@almadar/std 3.2.3 → 3.3.4

package/dist/modules/array.d.ts

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

package/dist/modules/async.d.ts

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

package/dist/modules/contract.d.ts

@@ -0,0 +1,22 @@
+import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+
+/**
+ * Contract Module - ML Contract Validation Operations
+ *
+ * Provides operators for validating tensors against input/output contracts
+ * and converting between entity fields and tensors via contract mappings.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Contract module operators.
+ * These operators validate and transform data using contract specifications.
+ */
+declare const CONTRACT_OPERATORS: Record<string, StdOperatorMeta>;
+/**
+ * Get all contract operator names.
+ */
+declare function getContractOperators(): string[];
+
+export { CONTRACT_OPERATORS, getContractOperators };

package/dist/modules/contract.js

@@ -0,0 +1,100 @@
+// modules/contract.ts
+var CONTRACT_OPERATORS = {
+  // ============================================================================
+  // Validation
+  // ============================================================================
+  "contract/validate-input": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Validate tensor against input contract",
+    hasSideEffects: false,
+    returnType: "boolean",
+    params: [
+      { name: "tensor", type: "tensor", description: "Input tensor" },
+      { name: "contract", type: "object", description: "Input contract spec" }
+    ],
+    example: '["contract/validate-input", "@payload.input", "@entity.inputContract"]'
+  },
+  "contract/validate-output": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Validate tensor against output contract",
+    hasSideEffects: false,
+    returnType: "boolean",
+    params: [
+      { name: "tensor", type: "tensor", description: "Output tensor" },
+      { name: "contract", type: "object", description: "Output contract spec" }
+    ],
+    example: '["contract/validate-output", "@entity.output", "@entity.outputContract"]'
+  },
+  "contract/clamp-output": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Clamp output tensor to contract ranges",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "tensor", type: "tensor", description: "Output tensor" },
+      { name: "contract", type: "object", description: "Output contract spec" }
+    ],
+    example: '["contract/clamp-output", "@entity.output", "@entity.outputContract"]'
+  },
+  "contract/violations": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "List contract violations",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "tensor", type: "tensor", description: "Tensor to check" },
+      { name: "contract", type: "object", description: "Contract spec" }
+    ],
+    example: '["contract/violations", "@entity.output", "@entity.outputContract"]'
+  },
+  // ============================================================================
+  // Conversion
+  // ============================================================================
+  "contract/entity-to-tensor": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Convert entity fields to tensor via contract",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "entity", type: "object", description: "Entity data" },
+      { name: "contract", type: "object", description: "Input contract mapping fields to dims" }
+    ],
+    example: '["contract/entity-to-tensor", "@entity", "@entity.inputContract"]'
+  },
+  "contract/tensor-to-payload": {
+    module: "contract",
+    category: "ml-contract",
+    minArity: 2,
+    maxArity: 2,
+    description: "Convert output tensor to event payload via contract",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { name: "tensor", type: "tensor", description: "Output tensor" },
+      { name: "contract", type: "object", description: "Output contract mapping dims to fields" }
+    ],
+    example: '["contract/tensor-to-payload", "@entity.output", "@entity.outputContract"]'
+  }
+};
+function getContractOperators() {
+  return Object.keys(CONTRACT_OPERATORS);
+}
+
+export { CONTRACT_OPERATORS, getContractOperators };
+//# sourceMappingURL=contract.js.map
+//# sourceMappingURL=contract.js.map

