@almadar/std 16.141.0 → 16.143.0

package/dist/registry.d.ts

@@ -82,6 +82,14 @@ declare function getStdPureOperators(): string[];
  * @returns Error message if invalid, null if valid
  */
 declare function validateStdOperatorArity(operator: string, argCount: number): string | null;
+/**
+ * Throw when a registered operator is applied outside its canonical arity
+ * bounds — the interpreter-side (`@almadar/evaluator`) mirror of the compiled
+ * path's `resolve_sexpr_call` check, so a schema fails identically on both
+ * execution paths. Unregistered heads are a no-op: the interpreter treats them
+ * as data-array literals, not operator calls.
+ */
+declare function assertOperatorArity(operator: string, argCount: number): void;
 /**
  * Check if a std operator is valid in guard context (no side effects).
  *
@@ -141,4 +149,4 @@ declare function getStdLibStats(): {
     lambdaOperators: number;
 };
 
-export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };
+export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };

package/dist/registry.js

@@ -6410,6 +6410,17 @@ function validateStdOperatorArity(operator, argCount) {
   }
   return null;
 }
+function assertOperatorArity(operator, argCount) {
+  const meta = STD_OPERATORS[operator];
+  if (!meta) return;
+  const { minArity, maxArity } = meta;
+  if (argCount < minArity || maxArity !== null && argCount > maxArity) {
+    const range = maxArity === null ? `at least ${minArity}` : minArity === maxArity ? `${minArity}` : `${minArity}..${maxArity}`;
+    throw new Error(
+      `(${operator} \u2026): expected ${range} argument(s), got ${argCount} \u2014 same bounds the compiled path enforces (canonical-operators.json)`
+    );
+  }
+}
 function isStdGuardOperator(operator) {
   const meta = STD_OPERATORS[operator];
   return meta !== void 0 && !meta.hasSideEffects;
@@ -6467,4 +6478,4 @@ function getStdLibStats() {
   };
 }
 
-export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };
+export { OPERATOR_NAMES, STD_OPERATORS, STD_OPERATORS_BY_MODULE, assertOperatorArity, getAllStdOperators, getLambdaOperators, getModuleOperators, getOperatorMetaExtended, getStdEffectOperators, getStdLibStats, getStdOperatorMeta, getStdOperatorsByModule, getStdPureOperators, isEffectOperatorExtended, isKnownOperatorExtended, isKnownStdOperator, isStdEffectOperator, isStdGuardOperator, validateOperatorArityExtended, validateStdOperatorArity };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/std",
-  "version": "16.141.0",
+  "version": "16.143.0",
   "description": "Standard library operators for Almadar (math, string, array, etc.)",
   "type": "module",
   "main": "./dist/index.js",
@@ -35,7 +35,8 @@
     "./factory-runtime": {
       "import": "./dist/factory-runtime/index.js",
       "types": "./dist/factory-runtime/index.d.ts"
-    }
+    },
+    "./canonical-operators.json": "./canonical-operators.json"
   },
   "files": [
     "dist",
@@ -48,10 +49,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.31.0"
+    "@almadar/core": "^10.33.0"
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": "^2.14.0",
+    "@almadar/eslint-plugin": "^2.15.0",
     "@almadar/llm": "^2.35.0",
     "@types/node": "^20.0.0",
     "@typescript-eslint/parser": "8.56.0",