@printstack/print-studio 0.0.0-stage → 0.1.0

package/elements/definitions/barcode-element.d.ts

@@ -0,0 +1 @@
+export declare const barcodeElement: import('../../core/element-registry').ElementDefinition;

package/elements/definitions/ellipse-element.d.ts

@@ -0,0 +1 @@
+export declare const ellipseElement: import('../../core/element-registry').ElementDefinition;

package/elements/definitions/image-element.d.ts

@@ -0,0 +1 @@
+export declare const imageElement: import('../../core/element-registry').ElementDefinition;

package/elements/definitions/line-element.d.ts

@@ -0,0 +1,5 @@
+import { Point } from '../../core/geometry';
+import { ElementNode } from '../../core/types';
+/** 节点的两个端点（页面坐标）；数据缺失时按包围盒水平中线兜底 */
+export declare function lineEndpoints(node: ElementNode): [Point, Point];
+export declare const lineElement: import('../../core/element-registry').ElementDefinition;

package/elements/definitions/qrcode-element.d.ts

@@ -0,0 +1 @@
+export declare const qrcodeElement: import('../../core/element-registry').ElementDefinition;

package/elements/definitions/rect-element.d.ts

@@ -0,0 +1 @@
+export declare const rectElement: import('../../core/element-registry').ElementDefinition;

package/elements/definitions/table-element.d.ts

@@ -0,0 +1 @@
+export declare const tableElement: import('../../core/element-registry').ElementDefinition;

package/elements/definitions/text-element.d.ts

@@ -0,0 +1,3 @@
+import { InspectorSection } from '../../core/types';
+export declare const inspectorSections: InspectorSection[];
+export declare const textElement: import('../../core/element-registry').ElementDefinition;

package/elements/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 元素注册入口：把内置元素定义注册到全局注册表。
+ * 新增元素 = 新建定义文件 + 在此登记，设计器与解析器自动获得该元素的全部能力。
+ */
+export declare const builtinElements: import('../core/element-registry').ElementDefinition[];
+export declare function registerBuiltinElements(): void;
+export type { TableMergeRule } from './table/table-style';
+export { elementRegistry } from '../core/element-registry';

package/elements/shared/image-drop.d.ts

@@ -0,0 +1,2 @@
+import { FileDropCapability } from '../../core/element-registry';
+export declare const imageFileDrop: FileDropCapability;

package/elements/shared/line-style.d.ts

@@ -0,0 +1,4 @@
+import { ElementNode } from '../../core/types';
+/** 将端点映射为以起点为旋转中心的 CSS 线段。 */
+export declare function lineGeometryStyle(node: ElementNode, scale: number, unit: 'mm' | 'px'): Record<string, string>;
+export declare function lineBorderStyle(color: string, dash: unknown, width: number, unit: 'mm' | 'px'): Record<string, string>;

package/elements/shared/qrcode-inspector.d.ts

@@ -0,0 +1,7 @@
+import { ElementNode } from '../../core/types';
+export declare function setQrCodeContent(node: ElementNode, key: 'level' | 'value', value: unknown): Partial<ElementNode>;
+export declare function getQrCodeFeedback(node: ElementNode, previousNode?: ElementNode): {
+    error?: string;
+    help: string;
+    info?: string;
+};

package/elements/shared/rect-style.d.ts

@@ -0,0 +1,6 @@
+import { ShapeProps } from './shape-props';
+export interface RectStyleProps extends ShapeProps {
+    radius?: number;
+}
+/** 描边位于边界内；scale 为每毫米对应的 CSS 长度单位数。 */
+export declare function rectStyle(props: RectStyleProps, scale: number, unit: 'mm' | 'px'): Record<string, string>;

package/elements/shared/shape-props.d.ts

@@ -0,0 +1,8 @@
+import { InspectorField, InspectorSection } from '../../core/types';
+export interface ShapeProps {
+    dash: string;
+    fill: string;
+    stroke: string;
+    strokeWidth: number;
+}
+export declare const shapeColorSections: (extra?: InspectorField[]) => InspectorSection[];

