@agile-team/mach-report 0.4.0

package/dist/render/window.js

@@ -0,0 +1,58 @@
+/**
+ * 页级视口虚拟化：给定每页高度与滚动位置，返回需要真实渲染的页区间
+ * 与上下占位高度。start/end 为闭区间索引。
+ *
+ * 布局模型：每页占据 height + gap（gap 为页间距，默认 0），
+ * padTop/padBottom 同口径累计，保证 占位+渲染页+间距 还原总滚动高度。
+ * 内部用前缀和 + 二分定位覆盖页与可见终点。
+ */
+export function computePageWindow(input) {
+    const { pageHeightsPx, viewportHeightPx, scrollTopPx, overscan = 1, gapPx = 0 } = input;
+    const n = pageHeightsPx.length;
+    if (n === 0) {
+        return { start: 0, end: -1, padTopPx: 0, padBottomPx: 0 };
+    }
+    const gap = Math.max(0, gapPx);
+    const offsets = new Array(n + 1);
+    offsets[0] = 0;
+    for (let i = 0; i < n; i++) {
+        offsets[i + 1] = offsets[i] + Math.max(0, pageHeightsPx[i] ?? 0) + gap;
+    }
+    const total = offsets[n];
+    const top = Math.max(0, scrollTopPx);
+    // 覆盖页：最后一个 offsets[i] <= top 的页（滚动位置所在页）
+    let cover = 0;
+    let lo = 0;
+    let hi = n - 1;
+    while (lo <= hi) {
+        const mid = (lo + hi) >> 1;
+        if (offsets[mid] <= top) {
+            cover = mid;
+            lo = mid + 1;
+        }
+        else {
+            hi = mid - 1;
+        }
+    }
+    const start = Math.max(0, Math.min(n - 1, cover - overscan));
+    // 可见终点：从覆盖页页顶起累计一屏（+间距）的最后一页
+    const target = offsets[cover] + Math.max(0, viewportHeightPx);
+    let visibleEnd = n - 1;
+    lo = 0;
+    hi = n - 1;
+    while (lo <= hi) {
+        const mid = (lo + hi) >> 1;
+        if (offsets[mid + 1] < target) {
+            lo = mid + 1;
+        }
+        else {
+            visibleEnd = mid;
+            hi = mid - 1;
+        }
+    }
+    const end = Math.min(n - 1, visibleEnd + overscan);
+    const padTopPx = offsets[start];
+    const padBottomPx = Math.max(0, total - offsets[end + 1]);
+    return { start, end, padTopPx, padBottomPx };
+}
+//# sourceMappingURL=window.js.map

package/dist/render/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../src/render/window.ts"],"names":[],"mappings":"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"}

package/dist/schema/render-plan.d.ts

@@ -0,0 +1,96 @@
+export type ComponentKind = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
+export interface ComponentStyle {
+    fontSizePx?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    align?: "left" | "center" | "right" | "justify";
+    verticalAlign?: "top" | "middle" | "bottom";
+    lineColor?: string;
+    borderColor?: string;
+    lineWidthPt?: number;
+    borderTop?: boolean;
+    borderRight?: boolean;
+    borderBottom?: boolean;
+    borderLeft?: boolean;
+    lineHeight?: number;
+    letterSpacing?: number;
+    opacity?: number;
+    rotateDeg?: number;
+}
+export interface RichParagraph {
+    segments: RichSegment[];
+    align?: ComponentStyle["align"];
+    lineHeight?: number;
+    spaceBeforeMm?: number;
+    spaceAfterMm?: number;
+    indentMm?: number;
+}
+export interface RichSegment {
+    kind?: "text" | "field";
+    text?: string;
+    field?: string;
+    style?: ComponentStyle;
+}
+export interface GridCell {
+    text?: string;
+    rawText?: string;
+    children?: PlanComponent[];
+    colSpan?: number;
+    rowSpan?: number;
+    style?: ComponentStyle;
+}
+export interface PlanGrid {
+    /** 行内允许 null 空位（jh4j 契约数据存在稀疏行；渲染器按空单元格处理） */
+    cells: (GridCell | null)[][];
+    colWidthsMm?: number[];
+    rowHeightsMm?: number[];
+    gapMm?: number;
+}
+export interface PlanComponent {
+    kind: ComponentKind;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    nid?: string;
+    rkey?: string;
+    text?: string;
+    rawText?: string;
+    lines?: string[];
+    richParagraphs?: RichParagraph[];
+    imageData?: string;
+    grid?: PlanGrid;
+    style?: ComponentStyle;
+    meta?: Record<string, unknown>;
+    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
+    fallbackText?: string;
+}
+export interface PlanPage {
+    pageWidthMm: number;
+    pageHeightMm: number;
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: PlanComponent[];
+}
+export interface GridPlanResponse {
+    code?: number;
+    message?: string;
+    data?: {
+        pages?: PlanPage[];
+    } | null;
+}
+export interface RenderPlan {
+    schemaVersion: string;
+    pages: PlanPage[];
+}
+export declare const RENDER_PLAN_SCHEMA_VERSION = "1.0.0-mach";
+export declare function toRenderPlan(response: GridPlanResponse): RenderPlan;
+export declare function isImageBackedComponent(comp: PlanComponent): boolean;
+export declare function isRichText(comp: PlanComponent): boolean;

