@almadar/std 1.0.0

package/dist/modules/math.js

@@ -0,0 +1,215 @@
+// modules/math.ts
+var MATH_OPERATORS = {
+  "math/abs": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 1,
+    description: "Absolute value",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "n", type: "number", description: "The number" }],
+    example: '["math/abs", -5] // => 5'
+  },
+  "math/min": {
+    module: "math",
+    category: "std-math",
+    minArity: 2,
+    maxArity: null,
+    description: "Minimum of values",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "...nums", type: "number[]", description: "Numbers to compare" }],
+    example: '["math/min", 3, 1, 4] // => 1'
+  },
+  "math/max": {
+    module: "math",
+    category: "std-math",
+    minArity: 2,
+    maxArity: null,
+    description: "Maximum of values",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "...nums", type: "number[]", description: "Numbers to compare" }],
+    example: '["math/max", 3, 1, 4] // => 4'
+  },
+  "math/clamp": {
+    module: "math",
+    category: "std-math",
+    minArity: 3,
+    maxArity: 3,
+    description: "Constrain value to range [min, max]",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "n", type: "number", description: "The value to clamp" },
+      { name: "min", type: "number", description: "Minimum bound" },
+      { name: "max", type: "number", description: "Maximum bound" }
+    ],
+    example: '["math/clamp", 150, 0, 100] // => 100'
+  },
+  "math/floor": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 1,
+    description: "Round down to integer",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "n", type: "number", description: "The number" }],
+    example: '["math/floor", 3.7] // => 3'
+  },
+  "math/ceil": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 1,
+    description: "Round up to integer",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "n", type: "number", description: "The number" }],
+    example: '["math/ceil", 3.2] // => 4'
+  },
+  "math/round": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 2,
+    description: "Round to nearest integer or specified decimals",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "n", type: "number", description: "The number" },
+      { name: "decimals", type: "number", description: "Decimal places", optional: true, defaultValue: 0 }
+    ],
+    example: '["math/round", 3.456, 2] // => 3.46'
+  },
+  "math/pow": {
+    module: "math",
+    category: "std-math",
+    minArity: 2,
+    maxArity: 2,
+    description: "Exponentiation (base^exp)",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "base", type: "number", description: "The base" },
+      { name: "exp", type: "number", description: "The exponent" }
+    ],
+    example: '["math/pow", 2, 8] // => 256'
+  },
+  "math/sqrt": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 1,
+    description: "Square root",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "n", type: "number", description: "The number" }],
+    example: '["math/sqrt", 16] // => 4'
+  },
+  "math/mod": {
+    module: "math",
+    category: "std-math",
+    minArity: 2,
+    maxArity: 2,
+    description: "Modulo (remainder)",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "a", type: "number", description: "Dividend" },
+      { name: "b", type: "number", description: "Divisor" }
+    ],
+    example: '["math/mod", 7, 3] // => 1'
+  },
+  "math/sign": {
+    module: "math",
+    category: "std-math",
+    minArity: 1,
+    maxArity: 1,
+    description: "Returns -1, 0, or 1 indicating sign",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [{ name: "n", type: "number", description: "The number" }],
+    example: '["math/sign", -42] // => -1'
+  },
+  "math/lerp": {
+    module: "math",
+    category: "std-math",
+    minArity: 3,
+    maxArity: 3,
+    description: "Linear interpolation between a and b by factor t",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "a", type: "number", description: "Start value" },
+      { name: "b", type: "number", description: "End value" },
+      { name: "t", type: "number", description: "Interpolation factor (0-1)" }
+    ],
+    example: '["math/lerp", 0, 100, 0.5] // => 50'
+  },
+  "math/map": {
+    module: "math",
+    category: "std-math",
+    minArity: 5,
+    maxArity: 5,
+    description: "Map value from one range to another",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "n", type: "number", description: "The value" },
+      { name: "inMin", type: "number", description: "Input range minimum" },
+      { name: "inMax", type: "number", description: "Input range maximum" },
+      { name: "outMin", type: "number", description: "Output range minimum" },
+      { name: "outMax", type: "number", description: "Output range maximum" }
+    ],
+    example: '["math/map", 5, 0, 10, 0, 100] // => 50'
+  },
+  "math/random": {
+    module: "math",
+    category: "std-math",
+    minArity: 0,
+    maxArity: 0,
+    description: "Random number between 0 (inclusive) and 1 (exclusive)",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [],
+    example: '["math/random"] // => 0.7234...'
+  },
+  "math/randomInt": {
+    module: "math",
+    category: "std-math",
+    minArity: 2,
+    maxArity: 2,
+    description: "Random integer in range [min, max] (inclusive)",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "min", type: "number", description: "Minimum (inclusive)" },
+      { name: "max", type: "number", description: "Maximum (inclusive)" }
+    ],
+    example: '["math/randomInt", 1, 6] // => 4'
+  },
+  "math/default": {
+    module: "math",
+    category: "std-math",
+    minArity: 2,
+    maxArity: 2,
+    description: "Return default if value is null, undefined, or NaN",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "n", type: "number | null", description: "The value" },
+      { name: "default", type: "number", description: "Default value" }
+    ],
+    example: '["math/default", null, 0] // => 0'
+  }
+};
+function getMathOperators() {
+  return Object.keys(MATH_OPERATORS);
+}
+
+export { MATH_OPERATORS, getMathOperators };
+//# sourceMappingURL=math.js.map
+//# sourceMappingURL=math.js.map

