weaver-e10-builder 1.1.9 → 1.2.3

package/dist/services/report/sources.js

@@ -0,0 +1,147 @@
+/**
+ * 父格筛选的比较方式白名单（**TitleCase**）。
+ *
+ * ⚠️ 与条件格式的 `ALLOWED_RELATIONS`（`validate.ts`，全小写 `equals`/`greaterAndEquals`）
+ * 是**两套枚举**，不可互相复用：这里写小写会被设计器判为无效，`eq`/`contains`/`uncontains`
+ * 这类简写平台一律不认。
+ */
+export const LEFT_FILTER_TYPES = new Set([
+    'Equals',
+    'NotEquals',
+    'Greater',
+    'GreaterOrEquals',
+    'Less',
+    'LessOrEquals',
+    'StartsWith',
+    'NotStartsWith',
+    'EndsWith',
+    'NotEndsWith',
+    'Contain',
+    'NotContain',
+    'Include',
+    'NotInclude',
+    'Null',
+    'NotNull',
+]);
+/** 平台不认的简写，命中时直接报错而不是静默降级。 */
+export const LEGACY_FILTER_TYPES = new Set([
+    'eq',
+    'neq',
+    'contains',
+    'uncontains',
+    'empty',
+    'nempty',
+    'equals',
+    'notContain',
+]);
+/**
+ * 把 spec 的 `sources[]` / `columns[].source` 解析成布局计划。
+ *
+ * 无 `sources` 时退化成「单源」：所有列同属一个隐式源，无入口格 —— 与历史行为完全一致。
+ */
+export function resolveSourcePlan(spec) {
+    const errors = [];
+    const columns = spec.columns || [];
+    const rawSources = Array.isArray(spec.sources) ? spec.sources : [];
+    if (!rawSources.length) {
+        // 单源：不引入任何区域划分，行为与旧版逐字节一致
+        return {
+            sources: [],
+            columnSource: columns.map(() => ''),
+            regions: columns.length ? [{ sourceKey: '', start: 0, end: columns.length - 1 }] : [],
+            entryParentColumn: new Map(),
+            errors,
+        };
+    }
+    const sources = rawSources.map((s, i) => ({
+        ...s,
+        key: String(s.key || `s${i + 1}`),
+    }));
+    // 源 key 唯一
+    const seen = new Set();
+    for (const s of sources) {
+        if (seen.has(s.key))
+            errors.push(`sources 里有两个都叫「${s.key}」的源，key 必须唯一。`);
+        seen.add(s.key);
+    }
+    // 两个源指向同一张表单会塌成一个数据集，跨源关联变成自引用（`subordination` 两段相同）
+    const bySourceId = new Map();
+    for (const s of sources) {
+        if (!s.sourceId)
+            continue;
+        const prev = bySourceId.get(String(s.sourceId));
+        if (prev) {
+            errors.push(`源「${prev}」与「${s.key}」指向同一张表单（sourceId=${s.sourceId}）。` +
+                '同一张表在同一张报表里只能挂一次数据集，跨源关联会退化成自引用；请改为单源布局。');
+        }
+        bySourceId.set(String(s.sourceId), s.key);
+    }
+    const primary = sources[0];
+    // 每列的源
+    const columnSource = columns.map((c) => String(c.source || primary.key));
+    for (let i = 0; i < columnSource.length; i++) {
+        if (!seen.has(columnSource[i])) {
+            errors.push(`列「${columns[i].title}」的 source=「${columnSource[i]}」没有在 sources 里声明（已声明：${sources
+                .map((s) => s.key)
+                .join(', ')}）。`);
+        }
+    }
+    if (errors.length) {
+        return { sources, columnSource, regions: [], entryParentColumn: new Map(), errors };
+    }
+    // 连续同源 → 区域
+    const regions = [];
+    for (let i = 0; i < columnSource.length; i++) {
+        const last = regions[regions.length - 1];
+        if (last && last.sourceKey === columnSource[i])
+            last.end = i;
+        else
+            regions.push({ sourceKey: columnSource[i], start: i, end: i });
+    }
+    const entryParentColumn = new Map();
+    // 每个非父源只能占一段（平台允许多段，CLI 暂不支持 —— 多段要逐段各配一次入口筛选）
+    const runsBySource = new Map();
+    for (const r of regions)
+        runsBySource.set(r.sourceKey, (runsBySource.get(r.sourceKey) || 0) + 1);
+    for (const [key, n] of runsBySource) {
+        if (key !== primary.key && n > 1) {
+            errors.push(`源「${key}」被拆成了 ${n} 段连续区域。平台允许一段以上（每段各配一次父格筛选），当前版本只支持每个子源占一段；` +
+                '请把该源的列排在一起，或改用单源布局。');
+        }
+    }
+    for (let k = 1; k < regions.length; k++) {
+        const region = regions[k];
+        const src = sources.find((s) => s.key === region.sourceKey);
+        const link = src.link;
+        if (!link) {
+            errors.push(`源「${src.key}」的列排在源「${regions[k - 1].sourceKey}」后面，但没写 link（跨源区域必须声明关联字段）。` +
+                `请在 sources 里给「${src.key}」加：{ "link": { "parent": "${regions[k - 1].sourceKey}", "parentField": "…", "childField": "…" } }`);
+            continue;
+        }
+        if (String(link.parent) !== regions[k - 1].sourceKey) {
+            errors.push(`源「${src.key}」的 link.parent=「${link.parent}」，但它左边紧邻的区域来自「${regions[k - 1].sourceKey}」。` +
+                '入口格的父格只能指向左边紧邻的区域。');
+            continue;
+        }
+        if (!link.parentField || !link.childField) {
+            errors.push(`源「${src.key}」的 link 缺少 parentField / childField。`);
+            continue;
+        }
+        const type = String(link.type || 'Equals');
+        if (LEGACY_FILTER_TYPES.has(type)) {
+            errors.push(`源「${src.key}」的 link.type=「${type}」是简写，平台不认；请改用 TitleCase 枚举（如 Equals / NotContain / Null）。`);
+            continue;
+        }
+        if (!LEFT_FILTER_TYPES.has(type)) {
+            errors.push(`源「${src.key}」的 link.type=「${type}」不在白名单内。有效值：${[...LEFT_FILTER_TYPES].join(' / ')}。`);
+            continue;
+        }
+        entryParentColumn.set(region.start, regions[k - 1].end);
+    }
+    return { sources, columnSource, regions, entryParentColumn, errors };
+}
+/** 该列是否是非父源的区域入口格（要挂父格筛选的那一格）。 */
+export function isEntryColumn(plan, index) {
+    return plan.entryParentColumn.has(index);
+}
+//# sourceMappingURL=sources.js.map

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

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

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

