@bluechaine/print-designer 0.1.0

package/dist/types/src/components/panels/PropertiesPanel.vue.d.ts

@@ -0,0 +1,225 @@
+declare const _default: import("vue").DefineComponent<{}, {
+    t: (key: string, fallback?: string) => string;
+    SETTING_CONTAINER_ID: string;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {
+    DragBox: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+        title: {
+            type: StringConstructor;
+            default: string;
+        };
+        storageKey: {
+            type: StringConstructor;
+            default: string;
+        };
+        layoutKey: {
+            type: import("vue").PropType<import("../../constants/panel-layout.js").SvpPanelLayoutKey>;
+            default: string;
+        };
+        styleOptionKey: {
+            type: StringConstructor;
+            default: string;
+        };
+        panelKey: {
+            type: import("vue").PropType<keyof import("../../core/stores").PanelVisibility>;
+            default: string;
+        };
+        defaultX: {
+            type: NumberConstructor;
+            default: number;
+        };
+        defaultY: {
+            type: NumberConstructor;
+            default: number;
+        };
+        width: {
+            type: NumberConstructor;
+            default: number;
+        };
+        height: {
+            type: NumberConstructor;
+            default: number;
+        };
+        visible: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        folded: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        foldable: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        closable: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        bodyPadding: {
+            type: StringConstructor;
+            default: string;
+        };
+        boundsSelector: {
+            type: StringConstructor;
+            default: string;
+        };
+        bodyStyleExtra: {
+            type: import("vue").PropType<Record<string, string>>;
+            default: () => {};
+        };
+    }>, {
+        boxRef: import("vue").Ref<HTMLElement | null, HTMLElement | null>;
+        state: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+            folded: boolean;
+            visible: boolean;
+        };
+        show: import("vue").ComputedRef<boolean>;
+        showFold: import("vue").ComputedRef<boolean>;
+        showClose: import("vue").ComputedRef<boolean>;
+        toggleFolded: () => void;
+        boxStyle: import("vue").ComputedRef<{
+            left: string;
+            top: string;
+            width: string;
+            height: string;
+        }>;
+        bodyStyle: import("vue").ComputedRef<{
+            padding: string | undefined;
+        }>;
+        onClose: () => void;
+        resolvedTitle: import("vue").ComputedRef<string>;
+        draggable: import("vue").ComputedRef<boolean>;
+        t: (key: string, fallback?: string) => string;
+        UI_ICONS: {
+            readonly save: "lucide:save";
+            readonly preview: "lucide:eye";
+            readonly editTemplate: "lucide:file-json-2";
+            readonly editPrintData: "lucide:database";
+            readonly exportFile: "lucide:download";
+            readonly importFile: "lucide:upload";
+            readonly chevronDown: "lucide:chevron-down";
+            readonly close: "lucide:x";
+        };
+    }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("close" | "update:visible")[], "close" | "update:visible", import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+        title: {
+            type: StringConstructor;
+            default: string;
+        };
+        storageKey: {
+            type: StringConstructor;
+            default: string;
+        };
+        layoutKey: {
+            type: import("vue").PropType<import("../../constants/panel-layout.js").SvpPanelLayoutKey>;
+            default: string;
+        };
+        styleOptionKey: {
+            type: StringConstructor;
+            default: string;
+        };
+        panelKey: {
+            type: import("vue").PropType<keyof import("../../core/stores").PanelVisibility>;
+            default: string;
+        };
+        defaultX: {
+            type: NumberConstructor;
+            default: number;
+        };
+        defaultY: {
+            type: NumberConstructor;
+            default: number;
+        };
+        width: {
+            type: NumberConstructor;
+            default: number;
+        };
+        height: {
+            type: NumberConstructor;
+            default: number;
+        };
+        visible: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        folded: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        foldable: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        closable: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
+        bodyPadding: {
+            type: StringConstructor;
+            default: string;
+        };
+        boundsSelector: {
+            type: StringConstructor;
+            default: string;
+        };
+        bodyStyleExtra: {
+            type: import("vue").PropType<Record<string, string>>;
+            default: () => {};
+        };
+    }>> & Readonly<{
+        onClose?: ((...args: any[]) => any) | undefined;
+        "onUpdate:visible"?: ((...args: any[]) => any) | undefined;
+    }>, {
+        title: string;
+        width: number;
+        height: number;
+        panelKey: keyof import("../../core/stores").PanelVisibility;
+        visible: boolean;
+        folded: boolean;
+        storageKey: string;
+        layoutKey: "draggableEls" | "miniMap" | "pageStructure" | "pageHistory" | "properties";
+        styleOptionKey: string;
+        defaultX: number;
+        defaultY: number;
+        foldable: boolean;
+        closable: boolean;
+        bodyPadding: string;
+        boundsSelector: string;
+        bodyStyleExtra: Record<string, string>;
+    }, {}, {
+        SvpIcon: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+            icon: {
+                type: StringConstructor;
+                required: true;
+            };
+            size: {
+                type: (StringConstructor | NumberConstructor)[];
+                default: number;
+            };
+        }>, {
+            isSvg: import("vue").ComputedRef<boolean>;
+            sizePx: import("vue").ComputedRef<number>;
+            wrapStyle: import("vue").ComputedRef<{
+                width: string;
+                height: string;
+            }>;
+        }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+            icon: {
+                type: StringConstructor;
+                required: true;
+            };
+            size: {
+                type: (StringConstructor | NumberConstructor)[];
+                default: number;
+            };
+        }>> & Readonly<{}>, {
+            size: string | number;
+        }, {}, {
+            Icon: import("vue").DefineSetupFnComponent<import("@iconify/vue").IconProps, {}, {}, import("@iconify/vue").IconProps, import("vue").PublicProps>;
+        }, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+    }, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/src/composables/useDesigner.d.ts

