weaver-e10-builder 1.1.9 → 1.2.2

package/dist/services/report/dataset.js

@@ -0,0 +1,185 @@
+/**
+ * 报表数据集：挂载、字段清单、侧栏操作（重命名/聚合/排序/替换/移除/预览）。
+ *
+ * **同名同源只挂一次**：同一张表在一个报表里挂两次，左侧会出现重复数据源分组，
+ * 属性面板回显也会错乱。所以 `resolveDataset` 永远先查本报表已有挂载，命中就复用。
+ */
+import { EDC } from './http.js';
+import { normalizeDatasetName, normalizeFieldList } from './fields.js';
+import { FORM_SOURCE_GROUP } from './constants.js';
+/** 本报表已挂载的数据集列表。 */
+export async function listDatasets(http, reportId, appId) {
+    const r = await http.get(EDC.dataset.list, { hasField: 'true', reportId }, reportId);
+    const rows = (r && r.data) || [];
+    return (Array.isArray(rows) ? rows : []).map((row) => ({
+        id: String(row.id),
+        name: row.name || '',
+        sourceId: row.sourceId != null ? String(row.sourceId) : '',
+        sourceType: row.type || '',
+        sourceGroup: row.sourceGroup || '',
+        tableText: row.tableText || '',
+    }));
+}
+/**
+ * 解析数据集：本报表已有同源就复用，否则 `addDataset` 新建。
+ *
+ * 三条门禁（都来自真实事故）：
+ * 1. 同 `sourceId` 已挂 → **必须复用**，再挂一次会产生重复数据源分组；
+ * 2. `sourceName` 强制 `{表单名}(业务模块)`，裸表单名会让面板缺后缀；
+ * 3. 跨报表的 `datasetId` **不认**，忽略并重新在本报表解析。
+ */
+export async function resolveDataset(http, opt) {
+    const sourceType = opt.sourceType || 'LOGIC';
+    const sourceGroup = opt.sourceGroup || FORM_SOURCE_GROUP;
+    const wantName = normalizeDatasetName(opt.sourceName, sourceType);
+    const shape = (row) => ({
+        id: String(row.id),
+        name: row.name || '',
+        sourceId: row.sourceId != null ? String(row.sourceId) : '',
+        sourceType: row.type || sourceType,
+        sourceGroup: row.sourceGroup || sourceGroup,
+        tableText: row.tableText || '',
+    });
+    const shapeWith = (row, extra) => ({
+        ...shape(row),
+        requestedName: wantName,
+        nameNormalized: row.name === wantName,
+        ...extra,
+    });
+    const existing = await listDatasets(http, opt.reportId, opt.appId);
+    const sameSource = existing.filter((x) => String(x.sourceId) === String(opt.sourceId));
+    let foreignDatasetWarn;
+    if (opt.datasetId) {
+        const hit = existing.find((x) => String(x.id) === String(opt.datasetId));
+        if (hit) {
+            return shapeWith(hit, {
+                reused: true,
+                scope: 'same-report',
+                duplicates: sameSource.filter((x) => String(x.id) !== String(hit.id)).map((x) => x.id),
+            });
+        }
+        // 跨报表不可复用：忽略外来 datasetId，本表重新解析
+        foreignDatasetWarn =
+            `数据集 ${opt.datasetId} 不在本报表(${opt.reportId})上，已忽略并在本报表重新解析。` +
+                '数据集不能跨报表复用。';
+    }
+    if (sameSource.length) {
+        // 同源多条（脏数据）：优先带正确 sourceGroup 的那条
+        const preferred = sameSource.find((x) => x.sourceGroup === FORM_SOURCE_GROUP && String(x.sourceType).toLowerCase() === 'logic') ||
+            sameSource.find((x) => x.sourceGroup === FORM_SOURCE_GROUP) ||
+            sameSource[0];
+        return shapeWith(preferred, {
+            reused: true,
+            scope: 'same-report',
+            duplicates: sameSource.filter((x) => x.id !== preferred.id).map((x) => x.id),
+            warn: foreignDatasetWarn,
+        });
+    }
+    await http.postFields(EDC.report.addDataset, {
+        reportId: opt.reportId,
+        sourceType,
+        sourceIds: opt.sourceId,
+        sourceName: wantName,
+        appid: opt.appId,
+        sourceGroup,
+    }, opt.reportId);
+    // addDataset 不回传 datasetId，只能回查列表确认（轮询无 sleep，命中即返回）
+    const tries = opt.pollTries ?? 8;
+    for (let i = 0; i < tries; i++) {
+        const rows = await listDatasets(http, opt.reportId, opt.appId);
+        const hits = rows.filter((x) => String(x.sourceId) === String(opt.sourceId));
+        const hit = hits.find((x) => x.sourceGroup === FORM_SOURCE_GROUP) || hits[0];
+        if (hit) {
+            return shapeWith(hit, {
+                reused: false,
+                created: true,
+                scope: 'same-report',
+                duplicates: hits.filter((x) => x.id !== hit.id).map((x) => x.id),
+                warn: foreignDatasetWarn,
+            });
+        }
+    }
+    throw new Error(`addDataset 后未能在数据集列表命中 sourceId=${opt.sourceId}`);
+}
+/**
+ * 落库后的权威字段清单（`fieldsKey`），并补上数据集显示名。
+ *
+ * 服务端 `fieldsKey` 的 `datasetName` / `tableText` 常为空，而 `tableName` 是属性面板回显必需项，
+ * 所以用调用方传进来的 `dsMeta` 兜底。
+ */
+export async function fieldsKeyOf(http, datasetId, reportId, appId, dsMeta = {}) {
+    const r = await http.get(EDC.dataset.fieldsAndOriginFields, { datasetId, hasField: 'true', isFront: 'true', reportId }, reportId);
+    const fk = (r && r.data && r.data.fieldsKey) || [];
+    if (!fk.length) {
+        throw new Error('字段清单为空 —— 检查数据集注册契约（field_ 前缀门禁）');
+    }
+    const label = dsMeta.label || '';
+    const st = dsMeta.sourceType || 'logic';
+    return fk.map((f) => ({
+        ...f,
+        datasetLabel: label,
+        datasetSourceType: st,
+        datasetName: f.datasetName || label,
+        tableText: f.tableText || label,
+        sourceType: f.sourceType || st,
+    }));
+}
+/**
+ * **建表前**的源级字段预检 —— 不需要先建空壳就能校验字段。
+ * 与落库后的 `fieldsKey` 元素同形，差别只有 `data` 是裸数组、`dataSetId` 恒为 `"0"`。
+ */
+export async function fieldsBySource(http, sourceId, opts = {}) {
+    const r = await http.get(EDC.dataset.fieldsBySource, {
+        sourceId,
+        sourceType: opts.sourceType || 'logic',
+        groupId: opts.sourceGroup || FORM_SOURCE_GROUP,
+    }, opts.reportId || '');
+    return normalizeFieldList(r, { datasetId: opts.datasetId }).fields;
+}
+// ── 侧栏操作 ────────────────────────────────────────────────
+export async function renameDataset(http, datasetId, name, nameLabelId = '-1') {
+    return http.get(EDC.dataset.rename, { datasetId, name, nameLabelId });
+}
+export async function getAggregation(http, datasetId) {
+    const r = await http.get(`${EDC.dataset.aggregationGet}?datasetId=${encodeURIComponent(datasetId)}`);
+    return (r && r.data !== undefined ? r.data : r) ?? null;
+}
+export async function saveAggregation(http, datasetId, aggreData) {
+    return http.postFields(EDC.dataset.aggregationSave, {
+        datasetId: String(datasetId),
+        aggreData: JSON.stringify(aggreData ?? []),
+    });
+}
+export async function getSort(http, datasetId) {
+    const r = await http.get(`${EDC.dataset.sortGet}?datasetId=${encodeURIComponent(datasetId)}`);
+    return (r && r.data !== undefined ? r.data : r) ?? null;
+}
+export async function saveSort(http, datasetId, sortData) {
+    return http.postFields(EDC.dataset.sortSave, {
+        datasetId: String(datasetId),
+        sortData: JSON.stringify(sortData ?? []),
+    });
+}
+/** 替换数据集（整表换源）。body 由调用方给出，含 `fieldMap` 映射。 */
+export async function replaceDataset(http, body) {
+    const r = await http.postJson(EDC.dataset.replace, body);
+    const newId = r?.data != null ? String(r.data) : '';
+    if (!newId)
+        throw new Error(`替换数据集失败：${r?.msg || '未返回新数据集 id'}`);
+    return newId;
+}
+/** 数据集是否仍被画布引用。只有 `data === true` / `'true'` 才算被引用。 */
+export async function isDatasetUsed(http, reportId, datasetId) {
+    const r = await http.get(EDC.dataset.checkUsed, { reportId, datasetId });
+    const d = r?.data;
+    return d === true || d === 'true';
+}
+/** 从报表移除数据集。注意 `sourceIds` 这个参数名是历史包袱，值其实是 **datasetId**。 */
+export async function deleteDataset(http, reportId, datasetId) {
+    return http.postFields(EDC.report.delDataset, { reportId: String(reportId), sourceIds: String(datasetId) }, reportId);
+}
+export async function previewDataset(http, datasetId) {
+    const r = await http.get(EDC.dataset.preview, { dataSetId: datasetId, isFront: 'true' });
+    return (r && r.data !== undefined ? r.data : r) ?? null;
+}
+//# sourceMappingURL=dataset.js.map

