@printstack/print-studio 0.0.0-stage → 0.1.0

package/designer/stores/tutorial-store.d.ts

@@ -0,0 +1,75 @@
+import { TutorialEditor, TutorialScript } from '../tutorials/types';
+import { createUiStore } from './ui-store';
+import { createViewStore } from './view-store';
+export declare function createTutorialStore(deps: TutorialEditor & {
+    beginSession(): boolean;
+    finishSession(keep: boolean): void;
+    ui: Pick<ReturnType<typeof createUiStore>, 'closeDialog' | 'toast'>;
+    view: Pick<ReturnType<typeof createViewStore>, 'settings' | 'updateSettings'>;
+}): import('pinia').Store<"editor-tutorial", Pick<{
+    close: () => void;
+    course: import('vue').ComputedRef<import('../tutorials/types').TutorialDefinition | undefined>;
+    courseId: import('vue').Ref<string | null, string | null>;
+    current: import('vue').Ref<number, number>;
+    executing: import('vue').Ref<boolean, boolean>;
+    finish: (keep: boolean) => void;
+    interval: import('vue').Ref<number, number>;
+    next: () => void;
+    open: () => void;
+    operation: import('vue').ComputedRef<import('../tutorials/types').TutorialOperation>;
+    operations: import('vue').ComputedRef<import('../tutorials/types').TutorialOperation[]>;
+    phase: import('vue').Ref<"finish" | "list" | "idle" | "running", "finish" | "list" | "idle" | "running">;
+    playing: import('vue').Ref<boolean, boolean>;
+    requestFinish: () => void;
+    seek: (index: number, restoreCurrent?: boolean) => void;
+    setExecuting: (value: boolean) => void;
+    setInterval: (value: number) => void;
+    setPlaying: (value: boolean) => void;
+    setTransition: (value: "seeking" | "idle" | "stopping") => void;
+    start: (id: string, script?: TutorialScript) => void;
+    transition: import('vue').Ref<"seeking" | "idle" | "stopping", "seeking" | "idle" | "stopping">;
+}, "playing" | "transition" | "courseId" | "current" | "executing" | "interval" | "phase">, Pick<{
+    close: () => void;
+    course: import('vue').ComputedRef<import('../tutorials/types').TutorialDefinition | undefined>;
+    courseId: import('vue').Ref<string | null, string | null>;
+    current: import('vue').Ref<number, number>;
+    executing: import('vue').Ref<boolean, boolean>;
+    finish: (keep: boolean) => void;
+    interval: import('vue').Ref<number, number>;
+    next: () => void;
+    open: () => void;
+    operation: import('vue').ComputedRef<import('../tutorials/types').TutorialOperation>;
+    operations: import('vue').ComputedRef<import('../tutorials/types').TutorialOperation[]>;
+    phase: import('vue').Ref<"finish" | "list" | "idle" | "running", "finish" | "list" | "idle" | "running">;
+    playing: import('vue').Ref<boolean, boolean>;
+    requestFinish: () => void;
+    seek: (index: number, restoreCurrent?: boolean) => void;
+    setExecuting: (value: boolean) => void;
+    setInterval: (value: number) => void;
+    setPlaying: (value: boolean) => void;
+    setTransition: (value: "seeking" | "idle" | "stopping") => void;
+    start: (id: string, script?: TutorialScript) => void;
+    transition: import('vue').Ref<"seeking" | "idle" | "stopping", "seeking" | "idle" | "stopping">;
+}, "course" | "operation" | "operations">, Pick<{
+    close: () => void;
+    course: import('vue').ComputedRef<import('../tutorials/types').TutorialDefinition | undefined>;
+    courseId: import('vue').Ref<string | null, string | null>;
+    current: import('vue').Ref<number, number>;
+    executing: import('vue').Ref<boolean, boolean>;
+    finish: (keep: boolean) => void;
+    interval: import('vue').Ref<number, number>;
+    next: () => void;
+    open: () => void;
+    operation: import('vue').ComputedRef<import('../tutorials/types').TutorialOperation>;
+    operations: import('vue').ComputedRef<import('../tutorials/types').TutorialOperation[]>;
+    phase: import('vue').Ref<"finish" | "list" | "idle" | "running", "finish" | "list" | "idle" | "running">;
+    playing: import('vue').Ref<boolean, boolean>;
+    requestFinish: () => void;
+    seek: (index: number, restoreCurrent?: boolean) => void;
+    setExecuting: (value: boolean) => void;
+    setInterval: (value: number) => void;
+    setPlaying: (value: boolean) => void;
+    setTransition: (value: "seeking" | "idle" | "stopping") => void;
+    start: (id: string, script?: TutorialScript) => void;
+    transition: import('vue').Ref<"seeking" | "idle" | "stopping", "seeking" | "idle" | "stopping">;
+}, "start" | "next" | "finish" | "close" | "open" | "requestFinish" | "seek" | "setExecuting" | "setInterval" | "setPlaying" | "setTransition">>;