@@ -0,0 +1,9 @@
+import { type InjectionKey } from 'vue-demi';
+import DesignerUtils from '../core/designer-utils';
+export declare const DESIGNER_INJECTION_KEY: InjectionKey<DesignerUtils>;
+export declare function provideDesigner(utils: DesignerUtils): DesignerUtils;
+/**
+ * Get the current DesignerUtils from the Vue injection chain.
+ * Falls back to the global singleton when no provider is present.
+ */
+export declare function useDesigner(): DesignerUtils;

package/dist/types/src/composables/useDesignerUi.d.ts

@@ -0,0 +1,2 @@
+import { type DesignerUiContext } from '../core/designer-options';
+export declare function useDesignerUi(): DesignerUiContext | null;

package/dist/types/src/composables/useDragBox.d.ts

@@ -0,0 +1,41 @@
+import { type PanelLayoutSpec, type SvpPanelLayoutKey } from '../constants/panel-layout';
+export interface DragBoxState {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    folded: boolean;
+    visible: boolean;
+}
+export interface UseDragBoxOptions {
+    key?: string;
+    defaultX?: number;
+    defaultY?: number;
+    defaultWidth?: number;
+    defaultHeight?: number;
+    defaultFolded?: boolean;
+    defaultVisible?: boolean;
+    /** Apply sv-print default layout (recomputed on workspace resize). */
+    layoutKey?: SvpPanelLayoutKey;
+    /** Override or extend the sv-print layout spec. */
+    layoutSpec?: PanelLayoutSpec;
+    handleSelector?: string;
+    boundsSelector?: string;
+    /** When false the panel cannot be dragged. */
+    draggable?: boolean;
+}
+export declare function useDragBox(boxEl: () => HTMLElement | null, opts?: UseDragBoxOptions): {
+    state: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        folded: boolean;
+        visible: boolean;
+    };
+    toggleFolded: () => void;
+    setVisible: (v: boolean) => void;
+    persist: () => void;
+    applyLayout: (force?: boolean) => void;
+    dragging: () => boolean;
+};

package/dist/types/src/composables/useRuler.d.ts

@@ -0,0 +1,10 @@
+export interface UseRulerOptions {
+    canvasX: () => HTMLCanvasElement | null;
+    canvasY: () => HTMLCanvasElement | null;
+    scrollerEl: () => HTMLElement | null;
+    /** Workspace container — observed for vertical ruler height changes. */
+    workspaceEl?: () => HTMLElement | null;
+}
+export declare function useRuler(opts: UseRulerOptions): {
+    redraw: () => void;
+};

package/dist/types/src/constants/default-table-element.d.ts