package/dist/services/report/dataset.js.map

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

package/dist/services/report/fields.d.ts

@@ -0,0 +1,80 @@
+import type { FieldBindingPlan, ReportField, SpecColumn } from './types.js';
+/** 判定是否平台系统字段（**不可作为兜底绑定目标**）。 */
+export declare function isSystemField(f: {
+    name?: unknown;
+} | null | undefined): boolean;
+/**
+ * 显示名归一化：去空白 + 全角括号转半角。
+ * 不做这一步，「（年）」这类全角/半角混写会导致本该命中的列匹配失败。
+ */
+export declare function normText(s: unknown): string;
+/** 字段显示名（兼容 `text` / `showName` 两种返回）。 */
+export declare function fieldTextOf(f: ReportField | null | undefined): string;
+/**
+ * 模糊候选 —— **仅供用户挑选，绝不自动绑定**。
+ * 先按包含关系打分，都不沾边时退化为「共有汉字数」，只为给用户一个可读的候选清单。
+ */
+export declare function fuzzyCandidates(allTexts: Array<{
+    name: string;
+    text: string;
+    system: boolean;
+}>, nTitle: string, topN?: number): Array<{
+    name: string;
+    text: string;
+    system: boolean;
+    score: number;
+}>;
+export interface BindingOptions {
+    /** `{ 列标题: 字段显示名 | field_xxx }`；多源时可用 `"源key.列标题"` 限定。 */
+    fieldMap?: Record<string, string>;
+    /** 已确认「文案与显示名不同」的列标题。 */
+    fieldConfirmed?: string[];
+    /** 所有列都允许文案不一致。 */
+    confirmDisplayMismatch?: boolean;
+    /** 当前这一批列属于哪个源（多源时用于 `fieldMap` 的限定键与报错文案）。 */
+    sourceKey?: string;
+    /**
+     * 本批列在**整张报表**里的全局下标。
+     *
+     * 多源时必须传：`columns` 是按源切过的子集，若直接用子集下标，第二个源会与父源撞号，
+     * `buildWorkbook` 的 `bindingAt(i)` 会静默绑到别的源的字段上。
+     */
+    globalIndices?: number[];
+}
+/**
+ * 字段绑定严格解析（命中即止，**不做模糊自动绑定**）。
+ *
+ * 匹配顺序：
+ *   1. 显式指定 —— `column.fieldName` / `column.field` / `fieldMap[列标题]`
+ *   2. 列标题 === `fieldsKey.text`（归一化后精确相等）
+ *   3. `column.field` === `fieldsKey.text` / `fieldsKey.name`
+ *   4. 都不中 → `unmatched[]`（附模糊候选，仅供用户挑选）
+ *
+ * 显式命中但显示名与列文案不一致 → `display_mismatch`，需要用户确认。
+ */
+export declare function resolveFieldBindings(fieldsKey: ReportField[], columns: SpecColumn[], opts?: BindingOptions): FieldBindingPlan;
+/**
+ * 字段列表归一化 —— 抹平两个接口的信封差异。
+ *
+ * | 接口 | `data` 形状 | `dataSetId` |
+ * |---|---|---|
+ * | `dataset/fieldsBySource` | **裸数组** | 恒为 `"0"`（还没落库） |
+ * | `dataset/fieldsAndOriginFields` | `{fieldsKey, originFieldsKey}` | 真实值 |
+ *
+ * 逐键比对过：两者字段元素**同形**，只有 `dataSetId` 不同。
+ * 所以统一取「字段元素数组」这一层；调用方必须用**本报表真实 datasetId** 覆盖，
+ * 否则 `fieldsBySource` 的 0 会把单元格绑到错误的数据集上。
+ */
+export declare function normalizeFieldList(payload: any, opts?: {
+    datasetId?: string;
+}): {
+    fields: ReportField[];
+    originFields: ReportField[];
+    shape: string;
+    dataSetIdInjected: boolean;
+};
+/** 数据集回显名规范化：LOGIC → `(业务模块)`，共享表 → `(表单)`。已有后缀则不重复追加。 */
+export declare function normalizeDatasetName(formName: unknown, sourceType: unknown): string;
+/** 工作表列号 → 字母（回读校验里报单元格坐标用）。 */
+export declare function colLetter(i: number): string;
+//# sourceMappingURL=fields.d.ts.map