package/elements/shared/text-style.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 文本样式构建：设计器预览与 HTML 解析器共用。
+ *
+ * pxPerMm 决定换算比例：设计画布缩放时传入当前值（PX_PER_MM * zoom），
+ * HTML 输出使用默认值（CSS 的 mm / pt 本身就是物理单位，浏览器打印时
+ * 自动对应真实尺寸）。
+ */
+export interface TextProps {
+    autoHeight: boolean;
+    background: string;
+    color: string;
+    fontFamily: string;
+    fontSize: number;
+    fontStyle: string;
+    fontWeight: string;
+    letterSpacing: number;
+    lineHeight: number;
+    padding: number;
+    text: string;
+    textAlign: 'center' | 'justify' | 'left' | 'right';
+    textDecoration: 'line-through' | 'none' | 'underline';
+    verticalAlign: 'bottom' | 'middle' | 'top';
+}
+export declare function buildTextStyle(props: TextProps, pxPerMm?: number): Record<string, string>;
+/**
+ * 测量文本自然高度（mm），用于 autoHeight：编辑提交后把元素高度
+ * 调整为内容的实际渲染高度，HTML / PDF 端无需再关心自适应。
+ */
+export declare function measureTextHeightMm(text: string, props: TextProps, widthMm: number, pxPerMm?: number): number;

package/elements/table/table-cell-style.d.ts

@@ -0,0 +1,14 @@
+import { TableLayoutCell } from './table-layout';
+import { TableHAlign, TableProps, TableVAlign } from './table-style';
+export interface ResolvedTableCellStyle {
+    align: TableHAlign;
+    background: string;
+    bold: boolean;
+    color: string;
+    fontFamily: string;
+    fontSizePt: number;
+    paddingMm: number;
+    vAlign: TableVAlign;
+    wrap: boolean;
+}
+export declare function resolveTableCellStyle(props: TableProps, cell: TableLayoutCell): ResolvedTableCellStyle;

package/elements/table/table-continuation.d.ts

@@ -0,0 +1,6 @@
+import { ElementNode, PrintDocument } from '../../core/types';
+export declare const CONTINUATION_PRESENTATION_KEYS: ReadonlySet<string>;
+export declare function updateTableContinuationPresentation(props: Record<string, unknown>, fieldKey: string, nextProps: Record<string, unknown>): Record<string, unknown>;
+/** 清单继承内容和结构，仅保存显式调整过的呈现设置。 */
+export declare function resolveTableContinuation(source: ElementNode, target: ElementNode): ElementNode;
+export declare function reconcileTableContinuation(document: PrintDocument, node: ElementNode): void;

package/elements/table/table-html.d.ts

@@ -0,0 +1,8 @@
+import { TableLayout, TableLayoutOptions } from './table-layout';
+import { TableProps } from './table-style';
+/**
+ * 渲染表格 HTML：外层裁剪容器保证表格永不溢出定界框
+ * （auto 高度禁止跨页时的裁剪、fixed 压缩模式的兜底都依赖它）。
+ * 打印输出与画布预览共用，缩放经 pxPerMm 换算。
+ */
+export declare function renderTableLayoutHtml(props: TableProps, options: TableLayoutOptions, layout: TableLayout, pxPerMm?: number): string;

package/elements/table/table-layout.d.ts