package/dist/modules/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/contract.ts"],"names":[],"mappings":";AAeO,IAAM,kBAAA,GAAsD;AAAA;AAAA;AAAA;AAAA,EAKjE,yBAAA,EAA2B;AAAA,IACzB,MAAA,EAAQ,UAAA;AAAA,IACR,QAAA,EAAU,aAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,wCAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,UAAA,EAAY,SAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,QAAA,EAAU,aAAa,cAAA,EAAe;AAAA,MAC9D,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,QAAA,EAAU,aAAa,qBAAA;AAAsB,KACzE;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA,EACA,0BAAA,EAA4B;AAAA,IAC1B,MAAA,EAAQ,UAAA;AAAA,IACR,QAAA,EAAU,aAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,yCAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,UAAA,EAAY,SAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,QAAA,EAAU,aAAa,eAAA,EAAgB;AAAA,MAC/D,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,QAAA,EAAU,aAAa,sBAAA;AAAuB,KAC1E;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA,EACA,uBAAA,EAAyB;AAAA,IACvB,MAAA,EAAQ,UAAA;AAAA,IACR,QAAA,EAAU,aAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,wCAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,UAAA,EAAY,QAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,QAAA,EAAU,aAAa,eAAA,EAAgB;AAAA,MAC/D,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,QAAA,EAAU,aAAa,sBAAA;AAAuB,KAC1E;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA,EACA,qBAAA,EAAuB;AAAA,IACrB,MAAA,EAAQ,UAAA;AAAA,IACR,QAAA,EAAU,aAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,0BAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,UAAA,EAAY,OAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,QAAA,EAAU,aAAa,iBAAA,EAAkB;AAAA,MACjE,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,QAAA,EAAU,aAAa,eAAA;AAAgB,KACnE;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA;AAAA;AAAA;AAAA,EAMA,2BAAA,EAA6B;AAAA,IAC3B,MAAA,EAAQ,UAAA;AAAA,IACR,QAAA,EAAU,aAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,8CAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,UAAA,EAAY,QAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,QAAA,EAAU,aAAa,aAAA,EAAc;AAAA,MAC7D,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,QAAA,EAAU,aAAa,uCAAA;AAAwC,KAC3F;AAAA,IACA,OAAA,EAAS;AAAA,GACX;AAAA,EACA,4BAAA,EAA8B;AAAA,IAC5B,MAAA,EAAQ,UAAA;AAAA,IACR,QAAA,EAAU,aAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,QAAA,EAAU,CAAA;AAAA,IACV,WAAA,EAAa,qDAAA;AAAA,IACb,cAAA,EAAgB,KAAA;AAAA,IAChB,UAAA,EAAY,QAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,EAAE,IAAA,EAAM,QAAA,EAAU,IAAA,EAAM,QAAA,EAAU,aAAa,eAAA,EAAgB;AAAA,MAC/D,EAAE,IAAA,EAAM,UAAA,EAAY,IAAA,EAAM,QAAA,EAAU,aAAa,wCAAA;AAAyC,KAC5F;AAAA,IACA,OAAA,EAAS;AAAA;AAEb;AAKO,SAAS,oBAAA,GAAiC;AAC/C,EAAA,OAAO,MAAA,CAAO,KAAK,kBAAkB,CAAA;AACvC","file":"contract.js","sourcesContent":["/**\n * Contract Module - ML Contract Validation Operations\n *\n * Provides operators for validating tensors against input/output contracts\n * and converting between entity fields and tensors via contract mappings.\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Contract module operators.\n * These operators validate and transform data using contract specifications.\n */\nexport const CONTRACT_OPERATORS: Record<string, StdOperatorMeta> = {\n  // ============================================================================\n  // Validation\n  // ============================================================================\n\n  'contract/validate-input': {\n    module: 'contract',\n    category: 'ml-contract',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Validate tensor against input contract',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [\n      { name: 'tensor', type: 'tensor', description: 'Input tensor' },\n      { name: 'contract', type: 'object', description: 'Input contract spec' },\n    ],\n    example: '[\"contract/validate-input\", \"@payload.input\", \"@entity.inputContract\"]',\n  },\n  'contract/validate-output': {\n    module: 'contract',\n    category: 'ml-contract',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Validate tensor against output contract',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [\n      { name: 'tensor', type: 'tensor', description: 'Output tensor' },\n      { name: 'contract', type: 'object', description: 'Output contract spec' },\n    ],\n    example: '[\"contract/validate-output\", \"@entity.output\", \"@entity.outputContract\"]',\n  },\n  'contract/clamp-output': {\n    module: 'contract',\n    category: 'ml-contract',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Clamp output tensor to contract ranges',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'tensor', type: 'tensor', description: 'Output tensor' },\n      { name: 'contract', type: 'object', description: 'Output contract spec' },\n    ],\n    example: '[\"contract/clamp-output\", \"@entity.output\", \"@entity.outputContract\"]',\n  },\n  'contract/violations': {\n    module: 'contract',\n    category: 'ml-contract',\n    minArity: 2,\n    maxArity: 2,\n    description: 'List contract violations',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [\n      { name: 'tensor', type: 'tensor', description: 'Tensor to check' },\n      { name: 'contract', type: 'object', description: 'Contract spec' },\n    ],\n    example: '[\"contract/violations\", \"@entity.output\", \"@entity.outputContract\"]',\n  },\n\n  // ============================================================================\n  // Conversion\n  // ============================================================================\n\n  'contract/entity-to-tensor': {\n    module: 'contract',\n    category: 'ml-contract',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Convert entity fields to tensor via contract',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'entity', type: 'object', description: 'Entity data' },\n      { name: 'contract', type: 'object', description: 'Input contract mapping fields to dims' },\n    ],\n    example: '[\"contract/entity-to-tensor\", \"@entity\", \"@entity.inputContract\"]',\n  },\n  'contract/tensor-to-payload': {\n    module: 'contract',\n    category: 'ml-contract',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Convert output tensor to event payload via contract',\n    hasSideEffects: false,\n    returnType: 'object',\n    params: [\n      { name: 'tensor', type: 'tensor', description: 'Output tensor' },\n      { name: 'contract', type: 'object', description: 'Output contract mapping dims to fields' },\n    ],\n    example: '[\"contract/tensor-to-payload\", \"@entity.output\", \"@entity.outputContract\"]',\n  },\n};\n\n/**\n * Get all contract operator names.\n */\nexport function getContractOperators(): string[] {\n  return Object.keys(CONTRACT_OPERATORS);\n}\n"]}

package/dist/modules/data.d.ts

@@ -0,0 +1,22 @@
+import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+
+/**
+ * Data Module - ML Data Preprocessing Operations
+ *
+ * Provides operators for creating datasets, dataloaders, and preprocessing
+ * pipelines for ML training workflows.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Data module operators.
+ * These operators handle dataset creation, splitting, normalization, and augmentation.
+ */
+declare const DATA_OPERATORS: Record<string, StdOperatorMeta>;
+/**
+ * Get all data operator names.
+ */
+declare function getDataOperators(): string[];
+
+export { DATA_OPERATORS, getDataOperators };

package/dist/modules/data.js

@@ -0,0 +1,117 @@
+// modules/data.ts
+var DATA_OPERATORS = {
+  // ============================================================================
+  // Dataset Creation
+  // ============================================================================
+  "data/dataset": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Create dataset from entity collection and contracts",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { name: "entities", type: "array", description: "Entity collection" },
+      { name: "contracts", type: "object", description: "Input/output contract pair" }
+    ],
+    example: '["data/dataset", "@entity.trainingData", "@entity.contracts"]'
+  },
+  "data/dataloader": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Create batched dataloader from dataset",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { name: "dataset", type: "object", description: "Dataset" },
+      { name: "config", type: "object", description: "Config with batch_size, shuffle, etc." }
+    ],
+    example: '["data/dataloader", "@entity.dataset", { "batch-size": 32, "shuffle": true }]'
+  },
+  "data/split": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Train/val/test split",
+    hasSideEffects: false,
+    returnType: "array",
+    params: [
+      { name: "dataset", type: "object", description: "Dataset" },
+      { name: "ratios", type: "array", description: "Split ratios e.g. [0.8, 0.1, 0.1]" }
+    ],
+    example: '["data/split", "@entity.dataset", [0.8, 0.1, 0.1]]'
+  },
+  // ============================================================================
+  // Preprocessing
+  // ============================================================================
+  "data/normalize": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Normalize features (mean/std or min/max)",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "tensor", type: "tensor", description: "Feature tensor" },
+      { name: "config", type: "object", description: "Normalization config (method, per_dim, etc.)" }
+    ],
+    example: '["data/normalize", "@entity.features", { "method": "standard" }]'
+  },
+  "data/augment": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Apply data augmentation",
+    hasSideEffects: false,
+    returnType: "object",
+    params: [
+      { name: "dataset", type: "object", description: "Dataset" },
+      { name: "config", type: "object", description: "Augmentation config" }
+    ],
+    example: '["data/augment", "@entity.dataset", { "flip": true, "rotate": 15 }]'
+  },
+  // ============================================================================
+  // Tokenization & Padding
+  // ============================================================================
+  "data/tokenize": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Tokenize text fields",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "text", type: "string", description: "Text to tokenize" },
+      { name: "config", type: "object", description: "Tokenizer config (method, vocab_size, max_length)" }
+    ],
+    example: '["data/tokenize", "@entity.text", { "method": "bpe", "max-length": 512 }]'
+  },
+  "data/pad": {
+    module: "data",
+    category: "ml-data",
+    minArity: 2,
+    maxArity: 2,
+    description: "Pad sequences to uniform length",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "sequences", type: "array", description: "List of token sequences" },
+      { name: "config", type: "object", description: "Padding config (max_length, pad_value)" }
+    ],
+    example: '["data/pad", "@entity.sequences", { "max-length": 512, "pad-value": 0 }]'
+  }
+};
+function getDataOperators() {
+  return Object.keys(DATA_OPERATORS);
+}
+
+export { DATA_OPERATORS, getDataOperators };
+//# sourceMappingURL=data.js.map
+//# sourceMappingURL=data.js.map