package/designer/stores/types.d.ts

@@ -0,0 +1,135 @@
+import { AlignTarget } from '../../core/align';
+import { DataSource, ElementLayoutPatch, PageNode, PrintDocument } from '../../core/types';
+export interface UiRestoreState {
+    binding?: {
+        field: string;
+        nodeId: string;
+        path: string;
+    };
+    column?: number;
+    dataSource?: {
+        draft: DataSource;
+        replacement: boolean;
+        sampleJson: string;
+        saved: boolean;
+        tab: 'basic' | 'sample' | 'schema';
+    };
+    dialog?: DialogState;
+    menu?: string;
+    select?: string;
+    tab?: string;
+    values?: Record<string, unknown>;
+}
+export type LayoutRule = (document: PrintDocument, movedElementIds: readonly string[], reshapedElementIds: readonly string[]) => ElementLayoutPatch[];
+export declare const PAGE_GAP_MM = 15;
+export declare const STAGE_PADDING_MM = 40;
+export declare const STAGE_MARGIN_MM = 500;
+export interface ToastItem {
+    id: number;
+    kind: 'error' | 'info' | 'success';
+    text: string;
+}
+export interface ExportDialogState {
+    completed: boolean;
+    format: 'html' | 'pdf';
+    minimized: boolean;
+}
+export interface EditingContext {
+    dialogSessionId?: number;
+    pageId: string;
+    selectionIds: string[];
+    templateId: null | string;
+}
+export interface DialogSession {
+    dialog: DialogState;
+    elementId?: string;
+    elementIds?: string[];
+    id: number;
+}
+export interface DialogState {
+    /** apply-template 对话框：预设的模板 id（从模板行"应用范围"进入时携带） */
+    applyTemplateTemplateId?: string;
+    /** repeat 对话框：要编辑的循环区块 id（缺省 = 新建模式） */
+    groupId?: string;
+    /** guide 对话框：要编辑的参考线 id（缺省 = 新建模式） */
+    guideId?: string;
+    name: 'apply-template' | 'canvas-color' | 'datasource' | 'element' | 'follow' | 'follow-join' | 'follow-manager' | 'guide' | 'page' | 'preview' | 'repeat' | 'repeat-manager' | 'template-library' | null;
+    /** apply-template 对话框：预设的目标页 id（范围起止均指向该页） */
+    pageId?: string;
+    /** preview 对话框使用的外部打印数据 */
+    previewInput?: Record<string, unknown>;
+    returnDialog?: 'follow-manager' | 'repeat-manager';
+}
+export declare const PANEL_WIDTH_DEFAULT = 280;
+export declare const PANEL_WIDTH_MIN = 240;
+export declare const PANEL_WIDTH_MAX = 560;
+export declare const PANEL_RAIL_MIN = 36;
+export declare const PANEL_RAIL_DEFAULT = 112;
+export interface PanelGroup {
+    activeId: string;
+    id: string;
+    panelIds: string[];
+    weight: number;
+}
+export interface PanelColumn {
+    collapsed: boolean;
+    floating: boolean;
+    groups: PanelGroup[];
+    height: number;
+    id: string;
+    railWidth: number;
+    width: number;
+    x: number;
+    y: number;
+}
+export interface PanelLayout {
+    columns: PanelColumn[];
+    version: 1;
+}
+export interface PanelDropTarget {
+    columnId?: string;
+    groupId?: string;
+    panelId?: string;
+    placement: 'after' | 'before' | 'bottom' | 'float' | 'left' | 'right' | 'tab' | 'top';
+    x?: number;
+    y?: number;
+}
+export interface PanelDragState {
+    columnId: string;
+    groupId?: string;
+    panelId?: string;
+    target: null | PanelDropTarget;
+    x: number;
+    y: number;
+}
+export type { AlignMode } from '../../core/align';
+/** 对齐面板选项；spacing 为 null 时自动计算间距，关键对象由选区提供。 */
+export interface AlignPanelState {
+    spacing: null | number;
+    target: AlignTarget;
+}
+export type PageLayoutMode = 'grid' | 'horizontal' | 'vertical';
+export interface GuideDragState {
+    guideId: string;
+    pageId: string;
+}
+export interface MutationOptions {
+    transient?: boolean;
+}
+export interface ElementQueryOptions {
+    locked?: boolean;
+    visible?: boolean;
+}
+export type EditingPagePatch = Partial<Pick<PageNode, 'background' | 'height' | 'margins' | 'name' | 'width'>>;
+export interface EditingScope {
+    activeId: string;
+    id: string;
+    layoutMode?: PageLayoutMode;
+    pageGap?: number;
+    pages: PageNode[];
+}
+export interface EditingScopeProvider {
+    activate: (pageId: string) => void;
+    resolve: () => EditingScope | undefined;
+    updatePage: (pageId: string, patch: EditingPagePatch) => void;
+}