@@ -0,0 +1,81 @@
+import { TableBorderStyle, TableCellMerge, TableCellOverride, TableColumn, TableProps } from './table-style';
+/**
+ * 解析各列实际宽度（mm）：fixed 直接取值、percent 按元素宽度换算、
+ * weight 分摊剩余宽度；min/max 钳制对所有模式生效。
+ */
+export declare function resolveColumnWidthsMm(props: TableProps, elementWidthMm: number): number[];
+export interface TableMergeSpan {
+    colspan: number;
+    rowspan: number;
+}
+export interface TableMergeMap {
+    /** 被合并覆盖的非锚点单元格 key（`row:col`） */
+    covered: Set<string>;
+    /** 锚点 key → 跨度 */
+    spans: Map<string, TableMergeSpan>;
+}
+export declare function mergeKey(row: number, col: number): string;
+/**
+ * 合并地图由统一规则求值结果生成。
+ */
+export declare function computeMergeMap(columns: TableColumn[], rows: string[][], merges: TableCellMerge[] | undefined): TableMergeMap;
+/** 单元格文本：空值回退（列级 nullText → 表级 nullText → 空串）+ 列格式化 */
+export declare function resolveCellText(value: unknown, column: TableColumn | undefined, props: TableProps): string;
+/** 汇总行各列文本：sum 求数值和 / text 自定义文本；无任何配置时首列显示"合计" */
+export declare function resolveSummaryValues(props: TableProps, rows: string[][]): string[];
+export interface TableEdgeSet {
+    bottom: null | TableBorderStyle;
+    left: null | TableBorderStyle;
+    right: null | TableBorderStyle;
+    top: null | TableBorderStyle;
+}
+export type TableRowKind = 'body' | 'header' | 'summary';
+export interface TableLayoutCell {
+    col: number;
+    colSpan: number;
+    column: TableColumn;
+    edges: TableEdgeSet;
+    kind: TableRowKind;
+    override?: TableCellOverride;
+    row: number;
+    rowSpan: number;
+    /** body 行的源数据行索引（斑马纹 / cellOverrides key）；其余为 -1 */
+    sourceRowIndex: number;
+    text: string;
+}
+export interface TableLayoutRow {
+    cells: TableLayoutCell[];
+    heightMm: number;
+    kind: TableRowKind;
+    /** body 行对应的源数据行索引（斑马纹 / cellOverrides key）；其余为 -1 */
+    sourceRowIndex: number;
+}
+export interface TableLayout {
+    colWidthsMm: number[];
+    heightMm: number;
+    rows: TableLayoutRow[];
+    widthMm: number;
+}
+export interface TableLayoutOptions {
+    elementHeightMm: number;
+    elementWidthMm: number;
+    /** 覆盖数据行（分页块）；缺省用 props.rows */
+    rows?: string[][];
+    showHeader?: boolean;
+    showSummary?: boolean;
+}
+/** 构建完整表格网格布局：行序 = [表头][汇总(顶部)][数据…][汇总(底部)] */
+export declare function buildTableLayout(props: TableProps, options: TableLayoutOptions): TableLayout;
+export interface TableChunk {
+    heightMm: number;
+    rows: string[][];
+    showHeader: boolean;
+    showSummary: boolean;
+    startRow: number;
+}
+/**
+ * 按可用页高切块：仅 auto 高度 + 允许跨页时生效，否则返回 null（整表单块）。
+ * rowsPerPage 优先于高度推算容量（固定行数 / 指定行后分页）；
+ * 空白补行把每块补齐到固定行数；汇总行按 scope 挂载。
+ */
+export declare function splitTableChunks(props: TableProps, availableHeightMm: number, continuationHeightMm?: number, getAvailableHeight?: (chunkIndex: number) => number, elementWidthMm?: number): null | TableChunk[];

package/elements/table/table-merges.d.ts

@@ -0,0 +1,3 @@
+import { TableCellMerge, TableProps } from './table-style';
+export declare function resolveTableMerges(props: TableProps): TableCellMerge[];
+export declare function sliceTableMerges(merges: TableCellMerge[], start: number, count: number): TableCellMerge[];

package/elements/table/table-overflow.d.ts

@@ -0,0 +1,2 @@
+import { ElementOverflowContext, ElementOverflowResult } from '../../core/element-registry';
+export declare function resolveTableOverflow({ node, page, warnings, }: ElementOverflowContext): ElementOverflowResult | null;

package/elements/table/table-pdf-render.d.ts

@@ -0,0 +1,3 @@
+import { PdfElementContext } from '../../core/element-registry';
+import { TableProps } from './table-style';
+export declare function renderTablePdf(ctx: PdfElementContext, props: TableProps): void;