package/dist/modules/data.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/data.ts"],"names":[],"mappings":"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","file":"data.js","sourcesContent":["/**\n * Data Module - ML Data Preprocessing Operations\n *\n * Provides operators for creating datasets, dataloaders, and preprocessing\n * pipelines for ML training workflows.\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Data module operators.\n * These operators handle dataset creation, splitting, normalization, and augmentation.\n */\nexport const DATA_OPERATORS: Record<string, StdOperatorMeta> = {\n  // ============================================================================\n  // Dataset Creation\n  // ============================================================================\n\n  'data/dataset': {\n    module: 'data',\n    category: 'ml-data',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Create dataset from entity collection and contracts',\n    hasSideEffects: false,\n    returnType: 'object',\n    params: [\n      { name: 'entities', type: 'array', description: 'Entity collection' },\n      { name: 'contracts', type: 'object', description: 'Input/output contract pair' },\n    ],\n    example: '[\"data/dataset\", \"@entity.trainingData\", \"@entity.contracts\"]',\n  },\n  'data/dataloader': {\n    module: 'data',\n    category: 'ml-data',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Create batched dataloader from dataset',\n    hasSideEffects: false,\n    returnType: 'object',\n    params: [\n      { name: 'dataset', type: 'object', description: 'Dataset' },\n      { name: 'config', type: 'object', description: 'Config with batch_size, shuffle, etc.' },\n    ],\n    example: '[\"data/dataloader\", \"@entity.dataset\", { \"batch-size\": 32, \"shuffle\": true }]',\n  },\n  'data/split': {\n    module: 'data',\n    category: 'ml-data',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Train/val/test split',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [\n      { name: 'dataset', type: 'object', description: 'Dataset' },\n      { name: 'ratios', type: 'array', description: 'Split ratios e.g. [0.8, 0.1, 0.1]' },\n    ],\n    example: '[\"data/split\", \"@entity.dataset\", [0.8, 0.1, 0.1]]',\n  },\n\n  // ============================================================================\n  // Preprocessing\n  // ============================================================================\n\n  'data/normalize': {\n    module: 'data',\n    category: 'ml-data',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Normalize features (mean/std or min/max)',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'tensor', type: 'tensor', description: 'Feature tensor' },\n      { name: 'config', type: 'object', description: 'Normalization config (method, per_dim, etc.)' },\n    ],\n    example: '[\"data/normalize\", \"@entity.features\", { \"method\": \"standard\" }]',\n  },\n  'data/augment': {\n    module: 'data',\n    category: 'ml-data',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Apply data augmentation',\n    hasSideEffects: false,\n    returnType: 'object',\n    params: [\n      { name: 'dataset', type: 'object', description: 'Dataset' },\n      { name: 'config', type: 'object', description: 'Augmentation config' },\n    ],\n    example: '[\"data/augment\", \"@entity.dataset\", { \"flip\": true, \"rotate\": 15 }]',\n  },\n\n  // ============================================================================\n  // Tokenization & Padding\n  // ============================================================================\n\n  'data/tokenize': {\n    module: 'data',\n    category: 'ml-data',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Tokenize text fields',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'text', type: 'string', description: 'Text to tokenize' },\n      { name: 'config', type: 'object', description: 'Tokenizer config (method, vocab_size, max_length)' },\n    ],\n    example: '[\"data/tokenize\", \"@entity.text\", { \"method\": \"bpe\", \"max-length\": 512 }]',\n  },\n  'data/pad': {\n    module: 'data',\n    category: 'ml-data',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Pad sequences to uniform length',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'sequences', type: 'array', description: 'List of token sequences' },\n      { name: 'config', type: 'object', description: 'Padding config (max_length, pad_value)' },\n    ],\n    example: '[\"data/pad\", \"@entity.sequences\", { \"max-length\": 512, \"pad-value\": 0 }]',\n  },\n};\n\n/**\n * Get all data operator names.\n */\nexport function getDataOperators(): string[] {\n  return Object.keys(DATA_OPERATORS);\n}\n"]}

package/dist/modules/format.d.ts

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

package/dist/modules/graph.d.ts

@@ -0,0 +1,23 @@
+import { a as StdOperatorMeta } from '../types-DOeGXRCm.js';
+
+/**
+ * Graph Module - Graph Neural Network Operations
+ *
+ * Provides operators for building and manipulating graphs for GNN workloads.
+ * Graphs are PyG-style data structures with node features, edge indices,
+ * and optional edge features.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Graph module operators.
+ * These operators build and manipulate graph data structures.
+ */
+declare const GRAPH_OPERATORS: Record<string, StdOperatorMeta>;
+/**
+ * Get all graph operator names.
+ */
+declare function getGraphOperators(): string[];
+
+export { GRAPH_OPERATORS, getGraphOperators };

package/dist/modules/graph.js

@@ -0,0 +1,209 @@
+// modules/graph.ts
+var GRAPH_OPERATORS = {
+  // ============================================================================
+  // Construction
+  // ============================================================================
+  "graph/from-entities": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Build PyG graph from entity collections",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "config", type: "object", description: "Graph construction config (nodes, edges, node-features, edge-features, directed)" }
+    ],
+    example: '["graph/from-entities", { "nodes": "User", "edges": "Follows" }]'
+  },
+  "graph/from-adjacency": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 2,
+    maxArity: 2,
+    description: "Build graph from adjacency matrix and features",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "adjacency", type: "tensor", description: "Adjacency matrix" },
+      { name: "features", type: "tensor", description: "Node feature matrix" }
+    ],
+    example: '["graph/from-adjacency", "@entity.adj", "@entity.features"]'
+  },
+  "graph/from-edge-list": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 2,
+    maxArity: 2,
+    description: "Build graph from edge list and features",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "edges", type: "tensor", description: "Edge index tensor [2, num_edges]" },
+      { name: "features", type: "tensor", description: "Node feature matrix" }
+    ],
+    example: '["graph/from-edge-list", "@entity.edges", "@entity.features"]'
+  },
+  // ============================================================================
+  // Transforms
+  // ============================================================================
+  "graph/add-self-loops": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Add self-loop edges to graph",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/add-self-loops", "@entity.graph"]'
+  },
+  "graph/to-undirected": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Convert directed graph to undirected",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/to-undirected", "@entity.graph"]'
+  },
+  "graph/subgraph": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 2,
+    maxArity: 2,
+    description: "Extract subgraph by node mask",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" },
+      { name: "mask", type: "tensor", description: "Boolean node mask" }
+    ],
+    example: '["graph/subgraph", "@entity.graph", "@entity.mask"]'
+  },
+  "graph/k-hop": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 3,
+    maxArity: 3,
+    description: "K-hop neighborhood subgraph",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" },
+      { name: "node", type: "number", description: "Center node index" },
+      { name: "k", type: "number", description: "Number of hops" }
+    ],
+    example: '["graph/k-hop", "@entity.graph", 0, 2]'
+  },
+  // ============================================================================
+  // Accessors
+  // ============================================================================
+  "graph/node-features": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get node feature matrix",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/node-features", "@entity.graph"]'
+  },
+  "graph/edge-index": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get edge index tensor",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/edge-index", "@entity.graph"]'
+  },
+  "graph/edge-features": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get edge feature matrix",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/edge-features", "@entity.graph"]'
+  },
+  "graph/num-nodes": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get node count",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/num-nodes", "@entity.graph"]'
+  },
+  "graph/num-edges": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get edge count",
+    hasSideEffects: false,
+    returnType: "number",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/num-edges", "@entity.graph"]'
+  },
+  "graph/degree": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Get node degree tensor",
+    hasSideEffects: false,
+    returnType: "tensor",
+    params: [
+      { name: "graph", type: "graph", description: "Input graph" }
+    ],
+    example: '["graph/degree", "@entity.graph"]'
+  },
+  // ============================================================================
+  // Batching
+  // ============================================================================
+  "graph/batch": {
+    module: "graph",
+    category: "ml-graph",
+    minArity: 1,
+    maxArity: 1,
+    description: "Batch multiple graphs into one",
+    hasSideEffects: false,
+    returnType: "graph",
+    params: [
+      { name: "graphs", type: "array", description: "List of graphs" }
+    ],
+    example: '["graph/batch", "@entity.graphs"]'
+  }
+};
+function getGraphOperators() {
+  return Object.keys(GRAPH_OPERATORS);
+}
+
+export { GRAPH_OPERATORS, getGraphOperators };
+//# sourceMappingURL=graph.js.map
+//# sourceMappingURL=graph.js.map

