@almadar/shell-web 0.0.0-stage → 1.0.0

package/dist/EventBusProvider-BFFHfN4O.d.ts

@@ -0,0 +1,296 @@
+import * as React from 'react';
+import React__default, { ReactNode } from 'react';
+import { A11yProps, EventEmit, EventPayload, BusEventSource, BusEventListener, Unsubscribe, EntityRow } from '@almadar/core';
+
+type VideoReadyPayload = {
+    source: string;
+};
+type VideoErrorPayload = {
+    error: string;
+    code: string;
+};
+type VideoPlayPayload = {
+    source: string;
+};
+/**
+ * Embedded video player: a YouTube video by id, or any player page by URL. Fires a ready event once it can play and an error event when it cannot.
+ * @capabilities embedded video, YouTube player, lesson video, video embed, play a video by id or URL, player ready and error events
+ * @accessibleName title
+ */
+interface VideoEmbedProps extends A11yProps {
+    /** YouTube video id (the 11 characters of the share URL); played through the YouTube IFrame API */
+    videoId?: string;
+    /** URL of any other embeddable player page; used when no `videoId` is set */
+    src?: string;
+    /** Accessible name of the player */
+    title?: string;
+    /** Text shown when no video is selected */
+    noVideoLabel?: string;
+    /** Text for a YouTube API loading failure */
+    apiUnavailableMessage?: string;
+    /** Text for YouTube error code 2 */
+    invalidVideoMessage?: string;
+    /** Text for YouTube error code 5 or an unknown code */
+    playbackFailedMessage?: string;
+    /** Text for YouTube error code 100 */
+    notFoundMessage?: string;
+    /** Text for YouTube error codes 101 and 150 */
+    notEmbeddableMessage?: string;
+    /** Start playback as soon as the player is ready (YouTube ids only) */
+    autoplay?: boolean;
+    /** Show the player's own controls (YouTube ids only) */
+    controls?: boolean;
+    /** Second of the video to start from (YouTube ids only) */
+    start?: number;
+    /** Event fired once the player is ready to play; the payload names the video id or URL */
+    readyEvent?: EventEmit<VideoReadyPayload>;
+    /** Event fired each time the YouTube player begins or resumes playing; the payload names the video id */
+    playEvent?: EventEmit<VideoPlayPayload>;
+    /** Event fired when the YouTube player cannot load or play the video; the payload carries the message and the player's error code. A plain URL never fires it: a browser reports no load failure for a page frame */
+    errorEvent?: EventEmit<VideoErrorPayload>;
+    /** Additional class names */
+    className?: string;
+}
+interface YouTubePlayer {
+    destroy(): void;
+}
+interface YouTubePlayerOptions {
+    videoId: string;
+    playerVars: {
+        autoplay: 0 | 1;
+        controls: 0 | 1;
+        start: number;
+        rel: 0;
+    };
+    events: {
+        onReady: () => void;
+        onError: (event: {
+            data: number;
+        }) => void;
+        onStateChange: (event: {
+            data: number;
+        }) => void;
+    };
+}
+interface YouTubeApi {
+    Player: new (host: HTMLElement, options: YouTubePlayerOptions) => YouTubePlayer;
+}
+declare global {
+    interface Window {
+        YT?: YouTubeApi;
+        onYouTubeIframeAPIReady?: () => void;
+    }
+}
+declare const VideoEmbed: React.FC<VideoEmbedProps>;
+
+/**
+ * Event Bus Types
+ *
+ * Re-exports from @almadar/core so every package agrees on the same
+ * bus event envelope. @almadar/ui no longer owns its own KFlowEvent —
+ * that type was folded into core's BusEvent.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Event bus context type.
+ *
+ * `emit` accepts `EventPayload` from `@almadar/core` — the canonical
+ * object shape (index signature over `EventPayloadValue`) that the bus
+ * envelope stores and listeners consume. Pattern-specific payload types
+ * from `@almadar/core/patterns` (`ItemActionPayload`, `SelectionChangePayload`,
+ * `FormSubmitPayload`, ...) are structural subtypes of `EventPayload`,
+ * so components can pass them in without casts.
+ */
+interface EventBusContextType {
+    /**
+     * Emit an event to all listeners.
+     *
+     * @param type - Event type identifier
+     * @param payload - Optional payload data (shape matches {@link EventPayload})
+     * @param source - Optional origin info (orbital/trait/...)
+     */
+    emit: (type: string, payload?: EventPayload, source?: BusEventSource) => void;
+    /**
+     * Subscribe to an event type.
+     *
+     * @param type - Event type to listen for
+     * @param listener - Callback function
+     * @returns Unsubscribe function
+     */
+    on: (type: string, listener: BusEventListener) => Unsubscribe;
+    /**
+     * Subscribe to an event type, but only fire once.
+     *
+     * @param type - Event type to listen for
+     * @param listener - Callback function
+     * @returns Unsubscribe function
+     */
+    once: (type: string, listener: BusEventListener) => Unsubscribe;
+    /**
+     * Check if there are any listeners for an event type.
+     *
+     * @param type - Event type to check
+     * @returns True if there are listeners
+     */
+    hasListeners: (type: string) => boolean;
+    /**
+     * Subscribe to ALL events regardless of type.
+     * Useful for verification, debugging, and analytics.
+     *
+     * @param listener - Callback function invoked for every emitted event
+     * @returns Unsubscribe function
+     */
+    onAny?: (listener: BusEventListener) => Unsubscribe;
+}
+
+declare global {
+    interface Window {
+        __kflowEventBus?: EventBusContextType | null;
+    }
+}
+/**
+ * Global event bus reference for bridging between packages.
+ *
+ * Uses window-level global to enable cross-package communication.
+ * This allows @almadar/ui components to emit events to the same bus
+ * that the consuming app's trait state machine listens to.
+ *
+ * When the EventBusProvider mounts, it sets window.__kflowEventBus.
+ * Components in any package can then use this shared event bus.
+ *
+ * SSR Safety: All window access is guarded by `typeof window !== 'undefined'`.
+ * React Compiler Safety: The global bus reference is set once at provider mount
+ * and is stable — no render-path side effects. In practice, the React context
+ * path (priority 1) is used in real apps; the window global (priority 2) is
+ * only reached when no EventBusProvider is in the tree (e.g., Storybook).
+ */
+/**
+ * Set the global event bus reference.
+ * Called by EventBusProvider when it mounts.
+ *
+ * @param bus - The event bus context to set as global, or null to clear
+ */
+declare function setGlobalEventBus(bus: EventBusContextType | null): void;
+/**
+ * Get the global event bus reference.
+ *
+ * @returns The global event bus if set, null otherwise
+ */
+declare function getGlobalEventBus(): EventBusContextType | null;
+/**
+ * Hook for accessing the event bus.
+ *
+ * Uses EventBusProvider context if available, otherwise falls back to
+ * a simple in-memory event bus (for design system / Storybook).
+ *
+ * @returns Event bus instance with emit, on, once, and hasListeners methods
+ *
+ * @example
+ * ```tsx
+ * const eventBus = useEventBus();
+ *
+ * // Emit an event
+ * eventBus.emit('UI:CLICK', { id: '123' });
+ *
+ * // Subscribe to an event
+ * useEffect(() => {
+ *   return eventBus.on('UI:CLICK', (event) => {
+ *     console.log('Clicked:', event.payload);
+ *   });
+ * }, []);
+ * ```
+ */
+declare function useEventBus(): EventBusContextType;
+/**
+ * The bus with no trait-scope rewriting: a machine-originated relay (an embedded
+ * program's emit) goes out on exactly the keys it names.
+ */
+declare function useRootEventBus(): EventBusContextType;
+/**
+ * Hook for subscribing to a specific event.
+ * Automatically cleans up subscription on unmount.
+ *
+ * @param event - Event name to subscribe to
+ * @param handler - Event handler function
+ *
+ * @example
+ * ```tsx
+ * useEventListener('UI:CLICK', (event) => {
+ *   console.log('Clicked:', event.payload);
+ * });
+ * ```
+ */
+declare function useEventListener(event: string, handler: BusEventListener): void;
+/**
+ * Alias for useEventListener for backward compatibility
+ */
+declare const useEventSubscription: typeof useEventListener;
+/**
+ * Hook for emitting events.
+ * Returns a memoized emit function.
+ *
+ * @returns Function to emit events
+ *
+ * @example
+ * ```tsx
+ * const emit = useEmitEvent();
+ *
+ * const handleClick = () => {
+ *   emit('UI:CLICK', { id: '123' });
+ * };
+ * ```
+ */
+declare function useEmitEvent(): (type: string, payload?: EventPayload, source?: BusEventSource) => void;
+
+/**
+ * EventBusProvider - React context provider for the event bus
+ *
+ * Provides a page-scoped event bus for trait communication.
+ * Each page has its own event bus instance.
+ *
+ * NOTE: Selection state has been moved to SelectionProvider.
+ * Use SelectionProvider for tracking selected entities.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Extended context type for backward compatibility.
+ *
+ * @deprecated getSelectedEntity and clearSelectedEntity are deprecated.
+ * Use SelectionProvider and useSelection hook instead.
+ */
+interface EventBusContextTypeExtended extends EventBusContextType {
+    /** @deprecated Use useSelection from SelectionProvider instead. */
+    getSelectedEntity: () => EntityRow | null;
+    /** @deprecated Use useSelection from SelectionProvider instead. */
+    clearSelectedEntity: () => void;
+}
+declare global {
+    var __almadarUiEventBusContext: React__default.Context<EventBusContextTypeExtended | null> | undefined;
+}
+declare const EventBusContext: React__default.Context<EventBusContextTypeExtended | null>;
+interface EventBusProviderProps {
+    children?: ReactNode;
+    /**
+     * @deprecated No-op. Logging is now gated by `@almadar/logger` —
+     * use `setLogLevel('DEBUG')` or `setNamespaceLevel('almadar:eventbus', 'DEBUG')`
+     * from `@almadar/logger` to control verbosity. Kept for API compatibility.
+     */
+    debug?: boolean;
+    /**
+     * When true, this provider does NOT register itself as the global event bus
+     * (`window.__kflowEventBus`). Use for SANDBOXED subtrees — e.g. a studio
+     * preview (`OrbPreview isolated`) embedded inside a host app — whose internal
+     * events must stay context-local and must NOT clobber the host's global bus.
+     * Children still get this bus via React context; only the global bridge is
+     * skipped. Default false (root/standalone providers own the global bridge).
+     */
+    isolated?: boolean;
+}
+declare function EventBusProvider({ children, isolated }: EventBusProviderProps): React__default.JSX.Element;
+
+export { EventBusContext as E, VideoEmbed as V, EventBusProvider as c, getGlobalEventBus as h, useEventBus as i, useEventListener as j, useEventSubscription as k, useRootEventBus as l, setGlobalEventBus as s, useEmitEvent as u };
+export type { EventBusContextType as a, EventBusContextTypeExtended as b, VideoEmbedProps as d, VideoErrorPayload as e, VideoPlayPayload as f, VideoReadyPayload as g };

