@almadar/ui 6.3.0 → 6.4.0

package/dist/avl/index.d.cts

@@ -1117,6 +1117,24 @@ declare function orbitalToExpandedGraph(schema: OrbitalSchema, orbitalName: stri
  * passes clicks through to the pattern elements.
  */
 
+/** Selected pattern info, emitted when user clicks a UI element in the node. */
+interface SelectedPattern {
+    /** The pattern type (e.g., "button", "input", "stack"). */
+    patternType: string;
+    /** The DOM element's data-pattern-id if available. */
+    patternId?: string;
+    /** The node this pattern belongs to. */
+    nodeData: PreviewNodeData;
+    /** The source trait for this slot content. */
+    sourceTrait?: string;
+    /** Bounding rect relative to the node for floating inspector positioning. */
+    rect?: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+}
 declare const OrbPreviewNode: React__default.NamedExoticComponent<NodeProps>;
 
 /**
@@ -1342,28 +1360,33 @@ declare function deriveEditFocusFromElement(el: HTMLElement): EditFocus | null;
  * Event contract (defaults — overridable via `CanvasDndProvider.onDrop`):
  *   - On drag start: emits `UI:DRAG_START` { kind, data }
  *   - On drag end:   emits `UI:DRAG_END`   { kind, data }
- *   - On 'pattern' drop:   emits `UI:PATTERN_DROP`  { patternType, containerNode, parentPath?, index? }
- *   - On 'behavior' drop:  emits `UI:BEHAVIOR_DROP` { behaviorName, containerNode }
- *
- * The `onDrop` callback lets consumers route OTHER payload kinds (e.g.
- * `'pattern-instance'` for in-canvas reorder of an existing pattern) to
- * their own bus events or schema mutations. Reorder semantics belong in
- * the consumer because they touch the SExpr tree directly — this primitive
- * only resolves payload + target + cursor and hands them off.
+ *   - On 'pattern' drop:          emits `UI:PATTERN_DROP` { patternType, containerNode, parentPath?, index? }
+ *   - On 'behavior' drop:         emits `UI:BEHAVIOR_DROP` { behaviorName, containerNode }
+ *   - On 'pattern-instance' drop: emits `UI:PATTERN_MOVE` { fromPath, loc, toParentPath?, toIndex? } —
+ *     reorder of an already-placed pattern; `loc` is the source's own
+ *     containerNode (orbitalName/traitName/transitionEvent), `toParentPath`/
+ *     `toIndex` come from `target.resolvePath` same as an insert drop.
+ *
+ * The `onDrop` callback lets consumers route ANY payload kind (including
+ * the defaults above) to their own bus events or schema mutations instead —
+ * e.g. the builder app bypasses ALL default emits (see UIEditor.tsx) because
+ * `useEventBus()` resolves to a different chunk's context inside this
+ * provider. Return `true` from `onDrop` to suppress the default emit.
  */
 
 /**
  * Drag kinds the canvas understands. Open-ended `string` so consumers can
- * introduce new kinds (e.g. `'pattern-instance'` for in-canvas reorder of an
- * existing pattern) without touching this file — the provider's defaults
- * cover `'pattern'` and `'behavior'`; everything else routes through the
- * consumer's `onDrop`.
+ * introduce further kinds without touching this file — the provider's
+ * defaults cover `'pattern'`, `'behavior'` and `'pattern-instance'`
+ * (in-canvas reorder of an existing pattern, source: `OrbPreviewNode`'s L2
+ * content); anything else routes through the consumer's `onDrop`.
  */
-type CanvasDragKind = 'pattern' | 'behavior' | (string & {});
+type CanvasDragKind = 'pattern' | 'behavior' | 'pattern-instance' | (string & {});
 /**
  * Payload carried by a draggable. For `'pattern'` tiles `data` is
- * `{ type: string }`, for `'behavior'` tiles `{ name: string }`. For consumer
- * kinds (e.g. `'pattern-instance'`) the shape is whatever the consumer
+ * `{ type: string }`, for `'behavior'` tiles `{ name: string }`, for
+ * `'pattern-instance'` (reorder) `{ fromPath: string, loc: CanvasContainerNode }`.
+ * For any other consumer-defined kind, the shape is whatever the consumer
  * agrees on with its own `onDrop`.
  */
 interface CanvasDragPayload {
@@ -1518,14 +1541,155 @@ interface OrbInspectorProps {
      * page-level dispatcher routes them to `themeManifest.setToken`.
      */
     themeManifest?: ThemeDefinition;
+    /**
+     * Initial tab on mount. Local state still owns the active tab after
+     * that — this does not make the component controlled. Enables
+     * deep-linking into a specific tab (e.g. from a LayersPanel selection).
+     */
+    defaultTab?: InspectorTab;
+    /** Fires whenever the tab-bar selection changes. */
+    onTabChange?: (tab: InspectorTab) => void;
     onSchemaChange?: (schema: OrbitalSchema) => void;
     onClose: () => void;
+    /**
+     * In-node pattern selection, when this inspector is rendered OUTSIDE
+     * `FlowCanvas` (see `FlowCanvas`'s `externalInspector` +
+     * `onSelectedPatternChange`). `PatternSelectionContext` only reaches
+     * descendants of `FlowCanvas`'s own render tree, so a standalone
+     * consumer has no other way to feed pattern-level selection in — pass
+     * `FlowCanvas`'s `onSelectedPatternChange` payload straight through here.
+     * When omitted (the inline, built-in-inspector usage), falls back to
+     * `PatternSelectionContext`, unchanged.
+     */
+    selectedPattern?: SelectedPattern | null;
 }
-declare function OrbInspector({ node, schema, editable, userType, themeManifest, onSchemaChange, onClose }: OrbInspectorProps): React__default.ReactElement;
+type InspectorTab = 'inspector' | 'design' | 'prototype' | 'code';
+declare function OrbInspector({ node, schema, editable, userType, themeManifest, defaultTab, onTabChange, onSchemaChange, onClose, selectedPattern: selectedPatternProp }: OrbInspectorProps): React__default.ReactElement;
 declare namespace OrbInspector {
     var displayName: string;
 }
 
+/**
+ * FileTree Molecule
+ *
+ * A filesystem tree navigator with folder expand/collapse, file-type icons,
+ * and click-to-select. Used by the Workspace tab to browse the agent's
+ * workspace directory.
+ *
+ * Follows atomic design: composes Box, Icon, Typography atoms.
+ */
+
+/** Flat tree row for `items` mode — nested at render time by `parentId`. */
+interface FileTreeItem {
+    /** Unique node id */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Id of this node's parent; empty/absent marks a root */
+    parentId?: string;
+    /** Icon name override (falls back to folder/file by presence of children) */
+    icon?: string;
+}
+
+/**
+ * LayersPanel
+ *
+ * Figma-style layers tree for an OrbitalSchema. Thin adapter over FileTree's
+ * generic `items` mode — all it does is flatten the schema into
+ * `FileTreeItem[]` via `schemaToLayerItems` and render `<FileTree look="nav" />`.
+ * No tree/panel logic of its own.
+ *
+ * ---------------------------------------------------------------------------
+ * ID scheme (stable, parseable, '/'-joined path of typed segments)
+ * ---------------------------------------------------------------------------
+ *   orbital:<orbitalName>
+ *   orbital:<orbitalName>/page:<pageName>
+ *   orbital:<orbitalName>/trait:<traitName>
+ *   orbital:<orbitalName>/trait:<traitName>/transition:<index>
+ *   orbital:<orbitalName>/trait:<traitName>/transition:<index>/slot:<slotName>
+ *   orbital:<orbitalName>/trait:<traitName>/transition:<index>/slot:<slotName>/pattern:<slotIndex>:<patternPath>
+ *
+ * The transition segment uses the transition's array INDEX (not its event
+ * name) because two transitions in the same trait can share an event name
+ * (same event fired from different `from` states) — the index is the only
+ * value `parseTraitLevel`/`parseTransitionLevel` guarantee is unique. The
+ * slot segment uses the slot's NAME (render-ui slots are conventionally
+ * distinct within one transition); the `pattern:<slotIndex>` part of the
+ * final leaf's key disambiguates the rare case of two render-ui effects
+ * targeting the same slot name within one transition by falling back to
+ * their position among that transition's render-ui effects.
+ *
+ * `<patternPath>` is the same schema-compatible address `UISlotRenderer`
+ * stamps as `data-pattern-path` and `useSchemaEditor`'s `navigatePatternPath`
+ * / `splitPatternChildPath` consume: `root` for the render-ui root, then
+ * `root.children.<i>`, `root.children.<i>.children.<j>`, … recursing into
+ * every nested pattern's `children` (an array, or a single bare pattern
+ * object — both normalized the same way `UISlotRenderer.renderPatternChildren`
+ * does). Non-object children (`@entity.X` / `@trait.X` string bindings,
+ * literals) are bindings, not nested patterns, and never get a row. Every
+ * pattern node in the render-ui tree — root and nested alike — gets its own
+ * `pattern:<slotIndex>:<patternPath>` leaf, parented to its containing
+ * pattern's row (or the slot row, for `root`), so a consumer can walk the
+ * exact tree `schemaEditor.movePattern`/`removePattern`/`updatePatternProp`
+ * address.
+ *
+ * This is backward-compatible one level up: every non-pattern segment
+ * (`orbital:` / `page:` / `trait:` / `transition:` / `slot:`) is unchanged,
+ * so a consumer parsing only those levels (e.g. to resolve which orbital a
+ * click belongs to) needs no changes. Only the trailing pattern leaf's key
+ * gained the `:<patternPath>` suffix — use the exported `parseLayerId` to
+ * read it instead of re-deriving the regex.
+ *
+ * Hierarchy choice: orbitals are the roots, with each orbital's `pages` and
+ * `traits` as sibling children (an OrbitalDefinition owns both directly).
+ * A schema has no cross-orbital "Page" entity and no data linking a
+ * render-ui slot back to a specific page route, so a page-rooted tree
+ * (pages containing the orbitals that render on them) is not derivable
+ * without guessing — forbidden by the no-heuristics rule. See the Wave D3
+ * report for this deviation from the literal "pages → orbitals → ..." spec
+ * line.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Flattens an OrbitalSchema into FileTree's `items` shape. See the ID scheme
+ * doc comment above the file header for the exact id grammar.
+ */
+declare function schemaToLayerItems(schema: OrbitalSchema): FileTreeItem[];
+/** Every field a LayersPanel id can carry, populated up to whatever depth the id reaches. `orbitalName` is the only field guaranteed present. */
+interface LayerIdParts {
+    orbitalName: string;
+    pageName?: string;
+    traitName?: string;
+    /** The transition's array INDEX (see the id-scheme doc comment — not its event name). */
+    transitionIndex?: number;
+    slotName?: string;
+    /** Position among the slot's render-ui effects (disambiguates two effects targeting the same slot name). */
+    patternSlotIndex?: number;
+    /** Schema-compatible address into the render-ui tree (`root`, `root.children.0`, …) — the exact `patternPath` `schemaEditor.movePattern`/`removePattern`/`updatePatternProp` expect. */
+    patternPath?: string;
+}
+/**
+ * Parses any id `schemaToLayerItems` produces back into its typed segments.
+ * Returns `null` for a malformed id (missing/garbled `orbital:` root, or an
+ * unrecognized segment). Segments below the deepest one present in `id` are
+ * left `undefined` — e.g. a trait-level id has no `slotName`/`patternPath`.
+ */
+declare function parseLayerId(id: string): LayerIdParts | null;
+interface LayersPanelProps {
+    schema: OrbitalSchema;
+    /** Currently selected node id (any level of the ID scheme above). */
+    selectedId?: string;
+    onSelect?: (id: string) => void;
+    /**
+     * Reorder a node within the tree. Threaded to FileTree's `onNodeReorder`
+     * seam — presence-gated there, so omitting it just means no dragging.
+     */
+    onReorder?: (id: string, newParentId: string | null, index: number) => void;
+}
+declare const LayersPanel: React__default.FC<LayersPanelProps>;
+
 /**
  * FlowCanvas — V3 UI Projection Canvas
  *
@@ -1673,6 +1837,31 @@ interface FlowCanvasProps {
         x: number;
         y: number;
     }>) => void;
+    /**
+     * Fired whenever the internal `selectedNode` changes — select, clear-on-
+     * escape, clear-on-level-change, and pattern-selection sync all route
+     * through this. Lets a consumer mirror selection into a persistent
+     * properties panel rendered outside the canvas (see `externalInspector`).
+     */
+    onSelectedNodeChange?: (node: PreviewNodeData | null) => void;
+    /**
+     * Fired whenever the in-node pattern selection changes (a pattern click
+     * inside `OrbPreviewNode`, cleared on background click / Escape / pattern
+     * delete). `PatternSelectionContext` is internal to this component's own
+     * render tree, so an externally-rendered `OrbInspector` (see
+     * `externalInspector`) has no other way to learn which pattern the user
+     * picked — pass this straight through to `OrbInspector`'s `selectedPattern`
+     * prop to keep Design-tab prop editing working outside the canvas.
+     */
+    onSelectedPatternChange?: (pattern: SelectedPattern | null) => void;
+    /**
+     * When true, FlowCanvas does not render its inline `OrbInspector` — the
+     * consumer is expected to render one externally, fed by
+     * `onSelectedNodeChange` + `onSelectedPatternChange`. Selection
+     * highlighting, keyboard delete, and every other behavior is unchanged.
+     * Default `false` preserves the built-in inline panel.
+     */
+    externalInspector?: boolean;
 }
 declare const FlowCanvas: React__default.FC<FlowCanvasProps>;
 
@@ -1874,4 +2063,4 @@ interface AvlClickTargetProps {
 }
 declare const AvlClickTarget: React__default.FC<AvlClickTargetProps>;
 
-export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlBackwardEdge, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, AvlBindingEdge, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, type AvlEdgeData, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlEventWireEdge, type AvlEventWireEdgeData, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, type AvlNodeData, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, AvlOrbitalNode, type AvlOrbitalProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps, AvlPage, AvlPageEdge, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionEdge, type AvlTransitionEdgeData, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorCanvasEntry, BehaviorComposeNode, type BehaviorComposeNodeData, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, type BehaviorRegistryRecord, BehaviorView, type BehaviorWireEdgeData, CONNECTION_COLORS, type CanvasContainerNode, CanvasDndProvider, type CanvasDndProviderProps, type CanvasDragKind, type CanvasDragPayload, type CanvasDropEvent, type CanvasDropTarget, type ComposeViewLevel, type ConnectableEvent, type CrossLink, DOMAIN_COLORS, DetailView, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, type EffectCategory, type ElkLayout, type EventEdgeData, EventFlowEdge, FlowCanvas, type FlowCanvasProps, type GlyphSize, type LayoutEdge, type LayoutNode, MiniStateMachine, ModuleCard, OrbInspector, type OrbInspectorProps, OrbPreviewNode, type OrbitalLevelData, type PatternEventSource, type PreviewNodeData, type RenderUIEntry, STATE_COLORS, type StateRole, SystemNode, type TraitLevelData, type TransitionLevelData, type UseCanvasDraggableArgs, type UseCanvasDraggableResult, type UseCanvasDroppableArgs, type UseCanvasDroppableResult, type ViewLevel, ZOOM_BAND_THRESHOLDS, type ZoomBand, ZoomBandContext, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, type ZoomLevel, arcPath, behaviorsToComposeGraph, computeTraitLayout, computeZoomBand, curveControlPoint, deriveEditFocusFromElement, edgePath, getStateRole, gridPositions, orbitalToExpandedGraph, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, registryEntryToCanvasEntry, ringPositions, schemaToFlowGraph, schemaToOverviewGraph, useCanvasDraggable, useCanvasDroppable, useZoomBand, zoomProgress };
+export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlBackwardEdge, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, AvlBindingEdge, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, type AvlEdgeData, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlEventWireEdge, type AvlEventWireEdgeData, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, type AvlNodeData, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, AvlOrbitalNode, type AvlOrbitalProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps, AvlPage, AvlPageEdge, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionEdge, type AvlTransitionEdgeData, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorCanvasEntry, BehaviorComposeNode, type BehaviorComposeNodeData, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, type BehaviorRegistryRecord, BehaviorView, type BehaviorWireEdgeData, CONNECTION_COLORS, type CanvasContainerNode, CanvasDndProvider, type CanvasDndProviderProps, type CanvasDragKind, type CanvasDragPayload, type CanvasDropEvent, type CanvasDropTarget, type ComposeViewLevel, type ConnectableEvent, type CrossLink, DOMAIN_COLORS, DetailView, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, type EffectCategory, type ElkLayout, type EventEdgeData, EventFlowEdge, FlowCanvas, type FlowCanvasProps, type GlyphSize, type LayerIdParts, LayersPanel, type LayersPanelProps, type LayoutEdge, type LayoutNode, MiniStateMachine, ModuleCard, OrbInspector, type OrbInspectorProps, OrbPreviewNode, type OrbitalLevelData, type PatternEventSource, type PreviewNodeData, type RenderUIEntry, STATE_COLORS, type SelectedPattern, type StateRole, SystemNode, type TraitLevelData, type TransitionLevelData, type UseCanvasDraggableArgs, type UseCanvasDraggableResult, type UseCanvasDroppableArgs, type UseCanvasDroppableResult, type ViewLevel, ZOOM_BAND_THRESHOLDS, type ZoomBand, ZoomBandContext, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, type ZoomLevel, arcPath, behaviorsToComposeGraph, computeTraitLayout, computeZoomBand, curveControlPoint, deriveEditFocusFromElement, edgePath, getStateRole, gridPositions, orbitalToExpandedGraph, parseApplicationLevel, parseLayerId, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, registryEntryToCanvasEntry, ringPositions, schemaToFlowGraph, schemaToLayerItems, schemaToOverviewGraph, useCanvasDraggable, useCanvasDroppable, useZoomBand, zoomProgress };