package/elements/table/table-preview.d.ts

@@ -0,0 +1,3 @@
+import { TableProps } from './table-style';
+/** 画布只展示静态样式结构，不使用数据、空值占位或运行时派生内容。 */
+export declare function createTablePreviewProps(props: TableProps): TableProps;

package/elements/table/table-render.d.ts

@@ -0,0 +1,3 @@
+import { TableLayoutOptions } from './table-layout';
+import { TableProps } from './table-style';
+export declare function renderTableHtml(props: TableProps, options: TableLayoutOptions, pxPerMm?: number): string;

package/elements/table/table-structure.d.ts

@@ -0,0 +1,13 @@
+import { TableCellMerge, TableColumn, TableProps } from './table-style';
+export declare function tableHeaderRows(props: TableProps): string[][];
+export declare function changeTableHeaderMode(props: TableProps, custom: boolean): Partial<TableProps>;
+export declare function remapTableMerges(merges: TableCellMerge[], order: number[]): null | TableCellMerge[];
+export declare function reindexTableColumns(props: TableProps, order: number[], insertedColumn?: TableColumn): null | TableProps;
+export declare function tableHeaderSelection(start: {
+    col: number;
+    row: number;
+}, end: {
+    col: number;
+    row: number;
+}, merges: TableCellMerge[]): TableCellMerge;
+export declare function resizeTableColumnPair(columns: TableColumn[], widths: number[], index: number, deltaMm: number): TableColumn[];

package/elements/table/table-style.d.ts

