@printstack/print-studio 0.0.0-stage → 0.1.0

package/designer/components/dialogs/use-preview-viewport.d.ts

@@ -0,0 +1,37 @@
+import { Ref } from 'vue';
+interface PreviewPage {
+    height: number;
+    thumbnail: string;
+    width: number;
+}
+export declare function usePreviewViewport(frame: Ref<HTMLIFrameElement | null>): {
+    activePage: import('vue').ComputedRef<{
+        height: number;
+        thumbnail: string;
+        width: number;
+    }>;
+    currentPage: Ref<number, number>;
+    fitMode: Ref<"page" | "width" | "manual", "page" | "width" | "manual">;
+    layout: Ref<"single" | "continuous", "single" | "continuous">;
+    onFrameLoad: () => void;
+    pages: Ref<{
+        height: number;
+        thumbnail: string;
+        width: number;
+    }[], PreviewPage[] | {
+        height: number;
+        thumbnail: string;
+        width: number;
+    }[]>;
+    ready: Ref<boolean, boolean>;
+    reset: () => void;
+    selectPage: (value: number) => void;
+    setFitMode: (value: "page" | "width") => void;
+    setLayout: (value: "continuous" | "single") => void;
+    setZoom: (value: number, anchor?: {
+        x: number;
+        y: number;
+    }) => void;
+    zoom: Ref<number, number>;
+};
+export {};

package/designer/components/dialogs/use-template-catalog.d.ts

@@ -0,0 +1,51 @@
+import { EditorContext } from '../../context/editor-context';
+import { TemplateLibraryCatalog } from '../../template-library/types';
+/**
+ * 模板库目录加载：聚合所有来源，单个来源失败不影响其他来源。
+ * generation 守卫防止对话框关闭 / 重开后的过期响应覆盖新状态；
+ * 失败经 ctx.errors 统一上报，同时在目录中保留内联展示并支持重试。
+ */
+export declare function useTemplateCatalog(ctx: EditorContext): {
+    catalog: import('vue').Ref<{
+        failures: {
+            error: unknown;
+            providerId: string;
+            title: string;
+        }[];
+        sections: {
+            entries: {
+                category?: string | undefined;
+                description?: string | undefined;
+                id: string;
+                load: () => import('../../..').PrintDocument | Promise<import('../../..').PrintDocument>;
+                name: string;
+                remove?: (() => Promise<void>) | undefined;
+                update?: ((document: import('../../..').PrintDocument) => Promise<void>) | undefined;
+            }[];
+            providerId: string;
+            title: string;
+        }[];
+    }, TemplateLibraryCatalog | {
+        failures: {
+            error: unknown;
+            providerId: string;
+            title: string;
+        }[];
+        sections: {
+            entries: {
+                category?: string | undefined;
+                description?: string | undefined;
+                id: string;
+                load: () => import('../../..').PrintDocument | Promise<import('../../..').PrintDocument>;
+                name: string;
+                remove?: (() => Promise<void>) | undefined;
+                update?: ((document: import('../../..').PrintDocument) => Promise<void>) | undefined;
+            }[];
+            providerId: string;
+            title: string;
+        }[];
+    }>;
+    invalidate: () => void;
+    load: () => Promise<void>;
+    loading: import('vue').Ref<boolean, boolean>;
+};

package/designer/components/dialogs/use-template-preview.d.ts

@@ -0,0 +1,35 @@
+import { PrintDocument } from '../../../core/types';
+import { EditorContext } from '../../context/editor-context';
+import { TemplateLibraryEntry } from '../../template-library/types';
+/**
+ * 模板库预览：选中条目后按需加载文档并渲染示例数据预览。
+ * 文档按条目缓存（WeakMap），同一来源刷新后自然失效；
+ * 复用预览渲染器（竞态守卫 / 中止 / 错误上报）与预览视口（fit 缩放、页面提取）。
+ */
+export declare function useTemplatePreview(ctx: EditorContext): {
+    currentPage: import('vue').Ref<number, number>;
+    fitMode: import('vue').Ref<"page" | "width" | "manual", "page" | "width" | "manual">;
+    frameRef: import('vue').Ref<HTMLIFrameElement | null, HTMLIFrameElement | null>;
+    loadedDocument: import('vue').Ref<PrintDocument | undefined, PrintDocument | undefined>;
+    loading: import('vue').Ref<boolean, boolean>;
+    pageCount: import('vue').ComputedRef<number>;
+    ready: import('vue').Ref<boolean, boolean>;
+    renderError: import('vue').Ref<{
+        detail: string;
+    } | null, {
+        detail: string;
+    } | {
+        detail: string;
+    } | null>;
+    reset: () => void;
+    retry: () => void;
+    select: (entry: TemplateLibraryEntry) => void;
+    selectedEntry: import('vue').Ref<TemplateLibraryEntry | undefined, TemplateLibraryEntry | undefined>;
+    selectPage: (value: number) => void;
+    setFitMode: (value: "page" | "width") => void;
+    setZoom: (value: number, anchor?: {
+        x: number;
+        y: number;
+    }) => void;
+    zoom: import('vue').Ref<number, number>;
+};