package/dist/modules/math.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/math.ts"],"names":[],"mappings":"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","file":"math.js","sourcesContent":["/**\n * Math Module - Numeric Operations\n *\n * Provides higher-level numeric operations beyond basic arithmetic.\n * Basic arithmetic (+, -, *, /, %) is provided by language primitives.\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Math module operators.\n * All operators return numbers and have no side effects.\n */\nexport const MATH_OPERATORS: Record<string, StdOperatorMeta> = {\n  'math/abs': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Absolute value',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [{ name: 'n', type: 'number', description: 'The number' }],\n    example: '[\"math/abs\", -5] // => 5',\n  },\n  'math/min': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 2,\n    maxArity: null,\n    description: 'Minimum of values',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [{ name: '...nums', type: 'number[]', description: 'Numbers to compare' }],\n    example: '[\"math/min\", 3, 1, 4] // => 1',\n  },\n  'math/max': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 2,\n    maxArity: null,\n    description: 'Maximum of values',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [{ name: '...nums', type: 'number[]', description: 'Numbers to compare' }],\n    example: '[\"math/max\", 3, 1, 4] // => 4',\n  },\n  'math/clamp': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 3,\n    maxArity: 3,\n    description: 'Constrain value to range [min, max]',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'n', type: 'number', description: 'The value to clamp' },\n      { name: 'min', type: 'number', description: 'Minimum bound' },\n      { name: 'max', type: 'number', description: 'Maximum bound' },\n    ],\n    example: '[\"math/clamp\", 150, 0, 100] // => 100',\n  },\n  'math/floor': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Round down to integer',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [{ name: 'n', type: 'number', description: 'The number' }],\n    example: '[\"math/floor\", 3.7] // => 3',\n  },\n  'math/ceil': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Round up to integer',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [{ name: 'n', type: 'number', description: 'The number' }],\n    example: '[\"math/ceil\", 3.2] // => 4',\n  },\n  'math/round': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 1,\n    maxArity: 2,\n    description: 'Round to nearest integer or specified decimals',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'n', type: 'number', description: 'The number' },\n      { name: 'decimals', type: 'number', description: 'Decimal places', optional: true, defaultValue: 0 },\n    ],\n    example: '[\"math/round\", 3.456, 2] // => 3.46',\n  },\n  'math/pow': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Exponentiation (base^exp)',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'base', type: 'number', description: 'The base' },\n      { name: 'exp', type: 'number', description: 'The exponent' },\n    ],\n    example: '[\"math/pow\", 2, 8] // => 256',\n  },\n  'math/sqrt': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Square root',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [{ name: 'n', type: 'number', description: 'The number' }],\n    example: '[\"math/sqrt\", 16] // => 4',\n  },\n  'math/mod': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Modulo (remainder)',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'a', type: 'number', description: 'Dividend' },\n      { name: 'b', type: 'number', description: 'Divisor' },\n    ],\n    example: '[\"math/mod\", 7, 3] // => 1',\n  },\n  'math/sign': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Returns -1, 0, or 1 indicating sign',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [{ name: 'n', type: 'number', description: 'The number' }],\n    example: '[\"math/sign\", -42] // => -1',\n  },\n  'math/lerp': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 3,\n    maxArity: 3,\n    description: 'Linear interpolation between a and b by factor t',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'a', type: 'number', description: 'Start value' },\n      { name: 'b', type: 'number', description: 'End value' },\n      { name: 't', type: 'number', description: 'Interpolation factor (0-1)' },\n    ],\n    example: '[\"math/lerp\", 0, 100, 0.5] // => 50',\n  },\n  'math/map': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 5,\n    maxArity: 5,\n    description: 'Map value from one range to another',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'n', type: 'number', description: 'The value' },\n      { name: 'inMin', type: 'number', description: 'Input range minimum' },\n      { name: 'inMax', type: 'number', description: 'Input range maximum' },\n      { name: 'outMin', type: 'number', description: 'Output range minimum' },\n      { name: 'outMax', type: 'number', description: 'Output range maximum' },\n    ],\n    example: '[\"math/map\", 5, 0, 10, 0, 100] // => 50',\n  },\n  'math/random': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Random number between 0 (inclusive) and 1 (exclusive)',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [],\n    example: '[\"math/random\"] // => 0.7234...',\n  },\n  'math/randomInt': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Random integer in range [min, max] (inclusive)',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'min', type: 'number', description: 'Minimum (inclusive)' },\n      { name: 'max', type: 'number', description: 'Maximum (inclusive)' },\n    ],\n    example: '[\"math/randomInt\", 1, 6] // => 4',\n  },\n  'math/default': {\n    module: 'math',\n    category: 'std-math',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Return default if value is null, undefined, or NaN',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'n', type: 'number | null', description: 'The value' },\n      { name: 'default', type: 'number', description: 'Default value' },\n    ],\n    example: '[\"math/default\", null, 0] // => 0',\n  },\n};\n\n/**\n * Get all math operator names.\n */\nexport function getMathOperators(): string[] {\n  return Object.keys(MATH_OPERATORS);\n}\n"]}

