@almadar/ui 6.59.0 → 6.61.0

package/dist/components/index.d.ts

@@ -11,15 +11,15 @@ export { G as GameAudioContext, a as GameAudioContextValue, e as GameAudioContro
 import { e as AvlStateMachineProps } from '../FileTree-BSfgp-HH.js';
 export { B as BehaviorView, f as BehaviorViewProps, g as FileTree, F as FileTreeItem, h as FileTreeNode, i as FileTreeProps, M as ModuleCard, j as ModuleCardProps } from '../FileTree-BSfgp-HH.js';
 import { LucideIcon } from 'lucide-react';
-import { l as ContentAnnotation, c as EditorMotion, d as EditorOperator, C as ContentSegment, L as LessonSegment } from '../cn-DIql5232.js';
-export { B as BloomLevel, n as BloomQuizBlock, o as BloomQuizBlockProps, q as CodeRunnerPanel, r as CodeRunnerPanelProps, s as CodeSimulationOutput, t as LessonUserProgress, S as SegmentRenderer, u as SegmentRendererProps, g as cn, j as parseLessonSegments } from '../cn-DIql5232.js';
+import { l as ContentAnnotation, c as EditorMotion, d as EditorOperator, C as ContentSegment, L as LessonSegment } from '../cn-CDIhHCUC.js';
+export { B as BloomLevel, n as BloomQuizBlock, o as BloomQuizBlockProps, q as CodeRunnerPanel, r as CodeRunnerPanelProps, s as CodeSimulationOutput, t as LessonUserProgress, S as SegmentRenderer, u as SegmentRendererProps, g as cn, j as parseLessonSegments } from '../cn-CDIhHCUC.js';
 import { LanguageCode } from '@almadar/core/i18n';
 import { EmojiPickPayload, ItemActionPayload, SelectionChangePayload } from '@almadar/core/patterns';
 import { T as TraitLevelData } from '../avl-schema-parser-CH1QoZw1.js';
 import { a as SlotContent, c as SlotPropValue } from '../useUISlots-1dk2TR4j.js';
 export { D as DEFAULT_SLOTS, S as SlotChangeCallback, b as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-1dk2TR4j.js';
-import '../verificationRegistry-B3dj1Zl8.js';
-export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderI18n, RenderInterpolationHandle, RenderInterpolationOptions, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useFormatContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, usePrefersReducedMotion, usePreview, usePullToRefresh, useQuerySingleton, useRenderI18n, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.js';
+import '../verificationRegistry-B5aGl7WF.js';
+export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, I18nContextValue, I18nProvider, InfiniteScrollOptions, InfiniteScrollResult, LongPressHandlers, LongPressOptions, OpenFile, PageHeadInput, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderI18n, RenderInterpolationHandle, RenderInterpolationOptions, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TapRevealOptions, TapRevealResult, TraitListenSpec, TranslateFunction, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, claimDelivery, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useFormatContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useMediaQuery, usePageHead, usePrefersReducedMotion, usePreview, usePullToRefresh, useQuerySingleton, useRenderI18n, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useValidation } from '../hooks/index.js';
 export { E as EventBusContextType, a as NavStackApi, u as useNavStack } from '../NavStackContext-04NLdXsY.js';
 export { E as EditorKeyEvent, a as KeyCaptureEntry, K as KeyCaptureTable, U as UseKeyboardRouterOptions, k as keyChord, m as mergeCaptureTables, u as useKeyboardRouter } from '../useKeyboardRouter-BW3rThep.js';
 export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-Czc2JAxo.js';
@@ -227,7 +227,7 @@ declare const SvgStack: React__default.FC<SvgStackProps>;
 type ButtonVariant = "primary" | "secondary" | "ghost" | "danger" | "success" | "warning" | "default" | "link";
 type ButtonSize = "sm" | "md" | "lg";
 /** @accessibleName label */
-interface ButtonProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, keyof A11yProps>, A11yProps {
+interface ButtonProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, keyof A11yProps | 'onClick'>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
     variant?: ButtonVariant;
@@ -258,6 +258,11 @@ interface ButtonProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButto
     disabled?: boolean;
     /** Makes the button a link: `#anchor` scrolls, an absolute URL loads, a path navigates in-app */
     href?: string;
+    /**
+     * Runs on activation, on the button or, with `href`, on the link; calling
+     * `preventDefault()` there keeps a link from following its `href`.
+     */
+    onClick?: (event: React__default.MouseEvent<HTMLButtonElement | HTMLAnchorElement>) => void;
     /** Test identifier for automated tests */
     'data-testid'?: string;
 }
@@ -337,6 +342,8 @@ interface TextareaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
     placeholder?: string;
     /** Number of visible rows */
     rows?: number;
+    /** Controlled value, for a field the program fills or clears. */
+    value?: string;
     /** Declarative event: fires on ⌘/Ctrl+Enter with `{ value }`. */
     action?: EventEmit<{
         value: string;
@@ -541,6 +548,7 @@ declare namespace AtlasImage {
 type ImageFit = 'cover' | 'contain' | 'fill' | 'none';
 type ImageAspect = 'auto' | '1/1' | '4/3' | '3/2' | '16/9' | '21/9';
 type ImageRounded = 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
+type ImagePosition = 'center' | 'top' | 'bottom' | 'left' | 'right';
 /** @accessibleName alt */
 interface ImageProps extends A11yProps {
     /** Image source URL */
@@ -557,6 +565,14 @@ interface ImageProps extends A11yProps {
     bordered?: boolean;
     /** "lazy" defers off-screen images; "eager" for above-the-fold media */
     loading?: 'lazy' | 'eager';
+    /** Which part of the image stays visible when it is cropped */
+    position?: ImagePosition;
+    /** Candidate sources at different widths (the HTML `srcset`) */
+    srcSet?: string;
+    /** Rendered widths at each breakpoint (the HTML `sizes`) */
+    sizes?: string;
+    /** The page's main image: load it first */
+    priority?: boolean;
     /** Additional class names */
     className?: string;
 }
@@ -677,6 +693,9 @@ interface AvatarProps extends A11yProps {
 }
 declare const Avatar: React__default.FC<AvatarProps>;
 
+type BandEdge = 'none' | 'curve' | 'wave' | 'arc' | 'tilt' | 'step' | 'scallop';
+type BandEdgeColor = 'background' | 'muted' | 'surface' | 'gradient' | 'inverse';
+
 /**
  * Box Component
  *
@@ -686,7 +705,7 @@ declare const Avatar: React__default.FC<AvatarProps>;
 
 type BoxPadding = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
 type BoxMargin = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "auto";
-type BoxBg = "transparent" | "primary" | "secondary" | "muted" | "accent" | "surface" | "overlay";
+type BoxBg = "transparent" | "primary" | "secondary" | "muted" | "accent" | "surface" | "overlay" | "gradient" | "inverse";
 type BoxRounded = "none" | "sm" | "md" | "lg" | "xl" | "2xl" | "full";
 type BoxShadow = "none" | "sm" | "md" | "lg" | "xl";
 interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
@@ -738,7 +757,10 @@ interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, k
      *  @payloadFor action
      */
     actionPayload?: EventPayload;
-    /** Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave */
+    /**
+     * Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave
+     * @notification
+     */
     hoverEvent?: EventEmit<{
         hovered: boolean;
     }>;
@@ -746,6 +768,20 @@ interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, k
     tapReveal?: boolean;
     /** Maximum width (CSS value, e.g., "550px", "80rem") */
     maxWidth?: string;
+    /** Shape cut into the top edge of a full-width band; "curve" uses the theme's shape */
+    edgeTop?: BandEdge;
+    /** Shape cut into the bottom edge of a full-width band; "curve" uses the theme's shape */
+    edgeBottom?: BandEdge;
+    /** Surface of the neighbouring band, which fills the cut */
+    edgeColor?: BandEdgeColor;
+    /** Mirror the edge shapes horizontally */
+    edgeFlip?: boolean;
+    /** Lay the theme's texture over the band */
+    texture?: boolean;
+    /** Content that appears or changes inside the box eases in instead of switching in one frame (new rows, swapped views, changed text), played in presentation motion (the theme's dramatic duration, standard easing) so it can be watched. Off under reduced motion. */
+    animateChanges?: boolean;
+    /** Scene behind the band's content (photo, illustration, pattern); never takes clicks */
+    backdrop?: React__default.ReactNode;
     /** Children elements */
     children?: React__default.ReactNode;
 }
@@ -1017,7 +1053,10 @@ interface StackProps extends Omit<React__default.AriaAttributes, keyof A11yProps
     as?: React__default.ElementType;
     /** Click handler */
     onClick?: (e: React__default.MouseEvent) => void;
-    /** Keyboard handler */
+    /**
+     * Keyboard handler
+     * @notification
+     */
     onKeyDown?: (e: React__default.KeyboardEvent) => void;
     /** Element id */
     id?: string;
@@ -1073,10 +1112,12 @@ interface TextHighlightProps extends A11yProps {
     onClick?: () => void;
     /**
      * Callback when highlight is hovered
+     * @notification
      */
     onMouseEnter?: () => void;
     /**
      * Callback when hover ends
+     * @notification
      */
     onMouseLeave?: () => void;
     /**
@@ -1095,7 +1136,10 @@ interface TextHighlightProps extends A11yProps {
     action?: EventEmit<{
         annotationId?: string;
     }>;
-    /** Declarative hover event — emits UI:{hoverEvent} with { hovered, annotationId } */
+    /**
+     * Declarative hover event — emits UI:{hoverEvent} with { hovered, annotationId }
+     * @notification
+     */
     hoverEvent?: EventEmit<{
         hovered: boolean;
         annotationId?: string;
@@ -1222,7 +1266,10 @@ interface UsePresenceOptions {
     animation: PresenceAnimation;
     /** Per-instance opt-out. Global opt-out is `--motion-enable` / reduced-motion. @default true */
     animate?: boolean;
-    /** Fired after the exit animation completes (before unmount). */
+    /**
+     * Fired after the exit animation completes (before unmount).
+     * @notification
+     */
     onExited?: () => void;
 }
 interface PresenceResult {
@@ -1469,6 +1516,7 @@ interface TimeSlotCellProps extends A11yProps {
     onPointerDown?: React__default.PointerEventHandler<HTMLDivElement>;
     onPointerUp?: React__default.PointerEventHandler<HTMLDivElement>;
     onPointerCancel?: React__default.PointerEventHandler<HTMLDivElement>;
+    /** @notification */
     onPointerLeave?: React__default.PointerEventHandler<HTMLDivElement>;
     "data-testid"?: string;
 }
@@ -1596,7 +1644,10 @@ interface TypewriterTextProps extends A11yProps {
     startDelay?: number;
     /** Additional class names */
     className?: string;
-    /** Called when the entire text has been revealed */
+    /**
+     * Called when the entire text has been revealed
+     * @notification
+     */
     onComplete?: () => void;
 }
 declare const TypewriterText: React__default.FC<TypewriterTextProps>;
@@ -1672,6 +1723,21 @@ interface AnimatedRevealProps extends Omit<React__default.HTMLAttributes<HTMLDiv
     delay?: number;
     /** How much of the element must be visible before triggering, 0-1 (default: 0.15) */
     threshold?: number;
+    /**
+     * scroll trigger: event emitted once (as UI:{revealEvent}) the first time the element scrolls into view; never under reduced motion
+     * @notification
+     */
+    revealEvent?: EventKey;
+    /**
+     * scroll trigger: event emitted (as UI:{enterEvent}) every time the element enters the view
+     * @notification
+     */
+    enterEvent?: EventKey;
+    /**
+     * scroll trigger: event emitted (as UI:{leaveEvent}) every time the element leaves the view after having entered it
+     * @notification
+     */
+    leaveEvent?: EventKey;
     /** Animate only the first time the element enters the viewport (default: true) */
     once?: boolean;
     /** Manual control: when trigger='manual', set this to true to animate */
@@ -2473,12 +2539,18 @@ interface Canvas2DProps extends A11yProps {
     unitClickEvent?: EventEmit<{
         unitId: string;
     }>;
-    /** Emits UI:{tileHoverEvent} with the unprojected scene { x, y } on hover. */
+    /**
+     * Emits UI:{tileHoverEvent} with the unprojected scene { x, y } on hover.
+     * @notification
+     */
     tileHoverEvent?: EventEmit<{
         x: number;
         y: number;
     }>;
-    /** Emits UI:{tileLeaveEvent} with {} on pointer leave. */
+    /**
+     * Emits UI:{tileLeaveEvent} with {} on pointer leave.
+     * @notification
+     */
     tileLeaveEvent?: EventEmit<Record<string, never>>;
     /** Maps a keydown `e.code` — optionally prefixed `Mod+` (⌘/Ctrl), `Shift+`, `Alt+` in that order — to the board's SEMANTIC event (device-agnostic input), emitted as `UI:{event}`; keystrokes inside inputs/textareas never route. */
     keyMap?: Record<string, EventKey>;
@@ -2625,6 +2697,7 @@ interface CanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11
         x: number;
         z: number;
     }>;
+    /** @notification */
     tileHoverEvent?: EventEmit<{
         x: number;
         y: number;
@@ -2632,6 +2705,7 @@ interface CanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11
         tileId: string;
         z: number;
     }>;
+    /** @notification */
     tileLeaveEvent?: EventEmit<Record<string, never>>;
     /** Feature-click event (3D only). */
     featureClickEvent?: EventEmit<{
@@ -3593,7 +3667,10 @@ interface LearningCanvasProps extends A11yProps {
         type?: string;
         index: number;
     }) => void;
-    /** Hovered shape payload: { id?, type?, index }. */
+    /**
+     * Hovered shape payload: { id?, type?, index }.
+     * @notification
+     */
     onShapeHover?: (payload: {
         id?: string;
         type?: string;
@@ -3615,7 +3692,10 @@ interface ErrorBoundaryProps {
     fallback?: ReactNode | ((error: Error, reset: () => void) => ReactNode);
     /** Additional CSS classes for the wrapper */
     className?: string;
-    /** Called when an error is caught (for logging/telemetry) */
+    /**
+     * Called when an error is caught (for logging/telemetry)
+     * @notification
+     */
     onError?: (error: Error, errorInfo: ErrorInfo) => void;
 }
 interface ErrorBoundaryState {
@@ -4495,13 +4575,6 @@ interface InputGroupProps extends Omit<InputProps, "icon" | "iconRight" | keyof
 }
 declare const InputGroup: React__default.FC<InputGroupProps>;
 
-/**
- * Menu Molecule Component
- *
- * A dropdown menu component with items, icons, dividers, and sub-menus.
- * Uses theme-aware CSS variables for styling.
- */
-
 interface MenuItem {
     /** `divider` renders a separator line instead of an item */
     type?: "item" | "divider";
@@ -4582,13 +4655,6 @@ declare namespace TopNavItem {
     var displayName: string;
 }
 
-/**
- * Modal Molecule Component
- *
- * A modal dialog component with overlay, header, content, and footer.
- * Uses theme-aware CSS variables for styling.
- */
-
 type ModalSize = "sm" | "md" | "lg" | "xl" | "full";
 /**
  * Layer 2 visual treatment for the modal pattern — orthogonal to the semantic
@@ -4600,7 +4666,10 @@ interface ModalProps extends A11yProps {
     isOpen?: boolean;
     /** Callback when modal should close (injected by slot wrapper) */
     onClose?: () => void;
-    /** Fires after the exit animation completes (the modal is about to unmount). */
+    /**
+     * Fires after the exit animation completes (the modal is about to unmount).
+     * @notification
+     */
     onExited?: () => void;
     title?: string;
     /** Modal content (can be empty if using slot content) */
@@ -5220,29 +5289,15 @@ interface IconButtonProps extends Omit<ButtonProps, 'children' | 'label' | 'icon
 }
 declare const IconButton: React__default.ForwardRefExoticComponent<IconButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
 
-/**
- * Drawer Molecule Component
- *
- * A slide-in drawer component for displaying secondary content.
- * Used by the UI Slot system for render_ui effects targeting the drawer slot.
- *
- * Features:
- * - Left/right positioning
- * - Configurable width
- * - Overlay backdrop
- * - Click-outside to dismiss
- * - Slide animation
- * - Escape key to close
- *
- * @packageDocumentation
- */
-
 type DrawerPosition = "left" | "right";
 type DrawerSize = "sm" | "md" | "lg" | "xl" | "full";
 interface DrawerProps extends A11yProps {
     /** Whether the drawer is open (defaults to true when rendered by slot wrapper) */
     isOpen?: boolean;
-    /** Fires after the exit animation completes (the drawer is about to unmount). */
+    /**
+     * Fires after the exit animation completes (the drawer is about to unmount).
+     * @notification
+     */
     onExited?: () => void;
     /** Render inside the nearest positioned ancestor (a preview frame) instead of over the window. */
     contained?: boolean;
@@ -5641,6 +5696,7 @@ interface CodeBlockProps extends A11yProps {
     /**
      * Declarative bus emit fired when this editor gains focus.
      * @tier presentation
+     * @notification
      */
     onEditorFocus?: EventEmit<{
         editorId: string;
@@ -5648,6 +5704,7 @@ interface CodeBlockProps extends A11yProps {
     /**
      * Declarative bus emit fired when this editor loses focus.
      * @tier presentation
+     * @notification
      */
     onEditorBlur?: EventEmit<{
         editorId: string;
@@ -7680,7 +7737,10 @@ interface GraphViewProps extends Omit<React__default.AriaAttributes, keyof A11yP
     edges: GraphViewEdge[];
     /** Callback when a node is clicked */
     onNodeClick?: (node: GraphViewNode) => void;
-    /** Callback when a node is hovered (null on leave) */
+    /**
+     * Callback when a node is hovered (null on leave)
+     * @notification
+     */
     onNodeHover?: (node: GraphViewNode | null) => void;
     /** Width in pixels */
     width?: number;
@@ -7913,7 +7973,10 @@ interface LightboxProps extends A11yProps {
     closeAction?: string;
     /** Direct onClose callback */
     onClose?: () => void;
-    /** Direct onIndexChange callback */
+    /**
+     * Direct onIndexChange callback
+     * @notification
+     */
     onIndexChange?: (index: number) => void;
     /** Additional CSS classes */
     className?: string;
@@ -7998,19 +8061,6 @@ interface DataDndProps {
     dndRoot?: boolean;
 }
 
-/**
- * DataGrid Molecule
- *
- * A simplified, schema-driven card grid for iterating over entity data.
- * Extracted from the CardGrid organism with all complexity removed:
- * no built-in search, sort, filter, pagination, selection, or bulk actions.
- *
- * Accepts `fields` config for per-field rendering control (icon, variant, format)
- * and `itemActions` for per-item event bus wiring.
- *
- * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
- */
-
 /** A DataGrid field is the shared display-field shape: every slot (title, badge, format, colour) is declared on it. */
 type DataGridField = DisplayField;
 interface DataGridItemAction {
@@ -8100,6 +8150,8 @@ interface DataGridProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
      * @deprecated Use children render prop in React code. This prop exists for pattern registry sync.
      */
     renderItem?: (item: EntityRow, index: number) => React__default.ReactNode;
+    /** Entrance animation each card plays when it mounts; a card that changes place glides there. Lists rendered inside the grid share its movement, so a card moved between them glides across */
+    itemEnter?: 'none' | 'fade' | 'rise' | 'scale' | 'slide';
     /** Max items to show before "Show More" button. Defaults to 0 (disabled). */
     pageSize?: number;
     /**
@@ -8115,26 +8167,11 @@ interface DataGridProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
      *  field whose type is relation. Same contract DetailPanel takes. */
     relationsData?: Record<string, readonly RelationOption[]>;
 }
-declare function DataGrid({ entity, emptyIcon, emptyTitle, emptyDescription, emptyAction, fields, columns, itemActions, itemClickEvent, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, skeleton, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, surface, relationsData, ...rest }: DataGridProps): React__default.JSX.Element;
+declare function DataGrid({ entity, emptyIcon, emptyTitle, emptyDescription, emptyAction, fields, columns, itemActions, itemClickEvent, maxInlineActions, scrollX, cols, gap, minCardWidth, className, isLoading, skeleton, error, imageField, selectable, selectionEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, renderItem: schemaRenderItem, dragGroup, accepts, sortable, dropEvent, reorderEvent, positionEvent, dndItemIdField, dndRoot, look, surface, relationsData, itemEnter, ...rest }: DataGridProps): React__default.JSX.Element;
 declare namespace DataGrid {
     var displayName: string;
 }
 
-/**
- * DataList Molecule
- *
- * A simplified, schema-driven list for iterating over entity data.
- * Extracted from the List organism with all complexity removed:
- * no built-in search, filter, selection, bulk actions, or custom renderers.
- * Ordering is available via `sortBy`/`sortDirection`, but it orders only the
- * rows handed in — a set larger than its `limit` must be ordered upstream.
- *
- * Accepts `fields` config for per-field rendering control (icon, variant, format)
- * and `itemActions` for per-item event bus wiring.
- *
- * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button, Icon.
- */
-
 /** A DataList field is the shared display-field shape: every slot (title, badge, format, colour) is declared on it. */
 type DataListField = DisplayField;
 interface DataListItemAction {
@@ -8150,6 +8187,8 @@ interface DataListItemAction {
     when?: RowActionCondition;
     /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
     payload?: RowActionPayload;
+    /** Page the action opens instead of emitting; `{{row.<field>}}` is replaced with the row's value. */
+    navigatesTo?: string;
 }
 interface DataListSwipeAction {
     /** Button label */
@@ -8178,6 +8217,8 @@ interface DataListProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
     columns?: readonly DataListField[];
     /** Per-item action buttons */
     itemActions?: readonly DataListItemAction[];
+    /** Entrance animation each row plays when it mounts, so an item arriving in this list (moved from another) animates in */
+    itemEnter?: 'none' | 'fade' | 'rise' | 'scale' | 'slide';
     /** Max inline action buttons before the rest collapse into a "⋯" overflow menu. Omit = all inline. */
     maxInlineActions?: number;
     /** When set, the whole row is clickable and emits UI:{itemClickEvent} with
@@ -8277,25 +8318,11 @@ interface DataListProps extends DataDndProps, EmptyStateSlotProps, A11yProps {
      *  field whose type is relation. Same contract DetailPanel takes. */
     relationsData?: Record<string, readonly RelationOption[]>;
 }
-declare function DataList({ entity, fields, columns, itemActions, maxInlineActions, itemClickEvent, gap, variant, groupBy, groupFormat, senderField, senderLabelField, currentUser, emptyMessage, emptyIcon, emptyTitle, emptyDescription, emptyAction, className, isLoading, skeleton, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, sortBy, sortDirection, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, surface, relationsData, ...rest }: DataListProps): React__default.JSX.Element;
+declare function DataList({ entity, fields, columns, itemActions, itemEnter, maxInlineActions, itemClickEvent, gap, variant, groupBy, groupFormat, senderField, senderLabelField, currentUser, emptyMessage, emptyIcon, emptyTitle, emptyDescription, emptyAction, className, isLoading, skeleton, error, reorderable: _reorderable, reorderEvent: _reorderEvent, swipeLeftEvent: _swipeLeftEvent, swipeLeftActions: _swipeLeftActions, swipeRightEvent: _swipeRightEvent, swipeRightActions: _swipeRightActions, longPressEvent: _longPressEvent, infiniteScroll, loadMoreEvent, hasMore, children, pageSize, sortBy, sortDirection, renderItem: schemaRenderItem, dragGroup, accepts, sortable: sortableProp, dropEvent, reorderEvent: dndReorderEvent, positionEvent, dndItemIdField, dndRoot, look, surface, relationsData, ...rest }: DataListProps): React__default.JSX.Element;
 declare namespace DataList {
     var displayName: string;
 }
 
-/**
- * TableView Molecule
- *
- * A simplified, schema-driven column table for iterating over entity data.
- * The table-shaped sibling of DataList (rows) and DataGrid (cards): same
- * `entity` + `columns`/`fields` + `itemActions` contract and the same
- * `useDataDnd` drag-to-reorder machinery, rendered as aligned columns with a
- * header. All complexity is opt-in: selection, drag-reorder, and per-column
- * sorting are each enabled by their own props and emit via the event bus.
- *
- * Uses atoms only internally: Box, VStack, HStack, Typography, Badge, Button,
- * Icon, Checkbox, Divider.
- */
-
 interface TableViewColumn {
     /** Stable column key (React key + default value lookup). */
     key: string;
@@ -8629,7 +8656,10 @@ interface CarouselProps<T = CarouselItem> extends A11yProps {
     showArrows?: boolean;
     /** Enable infinite loop */
     loop?: boolean;
-    /** Declarative event name for slide change */
+    /**
+     * Declarative event name for slide change
+     * @notification
+     */
     slideChangeEvent?: EventEmit<{
         index: number;
     }>;
@@ -9015,6 +9045,7 @@ type QrScanResult = EventPayload & {
 interface QrScannerProps extends A11yProps {
     onScan?: (result: QrScanResult) => void;
     scanEvent?: EventEmit<QrScanResult>;
+    /** @notification */
     onError?: (error: Error) => void;
     facingMode?: 'environment' | 'user';
     paused?: boolean;
@@ -9142,24 +9173,6 @@ interface RichTextEditorProps extends A11yProps {
 declare function sanitizeRichHtml(html: string): string;
 declare const RichTextEditor: React__default.FC<RichTextEditorProps>;
 
-/**
- * DocumentPanel Molecule
- *
- * The document writing surface, shaped like the established editors
- * (Notion / Google Docs / Gutenberg's canvas): a big inline-editable title
- * with the content DIRECTLY beneath it — nothing sits between the title and
- * the words. The only chrome is a compact top-right cluster in the header
- * row: while reading it holds a quiet Edit and the "⋯" actions menu; while
- * editing it swaps to the autosave hint + Done. Document metadata lives in
- * a sibling DocumentDetails card (a Gutenberg-style settings rail), never
- * inside this surface.
- *
- * The title commits on blur/Enter (select-on-focus, so typing replaces a
- * placeholder name); the body autosaves through the embedded
- * RichTextEditor's change stream; clicking the read body starts an editing
- * session with the cursor in the text.
- */
-
 interface DocumentPanelAction {
     label: string;
     event?: EventKey;
@@ -10064,7 +10077,10 @@ interface SidebarProps extends A11yProps {
     collapsed?: boolean;
     /** Default collapsed state */
     defaultCollapsed?: boolean;
-    /** Event emitted when collapse state changes, payload: { collapsed: boolean } */
+    /**
+     * Event emitted when collapse state changes, payload: { collapsed: boolean }
+     * @notification
+     */
     collapseChangeEvent?: EventEmit<{
         collapsed: boolean;
     }>;
@@ -10134,7 +10150,10 @@ interface ConfirmDialogProps extends A11yProps {
     isOpen?: boolean;
     /** Callback when dialog is closed (injected by slot wrapper) */
     onClose?: () => void;
-    /** Fires after the exit animation completes (the dialog is about to unmount). */
+    /**
+     * Fires after the exit animation completes (the dialog is about to unmount).
+     * @notification
+     */
     onExited?: () => void;
     /** Callback when action is confirmed (injected by slot wrapper) */
     onConfirm?: () => void;
@@ -10304,7 +10323,10 @@ interface WizardContainerProps extends A11yProps {
     steps: WizardStep[];
     /** Current step index (controlled) - accepts number or string for generated code compatibility */
     currentStep?: number | string;
-    /** Callback when step changes */
+    /**
+     * Callback when step changes
+     * @notification
+     */
     onStepChange?: (stepIndex: number) => void;
     /** Callback when wizard is completed */
     onComplete?: () => void;
@@ -10442,23 +10464,6 @@ interface ContentRendererProps extends Omit<DisplayStateProps, keyof A11yProps>,
 }
 declare const ContentRenderer: React__default.FC<ContentRendererProps>;
 
-/**
- * Chart Organism Component
- *
- * Data visualization. Supports bar / line / pie / area / donut / scatter /
- * histogram chart types. Renders multi-series natively for bar / line / area
- * via the `series` prop. Pie / donut consume the first series only. Scatter
- * plots raw {x,y} points; histogram renders pre-binned data as gap-less bars.
- *
- * Bus integration:
- *  - top-level `actions[].event` → `UI:{event}` on click (existing behavior)
- *  - per-data-point `drillEvent` → `UI:{drillEvent}` with `{ label, value, seriesLabel? }`
- *
- * Time axis: when `timeAxis: true`, ISO date labels are formatted via Intl
- * (e.g. "Mar 2026"). Positioning remains evenly spaced (real time-scale
- * alignment is deliberately deferred).
- */
-
 type ChartType = "bar" | "line" | "pie" | "area" | "donut" | "scatter" | "histogram";
 /**
  * Layer 2 visual treatment for the chart pattern — drives the chart
@@ -10817,13 +10822,20 @@ interface ImportSourceOption {
     /** Disable the option */
     disabled?: boolean;
 }
+/** A picked file as a program can receive it: plain JSON, its contents read as UTF-8 text. */
+interface ImportedFile {
+    name: string;
+    size: number;
+    type: string;
+    text: string;
+}
 interface ImportSourcePickerProps extends A11yProps {
     /** Source options to render */
     sources: ImportSourceOption[];
     /** Called with the source id when an 'action' option is picked */
     onSelect?: (sourceId: string) => void;
-    /** Called with the chosen files when a 'file' option resolves */
-    onFilesSelected?: (files: File[]) => void;
+    /** Called with the chosen files, read as text, when a 'file' option resolves */
+    onFilesSelected?: (files: ImportedFile[]) => void;
     /** Optional heading above the options */
     title?: string;
     /** Generic slot for additional sources rendered below the options */
@@ -11218,19 +11230,6 @@ interface StatCardProps extends DisplayStateProps, Omit<React__default.AriaAttri
 }
 declare const StatCard: React__default.FC<StatCardProps>;
 
-/**
- * Timeline Organism Component
- *
- * A vertical timeline component for displaying chronological events.
- * Composes atoms and molecules for layout, uses CSS variables for theming.
- *
- * Orbital Component Interface Compliance:
- * - Entity binding with auto-fetch when entity is a string
- * - Event emission via useEventBus (UI:* events)
- * - isLoading and error state props
- * - className for external styling
- */
-
 type TimelineItemStatus = "complete" | "active" | "pending" | "error";
 /**
  * Layer 2 visual treatment for the timeline pattern — orthogonal to the
@@ -11326,15 +11325,6 @@ interface DetailTab {
     content?: React__default.ReactNode;
 }
 
-/**
- * DetailPanel Organism Component
- *
- * Composes atoms and molecules to create a professional detail view.
- *
- * Data is provided by the runtime via the `entity` prop.
- * Extends DisplayStateProps (see ./types.ts) and declares `entity?: EntityRow`.
- */
-
 /** Relation descriptor injected onto a display field — target entity +
  *  cardinality, mirroring the `.lolo` `{type:"relation", relation:{...}}`
  *  descriptor. */
@@ -11486,7 +11476,7 @@ interface DetailPanelProps extends DisplayStateProps, A11yProps {
     /** Line items composed in instead of `lineItems` — e.g. the child rows' own trait (ledger). */
     lineItemsContent?: React__default.ReactNode;
     /** Record fields shown as the document's totals, in order (ledger). */
-    totals?: readonly DisplayField[];
+    totals?: readonly FieldDef[];
     /** The thread shown as the main surface (conversation). */
     thread?: readonly EntityWith<ReplyNodeRow>[];
     /** The thread composed in instead of `thread` — e.g. the replies' own trait with its composer (conversation). */
@@ -11496,20 +11486,6 @@ interface DetailPanelProps extends DisplayStateProps, A11yProps {
 }
 declare const DetailPanel: React__default.FC<DetailPanelProps>;
 
-/**
- * Form Organism Component
- *
- * A form container component with submit/reset handling.
- * Supports both children-based and schema-based form generation.
- * Renders correct input types based on field definitions including relations.
- *
- * Extended for inspection forms with:
- * - Conditional field visibility via S-expressions
- * - Hidden calculations that emit GLOBAL_VARIABLE_SET events
- * - Violation triggers that emit VIOLATION_DETECTED events
- * - Nested sections with collapsible support
- */
-
 /**
  * S-Expression type for conditional logic (re-export from @almadar/evaluator)
  */
@@ -11771,6 +11747,7 @@ interface SplitPaneProps extends Omit<React__default.AriaAttributes, keyof A11yP
     /** Called with the new ratio while dragging. Providing this makes `ratio`
      *  controlled — the rendered split always tracks the prop instead of
      *  internal state, mirroring a controlled input. Omit for uncontrolled
+     * @notification
      *  (self-tracked) behavior. */
     onRatioChange?: (ratio: number) => void;
 }
@@ -11946,22 +11923,27 @@ interface DockLayoutProps extends Omit<React__default.AriaAttributes, keyof A11y
     secondarySidebarWidth?: number;
     /** Whether `sidebar` is collapsed (controlled; the layout keeps its own state when omitted). */
     sidebarCollapsed?: boolean;
+    /** @notification */
     onSidebarCollapsedChange?: (collapsed: boolean) => void;
     /** Sidebar size as a SplitPane ratio (0-100, percentage of the sidebar/main split). @default 20 */
     sidebarWidth?: number;
+    /** @notification */
     onSidebarWidthChange?: (width: number) => void;
     /** Minimum sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 160 */
     sidebarMinSize?: number;
     /** Whether `bottomPanel` is collapsed (controlled; the layout keeps its own state when omitted). */
     bottomPanelCollapsed?: boolean;
+    /** @notification */
     onBottomPanelCollapsedChange?: (collapsed: boolean) => void;
     /** Bottom panel size as a SplitPane ratio (0-100, percentage given to the panel). @default 30 */
     bottomPanelHeight?: number;
+    /** @notification */
     onBottomPanelHeightChange?: (height: number) => void;
     /** Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120 */
     bottomPanelMinSize?: number;
     /** Whether `secondarySidebar` is collapsed (controlled; the layout keeps its own state when omitted). */
     secondarySidebarCollapsed?: boolean;
+    /** @notification */
     onSecondarySidebarCollapsedChange?: (collapsed: boolean) => void;
     /** The mobile variant; decided by the viewport (narrower than 1024px) when omitted. */
     compact?: boolean;
@@ -12594,6 +12576,12 @@ interface DashboardLayoutProps {
      *  or any other top-bar action by appending entries. Empty array (default)
      *  renders nothing. */
     topBarActions?: TopBarAction[];
+    /** Account-menu entries listed above Sign out (Settings, a profile page), each
+     *  `{icon, label, event?, navigatesTo?, variant?}` like `topBarActions`. */
+    userMenuItems?: TopBarAction[];
+    /** Content fills the area edge to edge — no padding, no max width, full height
+     *  (workspaces, canvases, maps). */
+    fullBleed?: boolean;
     /** Notification list. Pass an empty array to show the bell with no
      *  badge; omit / pass null to hide the bell entirely. */
     notifications?: NotificationItem[] | null;