package/designer/components/fields/field-boolean.vue.d.ts

@@ -0,0 +1,20 @@
+type __VLS_Props = {
+    disabled?: boolean;
+    mixed?: boolean;
+    readonly?: boolean;
+};
+type __VLS_ModelProps = {
+    modelValue?: boolean;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    blur: (event: FocusEvent) => any;
+    commit: () => any;
+    "update:modelValue": (value: boolean | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onCommit?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-color.vue.d.ts

@@ -0,0 +1,20 @@
+type __VLS_Props = {
+    allowNone?: boolean;
+    mixed?: boolean;
+    resetValue?: string;
+};
+type __VLS_ModelProps = {
+    modelValue?: string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    commit: () => any;
+    "update:modelValue": (value: string | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onCommit?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+}>, {
+    resetValue: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-data-preview.vue.d.ts

@@ -0,0 +1,12 @@
+import { ElementNode } from '../../../core/types';
+type __VLS_Props = {
+    /** 节点数据绑定：bindings.rows 为行数据数组路径 */
+    bindings?: Record<string, string>;
+    columns?: unknown;
+    /** 兼容 s-form 的 value 绑定（本控件只读，不回写） */
+    modelValue?: unknown;
+    node?: ElementNode;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-image.vue.d.ts

@@ -0,0 +1,14 @@
+type __VLS_ModelProps = {
+    modelValue?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    blur: (value: unknown) => any;
+    commit: () => any;
+    "update:modelValue": (value: string | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    onBlur?: ((value: unknown) => any) | undefined;
+    onCommit?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-table-borders.vue.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 表格边框组合控件：full 模式编辑整个 TableBorders（模式 + 外框 + 内线 +
+ * 四边独立覆盖）；sideMode 模式编辑单个 TableBorderStyle（如表头底部边框）。
+ */
+type __VLS_Props = {
+    inheritable?: boolean;
+    /** 单边模式：只编辑一个 TableBorderStyle 对象 */
+    sideMode?: string;
+};
+type __VLS_ModelProps = {
+    modelValue?: unknown;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    commit: () => any;
+    "update:modelValue": (value: unknown) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onCommit?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-table-cell-style.vue.d.ts

@@ -0,0 +1,13 @@
+import { TableCellOverride } from '../../../elements/table/table-style';
+type __VLS_ModelProps = {
+    modelValue?: TableCellOverride;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_ModelProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    commit: () => any;
+    "update:modelValue": (value: TableCellOverride | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_ModelProps> & Readonly<{
+    onCommit?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: TableCellOverride | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-table-continuation-layout.vue.d.ts

@@ -0,0 +1,14 @@
+import { ElementNode } from '../../../core/types';
+import { TableOverflow } from '../../../elements/table/table-style';
+type __VLS_Props = {
+    modelValue?: TableOverflow;
+    node: ElementNode;
+    onCommit?: () => void;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:modelValue": (value: TableOverflow) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:modelValue"?: ((value: TableOverflow) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-table-merge-rules.vue.d.ts

@@ -0,0 +1,13 @@
+type __VLS_Props = {
+    bindings?: Record<string, string>;
+    propsObject: Record<string, unknown>;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    commit: () => any;
+    "update:propsObject": (value: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCommit?: (() => any) | undefined;
+    "onUpdate:propsObject"?: ((value: Record<string, unknown>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-table-rows.vue.d.ts

@@ -0,0 +1,13 @@
+type __VLS_Props = {
+    propsObject: Record<string, unknown>;
+    rowsBinding?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    commit: () => any;
+    "update:propsObject": (value: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCommit?: (() => any) | undefined;
+    "onUpdate:propsObject"?: ((value: Record<string, unknown>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-table-structure.vue.d.ts

@@ -0,0 +1,19 @@
+import { ElementNode } from '../../../core/types';
+type __VLS_Props = {
+    bindings?: Record<string, string>;
+    node?: ElementNode;
+    widthOnly?: boolean;
+};
+type __VLS_ModelProps = {
+    modelValue: Record<string, unknown>;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    commit: () => any;
+    "update:modelValue": (value: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onCommit?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: Record<string, unknown>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/field-table.vue.d.ts

@@ -0,0 +1,21 @@
+type __VLS_Props = {
+    /** 节点数据绑定：bindings.rows 为行数据数组路径，列绑定字段相对其解析 */
+    bindings?: Record<string, string>;
+    columnIndex?: number;
+    embedded?: boolean;
+    expanded?: boolean;
+    /** 只读输入，编辑副本经 update:propsObject 提交 */
+    propsObject: Record<string, unknown>;
+    showMergeRules?: boolean;
+    tableMode: 'columns' | 'headers' | 'rows' | 'summary';
+    widthOnly?: boolean;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    commit: () => any;
+    "update:propsObject": (value: Record<string, unknown>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCommit?: (() => any) | undefined;
+    "onUpdate:propsObject"?: ((value: Record<string, unknown>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/fields/use-table-cells.d.ts

@@ -0,0 +1,38 @@
+import { Ref } from 'vue';
+import { TableCellMerge } from '../../../elements/table/table-style';
+export declare function useTableCells(options: {
+    columnCount: Ref<number>;
+    commit: () => void;
+    merges: Ref<TableCellMerge[]>;
+    rows: Ref<string[][]>;
+}): {
+    addNewRow: () => void;
+    canCancelMerge: import('vue').ComputedRef<boolean>;
+    cancelMerge: () => void;
+    canMergeSelection: import('vue').ComputedRef<boolean>;
+    coveredCells: import('vue').ComputedRef<Set<string>>;
+    mergedCellTitle: (row: number, col: number) => string | undefined;
+    mergeSelection: () => void;
+    removeRowEntry: (index: number) => void;
+    selectedCell: import('vue').ComputedRef<{
+        col: number;
+        row: number;
+    } | null>;
+    sheetCellStyle: (row: number, col: number) => Record<string, string>;
+    begin: (event: PointerEvent, row: number, col: number) => void;
+    clear: () => void;
+    contains: (row: number, col: number) => boolean;
+    end: Ref<{
+        col: number;
+        row: number;
+    } | null, {
+        col: number;
+        row: number;
+    } | {
+        col: number;
+        row: number;
+    } | null>;
+    focus: (row: number, col: number) => void;
+    select: (row: number, col: number, extend?: boolean) => void;
+    selection: import('vue').ComputedRef<TableCellMerge | null>;
+};

package/designer/components/fields/use-table-column-resize.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+import { TableProps } from '../../../elements/table/table-style';
+export declare function useTableColumnResize(options: {
+    commit: () => void;
+    onColumnSelect: (index: number) => void;
+    table: Ref<TableProps>;
+    widths: Ref<number[]>;
+    write: (patch: Record<string, unknown>) => void;
+}): {
+    resizeColumn: (event: PointerEvent, index: number) => void;
+};

package/designer/components/fields/use-table-columns.d.ts

@@ -0,0 +1,19 @@
+import { TableColumn, TableProps } from '../../../elements/table/table-style';
+interface TableColumnEditingOptions {
+    createColumn: (number: number) => TableColumn;
+    getProps: () => TableProps;
+    onBlocked: () => void;
+    write: (value: TableProps) => void;
+}
+export declare function useTableColumns(options: TableColumnEditingOptions): {
+    addColumn: () => boolean;
+    dragColumnIndex: import('vue').Ref<number | null, number | null>;
+    dragOverColumnIndex: import('vue').Ref<number | null, number | null>;
+    moveColumn: (from: number, to: number) => boolean;
+    onColumnDragEnd: () => void;
+    onColumnDragOver: (event: DragEvent, index: number) => void;
+    onColumnDragStart: (index: number) => void;
+    onColumnDrop: (index: number) => void;
+    removeColumn: (index: number) => boolean;
+};
+export {};