package/dist/services/report/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/services/report/fields.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,UAAU,EAEX,MAAM,YAAY,CAAC;AAEpB,kCAAkC;AAClC,wBAAgB,aAAa,CAAC,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE/E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAM3C;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAErE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,EAChE,MAAM,EAAE,MAAM,EACd,IAAI,SAAI,GACP,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAwBvE;AAED,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,yBAAyB;IACzB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mBAAmB;IACnB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,WAAW,EAAE,EACxB,OAAO,EAAE,UAAU,EAAE,EACrB,IAAI,GAAE,cAAmB,GACxB,gBAAgB,CA+GlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,GAAG,EACZ,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAChC;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,YAAY,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,OAAO,CAAA;CAAE,CA8BnG;AAED,0DAA0D;AAC1D,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAKnF;AAED,gCAAgC;AAChC,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ3C"}

package/dist/services/report/fields.js

@@ -0,0 +1,245 @@
+/**
+ * 字段绑定（规则 A）与字段列表归一化。
+ *
+ * **核心门禁 · 禁止静默兜底**：列标题与字段显示名必须**精确**匹配（归一化后）。
+ * 找不到就让用户挑，绝不回退到系统字段、绝不模糊自动绑定。
+ * 历史事故：列文案「姓名」被静默绑到系统字段 `name`（真实显示名「标题」），
+ * 列语义被改写，用户毫不知情。
+ */
+import { SYSTEM_FIELD_NAMES } from './constants.js';
+/** 判定是否平台系统字段（**不可作为兜底绑定目标**）。 */
+export function isSystemField(f) {
+    return SYSTEM_FIELD_NAMES.has(String((f && f.name) || ''));
+}
+/**
+ * 显示名归一化：去空白 + 全角括号转半角。
+ * 不做这一步，「（年）」这类全角/半角混写会导致本该命中的列匹配失败。
+ */
+export function normText(s) {
+    return String(s == null ? '' : s)
+        .replace(/\s+/g, '')
+        .replace(/（/g, '(')
+        .replace(/）/g, ')')
+        .trim();
+}
+/** 字段显示名（兼容 `text` / `showName` 两种返回）。 */
+export function fieldTextOf(f) {
+    return String((f && (f.text || f.showName)) || '');
+}
+/**
+ * 模糊候选 —— **仅供用户挑选，绝不自动绑定**。
+ * 先按包含关系打分，都不沾边时退化为「共有汉字数」，只为给用户一个可读的候选清单。
+ */
+export function fuzzyCandidates(allTexts, nTitle, topN = 8) {
+    if (!nTitle)
+        return [];
+    const scored = [];
+    for (const f of allTexts) {
+        const t = normText(f.text);
+        const n = normText(f.name);
+        let score = 0;
+        if (t && t.includes(nTitle))
+            score = 80;
+        else if (nTitle.includes(t) && t.length >= 2)
+            score = 60;
+        else if (n.includes(nTitle))
+            score = 40;
+        if (score > 0)
+            scored.push({ name: f.name, text: f.text, system: !!f.system, score });
+    }
+    if (!scored.length) {
+        const chars = new Set(nTitle.split(''));
+        for (const f of allTexts) {
+            if (f.system)
+                continue;
+            const t = normText(f.text);
+            if (!t)
+                continue;
+            let shared = 0;
+            for (const ch of new Set(t.split('')))
+                if (chars.has(ch))
+                    shared++;
+            if (shared > 0)
+                scored.push({ name: f.name, text: f.text, system: false, score: shared * 10 });
+        }
+    }
+    return scored.sort((a, b) => b.score - a.score).slice(0, topN);
+}
+/**
+ * 字段绑定严格解析（命中即止，**不做模糊自动绑定**）。
+ *
+ * 匹配顺序：
+ *   1. 显式指定 —— `column.fieldName` / `column.field` / `fieldMap[列标题]`
+ *   2. 列标题 === `fieldsKey.text`（归一化后精确相等）
+ *   3. `column.field` === `fieldsKey.text` / `fieldsKey.name`
+ *   4. 都不中 → `unmatched[]`（附模糊候选，仅供用户挑选）
+ *
+ * 显式命中但显示名与列文案不一致 → `display_mismatch`，需要用户确认。
+ */
+export function resolveFieldBindings(fieldsKey, columns, opts = {}) {
+    const fk = (fieldsKey || []).filter(Boolean);
+    const map = opts.fieldMap || {};
+    const confirmedTitles = new Set((opts.fieldConfirmed || []).map((x) => normText(x)));
+    const confirmedAll = !!opts.confirmDisplayMismatch;
+    const byText = new Map();
+    const byName = new Map();
+    for (const f of fk) {
+        const t = normText(fieldTextOf(f));
+        if (t && !byText.has(t))
+            byText.set(t, f);
+        const n = String(f.name || '');
+        if (n && !byName.has(n))
+            byName.set(n, f);
+    }
+    const bindings = [];
+    const unmatched = [];
+    const allTexts = fk.map((f) => ({
+        name: String(f.name || ''),
+        text: fieldTextOf(f),
+        system: isSystemField(f),
+    }));
+    const src = String(opts.sourceKey || '');
+    (columns || []).forEach((c, localIndex) => {
+        if (!c || c.formula)
+            return; // 公式列不参与字段绑定
+        // 多源时 `columns` 是按源切过的子集，下标必须换回整张报表的全局列号
+        const index = opts.globalIndices ? (opts.globalIndices[localIndex] ?? localIndex) : localIndex;
+        const title = String(c.title != null ? c.title : c.field || '');
+        const nTitle = normText(title);
+        // 多源时优先取源限定键 `"源key.列标题"`：两源同列名（关联布局的常态）时裸键会串源
+        const explicit = c.fieldName ||
+            (src ? map[`${src}.${title}`] || map[`${src}.${nTitle}`] : undefined) ||
+            map[title] ||
+            map[nTitle] ||
+            null;
+        const confirmMismatch = confirmedAll || c.confirmDisplayMismatch === true || confirmedTitles.has(nTitle);
+        let hit = null;
+        let how = '';
+        let requested = '';
+        if (explicit) {
+            requested = String(explicit);
+            hit = byName.get(requested) || byText.get(normText(requested)) || null;
+            how = 'explicit';
+            if (!hit) {
+                unmatched.push({
+                    index,
+                    title,
+                    reason: 'explicit_not_found',
+                    requested,
+                    message: `列「${title}」显式指定的字段「${requested}」不在该数据源字段清单中（禁止臆造字段名）。`,
+                    candidates: fuzzyCandidates(allTexts, nTitle, 8),
+                    allFields: allTexts,
+                });
+                return;
+            }
+        }
+        else {
+            hit = byText.get(nTitle) || null;
+            how = 'title';
+            if (!hit && c.field) {
+                const nf = normText(c.field);
+                hit = byText.get(nf) || byName.get(String(c.field)) || null;
+                how = hit ? 'field-text' : '';
+            }
+            if (!hit) {
+                unmatched.push({
+                    index,
+                    title,
+                    reason: 'no_exact_match',
+                    message: `列「${title}」在该数据源字段清单中**没有精确匹配的显示名**。` +
+                        '禁止自动兜底到系统字段（标题/数据ID…），请用户从候选或全量字段中指定。',
+                    candidates: fuzzyCandidates(allTexts, nTitle, 8),
+                    allFields: allTexts,
+                });
+                return;
+            }
+        }
+        const realText = fieldTextOf(hit);
+        if (normText(realText) !== nTitle && !confirmMismatch) {
+            unmatched.push({
+                index,
+                title,
+                reason: 'display_mismatch',
+                resolvedName: String(hit.name || ''),
+                resolvedText: realText,
+                message: `列「${title}」将绑定到字段「${realText}」(${hit.name})，与列文案不一致：` +
+                    `确认请加 spec.fieldConfirmed:["${title}"] 或 --field-confirmed "${title}"。`,
+                candidates: fuzzyCandidates(allTexts, nTitle, 8),
+            });
+            return;
+        }
+        bindings.push({
+            index,
+            title,
+            field: hit,
+            how,
+            displayText: realText,
+            mismatchConfirmed: normText(realText) !== nTitle,
+        });
+    });
+    return { ok: unmatched.length === 0, bindings, unmatched, fieldCount: fk.length };
+}
+/**
+ * 字段列表归一化 —— 抹平两个接口的信封差异。
+ *
+ * | 接口 | `data` 形状 | `dataSetId` |
+ * |---|---|---|
+ * | `dataset/fieldsBySource` | **裸数组** | 恒为 `"0"`（还没落库） |
+ * | `dataset/fieldsAndOriginFields` | `{fieldsKey, originFieldsKey}` | 真实值 |
+ *
+ * 逐键比对过：两者字段元素**同形**，只有 `dataSetId` 不同。
+ * 所以统一取「字段元素数组」这一层；调用方必须用**本报表真实 datasetId** 覆盖，
+ * 否则 `fieldsBySource` 的 0 会把单元格绑到错误的数据集上。
+ */
+export function normalizeFieldList(payload, opts = {}) {
+    let node = payload && payload.json && !payload.data ? payload.json : payload;
+    if (node && node.data !== undefined)
+        node = node.data;
+    if (node && node.data && (node.data.fieldsKey || node.data.originFieldsKey))
+        node = node.data;
+    let fields = [];
+    let originFields = [];
+    let shape = 'empty';
+    if (Array.isArray(node)) {
+        fields = node;
+        shape = 'bare-array';
+    }
+    else if (node && (node.fieldsKey || node.originFieldsKey)) {
+        fields = node.fieldsKey || node.originFieldsKey || [];
+        originFields = node.originFieldsKey || [];
+        shape = 'fieldsKey-object';
+    }
+    else if (node && Array.isArray(node.fields)) {
+        fields = node.fields;
+        shape = 'fields-array';
+    }
+    const injectDs = opts.datasetId != null && String(opts.datasetId) !== '';
+    if (injectDs) {
+        fields = fields.map((f) => ({
+            ...f,
+            dataSetId: String(opts.datasetId),
+            rawDataSetId: String((f && f.dataSetId) != null ? f.dataSetId : ''),
+        }));
+    }
+    return { fields, originFields, shape, dataSetIdInjected: injectDs };
+}
+/** 数据集回显名规范化：LOGIC → `(业务模块)`，共享表 → `(表单)`。已有后缀则不重复追加。 */
+export function normalizeDatasetName(formName, sourceType) {
+    const base = String(formName || '').trim();
+    if (!base)
+        return base;
+    if (/[（(].+[)）]\s*$/.test(base))
+        return base;
+    return base + (String(sourceType || 'logic').toLowerCase() === 'form' ? '(表单)' : '(业务模块)');
+}
+/** 工作表列号 → 字母（回读校验里报单元格坐标用）。 */
+export function colLetter(i) {
+    let s = '';
+    let n = i;
+    do {
+        s = String.fromCharCode(65 + (n % 26)) + s;
+        n = Math.floor(n / 26) - 1;
+    } while (n >= 0);
+    return s;
+}
+//# sourceMappingURL=fields.js.map