@@ -0,0 +1,151 @@
+/** Table field list used when dragging a new table onto the canvas. */
+export declare const DEFAULT_TABLE_FIELDS: readonly [{
+    readonly text: "id";
+    readonly field: "id";
+}, {
+    readonly text: "姓名";
+    readonly field: "name";
+}, {
+    readonly text: "性别";
+    readonly field: "gender";
+}, {
+    readonly text: "数量";
+    readonly field: "count";
+}];
+/** Column layout from `template.json` — applied to `defaultModule.table`. */
+export declare const DEFAULT_TABLE_COLUMNS: readonly [readonly [{
+    readonly width: 102.30000000000001;
+    readonly checked: true;
+    readonly fixed: false;
+    readonly rowspan: 1;
+    readonly colspan: 1;
+}, {
+    readonly width: 102.30000000000001;
+    readonly title: "姓名";
+    readonly field: "name";
+    readonly checked: true;
+    readonly columnId: "name";
+    readonly fixed: false;
+    readonly rowspan: 1;
+    readonly colspan: 1;
+    readonly align: "center";
+    readonly tableSummary: "count";
+}, {
+    readonly width: 102.30000000000001;
+    readonly title: "数量";
+    readonly field: "count";
+    readonly checked: true;
+    readonly columnId: "count";
+    readonly fixed: false;
+    readonly rowspan: 1;
+    readonly colspan: 1;
+    readonly align: "center";
+    readonly tableSummary: "sum";
+}, {
+    readonly width: 102.30000000000001;
+    readonly checked: true;
+    readonly fixed: false;
+    readonly rowspan: 1;
+    readonly colspan: 1;
+}, {
+    readonly width: 102.30000000000001;
+    readonly checked: true;
+    readonly fixed: false;
+    readonly rowspan: 1;
+    readonly colspan: 1;
+}, {
+    readonly width: 85.25;
+    readonly title: "性别";
+    readonly field: "gender";
+    readonly checked: false;
+    readonly columnId: "gender";
+    readonly fixed: false;
+    readonly rowspan: 1;
+    readonly colspan: 1;
+}]];
+/** Overrides merged into hiprint `defaultModule.table` element type. */
+export declare const DEFAULT_TABLE_ELEMENT_TYPE: {
+    tid: string;
+    title: string;
+    type: string;
+    field: string;
+    tableFooterRepeat: string;
+    fields: ({
+        text: "id";
+        field: "id";
+    } | {
+        text: "姓名";
+        field: "name";
+    } | {
+        text: "性别";
+        field: "gender";
+    } | {
+        text: "数量";
+        field: "count";
+    })[];
+    columns: ({
+        width: 102.30000000000001;
+        checked: true;
+        fixed: false;
+        rowspan: 1;
+        colspan: 1;
+    } | {
+        width: 102.30000000000001;
+        title: "姓名";
+        field: "name";
+        checked: true;
+        columnId: "name";
+        fixed: false;
+        rowspan: 1;
+        colspan: 1;
+        align: "center";
+        tableSummary: "count";
+    } | {
+        width: 102.30000000000001;
+        title: "数量";
+        field: "count";
+        checked: true;
+        columnId: "count";
+        fixed: false;
+        rowspan: 1;
+        colspan: 1;
+        align: "center";
+        tableSummary: "sum";
+    } | {
+        width: 102.30000000000001;
+        checked: true;
+        fixed: false;
+        rowspan: 1;
+        colspan: 1;
+    } | {
+        width: 102.30000000000001;
+        checked: true;
+        fixed: false;
+        rowspan: 1;
+        colspan: 1;
+    } | {
+        width: 85.25;
+        title: "性别";
+        field: "gender";
+        checked: false;
+        columnId: "gender";
+        fixed: false;
+        rowspan: 1;
+        colspan: 1;
+    })[][];
+    editable: boolean;
+    columnDisplayEditable: boolean;
+    columnDisplayIndexEditable: boolean;
+    columnTitleEditable: boolean;
+    columnResizable: boolean;
+    columnAlignEditable: boolean;
+    isEnableEditField: boolean;
+    isEnableContextMenu: boolean;
+    isEnableInsertRow: boolean;
+    isEnableDeleteRow: boolean;
+    isEnableInsertColumn: boolean;
+    isEnableDeleteColumn: boolean;
+    isEnableMergeCell: boolean;
+    groupFields: string[];
+    groupFooterFormatter: undefined;
+};

package/dist/types/src/constants/header-elements.d.ts

@@ -0,0 +1,3 @@
+import { type ElementCatalogueItem } from '../constants';
+import type { HeaderEle } from '../types';
+export declare function headerElementsFromCatalogue(catalogue?: ElementCatalogueItem[]): HeaderEle[];

package/dist/types/src/constants/icons.d.ts

