@instructure/platform-block-content-editor 1.0.0 → 1.1.0

package/dist/editor/ai/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/constants.ts"],"names":[],"mappings":"AAkBA,iEAAiE;AACjE,eAAO,MAAM,mBAAmB;;;;CAItB,CAAA;AAEV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/editor/ai/index.d.ts

@@ -0,0 +1,7 @@
+export { BlockAIMenu, type BlockAIMenuProps } from './BlockAIMenu';
+export { PreviewBlockModal, type PreviewBlockModalProps } from './PreviewBlockModal';
+export { useGenerateAltText } from './useGenerateAltText';
+export { PREVIEW_BLOCK_VIEWS, type PreviewBlockView } from './constants';
+export { type DesignerAITranslations, DesignerAIEnglish } from './aiTranslations';
+export type { AIInlineTemplateContentPayload } from './aiTypes';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/ai/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/index.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,EAAE,KAAK,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACjF,YAAY,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAA"}

package/dist/editor/ai/useBlockAIPopover.d.ts

@@ -0,0 +1,30 @@
+interface UseBlockAIPopoverProps {
+    componentType: string;
+    componentData: Record<string, unknown>;
+    componentId?: string;
+    onApply: (newProps: Record<string, unknown>) => void;
+    onClose: () => void;
+}
+/**
+ * The shared brain behind the block-level AI menu: prompt/thinking/preview state, aborting, and
+ * the AI-action call plus its response extraction. Host-agnostic — it reads the injected
+ * `useAIAction()` seam (the host closes over course/chat context) and preserves the abort signal
+ * for `handleStop`. If no seam is provided it is inert.
+ */
+export declare const useBlockAIPopover: ({ componentType, componentData, componentId, onApply, onClose, }: UseBlockAIPopoverProps) => {
+    prompt: string;
+    setPrompt: import('react').Dispatch<import('react').SetStateAction<string>>;
+    isThinking: boolean;
+    error: string | null;
+    clearError: () => void;
+    previewFirst: boolean;
+    setPreviewFirst: import('react').Dispatch<import('react').SetStateAction<boolean>>;
+    pendingProps: Record<string, unknown> | null;
+    handleSend: (instruction?: string) => Promise<void>;
+    handleStop: () => void;
+    handleRegenerate: (refinementText: string) => Promise<void>;
+    handleApply: () => void;
+    handleCancelPreview: () => void;
+};
+export {};
+//# sourceMappingURL=useBlockAIPopover.d.ts.map

package/dist/editor/ai/useBlockAIPopover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBlockAIPopover.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/useBlockAIPopover.ts"],"names":[],"mappings":"AAyBA,UAAU,sBAAsB;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACpD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,kEAM/B,sBAAsB;;;;;;;;;+BAoDiB,MAAM;;uCAwBE,MAAM;;;CAgDvD,CAAA"}

package/dist/editor/ai/useGenerateAltText.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generates image alt text via the injected AI-action seam: reads a `File`/`Blob` to base64 and
+ * sends the `generate_alt_text` tool, returning the `alt_text` string. Reports failure through
+ * `error` rather than throwing. Inert (returns null) when no seam is provided.
+ */
+export declare function useGenerateAltText(): {
+    isLoading: boolean;
+    error: string | null;
+    generateAltText: (file: File | Blob) => Promise<string | null>;
+};
+//# sourceMappingURL=useGenerateAltText.d.ts.map

package/dist/editor/ai/useGenerateAltText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGenerateAltText.d.ts","sourceRoot":"","sources":["../../../src/editor/ai/useGenerateAltText.ts"],"names":[],"mappings":"AAmDA;;;;GAIG;AACH,wBAAgB,kBAAkB;;;4BAMK,IAAI,GAAG,IAAI,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;EAyC1E"}

package/dist/editor/canvas/DesignerArea.d.ts

