More Mekanism

docs/.vitepress/config.mts

@@ -53,6 +53,9 @@ export default defineConfig({
             text: 'Mekanism',
             collapsed: true,
             items: [
+              { text: 'Antiprotonic Nucleosynthesizer', link: '/reference/input/mekanism/AntiprotonicNucleosynthesizer' },
+              { text: 'Bin', link: '/reference/input/mekanism/Bin' },
+              { text: 'Bio Generator', link: '/reference/input/mekanism/BioGenerator' },
               { text: 'Fission Reactor', link: '/reference/input/mekanism/FissionReactor' },
               { text: 'Fusion Reactor', link: '/reference/input/mekanism/FusionReactor' },
               { text: 'Induction Matrix', link: '/reference/input/mekanism/InductionMatrix' },

docs/reference/input/mekanism/AntiprotonicNucleosynthesizer.md

@@ -0,0 +1,153 @@
+# Mekanism Antiprotonic Nucleosynthesizer Input <RepoLink path="lib/input/mekanism/AntiprotonicNucleosynthesizerInputAdapter.lua" />
+
+```lua
+telem.input.mekanism.apns (
+	peripheralID: string,
+	categories?: string[] | '*'
+)
+```
+
+::: warning Mod Dependencies
+Requires **Mekanism**.
+:::
+
+See the Usage section for a complete list of the metrics in each category.
+
+<PropertiesTable
+  :properties="[
+    {
+      name: 'peripheralID',
+      type: 'string',
+      default: 'nil',
+      description: 'Peripheral ID of the Antiprotonic Nucleosynthesizer'
+    },
+		{
+			name: 'categories',
+			type: 'string[] | &quot;*&quot;',
+			default: '{ &quot;basic&quot; }'
+		}
+  ]"
+>
+<template v-slot:categories>
+
+List of metric categories to query. The value `"*"` can be used to include all categories, which are listed below.
+
+```lua
+{ "basic", "advanced", "input", "output", "energy", "recipe" }
+```
+</template>
+</PropertiesTable>
+
+## Usage
+
+```lua{4}
+local telem = require 'telem'
+
+local backplane = telem.backplane()
+  :addInput('my_apns', telem.input.mekanism.apns('right', '*'))
+  :cycleEvery(5)()
+```
+
+Given an Antiprotonic Nucleosynthesizer peripheral on the `right` side of the computer, this appends the following metrics to the backplane (grouped by category here for clarity):
+
+### Basic
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekapns:input_chemical_filled_percentage',
+      value: '0.0 - 1.0'
+    },
+    {
+      name: 'mekapns:input_item_count',
+      value: '0 - inf',
+      unit: 'item'
+    },
+    {
+      name: 'mekapns:output_item_count',
+      value: '0 - inf',
+      unit: 'item'
+    },
+    {
+      name: 'mekapns:energy_filled_percentage',
+      value: '0.0 - 1.0'
+    },
+    {
+      name: 'mekapns:energy_usage',
+      value: '0.0 - inf',
+      unit: 'FE/t'
+    }
+  ]"
+/>
+
+### Advanced
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekapns:comparator_level',
+      value: '0 - 15'
+    }
+  ]"
+/>
+
+### Input
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekapns:input_chemical',
+      value: '0.0 - inf',
+      unit: 'B'
+    },
+    {
+      name: 'mekapns:input_chemical_capacity',
+      value: '0.0 - inf',
+      unit: 'B'
+    },
+    {
+      name: 'mekapns:input_chemical_needed',
+      value: '0.0 - inf',
+      unit: 'B'
+    }
+  ]"
+/>
+
+### Energy
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekapns:energy',
+      value: '0.0 - inf',
+      unit: 'FE'
+    },
+    {
+      name: 'mekapns:max_energy',
+      value: '0.0 - inf',
+      unit: 'FE'
+    },
+    {
+      name: 'mekapns:energy_needed',
+      value: '0.0 - inf',
+      unit: 'FE'
+    }
+  ]"
+/>
+
+### Recipe
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekapns:recipe_progress',
+      value: '0 - inf',
+      unit: 't'
+    },
+    {
+      name: 'mekapns:ticks_required',
+      value: '0 - inf',
+      unit: 't'
+    }
+  ]"
+/>

docs/reference/input/mekanism/Bin.md

