@almadar/std 3.14.1 → 4.0.0

package/dist/modules/agent.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
 
 /**
  * Agent Module - AI Agent Intelligence Operations

package/dist/modules/array.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
 
 /**
  * Array Module - Collection Operations

package/dist/modules/async.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
 
 /**
  * Async Module - Asynchronous Operations

package/dist/modules/composition.d.ts

@@ -0,0 +1,27 @@
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
+
+/**
+ * Composition Module - Behavior Composition Operators
+ *
+ * Provides compile-time operators for composing N orbitals into a single
+ * application schema. These operators are resolved during `.lolo` lowering
+ * (or by the parallel Rust composition pass), not at runtime.
+ *
+ * Surfaced here so that the lolo type sync tool can publish them in
+ * `signatures.lolo`, the Rust compiler can validate their arity and shape,
+ * and IDE tooling can discover them through the unified std registry.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Composition module operators.
+ * All operators are pure (no runtime side effects) and compile-time resolved.
+ */
+declare const COMPOSITION_OPERATORS: Record<string, StdOperatorMeta>;
+/**
+ * Get all composition operator names.
+ */
+declare function getCompositionOperators(): string[];
+
+export { COMPOSITION_OPERATORS, getCompositionOperators };

package/dist/modules/composition.js

@@ -0,0 +1,98 @@
+// modules/composition.ts
+var COMPOSITION_OPERATORS = {
+  "behavior/compose": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 1,
+    maxArity: 1,
+    description: "Compose N orbitals into one application schema. Wires events, picks layout, generates pages.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "object",
+    params: [
+      {
+        name: "config",
+        type: "object",
+        description: "ComposeBehaviorsInput: { appName, orbitals[], layoutStrategy?, eventWiring?, entityMappings? }"
+      }
+    ],
+    example: '(behavior/compose { appName: "ShoppingApp" orbitals: [...] })'
+  },
+  "behavior/wire": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 2,
+    maxArity: 2,
+    description: "Apply cross-orbital event wiring. Adds external emits/listens to inline traits.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "array",
+    params: [
+      {
+        name: "orbitals",
+        type: "array",
+        description: "Array of OrbitalDefinition to wire"
+      },
+      {
+        name: "wiring",
+        type: "array",
+        description: "Array of EventWiringEntry { from, event, to, triggers }"
+      }
+    ],
+    example: "(behavior/wire orbitals wiring)"
+  },
+  "behavior/detect-layout": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 1,
+    maxArity: 2,
+    description: "Auto-detect layout from orbital count and wiring topology. Returns single, tabs, sidebar, dashboard, or wizard-flow.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "string",
+    params: [
+      {
+        name: "orbitals",
+        type: "array",
+        description: "Array of OrbitalDefinition"
+      },
+      {
+        name: "wiring",
+        type: "array",
+        description: "Optional EventWiringEntry array",
+        optional: true
+      }
+    ],
+    example: "(behavior/detect-layout orbitals)"
+  },
+  "behavior/pipe": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 2,
+    maxArity: null,
+    description: "Left-to-right composition. Each step receives the previous result as its first arg.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "any",
+    params: [
+      {
+        name: "seed",
+        type: "any",
+        description: "Initial value to pipe through steps"
+      },
+      {
+        name: "...steps",
+        type: "function[]",
+        description: "Functions, each receiving the previous result as first argument"
+      }
+    ],
+    example: '(behavior/pipe orbitals (behavior/wire wiring) (behavior/compose { appName: "X" }))'
+  }
+};
+function getCompositionOperators() {
+  return Object.keys(COMPOSITION_OPERATORS);
+}
+
+export { COMPOSITION_OPERATORS, getCompositionOperators };
+//# sourceMappingURL=composition.js.map
+//# sourceMappingURL=composition.js.map

