@doki-land/dejavu-engine 0.0.0 → 0.0.8

package/dist/runtime/escape.d.ts

@@ -0,0 +1,7 @@
+/**
+ * HTML escape — 转义 Dejavu 输出中的 5 个危险字符。
+ *
+ * 与 Rust `dejavu-types` 的 `html_escape` 过滤器、Node stub 以及
+ * legacy TS engine 行为完全一致。只处理 `& < > " '`。
+ */
+export declare function htmlEscape(str: string): string;

package/dist/runtime/escape.js

@@ -0,0 +1,14 @@
+/**
+ * HTML escape — 转义 Dejavu 输出中的 5 个危险字符。
+ *
+ * 与 Rust `dejavu-types` 的 `html_escape` 过滤器、Node stub 以及
+ * legacy TS engine 行为完全一致。只处理 `& < > " '`。
+ */
+export function htmlEscape(str) {
+    return String(str)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+}

package/dist/runtime/expr.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Dejavu 1.0 支持的二元运算符。
+ * 与 Rust `dejavu-ir::IrExprBinaryOp` 枚举一一对应。
+ *
+ * 行为：
+ * - `+` 特殊：任何一侧为字符串时做字符串拼接，否则数值加法。
+ * - `&&` / `||` 返回原值（短路），不是布尔。
+ * - `in`：R 是 object / array 时检查 key 存在。
+ * - 比较与相等用 JS 原生语义。
+ */
+export declare function binary(op: string, l: unknown, r: unknown): unknown;
+/**
+ * 一元运算符。
+ *
+ * `!` 使用 **Dejavu truthiness**（不是 JS falsy）。
+ */
+export declare function unary(op: string, a: unknown): unknown;
+/**
+ * 成员访问 —— `obj?.[property] ?? null`。
+ * 对不存在的键返回 null（不是 undefined）。
+ */
+export declare function exprMember(obj: unknown, property: string): unknown;
+/**
+ * 索引访问 —— 数组用数字索引（|0 截断），对象用 String(index)。
+ * 越界 / 不存在返回 null。
+ */
+export declare function exprIndex(obj: unknown, index: unknown): unknown;

package/dist/runtime/expr.js

@@ -0,0 +1,104 @@
+import { isTruthy } from "./value.js";
+/**
+ * Dejavu 1.0 支持的二元运算符。
+ * 与 Rust `dejavu-ir::IrExprBinaryOp` 枚举一一对应。
+ *
+ * 行为：
+ * - `+` 特殊：任何一侧为字符串时做字符串拼接，否则数值加法。
+ * - `&&` / `||` 返回原值（短路），不是布尔。
+ * - `in`：R 是 object / array 时检查 key 存在。
+ * - 比较与相等用 JS 原生语义。
+ */
+export function binary(op, l, r) {
+    switch (op) {
+        case "+": {
+            if (typeof l === "string" || typeof r === "string") {
+                return String(l) + String(r);
+            }
+            return l + r;
+        }
+        case "-":
+            return l - r;
+        case "*":
+            return l * r;
+        case "/":
+            return l / r;
+        case "%":
+            return l % r;
+        case "==":
+            // Dejavu 1.0 只用 ==/!= —— JS 宽松相等
+            // eslint-disable-next-line eqeqeq
+            return l == r;
+        case "!=":
+            // eslint-disable-next-line eqeqeq
+            return l != r;
+        case "===":
+            return l === r;
+        case "!==":
+            return l !== r;
+        case "<":
+            return l < r;
+        case "<=":
+            return l <= r;
+        case ">":
+            return l > r;
+        case ">=":
+            return l >= r;
+        case "&&":
+            return l && r;
+        case "||":
+            return l || r;
+        case "in":
+            if (r === null || r === undefined)
+                return false;
+            return String(l) in r;
+        default:
+            return null;
+    }
+}
+/**
+ * 一元运算符。
+ *
+ * `!` 使用 **Dejavu truthiness**（不是 JS falsy）。
+ */
+export function unary(op, a) {
+    switch (op) {
+        case "!":
+            return !isTruthy(a);
+        case "-":
+            return -(Number(a) || 0);
+        case "+":
+            return +(Number(a) || 0);
+        default:
+            return null;
+    }
+}
+/**
+ * 成员访问 —— `obj?.[property] ?? null`。
+ * 对不存在的键返回 null（不是 undefined）。
+ */
+export function exprMember(obj, property) {
+    if (obj === null || obj === undefined)
+        return null;
+    const target = obj;
+    const v = target[property];
+    return v === undefined ? null : v;
+}
+/**
+ * 索引访问 —— 数组用数字索引（|0 截断），对象用 String(index)。
+ * 越界 / 不存在返回 null。
+ */
+export function exprIndex(obj, index) {
+    if (obj === null || obj === undefined)
+        return null;
+    if (Array.isArray(obj)) {
+        const i = Number(index) | 0;
+        const v = obj[i];
+        return v === undefined ? null : v;
+    }
+    if (typeof obj === "object") {
+        const v = obj[String(index)];
+        return v === undefined ? null : v;
+    }
+    return null;
+}