package/dist/avl/index.d.ts

@@ -1117,6 +1117,24 @@ declare function orbitalToExpandedGraph(schema: OrbitalSchema, orbitalName: stri
  * passes clicks through to the pattern elements.
  */
 
+/** Selected pattern info, emitted when user clicks a UI element in the node. */
+interface SelectedPattern {
+    /** The pattern type (e.g., "button", "input", "stack"). */
+    patternType: string;
+    /** The DOM element's data-pattern-id if available. */
+    patternId?: string;
+    /** The node this pattern belongs to. */
+    nodeData: PreviewNodeData;
+    /** The source trait for this slot content. */
+    sourceTrait?: string;
+    /** Bounding rect relative to the node for floating inspector positioning. */
+    rect?: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+}
 declare const OrbPreviewNode: React__default.NamedExoticComponent<NodeProps>;
 
 /**
@@ -1342,28 +1360,33 @@ declare function deriveEditFocusFromElement(el: HTMLElement): EditFocus | null;
  * Event contract (defaults — overridable via `CanvasDndProvider.onDrop`):
  *   - On drag start: emits `UI:DRAG_START` { kind, data }
  *   - On drag end:   emits `UI:DRAG_END`   { kind, data }
- *   - On 'pattern' drop:   emits `UI:PATTERN_DROP`  { patternType, containerNode, parentPath?, index? }
- *   - On 'behavior' drop:  emits `UI:BEHAVIOR_DROP` { behaviorName, containerNode }
- *
- * The `onDrop` callback lets consumers route OTHER payload kinds (e.g.
- * `'pattern-instance'` for in-canvas reorder of an existing pattern) to
- * their own bus events or schema mutations. Reorder semantics belong in
- * the consumer because they touch the SExpr tree directly — this primitive
- * only resolves payload + target + cursor and hands them off.
+ *   - On 'pattern' drop:          emits `UI:PATTERN_DROP` { patternType, containerNode, parentPath?, index? }
+ *   - On 'behavior' drop:         emits `UI:BEHAVIOR_DROP` { behaviorName, containerNode }
+ *   - On 'pattern-instance' drop: emits `UI:PATTERN_MOVE` { fromPath, loc, toParentPath?, toIndex? } —
+ *     reorder of an already-placed pattern; `loc` is the source's own
+ *     containerNode (orbitalName/traitName/transitionEvent), `toParentPath`/
+ *     `toIndex` come from `target.resolvePath` same as an insert drop.
+ *
+ * The `onDrop` callback lets consumers route ANY payload kind (including
+ * the defaults above) to their own bus events or schema mutations instead —
+ * e.g. the builder app bypasses ALL default emits (see UIEditor.tsx) because
+ * `useEventBus()` resolves to a different chunk's context inside this
+ * provider. Return `true` from `onDrop` to suppress the default emit.
  */
 
 /**
  * Drag kinds the canvas understands. Open-ended `string` so consumers can
- * introduce new kinds (e.g. `'pattern-instance'` for in-canvas reorder of an
- * existing pattern) without touching this file — the provider's defaults
- * cover `'pattern'` and `'behavior'`; everything else routes through the
- * consumer's `onDrop`.
+ * introduce further kinds without touching this file — the provider's
+ * defaults cover `'pattern'`, `'behavior'` and `'pattern-instance'`
+ * (in-canvas reorder of an existing pattern, source: `OrbPreviewNode`'s L2
+ * content); anything else routes through the consumer's `onDrop`.
  */
-type CanvasDragKind = 'pattern' | 'behavior' | (string & {});
+type CanvasDragKind = 'pattern' | 'behavior' | 'pattern-instance' | (string & {});
 /**
  * Payload carried by a draggable. For `'pattern'` tiles `data` is
- * `{ type: string }`, for `'behavior'` tiles `{ name: string }`. For consumer
- * kinds (e.g. `'pattern-instance'`) the shape is whatever the consumer
+ * `{ type: string }`, for `'behavior'` tiles `{ name: string }`, for
+ * `'pattern-instance'` (reorder) `{ fromPath: string, loc: CanvasContainerNode }`.
+ * For any other consumer-defined kind, the shape is whatever the consumer
  * agrees on with its own `onDrop`.
  */
 interface CanvasDragPayload {
@@ -1518,14 +1541,155 @@ interface OrbInspectorProps {
      * page-level dispatcher routes them to `themeManifest.setToken`.
      */
     themeManifest?: ThemeDefinition;
+    /**
+     * Initial tab on mount. Local state still owns the active tab after
+     * that — this does not make the component controlled. Enables
+     * deep-linking into a specific tab (e.g. from a LayersPanel selection).
+     */
+    defaultTab?: InspectorTab;
+    /** Fires whenever the tab-bar selection changes. */
+    onTabChange?: (tab: InspectorTab) => void;
     onSchemaChange?: (schema: OrbitalSchema) => void;
     onClose: () => void;
+    /**
+     * In-node pattern selection, when this inspector is rendered OUTSIDE
+     * `FlowCanvas` (see `FlowCanvas`'s `externalInspector` +
+     * `onSelectedPatternChange`). `PatternSelectionContext` only reaches
+     * descendants of `FlowCanvas`'s own render tree, so a standalone
+     * consumer has no other way to feed pattern-level selection in — pass
+     * `FlowCanvas`'s `onSelectedPatternChange` payload straight through here.
+     * When omitted (the inline, built-in-inspector usage), falls back to
+     * `PatternSelectionContext`, unchanged.
+     */
+    selectedPattern?: SelectedPattern | null;
 }
-declare function OrbInspector({ node, schema, editable, userType, themeManifest, onSchemaChange, onClose }: OrbInspectorProps): React__default.ReactElement;
+type InspectorTab = 'inspector' | 'design' | 'prototype' | 'code';
+declare function OrbInspector({ node, schema, editable, userType, themeManifest, defaultTab, onTabChange, onSchemaChange, onClose, selectedPattern: selectedPatternProp }: OrbInspectorProps): React__default.ReactElement;
 declare namespace OrbInspector {
     var displayName: string;
 }
 
+/**
+ * FileTree Molecule
+ *
+ * A filesystem tree navigator with folder expand/collapse, file-type icons,
+ * and click-to-select. Used by the Workspace tab to browse the agent's
+ * workspace directory.
+ *
+ * Follows atomic design: composes Box, Icon, Typography atoms.
+ */
+
+/** Flat tree row for `items` mode — nested at render time by `parentId`. */
+interface FileTreeItem {
+    /** Unique node id */
+    id: string;
+    /** Display label */
+    label: string;
+    /** Id of this node's parent; empty/absent marks a root */
+    parentId?: string;
+    /** Icon name override (falls back to folder/file by presence of children) */
+    icon?: string;
+}
+
+/**
+ * LayersPanel
+ *
+ * Figma-style layers tree for an OrbitalSchema. Thin adapter over FileTree's
+ * generic `items` mode — all it does is flatten the schema into
+ * `FileTreeItem[]` via `schemaToLayerItems` and render `<FileTree look="nav" />`.
+ * No tree/panel logic of its own.
+ *
+ * ---------------------------------------------------------------------------
+ * ID scheme (stable, parseable, '/'-joined path of typed segments)
+ * ---------------------------------------------------------------------------
+ *   orbital:<orbitalName>
+ *   orbital:<orbitalName>/page:<pageName>
+ *   orbital:<orbitalName>/trait:<traitName>
+ *   orbital:<orbitalName>/trait:<traitName>/transition:<index>
+ *   orbital:<orbitalName>/trait:<traitName>/transition:<index>/slot:<slotName>
+ *   orbital:<orbitalName>/trait:<traitName>/transition:<index>/slot:<slotName>/pattern:<slotIndex>:<patternPath>
+ *
+ * The transition segment uses the transition's array INDEX (not its event
+ * name) because two transitions in the same trait can share an event name
+ * (same event fired from different `from` states) — the index is the only
+ * value `parseTraitLevel`/`parseTransitionLevel` guarantee is unique. The
+ * slot segment uses the slot's NAME (render-ui slots are conventionally
+ * distinct within one transition); the `pattern:<slotIndex>` part of the
+ * final leaf's key disambiguates the rare case of two render-ui effects
+ * targeting the same slot name within one transition by falling back to
+ * their position among that transition's render-ui effects.
+ *
+ * `<patternPath>` is the same schema-compatible address `UISlotRenderer`
+ * stamps as `data-pattern-path` and `useSchemaEditor`'s `navigatePatternPath`
+ * / `splitPatternChildPath` consume: `root` for the render-ui root, then
+ * `root.children.<i>`, `root.children.<i>.children.<j>`, … recursing into
+ * every nested pattern's `children` (an array, or a single bare pattern
+ * object — both normalized the same way `UISlotRenderer.renderPatternChildren`
+ * does). Non-object children (`@entity.X` / `@trait.X` string bindings,
+ * literals) are bindings, not nested patterns, and never get a row. Every
+ * pattern node in the render-ui tree — root and nested alike — gets its own
+ * `pattern:<slotIndex>:<patternPath>` leaf, parented to its containing
+ * pattern's row (or the slot row, for `root`), so a consumer can walk the
+ * exact tree `schemaEditor.movePattern`/`removePattern`/`updatePatternProp`
+ * address.
+ *
+ * This is backward-compatible one level up: every non-pattern segment
+ * (`orbital:` / `page:` / `trait:` / `transition:` / `slot:`) is unchanged,
+ * so a consumer parsing only those levels (e.g. to resolve which orbital a
+ * click belongs to) needs no changes. Only the trailing pattern leaf's key
+ * gained the `:<patternPath>` suffix — use the exported `parseLayerId` to
+ * read it instead of re-deriving the regex.
+ *
+ * Hierarchy choice: orbitals are the roots, with each orbital's `pages` and
+ * `traits` as sibling children (an OrbitalDefinition owns both directly).
+ * A schema has no cross-orbital "Page" entity and no data linking a
+ * render-ui slot back to a specific page route, so a page-rooted tree
+ * (pages containing the orbitals that render on them) is not derivable
+ * without guessing — forbidden by the no-heuristics rule. See the Wave D3
+ * report for this deviation from the literal "pages → orbitals → ..." spec
+ * line.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Flattens an OrbitalSchema into FileTree's `items` shape. See the ID scheme
+ * doc comment above the file header for the exact id grammar.
+ */
+declare function schemaToLayerItems(schema: OrbitalSchema): FileTreeItem[];
+/** Every field a LayersPanel id can carry, populated up to whatever depth the id reaches. `orbitalName` is the only field guaranteed present. */
+interface LayerIdParts {
+    orbitalName: string;
+    pageName?: string;
+    traitName?: string;
+    /** The transition's array INDEX (see the id-scheme doc comment — not its event name). */
+    transitionIndex?: number;
+    slotName?: string;
+    /** Position among the slot's render-ui effects (disambiguates two effects targeting the same slot name). */
+    patternSlotIndex?: number;
+    /** Schema-compatible address into the render-ui tree (`root`, `root.children.0`, …) — the exact `patternPath` `schemaEditor.movePattern`/`removePattern`/`updatePatternProp` expect. */
+    patternPath?: string;
+}
+/**
+ * Parses any id `schemaToLayerItems` produces back into its typed segments.
+ * Returns `null` for a malformed id (missing/garbled `orbital:` root, or an
+ * unrecognized segment). Segments below the deepest one present in `id` are
+ * left `undefined` — e.g. a trait-level id has no `slotName`/`patternPath`.
+ */
+declare function parseLayerId(id: string): LayerIdParts | null;
+interface LayersPanelProps {
+    schema: OrbitalSchema;
+    /** Currently selected node id (any level of the ID scheme above). */
+    selectedId?: string;
+    onSelect?: (id: string) => void;
+    /**
+     * Reorder a node within the tree. Threaded to FileTree's `onNodeReorder`
+     * seam — presence-gated there, so omitting it just means no dragging.
+     */
+    onReorder?: (id: string, newParentId: string | null, index: number) => void;
+}
+declare const LayersPanel: React__default.FC<LayersPanelProps>;
+
 /**
  * FlowCanvas — V3 UI Projection Canvas
  *
@@ -1673,6 +1837,31 @@ interface FlowCanvasProps {
         x: number;
         y: number;
     }>) => void;
+    /**
+     * Fired whenever the internal `selectedNode` changes — select, clear-on-
+     * escape, clear-on-level-change, and pattern-selection sync all route
+     * through this. Lets a consumer mirror selection into a persistent
+     * properties panel rendered outside the canvas (see `externalInspector`).
+     */
+    onSelectedNodeChange?: (node: PreviewNodeData | null) => void;
+    /**
+     * Fired whenever the in-node pattern selection changes (a pattern click
+     * inside `OrbPreviewNode`, cleared on background click / Escape / pattern
+     * delete). `PatternSelectionContext` is internal to this component's own
+     * render tree, so an externally-rendered `OrbInspector` (see
+     * `externalInspector`) has no other way to learn which pattern the user
+     * picked — pass this straight through to `OrbInspector`'s `selectedPattern`
+     * prop to keep Design-tab prop editing working outside the canvas.
+     */
+    onSelectedPatternChange?: (pattern: SelectedPattern | null) => void;
+    /**
+     * When true, FlowCanvas does not render its inline `OrbInspector` — the
+     * consumer is expected to render one externally, fed by
+     * `onSelectedNodeChange` + `onSelectedPatternChange`. Selection
+     * highlighting, keyboard delete, and every other behavior is unchanged.
+     * Default `false` preserves the built-in inline panel.
+     */
+    externalInspector?: boolean;
 }
 declare const FlowCanvas: React__default.FC<FlowCanvasProps>;
 
@@ -1874,4 +2063,4 @@ interface AvlClickTargetProps {
 }
 declare const AvlClickTarget: React__default.FC<AvlClickTargetProps>;
 
-export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlBackwardEdge, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, AvlBindingEdge, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, type AvlEdgeData, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlEventWireEdge, type AvlEventWireEdgeData, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, type AvlNodeData, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, AvlOrbitalNode, type AvlOrbitalProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps, AvlPage, AvlPageEdge, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionEdge, type AvlTransitionEdgeData, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorCanvasEntry, BehaviorComposeNode, type BehaviorComposeNodeData, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, type BehaviorRegistryRecord, BehaviorView, type BehaviorWireEdgeData, CONNECTION_COLORS, type CanvasContainerNode, CanvasDndProvider, type CanvasDndProviderProps, type CanvasDragKind, type CanvasDragPayload, type CanvasDropEvent, type CanvasDropTarget, type ComposeViewLevel, type ConnectableEvent, type CrossLink, DOMAIN_COLORS, DetailView, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, type EffectCategory, type ElkLayout, type EventEdgeData, EventFlowEdge, FlowCanvas, type FlowCanvasProps, type GlyphSize, type LayoutEdge, type LayoutNode, MiniStateMachine, ModuleCard, OrbInspector, type OrbInspectorProps, OrbPreviewNode, type OrbitalLevelData, type PatternEventSource, type PreviewNodeData, type RenderUIEntry, STATE_COLORS, type StateRole, SystemNode, type TraitLevelData, type TransitionLevelData, type UseCanvasDraggableArgs, type UseCanvasDraggableResult, type UseCanvasDroppableArgs, type UseCanvasDroppableResult, type ViewLevel, ZOOM_BAND_THRESHOLDS, type ZoomBand, ZoomBandContext, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, type ZoomLevel, arcPath, behaviorsToComposeGraph, computeTraitLayout, computeZoomBand, curveControlPoint, deriveEditFocusFromElement, edgePath, getStateRole, gridPositions, orbitalToExpandedGraph, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, registryEntryToCanvasEntry, ringPositions, schemaToFlowGraph, schemaToOverviewGraph, useCanvasDraggable, useCanvasDroppable, useZoomBand, zoomProgress };
+export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlBackwardEdge, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, AvlBindingEdge, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, type AvlEdgeData, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlEventWireEdge, type AvlEventWireEdgeData, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, type AvlNodeData, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, AvlOrbitalNode, type AvlOrbitalProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps, AvlPage, AvlPageEdge, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionEdge, type AvlTransitionEdgeData, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorCanvasEntry, BehaviorComposeNode, type BehaviorComposeNodeData, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, type BehaviorRegistryRecord, BehaviorView, type BehaviorWireEdgeData, CONNECTION_COLORS, type CanvasContainerNode, CanvasDndProvider, type CanvasDndProviderProps, type CanvasDragKind, type CanvasDragPayload, type CanvasDropEvent, type CanvasDropTarget, type ComposeViewLevel, type ConnectableEvent, type CrossLink, DOMAIN_COLORS, DetailView, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, type EffectCategory, type ElkLayout, type EventEdgeData, EventFlowEdge, FlowCanvas, type FlowCanvasProps, type GlyphSize, type LayerIdParts, LayersPanel, type LayersPanelProps, type LayoutEdge, type LayoutNode, MiniStateMachine, ModuleCard, OrbInspector, type OrbInspectorProps, OrbPreviewNode, type OrbitalLevelData, type PatternEventSource, type PreviewNodeData, type RenderUIEntry, STATE_COLORS, type SelectedPattern, type StateRole, SystemNode, type TraitLevelData, type TransitionLevelData, type UseCanvasDraggableArgs, type UseCanvasDraggableResult, type UseCanvasDroppableArgs, type UseCanvasDroppableResult, type ViewLevel, ZOOM_BAND_THRESHOLDS, type ZoomBand, ZoomBandContext, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, type ZoomLevel, arcPath, behaviorsToComposeGraph, computeTraitLayout, computeZoomBand, curveControlPoint, deriveEditFocusFromElement, edgePath, getStateRole, gridPositions, orbitalToExpandedGraph, parseApplicationLevel, parseLayerId, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, registryEntryToCanvasEntry, ringPositions, schemaToFlowGraph, schemaToLayerItems, schemaToOverviewGraph, useCanvasDraggable, useCanvasDroppable, useZoomBand, zoomProgress };