package/dist/FileTree-BCFnBEuQ.d.ts

@@ -0,0 +1,254 @@
+import React__default from 'react';
+import { A11yProps, EventEmit, JsonObject, EntityPersistence, OrbitalSchema } from '@almadar/core';
+import { T as TraitLevelData, F as FieldInfo, O as OrbitalTraitInfo, a as OrbitalPageInfo, E as ExternalLink } from './avl-schema-parser-CtJxJ9KU.js';
+import { Node, Edge } from '@xyflow/react';
+
+/**
+ * Author-supplied explanations for AVL diagrams: a note per state, per
+ * transition event and per effect type, shown in a popover on hover/focus.
+ */
+interface AvlNote {
+    /** Short heading. */
+    title?: string;
+    /** The explanation. */
+    body: string;
+}
+interface AvlAnnotations {
+    /** Keyed by state name. */
+    states?: Record<string, AvlNote>;
+    /** Keyed by transition event. */
+    transitions?: Record<string, AvlNote>;
+    /** Keyed by effect type (e.g. `persist`). */
+    effects?: Record<string, AvlNote>;
+}
+
+/**
+ * AvlStateMachine — the one state-machine renderer: a trait's states and
+ * transitions laid out left→right (ELK), themed entirely through tokens, with
+ * optional execution position (active state, fired transition, visited path).
+ */
+
+interface AvlStateMachineProps extends A11yProps {
+    /** The trait to draw (see `parseTraitLevel`).
+     * @example {"name":"OrderFlow","linkedEntity":"Order","states":[{"name":"browsing","isInitial":true,"isTerminal":false},{"name":"editing","isInitial":false,"isTerminal":false},{"name":"saving","isInitial":false,"isTerminal":false},{"name":"confirmed","isInitial":false,"isTerminal":true},{"name":"failed","isInitial":false,"isTerminal":false}],"transitions":[{"from":"browsing","to":"editing","event":"EDIT","effects":[{"type":"render-ui","args":[]}],"index":0},{"from":"editing","to":"saving","event":"SAVE","effects":[{"type":"persist","args":[]},{"type":"notify","args":[]}],"index":1},{"from":"saving","to":"confirmed","event":"SAVED","effects":[{"type":"emit","args":[]},{"type":"render-ui","args":[]}],"index":2},{"from":"saving","to":"failed","event":"SAVE_FAILED","effects":[{"type":"notify","args":[]}],"index":3},{"from":"failed","to":"editing","event":"RETRY","effects":[],"index":4},{"from":"editing","to":"browsing","event":"CANCEL","effects":[{"type":"render-ui","args":[]}],"index":5},{"from":"confirmed","to":"browsing","event":"DONE","effects":[{"type":"navigate","args":[]}],"index":6}],"emittedEvents":["ORDER_SAVED"],"listenedEvents":["PAYMENT_OK"]}
+     */
+    trait: TraitLevelData;
+    /** State execution is currently in. */
+    activeState?: string;
+    /** `index` of the transition that just fired. */
+    activeTransition?: number;
+    /** States already passed through, in order. */
+    visitedStates?: string[];
+    /** Keep the active state in view: when it changes, the diagram scrolls sideways to centre it. @default false */
+    followActive?: boolean;
+    /** Emits UI:{stateClickEvent} with { stateId } when a state is clicked. */
+    stateClickEvent?: EventEmit<{
+        stateId: string;
+    }>;
+    /** Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked. */
+    transitionClickEvent?: EventEmit<{
+        index: number;
+        event: string;
+        from: string;
+        to: string;
+    }>;
+    /** Direct transition-click callback, for React hosts (e.g. a canvas node). */
+    onTransitionClick?: (transition: {
+        index: number;
+        event: string;
+        from: string;
+        to: string;
+    }) => void;
+    /** State picked in an editor (first click). */
+    selectedState?: string;
+    /** Source of a transition being drawn — the next state click picks its target. */
+    pendingSourceState?: string;
+    /** Node silhouette. @default 'pill' */
+    nodeShape?: 'pill' | 'gear';
+    /** Entity field names listed in the header. */
+    entityFields?: string[];
+    /** Flow direction. @default 'ltr' */
+    direction?: 'ltr' | 'rtl';
+    /** Show the trait header (name, entity, listens/emits). @default true */
+    showHeader?: boolean;
+    /** Author explanations shown in a popover on hover: a note per state name, per transition event and per effect type.
+     * @example {"states":{"pending":{"title":"Unpaid","body":"Every order starts here."}},"transitions":{"PAY":{"body":"Only fires when the amount is positive."}},"effects":{"persist":{"body":"Saves the order."}}}
+     */
+    annotations?: AvlAnnotations;
+    className?: string;
+}
+declare const AvlStateMachine: React__default.FC<AvlStateMachineProps>;
+
+/**
+ * AVL Flow Converter
+ *
+ * Converts an OrbitalSchema into React Flow nodes and edges
+ * for the unified AVL canvas. Reuses the existing AVL schema parser.
+ */
+
+/** Data carried by every orbital node in the unified canvas. */
+interface AvlNodeData extends JsonObject {
+    orbitalName: string;
+    entityName: string;
+    persistence: EntityPersistence;
+    fields: FieldInfo[];
+    traits: OrbitalTraitInfo[];
+    pages: OrbitalPageInfo[];
+    traitDetails: {
+        [k: string]: TraitLevelData;
+    };
+    externalLinks: ExternalLink[];
+}
+/** Data carried by edges in the unified canvas. */
+interface AvlEdgeData extends JsonObject {
+    edgeKind: string;
+    event: string | null;
+    fromTrait: string | null;
+    toTrait: string | null;
+}
+/**
+ * Transform an OrbitalSchema into React Flow nodes and edges.
+ * Pre-parses all orbital and trait details for responsive zoom.
+ */
+declare function schemaToFlowGraph(schema: OrbitalSchema): {
+    nodes: Node<AvlNodeData>[];
+    edges: Edge<AvlEdgeData>[];
+};
+
+/**
+ * ModuleCard — Structured card for the module zoom band (0.4x-1.0x).
+ *
+ * Renders AVL primitives inside a card container:
+ * - Entity section: AvlEntity glyph + AvlPersistence + AvlFieldType grid
+ * - Trait sections: MiniStateMachine per trait + AvlEffect icons + emit/listen indicators
+ * - Pages section: AvlPage squares with route labels
+ */
+
+/**
+ * ModuleCard — a compact summary card for one orbital module: its entity and
+ * fields, a mini state machine per trait, and its pages.
+ *
+ * @capabilities orbital module summary card, entity and trait overview card, app architecture node card
+ */
+interface ModuleCardProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
+    /** The orbital to summarize.
+     * @example {"orbitalName":"OrderOrbital","entityName":"Order","persistence":"persistent","fields":[{"name":"customer","type":"string","required":true,"hasDefault":false},{"name":"qty","type":"number","required":true,"hasDefault":true},{"name":"status","type":"string","required":false,"hasDefault":true}],"traits":[{"name":"OrderFlow","stateCount":5,"eventCount":7,"transitionCount":7,"emits":["ORDER_SAVED"],"listens":["PAYMENT_OK"]}],"pages":[{"name":"Orders","route":"/orders"}],"traitDetails":{"OrderFlow":{"name":"OrderFlow","linkedEntity":"Order","states":[{"name":"browsing","isInitial":true,"isTerminal":false},{"name":"editing","isInitial":false,"isTerminal":false},{"name":"saving","isInitial":false,"isTerminal":false},{"name":"confirmed","isInitial":false,"isTerminal":true},{"name":"failed","isInitial":false,"isTerminal":false}],"transitions":[{"from":"browsing","to":"editing","event":"EDIT","effects":[{"type":"render-ui","args":[]}],"index":0},{"from":"editing","to":"saving","event":"SAVE","effects":[{"type":"persist","args":[]},{"type":"notify","args":[]}],"index":1},{"from":"saving","to":"confirmed","event":"SAVED","effects":[{"type":"emit","args":[]},{"type":"render-ui","args":[]}],"index":2},{"from":"saving","to":"failed","event":"SAVE_FAILED","effects":[{"type":"notify","args":[]}],"index":3},{"from":"failed","to":"editing","event":"RETRY","effects":[],"index":4},{"from":"editing","to":"browsing","event":"CANCEL","effects":[{"type":"render-ui","args":[]}],"index":5},{"from":"confirmed","to":"browsing","event":"DONE","effects":[{"type":"navigate","args":[]}],"index":6}],"emittedEvents":["ORDER_SAVED"],"listenedEvents":["PAYMENT_OK"]}},"externalLinks":[{"targetOrbital":"PaymentOrbital","eventName":"PAYMENT_OK","direction":"in","traitName":"OrderFlow"}]}
+     */
+    data: AvlNodeData;
+    /** Author explanations per trait name (states, transition events, effect types), shown in a popover on hover.
+     * @example {"OrderFlow":{"states":{"saving":{"body":"Waiting for the server to confirm."}},"effects":{"persist":{"body":"Saves the order."}}}}
+     */
+    annotations?: Record<string, AvlAnnotations>;
+}
+/**
+ * Self-contained ModuleCard. The connection `<Handle>`s need the ReactFlow store,
+ * so standalone they'd throw ("no zustand provider as an ancestor"). When this
+ * card isn't already a flow node (`useNodeId() === null`) it bundles its own
+ * `<ReactFlowProvider>` so it renders anywhere; inside `<FlowCanvas>` it's a real
+ * node and renders raw (no nested provider). The provider is an implementation
+ * detail, never a precondition for using the component.
+ */
+declare const ModuleCard: React__default.FC<ModuleCardProps>;
+
+/**
+ * BehaviorView — an orbital's behavior: one themed state machine per trait.
+ */
+
+interface BehaviorViewProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
+    /** The orbital to summarize.
+     * @example {"orbitalName":"OrderOrbital","entityName":"Order","persistence":"persistent","fields":[{"name":"customer","type":"string","required":true,"hasDefault":false},{"name":"qty","type":"number","required":true,"hasDefault":true},{"name":"status","type":"string","required":false,"hasDefault":true}],"traits":[{"name":"OrderFlow","stateCount":5,"eventCount":7,"transitionCount":7,"emits":["ORDER_SAVED"],"listens":["PAYMENT_OK"]}],"pages":[{"name":"Orders","route":"/orders"}],"traitDetails":{"OrderFlow":{"name":"OrderFlow","linkedEntity":"Order","states":[{"name":"browsing","isInitial":true,"isTerminal":false},{"name":"editing","isInitial":false,"isTerminal":false},{"name":"saving","isInitial":false,"isTerminal":false},{"name":"confirmed","isInitial":false,"isTerminal":true},{"name":"failed","isInitial":false,"isTerminal":false}],"transitions":[{"from":"browsing","to":"editing","event":"EDIT","effects":[{"type":"render-ui","args":[]}],"index":0},{"from":"editing","to":"saving","event":"SAVE","effects":[{"type":"persist","args":[]},{"type":"notify","args":[]}],"index":1},{"from":"saving","to":"confirmed","event":"SAVED","effects":[{"type":"emit","args":[]},{"type":"render-ui","args":[]}],"index":2},{"from":"saving","to":"failed","event":"SAVE_FAILED","effects":[{"type":"notify","args":[]}],"index":3},{"from":"failed","to":"editing","event":"RETRY","effects":[],"index":4},{"from":"editing","to":"browsing","event":"CANCEL","effects":[{"type":"render-ui","args":[]}],"index":5},{"from":"confirmed","to":"browsing","event":"DONE","effects":[{"type":"navigate","args":[]}],"index":6}],"emittedEvents":["ORDER_SAVED"],"listenedEvents":["PAYMENT_OK"]}},"externalLinks":[{"targetOrbital":"PaymentOrbital","eventName":"PAYMENT_OK","direction":"in","traitName":"OrderFlow"}]}
+     */
+    data: AvlNodeData;
+}
+declare const BehaviorView: React__default.FC<BehaviorViewProps>;
+
+/**
+ * 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.
+ */
+
+interface FileTreeNode {
+    /** File or directory name */
+    name: string;
+    /** Relative path from workspace root */
+    path: string;
+    /** 'file' or 'dir' */
+    type: 'file' | 'dir';
+    /** A directory's entries — or, on a file, the files derived from it (a `.lolo` source's `.orb`), nested under it. */
+    children?: FileTreeNode[];
+    /** A short muted note after the name (e.g. "generated"). */
+    note?: string;
+    /** Has children not loaded yet: shows the toggle, and expanding it calls `onNodeExpand`. */
+    expandable?: boolean;
+    /** File size in bytes (optional, for display) */
+    size?: number;
+    /** Detected language for syntax highlighting */
+    language?: string;
+}
+/** 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;
+}
+interface FileTreeProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
+    /** The tree data (pre-nested). Ignored when `items` is provided. */
+    tree?: FileTreeNode[];
+    /** Flat node list, nested by `parentId` at render time — takes precedence
+     *  over `tree` when provided. A `parentId` with no matching row renders
+     *  that node as a root rather than dropping it. */
+    items?: FileTreeItem[];
+    /** Currently selected file path */
+    selectedPath?: string;
+    /** Currently selected node id, in flat `items` mode: the row highlights
+     *  and every ancestor auto-expands so the selection is always visible —
+     *  the "you are here" a navigation tree needs. */
+    selectedId?: string;
+    /** Visual treatment for flat `items` mode: `files` (default) keeps the
+     *  monospace file-browser look; `nav` renders a sidebar navigation tree —
+     *  regular font, document icons, roomier hit areas. */
+    look?: 'files' | 'nav';
+    /** Called when a file is clicked */
+    onFileSelect?: (path: string) => void;
+    /** Called the first time a node marked `expandable` is expanded, with its path, so its children can be loaded. */
+    onNodeExpand?: (path: string) => void;
+    /** Paths to show expanded (e.g. to reveal a node): each is expanded when it appears here, loading its children if needed. */
+    expandedPaths?: readonly string[];
+    /** Called when a node is clicked, in flat `items` mode; carries the
+     *  selected node's id. Presence-gated: binding this prop is what turns on
+     *  the click-to-select affordance, mirroring Badge's `onRemove`.
+     *  @offByDefault */
+    onNodeSelect?: (id: string) => void;
+    /** Called from the row's hover action button, in flat `items` mode;
+     *  carries that node's id. Presence-gated: binding it renders the action.
+     *  @offByDefault */
+    onNodeAction?: (id: string) => void;
+    /** Icon for the row hover action (default: plus). */
+    nodeActionIcon?: string;
+    /** Accessible label/tooltip for the row hover action. */
+    nodeActionLabel?: string;
+    /** Called when a row is dropped onto another, in flat `items` mode; carries
+     *  the moved node's id, its new parent id (`null` for a root drop), and its
+     *  index within the new parent's children. Presence-gated: binding this
+     *  prop is what turns on row dragging.
+     *  @offByDefault */
+    onNodeReorder?: (id: string, newParentId: string | null, index: number) => void;
+    /** CSS class */
+    className?: string;
+    /** Indent size per level in px (default: 16) */
+    indent?: number;
+}
+declare const FileTree: React__default.FC<FileTreeProps>;
+
+export { BehaviorView as B, ModuleCard as M, AvlStateMachine as d, FileTree as g, schemaToFlowGraph as s };
+export type { AvlAnnotations as A, FileTreeItem as F, AvlNodeData as a, AvlNote as b, AvlEdgeData as c, AvlStateMachineProps as e, BehaviorViewProps as f, FileTreeNode as h, FileTreeProps as i, ModuleCardProps as j };