package/dist/runtime/filter.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Dejavu 1.0 合同过滤器集。
+ *
+ * 与 Rust `dejavu-types` 过滤器系统（见 `projects/crates/dejavu-types/src/values/filter.rs`）
+ * 以及 `dejavu-codegen` Node stub 对齐。
+ *
+ * 未识别的过滤器 **宽松返回原值**（与 Rust 渲染器一致，不抛错）。
+ */
+export declare function applyFilter(name: string, value: unknown, args: unknown[]): unknown;

package/dist/runtime/filter.js

@@ -0,0 +1,87 @@
+import { htmlEscape } from "./escape.js";
+import { isTruthy, valueToString } from "./value.js";
+/**
+ * Dejavu 1.0 合同过滤器集。
+ *
+ * 与 Rust `dejavu-types` 过滤器系统（见 `projects/crates/dejavu-types/src/values/filter.rs`）
+ * 以及 `dejavu-codegen` Node stub 对齐。
+ *
+ * 未识别的过滤器 **宽松返回原值**（与 Rust 渲染器一致，不抛错）。
+ */
+export function applyFilter(name, value, args) {
+    switch (name) {
+        case "escape":
+        case "e":
+            return htmlEscape(valueToString(value));
+        case "raw":
+        case "safe":
+        case "s":
+            return valueToString(value);
+        case "uppercase":
+        case "upper":
+            return String(value).toUpperCase();
+        case "lowercase":
+        case "lower":
+            return String(value).toLowerCase();
+        case "trim":
+            return String(value).trim();
+        case "default":
+            return isTruthy(value) ? value : args[0] ?? "";
+        case "length": {
+            if (value === null || value === undefined)
+                return 0;
+            if (Array.isArray(value))
+                return value.length;
+            if (typeof value === "string")
+                return value.length;
+            const maybe = value.length;
+            return typeof maybe === "number" ? maybe : String(value).length;
+        }
+        case "join":
+            return Array.isArray(value)
+                ? value.join(String(args[0] ?? ","))
+                : String(value);
+        case "replace":
+            return String(value).replace(args[0] ?? "", String(args[1] ?? ""));
+        case "date": {
+            let d = null;
+            if (value instanceof Date) {
+                d = value;
+            }
+            else if (typeof value === "number") {
+                d = new Date(value);
+            }
+            else if (typeof value === "string") {
+                const parsed = new Date(value);
+                if (!Number.isNaN(parsed.getTime()))
+                    d = parsed;
+            }
+            if (!d)
+                return "";
+            // 第一期只支持 ISO 8601（args[0] 不使用 —— Rust 过滤器默认也是 ISO）。
+            return d.toISOString();
+        }
+        case "slug":
+            return slugify(String(value));
+        default:
+            return value;
+    }
+}
+/**
+ * 与 Rust `slug_filter` 对齐：
+ *
+ * 1. NFKD Unicode 分解
+ * 2. 去掉 combining marks
+ * 3. 小写
+ * 4. 非字母数字 / `-` → `-`
+ * 5. 连续 `-` 合并
+ * 6. 去首尾 `-`
+ */
+function slugify(input) {
+    const decomposed = input
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase();
+    const replaced = decomposed.replace(/[^a-z0-9-]+/g, "-");
+    return replaced.replace(/-+/g, "-").replace(/^-+|-+$/g, "");
+}

package/dist/runtime/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Dejavu AOT runtime helpers —— dejavu-codegen 产出的 ESM 模块会 import 本文件。
+ *
+ * 所有导出都是纯函数，无副作用、无状态。
+ * 与 Rust `dejavu-codegen` Node stub 以及 `dejavu-types` 的 filter 系统语义一致。
+ */
+export { htmlEscape } from "./escape.js";
+export { valueToString, isTruthy } from "./value.js";
+export { applyFilter } from "./filter.js";
+export { binary, unary, exprMember, exprIndex } from "./expr.js";

package/dist/runtime/index.js