package/dist/modules/nn.d.ts

@@ -0,0 +1,23 @@
+import { a as StdOperatorMeta } from '../types-I95R8_FN.js';
+
+/**
+ * Neural Network Module - Neural Network Operations
+ *
+ * Provides operators for defining and executing neural networks.
+ * Networks are defined as S-expressions and compiled to native code
+ * by the Rust compiler for each target backend (PyTorch, TensorFlow, etc.).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Neural network module operators.
+ * These operators define network architecture and forward passes.
+ */
+declare const NN_OPERATORS: Record<string, StdOperatorMeta>;
+/**
+ * Get all nn operator names.
+ */
+declare function getNnOperators(): string[];
+
+export { NN_OPERATORS, getNnOperators };

package/dist/modules/nn.js

@@ -0,0 +1,189 @@
+// modules/nn.ts
+var NN_OPERATORS = {
+  "nn/sequential": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 1,
+    maxArity: null,
+    description: "Create a sequential neural network from layers",
+    hasSideEffects: false,
+    returnType: "nn/module",
+    params: [
+      { name: "...layers", type: "nn/layer[]", description: "Layers to stack sequentially" }
+    ],
+    example: '["nn/sequential", ["nn/linear", 16, 64], ["nn/relu"], ["nn/linear", 64, 4]]'
+  },
+  "nn/linear": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 2,
+    maxArity: 2,
+    description: "Fully connected linear layer (output = input * weights + bias)",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [
+      { name: "inFeatures", type: "number", description: "Input dimension" },
+      { name: "outFeatures", type: "number", description: "Output dimension" }
+    ],
+    example: '["nn/linear", 16, 64] // 16 inputs -> 64 outputs'
+  },
+  "nn/relu": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 0,
+    maxArity: 0,
+    description: "ReLU activation function: max(0, x)",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [],
+    example: '["nn/relu"]'
+  },
+  "nn/tanh": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 0,
+    maxArity: 0,
+    description: "Tanh activation function: (e^x - e^-x) / (e^x + e^-x)",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [],
+    example: '["nn/tanh"]'
+  },
+  "nn/sigmoid": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 0,
+    maxArity: 0,
+    description: "Sigmoid activation function: 1 / (1 + e^-x)",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [],
+    example: '["nn/sigmoid"]'
+  },
+  "nn/softmax": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 0,
+    maxArity: 1,
+    description: "Softmax activation function (normalizes to probability distribution)",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [
+      { name: "dim", type: "number", description: "Dimension to apply softmax", optional: true, defaultValue: -1 }
+    ],
+    example: '["nn/softmax"]'
+  },
+  "nn/dropout": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 0,
+    maxArity: 1,
+    description: "Dropout layer for regularization (randomly zeros elements during training)",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [
+      { name: "p", type: "number", description: "Dropout probability", optional: true, defaultValue: 0.5 }
+    ],
+    example: '["nn/dropout", 0.3] // 30% dropout'
+  },
+  "nn/batchnorm": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 1,
+    maxArity: 1,
+    description: "Batch normalization layer",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [
+      { name: "numFeatures", type: "number", description: "Number of features to normalize" }
+    ],
+    example: '["nn/batchnorm", 64]'
+  },
+  "nn/layernorm": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 1,
+    maxArity: 1,
+    description: "Layer normalization",
+    hasSideEffects: false,
+    returnType: "nn/layer",
+    params: [
+      { name: "normalizedShape", type: "number | number[]", description: "Shape to normalize over" }
+    ],
+    example: '["nn/layernorm", 64]'
+  },
+  "nn/forward": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 2,
+    maxArity: 2,
+    description: "Execute forward pass through network",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "module", type: "nn/module", description: "The neural network module" },
+      { name: "input", type: "tensor", description: "Input tensor" }
+    ],
+    example: '["nn/forward", "@entity.architecture", "@entity.sensors"]'
+  },
+  "nn/getWeights": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get network weights as a flat tensor",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "module", type: "nn/module", description: "The neural network module" }
+    ],
+    example: '["nn/getWeights", "@entity.architecture"]'
+  },
+  "nn/setWeights": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 2,
+    maxArity: 2,
+    description: "Set network weights from a flat tensor",
+    hasSideEffects: true,
+    returnType: "nn/module",
+    params: [
+      { name: "module", type: "nn/module", description: "The neural network module" },
+      { name: "weights", type: "tensor", description: "New weights as flat tensor" }
+    ],
+    example: '["nn/setWeights", "@entity.architecture", "@payload.newWeights"]'
+  },
+  "nn/paramCount": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get total number of trainable parameters",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "module", type: "nn/module", description: "The neural network module" }
+    ],
+    example: '["nn/paramCount", "@entity.architecture"] // => 3300'
+  },
+  "nn/clone": {
+    module: "nn",
+    category: "std-nn",
+    minArity: 1,
+    maxArity: 1,
+    description: "Create a deep copy of the network with same weights",
+    hasSideEffects: false,
+    returnType: "nn/module",
+    params: [
+      { name: "module", type: "nn/module", description: "The neural network module to clone" }
+    ],
+    example: '["nn/clone", "@entity.architecture"]'
+  }
+};
+function getNnOperators() {
+  return Object.keys(NN_OPERATORS);
+}
+
+export { NN_OPERATORS, getNnOperators };
+//# sourceMappingURL=nn.js.map
+//# sourceMappingURL=nn.js.map