@@ -0,0 +1,85 @@
+# Mekanism Bin Input <RepoLink path="lib/input/mekanism/BinInputAdapter.lua" />
+
+```lua
+telem.input.mekanism.bin (
+	peripheralID: string,
+	categories?: string[] | '*'
+)
+```
+
+::: warning Mod Dependencies
+Requires **Mekanism**.
+:::
+
+See the Usage section for a complete list of the metrics in each category.
+
+<PropertiesTable
+  :properties="[
+    {
+      name: 'peripheralID',
+      type: 'string',
+      default: 'nil',
+      description: 'Peripheral ID of the Antiprotonic Nucleosynthesizer'
+    },
+		{
+			name: 'categories',
+			type: 'string[] | &quot;*&quot;',
+			default: '{ &quot;basic&quot; }'
+		}
+  ]"
+>
+<template v-slot:categories>
+
+List of metric categories to query. The value `"*"` can be used to include all categories, which are listed below.
+
+```lua
+{ "basic" }
+```
+</template>
+</PropertiesTable>
+
+## Usage
+
+```lua{4}
+local telem = require 'telem'
+
+local backplane = telem.backplane()
+  :addInput('my_bin', telem.input.mekanism.bin('right', '*'))
+  :cycleEvery(5)()
+```
+
+Given a Bin peripheral on the `right` side of the computer, this appends the following metrics to the backplane (grouped by category here for clarity):
+
+### Basic
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekbin:stored',
+      value: '0 - inf',
+      unit: 'item'
+    },
+    {
+      name: 'mekbin:capacity',
+      value: '0 - inf',
+      unit: 'item'
+    }
+  ]"
+/>
+
+## Storage
+If the bin contains items, a storage metric is added for the item. Given a bin with the following contents:
+
+![Mekanism Basic Bin with contents](/assets/mekanism-bin.png)
+
+The following metric would be added:
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'storage:minecraft:lime_concrete_powder',
+      value: '71',
+      unit: 'item'
+    },
+  ]"
+/>

docs/reference/input/mekanism/BioGenerator.md

@@ -0,0 +1,131 @@
+# Mekanism Bio Generator Input <RepoLink path="lib/input/mekanism/BioGeneratorInputAdapter.lua" />
+
+```lua
+telem.input.mekanism.bioGenerator (
+	peripheralID: string,
+	categories?: string[] | '*'
+)
+```
+
+::: warning Mod Dependencies
+Requires **Mekanism** and **Mekanism Generators**.
+:::
+
+See the Usage section for a complete list of the metrics in each category.
+
+<PropertiesTable
+  :properties="[
+    {
+      name: 'peripheralID',
+      type: 'string',
+      default: 'nil',
+      description: 'Peripheral ID of the Bio Generator'
+    },
+		{
+			name: 'categories',
+			type: 'string[] | &quot;*&quot;',
+			default: '{ &quot;basic&quot; }'
+		}
+  ]"
+>
+<template v-slot:categories>
+
+List of metric categories to query. The value `"*"` can be used to include all categories, which are listed below.
+
+```lua
+{ "basic", "advanced", "fuel", "energy" }
+```
+</template>
+</PropertiesTable>
+
+## Usage
+
+```lua{4}
+local telem = require 'telem'
+
+local backplane = telem.backplane()
+  :addInput('my_biogen', telem.input.mekanism.bioGenerator('right', '*'))
+  :cycleEvery(5)()
+```
+
+Given a Bio Generator peripheral on the `right` side of the computer, this appends the following metrics to the backplane (grouped by category here for clarity):
+
+### Basic
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekbiogen:production_rate',
+      value: '0.0 - inf',
+      unit: 'FE/t'
+    },
+    {
+      name: 'mekbiogen:energy_filled_percentage',
+      value: '0.0 - 1.0'
+    },
+    {
+      name: 'mekbiogen:bio_fuel_filled_percentage',
+      value: '0.0 - 1.0'
+    }
+  ]"
+/>
+
+### Advanced
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekbiogen:comparator_level',
+      value: '0 - 15'
+    }
+  ]"
+/>
+
+### Fuel
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekbiogen:bio_fuel_capacity',
+      value: '0.0 - inf',
+      unit: 'B'
+    },
+    {
+      name: 'mekbiogen:bio_fuel',
+      value: '0.0 - inf',
+      unit: 'B'
+    },
+    {
+      name: 'mekbiogen:bio_fuel_needed',
+      value: '0.0 - inf',
+      unit: 'B'
+    }
+  ]"
+/>
+
+### Energy
+
+<MetricTable
+  :metrics="[
+    {
+      name: 'mekbiogen:max_energy',
+      value: '0.0 - inf',
+      unit: 'FE'
+    },
+    {
+      name: 'mekbiogen:energy_needed',
+      value: '0.0 - inf',
+      unit: 'FE'
+    },
+    {
+      name: 'mekbiogen:energy',
+      value: '0.0 - inf',
+      unit: 'FE'
+    },
+    {
+      name: 'mekbiogen:max_energy_output',
+      value: '0.0 - inf',
+      unit: 'FE/t'
+    }
+  ]"
+/>

src/telem/init.lua

@@ -1,9 +1,9 @@
 -- Telem by cyberbit
 -- MIT License
--- Version 0.7.1
+-- Version 0.8.0
 
 local _Telem = {
-    _VERSION = '0.7.1',
+    _VERSION = '0.8.0',
     util = require 'telem.lib.util',
     input = require 'telem.lib.input',
     output = require 'telem.lib.output',