@doki-land/dejavu-engine 0.0.14 → 0.0.15

package/dist/runtime/errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Structured runtime error for generated AOT modules.
+ *
+ * Generated code never throws a bare `Error`: every failure carries the stable
+ * diagnostic `code`, the `render` stage, structured `args` and a human-readable
+ * message so hosts can classify errors without parsing `message`.
+ */
+export declare class DejavuRuntimeError extends Error {
+    readonly code: string;
+    readonly stage = "render";
+    readonly args: Record<string, unknown>;
+    constructor(code: string, detail?: string, args?: Record<string, unknown>);
+}
+/** Build a structured render error. */
+export declare function runtimeError(code: string, detail?: string, args?: Record<string, unknown>): DejavuRuntimeError;

package/dist/runtime/errors.js

@@ -0,0 +1,22 @@
+/**
+ * Structured runtime error for generated AOT modules.
+ *
+ * Generated code never throws a bare `Error`: every failure carries the stable
+ * diagnostic `code`, the `render` stage, structured `args` and a human-readable
+ * message so hosts can classify errors without parsing `message`.
+ */
+export class DejavuRuntimeError extends Error {
+    code;
+    stage = "render";
+    args;
+    constructor(code, detail, args) {
+        super(detail ? `${code}: ${detail}` : code);
+        this.name = "DejavuRuntimeError";
+        this.code = code;
+        this.args = args ?? {};
+    }
+}
+/** Build a structured render error. */
+export function runtimeError(code, detail, args) {
+    return new DejavuRuntimeError(code, detail, args);
+}

package/dist/runtime/filter.js

@@ -1,4 +1,5 @@
 import { htmlEscape } from "./escape.js";
