@printstack/print-studio 0.0.0-stage → 0.1.1

package/designer/components/ui/menu-items.vue.d.ts

@@ -0,0 +1,11 @@
+import { ContextMenuItem, MenuItemAction } from '../../commands/menu-types';
+type __VLS_Props = {
+    items: ContextMenuItem[];
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    select: (item: MenuItemAction) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((item: MenuItemAction) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/ui/panel-frame.vue.d.ts

@@ -0,0 +1,21 @@
+type __VLS_Props = {
+    panelId: string;
+    title: string;
+};
+declare const __VLS_template: () => {
+    __VLS_Slots: {
+        actions?: (props: {}) => any;
+    } & {
+        default?: (props: {}) => any;
+    };
+};
+type __VLS_Slots = ReturnType<typeof __VLS_template>['__VLS_Slots'];
+declare const __VLS_base: 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 __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/designer/components/ui/toast-host.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/ui/tool-icon.vue.d.ts

@@ -0,0 +1,6 @@
+type __VLS_Props = {
+    name: string;
+};
+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/variable-text/use-variable-text-bindings.d.ts

@@ -0,0 +1,9 @@
+import { BindingVariable } from '../../../core/binding-expression';
+export declare function useVariableTextBindings(getRelativeTo: () => string | undefined): {
+    describe: (variable: BindingVariable) => {
+        invalid: boolean;
+        label: string;
+        title: string;
+    };
+    resolveField: (path: string) => import('../../../core/binding-expression').BindingVariableField | undefined;
+};

package/designer/components/variable-text/use-variable-text-editor.d.ts

@@ -0,0 +1,38 @@
+import { Ref } from 'vue';
+import { BindingVariable } from '../../../core/binding-expression';
+export interface VariableChipLabel {
+    invalid?: boolean;
+    label: string;
+    title: string;
+}
+interface VariableTextEditorOptions {
+    describe: (variable: BindingVariable) => VariableChipLabel;
+    editable: () => boolean;
+    getValue: () => string;
+    multiline: () => boolean;
+    root: Ref<HTMLElement | undefined>;
+    setValue: (value: string) => void;
+}
+/**
+ * 变量文本编辑器的 DOM 层：把 `{{ 路径 | 格式 }}` 表达式渲染为原子节点（chip），
+ * chip 为 contenteditable=false，只能整体删除 / 替换，内部字符不可选中或编辑。
+ * 字符串模型始终是唯一数据来源，DOM 仅为其投影。
+ */
+export declare function useVariableTextEditor(options: VariableTextEditorOptions): {
+    commitChange: () => void;
+    focus: () => void;
+    insertLineBreak: () => void;
+    insertText: (text: string) => void;
+    onCopy: (event: ClipboardEvent) => void;
+    onCut: (event: ClipboardEvent) => void;
+    onPaste: (event: ClipboardEvent) => void;
+    refreshChips: () => void;
+    removeAdjacentChip: (direction: "backward" | "forward", event: KeyboardEvent) => void;
+    removeChip: (chip: HTMLElement) => void;
+    replaceText: (value: string) => void;
+    select: () => void;
+    serialize: () => string;
+    syncFromValue: () => void;
+    updateChip: (chip: HTMLElement, expression: string) => void;
+};
+export {};

package/designer/components/variable-text/variable-formatter-editor.vue.d.ts

@@ -0,0 +1,16 @@
+import { BindingVariable, BindingVariableField } from '../../../core/binding-expression';
+type __VLS_Props = {
+    field?: BindingVariableField;
+    variable: BindingVariable;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    close: () => any;
+    remove: () => any;
+    "update:variable": (value: BindingVariable) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClose?: (() => any) | undefined;
+    onRemove?: (() => any) | undefined;
+    "onUpdate:variable"?: ((value: BindingVariable) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/variable-text/variable-text-field.vue.d.ts

@@ -0,0 +1,33 @@
+type __VLS_Props = {
+    ariaLabel?: string;
+    disabled?: boolean;
+    inline?: boolean;
+    multiline?: boolean;
+    placeholder?: string;
+    readonly?: boolean;
+    /** 相对模式：变量路径相对该数组路径解析（循环 / 表格行内字段） */
+    relativeTo?: string;
+    title?: string;
+};
+type __VLS_ModelProps = {
+    modelValue?: string;
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare const __VLS_export: import('vue').DefineComponent<__VLS_PublicProps, {
+    focus: () => void;
+    select: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    blur: (event: FocusEvent) => any;
+    focus: (event: FocusEvent) => any;
+    commit: () => any;
+    "update:modelValue": (value: string | undefined) => any;
+    leave: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onBlur?: ((event: FocusEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    onCommit?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+    onLeave?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/variable-text/variable-text-preview.vue.d.ts

@@ -0,0 +1,7 @@
+type __VLS_Props = {
+    relativeTo?: string;
+    text: string;
+};
+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/composables/use-restored-ui-state.d.ts

@@ -0,0 +1,2 @@
+import { UiRestoreState } from '../stores/types';
+export declare function useRestoredUiState<Key extends keyof UiRestoreState>(key: Key, restore: (value: UiRestoreState[Key]) => void): void;

package/designer/config/canvas-background.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 画布（页面外虚无区域）背景预设：Photoshop pasteboard 同款右键菜单数据源。
+ * 预设表是唯一数据源——命令注册（builtins 的 canvas.background.*）、store 解析色、
+ * 右键菜单条目均由它派生；扩展换色 = 改表或注册同 id 命令整体替换。
+ */
+export type CanvasBackgroundId = 'black' | 'custom' | 'dark-gray' | 'default' | 'light-gray' | 'medium-gray';
+export interface CanvasBackgroundPreset {
+    /** 最终 CSS 颜色值（default 指向主题 token，随主题联动） */
+    color: string;
+    id: CanvasBackgroundId;
+    label: string;
+}
+/** 固定预设；custom 不在表内（颜色来自用户输入，存于 store） */
+export declare const CANVAS_BACKGROUND_PRESETS: readonly CanvasBackgroundPreset[];
+/** 自定义颜色的兜底值（历史存储损坏 / 输入为空时使用） */
+export declare const FALLBACK_CANVAS_COLOR = "#4d4d4d";
+/** 预设 id 是否合法（用于 localStorage 恢复校验） */
+export declare function isCanvasBackgroundId(value: unknown): value is CanvasBackgroundId;

package/designer/context/editor-context.d.ts

@@ -0,0 +1,64 @@
+import { App } from 'vue';
+import { ErrorRuntime } from '../../components/error-fallback/core';
+import { DesignerEventMap, TypedEventBus } from '../../core/events';
+import { Rect } from '../../core/geometry';
+import { ElementNode } from '../../core/types';
+import { ZIndexService } from '../../core/z-index';
+import { EditorStore } from '../stores/editor-store';
+import { elementRegistry } from '../../core/element-registry';
+import { CommandRegistry } from '../commands/command-registry';
+import { ExtensionPointRegistry } from '../plugins/extension-points';
+import { PluginManager } from '../plugins/plugin-manager';
+import { PreferenceStorageRegistry } from '../services/preference-storage';
+import { TemplateLibraryRegistry } from '../template-library/registry';
+import { parserRegistry } from '../../parser';
+import { createBrowserOutput } from '../../runtime/browser-output';
+import { EditorRuntimeOptions } from './editor-runtime';
+export { EditorContextKey } from './editor-runtime';
+export interface SelectionSnapshot {
+    /** 选区联合包围盒（页面坐标系），无选中时为 null */
+    bounds: null | Rect;
+    ids: string[];
+    nodes: ElementNode[];
+    /** 主选中元素（多选时为第一个），无选中时为 null */
+    primary: ElementNode | null;
+}
+export interface EditorContext {
+    /** 命令注册表（快捷键 / 菜单 / 编程调用的统一分发层） */
+    readonly commands: CommandRegistry;
+    dispose?(): void;
+    /** 元素注册中心（复用既有单例） */
+    readonly elements: typeof elementRegistry;
+    /** 全局错误运行时（异常兜底唯一出口；展示规则见 plugins/error-handling） */
+    readonly errors: ErrorRuntime;
+    /** 全局事件总线（强类型，支持 '*' 通配） */
+    readonly events: TypedEventBus<DesignerEventMap>;
+    /** 稳定的、带 API 版本的扩展点注册中心 */
+    readonly extensions: ExtensionPointRegistry;
+    /** 当前选中集快照（响应式数据的当前值，供扩展读取） */
+    getSelection(): SelectionSnapshot;
+    output?: ReturnType<typeof createBrowserOutput>;
+    /** 解析器注册中心（复用既有单例） */
+    readonly parsers: typeof parserRegistry;
+    /** 插件管理器（插件式扩展的安装与卸载） */
+    readonly plugins: PluginManager;
+    readonly preferences: PreferenceStorageRegistry;
+    root?: () => HTMLElement | undefined;
+    /** 惰性获取编辑器 store（state 的唯一权威来源） */
+    store(): EditorStore;
+    /** 模板库注册表（文件 > 模板库的来源聚合，可注册远程来源） */
+    readonly templateLibrary: TemplateLibraryRegistry;
+    readonly use: PluginManager['use'];
+    readonly zIndex: ZIndexService;
+}
+export declare function createEditorContext(options?: EditorRuntimeOptions): EditorContext;
+/** 取全局 context 单例（不存在则创建；插件安装见 installDesigner / installBuiltinPlugins） */
+export declare function getEditorContext(): EditorContext;
+/**
+ * 设计器安装入口：创建 context 单例、provide 给组件树、安装内置插件
+ * （事件绑定 + 内置命令），并在 dev 模式挂 window.__designer 供控制台调试与
+ * 扩展开发。在 main.ts 的 app.use(pinia) 之后调用。
+ */
+export declare function installDesigner(app: App, options?: EditorRuntimeOptions): EditorContext;
+/** 组件内取 context：优先 inject（可测试替换），兜底全局单例 */
+export declare function useEditorContext(): EditorContext;

package/designer/context/editor-runtime.d.ts

@@ -0,0 +1,11 @@
+import { InjectionKey } from 'vue';
+import { RuntimeConfigOptions } from '../../core/runtime-config';
+import { PluginPolicy } from '../plugins/plugin-manager';
+import { DocumentStoreOptions } from '../stores/document-store';
+import { RegistryOptions } from '../../runtime/registries';
+import { EditorContext } from './editor-context';
+export declare const EditorContextKey: InjectionKey<EditorContext>;
+export type EditorRuntimeOptions = Omit<DocumentStoreOptions, 'elements' | 'parsers'> & RegistryOptions & RuntimeConfigOptions & {
+    pluginPolicy?: PluginPolicy;
+};
+export declare function createEditorRuntime(options?: EditorRuntimeOptions, install?: (ctx: EditorContext) => void): EditorContext;

package/designer/context/editor-view.d.ts

@@ -0,0 +1,8 @@
+import { EditorContext } from './editor-context';
+interface EditorView {
+    dispose(): void;
+    root(): HTMLElement | undefined;
+}
+export declare function bindEditorView(context: EditorContext, view: EditorView): () => void;
+export declare function disposeEditorView(context: EditorContext): void;
+export {};

package/designer/context/inspector-layout.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 属性区展示形态：panel 为侧栏窄容器，wide 为元素设置弹窗宽容器。
+ * 表格等复合控件据此切换内部布局；未声明时按窄容器（panel）回落。
+ */
+export type InspectorLayout = 'panel' | 'wide';
+export declare function provideInspectorLayout(layout: InspectorLayout): void;
+export declare function useInspectorLayout(fallback?: InspectorLayout): InspectorLayout;

package/designer/context/use-element-definition.d.ts

@@ -0,0 +1 @@
+export declare function useElementDefinition(getType: () => string | undefined): import('vue').ComputedRef<import('../../core').ElementDefinition | undefined>;

package/designer/events/store-event-bindings.d.ts

@@ -0,0 +1,7 @@
+import { ElementRegistry } from '../../core/element-registry';
+import { DesignerEventMap, TypedEventBus } from '../../core/events';
+import { EditorStore } from '../stores/editor-store';
+type EventBus = TypedEventBus<DesignerEventMap>;
+export declare function bindElementRegistryEvents(registry: ElementRegistry, bus: EventBus): () => void;
+export declare function bindStoreEvents(store: EditorStore, bus?: EventBus): () => void;
+export {};

package/designer/facade/bindings.d.ts

@@ -0,0 +1,6 @@
+import { DesignStudio } from '../../studio-types';
+import { EditorContext } from '../context/editor-context';
+export declare function onStudioDispose(studio: DesignStudio, dispose: () => void): () => void;
+export declare function bindStudioContext(studio: DesignStudio, context: EditorContext): void;
+export declare function getStudioContext(studio: DesignStudio): EditorContext;
+export declare function unbindStudioContext(studio: DesignStudio): void;

package/designer/facade/editing.d.ts

@@ -0,0 +1,43 @@
+import { AlignMode, AlignOptions, DistributeSpacingOptions, SpacingDirection } from '../../core/align';
+import { EntityReference, FacadeAccess } from './entities';
+export declare function createEditingFacade(access: FacadeAccess): {
+    edit: {
+        align: (mode: AlignMode, options?: AlignOptions) => void;
+        copy: () => void;
+        cut: () => void;
+        delete: () => void;
+        /** 分布对象；'h' / 'v' 为旧版按中心点分布的简写 */
+        distribute: (mode: "h" | "v" | AlignMode, options?: AlignOptions) => void;
+        distributeSpacing: (direction: SpacingDirection, options?: DistributeSpacingOptions) => void;
+        duplicate: () => void;
+        nudge: (dx: number, dy: number) => void;
+        paste: () => void;
+        reorder: (offset: number) => void;
+        sendTo: (edge: "back" | "front") => void;
+    };
+    selection: {
+        all: () => void;
+        clear: () => void;
+        readonly ids: string[];
+        readonly nodes: {
+            bindings?: Record<string, string> | undefined;
+            height: number;
+            id: import('../../core').ElementId;
+            locked: boolean;
+            name: string;
+            opacity: number;
+            points?: {
+                x: number;
+                y: number;
+            }[] | undefined;
+            props: Record<string, unknown>;
+            rotation: number;
+            type: string;
+            visible: boolean;
+            width: number;
+            x: number;
+            y: number;
+        }[];
+        set: (references: EntityReference[]) => void;
+    };
+};

package/designer/facade/elements.d.ts

@@ -0,0 +1,37 @@
+import { ElementNode } from '../../core/types';
+import { ElementOptions, ElementPatch, MutationOptions } from '../../studio-types';
+import { EntityReference, FacadeAccess } from './entities';
+export type { ElementOptions, ElementPatch } from '../../studio-types';
+export declare function createElementsFacade(access: FacadeAccess, pageId: string, defaultElementType: string): {
+    add: (options?: ElementOptions) => {
+        readonly data: ElementNode | undefined;
+        id: string;
+        remove(): void;
+        update(patch: Partial<Omit<ElementNode, "id" | "type">>): void;
+    };
+    clear(): void;
+    duplicate(reference: EntityReference): ({
+        readonly data: ElementNode | undefined;
+        id: string;
+        remove(): void;
+        update(patch: Partial<Omit<ElementNode, "id" | "type">>): void;
+    } | undefined)[];
+    get: (reference: EntityReference) => {
+        readonly data: ElementNode | undefined;
+        id: string;
+        remove(): void;
+        update(patch: Partial<Omit<ElementNode, "id" | "type">>): void;
+    } | undefined;
+    readonly list: {
+        readonly data: ElementNode | undefined;
+        id: string;
+        remove(): void;
+        update(patch: Partial<Omit<ElementNode, "id" | "type">>): void;
+    }[];
+    move(reference: EntityReference, displayIndex: number): void;
+    remove: (reference: EntityReference) => void;
+    rename(reference: EntityReference, name: string): void;
+    toggleFlag(reference: EntityReference, flag: "locked" | "visible"): void;
+    update(reference: EntityReference, patch: ElementPatch, options?: MutationOptions): void;
+    updateProps(reference: EntityReference, patch: Record<string, unknown>, options?: MutationOptions): void;
+};