@printstack/print-studio 0.1.0 → 0.1.2

package/{cloneDeep-C5UZRjbH.js → cloneDeep-waBDTGc3.js}

@@ -13,6 +13,7 @@ var n = {
 	},
 	app: {
 		browserTitle: "Print Studio · Web 打印设计器",
+		logoAccessibleLabel: "Print S：Print Studio、Print Scape、Print Style",
 		reloadButton: "重新加载",
 		fatalErrorTitle: "设计器暂时无法使用",
 		resetInterfaceButton: "重置界面"
@@ -184,6 +185,12 @@ var n = {
 		numberedName: "图层组 {groupNumber}"
 	}
 }, a = {
+	theme: {
+		groupLabel: "主题",
+		light: "浅色",
+		dark: "深色",
+		system: "系统"
+	},
 	tutorialPlayback: {
 		detailedSteps: "逐项操作演示",
 		demonstrate: "知道了，下一步",
@@ -820,7 +827,7 @@ var n = {
 		columnsLabel: "列数",
 		columnUnit: "列",
 		columnsHint: "超出页面宽度时自动减少列数",
-		columnGapLabel: "列间距",
+		columnGapLabel: "水平间距",
 		numberedGroupName: "循环区块 {groupNumber}",
 		selectMembersMessage: "请先选中要组合的元素",
 		ungroupedMessage: "已解除循环区块，元素已保留",
@@ -1247,6 +1254,7 @@ var n = {
 		panelTitle: "页面",
 		templatesSection: "模板",
 		pagesSection: "页面列表",
+		moreActionsTitle: "更多操作",
 		addTemplateTitle: "新建模板",
 		addTemplateFromPageTitle: "从当前页新建模板",
 		editTemplateTitle: "编辑模板",
@@ -1283,11 +1291,9 @@ var n = {
 		pageName: "页面名称"
 	},
 	templateBanner: {
-		resetBackgroundTitle: "清除模板背景，继承基础模板或页面背景",
-		resetBackgroundLabel: "继承背景",
 		baseTemplateLabel: "基于模板",
 		noTemplateLabel: "无模板",
-		detachTitle: "分离模板内容为页面元素",
+		detachTitle: "分离模板内容",
 		oddPages: "单数页",
 		facingPages: "单双页控制",
 		evenPages: "双数页",

package/components/print-s-logo/print-s-logo.vue.d.ts

@@ -4,9 +4,9 @@ interface Props {
     variant?: 'dark' | 'light';
 }
 declare const __VLS_export: import('vue').DefineComponent<Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<Props> & Readonly<{}>, {
-    variant: "dark" | "light";
     holdMs: number;
     transitionMs: number;
+    variant: "light" | "dark";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/components/s-form/types.d.ts

@@ -467,7 +467,7 @@ export interface SFormProps {
     /**
      * getValues / update:modelValue / submit 输出的快照是否剔除当前隐藏字段的值
      * （含隐藏分组下的全部子字段，剔除后变空的父级对象级联删除）。
-     * 默认 false：隐藏字段值保留输出（向后兼容）；
+     * 默认 false：隐藏字段值保留输出；
      * 内部状态始终保留隐藏字段的值，字段重新显示时原值不丢失
      */
     omitHiddenValues?: boolean;

package/core/coordinate-space.d.ts

@@ -0,0 +1,16 @@
+import { Point } from './geometry';
+/** 页面左上角在全局（画布内容）空间的位置，mm */
+export type SpaceOrigin = Point;
+/** 全局坐标 → 页面局部坐标 */
+export declare function globalToLocal(origin: SpaceOrigin, point: Point): Point;
+/** 页面局部坐标 → 全局坐标 */
+export declare function localToGlobal(origin: SpaceOrigin, point: Point): Point;
+/**
+ * 屏幕坐标 → 全局坐标。
+ * `contentRect` 为内容容器的 getBoundingClientRect（已含滚动偏移），`pxPerMm` 为当前缩放后的像素密度。
+ */
+export declare function clientToGlobal(contentRect: Pick<DOMRect, 'left' | 'top'>, client: Point, pxPerMm: number): Point;
+/** 屏幕坐标 → 页面局部坐标 */
+export declare function clientToLocal(contentRect: Pick<DOMRect, 'left' | 'top'>, origin: SpaceOrigin, client: Point, pxPerMm: number): Point;
+/** 页面局部坐标 → 屏幕坐标 */
+export declare function localToClient(contentRect: Pick<DOMRect, 'left' | 'top'>, origin: SpaceOrigin, point: Point, pxPerMm: number): Point;

package/core/document-model.d.ts

@@ -18,7 +18,7 @@ export declare function createTemplate(name?: string, reference?: PageLayout): P
 export declare function createElement(type: string, overrides?: Partial<ElementNode>, elements?: ElementRegistry): ElementNode;
 /** 声明 measureSize 的元素按内容修正节点尺寸；未声明或返回空时保持不变 */
 export declare function applyMeasureSize(node: ElementNode, definition?: import('./element-registry').ElementDefinition | undefined): void;
-/** 点驱动节点缺 points 时按定义的 migrateRect 补齐并同步包围盒；其余节点原样返回 */
+/** 点驱动节点缺 points 时创建默认点集并同步包围盒。 */
 export declare function normalizeNodePoints(node: ElementNode, definition?: import('./element-registry').ElementDefinition | undefined): ElementNode;
 export declare function cloneElement(node: ElementNode): ElementNode;
 export declare function findElement(doc: PrintDocument, id: string): null | {

package/core/element-registry.d.ts

@@ -79,11 +79,6 @@ export interface PointBasedCapability {
         point: Point;
         points: Point[];
     }) => boolean;
-    /**
-     * 旧版定界框数据迁移为点集：仅历史文档（无 points 字段）加载时调用，
-     * 返回的点集会重新派生包围盒并把 rotation 归零。
-     */
-    migrateRect?: (node: ElementNode) => Point[];
 }
 export interface InlineEditCapability {
     read: (node: ElementNode) => string;
@@ -135,14 +130,14 @@ export interface ElementDefinition {
      */
     measureSize?: (ctx: ElementMeasureContext) => Partial<Pick<ElementNode, 'height' | 'width'>>;
     /**
-     * 旧文档属性归一化：反序列化与创建实例时调用（幂等）。
-     * 用于数据模型演进（如旧版边框字段迁移到新模型），元素自行声明迁移逻辑。
+     * 属性归一化：反序列化与创建实例时调用（幂等）。
+     * 元素自行补全默认值并校验配置。
      */
     normalizeProps?: (props: Record<string, unknown>) => Record<string, unknown>;
     /** 工具栏排序，越小越靠前 */
     order: number;
     overflow?: (ctx: ElementOverflowContext) => ElementOverflowResult | null;
-    /** 声明元素持有的页面扩展资源，供迁移、复制及生命周期管理复用。 */
+    /** 声明元素持有的页面扩展资源，供复制及生命周期管理复用。 */
     pageExtensions?: {
         rebind: (node: ElementNode, purpose: string, templateId: string, elementId: string) => void;
         reconcile?: (document: PrintDocument, node: ElementNode) => void;

package/core/page-extensions.d.ts

@@ -20,7 +20,7 @@ export declare function resolvePageExtensionNode(document: PrintDocument, node:
 export declare function reconcilePageExtensions(document: PrintDocument, node: ElementNode, registry: ElementRegistry): void;
 export declare function assertRequiredElementMutation(document: PrintDocument, node: ElementNode, patch?: Partial<ElementNode>): void;
 export declare function validateTemplateDependencies(template: PageTemplate): void;
-/** 复制内部资源并重新绑定引用，避免副本与原元素共享可编辑资源。也迁移旧版引用。 */
+/** 复制内部资源并重新绑定引用，避免副本与原元素共享可编辑资源。 */
 export declare function copyPageExtensions(document: PrintDocument, source: ElementNode, target: ElementNode, registry: ElementRegistry, resources?: PrintDocument): void;
 export declare function prunePageExtensions(document: PrintDocument, registry?: ElementRegistry): void;
 export declare function assertPageExtensionReferences(document: PrintDocument, node: ElementNode, registry: ElementRegistry): void;

package/core/types.d.ts

@@ -79,6 +79,14 @@ export interface PageNode {
     id: string;
     margins?: PageMargins;
     name: string;
+    /**
+     * 页面（画板）左上角在画布全局空间的位置，mm；缺省 = 按排列方式自动布局。
+     * 仅决定页面放置位置，元素 / 参考线坐标始终相对页面左上角，不随之改变。
+     */
+    position?: {
+        x: number;
+        y: number;
+    };
     /** 页面模板（PageTemplate，作用同 InDesign 主页）id；缺省 = 内置空白模板 */
     templateId?: string;
     width: number;

package/core.js

@@ -1,5 +1,5 @@
-import { G as e, U as t, W as n, c as r, f as i, n as a, p as o, u as s } from "./document-model-DC9sn2WV.js";
-import { A as c, B as l } from "./cloneDeep-C5UZRjbH.js";
+import { G as e, U as t, W as n, c as r, f as i, n as a, p as o, u as s } from "./document-model-Cc5RoO4j.js";
+import { A as c, B as l } from "./cloneDeep-waBDTGc3.js";
 // src/core/types.ts
 var u = [
 	{

package/designer/commands/menu-adapter.d.ts

@@ -1,11 +1,11 @@
-import { ContextMenuItem } from './menu-types';
+import { ContextMenuItem, MenuItemAction } from './menu-types';
 import { CommandRegistry } from './command-registry';
 import { CommandDefinition, CommandMenuEntry } from './types';
 /** 取主快捷键（用于菜单右侧提示文案） */
 export declare function primaryShortcut(command: CommandDefinition): string | undefined;
 /** 把命令渲染为菜单条目；勾选/禁用/动态文案在求值时读取（响应式菜单 computed 内调用即自动追踪） */
-export declare function toMenuItem(command: CommandDefinition, execute: (id: string, ...args: unknown[]) => void, entry?: CommandMenuEntry): ContextMenuItem;
-export declare function toMenuItems(command: CommandDefinition, execute: (id: string, ...args: unknown[]) => void): ContextMenuItem[];
+export declare function toMenuItem(command: CommandDefinition, execute: (id: string, ...args: unknown[]) => void, entry?: CommandMenuEntry): MenuItemAction;
+export declare function toMenuItems(command: CommandDefinition, execute: (id: string, ...args: unknown[]) => void): MenuItemAction[];
 export declare function commandMenuItems(registry: CommandRegistry, entries: ((CommandMenuEntry & {
     id: string;
 }) | string)[], execute: (id: string, ...args: unknown[]) => void): ContextMenuItem[];

package/designer/commands/menu-types.d.ts

@@ -10,6 +10,7 @@ export interface MenuItemAction {
     /** 悬停提示：解释该菜单项的作用（帮助不熟悉的概念，如循环区块） */
     help?: string;
     icon?: string;
+    keepOpen?: boolean;
     label: string;
     shortcut?: string;
     type: 'item';
@@ -23,6 +24,12 @@ export interface MenuSubmenu {
     label: string;
     type: 'submenu';
 }
-export type ContextMenuItem = MenuDivider | MenuItemAction | MenuSubmenu;
+export interface MenuSegment {
+    icon?: string;
+    items: MenuItemAction[];
+    label: string;
+    type: 'segment';
+}
+export type ContextMenuItem = MenuDivider | MenuItemAction | MenuSegment | MenuSubmenu;
 export declare function divider(): MenuDivider;
 export declare function menuItem(label: string, action: () => void, extra?: Partial<Omit<MenuItemAction, 'action' | 'label' | 'type'>>): MenuItemAction;

package/designer/commands/types.d.ts

@@ -45,6 +45,8 @@ export interface CommandDefinition {
      * args 为 execute() 透传的参数（如带参命令的 groupId、触发时的键盘事件）。
      */
     run: (ctx: EditorContext, ...args: unknown[]) => unknown;
+    /** 将相关命令合并为一行分段选择器。 */
+    segment?: CommandSubmenu;
     /**
      * 规范化快捷键字符串（Ctrl/Shift/Alt + key），可多个。
      * 声明后自动获得键盘触发能力，与菜单解耦。

package/designer/components/dialogs/preview-dialog.vue.d.ts

@@ -1,3 +1,12 @@
-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>;
+type __VLS_Props = {
+    timeoutMs?: number;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    ready: (element: HTMLIFrameElement, warnings: string[]) => any;
+    error: (error: unknown) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onReady?: ((element: HTMLIFrameElement, warnings: string[]) => any) | undefined;
+    onError?: ((error: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/designer/components/dialogs/print-preview-dialog.vue.d.ts

@@ -0,0 +1,14 @@
+import { PrintPreviewSource } from './print-preview-source';
+type __VLS_Props = {
+    source: PrintPreviewSource;
+    timeoutMs?: number;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    ready: (element: HTMLIFrameElement, warnings: string[]) => any;
+    error: (error: unknown) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onReady?: ((element: HTMLIFrameElement, warnings: string[]) => any) | undefined;
+    onError?: ((error: unknown) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/designer/components/dialogs/print-preview-source.d.ts

@@ -0,0 +1,22 @@
+import { PrintDocument } from '../../../core/types';
+import { RenderExecutionOptions } from '../../../parser';
+export interface PrintPreviewSnapshot {
+    document: PrintDocument;
+    input: Record<string, unknown>;
+}
+/** 打印预览所需的状态与操作；界面不依赖编辑器 store。 */
+export interface PrintPreviewSource {
+    capture(error: unknown): unknown;
+    close(): void;
+    getSampleInput(): Record<string, unknown>;
+    readonly name: string;
+    print(target: Window): void;
+    render(input: Record<string, unknown>, execution?: RenderExecutionOptions): Promise<{
+        html: string;
+        warnings: string[];
+    }>;
+    readonly request: undefined | {
+        previewInput?: Record<string, unknown>;
+    };
+    readonly revision: number;
+}

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

@@ -1,5 +1,9 @@
 import { EditorContext } from '../../context/editor-context';
-export declare function useDocumentPreview(ctx: EditorContext): {
+import { PrintPreviewSource } from './print-preview-source';
+import { usePrintPreview } from './use-print-preview';
+/** 将设计器的文档和弹窗状态适配到共用打印预览。 */
+export declare function createDocumentPreviewSource(ctx: EditorContext): PrintPreviewSource;
+export declare function useDocumentPreview(ctx: EditorContext, options?: Parameters<typeof usePrintPreview>[1]): {
     dataPanelOpen: import('vue').Ref<boolean, boolean>;
     formatInput: () => void;
     frameRef: import('vue').Ref<HTMLIFrameElement | null, HTMLIFrameElement | null>;

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

@@ -4,10 +4,12 @@ import { RenderExecutionOptions } from '../../../parser';
 export declare function usePreviewRenderer(options: {
     capture: (error: unknown) => unknown;
     frame: Ref<HTMLIFrameElement | null>;
+    onReady?(frame: HTMLIFrameElement, warnings: string[]): void;
     render: (input: Record<string, unknown>, execution?: RenderExecutionOptions) => Promise<{
         html: string;
         warnings: string[];
     }>;
+    timeoutMs?: number;
 }): {
     invalidate: () => void;
     loading: Ref<boolean, boolean>;

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

@@ -0,0 +1,33 @@
+import { PrintPreviewSource } from './print-preview-source';
+export declare function usePrintPreview(source: PrintPreviewSource, options?: {
+    onError?(error: unknown): void;
+    onReady?(frame: HTMLIFrameElement, warnings: string[]): void;
+    timeoutMs?: number;
+}): {
+    dataPanelOpen: import('vue').Ref<boolean, boolean>;
+    formatInput: () => void;
+    frameRef: import('vue').Ref<HTMLIFrameElement | null, HTMLIFrameElement | null>;
+    inputJson: import('vue').Ref<string, string>;
+    inputPending: import('vue').Ref<boolean, boolean>;
+    jsonErrorDetail: import('vue').Ref<string, string>;
+    jsonErrorKey: import('vue').Ref<string, string>;
+    loading: import('vue').Ref<boolean, boolean>;
+    printFrame: () => void;
+    refreshPreview: () => void;
+    renderError: import('vue').Ref<{
+        detail: string;
+    } | null, {
+        detail: string;
+    } | {
+        detail: string;
+    } | null>;
+    resetToSample: () => void;
+    resourceProgress: import('vue').Ref<{
+        loaded: number;
+        total: number;
+    } | null, import('../../../core/render/frame').FrameResourceProgress | {
+        loaded: number;
+        total: number;
+    } | null>;
+    warnings: import('vue').Ref<string[], string[]>;
+};

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

@@ -26,7 +26,6 @@ export declare function useTableDraft(getProps: () => Record<string, unknown>, o
     commit: () => void;
     draft: import('vue').Ref<{
         background: string;
-        borderColor?: string | undefined;
         borders: {
             bottom?: {
                 color: string;
@@ -65,7 +64,6 @@ export declare function useTableDraft(getProps: () => Record<string, unknown>, o
                 width: number;
             } | undefined;
         };
-        borderWidth?: number | undefined;
         boxHeightMm?: number | undefined;
         cellOverrides?: Record<string, import('../../../elements/table/table-style').TableCellOverride> | undefined;
         color: string;
@@ -260,7 +258,6 @@ export declare function useTableDraft(getProps: () => Record<string, unknown>, o
         };
     }, TableProps | {
         background: string;
-        borderColor?: string | undefined;
         borders: {
             bottom?: {
                 color: string;
@@ -299,7 +296,6 @@ export declare function useTableDraft(getProps: () => Record<string, unknown>, o
                 width: number;
             } | undefined;
         };
-        borderWidth?: number | undefined;
         boxHeightMm?: number | undefined;
         cellOverrides?: Record<string, import('../../../elements/table/table-style').TableCellOverride> | undefined;
         color: string;

package/designer/components/panels/layer-row-types.d.ts

@@ -0,0 +1,37 @@
+import { ElementGroup, ElementNode, RepeatGroup } from '../../../core/types';
+/** 图层面板行数据：图层组行或元素行（与 layers-panel 的 displayList 条目一致） */
+export type LayerRowData = {
+    depth: number;
+    group: ElementGroup;
+    key: string;
+    kind: 'group';
+} | {
+    depth: number;
+    group: null | RepeatGroup;
+    key: string;
+    kind: 'element';
+    node: ElementNode;
+};
+/**
+ * 行交互处理器集合：由 layers-panel 注入（拖拽 / 重命名状态在面板内），
+ * 使用稳定引用，减少父组件更新引起的行渲染。
+ */
+export interface LayerRowApi {
+    clearDragState(): void;
+    commitRename(): void;
+    execute(id: string, ...args: unknown[]): void;
+    isGroupSelected(group: ElementGroup): boolean;
+    onDragOver(event: DragEvent, row: LayerRowData): void;
+    onDragStart(row: LayerRowData): void;
+    onGroupClick(event: MouseEvent, group: ElementGroup): void;
+    onGroupContextMenu(event: MouseEvent, group: ElementGroup): void;
+    onRenameClick(context: {
+        e: MouseEvent;
+    }): void;
+    onRowClick(event: MouseEvent, node: ElementNode): void;
+    onRowContextMenu(event: MouseEvent, node: ElementNode): void;
+    setRenameInput(element: unknown): void;
+    startRename(node: ElementNode): void;
+    startRenameGroup(group: ElementGroup): void;
+    updateRenameText(value: string): void;
+}

package/designer/components/panels/layer-row.vue.d.ts

@@ -0,0 +1,17 @@
+import { LayerRowApi, LayerRowData } from './layer-row-types';
+/**
+ * 图层面板单行：图层组行与元素行。
+ * 选中 / 悬停 / 重命名等状态在行内以 computed 细粒度读取 store，
+ * 将选区依赖隔离到行组件，减少选区变化时的列表渲染。
+ * 交互处理器（点击 / 拖拽 / 重命名提交）由面板经 api 注入，逻辑保持单一来源。
+ */
+type __VLS_Props = {
+    api: LayerRowApi;
+    dropIndicator: Record<string, string>;
+    renameText: string;
+    renamingGroupId: null | string;
+    row: LayerRowData;
+};
+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/stage/marquee-overlay.vue.d.ts

@@ -0,0 +1,8 @@
+import { PageNode } from '../../../core/types';
+type __VLS_Props = {
+    page: PageNode;
+    pxPerMm: number;
+};
+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/stage/node-style.d.ts

@@ -0,0 +1,3 @@
+import { ElementNode } from '../../../core/types';
+/** 元素毫米几何 → 页面像素定位样式（选中框 / 成员高亮等覆盖层共用） */
+export declare function nodeBoxStyle(node: ElementNode, pxPerMm: number): Record<string, string>;

package/designer/components/stage/selection-member.vue.d.ts

@@ -0,0 +1,14 @@
+import { ElementNode, PageNode } from '../../../core/types';
+/**
+ * 多选成员高亮：点驱动元素画线高亮，其余画细边框。
+ * 按节点隔离渲染，成员几何和关键对象标记变化时仍保持响应。
+ */
+type __VLS_Props = {
+    isKey: boolean;
+    node: ElementNode;
+    page: PageNode;
+    pxPerMm: number;
+};
+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-theme.d.ts

@@ -0,0 +1,3 @@
+import { ThemeMode } from '../stores/types';
+/** 所有弹层挂载在当前文档中，与设计器共享 TDesign 的主题基线。 */
+export declare function useTheme(mode: () => ThemeMode, capture: (error: unknown) => unknown): void;

package/designer/facade/editing.d.ts

@@ -6,8 +6,8 @@ export declare function createEditingFacade(access: FacadeAccess): {
         copy: () => void;
         cut: () => void;
         delete: () => void;
-        /** 分布对象；'h' / 'v' 为旧版按中心点分布的简写 */
-        distribute: (mode: "h" | "v" | AlignMode, options?: AlignOptions) => void;
+        /** 按指定边缘或中心点分布对象。 */
+        distribute: (mode: AlignMode, options?: AlignOptions) => void;
         distributeSpacing: (direction: SpacingDirection, options?: DistributeSpacingOptions) => void;
         duplicate: () => void;
         nudge: (dx: number, dy: number) => void;