@@ -0,0 +1,38 @@
+import { RefObject } from 'react';
+import { BlockRegistry, LayoutNode, TemplateData } from '../../registry';
+import { TrayDropTarget, TreePath } from '../document/utils';
+export interface DesignerAreaProps {
+    /** The layout tree to author. */
+    templateLayout: LayoutNode[];
+    /** Content props keyed by node id. */
+    templateData: TemplateData;
+    /** The registry the document's blocks resolve against. */
+    componentRegistry: BlockRegistry;
+    /** The engine's selected component id (drives the selection chrome). */
+    selectedComponentId: string | null;
+    /** Commit a new layout (e.g. `useBlockEditorState().changeLayout`). */
+    onLayoutChange: (layout: LayoutNode[]) => void;
+    /** A block was selected on the canvas. */
+    onSelectComponent: (id: string | undefined, path: TreePath) => void;
+    /** Add a block from a tray drop (e.g. `useBlockEditorState().addComponent`). */
+    onAddComponent?: (componentType: string, dropTarget?: TrayDropTarget, propsOverride?: Record<string, unknown>) => void;
+    /** Delete a block (e.g. `useBlockEditorState().deleteComponent`). */
+    onDeleteNode?: (nodeId: string) => void;
+    /** Duplicate a block (e.g. `useBlockEditorState().duplicateComponent`). */
+    onDuplicateNode?: (nodeId: string) => void;
+    /** Apply AI-generated props to a block. Accepted now; wired in a later step. */
+    onAIApply?: (nodeId: string, newProps: Record<string, unknown>) => void;
+    /** Optional external ref to the canvas content element, so an orchestrator can wire the
+     * canvas↔panel selection-focus coordination (`useDesignerSelectionFocus`). */
+    canvasRef?: RefObject<HTMLDivElement>;
+}
+/**
+ * The drag-and-drop authoring surface, self-contained with its own DnD context. Renders a
+ * document from the engine and commits edits back through the callbacks the orchestrator
+ * supplies (it holds no editor state itself, so the canvas and the settings form stay
+ * independent). This is the standalone convenience: `GridDndProvider` + `DesignerCanvas`. A
+ * host that wants tray drag sources to reach the canvas across a shared context composes
+ * `GridDndProvider` around both the sidebar and a bare `DesignerCanvas` instead.
+ */
+export declare function DesignerArea({ templateLayout, templateData, componentRegistry, selectedComponentId, onLayoutChange, onSelectComponent, onAddComponent, onDeleteNode, onDuplicateNode, onAIApply, canvasRef: externalCanvasRef, }: DesignerAreaProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DesignerArea.d.ts.map

package/dist/editor/canvas/DesignerArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignerArea.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/DesignerArea.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,SAAS,EAAU,MAAM,OAAO,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIjE,MAAM,WAAW,iBAAiB;IAChC,iCAAiC;IACjC,cAAc,EAAE,UAAU,EAAE,CAAA;IAC5B,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAA;IAC1B,0DAA0D;IAC1D,iBAAiB,EAAE,aAAa,CAAA;IAChC,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,uEAAuE;IACvE,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,IAAI,CAAA;IAC9C,0CAA0C;IAC1C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnE,gFAAgF;IAChF,cAAc,CAAC,EAAE,CACf,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,cAAc,EAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACpC,IAAI,CAAA;IACT,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACvE;kFAC8E;IAC9E,SAAS,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAA;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAC3B,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,eAAe,EACf,SAAS,EACT,SAAS,EAAE,iBAAiB,GAC7B,EAAE,iBAAiB,2CA2BnB"}

package/dist/editor/canvas/DesignerCanvas.d.ts

@@ -0,0 +1,35 @@
+import { RefObject } from 'react';
+import { BlockRegistry, LayoutNode, TemplateData } from '../../registry';
+import { TreePath } from '../document/utils';
+export interface DesignerCanvasProps {
+    /** The layout tree to author. */
+    templateLayout: LayoutNode[];
+    /** Content props keyed by node id. */
+    templateData: TemplateData;
+    /** The registry the document's blocks resolve against. */
+    componentRegistry: BlockRegistry;
+    /** The engine's selected component id (drives the selection chrome). */
+    selectedComponentId: string | null;
+    /** Commit a new layout (e.g. `useBlockEditorState().changeLayout`). */
+    onLayoutChange: (layout: LayoutNode[]) => void;
+    /** A block was selected on the canvas. */
+    onSelectComponent: (id: string | undefined, path: TreePath) => void;
+    /** Delete a block (e.g. `useBlockEditorState().deleteComponent`). */
+    onDeleteNode?: (nodeId: string) => void;
+    /** Duplicate a block (e.g. `useBlockEditorState().duplicateComponent`). */
+    onDuplicateNode?: (nodeId: string) => void;
+    /** Apply AI-generated props to a block. */
+    onAIApply?: (nodeId: string, newProps: Record<string, unknown>) => void;
+    /** Optional external ref to the canvas content element, so an orchestrator can wire the
+     * canvas↔panel selection-focus coordination (`useDesignerSelectionFocus`). */
+    canvasRef?: RefObject<HTMLDivElement>;
+}
+/**
+ * The authoring canvas *without* its own DnD context. It reads DnD state from an ambient
+ * `GridDndProvider`, so it must render inside one — `DesignerArea` supplies its own, and an
+ * orchestrator that shares one context across canvas + sidebar hoists the provider above both
+ * and renders this. Turns on `DesignerModeContext` for the blocks it renders (its one owned
+ * piece of context); brand color, block data and translations come from the host's providers.
+ */
+export declare function DesignerCanvas({ templateLayout, templateData, componentRegistry, selectedComponentId, onLayoutChange, onSelectComponent, onDeleteNode, onDuplicateNode, onAIApply, canvasRef: externalCanvasRef, }: DesignerCanvasProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DesignerCanvas.d.ts.map

package/dist/editor/canvas/DesignerCanvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignerCanvas.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/DesignerCanvas.tsx"],"names":[],"mappings":"AAkBA,OAAO,EAAE,KAAK,SAAS,EAAU,MAAM,OAAO,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAIjD,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,cAAc,EAAE,UAAU,EAAE,CAAA;IAC5B,sCAAsC;IACtC,YAAY,EAAE,YAAY,CAAA;IAC1B,0DAA0D;IAC1D,iBAAiB,EAAE,aAAa,CAAA;IAChC,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,uEAAuE;IACvE,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,IAAI,CAAA;IAC9C,0CAA0C;IAC1C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnE,qEAAqE;IACrE,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,2EAA2E;IAC3E,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,2CAA2C;IAC3C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACvE;kFAC8E;IAC9E,SAAS,CAAC,EAAE,SAAS,CAAC,cAAc,CAAC,CAAA;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,SAAS,EACT,SAAS,EAAE,iBAAiB,GAC7B,EAAE,mBAAmB,2CAqBrB"}

package/dist/editor/canvas/DropGridOverlay.d.ts

@@ -0,0 +1,24 @@
+import { ReactElement } from 'react';
+import { LayoutNode } from '../../registry';
+export interface GridCell {
+    column: number;
+    row: number;
+}
+export interface OccupiedCell extends GridCell {
+    columnSpan: number;
+    rowSpan: number;
+}
+export interface DesignerGridOverlayProps {
+    /** Number of columns in the grid. */
+    columns: number;
+    /** Number of rows to show (defaults to 10). */
+    rows?: number;
+    /** Layout used to determine which cells are occupied. */
+    templateLayout: LayoutNode[];
+    /** Whether to show the overlay (typically during a drag). */
+    visible: boolean;
+}
+/** Shows droppable cells for every empty grid position during a drag. */
+export declare const DesignerGridOverlay: ({ columns, rows, templateLayout, visible, }: DesignerGridOverlayProps) => ReactElement[] | null;
+export default DesignerGridOverlay;
+//# sourceMappingURL=DropGridOverlay.d.ts.map

package/dist/editor/canvas/DropGridOverlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropGridOverlay.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/DropGridOverlay.tsx"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,KAAK,EAAqB,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAGnE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;CAChB;AAoCD,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAA;IACf,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,yDAAyD;IACzD,cAAc,EAAE,UAAU,EAAE,CAAA;IAC5B,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,yEAAyE;AACzE,eAAO,MAAM,mBAAmB,GAAI,6CAKjC,wBAAwB,KAAG,YAAY,EAAE,GAAG,IA+B9C,CAAA;AAED,eAAe,mBAAmB,CAAA"}

package/dist/editor/canvas/GridDndContext.d.ts

@@ -0,0 +1,11 @@
+import { SortableInsertTarget } from '../document/utils';
+/** DnD state shared from the provider down to the canvas without prop drilling. */
+export interface GridDndContextValue {
+    activeId: string | null;
+    isSortingContainer: boolean;
+    numRows: number;
+    trayInsertTarget: SortableInsertTarget | null;
+}
+export declare const GridDndContext: import('react').Context<GridDndContextValue | null>;
+export declare function useGridDndContext(): GridDndContextValue;
+//# sourceMappingURL=GridDndContext.d.ts.map

package/dist/editor/canvas/GridDndContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridDndContext.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/GridDndContext.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAE7D,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,oBAAoB,GAAG,IAAI,CAAA;CAC9C;AAED,eAAO,MAAM,cAAc,qDAAkD,CAAA;AAE7E,wBAAgB,iBAAiB,IAAI,mBAAmB,CAMvD"}

package/dist/editor/canvas/GridDndProvider.d.ts

@@ -0,0 +1,17 @@
+import { ReactNode, RefObject } from 'react';
+import { BlockRegistry, LayoutNode, TemplateData } from '../../registry';
+import { TrayDropTarget } from '../document/utils';
+export interface GridDndProviderProps {
+    templateLayout: LayoutNode[];
+    templateData: TemplateData;
+    componentRegistry: BlockRegistry;
+    onLayoutChange: (layout: LayoutNode[]) => void;
+    /** Optional callback for handling tray component drops. */
+    onAddFromTray?: (componentType: string, dropTarget?: TrayDropTarget, propsOverride?: Record<string, unknown>) => void;
+    /** The canvas content element, used to cancel drops that leave the canvas. */
+    canvasRef?: RefObject<HTMLElement | null>;
+    children: ReactNode;
+}
+/** The single `DndContext` for the designer, wiring `useGridDnd` in and rendering the overlays. */
+export declare function GridDndProvider({ templateLayout, templateData, componentRegistry, onLayoutChange, onAddFromTray, canvasRef, children, }: GridDndProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=GridDndProvider.d.ts.map

package/dist/editor/canvas/GridDndProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridDndProvider.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/GridDndProvider.tsx"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAE7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAKvD,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,UAAU,EAAE,CAAA;IAC5B,YAAY,EAAE,YAAY,CAAA;IAC1B,iBAAiB,EAAE,aAAa,CAAA;IAChC,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,IAAI,CAAA;IAC9C,2DAA2D;IAC3D,aAAa,CAAC,EAAE,CACd,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,cAAc,EAC3B,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACpC,IAAI,CAAA;IACT,8EAA8E;IAC9E,SAAS,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;IACzC,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,EAC9B,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,SAAS,EACT,QAAQ,GACT,EAAE,oBAAoB,2CAmDtB"}

package/dist/editor/canvas/GridItemChild.d.ts

@@ -0,0 +1,44 @@
+import { ReactNode } from 'react';
+import { BlockRegistry } from '../../registry';
+import { DesignerItemAction } from '../document/designerItemAction';
+export interface DesignerItemUIProps {
+    children: ReactNode;
+    componentType: string;
+    /** Human-readable label for the component-type chip. */
+    componentTypeLabel?: string;
+    /** Component instance id, applied as `data-designer-item-id` for focus management. */
+    componentId?: string;
+    /** Whether this item is the engine's selected component (drives `data-selected`). */
+    isSelected?: boolean;
+    /** Whether any drag is active (hides the toolbar globally during a drag). */
+    isAnyDragActive?: boolean;
+    dragDisabled?: boolean;
+    onEditClick: (e: {
+        stopPropagation: () => void;
+    }) => void;
+    onDuplicateClick: (e: {
+        stopPropagation: () => void;
+    }) => void;
+    /** Current component data, passed to the AI menu as the "before" content. */
+    componentData?: Record<string, unknown>;
+    /** Callback when AI applies new props to this block. */
+    onAIApply?: (newProps: Record<string, unknown>) => void;
+    /** Composed by the host — passed to the AI menu to render the before/after preview + resolve. */
+    componentRegistry?: BlockRegistry;
+    /** Callback when delete is confirmed via the popover. */
+    onDeleteConfirm?: () => void;
+    /** Ref and props for the drag handle (from `useSortable`). */
+    dragHandleProps?: Record<string, unknown>;
+    /**
+     * Toolbar actions to hide for this item. Lets a host tailor the toolbar to the block —
+     * e.g. a data-driven widget hides "edit", "ai" and "duplicate", leaving move and delete.
+     */
+    hiddenActions?: DesignerItemAction[];
+    /** Host permission to edit content — gates move / duplicate / the edit overlay. */
+    canEditContent?: boolean;
+    /** Host permission to delete content — gates the delete action. */
+    canDeleteContent?: boolean;
+}
+export declare const DesignerItemUI: import('react').ForwardRefExoticComponent<DesignerItemUIProps & import('react').RefAttributes<HTMLDivElement>>;
+export default DesignerItemUI;
+//# sourceMappingURL=GridItemChild.d.ts.map

package/dist/editor/canvas/GridItemChild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridItemChild.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/GridItemChild.tsx"],"names":[],"mappings":"AAmCA,OAAO,EAAc,KAAK,SAAS,EAAyB,MAAM,OAAO,CAAA;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAInE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,SAAS,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,sFAAsF;IACtF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qFAAqF;IACrF,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,WAAW,EAAE,CAAC,CAAC,EAAE;QAAE,eAAe,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IACzD,gBAAgB,EAAE,CAAC,CAAC,EAAE;QAAE,eAAe,EAAE,MAAM,IAAI,CAAA;KAAE,KAAK,IAAI,CAAA;IAC9D,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACvD,iGAAiG;IACjG,iBAAiB,CAAC,EAAE,aAAa,CAAA;IACjC,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,8DAA8D;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC;;;OAGG;IACH,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACpC,mFAAmF;IACnF,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,cAAc,gHA2L1B,CAAA;AAID,eAAe,cAAc,CAAA"}

package/dist/editor/canvas/GridItemContainer.d.ts

@@ -0,0 +1,49 @@
+import { ReactNode } from 'react';
+import { BlockRegistry, LayoutNode } from '../../registry';
+import { TreePath } from '../document/utils';
+import { DesignerItemAction } from '../document/designerItemAction';
+export interface DesignerItemProps {
+    /** The layout node this item represents. */
+    node: LayoutNode;
+    /** Path to this node in the tree. */
+    path: TreePath;
+    /** Depth in the tree (0 = root). */
+    depth: number;
+    /** Callback when the item is selected. */
+    onSelect: (id: string | undefined, path: TreePath) => void;
+    /** The rendered block. */
+    children: ReactNode;
+    /** Already-translated label for the component-type chip (from the registry entry). */
+    componentTypeLabel?: string;
+    /** Whether this item is the engine's selected component. */
+    isSelected?: boolean;
+    /** Whether drag/drop is disabled. */
+    disabled?: boolean;
+    /** Whether any drag is active (hides toolbars globally). */
+    isAnyDragActive?: boolean;
+    /** The currently dragged item id (used to hide the item in disabled mode). */
+    activeId?: string | null;
+    /** Show a dashed placeholder above this item for an incoming tray drop. */
+    showTrayGapAbove?: boolean;
+    /** Height of the placeholder box shown above this item. */
+    trayGapHeight?: number;
+    /** Callback to delete this node from the layout. */
+    onDeleteNode?: (nodeId: string) => void;
+    /** Callback to duplicate this node. */
+    onDuplicateNode?: (nodeId: string) => void;
+    /** Current component data, passed through to the (later) AI popover. */
+    componentData?: Record<string, unknown>;
+    /** Callback when AI applies new props to this node. */
+    onAIApply?: (nodeId: string, newProps: Record<string, unknown>) => void;
+    /** Composed by the host — passed to the block's AI menu to render the before/after preview. */
+    componentRegistry?: BlockRegistry;
+    /** Toolbar actions to hide for this item. */
+    hiddenActions?: DesignerItemAction[];
+    /** Host permission to edit content. */
+    canEditContent?: boolean;
+    /** Host permission to delete content. */
+    canDeleteContent?: boolean;
+}
+export declare const DesignerItem: ({ node, path, depth, onSelect, children, componentTypeLabel, isSelected, disabled, isAnyDragActive, activeId, showTrayGapAbove, trayGapHeight, onDeleteNode, onDuplicateNode, componentData, onAIApply, componentRegistry, hiddenActions, canEditContent, canDeleteContent, }: DesignerItemProps) => import("react/jsx-runtime").JSX.Element;
+export default DesignerItem;
+//# sourceMappingURL=GridItemContainer.d.ts.map

package/dist/editor/canvas/GridItemContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridItemContainer.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/GridItemContainer.tsx"],"names":[],"mappings":"AA0BA,OAAO,EAAsB,KAAK,SAAS,EAAgC,MAAM,OAAO,CAAA;AACxF,OAAO,KAAK,EAAE,aAAa,EAAqB,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAClF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAIxE,MAAM,WAAW,iBAAiB;IAChC,4CAA4C;IAC5C,IAAI,EAAE,UAAU,CAAA;IAChB,qCAAqC;IACrC,IAAI,EAAE,QAAQ,CAAA;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IAC1D,0BAA0B;IAC1B,QAAQ,EAAE,SAAS,CAAA;IACnB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,oDAAoD;IACpD,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,uCAAuC;IACvC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,uDAAuD;IACvD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACvE,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,aAAa,CAAA;IACjC,6CAA6C;IAC7C,aAAa,CAAC,EAAE,kBAAkB,EAAE,CAAA;IACpC,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,YAAY,GAAI,+QAqB1B,iBAAiB,4CAgHnB,CAAA;AAED,eAAe,YAAY,CAAA"}

package/dist/editor/canvas/GridViewer.d.ts

@@ -0,0 +1,114 @@
+import { Announcements, CollisionDetection, DragEndEvent, DragMoveEvent, DragOverEvent, DragStartEvent, useSensors } from '@dnd-kit/core';
+import { SortingStrategy } from '@dnd-kit/sortable';
+import { RefObject } from 'react';
+import { BlockRegistry, LayoutNode, TemplateData } from '../../registry';
+import { SortableInsertTarget, TrayDropTarget, TreePath } from '../document/utils';
+export declare const DEFAULT_BLOCK_HEIGHT = 60;
+export declare const gridSortingStrategy: SortingStrategy;
+/**
+ * Sorting strategy for a tray item being inserted (not yet in the tree). Unlike
+ * `gridSortingStrategy` — which relocates an existing item — there's no slot being vacated,
+ * so every real item at or after `insertIndex` shifts down one slot to open room.
+ */
+export declare function makeTrayInsertStrategy(insertIndex: number, shiftHeight: number): SortingStrategy;
+export interface GridViewerProps {
+    /** The layout tree to render. */
+    templateLayout: LayoutNode[];
+    /** Content props keyed by node id. */
+    templateData: TemplateData;
+    /** The registry blocks resolve against. */
+    componentRegistry: BlockRegistry;
+    /** The engine's selected component id (drives the selection chrome). */
+    selectedComponentId: string | null;
+    /** Callback when the layout changes. */
+    onLayoutChange: (layout: LayoutNode[]) => void;
+    /** Callback when a component is selected. */
+    onSelectComponent: (id: string | undefined, path: TreePath) => void;
+    /** Current depth in the tree (for nested calls). */
+    depth?: number;
+    /** Current path in the tree (for nested calls). */
+    currentPath?: TreePath;
+    /** Parent node (for determining sorting strategy). */
+    parentNode?: LayoutNode | null;
+    /** Whether DnD is disabled. */
+    disabled?: boolean;
+    /** Maximum nesting depth. */
+    maxDepth?: number;
+    /** Active dragging id (from the wrapper). */
+    activeId?: string | null;
+    /** Whether a container is being sorted (disables child items). */
+    isSortingContainer?: boolean;
+    /** Live insertion indicator for a tray item dragged over a block. */
+    trayInsertTarget?: SortableInsertTarget | null;
+    /** Callback when a node should be deleted. */
+    onDeleteNode?: (nodeId: string) => void;
+    /** Callback when a node should be duplicated. */
+    onDuplicateNode?: (nodeId: string) => void;
+    /** Callback when AI applies new props to a block. Threaded now, wired in a later step. */
+    onAIApply?: (nodeId: string, newProps: Record<string, unknown>) => void;
+}
+/** Props every recursive `RenderNode` receives, shared with `TwoColumnDesigner`. */
+export interface RenderNodeProps {
+    onSelectComponent: (id: string | undefined, path: TreePath) => void;
+    onLayoutChange: (layout: LayoutNode[]) => void;
+    onDeleteNode?: (nodeId: string) => void;
+    onDuplicateNode?: (nodeId: string) => void;
+    onAIApply?: (nodeId: string, newProps: Record<string, unknown>) => void;
+    node: LayoutNode;
+    index: number;
+    templateData: TemplateData;
+    componentRegistry: BlockRegistry;
+    selectedComponentId: string | null;
+    currentPath: TreePath;
+    depth: number;
+    disabled: boolean;
+    maxDepth: number;
+    activeId: string | null;
+    isSortingContainer?: boolean;
+    trayInsertTarget?: SortableInsertTarget | null;
+}
+export declare const GridViewer: ({ templateLayout, templateData, componentRegistry, selectedComponentId, onSelectComponent, onLayoutChange, onDeleteNode, onDuplicateNode, onAIApply, depth, currentPath, parentNode: _parentNode, disabled, maxDepth, activeId, isSortingContainer, trayInsertTarget, }: GridViewerProps) => import("react/jsx-runtime").JSX.Element;
+interface UseGridDndProps {
+    templateLayout: LayoutNode[];
+    componentRegistry: BlockRegistry;
+    onLayoutChange: (layout: LayoutNode[]) => void;
+    /** Optional callback for handling tray component drops. */
+    onAddFromTray?: (componentType: string, dropTarget?: TrayDropTarget, propsOverride?: Record<string, unknown>) => void;
+    /**
+     * The canvas content element. Used to detect when a drag has left the canvas (e.g.
+     * dragged back over the tray) so the drop can be cancelled rather than snapping onto the
+     * closest block.
+     */
+    canvasRef?: RefObject<HTMLElement | null>;
+}
+export interface UseGridDndReturn {
+    activeId: string | null;
+    activeNode: LayoutNode | null;
+    isSortingContainer: boolean;
+    sensors: ReturnType<typeof useSensors>;
+    announcements: Announcements;
+    screenReaderInstructions: {
+        draggable: string;
+    };
+    collisionDetection: CollisionDetection;
+    handleDragStart: (event: DragStartEvent) => void;
+    handleDragMove: (event: DragMoveEvent) => void;
+    handleDragOver: (event: DragOverEvent) => void;
+    handleDragEnd: (event: DragEndEvent) => void;
+    handleDragCancel: () => void;
+    numRows: number;
+    trayInsertTarget: SortableInsertTarget | null;
+}
+export declare function useGridDnd({ templateLayout, componentRegistry, onLayoutChange, onAddFromTray, canvasRef, }: UseGridDndProps): UseGridDndReturn;
+export interface GridViewerCanvasProps extends Omit<GridViewerProps, 'activeId' | 'isSortingContainer' | 'trayInsertTarget' | 'depth' | 'currentPath' | 'parentNode'> {
+}
+export declare const GridViewerCanvas: ({ templateLayout, templateData, componentRegistry, selectedComponentId, onLayoutChange, onSelectComponent, onDeleteNode, onDuplicateNode, onAIApply, }: GridViewerCanvasProps) => import("react/jsx-runtime").JSX.Element;
+export interface GridDragOverlayProps {
+    activeId: string | null;
+    activeNode: LayoutNode | null;
+    templateData: TemplateData;
+    componentRegistry: BlockRegistry;
+}
+export declare const GridDragOverlay: ({ activeId, activeNode, templateData, componentRegistry, }: GridDragOverlayProps) => import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=GridViewer.d.ts.map

package/dist/editor/canvas/GridViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GridViewer.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/GridViewer.tsx"],"names":[],"mappings":"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"}

package/dist/editor/canvas/TwoColumnDesigner.d.ts

@@ -0,0 +1,34 @@
+import { LayoutNode } from '../../registry';
+import { SortableInsertTarget, TreePath } from '../document/utils';
+import { RenderNodeProps } from './GridViewer';
+export interface TwoColumnDesignerProps {
+    /** The TwoColumn node itself. */
+    node: LayoutNode;
+    /** Children of the TwoColumn node (`node.children`). */
+    columnChildren: LayoutNode[];
+    /** Content props keyed by node id. */
+    templateData: import('../../registry').TemplateData;
+    /** The registry the children resolve against. */
+    componentRegistry: import('../../registry').BlockRegistry;
+    /** The engine's selected component id (drives the selection chrome). */
+    selectedComponentId: string | null;
+    onSelectComponent: (id: string | undefined, path: TreePath) => void;
+    onLayoutChange: (layout: LayoutNode[]) => void;
+    onDeleteNode?: (nodeId: string) => void;
+    onDuplicateNode?: (nodeId: string) => void;
+    onAIApply?: (nodeId: string, newProps: Record<string, unknown>) => void;
+    depth: number;
+    /** Path to the children array. */
+    currentPath: TreePath;
+    disabled: boolean;
+    maxDepth: number;
+    activeId: string | null;
+    isSortingContainer?: boolean;
+    /** Live insertion indicator for a tray item dragged over a block. */
+    trayInsertTarget?: SortableInsertTarget | null;
+    /** The `RenderNode` from GridViewer, passed in to avoid a circular import. */
+    renderNode: React.ComponentType<RenderNodeProps>;
+}
+export declare const TwoColumnDesigner: ({ node, columnChildren: templateChildren, templateData, componentRegistry, selectedComponentId, onSelectComponent, onLayoutChange, onDeleteNode, onDuplicateNode, onAIApply, depth, currentPath, disabled, maxDepth, activeId, isSortingContainer, trayInsertTarget, renderNode: RenderNodeComponent, }: TwoColumnDesignerProps) => import("react/jsx-runtime").JSX.Element;
+export default TwoColumnDesigner;
+//# sourceMappingURL=TwoColumnDesigner.d.ts.map

package/dist/editor/canvas/TwoColumnDesigner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TwoColumnDesigner.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/TwoColumnDesigner.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAqB,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACnE,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACd,MAAM,mBAAmB,CAAA;AAI1B,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,cAAc,CAAA;AAErB,MAAM,WAAW,sBAAsB;IACrC,iCAAiC;IACjC,IAAI,EAAE,UAAU,CAAA;IAChB,wDAAwD;IACxD,cAAc,EAAE,UAAU,EAAE,CAAA;IAC5B,sCAAsC;IACtC,YAAY,EAAE,OAAO,gBAAgB,EAAE,YAAY,CAAA;IACnD,iDAAiD;IACjD,iBAAiB,EAAE,OAAO,gBAAgB,EAAE,aAAa,CAAA;IACzD,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,QAAQ,KAAK,IAAI,CAAA;IACnE,cAAc,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,IAAI,CAAA;IAC9C,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;IACvE,KAAK,EAAE,MAAM,CAAA;IACb,kCAAkC;IAClC,WAAW,EAAE,QAAQ,CAAA;IACrB,QAAQ,EAAE,OAAO,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,oBAAoB,GAAG,IAAI,CAAA;IAC9C,8EAA8E;IAC9E,UAAU,EAAE,KAAK,CAAC,aAAa,CAAC,eAAe,CAAC,CAAA;CACjD;AA0BD,eAAO,MAAM,iBAAiB,GAAI,ySAmB/B,sBAAsB,4CAyIxB,CAAA;AAED,eAAe,iBAAiB,CAAA"}

package/dist/editor/canvas/canvasStyles.d.ts

@@ -0,0 +1,36 @@
+/**
+ * The designer canvas' chrome CSS: the grid container, the per-item selection border and
+ * floating toolbar, the drag placeholders, the drop cells, and the two-column zones. None
+ * of it is expressible in InstUI props — it needs `:has()`, `:focus-within`, pseudo
+ * elements and grid positioning — so it is injected once as a global stylesheet keyed by
+ * stable class names, the same way the blocks ship CSS InstUI can't express. Sourced from
+ * the InstUI theme via `useTheme()`; per-node grid positions are applied inline where they
+ * vary at runtime.
+ */
+export declare const CANVAS_CLASS: {
+    readonly canvasSurface: "bce-designer-canvas-surface";
+    readonly canvas: "bce-designer-canvas";
+    readonly canvasMultiColumn: "bce-designer-canvas--multi";
+    readonly itemContainer: "bce-designer-item-container";
+    readonly itemContainerDragging: "bce-designer-item-container--dragging";
+    readonly itemContainerTrayGap: "bce-designer-item-container--tray-gap";
+    readonly item: "bce-designer-item";
+    readonly itemPopoverOpen: "bce-designer-item--popover-open";
+    readonly toolbar: "bce-designer-toolbar";
+    readonly toolbarGroup: "bce-designer-toolbar-group";
+    readonly chip: "bce-designer-chip";
+    readonly overlay: "bce-designer-overlay";
+    readonly content: "bce-designer-content";
+    readonly dragOverlay: "bce-designer-drag-overlay";
+    readonly gridCell: "bce-designer-grid-cell";
+    readonly gridCellOver: "bce-designer-grid-cell--over";
+    readonly twoColumns: "bce-twocol-columns";
+    readonly twoColumnZone: "bce-twocol-zone";
+    readonly twoColumnZoneOver: "bce-twocol-zone--over";
+    readonly twoColumnEmpty: "bce-twocol-empty";
+};
+/** CSS custom property carrying a per-item tray-gap placeholder height. */
+export declare const TRAY_GAP_HEIGHT_VAR = "--bce-tray-gap-height";
+/** Mounts the canvas chrome stylesheet once, under the designer. */
+export declare function CanvasChromeStyles(): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=canvasStyles.d.ts.map

package/dist/editor/canvas/canvasStyles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasStyles.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/canvasStyles.tsx"],"names":[],"mappings":"AAsBA;;;;;;;;GAQG;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;CAqBf,CAAA;AAEV,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,0BAA0B,CAAA;AAoB1D,oEAAoE;AACpE,wBAAgB,kBAAkB,4CAoPjC"}

package/dist/editor/canvas/canvasTranslations.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Strings the package owns for the designer chrome — the drag-and-drop canvas that is
+ * not part of any one block. Consumed via `useBlockTranslations(DesignerChromeEnglish)`,
+ * the same mechanism blocks use; there is deliberately no second translation context.
+ * The host overrides by placing a `BlockTranslationsProvider` above the designer;
+ * anything it omits falls back to the English below.
+ *
+ * `%{name}` markers are interpolated by `translate('<key>', { … })`.
+ */
+export interface DesignerChromeTranslations {
+    /** Fallback name for a block whose type has no registered label, in a11y announcements. */
+    item: string;
+    /** Screen-reader announcement when a component is picked up for keyboard drag. */
+    pickedUp: string;
+    /** Screen-reader announcement while dragging over nothing droppable. */
+    notOverDropArea: string;
+    /** Lowercase column name, interpolated mid-sentence into a drag announcement. */
+    leftColumn: string;
+    /** Lowercase column name, interpolated mid-sentence into a drag announcement. */
+    rightColumn: string;
+    /** Screen-reader announcement while dragging over a TwoColumn column. */
+    isOverColumn: string;
+    /** Screen-reader announcement while dragging over another block. */
+    isOver: string;
+    /** Screen-reader announcement when a component is dropped. */
+    wasDropped: string;
+    /** Screen-reader announcement when a component is dropped into a TwoColumn column. */
+    wasDroppedIntoColumn: string;
+    /** Screen-reader announcement when a keyboard drag is cancelled. */
+    dragCancelled: string;
+    /** Screen-reader instructions attached to every draggable component. */
+    dragInstructions: string;
+    /** Toolbar `aria-label` for a component's floating action bar. */
+    componentActions: string;
+    /** Drag-handle screen-reader label. */
+    dragToReorder: string;
+    /** Drag-handle tooltip. */
+    dragAndDrop: string;
+    /** Duplicate button screen-reader label. */
+    duplicateComponent: string;
+    /** Duplicate button tooltip. */
+    duplicate: string;
+    /** Delete button screen-reader label. */
+    deleteComponent: string;
+    /** Delete button tooltip and confirm action. */
+    delete: string;
+    /** Delete confirmation prompt. */
+    deleteConfirmation: string;
+    /** Cancel button in the delete confirmation. */
+    cancel: string;
+    /** Component overlay `aria-label` opening the settings for a block. */
+    editComponent: string;
+    /** `aria-label` for the group wrapping a block on the canvas. */
+    componentGroup: string;
+    /** `aria-label` for the left drop zone of a TwoColumn block. */
+    leftColumnLabel: string;
+    /** `aria-label` for the right drop zone of a TwoColumn block. */
+    rightColumnLabel: string;
+    /** Empty-column placeholder in a TwoColumn block. */
+    dropBlocksHere: string;
+}
+/** English bundled with this package — also the source for `locales/en.json`. */
+export declare const DesignerChromeEnglish: DesignerChromeTranslations;
+//# sourceMappingURL=canvasTranslations.d.ts.map

package/dist/editor/canvas/canvasTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasTranslations.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/canvasTranslations.ts"],"names":[],"mappings":"AAkBA;;;;;;;;GAQG;AACH,MAAM,WAAW,0BAA0B;IACzC,2FAA2F;IAC3F,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,QAAQ,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,eAAe,EAAE,MAAM,CAAA;IACvB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAA;IAClB,iFAAiF;IACjF,WAAW,EAAE,MAAM,CAAA;IACnB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAA;IACpB,oEAAoE;IACpE,MAAM,EAAE,MAAM,CAAA;IACd,8DAA8D;IAC9D,UAAU,EAAE,MAAM,CAAA;IAClB,sFAAsF;IACtF,oBAAoB,EAAE,MAAM,CAAA;IAC5B,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,gBAAgB,EAAE,MAAM,CAAA;IACxB,kEAAkE;IAClE,gBAAgB,EAAE,MAAM,CAAA;IACxB,uCAAuC;IACvC,aAAa,EAAE,MAAM,CAAA;IACrB,2BAA2B;IAC3B,WAAW,EAAE,MAAM,CAAA;IACnB,4CAA4C;IAC5C,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAA;IACjB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAA;IACvB,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,kCAAkC;IAClC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAA;IACd,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAA;IACrB,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAA;IACtB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAA;IACvB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,CAAA;IACxB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAA;CACvB;AAED,iFAAiF;AACjF,eAAO,MAAM,qBAAqB,EAAE,0BA2BnC,CAAA"}

package/dist/editor/canvas/index.d.ts

@@ -0,0 +1,5 @@
+export { DesignerArea, type DesignerAreaProps } from './DesignerArea';
+export { DesignerCanvas, type DesignerCanvasProps } from './DesignerCanvas';
+export { GridDndProvider, type GridDndProviderProps } from './GridDndProvider';
+export { type DesignerChromeTranslations, DesignerChromeEnglish, } from './canvasTranslations';
+//# sourceMappingURL=index.d.ts.map

package/dist/editor/canvas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/editor/canvas/index.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC9E,OAAO,EACL,KAAK,0BAA0B,EAC/B,qBAAqB,GACtB,MAAM,sBAAsB,CAAA"}