@@ -0,0 +1,61 @@
+/** Iconify icon ids (Lucide set). */
+export declare const ICON_DELETE = "lucide:trash-2";
+export declare const TOOL_ICONS: {
+    readonly undo: "lucide:undo-2";
+    readonly redo: "lucide:redo-2";
+    readonly alignLeft: "lucide:align-left";
+    readonly alignCenter: "lucide:align-center";
+    readonly alignRight: "lucide:align-right";
+    readonly alignTop: "lucide:align-start-vertical";
+    readonly alignMiddle: "lucide:align-center-vertical";
+    readonly alignBottom: "lucide:align-end-vertical";
+    readonly moveTop: "lucide:arrow-up-to-line";
+    readonly moveUp: "lucide:arrow-up";
+    readonly moveDown: "lucide:arrow-down";
+    readonly moveBottom: "lucide:arrow-down-to-line";
+    readonly flipH: "lucide:flip-horizontal";
+    readonly flipV: "lucide:flip-vertical";
+    readonly fontInc: "lucide:plus";
+    readonly fontDec: "lucide:minus";
+    readonly fontBold: "lucide:bold";
+    readonly fontUnbold: "lucide:bold";
+    readonly lock: "lucide:lock";
+    readonly unlock: "lucide:unlock";
+    readonly clone: "lucide:copy-plus";
+    readonly copy: "lucide:copy";
+    readonly cut: "lucide:scissors";
+    readonly paste: "lucide:clipboard-paste";
+    readonly delete: "lucide:trash-2";
+    readonly zoomOut: "lucide:zoom-out";
+    readonly zoomIn: "lucide:zoom-in";
+    readonly rotate: "lucide:rotate-cw";
+    readonly clear: "lucide:eraser";
+    readonly toggle: "lucide:panel-left";
+};
+export declare const PANEL_ICONS: {
+    readonly draggableEls: "lucide:boxes";
+    readonly miniMap: "lucide:scan-eye";
+    readonly pageStructure: "lucide:list-tree";
+    readonly pageHistory: "lucide:history";
+    readonly properties: "lucide:sliders-horizontal";
+};
+export declare const ELEMENT_ICON_NAMES: Record<string, string>;
+export declare const HEADER_TAB_ICONS: Record<string, string>;
+export declare const UI_ICONS: {
+    readonly save: "lucide:save";
+    readonly preview: "lucide:eye";
+    readonly editTemplate: "lucide:file-json-2";
+    readonly editPrintData: "lucide:database";
+    readonly exportFile: "lucide:download";
+    readonly importFile: "lucide:upload";
+    readonly chevronDown: "lucide:chevron-down";
+    readonly close: "lucide:x";
+};
+/** Icons for normalized history step labels. */
+export declare const HISTORY_ICONS: Record<string, string>;
+export declare function iconForHistoryLabel(label: string, rawType?: string): string;
+export declare function isIconifyName(value: string): boolean;
+export declare function elementTypeKey(item: any): string;
+export declare function iconForElement(item: any): string;
+export declare function iconForElementKey(key: string): string;
+export declare function iconForHeaderTab(key: string): string;

package/dist/types/src/constants/panel-layout.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Default floating-panel layout — mirrors sv-print `styleOption` defaults.
+ * Coordinates are relative to `.svp-workspace` (below header + toolbar).
+ */
+export declare const SVP_CHROME_TOP = 82;
+/** Matches `--svp-ruler-size`; panels must not overlap ruler strips. */
+export declare const SVP_RULER_INSET = 24;
+/** Gap between stacked panels in the same column. */
+export declare const SVP_PANEL_GAP = 8;
+/** Bottom margin for bottom-anchored panels (miniMap, pageHistory). */
+export declare const SVP_PANEL_BOTTOM = 30;
+/** Fixed height of bottom-docked panels. */
+export declare const SVP_PANEL_DOCK_HEIGHT = 200;
+/** Top-anchored panels share the workspace with a bottom-docked panel below. */
+export declare const SVP_STACKED_HEIGHT_INSET: number;
+export interface PanelLayoutSpec {
+    width: number;
+    height?: number;
+    left?: number;
+    top?: number;
+    right?: number;
+    bottom?: number;
+    /** height = boundsHeight - heightInset */
+    heightInset?: number;
+}
+export declare const SVP_PANEL_LAYOUT: {
+    readonly draggableEls: {
+        readonly left: 28;
+        readonly top: 28;
+        readonly width: 240;
+        readonly heightInset: number;
+    };
+    readonly miniMap: {
+        readonly left: 28;
+        readonly bottom: 30;
+        readonly width: 200;
+        readonly height: 200;
+    };
+    readonly properties: {
+        readonly right: 0;
+        readonly top: 28;
+        readonly width: 270;
+        readonly heightInset: 46;
+    };
+    readonly pageStructure: {
+        readonly right: 280;
+        readonly top: 28;
+        readonly width: 200;
+        readonly heightInset: number;
+    };
+    readonly pageHistory: {
+        readonly right: 280;
+        readonly bottom: 30;
+        readonly width: 200;
+        readonly height: 200;
+    };
+};
+export type SvpPanelLayoutKey = keyof typeof SVP_PANEL_LAYOUT;
+export interface PanelRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function resolvePanelLayout(spec: PanelLayoutSpec, bounds: {
+    width: number;
+    height: number;
+}): PanelRect;
+/** Resolve all default panel rects and verify they do not overlap. */
+export declare function resolveAllPanelLayouts(bounds: {
+    width: number;
+    height: number;
+}, keys?: SvpPanelLayoutKey[]): Record<SvpPanelLayoutKey, PanelRect>;
+export declare function findPanelOverlaps(layouts: Record<string, PanelRect>, gap?: number): Array<[string, string]>;