package/dist/modules/graph.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../modules/graph.ts"],"names":[],"mappings":"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","file":"graph.js","sourcesContent":["/**\n * Graph Module - Graph Neural Network Operations\n *\n * Provides operators for building and manipulating graphs for GNN workloads.\n * Graphs are PyG-style data structures with node features, edge indices,\n * and optional edge features.\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Graph module operators.\n * These operators build and manipulate graph data structures.\n */\nexport const GRAPH_OPERATORS: Record<string, StdOperatorMeta> = {\n  // ============================================================================\n  // Construction\n  // ============================================================================\n\n  'graph/from-entities': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Build PyG graph from entity collections',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'config', type: 'object', description: 'Graph construction config (nodes, edges, node-features, edge-features, directed)' },\n    ],\n    example: '[\"graph/from-entities\", { \"nodes\": \"User\", \"edges\": \"Follows\" }]',\n  },\n  'graph/from-adjacency': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Build graph from adjacency matrix and features',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'adjacency', type: 'tensor', description: 'Adjacency matrix' },\n      { name: 'features', type: 'tensor', description: 'Node feature matrix' },\n    ],\n    example: '[\"graph/from-adjacency\", \"@entity.adj\", \"@entity.features\"]',\n  },\n  'graph/from-edge-list': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Build graph from edge list and features',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'edges', type: 'tensor', description: 'Edge index tensor [2, num_edges]' },\n      { name: 'features', type: 'tensor', description: 'Node feature matrix' },\n    ],\n    example: '[\"graph/from-edge-list\", \"@entity.edges\", \"@entity.features\"]',\n  },\n\n  // ============================================================================\n  // Transforms\n  // ============================================================================\n\n  'graph/add-self-loops': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Add self-loop edges to graph',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/add-self-loops\", \"@entity.graph\"]',\n  },\n  'graph/to-undirected': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Convert directed graph to undirected',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/to-undirected\", \"@entity.graph\"]',\n  },\n  'graph/subgraph': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Extract subgraph by node mask',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n      { name: 'mask', type: 'tensor', description: 'Boolean node mask' },\n    ],\n    example: '[\"graph/subgraph\", \"@entity.graph\", \"@entity.mask\"]',\n  },\n  'graph/k-hop': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 3,\n    maxArity: 3,\n    description: 'K-hop neighborhood subgraph',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n      { name: 'node', type: 'number', description: 'Center node index' },\n      { name: 'k', type: 'number', description: 'Number of hops' },\n    ],\n    example: '[\"graph/k-hop\", \"@entity.graph\", 0, 2]',\n  },\n\n  // ============================================================================\n  // Accessors\n  // ============================================================================\n\n  'graph/node-features': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get node feature matrix',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/node-features\", \"@entity.graph\"]',\n  },\n  'graph/edge-index': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get edge index tensor',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/edge-index\", \"@entity.graph\"]',\n  },\n  'graph/edge-features': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get edge feature matrix',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/edge-features\", \"@entity.graph\"]',\n  },\n  'graph/num-nodes': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get node count',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/num-nodes\", \"@entity.graph\"]',\n  },\n  'graph/num-edges': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get edge count',\n    hasSideEffects: false,\n    returnType: 'number',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/num-edges\", \"@entity.graph\"]',\n  },\n  'graph/degree': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get node degree tensor',\n    hasSideEffects: false,\n    returnType: 'tensor',\n    params: [\n      { name: 'graph', type: 'graph', description: 'Input graph' },\n    ],\n    example: '[\"graph/degree\", \"@entity.graph\"]',\n  },\n\n  // ============================================================================\n  // Batching\n  // ============================================================================\n\n  'graph/batch': {\n    module: 'graph',\n    category: 'ml-graph',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Batch multiple graphs into one',\n    hasSideEffects: false,\n    returnType: 'graph',\n    params: [\n      { name: 'graphs', type: 'array', description: 'List of graphs' },\n    ],\n    example: '[\"graph/batch\", \"@entity.graphs\"]',\n  },\n};\n\n/**\n * Get all graph operator names.\n */\nexport function getGraphOperators(): string[] {\n  return Object.keys(GRAPH_OPERATORS);\n}\n"]}

package/dist/modules/index.d.ts

@@ -9,5 +9,9 @@ export { ASYNC_OPERATORS, getAsyncOperators } from './async.js';
 export { NN_OPERATORS, getNnOperators } from './nn.js';
 export { TENSOR_OPERATORS, getTensorOperators } from './tensor.js';
 export { TRAIN_OPERATORS, getTrainOperators } from './train.js';
+export { GRAPH_OPERATORS, getGraphOperators } from './graph.js';
+export { CONTRACT_OPERATORS, getContractOperators } from './contract.js';
+export { DATA_OPERATORS, getDataOperators } from './data.js';
 export { PROB_OPERATORS, getProbOperators } from './prob.js';
-import '../types-CmNM_IbV.js';
+export { OS_OPERATORS } from './os.js';
+import '../types-DOeGXRCm.js';