@agile-team/mach-report 0.5.0 → 0.6.0

package/dist/plugin-BIJxGHZX.cjs

@@ -0,0 +1 @@
+"use strict";var g=Object.create;var d=Object.defineProperty;var T=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var U=Object.getPrototypeOf,w=Object.prototype.hasOwnProperty;var y=(r,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of F(e))!w.call(r,t)&&t!==n&&d(r,t,{get:()=>e[t],enumerable:!(o=T(e,t))||o.enumerable});return r};var j=(r,e,n)=>(n=r!=null?g(U(r)):{},y(e||!r||!r.__esModule?d(n,"default",{value:r,enumerable:!0}):n,r));const C=require("vue");function h(r){return r==null?[]:Array.isArray(r)?r.map(String).filter(e=>e!==""):String(r).split(",").map(e=>e.trim()).filter(e=>e!=="")}function O(r){return h(r).join(",")}class l extends Error{constructor(e){super(e),this.name="PlanLoadError"}}function E(r={}){const{baseUrl:e="",headers:n,credentials:o}=r;return async({url:t,method:f,params:a})=>{const c=a&&Object.keys(a).length>0?`?${new URLSearchParams(a)}`:"";let s;try{s=await fetch(`${e}${t}${c}`,{method:f.toUpperCase(),headers:{Accept:"application/json",...n},credentials:o})}catch(i){throw new l(`请求失败(${t}): ${i instanceof Error?i.message:String(i)}`)}if(!s.ok)throw new l(`HTTP ${s.status} ${t}`);return s.json()}}function P(r){const{request:e,baseUrl:n=""}=r;return async({tempIds:o,furnitureTempId:t,params:f})=>{if(o.length===0)throw new l("缺少报表模板 ID");const a={tempId:o.join(",")};t&&(a.furnitureTempId=t);for(const[i,u]of Object.entries(f||{}))i&&u!=null&&u!==""&&(a[i]=String(u));const c=await e({url:`${n}/report/codePrintReport/gridPlan`,method:"get",params:a});if(c&&c.code!=null&&c.code!==200)throw new l(String(c.message||"预览加载失败"));const s=c?.data?.pages;return{schemaVersion:"jh4j-compatible",pages:Array.isArray(s)?s:[]}}}function R(r={fontUrl:"/simhei.ttf"}){let e=null;return async n=>{e||(e=await import("@agile-team/mach-report/pdf"));const o=r.fontUrl?await e.loadFontWithCache(r.fontUrl):null,{bytes:t}=await e.renderPlanToPdf(n,o?{customFontBytes:o}:{});return t}}const m="mach-report/fetcher",p="mach-report/pdf-exporter",_="mach-report/config",b={install(r,e={}){const n=e.fetcher??P({request:e.request??E({baseUrl:e.baseUrl}),baseUrl:e.baseUrl});r.provide(m,n);const o=e.pdfFontUrl??e.config?.defaults?.pdfFontUrl??"/simhei.ttf";r.provide(p,e.pdfExporter??R({fontUrl:o})),r.provide(_,C.computed(()=>e.config??null))}};exports.MACH_REPORT_CONFIG_KEY=_;exports.MACH_REPORT_FETCHER_KEY=m;exports.MACH_REPORT_PDF_EXPORTER_KEY=p;exports.PlanLoadError=l;exports.createDefaultPdfExporter=R;exports.createFetchRequest=E;exports.createJh4jGridPlanFetcher=P;exports.joinTempIds=O;exports.machReportPlugin=b;exports.normalizeTempIds=h;

package/dist/plugin-DrV67_VW.js