package/dist/schema/render-plan.js

@@ -0,0 +1,25 @@
+import { SCHEMA_VERSION_MACH } from "../defaults";
+export const RENDER_PLAN_SCHEMA_VERSION = SCHEMA_VERSION_MACH;
+export function toRenderPlan(response) {
+    if (response && response.code != null && response.code !== 200) {
+        throw new Error(String(response.message || "渲染计划加载失败"));
+    }
+    const pages = response?.data?.pages;
+    return {
+        schemaVersion: RENDER_PLAN_SCHEMA_VERSION,
+        pages: Array.isArray(pages) ? pages : []
+    };
+}
+export function isImageBackedComponent(comp) {
+    return ((comp.kind === "image" ||
+        comp.kind === "barcode" ||
+        comp.kind === "qrcode" ||
+        comp.kind === "chart") &&
+        !!comp.imageData);
+}
+export function isRichText(comp) {
+    return (comp.kind === "text" &&
+        Array.isArray(comp.richParagraphs) &&
+        comp.richParagraphs.length > 0);
+}
+//# sourceMappingURL=render-plan.js.map

package/dist/schema/render-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-plan.js","sourceRoot":"","sources":["../../src/schema/render-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA8GlD,MAAM,CAAC,MAAM,0BAA0B,GAAG,mBAAmB,CAAC;AAE9D,MAAM,UAAU,YAAY,CAAC,QAA0B;IACrD,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,KAAK,GAAG,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC;IACpC,OAAO;QACL,aAAa,EAAE,0BAA0B;QACzC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACxD,OAAO,CACL,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO;QACpB,IAAI,CAAC,IAAI,KAAK,SAAS;QACvB,IAAI,CAAC,IAAI,KAAK,QAAQ;QACtB,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC;QACxB,CAAC,CAAC,IAAI,CAAC,SAAS,CACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAmB;IAC5C,OAAO,CACL,IAAI,CAAC,IAAI,KAAK,MAAM;QACpB,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC;QAClC,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAC/B,CAAC;AACJ,CAAC"}

package/dist/schema/validate.d.ts

@@ -0,0 +1,15 @@
+import type { PlanComponent, PlanPage } from "./render-plan";
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    errors: ValidationError[];
+    warnings: ValidationError[];
+}
+export declare function validateComponent(comp: unknown, path: string, errors: ValidationError[], warnings?: ValidationError[]): void;
+export declare function validatePage(page: unknown, path: string, errors: ValidationError[], warnings?: ValidationError[]): void;
+export declare function validateRenderPlan(input: unknown): ValidationResult;
+export declare function assertRenderPlan(input: unknown): PlanPage[];
+export type { PlanComponent, PlanPage };

package/dist/schema/validate.js