package/dist/modules/nn.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/nn.ts"],"names":[],"mappings":"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","file":"nn.js","sourcesContent":["/**\n * Neural Network Module - Neural Network Operations\n *\n * Provides operators for defining and executing neural networks.\n * Networks are defined as S-expressions and compiled to native code\n * by the Rust compiler for each target backend (PyTorch, TensorFlow, etc.).\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Neural network module operators.\n * These operators define network architecture and forward passes.\n */\nexport const NN_OPERATORS: Record<string, StdOperatorMeta> = {\n  'nn/sequential': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 1,\n    maxArity: null,\n    description: 'Create a sequential neural network from layers',\n    hasSideEffects: false,\n    returnType: 'nn/module',\n    params: [\n      { name: '...layers', type: 'nn/layer[]', description: 'Layers to stack sequentially' },\n    ],\n    example: '[\"nn/sequential\", [\"nn/linear\", 16, 64], [\"nn/relu\"], [\"nn/linear\", 64, 4]]',\n  },\n  'nn/linear': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Fully connected linear layer (output = input * weights + bias)',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [\n      { name: 'inFeatures', type: 'number', description: 'Input dimension' },\n      { name: 'outFeatures', type: 'number', description: 'Output dimension' },\n    ],\n    example: '[\"nn/linear\", 16, 64] // 16 inputs -> 64 outputs',\n  },\n  'nn/relu': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 0,\n    maxArity: 0,\n    description: 'ReLU activation function: max(0, x)',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [],\n    example: '[\"nn/relu\"]',\n  },\n  'nn/tanh': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Tanh activation function: (e^x - e^-x) / (e^x + e^-x)',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [],\n    example: '[\"nn/tanh\"]',\n  },\n  'nn/sigmoid': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 0,\n    maxArity: 0,\n    description: 'Sigmoid activation function: 1 / (1 + e^-x)',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [],\n    example: '[\"nn/sigmoid\"]',\n  },\n  'nn/softmax': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 0,\n    maxArity: 1,\n    description: 'Softmax activation function (normalizes to probability distribution)',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [\n      { name: 'dim', type: 'number', description: 'Dimension to apply softmax', optional: true, defaultValue: -1 },\n    ],\n    example: '[\"nn/softmax\"]',\n  },\n  'nn/dropout': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 0,\n    maxArity: 1,\n    description: 'Dropout layer for regularization (randomly zeros elements during training)',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [\n      { name: 'p', type: 'number', description: 'Dropout probability', optional: true, defaultValue: 0.5 },\n    ],\n    example: '[\"nn/dropout\", 0.3] // 30% dropout',\n  },\n  'nn/batchnorm': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Batch normalization layer',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [\n      { name: 'numFeatures', type: 'number', description: 'Number of features to normalize' },\n    ],\n    example: '[\"nn/batchnorm\", 64]',\n  },\n  'nn/layernorm': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Layer normalization',\n    hasSideEffects: false,\n    returnType: 'nn/layer',\n    params: [\n      { name: 'normalizedShape', type: 'number | number[]', description: 'Shape to normalize over' },\n    ],\n    example: '[\"nn/layernorm\", 64]',\n  },\n  'nn/forward': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Execute forward pass through network',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'module', type: 'nn/module', description: 'The neural network module' },\n      { name: 'input', type: 'tensor', description: 'Input tensor' },\n    ],\n    example: '[\"nn/forward\", \"@entity.architecture\", \"@entity.sensors\"]',\n  },\n  'nn/getWeights': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get network weights as a flat tensor',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'module', type: 'nn/module', description: 'The neural network module' },\n    ],\n    example: '[\"nn/getWeights\", \"@entity.architecture\"]',\n  },\n  'nn/setWeights': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Set network weights from a flat tensor',\n    hasSideEffects: true,\n    returnType: 'nn/module',\n    params: [\n      { name: 'module', type: 'nn/module', description: 'The neural network module' },\n      { name: 'weights', type: 'tensor', description: 'New weights as flat tensor' },\n    ],\n    example: '[\"nn/setWeights\", \"@entity.architecture\", \"@payload.newWeights\"]',\n  },\n  'nn/paramCount': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get total number of trainable parameters',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'module', type: 'nn/module', description: 'The neural network module' },\n    ],\n    example: '[\"nn/paramCount\", \"@entity.architecture\"] // => 3300',\n  },\n  'nn/clone': {\n    module: 'nn',\n    category: 'std-nn',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Create a deep copy of the network with same weights',\n    hasSideEffects: false,\n    returnType: 'nn/module',\n    params: [\n      { name: 'module', type: 'nn/module', description: 'The neural network module to clone' },\n    ],\n    example: '[\"nn/clone\", \"@entity.architecture\"]',\n  },\n};\n\n/**\n * Get all nn operator names.\n */\nexport function getNnOperators(): string[] {\n  return Object.keys(NN_OPERATORS);\n}\n"]}

package/dist/modules/object.d.ts

@@ -0,0 +1,22 @@
+import { a as StdOperatorMeta } from '../types-I95R8_FN.js';
+
+/**
+ * Object Module - Object Operations
+ *
+ * Provides object manipulation and transformation functions.
+ * All operations are immutable (return new objects).
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Object module operators.
+ * All operators return objects or other values and have no side effects.
+ */
+declare const OBJECT_OPERATORS: Record<string, StdOperatorMeta>;
+/**
+ * Get all object operator names.
+ */
+declare function getObjectOperators(): string[];
+
+export { OBJECT_OPERATORS, getObjectOperators };