package/dist/types/src/constants.d.ts

@@ -0,0 +1,37 @@
+import type { PaperType, ToolDescriptor } from './types';
+export declare const DESIGN_CONTAINER_ID = "hiprint-printTemplate";
+export declare const SETTING_CONTAINER_ID = "PrintElementOptionSetting";
+export declare const PAGINATION_CLASS = "hiprint-printPagination";
+export declare const PAGINATION_SELECTOR = ".hiprint-printPagination";
+export declare const DRAGGABLE_ITEM_CLASS = "ep-draggable-item";
+/** Empty hiprint template JSON used by the JSON editor reset action. */
+export declare const EMPTY_TEMPLATE_JSON: {
+    panels: any[];
+};
+/** Canvas zoom limits (fraction of 100%). */
+export declare const ZOOM_MIN = 0.1;
+export declare const ZOOM_MAX = 2;
+export declare const ZOOM_STEP = 0.1;
+/** Standard ISO paper sizes (in mm). "自定义" (Custom) keeps the current size. */
+export declare const DEFAULT_PAPER_LIST: PaperType[];
+export declare const DEFAULT_FONT_LIST: {
+    title: string;
+    value: string;
+}[];
+/** Default drag-element catalogue rendered inside the DraggableEls panel. */
+export interface ElementCatalogueItem {
+    group: string;
+    key: string;
+    label: string;
+    /** Maps to the `tid` consumed by hiprint provider. */
+    tid: string;
+    /** Iconify icon id for the drag tile. */
+    icon?: string;
+}
+export declare const DEFAULT_ELEMENT_CATALOGUE: ElementCatalogueItem[];
+/**
+ * 28 toolbar actions as required by `print设计器功能.md`.
+ * Click handlers are wired against DesignerUtils, see Toolbar.vue.
+ */
+export declare const DEFAULT_TOOLBAR: ToolDescriptor[];
+export declare const STORAGE_PREFIX = "svp:";

package/dist/types/src/core/designer-options.d.ts

@@ -0,0 +1,34 @@
+import type { InjectionKey, Ref } from 'vue-demi';
+import { type PanelLayoutSpec, type SvpPanelLayoutKey } from '../constants/panel-layout';
+import { type PanelVisibility } from './stores';
+import type { ShowOption, StyleOption } from '../types';
+/** Maps `styleOption` keys to floating panel store keys. */
+export declare const STYLE_OPTION_PANEL_KEYS: Record<string, keyof PanelVisibility>;
+/** Maps `styleOption` keys to default layout keys. */
+export declare const STYLE_OPTION_LAYOUT_KEYS: Record<string, SvpPanelLayoutKey>;
+/** Toolbar buttons controlled by `styleOption.*.show`. */
+export declare const TOOL_STYLE_GROUP: Record<string, keyof StyleOption>;
+export interface ResolvedShowOption {
+    showHeader: boolean;
+    showToolbar: boolean;
+    showFooter: boolean;
+    showPower: boolean;
+}
+export interface DesignerUiContext {
+    styleOption: Ref<StyleOption | undefined>;
+    showOption: Ref<ResolvedShowOption>;
+}
+export declare const DESIGNER_UI_INJECTION_KEY: InjectionKey<DesignerUiContext>;
+export declare function resolveShowOption(showOption?: ShowOption, showToolbarFallback?: boolean): ResolvedShowOption;
+export declare function parseInlineStyle(style?: string): Record<string, string>;
+export declare function resolvePanelDragBoxOptions(styleKey: string, styleOption?: StyleOption): {
+    panelKey?: keyof PanelVisibility;
+    layoutKey?: SvpPanelLayoutKey;
+    layoutSpec?: PanelLayoutSpec;
+    boxStyleExtra: Record<string, string>;
+    bodyStyleExtra: Record<string, string>;
+    draggable: boolean;
+    title?: string;
+};
+export declare function applyStyleOption(styleOption?: StyleOption): void;
+export declare function isToolGroupVisible(toolKey: string, styleOption?: StyleOption): boolean;