@@ -0,0 +1,129 @@
+const KNOWN_KINDS = new Set([
+    "text",
+    "image",
+    "barcode",
+    "qrcode",
+    "chart",
+    "line",
+    "rect",
+    "ellipse"
+]);
+function isObj(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function checkNumber(obj, key, path, errors) {
+    const v = obj[key];
+    if (v === undefined || v === null)
+        return;
+    if (typeof v !== "number" || !Number.isFinite(v)) {
+        errors.push({ path: `${path}.${key}`, message: `应为有限数字，实际 ${JSON.stringify(v)}` });
+    }
+}
+export function validateComponent(comp, path, errors, warnings = []) {
+    if (!isObj(comp)) {
+        errors.push({ path, message: "组件应为对象" });
+        return;
+    }
+    const kind = comp["kind"];
+    if (typeof kind !== "string") {
+        errors.push({ path: `${path}.kind`, message: `组件缺少 kind 字符串` });
+    }
+    else if (!KNOWN_KINDS.has(kind)) {
+        warnings.push({
+            path: `${path}.kind`,
+            message: `未知组件类型 ${JSON.stringify(kind)}，将以兜底方式渲染`
+        });
+    }
+    for (const key of ["leftMm", "topMm", "widthMm", "heightMm"]) {
+        checkNumber(comp, key, path, errors);
+    }
+    if (comp["leftMm"] != null && comp["widthMm"] != null) {
+        if (comp["leftMm"] < -100 || comp["widthMm"] < 0) {
+            errors.push({ path, message: "几何数值异常（leftMm<-100 或 widthMm<0）" });
+        }
+    }
+    const grid = comp["grid"];
+    if (grid !== undefined) {
+        if (!isObj(grid) || !Array.isArray(grid["cells"])) {
+            errors.push({ path: `${path}.grid.cells`, message: "grid.cells 应为二维数组" });
+        }
+        else {
+            grid["cells"].forEach((row, ri) => {
+                if (!Array.isArray(row)) {
+                    errors.push({ path: `${path}.grid.cells.${ri}`, message: "行应为数组" });
+                    return;
+                }
+                row.forEach((cell, ci) => {
+                    if (cell === undefined || cell === null)
+                        return;
+                    if (isObj(cell) && Array.isArray(cell["children"])) {
+                        cell["children"].forEach((child, ki) => {
+                            validateComponent(child, `${path}.grid.cells.${ri}.${ci}.children.${ki}`, errors, warnings);
+                        });
+                    }
+                });
+            });
+        }
+    }
+    const rich = comp["richParagraphs"];
+    if (rich !== undefined) {
+        if (!Array.isArray(rich)) {
+            errors.push({ path: `${path}.richParagraphs`, message: "richParagraphs 应为数组" });
+        }
+        else {
+            rich.forEach((para, i) => {
+                if (!isObj(para) || !Array.isArray(para["segments"])) {
+                    errors.push({ path: `${path}.richParagraphs.${i}`, message: "段落缺少 segments 数组" });
+                }
+            });
+        }
+    }
+}
+export function validatePage(page, path, errors, warnings = []) {
+    if (!isObj(page)) {
+        errors.push({ path, message: "页应为对象" });
+        return;
+    }
+    const w = page["pageWidthMm"];
+    const h = page["pageHeightMm"];
+    if (typeof w !== "number" || !(w > 0 && w < 3000)) {
+        errors.push({ path: `${path}.pageWidthMm`, message: `页宽非法: ${JSON.stringify(w)}` });
+    }
+    if (typeof h !== "number" || !(h > 0 && h < 5000)) {
+        errors.push({ path: `${path}.pageHeightMm`, message: `页高非法: ${JSON.stringify(h)}` });
+    }
+    const comps = page["components"];
+    if (comps !== undefined && !Array.isArray(comps)) {
+        errors.push({ path: `${path}.components`, message: "components 应为数组" });
+    }
+    else if (Array.isArray(comps)) {
+        comps.forEach((comp, i) => validateComponent(comp, `${path}.components.${i}`, errors, warnings));
+    }
+}
+export function validateRenderPlan(input) {
+    const errors = [];
+    const warnings = [];
+    const pages = isObj(input) ? input["pages"] : undefined;
+    if (!Array.isArray(pages)) {
+        errors.push({
+            path: "$.pages",
+            message: input == null ? "渲染计划为空" : "渲染计划缺少 pages 数组"
+        });
+    }
+    else {
+        pages.forEach((page, i) => validatePage(page, `$.pages.${i}`, errors, warnings));
+    }
+    return { ok: errors.length === 0, errors, warnings };
+}
+export function assertRenderPlan(input) {
+    const result = validateRenderPlan(input);
+    if (!result.ok) {
+        const head = result.errors
+            .slice(0, 3)
+            .map((e) => `${e.path}: ${e.message}`)
+            .join("; ");
+        throw new Error(`渲染计划校验失败(${result.errors.length} 处): ${head}`);
+    }
+    return input.pages;
+}
+//# sourceMappingURL=validate.js.map

package/dist/schema/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/schema/validate.ts"],"names":[],"mappings":"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"}

package/dist/sql/ast-check.d.ts

@@ -0,0 +1,14 @@
+export interface AstCheckResult {
+    ok: boolean;
+    /** ast 深度校验是否执行（方言不支持时降级词法） */
+    degraded: boolean;
+    message?: string;
+}
+/**
+ * AST 深度校验（双保险策略）：
+ * 1. node-sql-parser（MySQL 方言，支持 ? 占位符）AST 顶层必须为 SELECT/集合运算
+ * 2. AST 通过后再叠加词法校验（MySQL 方言把 SELECT INTO 解析为别名，AST 层不可见，
+ *    由词法层兜底拦截）
+ * AST 解析失败（方言不兼容）自动降级为纯词法校验，返回 degraded=true。
+ */
+export declare function assertSingleSelectAst(sql: string): AstCheckResult;

package/dist/sql/ast-check.js

@@ -0,0 +1,44 @@
+import { Parser } from "node-sql-parser";
+import { assertSingleSelect } from "./compile";
+function isSelectAst(ast) {
+    if (ast == null || typeof ast !== "object")
+        return false;
+    const type = ast.type;
+    return type === "select" || type === "union" || type === "except" || type === "intersect";
+}
+/**
+ * AST 深度校验（双保险策略）：
+ * 1. node-sql-parser（MySQL 方言，支持 ? 占位符）AST 顶层必须为 SELECT/集合运算
+ * 2. AST 通过后再叠加词法校验（MySQL 方言把 SELECT INTO 解析为别名，AST 层不可见，
+ *    由词法层兜底拦截）
+ * AST 解析失败（方言不兼容）自动降级为纯词法校验，返回 degraded=true。
+ */
+export function assertSingleSelectAst(sql) {
+    const astResult = checkAstTopLevel(sql);
+    try {
+        assertSingleSelect(sql);
+        return { ok: true, degraded: !astResult };
+    }
+    catch (lexError) {
+        return {
+            ok: false,
+            degraded: false,
+            message: lexError instanceof Error ? lexError.message : String(lexError)
+        };
+    }
+}
+/** 返回 true=AST 校验通过；false=解析失败或顶层非 SELECT（message 由词法层补充） */
+function checkAstTopLevel(sql) {
+    try {
+        const parser = new Parser();
+        const ast = parser.astify(sql, { database: "MySQL" });
+        const list = Array.isArray(ast) ? ast : [ast];
+        if (list.length > 1)
+            return false;
+        return isSelectAst(list[0]);
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=ast-check.js.map

package/dist/sql/ast-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast-check.js","sourceRoot":"","sources":["../../src/sql/ast-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAS/C,SAAS,WAAW,CAAC,GAAY;IAC/B,IAAI,GAAG,IAAI,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACzD,MAAM,IAAI,GAAI,GAA0B,CAAC,IAAI,CAAC;IAC9C,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,WAAW,CAAC;AAC5F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC;QACH,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,CAAC;IAC5C,CAAC;IAAC,OAAO,QAAQ,EAAE,CAAC;QAClB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,KAAK;YACf,OAAO,EAAE,QAAQ,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;SACzE,CAAC;IACJ,CAAC;AACH,CAAC;AAED,6DAA6D;AAC7D,SAAS,gBAAgB,CAAC,GAAW;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAClC,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/sql/compile.d.ts

@@ -0,0 +1,31 @@
+export { SqlSyntaxError } from "./tokenizer";
+export interface RenderedSql {
+    sql: string;
+    binds: unknown[];
+    warnings: string[];
+}
+export interface CompiledSql {
+    original: string;
+    /** 参数名集合（bind 与 subst 并集） */
+    paramNames: string[];
+    render(params: Record<string, unknown>): RenderedSql;
+}
+export declare class SqlValidationError extends Error {
+    readonly sql: string;
+    constructor(message: string, sql: string);
+}
+export declare function compileDynamicSql(source: string): CompiledSql;
+/**
+ * 去注释：-- 行注释、# 行注释（仅行首/空白后，且排除 #{ 绑定占位）、/* 块注释。
+ * 注意：此函数用于校验口径，输出会折叠空白。
+ */
+export declare function stripSqlComments(sql: string): string;
+/**
+ * 单 SELECT 结构校验（词法层；AST 级校验见 ast-check.ts 双保险）：
+ * - 去注释后必须以 select 或 with 开头
+ * - 语句内除末尾外不允许出现分号
+ * - 顶层禁止 DML/DDL/调用关键字（字符串字面量内容不参与匹配）
+ */
+export declare function assertSingleSelect(sql: string): void;
+/** 便捷入口：编译 + 渲染 + 校验一体 */
+export declare function renderDynamicSql(source: string, params: Record<string, unknown>): RenderedSql;

package/dist/sql/compile.js

@@ -0,0 +1,145 @@
+import { evalExpr, ExprError, parseIfArgs } from "./expr";
+import { SqlSyntaxError, tokenize } from "./tokenizer";
+export { SqlSyntaxError } from "./tokenizer";
+export class SqlValidationError extends Error {
+    constructor(message, sql) {
+        super(`SQL 校验失败: ${message}`);
+        this.sql = sql;
+        this.name = "SqlValidationError";
+    }
+}
+const FORBIDDEN_TOP_LEVEL = /\b(insert|update|delete|merge|create|alter|drop|truncate|grant|revoke|call|exec|execute)\b/i;
+export function compileDynamicSql(source) {
+    let tokens;
+    try {
+        tokens = tokenize(source);
+    }
+    catch (e) {
+        if (e instanceof SqlSyntaxError)
+            throw e;
+        throw new SqlSyntaxError(String(e), 0, source);
+    }
+    const paramNames = new Set();
+    for (const t of tokens) {
+        if (t.type === "bind" || t.type === "subst")
+            paramNames.add(t.value);
+    }
+    return {
+        original: source,
+        paramNames: [...paramNames],
+        render(params) {
+            const binds = [];
+            const warnings = [];
+            let out = "";
+            for (const t of tokens) {
+                switch (t.type) {
+                    case "literal":
+                        out += t.text;
+                        break;
+                    case "bind": {
+                        const name = t.value;
+                        if (!(name in params)) {
+                            warnings.push(`参数 ${name} 未提供，按 NULL 绑定`);
+                            binds.push(null);
+                        }
+                        else {
+                            binds.push(params[name]);
+                        }
+                        out += "?";
+                        break;
+                    }
+                    case "subst": {
+                        const name = t.value;
+                        if (!(name in params)) {
+                            warnings.push(`参数 ${name} 未提供，文本替换为空串`);
+                            out += "";
+                        }
+                        else {
+                            out += String(params[name]);
+                        }
+                        break;
+                    }
+                    case "if": {
+                        const { cond, whenTrue, whenFalse } = parseIfArgs(t.value);
+                        let truthy;
+                        try {
+                            const v = evalExpr(cond, { params });
+                            truthy = v === true || (typeof v === "string" && v !== "") || (typeof v === "number" && v !== 0);
+                        }
+                        catch (e) {
+                            throw e instanceof ExprError ? e : new ExprError(String(e));
+                        }
+                        const branch = truthy ? whenTrue : whenFalse;
+                        let branchText;
+                        try {
+                            branchText = String(evalExpr(branch, { params }));
+                        }
+                        catch {
+                            branchText = branch;
+                        }
+                        const sub = compileDynamicSql(branchText);
+                        const rendered = sub.render(params);
+                        binds.push(...rendered.binds);
+                        warnings.push(...rendered.warnings);
+                        out += rendered.sql;
+                        break;
+                    }
+                    case "escape":
+                        out += t.text;
+                        break;
+                }
+            }
+            return { sql: out, binds, warnings };
+        }
+    };
+}
+/**
+ * 去注释：-- 行注释、# 行注释（仅行首/空白后，且排除 #{ 绑定占位）、/* 块注释。
+ * 注意：此函数用于校验口径，输出会折叠空白。
+ */
+export function stripSqlComments(sql) {
+    return sql
+        .replace(/\/\*[\s\S]*?\*\//g, " ")
+        .replace(/(^|\s)--[^\n]*/g, "$1 ")
+        .replace(/(^|\s)#(?!\{)[^\n]*/g, "$1 ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+/** 剥离单引号字符串字面量（内容不参与关键字检查，防 'xxx into yyy' 误伤） */
+function stripStringLiterals(sql) {
+    return sql.replace(/'(?:[^']|'')*'/g, "''");
+}
+/**
+ * 单 SELECT 结构校验（词法层；AST 级校验见 ast-check.ts 双保险）：
+ * - 去注释后必须以 select 或 with 开头
+ * - 语句内除末尾外不允许出现分号
+ * - 顶层禁止 DML/DDL/调用关键字（字符串字面量内容不参与匹配）
+ */
+export function assertSingleSelect(sql) {
+    const clean = stripSqlComments(sql);
+    if (clean === "")
+        throw new SqlValidationError("空 SQL", sql);
+    if (!/^(select|with)\b/i.test(clean)) {
+        throw new SqlValidationError("仅允许 SELECT 查询（需以 select/with 开头）", sql);
+    }
+    const body = clean.endsWith(";") ? clean.slice(0, -1) : clean;
+    if (body.includes(";")) {
+        throw new SqlValidationError("检测到多语句（分号），仅允许单条 SELECT", sql);
+    }
+    const codeOnly = stripStringLiterals(body);
+    const m = FORBIDDEN_TOP_LEVEL.exec(codeOnly);
+    if (m) {
+        throw new SqlValidationError(`禁止的关键字: ${m[1]}`, sql);
+    }
+    if (/\binto\b/i.test(codeOnly)) {
+        throw new SqlValidationError("禁止 SELECT INTO", sql);
+    }
+}
+/** 便捷入口：编译 + 渲染 + 校验一体 */
+export function renderDynamicSql(source, params) {
+    const compiled = compileDynamicSql(source);
+    const rendered = compiled.render(params);
+    assertSingleSelect(rendered.sql);
+    return rendered;
+}
+//# sourceMappingURL=compile.js.map

package/dist/sql/compile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.js","sourceRoot":"","sources":["../../src/sql/compile.ts"],"names":[],"mappings":"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"}

package/dist/sql/expr.d.ts

@@ -0,0 +1,21 @@
+export interface ExprContext {
+    params: Record<string, unknown>;
+}
+export declare class ExprError extends Error {
+    constructor(message: string);
+}
+/**
+ * 求值 jh4j 公式表达式（用于 {if(cond, a, b)} 的 cond 与操作数）：
+ * - #param 引用（渲染时被替换为参数值；此实现按值求值）
+ * - "..." 字符串字面量（仅双引号，与 jh4j 一致）
+ * - isEmpty(x)、isNotEmpty(x)
+ * - == / != 比较
+ * - + 拼接
+ */
+export declare function evalExpr(input: string, ctx: ExprContext): unknown;
+/** {if(cond, whenTrue, whenFalse)} 的参数拆分（2 或 3 段，兼容 jh4j 三段式） */
+export declare function parseIfArgs(inner: string): {
+    cond: string;
+    whenTrue: string;
+    whenFalse: string;
+};