package/dist/services/report/fields.js.map

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

package/dist/services/report/forms.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 应用内定源（规则 B）。
+ *
+ * **只在当前应用里找表**：一上来拉全系统分组树/全库分页去找一张表，是纯粹的浪费；
+ * 用户给了应用上下文就在应用内解决。
+ *
+ * 硬规则：只有「准确表名 + 唯一精确命中」才允许自动绑定。
+ * 模糊命中、同名多条、未命中 —— 一律停下让用户指定，**禁止按关键词猜表、禁止建空壳试探**。
+ */
+import { ReportHttp } from './http.js';
+import type { FormCandidate, FormHit } from './types.js';
+export interface AppForm {
+    id: string;
+    name: string;
+    tableName?: string;
+}
+/** 列出应用内全部表单（一次请求，应用内检索已足够）。 */
+export declare function listFormsInApp(http: ReportHttp, appId: string): Promise<AppForm[]>;
+/** 关键词打分：完全相等 100 / 包含 40 / 被包含 20。 */
+export declare function scoreForm(form: AppForm, keywords: string[]): AppForm & {
+    score: number;
+    hits: string[];
+};
+/** 未指定准确表名：应用内检索候选，强制二次确认。 */
+export declare function suggestFormsInApp(http: ReportHttp, appId: string, keywords: string | string[], opts?: {
+    topN?: number;
+}): Promise<FormHit & {
+    appFormCount: number;
+    keywords: string[];
+    candidates: FormCandidate[];
+}>;
+/**
+ * 精确查找表单。
+ *
+ * 返回 `match` 取值：`exact`(唯一精确，可自动绑定) / `exact-ambiguous`(同名多条) /
+ * `fuzzy`(含 1 条) / `fuzzy-multi` / `none`。后四者 `needConfirm: true`。
+ */
+export declare function findFormInApp(http: ReportHttp, appId: string, formName: string): Promise<FormHit & {
+    appFormCount?: number;
+}>;
+export interface FormGateResult {
+    ok: boolean;
+    needConfirm: boolean;
+    candidates: FormCandidate[];
+    form?: {
+        id: string;
+        name: string;
+        match: string;
+    };
+    exitCode: number;
+    reason: string;
+    message: string;
+    confirmPrompt?: string;
+}
+/**
+ * 建表前的定源门禁（规则 B）。
+ *
+ * 触发「必须让用户指定表」的两种情况：
+ *   1. 需求**没指明具体表**；
+ *   2. 应用内检索**不是完全精准匹配**（模糊 / 多条 / 未命中）。
+ * 两种情况都**不建表**，把候选交出去。
+ */
+export declare function resolveFormWithPrompt(http: ReportHttp, appId: string, formName: string, opts?: {
+    sourceId?: string;
+    confirmedSourceId?: string;
+    formConfirmed?: boolean;
+    keywords?: string;
+    suggestOnly?: boolean;
+}): Promise<FormGateResult>;
+//# sourceMappingURL=forms.d.ts.map

package/dist/services/report/forms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms.d.ts","sourceRoot":"","sources":["../../../src/services/report/forms.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAO,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AASzD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,gCAAgC;AAChC,wBAAsB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAOxF;AAED,uCAAuC;AACvC,wBAAgB,SAAS,CACvB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,EAAE,GACjB,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAoB7C;AAED,8BAA8B;AAC9B,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,EAC3B,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAC3B,OAAO,CAAC,OAAO,GAAG;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CA4B9F;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAqE9C;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CAClB,GACL,OAAO,CAAC,cAAc,CAAC,CAuGzB"}