@almadar/std 16.233.0 → 16.235.0

package/dist/registry.d.ts

@@ -1,4 +1,5 @@
-import { S as StdOperatorMeta, a as StdModule, O as OperatorMeta, R as RunsOn } from './types-DwAW4Nni.js';
+import { S as StdOperatorMeta, a as StdModule, O as OperatorMeta, R as RunsOn, b as OperatorVisualForm } from './types-Ggla7OK7.js';
+export { c as OPERATOR_VISUAL_FORMS } from './types-Ggla7OK7.js';
 
 /**
  * Standard Library Registry
@@ -152,5 +153,7 @@ declare function getStdLibStats(): {
     effectOperators: number;
     lambdaOperators: number;
 };
+/** The AVL circuit form of an operator: its declared form, else conveyor (takes a lambda), actuator (side effect) or block. Null when unregistered. */
+declare function operatorVisualForm(operator: string): OperatorVisualForm | null;
 
-export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };
+export { OPERATOR_NAMES, OperatorVisualForm, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, operatorVisualForm, validateOperatorArityExtended, validateStdOperatorArity };

package/dist/registry.js

@@ -36,6 +36,19 @@ var STD_MODULES = [
   "behavior",
   "integration"
 ];
+var OPERATOR_VISUAL_FORMS = [
+  "block",
+  "series",
+  "parallel",
+  "invert",
+  "branch",
+  "scope",
+  "template",
+  "conveyor",
+  "ladder",
+  "actuator",
+  "delay"
+];
 function getModuleFromOperator(operator) {
   const parts = operator.split("/");
   if (parts.length !== 2) return null;
@@ -253,6 +266,7 @@ var CORE_OPERATORS = {
   },
   // --- logic ------------------------------------------------------------------
   and: {
+    visual: { form: "series" },
     module: "core",
     category: "logic",
     minArity: 2,
@@ -265,6 +279,7 @@ var CORE_OPERATORS = {
     example: '["and", ["=", "active", "active"], [">", 5, 0]]'
   },
   or: {
+    visual: { form: "parallel" },
     module: "core",
     category: "logic",
     minArity: 2,
@@ -277,6 +292,7 @@ var CORE_OPERATORS = {
     example: '["or", ["=", "admin", "user"], ["=", "admin", "owner"]]'
   },
   not: {
+    visual: { form: "invert" },
     module: "core",
     category: "logic",
     minArity: 1,
@@ -288,6 +304,7 @@ var CORE_OPERATORS = {
     example: '["not", false]'
   },
   if: {
+    visual: { form: "branch" },
     module: "core",
     category: "logic",
     minArity: 3,
@@ -305,6 +322,7 @@ var CORE_OPERATORS = {
   },
   // --- control ----------------------------------------------------------------
   let: {
+    visual: { form: "scope" },
     module: "core",
     category: "control",
     minArity: 2,
@@ -323,6 +341,7 @@ var CORE_OPERATORS = {
     example: '["let", [["x", 10]], ["+", "x", 1]]'
   },
   do: {
+    visual: { form: "ladder" },
     module: "core",
     category: "control",
     minArity: 1,
@@ -345,6 +364,7 @@ var CORE_OPERATORS = {
     example: '["list", "path", "method", "status"] // => ["path", "method", "status"]'
   },
   when: {
+    visual: { form: "branch" },
     module: "core",
     category: "control",
     minArity: 2,
@@ -359,6 +379,7 @@ var CORE_OPERATORS = {
     example: '["when", [">", "@entity.health", 0], ["emit", "ALIVE"]]'
   },
   fn: {
+    visual: { form: "template" },
     module: "core",
     category: "control",
     minArity: 2,
@@ -3185,6 +3206,7 @@ var FORMAT_OPERATORS = {
 // modules/async.ts
 var ASYNC_OPERATORS = {
   "async/delay": {
+    visual: { form: "delay" },
     module: "async",
     category: "std-async",
     minArity: 1,
@@ -3200,6 +3222,7 @@ var ASYNC_OPERATORS = {
     example: '["async/delay", 2000, ["emit", "RETRY"]] // Wait 2s then emit'
   },
   "async/interval": {
+    visual: { form: "delay" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -3215,6 +3238,7 @@ var ASYNC_OPERATORS = {
     example: '["async/interval", 5000, ["emit", "POLL_TICK"]] // Emit every 5s'
   },
   "async/timeout": {
+    visual: { form: "delay" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -3230,6 +3254,7 @@ var ASYNC_OPERATORS = {
     example: '["async/timeout", ["call", "api", "fetchData"], 5000]'
   },
   "async/debounce": {
+    visual: { form: "delay" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -3245,6 +3270,7 @@ var ASYNC_OPERATORS = {
     example: '["async/debounce", "SEARCH", 300]'
   },
   "async/throttle": {
+    visual: { form: "delay" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -3260,6 +3286,7 @@ var ASYNC_OPERATORS = {
     example: '["async/throttle", "SCROLL", 100]'
   },
   "async/retry": {
+    visual: { form: "delay" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -3277,6 +3304,7 @@ var ASYNC_OPERATORS = {
   { "attempts": 3, "backoff": "exponential", "baseDelay": 1000 }]`
   },
   "async/race": {
+    visual: { form: "parallel" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -3289,6 +3317,7 @@ var ASYNC_OPERATORS = {
     example: '["async/race", ["call", "api1"], ["call", "api2"]]'
   },
   "async/all": {
+    visual: { form: "parallel" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -3301,6 +3330,7 @@ var ASYNC_OPERATORS = {
     example: '["async/all", ["call", "api1"], ["call", "api2"]]'
   },
   "async/sequence": {
+    visual: { form: "ladder" },
     module: "async",
     category: "std-async",
     minArity: 2,
@@ -6729,5 +6759,12 @@ function getStdLibStats() {
     lambdaOperators: getLambdaOperators().length
   };
 }
+function operatorVisualForm(operator) {
+  const meta = getStdOperatorMeta(operator);
+  if (!meta) return null;
+  if (meta.visual) return meta.visual.form;
+  if (meta.acceptsLambda) return "conveyor";
+  return meta.hasSideEffects ? "actuator" : "block";
+}
 
-export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };
+export { OPERATOR_NAMES, OPERATOR_VISUAL_FORMS, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getOperatorRunsOn, getOperatorsRunningOn, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, operatorVisualForm, validateOperatorArityExtended, validateStdOperatorArity };

package/dist/{types-DwAW4Nni.d.ts → types-Ggla7OK7.d.ts}

@@ -149,6 +149,9 @@ interface OperatorEffectMeta {
  * Extended operator metadata for std library operators.
  * Adds parameter descriptions and examples.
  */
+/** How an operator is drawn in the AVL circuit notation (evaluation as signal flow). */
+declare const OPERATOR_VISUAL_FORMS: readonly ["block", "series", "parallel", "invert", "branch", "scope", "template", "conveyor", "ladder", "actuator", "delay"];
+type OperatorVisualForm = (typeof OPERATOR_VISUAL_FORMS)[number];
 interface StdOperatorMeta extends OperatorMeta {
     /** The std module this operator belongs to */
     module: StdModule;
@@ -170,6 +173,10 @@ interface StdOperatorMeta extends OperatorMeta {
     compileTime?: boolean;
     /** Schema v2: structured metadata for effect operators */
     effect?: OperatorEffectMeta;
+    /** Circuit form, declared only where it is not derivable (lambda → conveyor, side effect → actuator, else block). */
+    visual?: {
+        form: OperatorVisualForm;
+    };
 }
 /**
  * Type guard to check if an operator category is a std category.
@@ -196,4 +203,4 @@ declare function isStdOperator(operator: string): boolean;
  */
 declare function makeStdOperator(module: StdModule, fn: string): string;
 
-export { type BasicReturnType as B, type OperatorMeta as O, type RunsOn as R, type StdOperatorMeta as S, type StdModule as a, OPERATOR_CATEGORIES as b, type OperatorCategory as c, type OperatorEffectMeta as d, type OperatorTypeRef as e, STD_MODULES as f, STD_OPERATOR_CATEGORIES as g, type StdOperatorCategory as h, getFunctionFromOperator as i, getModuleFromOperator as j, isStdCategory as k, isStdOperator as l, makeStdOperator as m };
+export { type BasicReturnType as B, type OperatorMeta as O, type RunsOn as R, type StdOperatorMeta as S, type StdModule as a, type OperatorVisualForm as b, OPERATOR_VISUAL_FORMS as c, OPERATOR_CATEGORIES as d, type OperatorCategory as e, type OperatorEffectMeta as f, type OperatorTypeRef as g, STD_MODULES as h, STD_OPERATOR_CATEGORIES as i, type StdOperatorCategory as j, getFunctionFromOperator as k, getModuleFromOperator as l, isStdCategory as m, isStdOperator as n, makeStdOperator as o };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/std",
-  "version": "16.233.0",
+  "version": "16.235.0",
   "description": "Standard library operators for Almadar (math, string, array, etc.)",
   "type": "module",
   "main": "./dist/index.js",
@@ -87,7 +87,7 @@
     "compiler": ">=4.10.0"
   },
   "dependencies": {
-    "@almadar/core": "^10.108.0"
+    "@almadar/core": "^10.110.0"
   },
   "devDependencies": {
     "@almadar/eslint-plugin": "^2.20.0",