@@ -0,0 +1,10 @@
+/**
+ * Dejavu AOT runtime helpers —— dejavu-codegen 产出的 ESM 模块会 import 本文件。
+ *
+ * 所有导出都是纯函数，无副作用、无状态。
+ * 与 Rust `dejavu-codegen` Node stub 以及 `dejavu-types` 的 filter 系统语义一致。
+ */
+export { htmlEscape } from "./escape.js";
+export { valueToString, isTruthy } from "./value.js";
+export { applyFilter } from "./filter.js";
+export { binary, unary, exprMember, exprIndex } from "./expr.js";

package/dist/runtime/value.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 1.0 合同的 truthiness —— 与 JS falsy 不同：
+ *
+ * - null / undefined → false
+ * - "" → false
+ * - 0 (number) / false (boolean) → false
+ * - 空数组 [] → false
+ * - 空对象 {} → false
+ * - "0" (字符串) → **true**
+ * - 其他 → true
+ */
+export declare function isTruthy(v: unknown): boolean;
+/**
+ * 将任意 JS 值渲染为字符串。与 Rust 渲染器的 debug-print 语义对齐：
+ *
+ * - null / undefined → ""
+ * - boolean → "true" / "false"
+ * - number → String()（NaN / Infinity 保持原样）
+ * - Date → toISOString()
+ * - Array → 递归 valueToString 后 "," join
+ * - object → JSON.stringify（fallback 到 String()）
+ * - string / 其他 → String()
+ */
+export declare function valueToString(v: unknown): string;

package/dist/runtime/value.js

@@ -0,0 +1,60 @@
+/**
+ * 1.0 合同的 truthiness —— 与 JS falsy 不同：
+ *
+ * - null / undefined → false
+ * - "" → false
+ * - 0 (number) / false (boolean) → false
+ * - 空数组 [] → false
+ * - 空对象 {} → false
+ * - "0" (字符串) → **true**
+ * - 其他 → true
+ */
+export function isTruthy(v) {
+    if (v === null || v === undefined)
+        return false;
+    if (v === "")
+        return false;
+    if (v === false)
+        return false;
+    if (v === 0)
+        return false;
+    if (Array.isArray(v) && v.length === 0)
+        return false;
+    if (typeof v === "object" && !Array.isArray(v)) {
+        return Object.keys(v).length > 0;
+    }
+    return true;
+}
+/**
+ * 将任意 JS 值渲染为字符串。与 Rust 渲染器的 debug-print 语义对齐：
+ *
+ * - null / undefined → ""
+ * - boolean → "true" / "false"
+ * - number → String()（NaN / Infinity 保持原样）
+ * - Date → toISOString()
+ * - Array → 递归 valueToString 后 "," join
+ * - object → JSON.stringify（fallback 到 String()）
+ * - string / 其他 → String()
+ */
+export function valueToString(v) {
+    if (v === null || v === undefined)
+        return "";
+    if (typeof v === "boolean")
+        return v ? "true" : "false";
+    if (typeof v === "number") {
+        return String(v);
+    }
+    if (v instanceof Date)
+        return v.toISOString();
+    if (Array.isArray(v))
+        return v.map(valueToString).join(",");
+    if (typeof v === "object") {
+        try {
+            return JSON.stringify(v);
+        }
+        catch {
+            return String(v);
+        }
+    }
+    return String(v);
+}

package/package.json

@@ -1,41 +1,47 @@
 {
   "name": "@doki-land/dejavu-engine",
-  "version": "0.0.0",
-  "description": "DejaVu Engine - 模板引擎",
+  "version": "0.0.8",
+  "description": "Dejavu pure TypeScript AOT runtime — generated template modules depend on this package",
   "type": "module",
+  "license": "MPL-2.0",
+  "author": "Doki Land",
+  "homepage": "https://github.com/doki-land/dejavu-language/tree/dev/projects/packages/dejavu-engine",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/doki-land/dejavu-language.git",
+    "directory": "projects/packages/dejavu-engine"
+  },
+  "bugs": {
+    "url": "https://github.com/doki-land/dejavu-language/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
-  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "bin": {
-    "dejavu": "./bin/dejavu.mjs"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "default": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "default": "./dist/runtime/index.js"
     }
   },
   "files": [
-    "dist",
-    "bin"
+    "dist"
   ],
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/node": "^25.4.0",
-    "jsdom": "^29.0.0",
-    "terser": "^5.46.1",
-    "tsup": "^8.0.0",
-    "typescript": "^5.0.0",
-    "vite": "^5.0.0",
-    "vitest": "^2.1.8"
-  },
   "scripts": {
-    "build": "tsup src/index.ts --format esm",
-    "build:dts": "tsup src/index.ts --format esm --dts",
-    "dev": "tsup src/index.ts --format esm --watch",
+    "build": "tsc -p tsconfig.json",
     "test": "vitest run",
     "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "vitest": "^2.1.8",
+    "typescript": "^5.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
   }
-}
+}