@@ -0,0 +1,312 @@
+/**
+ * EDC 报表的类型定义：声明式 spec、数据集/字段、工作簿单元格。
+ */
+import type { StyleSpec } from './constants.js';
+/** 报表视角的数据集（`dataset/list` 一行）。 */
+export interface ReportDataset {
+    id: string;
+    name: string;
+    sourceId?: string;
+    sourceType?: string;
+    sourceGroup?: string;
+    tableText?: string;
+    /** 本次解析是否复用已有挂载（同源只挂一次）。 */
+    reused?: boolean;
+    /** 本次解析是否新建。 */
+    created?: boolean;
+    /** 期望的回显名（`{表单名}(业务模块)`）。 */
+    requestedName?: string;
+    /** 回显名是否已符合预期。 */
+    nameNormalized?: boolean;
+    /** 同 sourceId 的重复挂载 id（存量脏数据，需提示用户清理）。 */
+    duplicates?: string[];
+}
+/** `fieldsKey` 里的一个字段元素。 */
+export interface ReportField {
+    name: string;
+    nameIndex?: string;
+    text?: string;
+    showName?: string;
+    dataSetId?: string;
+    datasetName?: string;
+    tableText?: string;
+    sourceType?: string;
+    fieldId?: string;
+    config?: {
+        fieldId?: string;
+        [k: string]: unknown;
+    } | null;
+    [k: string]: unknown;
+}
+/** 字段绑定结果（一列 → 一个真实字段）。 */
+export interface FieldBinding {
+    index: number;
+    title: string;
+    field: ReportField;
+    how: string;
+    displayText: string;
+    mismatchConfirmed: boolean;
+}
+/** 未命中项：**必须交给用户挑字段**，禁止自动兜底。 */
+export interface UnmatchedColumn {
+    index: number;
+    title: string;
+    reason: 'explicit_not_found' | 'no_exact_match' | 'display_mismatch';
+    message: string;
+    requested?: string;
+    resolvedName?: string;
+    resolvedText?: string;
+    candidates?: Array<{
+        name: string;
+        text: string;
+        system: boolean;
+        score: number;
+    }>;
+    allFields?: Array<{
+        name: string;
+        text: string;
+        system: boolean;
+    }>;
+}
+export interface FieldBindingPlan {
+    ok: boolean;
+    bindings: FieldBinding[];
+    unmatched: UnmatchedColumn[];
+    fieldCount: number;
+}
+/** 条件格式规则（spec 里用人类可读写法，落库时编译成平台结构）。 */
+export interface ColumnRule {
+    highlight?: {
+        op: string;
+        value1?: string | number;
+        value2?: string | number;
+        foreColor?: string;
+        fontSize?: number;
+        fontFamily?: string;
+        bold?: boolean;
+        italic?: boolean;
+        underline?: boolean;
+    };
+    databar?: {
+        leftType?: string;
+        leftValue?: string | number;
+        rightType?: string;
+        rightValue?: string | number;
+        solid?: boolean;
+        color?: string;
+        negativeFillColor?: string;
+    };
+    iconset?: {
+        type?: number | string;
+        thresholds?: Array<number | string>;
+    };
+}
+/** spec.columns[] 的一项。 */
+export interface SpecColumn {
+    /** 列标题。同时是字段匹配键（标题 === 字段显示名时自动绑定）。 */
+    title: string;
+    /** 显式字段：显示名或 `field_xxx`。 */
+    field?: string;
+    /** 显式字段技术名（优先级最高）。 */
+    fieldName?: string;
+    /** 该列允许文案与字段显示名不一致。 */
+    confirmDisplayMismatch?: boolean;
+    /** 列宽，默认 120。 */
+    width?: number;
+    /** 数字格式：key 或中文别名。 */
+    format?: string;
+    /** 公式（不带前导 `=`）。有公式的列不参与字段绑定。 */
+    formula?: string;
+    /** 日期分组。 */
+    groupType?: string;
+    /** 条件格式。 */
+    rule?: ColumnRule;
+    /** 该列来自哪个源（`sources[].key`）。缺省 = `sources[0].key`。 */
+    source?: string;
+}
+export interface SpecLayout {
+    /** 标题（置顶合并行）。 */
+    title?: string;
+    /** 冻结行数（1 = 冻结表头）。 */
+    freezeRows?: number;
+    /** 数据区水平位置：left | center。**不要写 0**。 */
+    showLocation?: string;
+}
+/** 声明式搭表 spec（`report build --spec spec.json`）。 */
+export interface ReportSpec {
+    appId: string;
+    /** 报表名（写入即最终名，禁止落库后改名）。 */
+    name: string;
+    /** 也接受 `reportName`。 */
+    reportName?: string;
+    /** 表单名（精确匹配才自动绑定）。 */
+    form?: string;
+    /** 已确认的表单 id。 */
+    sourceId?: string;
+    /** 用户已确认当前表单。 */
+    formConfirmed?: boolean;
+    /** 未指明表时的候选关键词。 */
+    formKeywords?: string;
+    keywords?: string;
+    columns: SpecColumn[];
+    /** `{ 列标题: 字段显示名 | field_雪花 | 系统字段名 }` —— 显式字段兜底。 */
+    fieldMap?: Record<string, string>;
+    /** 文案与显示名不同但已确认的列标题。 */
+    fieldConfirmed?: string[];
+    /** 允许所有列文案与显示名不一致。 */
+    confirmDisplayMismatch?: boolean;
+    style?: StyleSpec;
+    titleStyle?: StyleSpec;
+    headerStyle?: StyleSpec;
+    columnHeaderStyle?: StyleSpec;
+    bodyStyle?: StyleSpec;
+    stylePreset?: string;
+    applyDefaultHeader?: boolean;
+    defaultHeader?: boolean;
+    styleFromMockup?: boolean;
+    fromMockup?: boolean;
+    hasEffectImage?: boolean;
+    layout?: SpecLayout;
+    /** 仅当该 datasetId 已挂在**本报表**上时才复用。 */
+    datasetId?: string;
+    sourceType?: string;
+    sourceGroup?: string;
+    sourceName?: string;
+    /**
+     * 多数据源声明。**缺省时按单源处理**，行为与只有 `form`/`sourceId` 时完全一致。
+     * `sources[0]` 是父源；每个非父源用 `link` 声明跟谁关联。
+     */
+    sources?: SourceRef[];
+}
+/** 区域入口格的父格筛选声明（子源 → 父源）。 */
+export interface SourceLink {
+    /** 父源 key（必须已声明，且排在前面）。 */
+    parent: string;
+    /** 父源侧关联字段（显示名或 `field_xxx`）。 */
+    parentField: string;
+    /** 本源侧关联字段（显示名或 `field_xxx`）。 */
+    childField: string;
+    /** 比较方式，平台 TitleCase 枚举，默认 `Equals`。 */
+    type?: string;
+}
+/** spec `sources[]` 的一项。 */
+export interface SourceRef {
+    /** spec 内引用名（`columns[].source` 用它）。 */
+    key: string;
+    /** 准确表单名；与 `sourceId` 二选一。 */
+    form?: string;
+    /** 已确认的表单 ID。 */
+    sourceId?: string;
+    /** 数据集注册契约（普通应用 `LOGIC` + `weaver-ebuilder-form-service`）。 */
+    sourceType?: string;
+    sourceGroup?: string;
+    /** 数据集回显名；缺后缀时自动补。 */
+    sourceName?: string;
+    /** 非父源必填：挂到哪个源上、用哪对字段关联。 */
+    link?: SourceLink;
+}
+/** 表单检索结果（规则 B 的门禁产物）。 */
+export interface FormHit {
+    id: string;
+    name: string;
+    match: string;
+    needConfirm?: boolean;
+    autoBind?: boolean;
+    message?: string;
+    candidates?: FormCandidate[];
+}
+export interface FormCandidate {
+    id: string;
+    name: string;
+    match?: string;
+    score?: number;
+}
+/** 单元格样式（落库结构，键名即平台契约，勿改）。 */
+export interface CellStyle {
+    backColor: string;
+    backgroundImageLayout: number;
+    borderBottom: {
+        color: string;
+        style: number;
+    };
+    borderLeft: {
+        color: string;
+        style: number;
+    };
+    borderRight: {
+        color: string;
+        style: number;
+    };
+    borderTop: {
+        color: string;
+        style: number;
+    };
+    font: string;
+    foreColor: string;
+    hAlign: number;
+    vAlign: number;
+    textDecoration: number;
+    textIndent: number;
+    wordWrap: boolean;
+    formatter?: string;
+    cellType?: Record<string, unknown>;
+}
+export interface WorkbookCell {
+    style: CellStyle;
+    tag: Record<string, unknown>;
+    rowCount?: number;
+    colCount?: number;
+    formula?: string;
+}
+export interface WorkbookSheet {
+    name: string;
+    rowCount: number;
+    columnCount: number;
+    activeRow: number;
+    activeCol: number;
+    frozenRowCount: number;
+    frozenColCount: number;
+    rows: Array<{
+        size: number;
+    }>;
+    columns: Array<{
+        size: number;
+    }>;
+    spans: Array<{
+        row: number;
+        col: number;
+        rowCount: number;
+        colCount: number;
+    }>;
+    tag: Record<string, unknown>;
+    data: {
+        dataTable: Record<string, Record<string, WorkbookCell>>;
+    };
+}
+export interface Workbook {
+    version: string;
+    sheetCount: number;
+    newTabVisible: boolean;
+    tabEditable: boolean;
+    sheets: Record<string, WorkbookSheet>;
+}
+/** `getReportDevInfo` 回读的一条字段记录。 */
+export interface DevField {
+    x?: number | string;
+    y?: number | string;
+    name?: string;
+    text?: string;
+    cellType?: string;
+    tableName?: string;
+    fixed?: number | string;
+    [k: string]: unknown;
+}
+export interface ReportDevInfo {
+    fields?: DevField[];
+    workbookProps?: unknown;
+    sheetProps?: unknown[];
+    designKey?: string;
+    snapshot?: unknown;
+    [k: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/services/report/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/report/types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,169 @@
+/**
+ * 报表配置校验规则引擎（本地，不落库）。
+ *
+ * 这些规则都是"写错了不会报错、但设计器上表现异常"的那一类 ——
+ * 比如 `between` 引擎不认（会静默不生成条件格式）、`transType=person` 被废弃、
+ * 超链接里混进全角 `？` 导致点击无反应。所以在写之前先拦住。
+ */
+import { resolveLayerStyles } from './constants.js';
+export interface ValidationIssue {
+    level: 'error' | 'warning' | 'info';
+    message: string;
+    suggestion?: Record<string, any>;
+}
+export interface ValidationResult {
+    ok: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+    infos: ValidationIssue[];
+    normalized?: any;
+}
+export declare const BASE_DEFAULTS: {
+    groupId: string;
+    showOrder: string;
+    nameLabelId: string;
+    systemType: string;
+};
+/**
+ * 报表名/分组等基础字段的写入规范。
+ *
+ * `nameLabelId` 传空串会在平台 `Long.parseLong` 处炸成「报表内部错误」，
+ * 所以无多语言时必须显式写 `-1`。
+ */
+export declare function validateBaseMeta(opts: {
+    name: string;
+    nameLabelId?: string;
+    groupId?: string;
+    showOrder?: string;
+}): ValidationResult & {
+    normalized: {
+        name: string;
+        nameLabelId: string;
+        groupId: string;
+        showOrder: string;
+    };
+};
+/** 分层样式的默认值，供 `validate style --list` 输出。 */
+export declare function styleCatalog(): {
+    DEFAULT_BODY_STYLE: {
+        font: string;
+        fontSize: number;
+        bold: boolean;
+        italic: boolean;
+        underline: boolean;
+        foreColor: string;
+        backColor: string;
+        hAlign: string;
+        vAlign: string;
+        borderColor: string;
+    };
+    DEFAULT_TITLE_STYLE: {
+        font: string;
+        fontSize: number;
+        bold: boolean;
+        italic: boolean;
+        underline: boolean;
+        foreColor: string;
+        backColor: string;
+        hAlign: string;
+        vAlign: string;
+        borderColor: string;
+    };
+    DEFAULT_HEADER_STYLE: {
+        font: string;
+        fontSize: number;
+        bold: boolean;
+        italic: boolean;
+        underline: boolean;
+        foreColor: string;
+        backColor: string;
+        hAlign: string;
+        vAlign: string;
+        borderColor: string;
+    };
+    fontSizes: number[];
+    numberFormats: Record<string, {
+        formatter: string;
+        key: string;
+    }>;
+};
+export { resolveLayerStyles };
+/** 引擎认识的 relation（`highlight:` 前缀之后的部分）。 */
+export declare const ALLOWED_RELATIONS: Set<string>;
+/** 常见误写 → 引擎真名。`between` 就是最典型的坑：引擎只认 `interval`。 */
+export declare const RELATION_ALIAS_FIX: Record<string, string>;
+/** 校验并规范化一条 `conditionRule`。 */
+export declare function validateConditionRule(input: any, label?: string): ValidationResult & {
+    normalized: any;
+};
+/**
+ * 把用户口语映射成条件格式规则（不落库，只帮用户确认意图）。
+ */
+export declare function mapNaturalPhrase(phrase: string): ValidationResult & {
+    normalized: any;
+};
+export declare const FORMAT_CATALOG: Array<{
+    label: string;
+    formatter: string;
+    key1: string;
+}>;
+export declare const GROUP_TYPE_ALIAS: Record<string, string>;
+export declare const SUPPORTED_FONTS: Set<string>;
+export declare const DEFAULT_FONT = "\u5FAE\u8F6F\u96C5\u9ED1";
+export declare const DEFAULT_FONT_SIZE = 12;
+/** 数字格式规范化：非目录全等值会被设计器当成「其他数字格式」回显。 */
+export declare function normalizeNumberFormat(input: {
+    map?: string;
+    formatter?: string;
+    formatterType?: any;
+}): ValidationResult & {
+    normalized: any;
+};
+export declare function normalizeGroupType(raw: unknown): ValidationResult & {
+    normalized: any;
+};
+/** 字体规范化：目录外的字号/字体回退默认值并提示（不中断）。 */
+export declare function normalizeFont(font: unknown): ValidationResult & {
+    normalized: {
+        font: string;
+        fontSize: number;
+    };
+};
+/** 整表全量设置样式一律拦下 —— 会覆盖用户已有的逐格设置。 */
+export declare function validateCellPatch(patch: any): ValidationResult;
+export declare const BROWSER_PRESETS: Record<string, string>;
+/** 已废弃的 `transType` 写法 —— 写进去设计器不认，必须换成新写法。 */
+export declare const TRANS_MAP: Record<string, {
+    transType?: string;
+    browserType?: any[];
+    error?: string;
+    warn?: string;
+    note?: string;
+}>;
+export declare const QR_MAP: Record<string, string>;
+export declare const DIR_MAP: Record<string, string>;
+/** 校验并规范化转换面板设置。 */
+export declare function normalizeTransform(input: any): ValidationResult & {
+    normalized: any;
+};
+export declare const OPEN_TYPE_MAP: Record<string, string>;
+/** 全角 `？`/`＆` 会让链接点击无反应，统一换成 ASCII。 */
+export declare function sanitizeHrefString(s: unknown): string;
+export declare function normalizeHref(input: any, opts?: {
+    fix?: boolean;
+}): ValidationResult & {
+    normalized: any;
+};
+/** 超链接写法速查（`validate href --list`）。 */
+export declare function hrefCatalog(): {
+    openTypes: Record<string, string>;
+    rules: {
+        queryCell: string;
+        pathCell: string;
+        queryCondition: string;
+        asciiOnly: string;
+        avoidParamNames: string[];
+        parentChain: string;
+    };
+};
+//# sourceMappingURL=validate.d.ts.map

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

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