@sepveneto/dnde 0.7.5 → 0.8.1

package/dist/{lib/App.vue.d.ts → App.vue.d.ts}

@@ -11,6 +11,15 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         readonly type: import("vue").PropType<Record<string, any>>;
         readonly default: () => {};
     };
+    readonly agent: BooleanConstructor;
+    readonly capabilities: {
+        readonly type: import("vue").PropType<any[]>;
+        readonly default: () => never[];
+    };
+    readonly workflows: {
+        readonly type: import("vue").PropType<any[]>;
+        readonly default: () => never[];
+    };
 }>, {
     validate(): Promise<void> | undefined;
 }, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
@@ -26,9 +35,21 @@ declare const _default: import("vue").DefineComponent<import("vue").ExtractPropT
         readonly type: import("vue").PropType<Record<string, any>>;
         readonly default: () => {};
     };
+    readonly agent: BooleanConstructor;
+    readonly capabilities: {
+        readonly type: import("vue").PropType<any[]>;
+        readonly default: () => never[];
+    };
+    readonly workflows: {
+        readonly type: import("vue").PropType<any[]>;
+        readonly default: () => never[];
+    };
 }>> & Readonly<{}>, {
     readonly name: string;
+    readonly agent: boolean;
     readonly widgets: import("./store").LikeWidget[];
     readonly extra: Record<string, any>;
+    readonly capabilities: any[];
+    readonly workflows: any[];
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/{lib/Editor.vue.d.ts → Editor.vue.d.ts}

@@ -12,6 +12,7 @@ declare const editor: import("pinia").Store<"editor", Pick<{
     selectedNodeOperates: Vue.ComputedRef<import("./type.js").HelperAction[]>;
     addNode: (node: import("@sepveneto/dnde-core/class").Node, pNode?: import("@sepveneto/dnde-core/class").Node, manual?: boolean) => void;
     delNode: (wid: string) => void;
+    setRoot: (node: import("@sepveneto/dnde-core/class").Node) => void;
     isPreview: Vue.Ref<boolean, boolean>;
     dragging: Vue.Ref<import("@sepveneto/dnde-core/class").Node | null, import("@sepveneto/dnde-core/class").Node | null>;
     plugins: {
@@ -47,6 +48,7 @@ declare const editor: import("pinia").Store<"editor", Pick<{
     selectedNodeOperates: Vue.ComputedRef<import("./type.js").HelperAction[]>;
     addNode: (node: import("@sepveneto/dnde-core/class").Node, pNode?: import("@sepveneto/dnde-core/class").Node, manual?: boolean) => void;
     delNode: (wid: string) => void;
+    setRoot: (node: import("@sepveneto/dnde-core/class").Node) => void;
     isPreview: Vue.Ref<boolean, boolean>;
     dragging: Vue.Ref<import("@sepveneto/dnde-core/class").Node | null, import("@sepveneto/dnde-core/class").Node | null>;
     plugins: {
@@ -82,6 +84,7 @@ declare const editor: import("pinia").Store<"editor", Pick<{
     selectedNodeOperates: Vue.ComputedRef<import("./type.js").HelperAction[]>;
     addNode: (node: import("@sepveneto/dnde-core/class").Node, pNode?: import("@sepveneto/dnde-core/class").Node, manual?: boolean) => void;
     delNode: (wid: string) => void;
+    setRoot: (node: import("@sepveneto/dnde-core/class").Node) => void;
     isPreview: Vue.Ref<boolean, boolean>;
     dragging: Vue.Ref<import("@sepveneto/dnde-core/class").Node | null, import("@sepveneto/dnde-core/class").Node | null>;
     plugins: {
@@ -104,7 +107,7 @@ declare const editor: import("pinia").Store<"editor", Pick<{
     getData: () => Record<string, any>;
     setData: (data: any) => void;
     setSchema: (schema: import("@sepveneto/dnde-core").IWidget["schema"]) => void;
-}, "selectNode" | "addNode" | "delNode" | "getData" | "setData" | "setSchema">>;
+}, "selectNode" | "addNode" | "delNode" | "setRoot" | "getData" | "setData" | "setSchema">>;
 declare const _default: Vue.DefineComponent<Vue.ExtractPropTypes<{
     readonly name: {
         readonly type: StringConstructor;
@@ -118,6 +121,15 @@ declare const _default: Vue.DefineComponent<Vue.ExtractPropTypes<{
         readonly type: Vue.PropType<Record<string, any>>;
         readonly default: () => {};
     };
+    readonly agent: BooleanConstructor;
+    readonly capabilities: {
+        readonly type: Vue.PropType<any[]>;
+        readonly default: () => never[];
+    };
+    readonly workflows: {
+        readonly type: Vue.PropType<any[]>;
+        readonly default: () => never[];
+    };
 }>, {
     register(fn: (ctx: typeof editor) => {
         init: () => void;
@@ -143,11 +155,23 @@ declare const _default: Vue.DefineComponent<Vue.ExtractPropTypes<{
         readonly type: Vue.PropType<Record<string, any>>;
         readonly default: () => {};
     };
+    readonly agent: BooleanConstructor;
+    readonly capabilities: {
+        readonly type: Vue.PropType<any[]>;
+        readonly default: () => never[];
+    };
+    readonly workflows: {
+        readonly type: Vue.PropType<any[]>;
+        readonly default: () => never[];
+    };
 }>> & Readonly<{
     onChange?: ((...args: any[]) => any) | undefined;
 }>, {
     readonly name: string;
+    readonly agent: boolean;
     readonly widgets: import("./store").LikeWidget[];
     readonly extra: Record<string, any>;
+    readonly capabilities: any[];
+    readonly workflows: any[];
 }, {}, {}, {}, string, Vue.ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/agents/context.d.ts

@@ -0,0 +1,14 @@
+import type { LayoutWidgetDescriptor } from './types';
+/**
+ * 把编辑器组件列表拍平成 Layout Agent 需要的描述。
+ *
+ * 输入可能是分组、Widget 实例或原始 IWidget，这里统一递归处理。
+ * 只有带 `agent` 描述的组件才会进入布局候选。
+ */
+export declare function toLayoutWidgets(widgets?: any[]): LayoutWidgetDescriptor[];
+/** 当前页面节点的轻量快照，供 Edit Agent 定位组件。 */
+export declare function snapshotNodes(nodes?: any[]): Array<{
+    wid: string;
+    type: string;
+    name: string;
+}>;

package/dist/agents/loader.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 可选 agent 能力的加载器。
+ *
+ * agent 被设计成独立的 web component（`<dnd-agent>`），编辑器自身**不**在构建期依赖
+ * `@sepveneto/dnde-agent`：业务侧不安装它也能正常打包、使用编辑器。
+ *
+ * 加载方式由宿主在 `register({ agent })` 时**显式注入**（通常是
+ * `() => import('@sepveneto/dnde-agent/element')`），这样业务侧的打包器才能正确解析依赖。
+ * 只开启 `agent` 却没注入、或依赖缺失时，会在控制台提示安装。
+ */
+/** agent web component 注册的标签名。 */
+export declare const AGENT_ELEMENT_TAG = "dnd-agent";
+/** 可选的 agent 依赖包名。 */
+export declare const AGENT_PACKAGE_NAME = "@sepveneto/dnde-agent";
+/** agent 的 web component 入口（注册 `<dnd-agent>`，并 re-export 库方法）。 */
+export declare const AGENT_ELEMENT_ENTRY = "@sepveneto/dnde-agent/element";
+/** 按需加载 agent 包的方式，宿主可以注入自定义实现（如走 import map / CDN）。 */
+export type AgentImporter = () => Promise<unknown>;
+/**
+ * 注入 agent 的加载方式，由 `register({ agent })` 调用。
+ *
+ * 传入 `undefined` 可清除（一般不需要）。注入后未完成的加载会被丢弃，允许用新的
+ * importer 重新加载。
+ */
+export declare function setAgentImporter(importer?: AgentImporter): void;
+/** `<dnd-agent>` 是否已经注册（业务侧自行 import 过该包时即为 true）。 */
+export declare function isAgentRegistered(tag?: string): boolean;
+/**
+ * 确保 agent web component 可用。
+ *
+ * - 已注册：直接返回 `true`；
+ * - 未注册：调用宿主注入的加载器，成功后返回 `true`；
+ * - 未注入加载器 / 依赖缺失 / 加载失败：在控制台提示安装，并返回 `false`。失败不会缓存，
+ *   业务侧后续补上依赖或注入后可以重新触发。
+ */
+export declare function loadAgent(tag?: string, importer?: AgentImporter | undefined): Promise<boolean>;

package/dist/agents/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Agent 相关的轻量类型定义。
+ *
+ * 这些结构本来来自可选的 `@sepveneto/dnde-agent` 包，但编辑器不应当强依赖它
+ * （业务侧可以不安装）。因此这里保留编辑器真正用到的字段做本地声明，
+ * 运行时由 agent web component 通过事件/属性传回，结构保持一致即可。
+ */
+/** 供 Layout Agent 选取组件的描述信息。 */
+export interface LayoutWidgetDescriptor {
+    typeId: string;
+    description: string;
+    layout: Record<string, any>;
+}
+/** Layout Agent 生成的一个组件片段。 */
+export interface LayoutWidgetItem {
+    widget: string;
+    items: Array<{
+        category: string;
+        id: any;
+    }>;
+}
+export type LayoutIR = LayoutWidgetItem[];
+export interface AddComponentIR {
+    type: 'add-component';
+    widget: string;
+    items: Array<Record<string, any>>;
+}
+export interface DeleteComponentIR {
+    type: 'delete-component';
+    target: string;
+}
+export interface UpdateComponentIR {
+    type: 'update-component';
+    target: string;
+    changes: Record<string, any>;
+}
+export interface MoveComponentIR {
+    type: 'move-component';
+    target: string;
+    before?: string;
+    after?: string;
+}
+/** Edit Agent 生成的单条编辑指令。 */
+export type EditIR = AddComponentIR | DeleteComponentIR | UpdateComponentIR | MoveComponentIR;

package/dist/{lib/components → components}/NodePlugin.vue.d.ts

@@ -13,6 +13,7 @@ declare const _default: import("vue").DefineComponent<{}, {
         selectedNodeOperates: import("vue").ComputedRef<HelperAction[]>;
         addNode: (node: import("@sepveneto/dnde-core/class").Node, pNode?: import("@sepveneto/dnde-core/class").Node, manual?: boolean) => void;
         delNode: (wid: string) => void;
+        setRoot: (node: import("@sepveneto/dnde-core/class").Node) => void;
         isPreview: import("vue").Ref<boolean, boolean>;
         dragging: import("vue").Ref<import("@sepveneto/dnde-core/class").Node | null, import("@sepveneto/dnde-core/class").Node | null>;
         plugins: {
@@ -48,6 +49,7 @@ declare const _default: import("vue").DefineComponent<{}, {
         selectedNodeOperates: import("vue").ComputedRef<HelperAction[]>;
         addNode: (node: import("@sepveneto/dnde-core/class").Node, pNode?: import("@sepveneto/dnde-core/class").Node, manual?: boolean) => void;
         delNode: (wid: string) => void;
+        setRoot: (node: import("@sepveneto/dnde-core/class").Node) => void;
         isPreview: import("vue").Ref<boolean, boolean>;
         dragging: import("vue").Ref<import("@sepveneto/dnde-core/class").Node | null, import("@sepveneto/dnde-core/class").Node | null>;
         plugins: {
@@ -83,6 +85,7 @@ declare const _default: import("vue").DefineComponent<{}, {
         selectedNodeOperates: import("vue").ComputedRef<HelperAction[]>;
         addNode: (node: import("@sepveneto/dnde-core/class").Node, pNode?: import("@sepveneto/dnde-core/class").Node, manual?: boolean) => void;
         delNode: (wid: string) => void;
+        setRoot: (node: import("@sepveneto/dnde-core/class").Node) => void;
         isPreview: import("vue").Ref<boolean, boolean>;
         dragging: import("vue").Ref<import("@sepveneto/dnde-core/class").Node | null, import("@sepveneto/dnde-core/class").Node | null>;
         plugins: {
@@ -105,7 +108,7 @@ declare const _default: import("vue").DefineComponent<{}, {
         getData: () => Record<string, any>;
         setData: (data: any) => void;
         setSchema: (schema: import("@sepveneto/dnde-core").IWidget["schema"]) => void;
-    }, "selectNode" | "addNode" | "delNode" | "getData" | "setData" | "setSchema">>;
+    }, "selectNode" | "addNode" | "delNode" | "setRoot" | "getData" | "setData" | "setSchema">>;
     ctx: import("@sepveneto/dnde-core").EditorContext;
     actionWrap: (action: HelperAction) => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
         [key: string]: any;

package/dist/composables/dragCore.d.ts

@@ -0,0 +1,69 @@
+import type { Node } from '@sepveneto/dnde-core/class';
+/** 拖拽逻辑作用的目标列表 */
+export interface DragTarget {
+    /** 当前列表（响应式数组） */
+    list: Node[];
+    /** 列表所属的父节点，根列表传 rootNode */
+    parent: Node;
+    /** 用新数组替换当前列表 */
+    setList: (list: Node[]) => void;
+}
+/** 拖拽逻辑需要的外部能力，由编辑器 store 提供 */
+export interface DragHost {
+    /** 跨容器拖动被撤销时，把节点还原回指定容器的指定位置 */
+    restoreToContainer: (containerId: string, index: number, node: Node) => void;
+    /** 把节点登记到目标父节点下 */
+    addNode: (node: Node, parent: Node) => void;
+}
+/** 只取逻辑用到的字段，便于在测试中构造 */
+export interface DragAddEvent {
+    newIndex: number;
+    newDraggableIndex: number;
+    oldIndex: number;
+    from: {
+        dataset: {
+            id?: string;
+        };
+    };
+    to: {
+        dataset: {
+            id?: string;
+        };
+    };
+}
+/**
+ * 找出列表中第一处重复出现的 wid。
+ *
+ * vuedraggable 在同级跨列表拖动时，会在目标列表里留下源列表的重复项，
+ * 靠这个函数定位需要清理的节点。
+ */
+export declare function findDuplicatedWid(list: Node[]): string | undefined;
+/**
+ * 该位置是否紧邻 fixed 节点（header 之后 / footer 之前都不允许插入）。
+ *
+ * 注意：入参是 `Widget.isFixed` 归一化之后的值，即 `meta.fixed: true` 会变成 `'header'`。
+ */
+export declare function isFixedBoundary(list: Node[], index: number): boolean;
+/**
+ * 计算跨列表拖动后应从后一个数组中移除的重复项下标。
+ *
+ * `originIndex` 是被拖动节点在原数组中的位置，用来判断它在新数组里是上移还是下移。
+ * 返回 -1 表示不删除（没有重复，或相邻是 fixed 边界需要保留）。
+ */
+export declare function resolveDuplicateRemovalIndex(current: Node[], next: Node[], wid: string, originIndex: number): number;
+/**
+ * 处理一次「放入」：
+ * - 落点紧邻 fixed 节点时撤销这次插入；
+ * - 跨容器拖动被撤销时，把节点还原回原容器；
+ * - 否则把节点登记到目标父节点下。
+ */
+export declare function handleNodeAdd(target: DragTarget, evt: DragAddEvent, host: DragHost): void;
+/**
+ * 处理列表更新：
+ * - 长度没有增加（同级重排）→ 直接整体替换；
+ * - 长度增加（跨列表拖动）→ 清理 vuedraggable 留下的重复项，
+ *   若重复项紧邻 fixed 边界则保留。
+ *
+ * `defer` 用于把清理后的写入推迟到下一个 tick（与 vuedraggable 的更新时机对齐）。
+ */
+export declare function handleNodeInput(target: DragTarget, val: Node[], defer: (fn: () => void) => void): void;

package/dist/composables/useNodeListDrag.d.ts

@@ -0,0 +1,15 @@
+import type { DraggableEvt } from '@/type';
+import type { Node } from '@sepveneto/dnde-core/class';
+import type { DragTarget } from './dragCore';
+export type NodeListDragTarget = DragTarget;
+/**
+ * 编辑区与大纲面板中所有可拖拽列表共用的拖拽处理。
+ *
+ * 逻辑本体在 `./dragCore`（不依赖 store / vue，便于单测），
+ * 这里只负责取 store 并接线。
+ */
+export declare function useNodeListDrag(target: NodeListDragTarget): {
+    onStart: (evt: DraggableEvt) => void;
+    onAdd: (evt: DraggableEvt) => void;
+    onInput: (val: Node[]) => void;
+};