@@ -0,0 +1,89 @@
+import { computed as d } from "vue";
+function h(e) {
+  return e == null ? [] : Array.isArray(e) ? e.map(String).filter((r) => r !== "") : String(e).split(",").map((r) => r.trim()).filter((r) => r !== "");
+}
+function y(e) {
+  return h(e).join(",");
+}
+class l extends Error {
+  constructor(r) {
+    super(r), this.name = "PlanLoadError";
+  }
+}
+function m(e = {}) {
+  const { baseUrl: r = "", headers: a, credentials: t } = e;
+  return async ({ url: n, method: f, params: o }) => {
+    const s = o && Object.keys(o).length > 0 ? `?${new URLSearchParams(o)}` : "";
+    let c;
+    try {
+      c = await fetch(`${r}${n}${s}`, {
+        method: f.toUpperCase(),
+        headers: { Accept: "application/json", ...a },
+        credentials: t
+      });
+    } catch (i) {
+      throw new l(
+        `请求失败(${n}): ${i instanceof Error ? i.message : String(i)}`
+      );
+    }
+    if (!c.ok)
+      throw new l(`HTTP ${c.status} ${n}`);
+    return c.json();
+  };
+}
+function p(e) {
+  const { request: r, baseUrl: a = "" } = e;
+  return async ({ tempIds: t, furnitureTempId: n, params: f }) => {
+    if (t.length === 0) throw new l("缺少报表模板 ID");
+    const o = { tempId: t.join(",") };
+    n && (o.furnitureTempId = n);
+    for (const [i, u] of Object.entries(f || {}))
+      i && u != null && u !== "" && (o[i] = String(u));
+    const s = await r({
+      url: `${a}/report/codePrintReport/gridPlan`,
+      method: "get",
+      params: o
+    });
+    if (s && s.code != null && s.code !== 200)
+      throw new l(String(s.message || "预览加载失败"));
+    const c = s?.data?.pages;
+    return {
+      schemaVersion: "jh4j-compatible",
+      pages: Array.isArray(c) ? c : []
+    };
+  };
+}
+function g(e = { fontUrl: "/simhei.ttf" }) {
+  let r = null;
+  return async (a) => {
+    r || (r = await import("@agile-team/mach-report/pdf"));
+    const t = e.fontUrl ? await r.loadFontWithCache(e.fontUrl) : null, { bytes: n } = await r.renderPlanToPdf(a, t ? { customFontBytes: t } : {});
+    return n;
+  };
+}
+const P = "mach-report/fetcher", E = "mach-report/pdf-exporter", U = "mach-report/config", R = {
+  install(e, r = {}) {
+    const a = r.fetcher ?? p({
+      request: r.request ?? m({ baseUrl: r.baseUrl }),
+      baseUrl: r.baseUrl
+    });
+    e.provide(P, a);
+    const t = r.pdfFontUrl ?? r.config?.defaults?.pdfFontUrl ?? "/simhei.ttf";
+    e.provide(
+      E,
+      r.pdfExporter ?? g({ fontUrl: t })
+    ), e.provide(U, d(() => r.config ?? null));
+  }
+};
+export {
+  U as M,
+  l as P,
+  P as a,
+  E as b,
+  g as c,
+  m as d,
+  p as e,
+  y as j,
+  R as m,
+  h as n
+};

package/dist/render/canvas.d.ts

