@almadar/std 13.6.0 → 13.8.0

package/dist/modules/math.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Math Module - Numeric Operations

package/dist/modules/nn.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Neural Network Module - Neural Network Operations

package/dist/modules/object.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Object Module - Object Operations

package/dist/modules/object.js

@@ -49,9 +49,10 @@ var OBJECT_OPERATORS = {
     category: "std-object",
     minArity: 2,
     maxArity: 3,
-    description: "Get nested value by path",
+    description: "Get nested value by path (return type derived from input object shape and key)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "object-key-lookup",
     params: [
       { name: "obj", type: "object", description: "The object" },
       { name: "path", type: "string", description: 'Dot-separated path (e.g., "user.name")' },
@@ -115,9 +116,10 @@ var OBJECT_OPERATORS = {
     category: "std-object",
     minArity: 2,
     maxArity: 2,
-    description: "Select only specified keys",
+    description: "Select only specified keys (return type is subset of input object shape)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "object-key-lookup",
     params: [
       { name: "obj", type: "object", description: "The object" },
       { name: "keys", type: "array", description: "Keys to keep" }

package/dist/modules/object.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../modules/object.ts"],"names":[],"mappings":"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","file":"object.js","sourcesContent":["/**\n * Object Module - Object Operations\n *\n * Provides object manipulation and transformation functions.\n * All operations are immutable (return new objects).\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Object module operators.\n * All operators return objects or other values and have no side effects.\n */\nexport const OBJECT_OPERATORS: Record<string, StdOperatorMeta> = {\n  'object/keys': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get object keys as array',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/keys\", {\"a\": 1, \"b\": 2}] // => [\"a\", \"b\"]',\n  },\n  'object/values': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get object values as array',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/values\", {\"a\": 1, \"b\": 2}] // => [1, 2]',\n  },\n  'object/entries': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get [key, value] pairs as array',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/entries\", {\"a\": 1}] // => [[\"a\", 1]]',\n  },\n  'object/fromEntries': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Create object from [key, value] pairs',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: 'entries', type: 'array', description: 'Array of [key, value] pairs' }],\n    example: '[\"object/fromEntries\", [[\"a\", 1], [\"b\", 2]]] // => {\"a\": 1, \"b\": 2}',\n  },\n  'object/get': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 3,\n    description: 'Get nested value by path',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'path', type: 'string', description: 'Dot-separated path (e.g., \"user.name\")' },\n      { name: 'default', type: 'any', description: 'Default if path not found', optional: true },\n    ],\n    example: '[\"object/get\", \"@user\", \"profile.name\", \"Anonymous\"]',\n  },\n  'object/set': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 3,\n    maxArity: 3,\n    description: 'Set nested value by path (returns new object)',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'path', type: 'string', description: 'Dot-separated path' },\n      { name: 'value', type: 'any', description: 'Value to set' },\n    ],\n    example: '[\"object/set\", \"@user\", \"profile.name\", \"John\"]',\n  },\n  'object/has': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Check if path exists',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'path', type: 'string', description: 'Dot-separated path' },\n    ],\n    example: '[\"object/has\", \"@user\", \"profile.name\"]',\n  },\n  'object/merge': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: null,\n    description: 'Shallow merge objects (later wins)',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: '...objs', type: 'object[]', description: 'Objects to merge' }],\n    example: '[\"object/merge\", {\"a\": 1}, {\"b\": 2}] // => {\"a\": 1, \"b\": 2}',\n  },\n  'object/deepMerge': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: null,\n    description: 'Deep merge objects (later wins)',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: '...objs', type: 'object[]', description: 'Objects to merge' }],\n    example: '[\"object/deepMerge\", {\"a\": {\"b\": 1}}, {\"a\": {\"c\": 2}}]',\n  },\n  'object/pick': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Select only specified keys',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'keys', type: 'array', description: 'Keys to keep' },\n    ],\n    example: '[\"object/pick\", \"@entity\", [\"name\", \"email\"]]',\n  },\n  'object/omit': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Exclude specified keys',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'keys', type: 'array', description: 'Keys to exclude' },\n    ],\n    example: '[\"object/omit\", \"@entity\", [\"password\", \"secret\"]]',\n  },\n  'object/mapValues': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Transform all values',\n    hasSideEffects: false,\n    returnType: 'any',\n    acceptsLambda: true,\n    lambdaArgPosition: 1,\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'fn', type: 'lambda', description: 'Transform function' },\n    ],\n    example: '[\"object/mapValues\", \"@stats\", [\"fn\", \"v\", [\"*\", \"@v\", 100]]]',\n  },\n  'object/mapKeys': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Transform all keys',\n    hasSideEffects: false,\n    returnType: 'any',\n    acceptsLambda: true,\n    lambdaArgPosition: 1,\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'fn', type: 'lambda', description: 'Transform function' },\n    ],\n    example: '[\"object/mapKeys\", \"@data\", [\"fn\", \"k\", [\"str/upper\", \"@k\"]]]',\n  },\n  'object/filter': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Filter entries by predicate',\n    hasSideEffects: false,\n    returnType: 'any',\n    acceptsLambda: true,\n    lambdaArgPosition: 1,\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'pred', type: 'lambda', description: 'Predicate (key, value) => boolean' },\n    ],\n    example: '[\"object/filter\", \"@data\", [\"fn\", [\"k\", \"v\"], [\"!=\", \"@v\", null]]]',\n  },\n  'object/empty?': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Check if object has no keys',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/empty?\", {}] // => true',\n  },\n  'object/equals': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Deep equality check',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [\n      { name: 'a', type: 'object', description: 'First object' },\n      { name: 'b', type: 'object', description: 'Second object' },\n    ],\n    example: '[\"object/equals\", {\"a\": 1}, {\"a\": 1}] // => true',\n  },\n  'object/clone': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Shallow clone object',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/clone\", \"@entity\"]',\n  },\n  'object/deepClone': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Deep clone object',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/deepClone\", \"@entity\"]',\n  },\n  'path': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: null, // variadic\n    description: 'Build a dot-separated path string from segments. Used with set effect for dynamic field paths.',\n    hasSideEffects: false,\n    returnType: 'string',\n    params: [\n      { name: '...segments', type: 'string[]', description: 'Path segments to join with dots' },\n    ],\n    example: '[\"path\", \"formValues\", \"@payload.fieldId\"] // => \"formValues.customerName\"',\n  },\n};\n\n/**\n * Get all object operator names.\n */\nexport function getObjectOperators(): string[] {\n  return Object.keys(OBJECT_OPERATORS);\n}\n"]}
+{"version":3,"sources":["../../modules/object.ts"],"names":[],"mappings":"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","file":"object.js","sourcesContent":["/**\n * Object Module - Object Operations\n *\n * Provides object manipulation and transformation functions.\n * All operations are immutable (return new objects).\n *\n * @packageDocumentation\n */\n\nimport type { StdOperatorMeta } from '../types.js';\n\n/**\n * Object module operators.\n * All operators return objects or other values and have no side effects.\n */\nexport const OBJECT_OPERATORS: Record<string, StdOperatorMeta> = {\n  'object/keys': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get object keys as array',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/keys\", {\"a\": 1, \"b\": 2}] // => [\"a\", \"b\"]',\n  },\n  'object/values': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get object values as array',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/values\", {\"a\": 1, \"b\": 2}] // => [1, 2]',\n  },\n  'object/entries': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Get [key, value] pairs as array',\n    hasSideEffects: false,\n    returnType: 'array',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/entries\", {\"a\": 1}] // => [[\"a\", 1]]',\n  },\n  'object/fromEntries': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Create object from [key, value] pairs',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: 'entries', type: 'array', description: 'Array of [key, value] pairs' }],\n    example: '[\"object/fromEntries\", [[\"a\", 1], [\"b\", 2]]] // => {\"a\": 1, \"b\": 2}',\n  },\n  'object/get': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 3,\n    description: 'Get nested value by path (return type derived from input object shape and key)',\n    hasSideEffects: false,\n    returnType: 'any',\n    returnSemantics: 'object-key-lookup',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'path', type: 'string', description: 'Dot-separated path (e.g., \"user.name\")' },\n      { name: 'default', type: 'any', description: 'Default if path not found', optional: true },\n    ],\n    example: '[\"object/get\", \"@user\", \"profile.name\", \"Anonymous\"]',\n  },\n  'object/set': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 3,\n    maxArity: 3,\n    description: 'Set nested value by path (returns new object)',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'path', type: 'string', description: 'Dot-separated path' },\n      { name: 'value', type: 'any', description: 'Value to set' },\n    ],\n    example: '[\"object/set\", \"@user\", \"profile.name\", \"John\"]',\n  },\n  'object/has': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Check if path exists',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'path', type: 'string', description: 'Dot-separated path' },\n    ],\n    example: '[\"object/has\", \"@user\", \"profile.name\"]',\n  },\n  'object/merge': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: null,\n    description: 'Shallow merge objects (later wins)',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: '...objs', type: 'object[]', description: 'Objects to merge' }],\n    example: '[\"object/merge\", {\"a\": 1}, {\"b\": 2}] // => {\"a\": 1, \"b\": 2}',\n  },\n  'object/deepMerge': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: null,\n    description: 'Deep merge objects (later wins)',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: '...objs', type: 'object[]', description: 'Objects to merge' }],\n    example: '[\"object/deepMerge\", {\"a\": {\"b\": 1}}, {\"a\": {\"c\": 2}}]',\n  },\n  'object/pick': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Select only specified keys (return type is subset of input object shape)',\n    hasSideEffects: false,\n    returnType: 'any',\n    returnSemantics: 'object-key-lookup',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'keys', type: 'array', description: 'Keys to keep' },\n    ],\n    example: '[\"object/pick\", \"@entity\", [\"name\", \"email\"]]',\n  },\n  'object/omit': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Exclude specified keys',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'keys', type: 'array', description: 'Keys to exclude' },\n    ],\n    example: '[\"object/omit\", \"@entity\", [\"password\", \"secret\"]]',\n  },\n  'object/mapValues': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Transform all values',\n    hasSideEffects: false,\n    returnType: 'any',\n    acceptsLambda: true,\n    lambdaArgPosition: 1,\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'fn', type: 'lambda', description: 'Transform function' },\n    ],\n    example: '[\"object/mapValues\", \"@stats\", [\"fn\", \"v\", [\"*\", \"@v\", 100]]]',\n  },\n  'object/mapKeys': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Transform all keys',\n    hasSideEffects: false,\n    returnType: 'any',\n    acceptsLambda: true,\n    lambdaArgPosition: 1,\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'fn', type: 'lambda', description: 'Transform function' },\n    ],\n    example: '[\"object/mapKeys\", \"@data\", [\"fn\", \"k\", [\"str/upper\", \"@k\"]]]',\n  },\n  'object/filter': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Filter entries by predicate',\n    hasSideEffects: false,\n    returnType: 'any',\n    acceptsLambda: true,\n    lambdaArgPosition: 1,\n    params: [\n      { name: 'obj', type: 'object', description: 'The object' },\n      { name: 'pred', type: 'lambda', description: 'Predicate (key, value) => boolean' },\n    ],\n    example: '[\"object/filter\", \"@data\", [\"fn\", [\"k\", \"v\"], [\"!=\", \"@v\", null]]]',\n  },\n  'object/empty?': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Check if object has no keys',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/empty?\", {}] // => true',\n  },\n  'object/equals': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 2,\n    maxArity: 2,\n    description: 'Deep equality check',\n    hasSideEffects: false,\n    returnType: 'boolean',\n    params: [\n      { name: 'a', type: 'object', description: 'First object' },\n      { name: 'b', type: 'object', description: 'Second object' },\n    ],\n    example: '[\"object/equals\", {\"a\": 1}, {\"a\": 1}] // => true',\n  },\n  'object/clone': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Shallow clone object',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/clone\", \"@entity\"]',\n  },\n  'object/deepClone': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: 1,\n    description: 'Deep clone object',\n    hasSideEffects: false,\n    returnType: 'any',\n    params: [{ name: 'obj', type: 'object', description: 'The object' }],\n    example: '[\"object/deepClone\", \"@entity\"]',\n  },\n  'path': {\n    module: 'object',\n    category: 'std-object',\n    minArity: 1,\n    maxArity: null, // variadic\n    description: 'Build a dot-separated path string from segments. Used with set effect for dynamic field paths.',\n    hasSideEffects: false,\n    returnType: 'string',\n    params: [\n      { name: '...segments', type: 'string[]', description: 'Path segments to join with dots' },\n    ],\n    example: '[\"path\", \"formValues\", \"@payload.fieldId\"] // => \"formValues.customerName\"',\n  },\n};\n\n/**\n * Get all object operator names.\n */\nexport function getObjectOperators(): string[] {\n  return Object.keys(OBJECT_OPERATORS);\n}\n"]}

package/dist/modules/os.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * OS Module - Operating System Event Watchers

package/dist/modules/prob.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Prob Module - Probabilistic Programming Operators

package/dist/modules/str.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * String Module - String Operations

package/dist/modules/tensor.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Tensor Module - Tensor Operations

package/dist/modules/time.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Time Module - Date and Time Operations

package/dist/modules/train.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Training Module - Neural Network Training Operations

package/dist/modules/validate.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta } from '../types-D7dG8fBF.js';
+import { S as StdOperatorMeta } from '../types-CdSN5hnD.js';
 
 /**
  * Validate Module - Input Validation

package/dist/registry.d.ts

@@ -1,4 +1,4 @@
-import { S as StdOperatorMeta, a as StdModule, O as OperatorMeta } from './types-D7dG8fBF.js';
+import { S as StdOperatorMeta, a as StdModule, O as OperatorMeta } from './types-CdSN5hnD.js';
 
 /**
  * Standard Library Registry

package/dist/registry.js

@@ -227,9 +227,10 @@ var CORE_OPERATORS = {
     category: "logic",
     minArity: 2,
     maxArity: null,
-    description: "Logical AND",
+    description: "Logical AND (returns the last truthy value, NOT a boolean \u2014 short-circuit)",
     hasSideEffects: false,
     returnType: "boolean",
+    returnSemantics: "last-truthy-of-args",
     params: [{ name: "...conds", type: BOOLEAN, description: "Boolean expressions to AND" }],
     example: '["and", ["=", "@entity.active", true], [">", "@entity.score", 0]]'
   },
@@ -238,9 +239,10 @@ var CORE_OPERATORS = {
     category: "logic",
     minArity: 2,
     maxArity: null,
-    description: "Logical OR",
+    description: "Logical OR (returns the first truthy value, NOT a boolean \u2014 short-circuit)",
     hasSideEffects: false,
     returnType: "boolean",
+    returnSemantics: "first-truthy-of-args",
     params: [{ name: "...conds", type: BOOLEAN, description: "Boolean expressions to OR" }],
     example: '["or", ["=", "@entity.role", "admin"], ["=", "@entity.role", "owner"]]'
   },
@@ -260,9 +262,10 @@ var CORE_OPERATORS = {
     category: "logic",
     minArity: 3,
     maxArity: 3,
-    description: "Conditional expression (ternary)",
+    description: "Conditional expression (ternary). Return type is union of branch types.",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "branch-union",
     params: [
       { name: "cond", type: BOOLEAN, description: "Condition to evaluate" },
       { name: "then", type: ANY, description: "Value or effect if true" },
@@ -1236,9 +1239,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 1,
     maxArity: 1,
-    description: "Get first element",
+    description: "Get first element (element type of input array, may be undefined when empty)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "element-of-arg<0>?",
     params: [{ name: "arr", type: "array", description: "The array" }],
     example: '["array/first", [1, 2, 3]] // => 1'
   },
@@ -1247,9 +1251,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 1,
     maxArity: 1,
-    description: "Get last element",
+    description: "Get last element (element type of input array, may be undefined when empty)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "element-of-arg<0>?",
     params: [{ name: "arr", type: "array", description: "The array" }],
     example: '["array/last", [1, 2, 3]] // => 3'
   },
@@ -1258,9 +1263,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 2,
     maxArity: 2,
-    description: "Get element at index",
+    description: "Get element at index (element type of input array, may be undefined out-of-bounds)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "element-of-arg<0>?",
     params: [
       { name: "arr", type: "array", description: "The array" },
       { name: "index", type: "number", description: "Index (0-based)" }
@@ -1470,9 +1476,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 2,
     maxArity: 2,
-    description: "Find first element matching predicate",
+    description: "Find first element matching predicate (element type of input array, undefined when no match)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "element-of-arg<0>?",
     acceptsLambda: true,
     lambdaArgPosition: 1,
     params: [
@@ -1502,9 +1509,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 2,
     maxArity: 2,
-    description: "Keep elements matching predicate",
+    description: "Keep elements matching predicate (returns same array element type as input)",
     hasSideEffects: false,
     returnType: "array",
+    returnSemantics: "identity-of-arg<0>",
     acceptsLambda: true,
     lambdaArgPosition: 1,
     params: [
@@ -1518,9 +1526,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 2,
     maxArity: 2,
-    description: "Remove elements matching predicate",
+    description: "Remove elements matching predicate (returns same array element type as input)",
     hasSideEffects: false,
     returnType: "array",
+    returnSemantics: "identity-of-arg<0>",
     acceptsLambda: true,
     lambdaArgPosition: 1,
     params: [
@@ -1534,9 +1543,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 2,
     maxArity: 2,
-    description: "Transform each element",
+    description: "Transform each element (return type wraps the lambda result in an array)",
     hasSideEffects: false,
     returnType: "array",
+    returnSemantics: "lambda-result",
     acceptsLambda: true,
     lambdaArgPosition: 1,
     params: [
@@ -1550,9 +1560,10 @@ var ARRAY_OPERATORS = {
     category: "std-array",
     minArity: 3,
     maxArity: 3,
-    description: "Reduce array to single value",
+    description: "Reduce array to single value (return type matches the lambda result / init type)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "lambda-result",
     acceptsLambda: true,
     lambdaArgPosition: 1,
     params: [
@@ -1805,9 +1816,10 @@ var OBJECT_OPERATORS = {
     category: "std-object",
     minArity: 2,
     maxArity: 3,
-    description: "Get nested value by path",
+    description: "Get nested value by path (return type derived from input object shape and key)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "object-key-lookup",
     params: [
       { name: "obj", type: "object", description: "The object" },
       { name: "path", type: "string", description: 'Dot-separated path (e.g., "user.name")' },
@@ -1871,9 +1883,10 @@ var OBJECT_OPERATORS = {
     category: "std-object",
     minArity: 2,
     maxArity: 2,
-    description: "Select only specified keys",
+    description: "Select only specified keys (return type is subset of input object shape)",
     hasSideEffects: false,
     returnType: "any",
+    returnSemantics: "object-key-lookup",
     params: [
       { name: "obj", type: "object", description: "The object" },
       { name: "keys", type: "array", description: "Keys to keep" }