@@ -0,0 +1,219 @@
+/**
+ * 表格数据模型与样式求值：类型、默认值、旧文档归一化、行高公式。
+ * 纯函数，不依赖 Vue / DOM；画布预览、HTML / PDF 解析器共用。
+ *
+ * 三级样式优先级：单元格样式（cellOverrides / 汇总行样式）> 列样式 > 表格默认样式。
+ */
+export type TableHAlign = 'center' | 'left' | 'right';
+export type TableVAlign = 'bottom' | 'middle' | 'top';
+export type TableLineStyle = 'dashed' | 'dotted' | 'solid';
+export type TableWidthMode = 'fixed' | 'percent' | 'weight';
+export type TableCellFormatType = 'currency' | 'date' | 'lower' | 'none' | 'number' | 'thousand' | 'upper';
+export interface TableBorderStyle {
+    color: string;
+    style: TableLineStyle;
+    width: number;
+}
+/**
+ * 边框模型：mode 决定内部分隔线画哪些（外框始终由 outer/四边覆盖决定）。
+ * headerBottom 用于表头底部独立加粗线（单据场景）。
+ */
+export interface TableBorders {
+    bottom?: TableBorderStyle;
+    headerBottom?: TableBorderStyle;
+    inner: TableBorderStyle;
+    left?: TableBorderStyle;
+    mode: 'all' | 'horizontal' | 'none' | 'outer' | 'vertical';
+    outer: TableBorderStyle;
+    right?: TableBorderStyle;
+    top?: TableBorderStyle;
+}
+export interface TableCellFormat {
+    /** number/thousand/currency 的小数位；date 的 pattern 用 pattern 字段 */
+    digits?: number;
+    /** date 格式化模式，如 yyyy-MM-dd、HH:mm */
+    pattern?: string;
+    type: TableCellFormatType;
+}
+/** 单元格级样式覆盖（第三级优先级）：静态默认数据单元格与汇总行 */
+export interface TableCellOverride {
+    align?: TableHAlign;
+    background?: string;
+    bold?: boolean;
+    color?: string;
+    fontFamily?: string;
+    fontSize?: number;
+    paddingMm?: number;
+    vAlign?: TableVAlign;
+    wrap?: boolean;
+}
+export interface TableColumn {
+    align: TableHAlign;
+    /** 列级背景（覆盖表格默认，被单元格覆盖） */
+    background?: string;
+    /** 数据绑定字段（相对绑定数组的当前元素，如 name）；行绑定未启用时忽略 */
+    bind?: string;
+    bold?: boolean;
+    color?: string;
+    fontSize?: number;
+    /** 单元格内容格式化（金额 / 日期 / 数字…） */
+    format?: TableCellFormat;
+    maxWidthMm?: number;
+    /** 纵向动态合并：相邻行取值相同时按列合并单元格 */
+    mergeSame?: boolean;
+    minWidthMm?: number;
+    /** 空值处理：该列取值为空时的替代文本；缺省回退表级 nullText */
+    nullText?: string;
+    title: string;
+    vAlign?: TableVAlign;
+    /** 宽度值：weight 权重 / percent 百分比 / fixed 毫米，由 widthMode 决定 */
+    width: number;
+    widthMode?: TableWidthMode;
+    /** 自动换行；false 时单行显示、超出裁剪 */
+    wrap?: boolean;
+}
+/** 静态手动合并（默认数据行）：锚点 + 跨度 */
+export interface TableCellMerge {
+    col: number;
+    colspan: number;
+    row: number;
+    rowspan: number;
+}
+export interface TableMergeRule {
+    columns: number[];
+    fields?: string[];
+    type: 'fields';
+}
+/** 汇总行（合计行）：列级配置 sum 求和 / text 自定义文本 */
+export interface TableSummary {
+    borders?: TableBorders;
+    /** key 为列索引字符串 */
+    columns: Record<string, {
+        style?: TableCellOverride;
+        text?: string;
+        type: 'none' | 'sum' | 'text';
+    }>;
+    enabled: boolean;
+    position: 'bottom' | 'top';
+    /** eachPage：每页都显示（当页小计）；lastPage：仅最后一页（全量合计） */
+    scope: 'eachPage' | 'lastPage';
+    style?: TableCellOverride;
+    /**
+     * 已求值的各列文本（按列序）。运行时派生：跨页切块时由 paginate 写入
+     * （lastPage 全量合计 / eachPage 当页小计），normalizeTableProps 会丢弃。
+     */
+    values?: string[];
+}
+export interface TableOverflow {
+    elementId: string;
+    enabled: boolean;
+    message: string;
+    messageAlign?: '' | TableHAlign;
+    messageVAlign?: '' | TableVAlign;
+    scope: 'all' | 'remaining';
+    templateId: string;
+    threshold: number;
+}
+export interface TablePagination {
+    /** 跨页策略：false 时超出部分裁剪不跨页 */
+    crossPage: boolean;
+    /** 空白补行：数据不足时补空行到每页固定行数（出库单 / 送货单场景） */
+    fillEmptyRows: boolean;
+    fixedRows?: boolean;
+    positionMode?: 'fixed' | 'flow';
+    /** 跨页时下一页重复表头 */
+    repeatHeader: boolean;
+    /** 固定模式下的每页行数；兼作空白补行的补齐目标。 */
+    rowsPerPage: number;
+}
+export interface TableProps {
+    background: string;
+    /** 旧版整表边框：仅作旧文档迁移源，normalizeTableProps 后迁移进 borders */
+    borderColor?: string;
+    borders: TableBorders;
+    borderWidth?: number;
+    /**
+     * 设计态定界框高度（mm），由绑定解析阶段写入。输出态 measureSize 会把节点高度
+     * 改写为内容自然高度，分页 / 超限判断需以定界框作为单页可用空间上限。
+     */
+    boxHeightMm?: number;
+    /**
+     * 单元格样式覆盖（第三级优先级）：key 为静态默认数据行的 `${row}:${col}`。
+     * 绑定数据后行是动态的，覆盖仅对静态行有意义；本版本不提供自由编辑 UI。
+     */
+    cellOverrides?: Record<string, TableCellOverride>;
+    color: string;
+    columns: TableColumn[];
+    fontFamily: string;
+    fontSize: number;
+    /** 表头整体水平对齐；'' 或缺省时跟随各列 align */
+    headerAlign?: '' | TableHAlign;
+    headerBackground: string;
+    headerBold?: boolean;
+    headerBorders?: TableBorders;
+    headerColor: string;
+    headerFontFamily?: string;
+    headerFontSize?: number;
+    headerHeightMm?: number;
+    headerHeightMode?: 'auto' | 'fixed';
+    headerMerges?: TableCellMerge[];
+    headerPaddingMm?: number;
+    headerRows?: string[][];
+    headerVAlign?: TableVAlign;
+    headerVisible: boolean;
+    headerWrap?: boolean;
+    /** 运行时布局约束：仅由指定表体行吸收最小总高度的剩余空间。 */
+    heightFill?: {
+        bodyRow: number;
+        minHeightMm: number;
+    };
+    /** 表格高度：auto 按自然行高（支持跨页）；fixed 压缩行高填满定界框 */
+    heightMode: 'auto' | 'fixed';
+    mergeRules?: TableMergeRule[];
+    merges?: TableCellMerge[];
+    /** 最小行高下限（mm），仅 auto 模式参与行高计算 */
+    minRowHeightMm?: number;
+    /** 表级空值默认文本；列级 nullText 优先 */
+    nullText?: string;
+    overflow: TableOverflow;
+    /** 单元格内边距（mm） */
+    padding: number;
+    pagination: TablePagination;
+    resolvedMerges?: TableCellMerge[];
+    rowOffset?: number;
+    rows: string[][];
+    sourceRows?: unknown[];
+    stripe: boolean;
+    stripeColor: string;
+    summary: TableSummary;
+}
+/** 单元格行高倍数：预览与 PDF 输出一致，行最小高度据此可确定计算 */
+export declare const TABLE_LINE_HEIGHT = 1.25;
+export declare function defaultTableBorderStyle(color?: string, width?: number): TableBorderStyle;
+export declare function defaultTableBorders(color?: string, width?: number): TableBorders;
+export declare function defaultTableSummary(): TableSummary;
+export declare function defaultTablePagination(): TablePagination;
+/** 构造带派生值的汇总配置（跨页切块时使用，values 不落文档模型） */
+export declare function withSummaryValues(summary: TableSummary, values: string[]): TableSummary;
+export declare function normalizeTableMergeRules(raw: unknown): TableMergeRule[];
+/**
+ * 表格属性归一化：旧文档（无 borders/summary/pagination 等新键）补默认值，
+ * 旧 borderColor/borderWidth 迁移为边框模型。幂等，加载与渲染前均可调用。
+ * 旧文档 heightMode 缺省为 fixed（保持旧版压缩行高观感），新建元素默认 auto。
+ */
+export declare function normalizeTableProps(raw: Record<string, unknown>): Record<string, unknown>;
+/** 生效边框宽度（mm）：新边框模型的内线宽度，兼容旧 borderWidth 字段 */
+export declare function borderWidthOf(props: TableProps): number;
+/** 浏览器可见边框至少占 1 CSS px，高度计算不能只使用亚像素毫米线宽。 */
+export declare function resolveTableBorderHeightMm(props: TableProps): number;
+/** 表体自然行高（mm）：字号 × 行高倍数 + 上下内边距 + 单行边框，不小于最小行高 */
+export declare function resolveRowHeightMm(props: TableProps): number;
+/** 表头高度（mm）：固定模式用 headerHeightMm，否则按表头字号/内边距的自然行高 */
+export declare function resolveHeaderHeightMm(props: TableProps): number;
+export declare function resolveSummaryHeightMm(props: TableProps): number;
+/** 表格自然总高度（mm）：表头 + 数据行 + 汇总行 + 折叠外框两端的半条边框 */
+export declare function resolveTableNaturalHeightMm(props: TableProps, rowCount: number): number;
+/** 边框线型 → PDF dash 模式（mm） */
+export declare function lineDashPatternMm(style: TableLineStyle): number[];
+/** 颜色是否可见（非透明）：边框 / 背景绘制前的统一判断 */
+export declare function isVisibleColor(value: unknown): boolean;