@agile-team/mach-report 0.4.0

package/dist/layout/paginate.js

@@ -0,0 +1,197 @@
+import { RENDER_PLAN_SCHEMA_VERSION } from "../schema/render-plan";
+import { DEFAULT_FONT_PT, LINE_HEIGHT } from "../defaults";
+import { heuristicMeasurer, measureTextMm, wrapText } from "./textwrap";
+function makeWorkingPage(page) {
+    return {
+        widthMm: page.widthMm,
+        heightMm: page.heightMm,
+        marginTopMm: page.marginTopMm ?? 0,
+        marginBottomMm: page.marginBottomMm ?? 0,
+        marginLeftMm: page.marginLeftMm ?? 0,
+        marginRightMm: page.marginRightMm ?? 0,
+        components: []
+    };
+}
+function toContentBottom(page, wp) {
+    return wp.heightMm - (page.marginBottomMm ?? wp.marginBottomMm);
+}
+function estRowHeightMm(list, lines) {
+    const fontSizePt = list.fontSizePt ?? DEFAULT_FONT_PT;
+    const lineMm = (fontSizePt * LINE_HEIGHT * 25.4) / 72;
+    const padding = (list.paddingMm ?? 1) * 2;
+    return Math.max(list.rowHeightMm ?? 0, lines * lineMm + padding);
+}
+function cellText(value) {
+    if (value == null)
+        return "";
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number")
+        return String(value);
+    if (typeof value === "boolean")
+        return value ? "是" : "否";
+    if (value instanceof Date)
+        return value.toISOString().slice(0, 10);
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function interList(list, measurer) {
+    const fontSizePt = list.fontSizePt ?? DEFAULT_FONT_PT;
+    const paddingMm = list.paddingMm ?? 1;
+    // 每列单元格样式只构造一次：{ align, verticalAlign, ...col.style }
+    const cellStyles = list.columns.map((col) => col.style
+        ? { align: "left", verticalAlign: "middle", ...col.style }
+        : { align: "left", verticalAlign: "middle" });
+    // 表头单元格样式（含底色/加粗），同样驻留
+    const headerCellStyles = list.columns.map((col) => ({
+        bold: list.headerBold ?? true,
+        align: "center",
+        verticalAlign: "middle",
+        backgroundColor: list.headerBackgroundColor,
+        ...(col.style || {})
+    }));
+    const headerTexts = list.columns.map((col) => col.header);
+    const headerLines = headerTexts.map((text, i) => wrapText(text, list.columns[i].widthMm - paddingMm * 2, { fontSizePt, bold: list.headerBold ?? true }, measurer));
+    const maxLines = Math.max(...headerLines.map((l) => l.length), 1);
+    const headerHeight = estRowHeightMm(list, maxLines);
+    const headerCells = headerTexts.map((text, i) => ({
+        text,
+        style: headerCellStyles[i]
+    }));
+    // border:false → 四边全关（下游 resolveBoxBorders 据此不画内外线）
+    const borderStyle = list.border === false
+        ? { borderTop: false, borderRight: false, borderBottom: false, borderLeft: false }
+        : { borderBottom: true, borderLeft: true, borderRight: true, borderTop: true };
+    return {
+        fontSizePt,
+        paddingMm,
+        cellStyles,
+        borderStyle,
+        headerHeightMm: headerHeight,
+        headerGrid: { cells: [headerCells], rowHeightsMm: [headerHeight] },
+        columns: list.columns
+    };
+}
+/** 单行 → 网格（复用驻留样式，无逐格对象分配） */
+function buildRowGridFast(inter, row, measurer) {
+    const columns = inter.columns;
+    const texts = new Array(columns.length);
+    let maxLines = 1;
+    for (let i = 0; i < columns.length; i++) {
+        texts[i] = cellText(row[columns[i].field]);
+    }
+    // 折行只需算一次行数（宽度/字号同列恒定）
+    const lines = new Array(columns.length);
+    for (let i = 0; i < columns.length; i++) {
+        const wrapped = wrapText(texts[i], columns[i].widthMm - inter.paddingMm * 2, { fontSizePt: inter.fontSizePt }, measurer);
+        lines[i] = wrapped;
+        if (wrapped.length > maxLines)
+            maxLines = wrapped.length;
+    }
+    const lineMm = (inter.fontSizePt * LINE_HEIGHT * 25.4) / 72;
+    const height = Math.max(inter.rowHeightFloorMm, maxLines * lineMm + inter.paddingMm * 2);
+    const cells = new Array(columns.length);
+    for (let i = 0; i < columns.length; i++) {
+        cells[i] = { text: texts[i], style: inter.cellStyles[i] };
+    }
+    return { grid: { cells: [cells], rowHeightsMm: [height] }, heightMm: height };
+}
+export function paginateTemplate(template, datasets, optionsOrMmPerRow = {}) {
+    // 兼容旧签名 paginateTemplate(tpl, data, mmPerRow: number)
+    const options = typeof optionsOrMmPerRow === "number" ? { mmPerRow: optionsOrMmPerRow } : optionsOrMmPerRow;
+    const mmPerRow = options.mmPerRow ?? 0;
+    const measurer = options.measurer ?? heuristicMeasurer;
+    const warnings = [];
+    const pages = [];
+    let seq = 0;
+    const nextId = (prefix) => `${prefix}_${(++seq).toString(36)}`;
+    for (const tplPage of template.pages) {
+        const current = makeWorkingPage(tplPage);
+        const contentBottom = () => toContentBottom(tplPage, current);
+        const contentTop = current.marginTopMm;
+        const pushCurrent = () => {
+            pages.push({
+                pageWidthMm: current.widthMm,
+                pageHeightMm: current.heightMm,
+                marginTopMm: current.marginTopMm,
+                marginBottomMm: current.marginBottomMm,
+                marginLeftMm: current.marginLeftMm,
+                marginRightMm: current.marginRightMm,
+                components: current.components
+            });
+        };
+        for (const comp of tplPage.components) {
+            if (comp.kind !== "list") {
+                current.components.push(comp);
+                continue;
+            }
+            const list = comp;
+            const rows = datasets[list.dataset];
+            if (!Array.isArray(rows)) {
+                warnings.push(`数据集 ${list.dataset} 未提供数据，列表 ${list.id ?? ""} 输出为空`);
+            }
+            const dataRows = Array.isArray(rows) ? rows : [];
+            const columnsWidth = list.columns.reduce((s, c) => s + c.widthMm, 0);
+            const scale = columnsWidth > list.widthMm ? list.widthMm / columnsWidth : 1;
+            const scaledList = scale === 1 ? list : { ...list, columns: list.columns.map((c) => ({ ...c, widthMm: c.widthMm * scale })) };
+            const inter = {
+                ...interList(scaledList, measurer),
+                rowHeightFloorMm: scaledList.rowHeightMm ?? 0
+            };
+            const headerComp = {
+                kind: "rect",
+                leftMm: list.leftMm,
+                topMm: 0,
+                widthMm: list.widthMm,
+                heightMm: inter.headerHeightMm,
+                grid: inter.headerGrid,
+                nid: nextId("listh"),
+                style: inter.borderStyle
+            };
+            let y = list.topMm;
+            const placeHeader = (target, topMm) => {
+                target.components.push({ ...headerComp, topMm });
+            };
+            placeHeader(current, y);
+            y += inter.headerHeightMm + mmPerRow;
+            for (let i = 0; i < dataRows.length; i++) {
+                const rowGrid = buildRowGridFast(inter, dataRows[i], measurer);
+                if (y + rowGrid.heightMm > contentBottom()) {
+                    pushCurrent();
+                    const next = makeWorkingPage(tplPage);
+                    current.components = next.components;
+                    current.heightMm = next.heightMm;
+                    if (scaledList.headerEveryPage !== false) {
+                        placeHeader(current, list.topMm);
+                        y = list.topMm + inter.headerHeightMm;
+                    }
+                    else {
+                        y = contentTop;
+                    }
+                }
+                current.components.push({
+                    kind: "rect",
+                    leftMm: list.leftMm,
+                    topMm: y,
+                    widthMm: list.widthMm,
+                    heightMm: rowGrid.heightMm,
+                    grid: rowGrid.grid,
+                    nid: nextId("listr"),
+                    style: inter.borderStyle
+                });
+                y += rowGrid.heightMm;
+            }
+        }
+        pushCurrent();
+    }
+    return {
+        plan: { schemaVersion: RENDER_PLAN_SCHEMA_VERSION, pages },
+        warnings
+    };
+}
+export { measureTextMm, wrapText };
+//# sourceMappingURL=paginate.js.map

package/dist/layout/paginate.js.map

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

package/dist/layout/textwrap.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 文本测量与折行（分页/Canvas/PDF 共用的唯一折行真相源）。
+ *
+ * 测量模型可注入（TextMeasurer）：
+ * - 默认 createHeuristicMeasurer()：CJK/拉丁宽度启发式（零依赖、Node 可用）
+ * - 浏览器端可注入 createCanvasMeasurer()（真字体 metrics，消除三端折行差异）
+ */
+export interface TextMeasureOptions {
+    fontSizePt: number;
+    bold?: boolean;
+    letterSpacingPt?: number;
+}
+/** 宽度测量接口：返回文本在给定字号下的宽度（mm）。实现必须无副作用、可缓存。 */
+export interface TextMeasurer {
+    measureMm(text: string, options: TextMeasureOptions): number;
+}
+export declare function charWidthEm(ch: string): number;
+/** 启发式测量器：宽度模型与 jh4j 近似口径一致（默认实现） */
+export declare const heuristicMeasurer: TextMeasurer;
+/** 兼容旧 API：默认启发式测量 */
+export declare function createHeuristicMeasurer(): TextMeasurer;
+export declare function measureTextMm(text: string, options: TextMeasureOptions): number;
+/**
+ * 浏览器 Canvas 测量器：用真实字体 metrics 校准宽度（可选注入）。
+ * 无 2D 环境时自动回退启发式（Node/SSR 安全）。
+ */
+export declare function createCanvasMeasurer(getCtx2d: () => CanvasRenderingContext2D | null): TextMeasurer;
+/**
+ * 文本折行：
+ * - CJK 字符任意位置可断（与既有行为一致）
+ * - 连续拉丁/数字串视为一个词，仅在词间（空格/CJK 边界）断行；
+ *   单词本身超宽时按字符硬拆（兜底，不无限溢出）
+ * - 换行符强制断行；行首不保留折行产生的空格
+ * - 可注入 TextMeasurer（默认启发式）
+ */
+export declare function wrapText(text: string, maxWidthMm: number, options: TextMeasureOptions, measurer?: TextMeasurer): string[];

package/dist/layout/textwrap.js

@@ -0,0 +1,173 @@
+/**
+ * 文本测量与折行（分页/Canvas/PDF 共用的唯一折行真相源）。
+ *
+ * 测量模型可注入（TextMeasurer）：
+ * - 默认 createHeuristicMeasurer()：CJK/拉丁宽度启发式（零依赖、Node 可用）
+ * - 浏览器端可注入 createCanvasMeasurer()（真字体 metrics，消除三端折行差异）
+ */
+const CJK_RE = /[\u3000-\u9fff\uff00-\uffef]/;
+/** Latin 快速分类：0=默认 0.54em，1=窄字符 0.26，2=宽字符 0.95，3=数字 0.59，4=大写 0.67，5=空格 0.3 */
+const LATIN_CLASS = new Uint8Array(128);
+{
+    // 窄字符（i l j t f . , : ; ' ` | ! ( ) [ ]）
+    for (const ch of "iljtf.,:;'`|!()[]")
+        LATIN_CLASS[ch.charCodeAt(0)] = 1;
+    // 宽字符（m w M W @）
+    for (const ch of "mwMW@")
+        LATIN_CLASS[ch.charCodeAt(0)] = 2;
+    // 数字 0.59
+    for (let c = 48; c <= 57; c++)
+        LATIN_CLASS[c] = 3;
+    // 大写 0.67
+    for (let c = 65; c <= 90; c++)
+        LATIN_CLASS[c] = 4;
+    LATIN_CLASS[32] = 5; // 空格
+}
+const LATIN_WIDTH = [0.54, 0.26, 0.95, 0.59, 0.67, 0.3];
+export function charWidthEm(ch) {
+    const code = ch.charCodeAt(0);
+    // 快路径：ASCII 查表（O(1)，无正则、无分配）
+    if (code < 128)
+        return LATIN_WIDTH[LATIN_CLASS[code]];
+    if (CJK_RE.test(ch))
+        return 1;
+    // 其余（带音符拉丁/西里尔等）走原启发式
+    if (/[A-Z]/.test(ch))
+        return 0.67;
+    return 0.54;
+}
+/** 启发式测量器：宽度模型与 jh4j 近似口径一致（默认实现） */
+export const heuristicMeasurer = {
+    measureMm(text, options) {
+        const { fontSizePt, bold = false, letterSpacingPt = 0 } = options;
+        const ptToMm = 25.4 / 72;
+        let units = 0;
+        for (const ch of text) {
+            units += charWidthEm(ch);
+        }
+        if (bold)
+            units *= 1.04;
+        return (units * fontSizePt + letterSpacingPt * text.length) * ptToMm;
+    }
+};
+/** 兼容旧 API：默认启发式测量 */
+export function createHeuristicMeasurer() {
+    return heuristicMeasurer;
+}
+export function measureTextMm(text, options) {
+    return heuristicMeasurer.measureMm(text, options);
+}
+/**
+ * 浏览器 Canvas 测量器：用真实字体 metrics 校准宽度（可选注入）。
+ * 无 2D 环境时自动回退启发式（Node/SSR 安全）。
+ */
+export function createCanvasMeasurer(getCtx2d) {
+    let ctx;
+    return {
+        measureMm(text, options) {
+            if (ctx === undefined)
+                ctx = getCtx2d();
+            if (!ctx)
+                return heuristicMeasurer.measureMm(text, options);
+            const px = (options.fontSizePt * 96) / 72;
+            ctx.font = `${options.bold ? "bold " : ""}${px}px sans-serif`;
+            // px → mm（96dpi 基准）
+            return (ctx.measureText(text).width * 25.4) / 96;
+        }
+    };
+}
+function tokenize(text, options, measurer) {
+    const atoms = [];
+    let word = "";
+    let wordWidth = 0;
+    const flush = () => {
+        if (word) {
+            atoms.push({ text: word, widthMm: wordWidth, cjk: false });
+            word = "";
+            wordWidth = 0;
+        }
+    };
+    for (const ch of text) {
+        if (ch === "\n") {
+            flush();
+            atoms.push({ text: "\n", widthMm: 0, cjk: false, br: true });
+            continue;
+        }
+        if (ch === " ") {
+            flush();
+            atoms.push({ text: ch, widthMm: measurer.measureMm(ch, options), cjk: false, space: true });
+            continue;
+        }
+        if (CJK_RE.test(ch)) {
+            flush();
+            atoms.push({ text: ch, widthMm: measurer.measureMm(ch, options), cjk: true });
+            continue;
+        }
+        word += ch;
+        wordWidth += measurer.measureMm(ch, options);
+    }
+    flush();
+    return atoms;
+}
+/**
+ * 文本折行：
+ * - CJK 字符任意位置可断（与既有行为一致）
+ * - 连续拉丁/数字串视为一个词，仅在词间（空格/CJK 边界）断行；
+ *   单词本身超宽时按字符硬拆（兜底，不无限溢出）
+ * - 换行符强制断行；行首不保留折行产生的空格
+ * - 可注入 TextMeasurer（默认启发式）
+ */
+export function wrapText(text, maxWidthMm, options, measurer = heuristicMeasurer) {
+    if (!text)
+        return [""];
+    const lines = [];
+    let current = "";
+    let currentWidth = 0;
+    const pushLine = () => {
+        lines.push(current);
+        current = "";
+        currentWidth = 0;
+    };
+    for (const atom of tokenize(text, options, measurer)) {
+        if (atom.br) {
+            pushLine();
+            continue;
+        }
+        if (currentWidth + atom.widthMm <= maxWidthMm) {
+            current += atom.text;
+            currentWidth += atom.widthMm;
+            continue;
+        }
+        if (atom.space) {
+            // 行尾放不下的空格直接丢弃断行（不保留到下一行行首）
+            pushLine();
+            continue;
+        }
+        if (atom.cjk) {
+            if (current.length > 0)
+                pushLine();
+            current = atom.text;
+            currentWidth = atom.widthMm;
+            continue;
+        }
+        // 拉丁词放不下：先断行，词本身超宽再按字符硬拆
+        if (current.length > 0)
+            pushLine();
+        if (atom.widthMm <= maxWidthMm) {
+            current = atom.text;
+            currentWidth = atom.widthMm;
+            continue;
+        }
+        for (const ch of atom.text) {
+            const chWidth = measurer.measureMm(ch, options);
+            if (currentWidth + chWidth > maxWidthMm && current.length > 0) {
+                pushLine();
+            }
+            current += ch;
+            currentWidth += chWidth;
+        }
+    }
+    pushLine();
+    return lines;
+}
+//# sourceMappingURL=textwrap.js.map

package/dist/layout/textwrap.js.map

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

package/dist/manager/api.d.ts

@@ -0,0 +1,45 @@
+import type { DatasetRecord, ImportStrategy, PageResult, ParamRecord, ReportRecord, RequestFn } from "./types";
+export declare function createReportAdminClient(options: {
+    request: RequestFn;
+    baseUrl?: string;
+}): {
+    /** 模板列表（分页） */
+    listReports(query?: {
+        current?: number;
+        size?: number;
+        directoryId?: string;
+        keyword?: string;
+    }): Promise<PageResult<ReportRecord>>;
+    /** 模板详情（content 为 jh4j 私有模板 JSON 字符串，可喂给 importJh4jTemplateContent） */
+    getReport(id: string): Promise<ReportRecord>;
+    /** 保存模板（jh4j：PUT，body {id, code, name, content}） */
+    updateReport(input: {
+        id: string;
+        code?: string;
+        name?: string;
+        content: string;
+    }): Promise<unknown>;
+    /** 导出模板定义包（body = ID 数组，返回 ZIP blob） */
+    exportDefinition(ids: string[]): Promise<unknown>;
+    /** 导入模板定义包（multipart: file + strategy） */
+    importDefinition(file: File | Blob, strategy: ImportStrategy): Promise<unknown>;
+    /** 数据集列表 */
+    listDatasets(reportId: string): Promise<PageResult<DatasetRecord>>;
+    /** 参数列表 */
+    listParams(reportId: string): Promise<PageResult<ParamRecord>>;
+    /** 模板锁：进入设计器前获取（40s 心跳由 holdLock 驱动） */
+    acquireLock(reportId: string): Promise<unknown>;
+    lockHeartbeat(reportId: string): Promise<unknown>;
+    releaseLock(reportId: string): Promise<unknown>;
+    /**
+     * 持锁执行：acquire → fn（期间自动心跳）→ release（finally）。
+     * 返回 fn 的结果；获取锁失败时抛 ReportAdminError。
+     * 心跳连续失败（默认 2 次）视为锁丢失：触发 onLockLost 回调并停止心跳，
+     * fn 继续执行（避免中途丢弃用户编辑），由调用方决定是否提示/中止。
+     */
+    holdLock<T>(reportId: string, fn: () => Promise<T>, options?: {
+        onLockLost?: (reason: string) => void;
+        heartbeatFailLimit?: number;
+    }): Promise<T>;
+};
+export type ReportAdminClient = ReturnType<typeof createReportAdminClient>;

package/dist/manager/api.js

@@ -0,0 +1,101 @@
+import { ReportAdminError } from "./types";
+const BASE = "/report/codePrintReport";
+const LOCK_BASE = "/report/codePrintReportLock";
+function unwrap(response, url) {
+    const body = response;
+    if (body && body.code != null && body.code !== 200) {
+        throw new ReportAdminError(String(body.message || "请求失败"), url);
+    }
+    return (body?.data ?? body);
+}
+export function createReportAdminClient(options) {
+    const { request } = options;
+    const base = options.baseUrl ?? "";
+    return {
+        /** 模板列表（分页） */
+        async listReports(query = {}) {
+            const url = `${base}${BASE}/list`;
+            return unwrap(await request({ url, method: "get", params: { current: 1, size: 20, ...query } }), url);
+        },
+        /** 模板详情（content 为 jh4j 私有模板 JSON 字符串，可喂给 importJh4jTemplateContent） */
+        async getReport(id) {
+            const url = `${base}${BASE}/getById`;
+            return unwrap(await request({ url, method: "get", params: { id } }), url);
+        },
+        /** 保存模板（jh4j：PUT，body {id, code, name, content}） */
+        async updateReport(input) {
+            const url = `${base}${BASE}/update`;
+            return unwrap(await request({ url, method: "put", data: input }), url);
+        },
+        /** 导出模板定义包（body = ID 数组，返回 ZIP blob） */
+        async exportDefinition(ids) {
+            const url = `${base}${BASE}/exportDefinition`;
+            return request({ url, method: "post", data: ids });
+        },
+        /** 导入模板定义包（multipart: file + strategy） */
+        async importDefinition(file, strategy) {
+            const url = `${base}${BASE}/importDefinition`;
+            const form = new FormData();
+            form.append("file", file);
+            form.append("strategy", strategy);
+            return request({ url, method: "post", data: form });
+        },
+        /** 数据集列表 */
+        async listDatasets(reportId) {
+            const url = `${base}${BASE}Ds/list`;
+            return unwrap(await request({ url, method: "get", params: { reportId, current: 1, size: 999 } }), url);
+        },
+        /** 参数列表 */
+        async listParams(reportId) {
+            const url = `${base}${BASE}Param/list`;
+            return unwrap(await request({ url, method: "get", params: { reportId, current: 1, size: 999 } }), url);
+        },
+        /** 模板锁：进入设计器前获取（40s 心跳由 holdLock 驱动） */
+        async acquireLock(reportId) {
+            const url = `${base}${LOCK_BASE}/acquire`;
+            return unwrap(await request({ url, method: "post", data: { reportId } }), url);
+        },
+        async lockHeartbeat(reportId) {
+            const url = `${base}${LOCK_BASE}/heartbeat`;
+            return unwrap(await request({ url, method: "post", data: { reportId } }), url);
+        },
+        async releaseLock(reportId) {
+            const url = `${base}${LOCK_BASE}/release`;
+            return unwrap(await request({ url, method: "post", data: { reportId } }), url);
+        },
+        /**
+         * 持锁执行：acquire → fn（期间自动心跳）→ release（finally）。
+         * 返回 fn 的结果；获取锁失败时抛 ReportAdminError。
+         * 心跳连续失败（默认 2 次）视为锁丢失：触发 onLockLost 回调并停止心跳，
+         * fn 继续执行（避免中途丢弃用户编辑），由调用方决定是否提示/中止。
+         */
+        async holdLock(reportId, fn, options = {}) {
+            await this.acquireLock(reportId);
+            const failLimit = Math.max(1, options.heartbeatFailLimit ?? 2);
+            let consecutiveFailures = 0;
+            let lockLost = false;
+            const timer = setInterval(() => {
+                void this.lockHeartbeat(reportId)
+                    .then(() => {
+                    consecutiveFailures = 0;
+                })
+                    .catch((e) => {
+                    consecutiveFailures++;
+                    if (!lockLost && consecutiveFailures >= failLimit) {
+                        lockLost = true;
+                        options.onLockLost?.(`模板锁心跳连续 ${consecutiveFailures} 次失败（${e instanceof Error ? e.message : String(e)}），锁可能已被释放`);
+                        clearInterval(timer);
+                    }
+                });
+            }, 40000);
+            try {
+                return await fn();
+            }
+            finally {
+                clearInterval(timer);
+                await this.releaseLock(reportId).catch(() => undefined);
+            }
+        }
+    };
+}
+//# sourceMappingURL=api.js.map

package/dist/manager/api.js.map

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

package/dist/manager/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./api";

package/dist/manager/index.js

@@ -0,0 +1,3 @@
+export * from "./types";
+export * from "./api";
+//# sourceMappingURL=index.js.map

package/dist/manager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/manager/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC"}

package/dist/manager/types.d.ts

@@ -0,0 +1,50 @@
+export interface ReportRecord {
+    id: string;
+    code?: string;
+    name?: string;
+    publishStatus?: string;
+    directoryId?: string;
+    updateTime?: string;
+    [key: string]: unknown;
+}
+export interface PageResult<T> {
+    records: T[];
+    total?: number;
+    current?: number;
+    size?: number;
+}
+export interface DatasetRecord {
+    id?: string;
+    reportId?: string;
+    code?: string;
+    name?: string;
+    type?: string;
+    datasourceCode?: string;
+    sqlText?: string;
+    apiUrl?: string;
+    fields?: unknown[];
+    [key: string]: unknown;
+}
+export interface ParamRecord {
+    id?: string;
+    reportId?: string;
+    name?: string;
+    defaultValue?: string;
+    [key: string]: unknown;
+}
+export type ImportStrategy = "overwrite" | "skip";
+export type RequestFn = (config: {
+    url: string;
+    method: string;
+    params?: Record<string, unknown>;
+    data?: unknown;
+}) => Promise<unknown>;
+export interface ApiResponse<T = unknown> {
+    code?: number;
+    message?: string;
+    data?: T;
+}
+export declare class ReportAdminError extends Error {
+    readonly url: string;
+    constructor(message: string, url: string);
+}

package/dist/manager/types.js

@@ -0,0 +1,8 @@
+export class ReportAdminError extends Error {
+    constructor(message, url) {
+        super(message);
+        this.url = url;
+        this.name = "ReportAdminError";
+    }
+}
+//# sourceMappingURL=types.js.map