+import { runtimeError } from "./errors.js";
 import { valueToString } from "./value.js";
 /** 与 Rust `dejavu_ir::registry::FILTERS` 同序同构的静态描述。 */
 export const FILTERS = [
@@ -20,11 +21,16 @@ export function filterSpec(name) {
 export function applyFilter(name, value, args) {
     const spec = filterSpec(name);
     if (!spec) {
-        throw new Error(`dejavu.template.unknown-filter: ${name}`);
+        throw runtimeError("dejavu.template.unknown-filter", name, { filter: name });
     }
     if (args.length < spec.minArgs || args.length > spec.maxArgs) {
-        throw new Error(`dejavu.template.filter-arity: ${spec.name} expects ` +
-            `${spec.minArgs}..${spec.maxArgs} argument(s), got ${args.length}`);
+        throw runtimeError("dejavu.template.filter-arity", `${spec.name} expects ` +
+            `${spec.minArgs}..${spec.maxArgs} argument(s), got ${args.length}`, {
+            filter: spec.name,
+            minArgs: spec.minArgs,
+            maxArgs: spec.maxArgs,
+            got: args.length,
+        });
     }
     switch (name) {
         case "escape":
@@ -77,7 +83,7 @@ export function applyFilter(name, value, args) {
             return slugify(valueToString(value));
         default:
             // Unreachable: `filterSpec` already rejected unknown names.
-            throw new Error(`dejavu.template.unknown-filter: ${name}`);
+            throw runtimeError("dejavu.template.unknown-filter", name);
     }
 }
 /**

package/dist/runtime/function.d.ts

@@ -9,6 +9,7 @@ export interface FunctionSpec {
     aliases: string[];
     minArgs: number;
     maxArgs: number;
+    capability: string;
 }
 /** 与 Rust `dejavu_ir::registry::FUNCTIONS` 同序同构的静态描述。 */
 export declare const FUNCTIONS: readonly FunctionSpec[];

package/dist/runtime/function.js

@@ -4,11 +4,12 @@
  * 与 Rust `dejavu_ir::registry::FUNCTIONS` 和 `builtins::call_function` 对齐。
  * 仅允许 `name(args)` 形式的裸标识符调用；成员调用与未知名字一律报错。
  */
+import { runtimeError } from "./errors.js";
 /** 与 Rust `dejavu_ir::registry::FUNCTIONS` 同序同构的静态描述。 */
 export const FUNCTIONS = [
-    { name: "range", aliases: [], minArgs: 2, maxArgs: 3 },
-    { name: "min", aliases: [], minArgs: 2, maxArgs: 2 },
-    { name: "max", aliases: [], minArgs: 2, maxArgs: 2 },
+    { name: "range", aliases: [], minArgs: 2, maxArgs: 3, capability: "pure" },
+    { name: "min", aliases: [], minArgs: 2, maxArgs: 2, capability: "pure" },
+    { name: "max", aliases: [], minArgs: 2, maxArgs: 2, capability: "pure" },
 ];
 /** `range` 允许产出的最大元素数，与 Rust `RANGE_LIMIT` 一致。 */
 const RANGE_LIMIT = 10_000;
@@ -18,11 +19,16 @@ export function functionSpec(name) {
 export function callFunction(name, args) {
     const spec = functionSpec(name);
     if (!spec) {
-        throw new Error(`dejavu.template.unknown-function: ${name}`);
+        throw runtimeError("dejavu.template.unknown-function", name, { function: name });
     }
     if (args.length < spec.minArgs || args.length > spec.maxArgs) {
-        throw new Error(`dejavu.template.function-arity: ${spec.name} expects ` +
-            `${spec.minArgs}..${spec.maxArgs} argument(s), got ${args.length}`);
+        throw runtimeError("dejavu.template.function-arity", `${spec.name} expects ` +
+            `${spec.minArgs}..${spec.maxArgs} argument(s), got ${args.length}`, {
+            function: spec.name,
+            minArgs: spec.minArgs,
+            maxArgs: spec.maxArgs,
+            got: args.length,
+        });
     }
     switch (spec.name) {
         case "range":
@@ -33,7 +39,7 @@ export function callFunction(name, args) {
             return numericPair(args, false);
         default:
             // Unreachable: `functionSpec` already rejected unknown names.
-            throw new Error(`dejavu.template.unknown-function: ${name}`);
+            throw runtimeError("dejavu.template.unknown-function", name);
     }
 }
 /** `range(start, stop, step=1)`，非法输入按值模型规则返回 null。 */

package/dist/runtime/index.d.ts

@@ -5,6 +5,7 @@
  * 与 Rust `dejavu-codegen` Node stub 以及 `dejavu-types` 的 filter 系统语义一致。
  */
 export { htmlEscape } from "./escape.js";
+export { DejavuRuntimeError, runtimeError } from "./errors.js";
 export { valueToString, isTruthy, valuesEqual } from "./value.js";
 export { applyFilter } from "./filter.js";
 export { FUNCTIONS, functionSpec, callFunction } from "./function.js";

package/dist/runtime/index.js

@@ -5,6 +5,7 @@
  * 与 Rust `dejavu-codegen` Node stub 以及 `dejavu-types` 的 filter 系统语义一致。
  */
 export { htmlEscape } from "./escape.js";
+export { DejavuRuntimeError, runtimeError } from "./errors.js";
 export { valueToString, isTruthy, valuesEqual } from "./value.js";
 export { applyFilter } from "./filter.js";
 export { FUNCTIONS, functionSpec, callFunction } from "./function.js";

package/dist/runtime/test.d.ts

@@ -10,6 +10,7 @@ export interface TestSpec {
     aliases: string[];
     minArgs: number;
     maxArgs: number;
+    capability: string;
 }
 /** 与 Rust `dejavu_ir::registry::TESTS` 同序同构的静态描述。 */
 export declare const TESTS: readonly TestSpec[];

package/dist/runtime/test.js

@@ -5,19 +5,20 @@
  * 语法为 `expr is name` / `expr is not name` / `expr is name(args)`，
  * 本文件只负责对已求值的左值执行谓词。
  */
+import { runtimeError } from "./errors.js";
 import { isTruthy } from "./value.js";
 /** 与 Rust `dejavu_ir::registry::TESTS` 同序同构的静态描述。 */
 export const TESTS = [
-    { name: "null", aliases: ["none"], minArgs: 0, maxArgs: 0 },
-    { name: "truthy", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "empty", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "array", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "object", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "string", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "number", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "boolean", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "even", aliases: [], minArgs: 0, maxArgs: 0 },
-    { name: "odd", aliases: [], minArgs: 0, maxArgs: 0 },
+    { name: "null", aliases: ["none"], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "truthy", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "empty", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "array", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "object", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "string", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "number", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "boolean", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "even", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
+    { name: "odd", aliases: [], minArgs: 0, maxArgs: 0, capability: "pure" },
 ];
 export function testSpec(name) {
     return TESTS.find((spec) => spec.name === name || spec.aliases.includes(name));
@@ -26,11 +27,16 @@ export function testSpec(name) {
 export function applyTest(name, value, args, negated = false) {
     const spec = testSpec(name);
     if (!spec) {
-        throw new Error(`dejavu.template.unknown-test: ${name}`);
+        throw runtimeError("dejavu.template.unknown-test", name, { test: name });
     }
     if (args.length < spec.minArgs || args.length > spec.maxArgs) {
-        throw new Error(`dejavu.template.test-arity: ${spec.name} expects ` +
-            `${spec.minArgs}..${spec.maxArgs} argument(s), got ${args.length}`);
+        throw runtimeError("dejavu.template.test-arity", `${spec.name} expects ` +
+            `${spec.minArgs}..${spec.maxArgs} argument(s), got ${args.length}`, {
+            test: spec.name,
+            minArgs: spec.minArgs,
+            maxArgs: spec.maxArgs,
+            got: args.length,
+        });
     }
     let result;
     switch (spec.name) {
@@ -69,7 +75,7 @@ export function applyTest(name, value, args, negated = false) {
             break;
         default:
             // Unreachable: `testSpec` already rejected unknown names.
-            throw new Error(`dejavu.template.unknown-test: ${name}`);
+            throw runtimeError("dejavu.template.unknown-test", name);
     }
     return result !== negated;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doki-land/dejavu-engine",
-  "version": "0.0.14",
+  "version": "0.0.15",
   "description": "Dejavu pure TypeScript AOT runtime — generated template modules depend on this package",
   "type": "module",
   "license": "MPL-2.0",