@hankchen/canvas-editor-vue 0.6.1 → 0.8.0

package/dist/layer-panel.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./layer-panel-Cz-tmbJJ.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./layer-panel-BouAYiDq.js";
 export { e as ADD_LAYER_MENU, a as ADD_MENU, s as ADD_RATIO_PRESET_MENU, t as ADD_TEXT_PRESET_MENU, c as LayerPanel, r as PANEL_ADD_MENU, n as TemplateTableForm, i as isUpperHalf, o as useLayerPanel };

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

@@ -14,8 +14,9 @@ type __VLS_Props = {
      */
     locked?: boolean;
     /**
-     * 补全候选源（面板按字段分发：data 门字段 = 表达式源，rowsPath 标记字段 =
-     * 行相对源，工单 03）；null = 未注入/无接线/降级（浮层恒闭）。
+     * 补全候选源（面板按字段分发：data 门 textarea 字段 = 表达式源；资源字段与
+     * rowsPath 点选器字段 = 选择器源，经 source 下发进控件）；null = 未注入/
+     * 无接线/降级（浮层恒闭、选择器无菜单）。
      */
     completion?: CompletionSource | null;
     /** pair 子字段的禁用态替代显示（键 = 子字段绝对键）；其他控件不传 */
@@ -30,6 +31,12 @@ type __VLS_Props = {
      * （缩略图角标，与画布失败标识同源）；undefined = 无记录/不适用。
      */
     resourceStatus?: ResourceStatus;
+    /**
+     * rowsPath 控件的漂移态（rows-path-picker 工单 03，spec D2）：面板按已提交
+     * 值判定（rowsPathDrifted）——true 时控件落 cn-field--invalid（红描边经
+     * fallthrough 到点选器展示框），菜单不受影响照常可开可重选。其他控件不下发。
+     */
+    drifted?: boolean;
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     input: (value: unknown) => any;

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

@@ -1,6 +1,6 @@
-import { Layer, LayerPath, LayerType, ResourceStatusMap } from '@hankchen/canvas-editor';
+import { Canvas, CanvasBackground, Layer, LayerPath, LayerType, ResourceStatusMap } from '@hankchen/canvas-editor';
 /** 控件种类（与 controls.ts 的组件注册表一一对应） */
-export type FieldControl = 'number' | 'text' | 'textarea' | 'color' | 'select' | 'boolean' | 'pair' | 'anchor' | 'align' | 'padding' | 'border' | 'font' | 'imageSrc' | 'resourceValue';
+export type FieldControl = 'number' | 'text' | 'textarea' | 'color' | 'select' | 'boolean' | 'pair' | 'anchor' | 'align' | 'padding' | 'border' | 'font' | 'imageSrc' | 'resourceValue' | 'rowsPath';
 /**
  * 自适应 prefix 钮描述（pair 子字段用）：key 相对 pair 值对象上的布尔键；
  * 开启 → 本输入禁用。placeholder 是禁用态兜底占位（盒未解析时；正常路径面板
@@ -39,13 +39,6 @@ export interface FieldDef {
      * 禁拼接/函数），不走片段级扫描诊断。图片地址/二维码值两类声明。
      */
     readonly resource?: true;
-    /**
-     * 补全标记门（rows-path-completion 工单 03，D6）：'rowsPath' = 裸路径补全
-     * （usePathCompletion，候选源 = 面板 rowsPathSource）——不走 data 门
-     * （rowsPath 是结构语义，表达式补全门不适用）；缺省 = 无标记（data 门字段
-     * 照走 useExpressionCompletion）。
-     */
-    readonly completion?: 'rowsPath';
     /** 输入框占位文案（text 控件透传） */
     readonly placeholder?: string;
     /**
@@ -65,6 +58,11 @@ export interface FieldDef {
     readonly nonEmpty?: boolean;
     /** select 取值域（领域常量原样引用，不自创缩写） */
     readonly domain?: readonly string[];
+    /**
+     * select 选项显示名（value → 标签，image-fit 工单 05「适配」）：缺省 = 原值
+     * 显示。值仍提交 wire 原值，文案只呈现
+     */
+    readonly optionLabels?: Readonly<Record<string, string>>;
     readonly min?: number;
     readonly max?: number;
     readonly step?: number;
@@ -107,8 +105,28 @@ export declare function pairItemKey(field: FieldDef, item: FieldDef): readonly s
  * 不输出（不渲染空标题）。
  */
 export declare function fieldSectionsForPath(path: LayerPath, layer: Layer): readonly FieldSection[];
-/** 画布级字段组（未选中图层时）：宽/高 */
+/**
+ * 画布级字段组（未选中图层时）：宽/高 + 背景区段（canvas-background 工单 04）。
+ * 背景字段键相对画布根（['background', color|image]），提交由面板折算回整对象
+ * 一步事务（usePropertyPanel）；背景静态（spec Q3）——imageSrc 不带 data 标记，
+ * 无取值方式段、无表达式态，上传缝在静态态展开全形态。
+ */
 export declare const CANVAS_FIELD_SECTIONS: readonly FieldSection[];
+/**
+ * 画布级读取视图（canvas-background 工单 04）：background null（未设/清空态）投影
+ * 为全空值对象——背景字段否则被 readField 的 ok:false 过滤掉，清空后区段即消失、
+ * 无法再设置。已设背景原样透出（不拷贝不重整）；未打开文档 null。
+ */
+export declare function canvasFieldTarget(canvas: Canvas | null): Canvas | null;
+/** 全空背景值对象（读取投影与提交折算共用的一份底形；kernel 归一门会再收口） */
+export declare const EMPTY_CANVAS_BACKGROUND: CanvasBackground;
+/**
+ * 图层级读取视图（image-fit 工单 05，canvasFieldTarget 同门）：ImageLayer 的 fit
+ * 缺省态（wire 无键 = cover）投影为 cover——适配字段否则被 readField 的 ok:false
+ * 过滤掉，选中任一未声明的图片层「适配」行即消失。已声明（含未知值）与非图片层
+ * 原样透传（不拷贝不重整）；投影只作用读侧，提交仍走 updateSpec 直写文档
+ */
+export declare function layerFieldTarget(layer: Layer): Layer;
 export type FieldReadResult = {
     ok: true;
     value: unknown;

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

@@ -0,0 +1,17 @@
+import { CompletionSource } from '../../shared/completion';
+import { FieldDef } from '../fieldSchema';
+type __VLS_Props = {
+    field: FieldDef;
+    modelValue: string;
+    /** 候选源（面板 rowsPathSource 注入缝）；null = 未绑声明，无菜单只读回显 */
+    source?: CompletionSource | null;
+    disabled?: boolean;
+};
+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, {}, any>;
+export default _default;

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

@@ -11,6 +11,7 @@ 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 RowsPathField } from './RowsPathField';
 export { default as SelectField } from './SelectField';
 export { default as TextField } from './TextField';
 export { default as TextareaField } from './TextareaField';

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

@@ -0,0 +1,9 @@
+/**
+ * 源图内在尺寸读数（image-fit 工单 05 搭车项，ADR 0023）：像素 + 宽高比一行文本，
+ * 作者判断 cover/contain 的直接依据。纯函数零 DOM——缩略图 img 装载完成后由
+ * 控件以 naturalWidth/naturalHeight 调用，Node 无 DOM 环境可测。
+ */
+/** 宽高比显示：整数比（约化后两侧 ≤32，如 16:9）优先，否则两位小数比（如 1.77:1） */
+export declare function aspectRatioLabel(width: number, height: number): string;
+/** 整行读数（「1920×1080 · 16:9」形态）；非法尺寸（≤0/非有限值）返回 null 不渲染 */
+export declare function intrinsicSizeLabel(width: number, height: number): string | null;

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

@@ -26,10 +26,19 @@ export interface PropertyPanelBinding {
      */
     readonly completionSource: ComputedRef<CompletionSource | null>;
     /**
-     * rowsPath 标记字段的补全候选源（rows-path-completion 工单 03）：起点三分流
-     * + 枚举器组装，「行数组」文案在此置入；未注入/判别降级为 null（零弹层）。
+     * rowsPath 字段的级联点选候选源（rows-path-picker 工单 03）：起点三分流判别
+     * （根层表 = 载荷根 schema；嵌套表 = 外层行 schema 行相对；判别降级 null）+
+     * 工单 01 剪枝枚举件按前缀供给（rowsPathPickerSource 组装，候选面剪枝至
+     * 「通往行数组的路径」）。起点 null = null 源（门态，菜单钮不渲染，spec D1）。
      */
     readonly rowsPathSource: ComputedRef<CompletionSource | null>;
+    /**
+     * 已提交 rowsPath 的漂移态（rows-path-picker 工单 03，spec D2）：模板表选中
+     * 态下按起点三分流判已提交值——枚举不出或终点非数组 = true（回显标红，菜单
+     * 照常可开可重选）；未绑声明/字段面外（非模板表目标）恒 false（门态弱提示
+     * 替代标红）。
+     */
+    readonly rowsPathDrifted: ComputedRef<boolean>;
     /** 锚点折叠区开合（store ui 分支投影，会话内记忆；工票 03） */
     readonly anchorExpanded: ComputedRef<boolean>;
     /**