@dragcraft/designer 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-PRESENT hackycy <https://github.com/hackycy>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.mts

@@ -0,0 +1,502 @@
+import { AddNodePayload, BehaviorPredicate, Command, Command as Command$1, CommandExecutionResult, CommandHandler, CommandType, ContainerDefinition, ContainerVariantMigrationContext, ContainerVariantMigrationResult, CreatableBehaviorPredicate, CreatableBehaviorResult, CreatableDecision, CreationBlockReason, CreationBlockReason as CreationBlockReason$1, DeepReadonly as DeepReadonly$1, DesignerEngine, DesignerEngine as DesignerEngine$1, DesignerSchema, DesignerSchema as DesignerSchema$1, DragTarget, EngineOptions, EngineOptions as EngineOptions$1, EngineStore, EngineStore as EngineStore$1, EventName, HistoryEntry, HistoryState, InstanceBehaviorContext, MoveNodePayload, NodeDestination, PlacementDecision, RemoveNodePayload, SchemaNode, SchemaNode as SchemaNode$1, SetGlobalConfigPayload, TypeBehaviorContext, UpdatePropsPayload, WidgetActionConfig, WidgetMeta, WidgetMeta as WidgetMeta$1, createEngine, resolveBehavior, resolveCreatable } from "@dragcraft/core";
+import { ActionConfirmRequest, ActionDecision, ActionInterceptor, ActionInterceptor as ActionInterceptor$1, ActionInvocation, ActionKey, ActionRisk, ComponentMap, ComponentMap as ComponentMap$1, ConfirmActionInterceptorOptions, ContainerDropRejection, ContainerDropTarget, ContainerRegionOutlet, DeepReadonly, DefaultEmptyState, DefaultNodeHandle, DefaultNodeMask, DefaultNodeToolbar, EmptyStateProps, NodeActionContext, NodeActionDefinition, NodeActionDefinition as NodeActionDefinition$1, NodeActionRegistry, NodeActionRegistry as NodeActionRegistry$1, NodeHandleProps, NodeInteractionGeometry, NodeInteractionGeometryMode, NodeInteractionPresentation, NodeInteractionRect, NodeMaskProps, NodeToolbarOrientation, NodeToolbarPlacement, NodeToolbarProps, NodeWrapperProps, RendererEventHooks, RendererEventHooks as RendererEventHooks$1, RendererExtensions, RendererExtensions as RendererExtensions$1, RendererOptions, RendererWidgetActionExtra, RendererWidgetMeta, RendererWidgetMeta as RendererWidgetMeta$1, ResolveContainerDropIndexContext, ResolvedNodeAction, RootRenderer, UseNodeInteractionGeometryOptions, UseNodeInteractionGeometryReturn, WidgetActionConfig as RendererWidgetActionConfig, WidgetFallbackProps, createConfirmActionInterceptor, createDefaultActions, createNodeActionRegistry, useContainerRuntime, useNodeActions, useNodeDrag, useNodeInteractionGeometry, useWidgetNode } from "@dragcraft/renderer";
+import { Component, ComputedRef, InjectionKey, PropType, Ref, VNodeChild } from "vue";
+import { FlatMessages, I18N_KEY, I18nInstance, I18nInstance as I18nInstance$1, LocaleMessages, LocaleMessages as LocaleMessages$1, MessageTree, MessageTree as MessageTree$1, createI18n, useI18n } from "@dragcraft/i18n";
+import { FieldBindingScope, FieldBindingTarget, FieldChangePayload, FieldComponentMap, FieldComponentMap as FieldComponentMap$1, FieldSchema, FormGenerator, FormSchema, FormSchema as FormSchema$1, SectionSchema, ValidationRule } from "@dragcraft/form-generator";
+//#region src/bindings/field-binding.d.ts
+type FieldBinding = string | FieldBindingTarget | undefined;
+interface ResolvedFieldBinding {
+  scope: FieldBindingScope;
+  path: string;
+}
+declare function resolveFieldBinding(binding: FieldBinding, fallback: ResolvedFieldBinding): ResolvedFieldBinding;
+declare function readBindingValue(binding: ResolvedFieldBinding, schema: DeepReadonly$1<DesignerSchema$1>, node: DeepReadonly$1<SchemaNode$1> | null): unknown;
+declare function createBindingCommand(binding: ResolvedFieldBinding, value: unknown, nodeId?: string): Command$1 | null;
+//#endregion
+//#region src/components/DcCanvas.d.ts
+declare const _default: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/composables/useCanvasPan.d.ts
+type CanvasInteractionMode = 'pointer' | 'hand';
+//#endregion
+//#region src/components/DcCanvasControls.d.ts
+declare const _default$1: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  interactionMode: {
+    type: PropType<CanvasInteractionMode>;
+    required: true;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+  modeChange: (_mode: CanvasInteractionMode) => true;
+  resetView: () => true;
+}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  interactionMode: {
+    type: PropType<CanvasInteractionMode>;
+    required: true;
+  };
+}>> & Readonly<{
+  onModeChange?: ((_mode: CanvasInteractionMode) => any) | undefined;
+  onResetView?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/types.d.ts
+type DesignerWorkspaceMode = 'wide' | 'compact';
+interface DesignerWorkspaceOptions {
+  compactBreakpoint?: number;
+  defaultLeftOpen?: boolean;
+  defaultRightOpen?: boolean;
+  keyboardShortcuts?: boolean;
+  leftPanelWidth?: number;
+  rightPanelWidth?: number;
+  railWidth?: number;
+  drawerWidth?: number;
+}
+interface DesignerWorkspaceController {
+  readonly compactBreakpoint: number;
+  readonly keyboardShortcuts: boolean;
+  readonly leftPanelWidth: number;
+  readonly rightPanelWidth: number;
+  readonly railWidth: number;
+  readonly drawerWidth: number;
+  mode: Ref<DesignerWorkspaceMode>;
+  leftOpen: Ref<boolean>;
+  rightOpen: Ref<boolean>;
+  activeLeftPanel: Ref<LeftPanelTabKey>;
+  activeRightPanel: Ref<PropertyTabKey>;
+  setMode: (mode: DesignerWorkspaceMode) => void;
+  openLeft: (panel?: LeftPanelTabKey) => void;
+  closeLeft: () => void;
+  toggleLeft: (panel?: LeftPanelTabKey) => void;
+  openRight: (panel?: PropertyTabKey) => void;
+  closeRight: () => void;
+  toggleRight: (panel?: PropertyTabKey) => void;
+  closeDrawers: () => void;
+}
+interface DesignerEngineOptions extends EngineOptions$1 {
+  initialSchema?: DesignerSchema$1;
+}
+/**
+ * Widget group configuration with display title.
+ * Used by DcMaterialPanel to organize widgets into named groups.
+ */
+interface WidgetGroupConfig {
+  /** Group identifier (matches WidgetMeta.group) */
+  name: string;
+  /** Display title shown in the material panel */
+  title: string;
+  /** i18n message key for title; overrides `title` when i18n is active */
+  titleKey?: string;
+}
+type MaterialItemIcon = string | Component;
+/**
+ * Designer-owned display metadata for a widget in the material panel.
+ * Core registration remains UI-agnostic; this protocol only affects designer UI.
+ */
+interface MaterialDisplayMeta {
+  /** Material panel title override. Falls back to WidgetMeta.title/titleKey. */
+  title?: string;
+  /** i18n message key for material panel title. */
+  titleKey?: string;
+  /** Icon or Vue component shown in the material panel. Falls back to WidgetMeta.icon. */
+  icon?: MaterialItemIcon;
+  /** Short supporting copy for richer material cards. */
+  description?: string;
+  /** i18n message key for description. */
+  descriptionKey?: string;
+  /** Image URL for visual material cards. */
+  thumbnail?: string;
+  /** Compact labels shown by custom material item renderers. */
+  tags?: string[];
+  /** Additional search terms for the material panel. */
+  keywords?: string[];
+  /** App-specific display data for custom material item renderers. */
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Widget metadata accepted by designer. Extends renderer metadata with
+ * material-panel display information without coupling core to Vue UI.
+ */
+interface DesignerWidgetMeta extends RendererWidgetMeta$1 {
+  material?: MaterialDisplayMeta;
+}
+interface ResolvedMaterialItem {
+  title: string;
+  icon?: MaterialItemIcon;
+  description?: string;
+  thumbnail?: string;
+  tags: string[];
+  keywords: string[];
+}
+interface MaterialItemRenderProps {
+  meta: DesignerWidgetMeta;
+  material: ResolvedMaterialItem;
+  draggable: boolean;
+  disabled: boolean;
+  dragging: boolean;
+}
+/**
+ * Options accepted by createDesigner.
+ *
+ * Users must explicitly provide widget metas, component maps, and field maps.
+ */
+interface DesignerOptions {
+  /** Core engine options (initialSchema, maxHistorySize) */
+  engineOptions?: DesignerEngineOptions;
+  /** Widget metas to register with the engine */
+  widgetMetas?: DesignerWidgetMeta[];
+  /** Widget type → Vue component map for canvas rendering */
+  componentMap?: ComponentMap$1;
+  /** Widget group configurations for material panel. If not provided, groups are derived from registered widgets. */
+  widgetGroups?: WidgetGroupConfig[];
+  /** Field type → Vue component map for form-generator */
+  fieldComponentMap?: FieldComponentMap$1;
+  /** Global config form schema for the right panel Global tab */
+  globalConfigSchema?: FormSchema$1;
+  /** Extension point overrides */
+  extensions?: DesignerExtensions;
+  /** Renderer event hooks for selection, drag, and hover */
+  eventHooks?: RendererEventHooks$1;
+  /** Interceptors for node actions such as delete, move, duplicate, and custom actions */
+  actionInterceptors?: ActionInterceptor$1[];
+  /** Custom node action definitions to add or override default actions */
+  customActions?: NodeActionDefinition$1[];
+  /** Current locale (default: 'zh-CN') */
+  locale?: string;
+  /** Additional/override messages merged on top of designer and renderer defaults */
+  messages?: LocaleMessages$1;
+  /** Workbench layout and keyboard behavior. */
+  workspace?: DesignerWorkspaceOptions;
+}
+interface DesignerRailSlotAPI {
+  engine: DesignerEngine$1;
+  workspace: DesignerWorkspaceController;
+  t: I18nInstance$1['t'];
+}
+/**
+ * All available designer extension points.
+ */
+interface DesignerExtensions {
+  /** Completely replace the left material panel */
+  materialPanelRenderer?: Component;
+  /** Completely replace the right property panel */
+  propertyPanelRenderer?: Component;
+  /** Custom content renderer for a single material item. Designer owns the outer shell and drag behavior. */
+  materialItemRenderer?: (props: MaterialItemRenderProps) => VNodeChild;
+  /** Renderer extensions (dropIndicator) forwarded to @dragcraft/renderer */
+  rendererExtensions?: RendererExtensions$1;
+  /** Optional controls appended to the left sidebar rail. */
+  leftRailRenderer?: (api: DesignerRailSlotAPI) => VNodeChild;
+  /** Optional controls appended to the right sidebar rail. */
+  rightRailRenderer?: (api: DesignerRailSlotAPI) => VNodeChild;
+}
+/**
+ * The object returned by createDesigner().
+ * Holds the core engine and resolved configuration.
+ */
+interface DesignerInstance {
+  /** The underlying core engine */
+  engine: DesignerEngine$1;
+  /** Merged component map (default + extra) */
+  componentMap: ComponentMap$1;
+  /** Widget group configurations for material panel */
+  widgetGroups: WidgetGroupConfig[] | undefined;
+  /** Resolved designer extensions */
+  extensions: DesignerExtensions;
+  /** Override field component map for form-generator */
+  fieldComponentMap: FieldComponentMap$1 | undefined;
+  /** Global config form schema, if provided */
+  globalConfigSchema: FormSchema$1 | null;
+  /** Renderer event hooks */
+  eventHooks: RendererEventHooks$1;
+  /** Node action interceptors */
+  actionInterceptors: ActionInterceptor$1[];
+  /** Node action registry */
+  actionRegistry: NodeActionRegistry$1;
+  /** i18n instance for locale management */
+  i18n: I18nInstance$1;
+  workspace: DesignerWorkspaceController;
+  /** Dispose all resources */
+  dispose: () => void;
+}
+/**
+ * Internal context provided to all designer descendants via provide/inject.
+ */
+interface DesignerContext {
+  engine: DesignerEngine$1;
+  componentMap: ComponentMap$1;
+  widgetGroups: WidgetGroupConfig[] | undefined;
+  extensions: DesignerExtensions;
+  fieldComponentMap: FieldComponentMap$1 | undefined;
+  globalConfigSchema: FormSchema$1 | null;
+  eventHooks: RendererEventHooks$1;
+  actionInterceptors: ActionInterceptor$1[];
+  actionRegistry: NodeActionRegistry$1;
+  workspace: DesignerWorkspaceController;
+  activeDestination: Ref<NodeDestination | null>;
+  containerDropDecision: Ref<PlacementDecision | null>;
+  dragOverNodeId: Ref<string | null>;
+  dragOverIndex: Ref<number | null>;
+  handleMaterialDragStart: (e: DragEvent, meta: RendererWidgetMeta$1) => void;
+  handleDragEnd: (e: DragEvent) => void;
+  handleCanvasDragOver: (e: DragEvent) => void;
+  handleCanvasDragLeave: (e: DragEvent) => void;
+  handleCanvasDrop: (e: DragEvent) => CommandExecutionResult;
+  handleContainerDragOver: (payload: ContainerDropTarget | ContainerDropRejection) => void;
+  handleContainerDragLeave: (e: DragEvent) => void;
+  handleContainerDrop: (e: DragEvent) => CommandExecutionResult;
+  /** Whether the current drag-over is forbidden */
+  isForbidden: Ref<boolean>;
+  /** User-facing reason for the current forbidden drag-over state */
+  forbiddenReason: Ref<(CreationBlockReason$1 & {
+    details?: Record<string, unknown>;
+  }) | null>;
+  searchQuery: Ref<string>;
+  activeTab: Ref<PropertyTabKey>;
+  leftPanelActiveTab: Ref<LeftPanelTabKey>;
+}
+/**
+ * Injection key for the designer context.
+ */
+declare const DESIGNER_CONTEXT_KEY: InjectionKey<DesignerContext>;
+type PropertyTabKey = 'global' | 'widget';
+type LeftPanelTabKey = 'materials' | 'structure';
+/**
+ * Return type of useDesigner composable.
+ */
+interface UseDesignerReturn {
+  /** Reactive schema (from engine.store.schema ShallowRef) */
+  schema: EngineStore$1['schema'];
+  /** Currently selected node ID (reactive) */
+  selectedNodeId: EngineStore$1['selectedNodeId'];
+  /** Currently hovered node ID (reactive) */
+  hoveredNodeId: EngineStore$1['hoveredNodeId'];
+  /** Execute a command through the engine */
+  execute: DesignerEngine$1['execute'];
+  /** Undo last change */
+  undo: () => void;
+  /** Redo last undone change */
+  redo: () => void;
+  /** Whether undo is available */
+  canUndo: () => boolean;
+  /** Whether redo is available */
+  canRedo: () => boolean;
+  /** Import a full schema (replaces current) */
+  importSchema: (schema: DesignerSchema$1) => void;
+  /** Export current schema (deep clone) */
+  exportSchema: () => DesignerSchema$1;
+  /** Subscribe to engine events */
+  on: DesignerEngine$1['eventHub']['on'];
+  /** Unsubscribe from engine events */
+  off: DesignerEngine$1['eventHub']['off'];
+}
+//#endregion
+//#region src/components/DcDesigner.d.ts
+declare const _default$2: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  instance: {
+    type: PropType<DesignerInstance>;
+    required: true;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  instance: {
+    type: PropType<DesignerInstance>;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/components/DcLeftSidebar.d.ts
+declare const _default$3: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/components/DcMaterialGroup.d.ts
+declare const _default$4: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  title: {
+    type: PropType<string>;
+    required: true;
+  };
+  widgets: {
+    type: PropType<DesignerWidgetMeta[]>;
+    required: true;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  title: {
+    type: PropType<string>;
+    required: true;
+  };
+  widgets: {
+    type: PropType<DesignerWidgetMeta[]>;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/components/DcMaterialItem.d.ts
+declare const _default$5: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+  meta: {
+    type: PropType<DesignerWidgetMeta>;
+    required: true;
+  };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+  meta: {
+    type: PropType<DesignerWidgetMeta>;
+    required: true;
+  };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/components/DcMaterialPanel.d.ts
+declare const _default$6: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/components/DcPropertyPanel.d.ts
+declare const _default$7: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/components/DcRightSidebar.d.ts
+declare const _default$8: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/components/DcStructurePanel.d.ts
+declare const _default$9: import("vue").DefineComponent<{}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+  [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//#endregion
+//#region src/composables/useDesigner.d.ts
+/**
+ * Composable that provides reactive access to designer state and operations.
+ * Thin wrapper around the engine's reactive store and API.
+ *
+ * @example
+ * ```ts
+ * const designer = createDesigner()
+ * const { schema, selectedNodeId, undo, redo } = useDesigner(designer)
+ * ```
+ */
+declare function useDesigner(instance: DesignerInstance): UseDesignerReturn;
+//#endregion
+//#region src/composables/useDragDrop.d.ts
+interface UseDragDropReturn {
+  /** Unified root/container destination selected during drag-over. */
+  dragOverDestination: Ref<NodeDestination | null>;
+  /** Alias used by renderer container outlets. */
+  activeDestination: Ref<NodeDestination | null>;
+  /** Advisory placement decision for the active container destination. */
+  containerDropDecision: Ref<PlacementDecision | null>;
+  /** Compatibility projection for renderer extensions. */
+  dragOverNodeId: Ref<string | null>;
+  /** Compatibility projection for renderer extensions. */
+  dragOverIndex: Ref<number | null>;
+  /** Cached locked indices (recomputed only when schema changes) */
+  lockedIndices: ComputedRef<ReadonlySet<number>>;
+  /** Valid drop indices for the current drag operation */
+  validDropIndices: ComputedRef<ReadonlySet<number> | null>;
+  /** Start dragging a new widget from the material panel */
+  handleMaterialDragStart: (e: DragEvent, meta: RendererWidgetMeta$1) => void;
+  /** Handle dragover on the canvas (event delegation) */
+  handleCanvasDragOver: (e: DragEvent) => void;
+  /** Handle dragleave on the canvas (event delegation) */
+  handleCanvasDragLeave: (e: DragEvent) => void;
+  /** Handle drop on the canvas (event delegation) */
+  handleCanvasDrop: (e: DragEvent) => CommandExecutionResult;
+  /** Handle a material-resolved container destination or adapter rejection. */
+  handleContainerDragOver: (payload: ContainerDropTarget | ContainerDropRejection) => void;
+  /** Clear container feedback after leaving the active region. */
+  handleContainerDragLeave: (e: DragEvent) => void;
+  /** Commit the active container destination. */
+  handleContainerDrop: (e: DragEvent) => CommandExecutionResult;
+  /** Commit the current drag target to the current destination. */
+  commitDrop: () => CommandExecutionResult;
+  /** Handle drag end (cleanup) */
+  handleDragEnd: (e: DragEvent) => void;
+  /** Whether the current drag-over is forbidden */
+  isForbidden: Ref<boolean>;
+  /** User-facing reason for the current forbidden drag-over state */
+  forbiddenReason: Ref<DropRejectionReason | null>;
+}
+type DropRejectionReason = CreationBlockReason$1 & {
+  details?: Record<string, unknown>;
+};
+/**
+ * Coordinates HTML5 Drag and Drop between the material panel (drag source)
+ * and the canvas (drop target), bridging to core commands.
+ *
+ * Manages all drag-drop state including visual drop index computation
+ * and sortable constraint validation.
+ */
+declare function useDragDrop(engine: DesignerEngine$1): UseDragDropReturn;
+//#endregion
+//#region src/composables/usePropertyBinding.d.ts
+interface UsePropertyBindingOptions {
+  globalConfigSchema?: FormSchema$1 | null;
+  t?: (key: string, fallback?: string) => string;
+}
+interface UsePropertyBindingReturn {
+  /** The selected node, reactively derived */
+  selectedNode: ComputedRef<DeepReadonly$1<SchemaNode$1> | null>;
+  /** The form schema for the selected node's widget type */
+  selectedFormSchema: ComputedRef<FormSchema$1 | null>;
+  /** The selected widget meta */
+  selectedWidgetMeta: ComputedRef<WidgetMeta$1 | undefined>;
+  /** The current property values for the selected node */
+  selectedNodeProps: ComputedRef<Record<string, unknown>>;
+  /** The current values for the global config form */
+  globalConfigValues: ComputedRef<Record<string, unknown>>;
+  /** Handle property change from the form generator */
+  handlePropertyChange: (key: string, value: unknown) => CommandExecutionResult | null;
+  /** Handle global config change */
+  handleGlobalConfigChange: (key: string, value: unknown) => CommandExecutionResult | null;
+}
+/**
+ * Bridges the currently selected node's props and formSchema
+ * to the form-generator, and dispatches property updates as commands.
+ */
+declare function usePropertyBinding(engine: DesignerEngine$1, options?: UsePropertyBindingOptions): UsePropertyBindingReturn;
+//#endregion
+//#region src/context.d.ts
+/**
+ * Injects the DesignerContext from the nearest ancestor DcDesigner.
+ * Throws if called outside the designer component tree.
+ */
+declare function useDesignerContext(): DesignerContext;
+//#endregion
+//#region src/factory.d.ts
+/**
+ * Creates a designer instance by initializing the core engine,
+ * registering widgets, and resolving configuration.
+ *
+ * Users must explicitly provide widget metas, component maps, and field maps.
+ *
+ * @example
+ * ```ts
+ * const designer = createDesigner({
+ *   widgetMetas: myWidgetMetas,
+ *   componentMap: myComponentMap,
+ *   fieldComponentMap: myFieldComponentMap,
+ *   globalConfigSchema: myGlobalSchema,
+ * })
+ * ```
+ */
+declare function createDesigner(options?: DesignerOptions): DesignerInstance;
+//#endregion
+//#region src/material.d.ts
+type Translate = (key: string, fallback?: string) => string;
+declare function resolveMaterialItem(meta: DesignerWidgetMeta, t: Translate): ResolvedMaterialItem;
+declare function materialItemMatchesQuery(meta: DesignerWidgetMeta, material: ResolvedMaterialItem, query: string): boolean;
+//#endregion
+//#region src/messages.d.ts
+declare const designerMessages: Record<string, MessageTree$1>;
+//#endregion
+//#region src/workspace.d.ts
+declare function createDesignerWorkspace(options?: DesignerWorkspaceOptions): DesignerWorkspaceController;
+//#endregion
+export { type ActionConfirmRequest, type ActionDecision, type ActionInterceptor, type ActionInvocation, ActionKey, type ActionRisk, type AddNodePayload, type BehaviorPredicate, type Command, type CommandHandler, CommandType, type ComponentMap, type ConfirmActionInterceptorOptions, type ContainerDefinition, ContainerRegionOutlet, type ContainerVariantMigrationContext, type ContainerVariantMigrationResult, type CreatableBehaviorPredicate, type CreatableBehaviorResult, type CreatableDecision, type CreationBlockReason, DESIGNER_CONTEXT_KEY, _default as DcCanvas, _default$1 as DcCanvasControls, _default$2 as DcDesigner, _default$3 as DcLeftSidebar, _default$4 as DcMaterialGroup, _default$5 as DcMaterialItem, _default$6 as DcMaterialPanel, _default$7 as DcPropertyPanel, _default$8 as DcRightSidebar, _default$9 as DcStructurePanel, type DeepReadonly, DefaultEmptyState, DefaultNodeHandle, DefaultNodeMask, DefaultNodeToolbar, type DesignerContext, type DesignerEngine, type DesignerEngineOptions, type DesignerExtensions, type DesignerInstance, type DesignerOptions, type DesignerRailSlotAPI, type DesignerSchema, type DesignerWidgetMeta, type DesignerWorkspaceController, type DesignerWorkspaceMode, type DesignerWorkspaceOptions, type DragTarget, type EmptyStateProps, type EngineOptions, type EngineStore, EventName, type FieldBinding, type FieldChangePayload, type FieldComponentMap, type FieldSchema, type FlatMessages, FormGenerator, type FormSchema, type HistoryEntry, type HistoryState, I18N_KEY, type I18nInstance, type InstanceBehaviorContext, type LeftPanelTabKey, type LocaleMessages, type MaterialDisplayMeta, type MaterialItemIcon, type MaterialItemRenderProps, type MessageTree, type MoveNodePayload, type NodeActionContext, type NodeActionDefinition, type NodeActionRegistry, type NodeHandleProps, type NodeInteractionGeometry, type NodeInteractionGeometryMode, type NodeInteractionPresentation, type NodeInteractionRect, type NodeMaskProps, type NodeToolbarOrientation, type NodeToolbarPlacement, type NodeToolbarProps, type NodeWrapperProps, type PropertyTabKey, type RemoveNodePayload, type RendererEventHooks, type RendererExtensions, type RendererOptions, type RendererWidgetActionConfig, type RendererWidgetActionExtra, type RendererWidgetMeta, type ResolveContainerDropIndexContext, type ResolvedFieldBinding, type ResolvedMaterialItem, type ResolvedNodeAction, RootRenderer, type SchemaNode, type SectionSchema, type SetGlobalConfigPayload, type TypeBehaviorContext, type UpdatePropsPayload, type UseDesignerReturn, type UseDragDropReturn, type UseNodeInteractionGeometryOptions, type UseNodeInteractionGeometryReturn, type UsePropertyBindingReturn, type ValidationRule, type WidgetActionConfig, type WidgetFallbackProps, type WidgetGroupConfig, type WidgetMeta, createBindingCommand, createConfirmActionInterceptor, createDefaultActions, createDesigner, createDesignerWorkspace, createEngine, createI18n, createNodeActionRegistry, designerMessages, materialItemMatchesQuery, readBindingValue, resolveBehavior, resolveCreatable, resolveFieldBinding, resolveMaterialItem, useContainerRuntime, useDesigner, useDesignerContext, useDragDrop, useI18n, useNodeActions, useNodeDrag, useNodeInteractionGeometry, usePropertyBinding, useWidgetNode };