@hankchen/canvas-editor-vue 0.0.0-stage → 0.1.0

package/dist/property-panel/fields/ShorthandModeButton.d.ts

@@ -0,0 +1,13 @@
+import { ShorthandMode } from '../shorthand';
+type __VLS_Props = {
+    /** 当前模式（决定图标与文案） */
+    mode: ShorthandMode;
+    /** 领域名词，用于悬停文案（如「内边距」「边框」） */
+    label: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    cycle: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCycle?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLButtonElement>;
+export default _default;

package/dist/property-panel/fields/TextField.d.ts

@@ -0,0 +1,13 @@
+import { FieldDef } from '../fieldSchema';
+type __VLS_Props = {
+    field: FieldDef;
+    modelValue: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    input: (value: string) => any;
+    change: (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInput?: ((value: string) => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLInputElement>;
+export default _default;

package/dist/property-panel/fields/TextareaField.d.ts

@@ -0,0 +1,13 @@
+import { FieldDef } from '../fieldSchema';
+type __VLS_Props = {
+    field: FieldDef;
+    modelValue: string;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    input: (value: string) => any;
+    change: (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onInput?: ((value: string) => any) | undefined;
+    onChange?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLTextAreaElement>;
+export default _default;

package/dist/property-panel/fields/ValueTypeSegmented.d.ts

@@ -0,0 +1,10 @@
+type __VLS_Props = {
+    /** 当前取值方式（由图层 expression 标记派生：null → static） */
+    mode: 'static' | 'expression';
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: "expression" | "static") => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChange?: ((value: "expression" | "static") => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLSpanElement>;
+export default _default;

package/dist/property-panel/fields/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 字段控件域内出口：controls.ts 经此收集 <component :is> 动态分发的控件集。
+ * 控件不进包级公共出口——宿主消费面走属性面板域 barrel 或包根。
+ */
+export { default as AlignField } from './AlignField';
+export { default as AnchorDisclosureField } from './AnchorDisclosureField';
+export { default as BooleanField } from './BooleanField';
+export { default as BorderField } from './BorderField';
+export { default as ColorField } from './ColorField';
+export { default as FontField } from './FontField';
+export { default as NumberField } from './NumberField';
+export { default as PaddingField } from './PaddingField';
+export { default as PairField } from './PairField';
+export { default as SelectField } from './SelectField';
+export { default as TextField } from './TextField';
+export { default as TextareaField } from './TextareaField';

package/dist/property-panel/fontPicker.d.ts

@@ -0,0 +1,13 @@
+import { InjectionKey, Ref } from 'vue';
+import { FontCatalogEntry, UploadFile } from '@hankchen/canvas-editor';
+export interface FontPickerContext {
+    /** 字体清单（内置 + 自定义，响应式快照——上传追加后下拉实时联动） */
+    readonly entries: Ref<readonly FontCatalogEntry[]>;
+    /** 上传可用性（内核 canUpload：未注入 uploadHandler 即 false） */
+    readonly canUpload: boolean;
+    /** 本机字体 → 可物化引用（内核 uploadFont：引用入清单后返回） */
+    readonly uploadFont: (file: UploadFile) => Promise<string>;
+}
+export declare const FONT_PICKER_KEY: InjectionKey<FontPickerContext>;
+/** 控件 setup 内取注入缝；未注入返回 null（控件退化） */
+export declare function injectFontPicker(): FontPickerContext | null;

package/dist/property-panel/imageUpload.d.ts

@@ -0,0 +1,11 @@
+import { InjectionKey } from 'vue';
+import { UploadFile } from '@hankchen/canvas-editor';
+export interface ImageUploadContext {
+    /** 上传可用性（内核 canUpload：未注入 uploadHandler 即 false） */
+    readonly canUpload: boolean;
+    /** 本机图片 → 可物化引用（内核 uploadImage 裸上传：不建层不写文档） */
+    readonly uploadImage: (file: UploadFile) => Promise<string | null>;
+}
+export declare const IMAGE_UPLOAD_KEY: InjectionKey<ImageUploadContext>;
+/** 控件 setup 内取注入缝；未注入返回 null（控件退化） */
+export declare function injectImageUpload(): ImageUploadContext | null;

package/dist/property-panel/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 属性面板域出口：schema 驱动面板——字段描述注册表（fieldSchema）与领域类型、
+ * 面板组件与动态控件分发器、面板订阅切片桥（usePropertyPanel）、动态控件
+ * 注册表（controls）、Tailwind 类名常量（controlStyles，包内私有）、
+ * 字体清单注入缝（fontPicker）与图片上传注入缝（imageUpload）。字段控件集见 ./fields。
+ */
+export { CANVAS_FIELD_SECTIONS, FIELD_SECTIONS_BY_TYPE, fieldSectionsForPath, fieldSectionsForType, layerRoleAt, readField, type FieldControl, type FieldDef, type FieldReadResult, type FieldSection, type LayerRole, } from './fieldSchema';
+export { controlRegistry } from './controls';
+export { FONT_PICKER_KEY, injectFontPicker, type FontPickerContext } from './fontPicker';
+export { IMAGE_UPLOAD_KEY, injectImageUpload, type ImageUploadContext } from './imageUpload';
+export { usePropertyPanel, type PropertyPanelBinding } from './usePropertyPanel';
+export { default as PropertyField } from './PropertyField';
+export { default as PropertyPanel } from './PropertyPanel';

package/dist/property-panel/shorthand.d.ts

@@ -0,0 +1,28 @@
+import { Border, Padding } from '@hankchen/canvas-editor';
+/** 简写值模式：1 = 四边一框、2 = 上下|左右两框、4 = 四边各一框 */
+export type ShorthandMode = 1 | 2 | 4;
+/** 边名（Padding/Border 四键同名，两域共用一张框布局表） */
+export type SideName = 'top' | 'bottom' | 'left' | 'right';
+/** 一框 = 代表边（显示与输入取值）+ 收编边清单（提交时同写代表边值） */
+export interface ShorthandBox {
+    readonly label: string;
+    readonly rep: SideName;
+    readonly sides: readonly SideName[];
+}
+/** 各模式的框布局：1 = 四边一框（代表值上）；2 = 上下|左右（代表值上|左）；4 = 四框 */
+export declare const SHORTHAND_BOXES: Record<ShorthandMode, readonly ShorthandBox[]>;
+/** 循环次序 1→2→4→1（单按钮循环的唯一合法迁移） */
+export declare function nextShorthandMode(mode: ShorthandMode): ShorthandMode;
+/** 四值全等→1；上===下 且 左===右→2；否则→4（严格相等，浮点按原值比较） */
+export declare function derivePaddingMode(padding: Padding): ShorthandMode;
+/** 收缩写回规整：取代表值（上/左）折叠到目标模式的规整形态；4 = 原样 */
+export declare function shrinkPadding(padding: Padding, to: ShorthandMode): Padding;
+export declare function samePadding(a: Padding, b: Padding): boolean;
+/** 四边全 null 或全等→1；上下等且左右等（含 null 相等比较）→2；否则→4 */
+export declare function deriveBorderMode(border: Border): ShorthandMode;
+/**
+ * 收缩写回规整：上下取上、左右取左；收缩到 1 全取上——上为 null 即全 null
+ * （无边框）。每边发独立对象副本，不共享引用。
+ */
+export declare function shrinkBorder(border: Border, to: ShorthandMode): Border;
+export declare function sameBorder(a: Border, b: Border): boolean;

package/dist/property-panel/usePropertyPanel.d.ts

@@ -0,0 +1,51 @@
+import { ComputedRef } from 'vue';
+import { Canvas, EditorSession, Layer, LayerBox, LayerPath, ResourceStatusMap } from '@hankchen/canvas-editor';
+import { FieldDef, FieldSection } from './fieldSchema';
+import { CompletionSource } from '../shared/completion';
+export type { FieldDef, FieldSection } from './fieldSchema';
+export interface PropertyPanelBinding {
+    /** 当前选中路径；null = 画布级目标 */
+    readonly selection: ComputedRef<LayerPath | null>;
+    /** 选中层的领域对象切片；未选中 null */
+    readonly layer: ComputedRef<Layer | null>;
+    /** 文档画布（画布级字段读值）；未打开文档 null */
+    readonly canvas: ComputedRef<Canvas | null>;
+    /** 当前目标的字段组：选中层按 type/角色过滤，画布级为宽/高，无文档为空 */
+    readonly sections: ComputedRef<readonly FieldSection[]>;
+    /**
+     * 选中层的绝对盒（layer-panel-ux 工票 03）：EditorSession.layerBoxAt 的
+     * computed 切片，与画布 gizmo 同源——自适应高的禁用态显示值据此计算。
+     * 模板子树经 previewCanvas 解析为预览盒（isPreviewBox 驱动区分展示）。
+     */
+    readonly layerBox: ComputedRef<LayerBox | null>;
+    /** 选中路径是否落在模板子树（layerBoxAt 届时返回预览盒而非文档盒） */
+    readonly isPreviewBox: ComputedRef<boolean>;
+    /**
+     * 当前目标的补全候选源（content-completion 工单 05）：随选中路径切换上下文
+     * （根层 = 根候选集 / 模板格内容层 = 行候选集）；未注入声明为 null。
+     */
+    readonly completionSource: ComputedRef<CompletionSource | null>;
+    /**
+     * rowsPath 标记字段的补全候选源（rows-path-completion 工单 03）：起点三分流
+     * + 枚举器组装，「行数组」文案在此置入；未注入/判别降级为 null（零弹层）。
+     */
+    readonly rowsPathSource: ComputedRef<CompletionSource | null>;
+    /** 锚点折叠区开合（store ui 分支投影，会话内记忆；工票 03） */
+    readonly anchorExpanded: ComputedRef<boolean>;
+    /**
+     * 资源物化状态切片（placeholder-padding-hint 工单 02，store ui 分支投影）：
+     * 宿主从渲染端物化状态机桥接注入，padding 行占位态动态提示的物化维度事实源。
+     */
+    readonly resourceStatuses: ComputedRef<ResourceStatusMap>;
+    /** 面板唯一提交口：final = 收口提交（change/blur），否则按 mergeKey 合并累积 */
+    commit(field: FieldDef, value: unknown, final: boolean): void;
+    /**
+     * 数据字段取值方式切换（静态值/表达式，工单 02）：静态 → 表达式初值取当前
+     * 字面原文（不自动包裹/猜变量）；表达式 → 静态字面接管（值保持现镜像）。
+     * 各为独立一步历史；仅 data 字段且有选中目标时生效。
+     */
+    toggleDataMode(field: FieldDef): void;
+    /** 锚点折叠区开合（写 store ui 分支，不进历史） */
+    setAnchorExpanded(open: boolean): void;
+}
+export declare function usePropertyPanel(editor: EditorSession): PropertyPanelBinding;

package/dist/property-panel/useShorthandMode.d.ts

@@ -0,0 +1,18 @@
+import { ComputedRef } from 'vue';
+import { ShorthandMode } from './shorthand';
+export declare function useShorthandMode<T>(
+/** 模型值切片的 getter（引用比较决定覆盖是否失效） */
+getValue: () => T, 
+/** 初始/回落模式的数据推导（derivePaddingMode / deriveBorderMode） */
+derive: (value: T) => ShorthandMode): {
+    /** 当前生效模式：覆盖优先，回落推导 */
+    mode: ComputedRef<ShorthandMode>;
+    /**
+     * 循环 1→2→4→1 并登记覆盖；返回迁移前后模式——收缩（to < from）时的
+     * 取代表值写回规整由调用方提交（padding/border 形态不同，各自 emit）
+     */
+    cycle: () => {
+        from: ShorthandMode;
+        to: ShorthandMode;
+    };
+};