@@ -0,0 +1,61 @@
+import { PlanPage, RenderPlan } from '../schema/render-plan';
+import { TextMeasurer } from '../layout/textwrap';
+export interface CanvasRenderOptions {
+    /** 设备像素比，默认取运行环境 devicePixelRatio */
+    dpr?: number;
+    dpi?: number;
+    /** 文本默认字体族 */
+    fontFamily?: string;
+    /** 文本测量器（默认启发式） */
+    measurer?: TextMeasurer;
+    /** 只渲染页区间（闭区间索引；缺省全渲染——仅小报表使用，大报表请用 createCanvasPager） */
+    start?: number;
+    end?: number;
+}
+export declare function measurePageSizePx(page: Pick<PlanPage, "pageWidthMm" | "pageHeightMm">, dpi?: number): {
+    widthPx: number;
+    heightPx: number;
+};
+/** pt→px 换算（与 DOM 后端 units.ptToPx 同一真相源），供单测直接断言 */
+export declare function planFontSizePx(style: {
+    fontSizePx?: number;
+    fontSize?: number;
+} | undefined, dpi?: number): number;
+export interface CanvasRenderResult {
+    canvases: HTMLCanvasElement[];
+}
+/**
+ * RenderPlan → Canvas 位图页（顶点原点坐标系，与 DOM/PDF 一致）。
+ *
+ * ⚠️ 内存模型：A4 @dpr2 ≈ 14MB/页，全量渲染 100 页 ≈ 1.4GB。
+ * 大报表必须使用 createCanvasPager（窗口化 + 画布池 + 分帧渲染），
+ * 本函数适合页数少或已指定 start/end 区间的场景。
+ */
+export declare function renderPlanToCanvas(plan: RenderPlan, options?: CanvasRenderOptions): CanvasRenderResult;
+export interface CanvasPagerOptions extends CanvasRenderOptions {
+    /** 预渲染页数缓冲（窗口两侧各加 N 页），默认 1 */
+    overscan?: number;
+    /** 页间距 px，默认 18 */
+    gapPx?: number;
+    /** 每帧渲染页数上限（分帧，防长任务），默认 1 */
+    pagesPerFrame?: number;
+}
+export interface CanvasPager {
+    /** 挂载到滚动容器（viewport，overflow:auto），接管其内容 */
+    attach(viewport: HTMLElement): void;
+    destroy(): void;
+    /** 当前实际渲染的页区间 */
+    window(): {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * Canvas 虚拟化分页器（大报表专用）：
+ * - 视口窗口化：只绘制窗口内页（computePageWindow 与 DOM 后端共用）
+ * - 画布池：固定数量 canvas 复用重绘，滚动零新增位图
+ * - 分帧：每帧最多 pagesPerFrame 页，滚动期间不产生长任务
+ *
+ * 内存从 O(总页数) 降到 O(窗口+2×overscan)。
+ */
+export declare function createCanvasPager(plan: RenderPlan, options?: CanvasPagerOptions): CanvasPager;

package/dist/render/dom.d.ts

@@ -0,0 +1,10 @@
+import { PlanComponent, PlanPage, RenderPlan } from '../schema/render-plan';
+export interface RenderOptions {
+    dpi?: number;
+    classNames?: Partial<Record<ClassKey, string>>;
+}
+export type ClassKey = "root" | "page" | "comp" | "text" | "lines" | "line" | "rich" | "paragraph" | "segment" | "image" | "shape" | "grid" | "row" | "cell" | "unknown";
+export declare function classOf(key: ClassKey, options?: RenderOptions): string;
+export declare function renderComponent(comp: PlanComponent, dpi: number, options: RenderOptions, doc: Document): HTMLElement;
+export declare function renderPage(page: PlanPage, dpi: number, options: RenderOptions, doc: Document): HTMLElement;
+export declare function renderPlan(plan: RenderPlan, doc: Document, options?: RenderOptions): HTMLElement;

package/dist/render/grid-geometry.d.ts

@@ -0,0 +1,41 @@
+import { GridCell, PlanGrid } from '../schema/render-plan';
+export interface GridCellBox {
+    ri: number;
+    ci: number;
+    cell: GridCell;
+    /** 相对组件左上角（mm，顶点原点） */
+    xMm: number;
+    yMm: number;
+    widthMm: number;
+    heightMm: number;
+}
+/** 网格线段：kind="h" 为水平线（pos=y，from/to=x 区间）；"v" 为垂直线（pos=x，from/to=y 区间） */
+export interface GridEdge {
+    kind: "h" | "v";
+    pos: number;
+    from: number;
+    to: number;
+}
+export interface GridLayout {
+    columns: {
+        pos: number;
+        size: number;
+    }[];
+    rows: {
+        pos: number;
+        size: number;
+    }[];
+    cells: GridCellBox[];
+    /** 内部网格线段（不含外框；已跳过被 colSpan/rowSpan 跨越的边界，相邻段已合并） */
+    edges: GridEdge[];
+}
+/**
+ * 网格几何统一解析（DOM/Canvas/PDF 三后端共用，单位真相源）：
+ * - 列宽：优先 colWidthsMm（等比缩放至组件宽），否则按列数均分
+ * - 行高：优先 rowHeightsMm（等比缩放至组件高），否则按行数均分
+ * - colSpan/rowSpan：占位矩阵展开，跨度取起止行列差；越界收敛到网格内
+ * - 行内 null/undefined 单元格视为占 1 列的空单元格（与 DOM 表格行为一致）
+ * - edges：内部网格线段，跳过被 span 跨越的边界（合并单元格中间无线）
+ * 产出为组件左上角顶点原点的 mm 坐标，各后端自行换算 px/pt。
+ */
+export declare function resolveGridLayout(grid: PlanGrid, compWidthMm: number, compHeightMm: number): GridLayout;

package/dist/render/style.d.ts

@@ -0,0 +1,33 @@
+import { ComponentStyle } from '../schema/render-plan';
+/** 解析后的字号（px 值已按 dpi 换算；pt 值供 PDF 使用） */
+export interface ResolvedFontSize {
+    fontSizePt: number;
+    fontSizePx: number;
+}
+/** 字号解析：fontSizePx 直通；否则 pt→px（与 units.ptToPx 同源） */
+export declare function resolveFontSize(style: Pick<ComponentStyle, "fontSizePx" | "fontSize"> | undefined, dpi?: number, defaultPt?: number): ResolvedFontSize;
+/** 描边解析：颜色 + 线宽（pt） */
+export declare function resolveStroke(style: Pick<ComponentStyle, "borderColor" | "lineColor" | "lineWidthPt"> | undefined, fallbackColor?: string): {
+    color: string;
+    widthPt: number;
+};
+/** 文本颜色解析 */
+export declare function resolveTextColor(style: Pick<ComponentStyle, "color"> | undefined, fallback?: string): string;
+/** 行高解析（倍数，基线距 = 字号 × lineHeight） */
+export declare function resolveLineHeight(style: Pick<ComponentStyle, "lineHeight"> | undefined): number;
+/** 盒子边框语义：四边开关 + 内部网格线（四边全关则内线不画） */
+export interface BoxBorders {
+    top: boolean;
+    right: boolean;
+    bottom: boolean;
+    left: boolean;
+    /** 网格内线（仅当任意外边开启） */
+    inner: boolean;
+}
+/**
+ * 边框开关解析：
+ * - 未声明（undefined）→ 四边全开（与既有 rect 总有边框的行为兼容）
+ * - 显式 false → 对应边关闭
+ * - 四边全关（如 list border:false）→ 内线也不画
+ */
+export declare function resolveBoxBorders(style: Pick<ComponentStyle, "borderTop" | "borderRight" | "borderBottom" | "borderLeft"> | undefined): BoxBorders;

package/dist/render/window.d.ts

@@ -0,0 +1,23 @@
+export interface PageWindowInput {
+    pageHeightsPx: number[];
+    viewportHeightPx: number;
+    scrollTopPx: number;
+    overscan?: number;
+    /** 页间距（px）。占位高度按“每页高度+间距”累计，与 margin-bottom 布局一致；默认 0 */
+    gapPx?: number;
+}
+export interface PageWindow {
+    start: number;
+    end: number;
+    padTopPx: number;
+    padBottomPx: number;
+}
+/**
+ * 页级视口虚拟化：给定每页高度与滚动位置，返回需要真实渲染的页区间
+ * 与上下占位高度。start/end 为闭区间索引。
+ *
+ * 布局模型：每页占据 height + gap（gap 为页间距，默认 0），
+ * padTop/padBottom 同口径累计，保证 占位+渲染页+间距 还原总滚动高度。
+ * 内部用前缀和 + 二分定位覆盖页与可见终点。
+ */
+export declare function computePageWindow(input: PageWindowInput): PageWindow;

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/validate.d.ts

@@ -0,0 +1,15 @@
+import { 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/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/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/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;
+};

package/dist/sql/index.d.ts

@@ -0,0 +1,4 @@
+export * from './tokenizer';
+export * from './expr';
+export * from './compile';
+export * from './ast-check';

package/dist/sql/tokenizer.d.ts

@@ -0,0 +1,25 @@
+export type TokenType = "literal" | "bind" | "subst" | "if" | "escape";
+export interface Token {
+    type: TokenType;
+    text: string;
+    /** bind/subst 参数名；if 表达式源码 */
+    value?: string;
+    start: number;
+    end: number;
+}
+export declare class SqlSyntaxError extends Error {
+    readonly position: number;
+    readonly source: string;
+    constructor(message: string, position: number, source: string);
+}
+/**
+ * 扫描动态 SQL，产出 token 流：
+ * - literal: 纯 SQL 文本（已反转义 \{ \}）
+ * - bind:    #{name}
+ * - subst:   ${name}
+ * - if:      {if(expr, a, b)} —— value 为去壳后的参数串
+ * - escape:  \{ 或 \}
+ */
+export declare function tokenize(sql: string): Token[];
+/** 按顶层逗号拆分（忽略双引号内与括号/花括号内） */
+export declare function splitTopLevel(input: string): string[];