@agile-team/mach-report 2.11.2 → 2.12.0

package/dist/designer.d.ts

@@ -85,6 +85,39 @@ declare const BASE_TEMPLATE_EDITOR_MESSAGES: {
     note: string;
     invalid: string;
 };
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions_2 {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
+/** Serializable symbol settings. Encoders remain in the optional /codes entry. */
+declare interface CodeOptions_3 {
+    /** Explicit content, including an empty value, takes precedence over legacy fallbackText. */
+    value?: string;
+    symbology?: "code128" | "code39" | "ean13" | "ean8";
+    errorCorrection?: "L" | "M" | "Q" | "H";
+    /** White modules around a symbol: QR >=4, linear >=10, EAN >=11. */
+    quietZoneModules?: number;
+    /** Human-readable content below a linear barcode. */
+    showText?: boolean;
+}
 /**
  * 列值格式化（声明式、JSON 可序列化）。
  * 在 paginate 的 cellText 出口统一消费：格式化发生在进 RenderPlan 之前，
@@ -151,6 +184,30 @@ declare type ColumnFormat_3 = {
     kind: "date";
     pattern?: string;
 };
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding {
+    field: string;
+    format?: ValueFormat;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding_2 {
+    field: string;
+    format?: ValueFormat_2;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
+/** A literal own field of the current label record; expressions and paths are not evaluated. */
+declare interface ComponentBinding_3 {
+    field: string;
+    format?: ValueFormat_3;
+    prefix?: string;
+    suffix?: string;
+    emptyText?: string;
+}
 declare interface ComponentImageContext {
     readonly component: Readonly<PlanComponent>;
     readonly pageIndex: number;
@@ -1465,6 +1522,18 @@ declare interface OutputDiagnostic {
     nid?: string;
     message: string;
 }
+declare interface OutputDiagnostic_2 {
+    code: "missing-image" | "unsupported-component" | "unsupported-image-format" | "unsupported-style" | "rich-text-flattened" | "nested-components-omitted" | "async-image-required" | "image-decode-failed" | "asset-render-failed" | "asset-budget-exceeded";
+    severity: "warning";
+    format: OutputFormat_2;
+    pageIndex: number;
+    componentIndex: number;
+    /** Nested grid child location as repeating [rowIndex, columnIndex, childIndex] triples. */
+    componentPath?: readonly number[];
+    kind: string;
+    nid?: string;
+    message: string;
+}
 declare interface OutputDiagnosticOptions extends OutputTaskOptions {
     /** Structured fidelity diagnostics; rendering never silently invents missing content. */
     onDiagnostic?: (diagnostic: OutputDiagnostic) => void;
@@ -1472,6 +1541,7 @@ declare interface OutputDiagnosticOptions extends OutputTaskOptions {
     fidelity?: "warn" | "strict";
 }
 declare type OutputFormat = "dom" | "canvas" | "pdf" | "xlsx";
+declare type OutputFormat_2 = "dom" | "canvas" | "pdf" | "xlsx";
 /** Stage counts are exact completed units; encoding libraries may remain indeterminate. */
 declare interface OutputTaskOptions {
     signal?: AbortSignal;
@@ -1554,6 +1624,10 @@ export declare interface ParamEditorOptions {
     accept(definitions: ReportParamDef[]): boolean;
 }
 declare interface PlanComponent {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind;
@@ -1578,6 +1652,10 @@ declare interface PlanComponent {
     fallbackText?: string;
 }
 declare interface PlanComponent_2 {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions_2;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding_2;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind_2;
@@ -1602,6 +1680,10 @@ declare interface PlanComponent_2 {
     fallbackText?: string;
 }
 declare interface PlanComponent_3 {
+    /** Optional QR/barcode encoding configuration; no encoder is loaded by the core. */
+    code?: CodeOptions_3;
+    /** Template-only binding; resolved and removed before constructing the output plan. */
+    binding?: ComponentBinding_3;
     /** Template page furniture repeats per page and reserves its vertical band. */
     pageAnchor?: "header" | "footer";
     kind: ComponentKind_3;
@@ -1701,6 +1783,78 @@ declare interface PlanTableFragment_3 {
     };
 }
 declare const PRODUCT_TEMPLATE_EDITOR_MESSAGES: {
+    paperAndPages: string;
+    pageDirectory: string;
+    pageName: string;
+    addPage: string;
+    duplicatePage: string;
+    removePage: string;
+    removePageConfirm: string;
+    confirmRemovePage: string;
+    paperPreset: string;
+    labelPaper: string;
+    customPaper: string;
+    paperWidth: string;
+    paperHeight: string;
+    pageLayout: string;
+    fixedPaper: string;
+    completeWide: string;
+    pageMargins: string;
+    marginTop: string;
+    marginRight: string;
+    marginBottom: string;
+    marginLeft: string;
+    pageOverflow: string;
+    pageOverflowHint: string;
+    locateOverflow: string;
+    repeatRecords: string;
+    repeatRecordsHint: string;
+    recordDataset: string;
+    recordRowKey: string;
+    labelCopies: string;
+    fixedCopies: string;
+    fieldCopies: string;
+    copiesPerRecord: string;
+    copiesField: string;
+    repeatBoundHint: string;
+    repeatOrderHint: string;
+    repeatNeedsFixed: string;
+    dataBinding: string;
+    contentSource: string;
+    staticContent: string;
+    recordField: string;
+    bindingField: string;
+    bindingNeedsRepeat: string;
+    bindingRecordHint: string;
+    bindingImageHint: string;
+    valueFormat: string;
+    naturalFormat: string;
+    numberFormat: string;
+    percentFormat: string;
+    dateFormat: string;
+    decimalPlaces: string;
+    datePattern: string;
+    bindingDecoration: string;
+    valuePrefix: string;
+    valueSuffix: string;
+    emptyValueText: string;
+    insertQrcode: string;
+    insertBarcode: string;
+    codeSettings: string;
+    codeValue: string;
+    codeSymbology: string;
+    codeCorrection: string;
+    codeQuietZone: string;
+    codeShowText: string;
+    eanContentHint: string;
+    code39ContentHint: string;
+    code128ContentHint: string;
+    codePlaceholder: string;
+    codePreviewHint: string;
+    boundImagePlaceholder: string;
+    rulerLabel: string;
+    rulerToggle: string;
+    designSample: string;
     repeatPage: string;
     repeatNone: string;
     repeatHeader: string;
@@ -2263,18 +2417,24 @@ declare interface ReportTemplate {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
     params?: ReportParamDef[];
+    /** Fixed label pages repeat in record → copy → template-page order. */
+    repeat?: ReportTemplateRepeat;
     pages: TemplatePage[];
 }
 declare interface ReportTemplate_2 {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
     params?: ReportParamDef_2[];
+    /** Fixed label pages repeat in record → copy → template-page order. */
+    repeat?: ReportTemplateRepeat_2;
     pages: TemplatePage_2[];
 }
 declare interface ReportTemplate_3 {
     schemaVersion?: string;
     /** 参数定义（可选；宿主也可经 ReportPreview 的 paramDefs prop 提供，prop 优先） */
     params?: ReportParamDef_3[];
+    /** Fixed label pages repeat in record → copy → template-page order. */
+    repeat?: ReportTemplateRepeat_3;
     pages: TemplatePage_3[];
 }
 declare interface ReportTemplateCatalogEntry extends ReportTemplateSummary {
@@ -2366,6 +2526,33 @@ export declare const ReportTemplateLibrary: DefineComponent<TemplateLibraryOptio
 }, string, MachReportVuePublicProps, Readonly<TemplateLibraryOptions> & Readonly<{
     onOpen?: ((document: ReportTemplateDocument_3, context?: ReportTemplateCatalogOpenContext_2 | undefined) => any) | undefined;
 }>, {}>;
+/** Every record emits its copies, each containing all template pages in their original order. */
+declare interface ReportTemplateRepeat {
+    dataset: string;
+    rowKey?: string;
+    /** Whole copies per record, 1..1000. The field value must be a number, never a numeric string. */
+    copies?: number | {
+        field: string;
+    };
+}
+/** Every record emits its copies, each containing all template pages in their original order. */
+declare interface ReportTemplateRepeat_2 {
+    dataset: string;
+    rowKey?: string;
+    /** Whole copies per record, 1..1000. The field value must be a number, never a numeric string. */
+    copies?: number | {
+        field: string;
+    };
+}
+/** Every record emits its copies, each containing all template pages in their original order. */
+declare interface ReportTemplateRepeat_3 {
+    dataset: string;
+    rowKey?: string;
+    /** Whole copies per record, 1..1000. The field value must be a number, never a numeric string. */
+    copies?: number | {
+        field: string;
+    };
+}
 declare interface ReportTemplateReviewIssue {
     code: "template" | "compatibility" | "dataset" | "field" | "sample" | "layout" | "output" | "params";
     severity: "error" | "warning";
@@ -2375,6 +2562,8 @@ declare interface ReportTemplateReviewIssue {
     pageIndex?: number;
     componentIndex?: number;
     field?: string;
+    /** Original structured output finding, retained for trusted publication resource handling. */
+    diagnostic?: OutputDiagnostic_2;
 }
 declare type ReportTemplateSummary = Omit<ReportTemplateDocument, "template">;
 declare interface RichParagraph {
@@ -2623,6 +2812,78 @@ declare interface StyleRule_3 {
     style: Record<string, unknown>;
 }
 export declare const TEMPLATE_EDITOR_MESSAGES: {
+    paperAndPages: string;
+    pageDirectory: string;
+    pageName: string;
+    addPage: string;
+    duplicatePage: string;
+    removePage: string;
+    removePageConfirm: string;
+    confirmRemovePage: string;
+    paperPreset: string;
+    labelPaper: string;
+    customPaper: string;
+    paperWidth: string;
+    paperHeight: string;
+    pageLayout: string;
+    fixedPaper: string;
+    completeWide: string;
+    pageMargins: string;
+    marginTop: string;
+    marginRight: string;
+    marginBottom: string;
+    marginLeft: string;
+    pageOverflow: string;
+    pageOverflowHint: string;
+    locateOverflow: string;
+    repeatRecords: string;
+    repeatRecordsHint: string;
+    recordDataset: string;
+    recordRowKey: string;
+    labelCopies: string;
+    fixedCopies: string;
+    fieldCopies: string;
+    copiesPerRecord: string;
+    copiesField: string;
+    repeatBoundHint: string;
+    repeatOrderHint: string;
+    repeatNeedsFixed: string;
+    dataBinding: string;
+    contentSource: string;
+    staticContent: string;
+    recordField: string;
+    bindingField: string;
+    bindingNeedsRepeat: string;
+    bindingRecordHint: string;
+    bindingImageHint: string;
+    valueFormat: string;
+    naturalFormat: string;
+    numberFormat: string;
+    percentFormat: string;
+    dateFormat: string;
+    decimalPlaces: string;
+    datePattern: string;
+    bindingDecoration: string;
+    valuePrefix: string;
+    valueSuffix: string;
+    emptyValueText: string;
+    insertQrcode: string;
+    insertBarcode: string;
+    codeSettings: string;
+    codeValue: string;
+    codeSymbology: string;
+    codeCorrection: string;
+    codeQuietZone: string;
+    codeShowText: string;
+    eanContentHint: string;
+    code39ContentHint: string;
+    code128ContentHint: string;
+    codePlaceholder: string;
+    codePreviewHint: string;
+    boundImagePlaceholder: string;
+    rulerLabel: string;
+    rulerToggle: string;
+    designSample: string;
     repeatPage: string;
     repeatNone: string;
     repeatHeader: string;
@@ -3029,6 +3290,12 @@ declare interface TreeTableOptions_3 {
     /** Bounded leaf-to-ancestor aggregate work; default one million. */
     maxAggregationVisits?: number;
 }
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat = ColumnFormat;
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat_2 = ColumnFormat_2;
+/** The same declarative formatting used by list columns, before any output backend. */
+declare type ValueFormat_3 = ColumnFormat_3;
 declare interface XlsxImageOptions {
     /** Decoded bytes per unique embedded image; default 16 MiB. */
     maxImageBytes?: number;