package/dist/modules/composition.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/composition.ts"],"names":[],"mappings":";AAoBO,IAAM,qBAAA,GAAyD;AAAA,EACpE,kBAAA,EAAoB;AAAA,IAClB,MAAA,EAAQ,aAAA;AAAA,IACR,QAAA,EAAU,iBAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,8FAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,WAAA,EAAa,IAAA;AAAA,IACb,UAAA,EAAY,QAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,IAAA,EAAM,QAAA;AAAA,QACN,IAAA,EAAM,QAAA;AAAA,QACN,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ,aAAA;AAAA,IACR,QAAA,EAAU,iBAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,iFAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,WAAA,EAAa,IAAA;AAAA,IACb,UAAA,EAAY,OAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,IAAA,EAAM,UAAA;AAAA,QACN,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA;AAAA,QACE,IAAA,EAAM,QAAA;AAAA,QACN,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA,EACA,wBAAA,EAA0B;AAAA,IACxB,MAAA,EAAQ,aAAA;AAAA,IACR,QAAA,EAAU,iBAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,sHAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,WAAA,EAAa,IAAA;AAAA,IACb,UAAA,EAAY,QAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,IAAA,EAAM,UAAA;AAAA,QACN,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA;AAAA,QACE,IAAA,EAAM,QAAA;AAAA,QACN,IAAA,EAAM,OAAA;AAAA,QACN,WAAA,EAAa,iCAAA;AAAA,QACb,QAAA,EAAU;AAAA;AACZ,KACF;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA,EACA,eAAA,EAAiB;AAAA,IACf,MAAA,EAAQ,aAAA;AAAA,IACR,QAAA,EAAU,iBAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,IAAA;AAAA,IACV,WAAA,EAAa,qFAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,WAAA,EAAa,IAAA;AAAA,IACb,UAAA,EAAY,KAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,IAAA,EAAM,MAAA;AAAA,QACN,IAAA,EAAM,KAAA;AAAA,QACN,WAAA,EAAa;AAAA,OACf;AAAA,MACA;AAAA,QACE,IAAA,EAAM,UAAA;AAAA,QACN,IAAA,EAAM,YAAA;AAAA,QACN,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,OAAA,EAAS;AAAA;AAEb;AAKO,SAAS,uBAAA,GAAoC;AAClD,EAAA,OAAO,MAAA,CAAO,KAAK,qBAAqB,CAAA;AAC1C","file":"composition.js","sourcesContent":["/**\n * Composition Module - Behavior Composition Operators\n *\n * Provides compile-time operators for composing N orbitals into a single\n * application schema. These operators are resolved during `.lolo` lowering\n * (or by the parallel Rust composition pass), not at runtime.\n *\n * Surfaced here so that the lolo type sync tool can publish them in\n * `signatures.lolo`, the Rust compiler can validate their arity and shape,\n * and IDE tooling can discover them through the unified std registry.\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Composition module operators.\n * All operators are pure (no runtime side effects) and compile-time resolved.\n */\nexport const COMPOSITION_OPERATORS: Record<string, StdOperatorMeta> = {\n  'behavior/compose': {\n    module: 'composition',\n    category: 'std-composition',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Compose N orbitals into one application schema. Wires events, picks layout, generates pages.',\n    hasSideEffects: false,\n    compileTime: true,\n    returnType: 'object',\n    params: [\n      {\n        name: 'config',\n        type: 'object',\n        description: 'ComposeBehaviorsInput: { appName, orbitals[], layoutStrategy?, eventWiring?, entityMappings? }',\n      },\n    ],\n    example: '(behavior/compose { appName: \"ShoppingApp\" orbitals: [...] })',\n  },\n  'behavior/wire': {\n    module: 'composition',\n    category: 'std-composition',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Apply cross-orbital event wiring. Adds external emits/listens to inline traits.',\n    hasSideEffects: false,\n    compileTime: true,\n    returnType: 'array',\n    params: [\n      {\n        name: 'orbitals',\n        type: 'array',\n        description: 'Array of OrbitalDefinition to wire',\n      },\n      {\n        name: 'wiring',\n        type: 'array',\n        description: 'Array of EventWiringEntry { from, event, to, triggers }',\n      },\n    ],\n    example: '(behavior/wire orbitals wiring)',\n  },\n  'behavior/detect-layout': {\n    module: 'composition',\n    category: 'std-composition',\n    minArity: 1,\n    maxArity: 2,\n    description: 'Auto-detect layout from orbital count and wiring topology. Returns single, tabs, sidebar, dashboard, or wizard-flow.',\n    hasSideEffects: false,\n    compileTime: true,\n    returnType: 'string',\n    params: [\n      {\n        name: 'orbitals',\n        type: 'array',\n        description: 'Array of OrbitalDefinition',\n      },\n      {\n        name: 'wiring',\n        type: 'array',\n        description: 'Optional EventWiringEntry array',\n        optional: true,\n      },\n    ],\n    example: '(behavior/detect-layout orbitals)',\n  },\n  'behavior/pipe': {\n    module: 'composition',\n    category: 'std-composition',\n    minArity: 2,\n    maxArity: null,\n    description: 'Left-to-right composition. Each step receives the previous result as its first arg.',\n    hasSideEffects: false,\n    compileTime: true,\n    returnType: 'any',\n    params: [\n      {\n        name: 'seed',\n        type: 'any',\n        description: 'Initial value to pipe through steps',\n      },\n      {\n        name: '...steps',\n        type: 'function[]',\n        description: 'Functions, each receiving the previous result as first argument',\n      },\n    ],\n    example: '(behavior/pipe orbitals (behavior/wire wiring) (behavior/compose { appName: \"X\" }))',\n  },\n};\n\n/**\n * Get all composition operator names.\n */\nexport function getCompositionOperators(): string[] {\n  return Object.keys(COMPOSITION_OPERATORS);\n}\n"]}

package/dist/modules/contract.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
 
 /**
  * Contract Module - ML Contract Validation Operations

package/dist/modules/data.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
 
 /**
  * Data Module - ML Data Preprocessing Operations

package/dist/modules/format.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
 
 /**
  * Format Module - Display Formatting

package/dist/modules/graph.d.ts

@@ -1,4 +1,4 @@
-import { a as StdOperatorMeta } from '../types-BjP5nVQd.js';
+import { a as StdOperatorMeta } from '../types-BGtQuBge.js';
 
 /**
  * Graph Module - Graph Neural Network Operations

package/dist/modules/index.d.ts

@@ -15,4 +15,5 @@ export { DATA_OPERATORS, getDataOperators } from './data.js';
 export { PROB_OPERATORS, getProbOperators } from './prob.js';
 export { OS_OPERATORS } from './os.js';
 export { AGENT_OPERATORS, getAgentOperators } from './agent.js';
-import '../types-BjP5nVQd.js';
+export { COMPOSITION_OPERATORS, getCompositionOperators } from './composition.js';
+import '../types-BGtQuBge.js';

package/dist/modules/index.js

@@ -4229,6 +4229,101 @@ function getAgentOperators() {
   return Object.keys(AGENT_OPERATORS);
 }
 
-export { AGENT_OPERATORS, ARRAY_OPERATORS, ASYNC_OPERATORS, CONTRACT_OPERATORS, DATA_OPERATORS, FORMAT_OPERATORS, GRAPH_OPERATORS, MATH_OPERATORS, NN_OPERATORS, OBJECT_OPERATORS, OS_OPERATORS, PROB_OPERATORS, STR_OPERATORS, TENSOR_OPERATORS, TIME_OPERATORS, TRAIN_OPERATORS, VALIDATE_OPERATORS, getAgentOperators, getArrayOperators, getAsyncOperators, getContractOperators, getDataOperators, getFormatOperators, getGraphOperators, getLambdaArrayOperators, getMathOperators, getNnOperators, getObjectOperators, getProbOperators, getStrOperators, getTensorOperators, getTimeOperators, getTrainOperators, getValidateOperators };
+// modules/composition.ts
+var COMPOSITION_OPERATORS = {
+  "behavior/compose": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 1,
+    maxArity: 1,
+    description: "Compose N orbitals into one application schema. Wires events, picks layout, generates pages.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "object",
+    params: [
+      {
+        name: "config",
+        type: "object",
+        description: "ComposeBehaviorsInput: { appName, orbitals[], layoutStrategy?, eventWiring?, entityMappings? }"
+      }
+    ],
+    example: '(behavior/compose { appName: "ShoppingApp" orbitals: [...] })'
+  },
+  "behavior/wire": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 2,
+    maxArity: 2,
+    description: "Apply cross-orbital event wiring. Adds external emits/listens to inline traits.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "array",
+    params: [
+      {
+        name: "orbitals",
+        type: "array",
+        description: "Array of OrbitalDefinition to wire"
+      },
+      {
+        name: "wiring",
+        type: "array",
+        description: "Array of EventWiringEntry { from, event, to, triggers }"
+      }
+    ],
+    example: "(behavior/wire orbitals wiring)"
+  },
+  "behavior/detect-layout": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 1,
+    maxArity: 2,
+    description: "Auto-detect layout from orbital count and wiring topology. Returns single, tabs, sidebar, dashboard, or wizard-flow.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "string",
+    params: [
+      {
+        name: "orbitals",
+        type: "array",
+        description: "Array of OrbitalDefinition"
+      },
+      {
+        name: "wiring",
+        type: "array",
+        description: "Optional EventWiringEntry array",
+        optional: true
+      }
+    ],
+    example: "(behavior/detect-layout orbitals)"
+  },
+  "behavior/pipe": {
+    module: "composition",
+    category: "std-composition",
+    minArity: 2,
+    maxArity: null,
+    description: "Left-to-right composition. Each step receives the previous result as its first arg.",
+    hasSideEffects: false,
+    compileTime: true,
+    returnType: "any",
+    params: [
+      {
+        name: "seed",
+        type: "any",
+        description: "Initial value to pipe through steps"
+      },
+      {
+        name: "...steps",
+        type: "function[]",
+        description: "Functions, each receiving the previous result as first argument"
+      }
+    ],
+    example: '(behavior/pipe orbitals (behavior/wire wiring) (behavior/compose { appName: "X" }))'
+  }
+};
+function getCompositionOperators() {
+  return Object.keys(COMPOSITION_OPERATORS);
+}
+
+export { AGENT_OPERATORS, ARRAY_OPERATORS, ASYNC_OPERATORS, COMPOSITION_OPERATORS, CONTRACT_OPERATORS, DATA_OPERATORS, FORMAT_OPERATORS, GRAPH_OPERATORS, MATH_OPERATORS, NN_OPERATORS, OBJECT_OPERATORS, OS_OPERATORS, PROB_OPERATORS, STR_OPERATORS, TENSOR_OPERATORS, TIME_OPERATORS, TRAIN_OPERATORS, VALIDATE_OPERATORS, getAgentOperators, getArrayOperators, getAsyncOperators, getCompositionOperators, getContractOperators, getDataOperators, getFormatOperators, getGraphOperators, getLambdaArrayOperators, getMathOperators, getNnOperators, getObjectOperators, getProbOperators, getStrOperators, getTensorOperators, getTimeOperators, getTrainOperators, getValidateOperators };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map