@almadar/std 16.44.0 → 16.46.0

package/canonical-operators.json

@@ -1,7 +1,7 @@
 {
   "version": "2.0.0",
   "description": "Canonical operator registry for Almadar. Generated from @almadar/std/modules. Consumed by orbital-compiler via include_str!.",
-  "generated": "2026-06-19T08:35:48.734Z",
+  "generated": "2026-06-19T13:16:14.315Z",
   "categories": {
     "arithmetic": {
       "description": "Numeric operations",
@@ -160,6 +160,20 @@
         "rust"
       ]
     },
+    "std-noise": {
+      "description": "Coherent noise (procedural gen)",
+      "target": [
+        "ts",
+        "rust"
+      ]
+    },
+    "std-path": {
+      "description": "Grid pathfinding",
+      "target": [
+        "ts",
+        "rust"
+      ]
+    },
     "std-nn": {
       "description": "Neural network layer definitions",
       "target": [
@@ -1648,6 +1662,30 @@
       "description": "Tanh activation function: (e^x - e^-x) / (e^x + e^-x)",
       "module": "nn"
     },
+    "noise/fbm": {
+      "category": "std-noise",
+      "minArity": 3,
+      "maxArity": 4,
+      "returnType": "number",
+      "description": "Fractal Brownian motion: summed perlin octaves (clamped 1..8); output [-1,1]",
+      "module": "noise"
+    },
+    "noise/perlin": {
+      "category": "std-noise",
+      "minArity": 2,
+      "maxArity": 3,
+      "returnType": "number",
+      "description": "2D Perlin noise at (x,y) with optional seed; output [-1,1]",
+      "module": "noise"
+    },
+    "noise/simplex": {
+      "category": "std-noise",
+      "minArity": 2,
+      "maxArity": 3,
+      "returnType": "number",
+      "description": "Value-coherent noise (perlin-derived) at (x,y) with optional seed; output [-1,1]",
+      "module": "noise"
+    },
     "not": {
       "category": "logic",
       "minArity": 1,
@@ -1903,6 +1941,22 @@
       "description": "Build a dot-separated path string from segments. Used with set effect for dynamic field paths.",
       "module": "object"
     },
+    "path/astar": {
+      "category": "std-path",
+      "minArity": 5,
+      "maxArity": 6,
+      "returnType": "array",
+      "description": "A* shortest path on a w×h grid; returns cells start→goal (incl. both) or [] if none",
+      "module": "path"
+    },
+    "path/reachable": {
+      "category": "std-path",
+      "minArity": 5,
+      "maxArity": 6,
+      "returnType": "array",
+      "description": "BFS cells reachable within N moves from start (incl. start); sorted row-major",
+      "module": "path"
+    },
     "persist": {
       "category": "effect",
       "minArity": 2,

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as StdModule, S as StdOperatorMeta } from './types-Bc_qzeWd.js';
-export { B as BasicReturnType, b as OPERATOR_CATEGORIES, c as OperatorCategory, d as OperatorEffectMeta, O as OperatorMeta, e as OperatorTypeRef, f as STD_MODULES, g as STD_OPERATOR_CATEGORIES, h as StdOperatorCategory, i as getFunctionFromOperator, j as getModuleFromOperator, k as isStdCategory, l as isStdOperator, m as makeStdOperator } from './types-Bc_qzeWd.js';
+import { a as StdModule, S as StdOperatorMeta } from './types-cxNzLgmy.js';
+export { B as BasicReturnType, b as OPERATOR_CATEGORIES, c as OperatorCategory, d as OperatorEffectMeta, O as OperatorMeta, e as OperatorTypeRef, f as STD_MODULES, g as STD_OPERATOR_CATEGORIES, h as StdOperatorCategory, i as getFunctionFromOperator, j as getModuleFromOperator, k as isStdCategory, l as isStdOperator, m as makeStdOperator } from './types-cxNzLgmy.js';
 export { STD_OPERATORS as OPERATORS, OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, getAllStdOperators as getAllOperatorNames, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownStdOperator as isKnownOperator, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateStdOperatorArity as validateOperatorArity, validateOperatorArityExtended, validateStdOperatorArity } from './registry.js';
 export { CORE_OPERATORS, getCoreOperators } from './modules/core.js';
 export { MATH_OPERATORS } from './modules/math.js';

package/dist/index.js

@@ -36,6 +36,8 @@ var OPERATOR_CATEGORIES = [
   "std-grid",
   "std-anim",
   "std-ease",
+  "std-noise",
+  "std-path",
   "ml-arch",
   "ml-effect",
   "ml-tensor",
@@ -67,7 +69,9 @@ var STD_MODULES = [
   "geo",
   "grid",
   "anim",
-  "ease"
+  "ease",
+  "noise",
+  "path"
 ];
 var STD_OPERATOR_CATEGORIES = [
   "std-math",
@@ -90,6 +94,8 @@ var STD_OPERATOR_CATEGORIES = [
   "std-grid",
   "std-anim",
   "std-ease",
+  "std-noise",
+  "std-path",
   "ml-arch",
   "ml-effect",
   "ml-tensor",
@@ -5328,6 +5334,96 @@ var EASE_OPERATORS = {
   }
 };
 
+// modules/noise.ts
+var NOISE_OPERATORS = {
+  "noise/perlin": {
+    module: "noise",
+    category: "std-noise",
+    minArity: 2,
+    maxArity: 3,
+    description: "2D Perlin noise at (x,y) with optional seed; output [-1,1]",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "x", type: "number", description: "X coordinate" },
+      { name: "y", type: "number", description: "Y coordinate" },
+      { name: "seed", type: "number", description: "Optional integer seed (default 0)", optional: true }
+    ],
+    example: '["noise/perlin", 1.5, 2.5, 0] // => coherent value in [-1,1]'
+  },
+  "noise/simplex": {
+    module: "noise",
+    category: "std-noise",
+    minArity: 2,
+    maxArity: 3,
+    description: "Value-coherent noise (perlin-derived) at (x,y) with optional seed; output [-1,1]",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "x", type: "number", description: "X coordinate" },
+      { name: "y", type: "number", description: "Y coordinate" },
+      { name: "seed", type: "number", description: "Optional integer seed (default 0)", optional: true }
+    ],
+    example: '["noise/simplex", 1.5, 2.5, 0] // => coherent value in [-1,1]'
+  },
+  "noise/fbm": {
+    module: "noise",
+    category: "std-noise",
+    minArity: 3,
+    maxArity: 4,
+    description: "Fractal Brownian motion: summed perlin octaves (clamped 1..8); output [-1,1]",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "x", type: "number", description: "X coordinate" },
+      { name: "y", type: "number", description: "Y coordinate" },
+      { name: "octaves", type: "number", description: "Octave count (floored, clamped to 1..8)" },
+      { name: "seed", type: "number", description: "Optional integer seed (default 0)", optional: true }
+    ],
+    example: '["noise/fbm", 1.5, 2.5, 4, 0] // => layered value in [-1,1]'
+  }
+};
+
+// modules/path.ts
+var PATH_OPERATORS = {
+  "path/astar": {
+    module: "path",
+    category: "std-path",
+    minArity: 5,
+    maxArity: 6,
+    description: "A* shortest path on a w\xD7h grid; returns cells start\u2192goal (incl. both) or [] if none",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "start", type: "vector", description: "Start cell {x,y}" },
+      { name: "goal", type: "vector", description: "Goal cell {x,y}" },
+      { name: "blocked", type: { kind: "array", of: "vector" }, description: "Blocked cells [{x,y}, ...]" },
+      { name: "w", type: "number", description: "Grid width (x in [0,w))" },
+      { name: "h", type: "number", description: "Grid height (y in [0,h))" },
+      { name: "diagonal", type: "boolean", description: "Allow 8-direction moves (default false)", optional: true }
+    ],
+    example: '["path/astar", {"x":0,"y":0}, {"x":2,"y":0}, [], 3, 1] // => [{"x":0,"y":0},{"x":1,"y":0},{"x":2,"y":0}]'
+  },
+  "path/reachable": {
+    module: "path",
+    category: "std-path",
+    minArity: 5,
+    maxArity: 6,
+    description: "BFS cells reachable within N moves from start (incl. start); sorted row-major",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "start", type: "vector", description: "Start cell {x,y}" },
+      { name: "steps", type: "number", description: "Maximum number of moves" },
+      { name: "blocked", type: { kind: "array", of: "vector" }, description: "Blocked cells [{x,y}, ...]" },
+      { name: "w", type: "number", description: "Grid width (x in [0,w))" },
+      { name: "h", type: "number", description: "Grid height (y in [0,h))" },
+      { name: "diagonal", type: "boolean", description: "Allow 8-direction moves (default false)", optional: true }
+    ],
+    example: '["path/reachable", {"x":1,"y":1}, 1, [], 3, 3, false] // => 5 cross-shaped cells, row-major'
+  }
+};
+
 // registry.ts
 var STD_OPERATORS = {
   ...CORE_OPERATORS,
@@ -5350,7 +5446,9 @@ var STD_OPERATORS = {
   ...GEO_OPERATORS,
   ...GRID_OPERATORS,
   ...ANIM_OPERATORS,
-  ...EASE_OPERATORS
+  ...EASE_OPERATORS,
+  ...NOISE_OPERATORS,
+  ...PATH_OPERATORS
 };
 var OPERATOR_NAMES = Object.keys(STD_OPERATORS);
 var STD_OPERATORS_BY_MODULE = {
@@ -5374,7 +5472,9 @@ var STD_OPERATORS_BY_MODULE = {
   geo: GEO_OPERATORS,
   grid: GRID_OPERATORS,
   anim: ANIM_OPERATORS,
-  ease: EASE_OPERATORS
+  ease: EASE_OPERATORS,
+  noise: NOISE_OPERATORS,
+  path: PATH_OPERATORS
 };
 function getStdOperatorMeta(operator) {
   return STD_OPERATORS[operator];
@@ -105236,6 +105336,18 @@ var MODULE_DESCRIPTIONS = {
     displayName: "Easing Curves",
     description: "Penner easing curves and smoothstep interpolation.",
     icon: "\u303D\uFE0F"
+  },
+  noise: {
+    name: "Noise",
+    displayName: "Coherent Noise",
+    description: "Deterministic perlin-derived coherent noise (perlin/simplex/fbm) for procedural generation.",
+    icon: "\u{1F32B}\uFE0F"
+  },
+  path: {
+    name: "Path",
+    displayName: "Grid Pathfinding",
+    description: "Deterministic A* shortest path and BFS reachability over integer grid cells.",
+    icon: "\u{1F9ED}"
   }
 };
 var BEHAVIOR_GROUPINGS = {