@almadar/shell-web 0.1.0 → 1.1.0

package/dist/components/index.js

@@ -1,35 +1,32 @@
+"use client";
 export { assertUniqueSlotsPerHost } from '../chunk-5QTYQTPS.js';
-export { BehaviorView } from '../chunk-DLZF4PVE.js';
-export { ModuleCard } from '../chunk-2PY54Z44.js';
-import { JsonTreeEditor } from '../chunk-U6QRZASX.js';
-export { JsonTreeEditor } from '../chunk-U6QRZASX.js';
-export { SharedEntityStoreContext, createSharedEntityStore, runTickFrame, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, usePreview, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useTickVisibility, useTraitListens, useUIEvents, useValidation } from '../chunk-73SRAB4P.js';
-import { resolveSheetDirection, frameRect, GridPicker, FormSection } from '../chunk-GYTPOFVC.js';
-export { Card as ActionCard, ActionPalette, ActionTile, ActivationBlock, ActivityRail, AgentActivityFeed, AgentActivityRow, AgentChatFeed, AgentThinkingRow, Alert, AlgoGraphCanvas, AlgorithmCanvas, AnimatedCounter, AuthLayout, BiologyCanvas, BloomQuizBlock, BranchingLogicBuilder, Breadcrumb, ButtonGroup, COMPACT_MEDIA_QUERY, CalendarGrid, Canvas, Canvas2D, Carousel, ChangeList, Chart, ChartLegend, ChatBar, ChemistryCanvas, ChoiceButton, CodeBlock, CodeRunnerPanel, CommandPalette, CommitRow, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DateRangePicker, DateRangeSelector, DetailPanel, DialogueBubble, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DockLayout, DocumentDetails, DocumentPanel, DocumentViewer, StateMachineView as DomStateMachineVisualizer, DrawShapeLayer, DrawSprite, DrawSpriteLayer, DrawText, DrawTextLayer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EdgeDecoration, EmojiPicker, ErrorBoundary, ErrorState, FEATURE_COLORS, FLOOR_HEIGHT, FeatureCard, FeatureGrid, FilterGroup, Flex, FlipCard, FloatingActionButton, FloatingToolbar, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, FxOverlay, GameAudioContext, GameAudioCue, GameAudioProvider, GameAudioToggle, GameHud, GameMenu, GameShell, Gantt, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, Header, HealthBar, IconButton, ImportPreviewTree, ImportProgress, ImportSourcePicker, InputGroup, JazariStateMachine, LearningCanvas, LearningScene3D, Lightbox, LikertScale, LineChart, LoadingState, MachinePanel, MapView, MarkdownContent, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, Navigation, NumberStepper, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, PageHeader, PageTransition, Pagination, PhysicsCanvas, PositionedCanvas, ProgressDots, PullToRefresh, QrScanner, QuizBlock, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, RichTextEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SegmentRenderer, SequenceBar, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SkeletonTree, SlotContentRenderer, SocialProof, SortableList, Split, SplitPane, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, SubagentTracePanel, SwipeableRow, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagInput, Timeline, TimerDisplay, Toast, ToastSlot, TopNavItem, TraitFrame, TraitSlot, TraitStateViewer, UISlotComponent, UISlotRenderer, UploadDropZone, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, activityRowFacts, applyCompletion, applySuggestions, arrowBetween, billboardLabel, createUnitAnimationState, cylinderBetween, dispatchCommandPaletteCommand, get3DClickPayload, getCurrentFrame, groupIntoConversations, inferDirection, isoToScreen, meshSphere, parseEditFocus, preloadCodeHighlighter, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, sanitizeRichHtml, screenToIso, tickAnimationState, toCodeLanguage, transitionAnimation, useCamera, useCompactLayout, useDockLayout, useGameAudio, useGameAudioContext, useImageCache } from '../chunk-GYTPOFVC.js';
-export { FileTree } from '../chunk-YDNJLLG6.js';
-import '../chunk-KVQS4GXU.js';
-import '../chunk-L677XGY3.js';
-import '../chunk-FP3WIKTC.js';
-export { Accordion } from '../chunk-42FY4RYA.js';
-export { EmptyState } from '../chunk-FAJDTHWC.js';
-import '../chunk-GAR5TQ5B.js';
-import { ThemedPortal } from '../chunk-SJGJJKBY.js';
-export { Popover, Tooltip } from '../chunk-SJGJJKBY.js';
-import '../chunk-DZ42OJQC.js';
-export { parseLessonSegments, parseMarkdownWithCodeBlocks } from '../chunk-P4LNHAFI.js';
+export { BehaviorView } from '../chunk-YYIHRIDH.js';
+export { ModuleCard } from '../chunk-VUIACGDU.js';
+import { JsonTreeEditor } from '../chunk-ILQXJ2AR.js';
+export { JsonTreeEditor } from '../chunk-ILQXJ2AR.js';
+export { SharedEntityStoreContext, createSharedEntityStore, runTickFrame, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, usePreview, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useTickVisibility, useTraitListens, useUIEvents, useValidation } from '../chunk-UU57VNS2.js';
+import { resolveSheetDirection, frameRect, GridPicker, FormSection } from '../chunk-MS4K3K2R.js';
+export { Card as ActionCard, ActionPalette, ActionTile, ActivationBlock, ActivityRail, AgentActivityFeed, AgentActivityRow, AgentChatFeed, AgentThinkingRow, Alert, AlgoGraphCanvas, AlgorithmCanvas, AnimatedCounter, AuthLayout, BiologyCanvas, BloomQuizBlock, BranchingLogicBuilder, Breadcrumb, ButtonGroup, COMPACT_MEDIA_QUERY, CalendarGrid, Canvas, Canvas2D, Carousel, ChangeList, Chart, ChartLegend, ChatBar, ChemistryCanvas, ChoiceButton, CodeBlock, CodeRunnerPanel, CommandPalette, CommitRow, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DateRangePicker, DateRangeSelector, DetailPanel, DialogueBubble, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DockLayout, DocumentDetails, DocumentPanel, DocumentViewer, StateMachineView as DomStateMachineVisualizer, DrawFxLayer, DrawGroup, DrawMesh, DrawShape, DrawShapeLayer, DrawSkinnedMesh, DrawSprite, DrawSpriteLayer, DrawText, DrawTextLayer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EdgeDecoration, EmojiPicker, ErrorBoundary, ErrorState, FEATURE_COLORS, FLOOR_HEIGHT, FeatureCard, FeatureGrid, FilterGroup, Flex, FlipCard, FloatingActionButton, FloatingToolbar, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, FxOverlay, GameAudioContext, GameAudioCue, GameAudioProvider, GameAudioToggle, GameHud, GameMenu, GameShell, Gantt, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, GuestView, Header, HealthBar, IconButton, ImportPreviewTree, ImportProgress, ImportSourcePicker, InputGroup, JazariStateMachine, LearningCanvas, Lightbox, LikertScale, LineChart, LoadingState, MachinePanel, MapView, MarkdownContent, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, Navigation, NumberStepper, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, PageHeader, PageTransition, Pagination, PhysicsCanvas, PositionedCanvas, ProgressDots, PullToRefresh, QrScanner, QuizBlock, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, RichTextEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SegmentRenderer, SequenceBar, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SkeletonTree, SlotContentRenderer, SocialProof, SortableList, Split, SplitPane, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, SubagentTracePanel, SwipeableRow, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagInput, Timeline, TimerDisplay, Toast, ToastSlot, TopNavItem, TraitFrame, TraitSlot, TraitStateViewer, UISlotComponent, UISlotRenderer, UploadDropZone, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, activityRowFacts, applyCompletion, applySuggestions, createUnitAnimationState, dispatchCommandPaletteCommand, getCurrentFrame, groupIntoConversations, inferDirection, isoToScreen, parseEditFocus, preloadCodeHighlighter, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, sanitizeRichHtml, screenToIso, tickAnimationState, toCodeLanguage, transitionAnimation, useCamera, useCompactLayout, useDockLayout, useGameAudio, useGameAudioContext, useImageCache } from '../chunk-MS4K3K2R.js';
+export { FileTree } from '../chunk-57DC34LY.js';
+import '../chunk-4YJ53G7S.js';
+import '../chunk-AGVSO4WY.js';
+import '../chunk-7N6ZPHQ5.js';
+export { Accordion } from '../chunk-REXYVBUO.js';
+export { EmptyState } from '../chunk-AGXD77SL.js';
+import '../chunk-M74BCDBQ.js';
+import '../chunk-PCR37T3U.js';
+import { ThemedPortal } from '../chunk-PRLHKBXG.js';
+export { Popover, Tooltip } from '../chunk-PRLHKBXG.js';
+import '../chunk-FAKU5F62.js';
+export { parseLessonSegments, parseMarkdownWithCodeBlocks } from '../chunk-2WGR4TDJ.js';
 import '../chunk-TZZBINQY.js';
-export { DrawFxLayer, DrawGroup, DrawMesh, DrawShape, DrawSkinnedMesh } from '../chunk-PC7K4SK7.js';
-import '../chunk-VFF5OO47.js';
-import '../chunk-DFNZUYX4.js';
-import '../chunk-B4BU77LT.js';
-import '../chunk-6P3MWXYE.js';
-import '../chunk-DYEKAA4L.js';
-export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-R5O5AUPI.js';
-export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-L2DEKY4J.js';
-import '../chunk-AILY3XPS.js';
+import '../chunk-ZDRDJKYB.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-PRXQGGCO.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-VO2TTLS5.js';
+import '../chunk-AE7VCQB6.js';
 import '../chunk-3BBUBJFF.js';
 export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-YHMRX6YA.js';
-import { VStack, Button, HStack, GameIcon, Typography, Box, useTranslate, Badge, Icon, cn, Select, domPassthrough, Switch, Input } from '../chunk-MBQAMMSE.js';
+import { VStack, Button, HStack, GameIcon, Typography, Box, useTranslate, Badge, Icon, cn, Select, domPassthrough, Switch, Input } from '../chunk-4YXBKHHM.js';
 import { getKnownPatterns, getPatternDefinition } from '../chunk-A2LR6VQQ.js';
 import '../chunk-P4ZFUQFF.js';
 import '../chunk-G7DCAZ22.js';

package/dist/context/index.d.ts

@@ -1,9 +1,8 @@
 export { U as UISlotContext, a as UISlotProvider, u as useSlotContent, b as useSlotHasContent, c as useUISlots } from '../UISlotContext-Dl_ewwCI.js';
 export { T as ThemeMode, r as resolveThemeForRuntime, t as themeTokensToCssVars } from '../themeTokens-CRd8AEDF.js';
-export { A as ARBITRARY_CLASS_STYLE_ID, a as ArbitraryClassCompiler, b as ArbitraryClassCompilerProvider, c as ArbitraryClassCompilerProviderProps, C as CurrentPagePathContext, d as CurrentPagePathProvider, e as CurrentPagePathProviderProps, D as DesignThemeProvider, O as OrbitalThemeProvider, f as OrbitalThemeProviderProps, u as useArbitraryClassStyles, g as useCurrentPagePath, h as useDesignTheme } from '../ArbitraryClassCompiler-Mzabq-UB.js';
-export { U as UserContext, a as UserContextValue, b as UserData, c as UserProvider, d as UserProviderProps, u as useHasPermission, e as useHasRole, f as useUser, g as useUserForEvaluation } from '../UserContext-DqWeZkUZ.js';
+export { A as ARBITRARY_CLASS_STYLE_ID, a as ArbitraryClassCompiler, b as ArbitraryClassCompilerProvider, c as ArbitraryClassCompilerProviderProps, C as CurrentPagePathContext, d as CurrentPagePathProvider, e as CurrentPagePathProviderProps, D as DesignThemeProvider, O as OrbitalThemeProvider, f as OrbitalThemeProviderProps, U as UserContext, g as UserContextValue, h as UserData, i as UserProvider, j as UserProviderProps, u as useArbitraryClassStyles, k as useCurrentPagePath, l as useDesignTheme, m as useHasPermission, n as useHasRole, o as useUser, p as useUserForEvaluation } from '../ArbitraryClassCompiler-CO_iASBn.js';
 export { ANONYMOUS_USER, UISlot } from '@almadar/core';
 export { S as SlotChangeCallback, a as SlotContent, b as SlotRenderConfig, U as UISlotManager } from '../useUISlots-CiobNFGb.js';
 import 'react';
-import '../EventBusProvider-CVwjkV_2.js';
+import '../EventBusProvider-BFFHfN4O.js';
 import '../ThemeContext-DJmO59xd.js';

package/dist/context/index.js

@@ -1,7 +1,8 @@
-export { DesignThemeProvider, useDesignTheme } from '../chunk-EQAMU2ZC.js';
-export { ANONYMOUS_USER, ARBITRARY_CLASS_STYLE_ID, ArbitraryClassCompilerProvider, CurrentPagePathContext, CurrentPagePathProvider, OrbitalThemeProvider, UISlotContext, UISlotProvider, UserContext, UserProvider, useArbitraryClassStyles, useCurrentPagePath, useHasPermission, useHasRole, useSlotContent, useSlotHasContent, useUISlots, useUser, useUserForEvaluation } from '../chunk-AILY3XPS.js';
+"use client";
+export { DesignThemeProvider, useDesignTheme } from '../chunk-UTDC2NEA.js';
+export { ANONYMOUS_USER, ARBITRARY_CLASS_STYLE_ID, ArbitraryClassCompilerProvider, CurrentPagePathContext, CurrentPagePathProvider, OrbitalThemeProvider, UISlotContext, UISlotProvider, UserContext, UserProvider, useArbitraryClassStyles, useCurrentPagePath, useHasPermission, useHasRole, useSlotContent, useSlotHasContent, useUISlots, useUser, useUserForEvaluation } from '../chunk-AE7VCQB6.js';
 export { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-3BBUBJFF.js';
 import '../chunk-YHMRX6YA.js';
-import '../chunk-MBQAMMSE.js';
+import '../chunk-4YXBKHHM.js';
 import '../chunk-P4ZFUQFF.js';
 import '../chunk-G7DCAZ22.js';

package/dist/core.d.ts

@@ -1,14 +1,14 @@
 import * as React$1 from 'react';
 import React__default, { RefObject } from 'react';
-import { A11yProps, AssetUrl, EventKey, TextureAtlas, Tilesheet, SpriteSheetAtlas, EventPayload, EventEmit, FieldValue, SExpr, Asset, OrbitalSchema, OrbitalPage, NavStackEntry, IconFamily as IconFamily$1, JsonValue, TraitIndex, SurfaceMode } from '@almadar/core';
+import { A11yProps, AssetUrl, EventKey, TextureAtlas, Tilesheet, SpriteSheetAtlas, EventPayload, EventEmit, FieldValue, SExpr, Asset, OrbitalSchema, OrbitalPage, NavStackEntry, IconFamily as IconFamily$1, JsonValue, SurfaceMode } from '@almadar/core';
 export { BusEvent, BusEventListener, BusEventSource, BusEventListener as EventListener, SurfaceMode, Unsubscribe, comparePathSpecificity, matchPath, matchPathAmong } from '@almadar/core';
-import { I as IconInput } from './fx-CmQjnHmT.js';
-export { B as Badge, b as BadgeColor, c as BadgeProps, d as BadgeSize, e as BadgeVariant, C as CONFETTI_BURST_KEYFRAMES, f as CONFETTI_COLORS, g as ColorToken, h as ConfettiParticle, D as DisplayField, i as DisplayFieldFormat, j as DisplayFieldVariant, F as FxItem, k as FxLifecycle, l as FxOverlayItem, m as FxOverlayKind, a as FxPreset, n as FxProceduralShape, o as FxSpace, p as FxView, q as Icon, r as IconAnimation, s as IconProps, t as IconSize, u as ImageSource, L as LinkAction, P as Point, R as Rect, U as UiError, v as createConfettiParticles, w as fxHash01, x as fxLifecycle, y as resolveFxView, z as resolveIcon } from './fx-CmQjnHmT.js';
-export { B as Button, a as ButtonProps, b as ButtonSize, c as ButtonVariant, I as Input, d as InputProps, P as PatternTile, e as PatternTileProps, f as PatternVariant, S as Select, g as SelectOption, h as SelectOptionGroup, i as SelectProps, j as getTileDimensions } from './Select-mDZIwNqN.js';
-export { E as EventBusContext, a as EventBusContextType, b as EventBusContextTypeExtended, c as EventBusProvider, V as VideoEmbed, d as VideoEmbedProps, e as VideoErrorPayload, f as VideoPlayPayload, g as VideoReadyPayload, h as getGlobalEventBus, s as setGlobalEventBus, u as useEmitEvent, i as useEventBus, j as useEventListener, k as useEventSubscription, l as useRootEventBus } from './EventBusProvider-CVwjkV_2.js';
+import { I as IconInput } from './fx-Br8zjvu9.js';
+export { B as Badge, b as BadgeColor, c as BadgeProps, d as BadgeSize, e as BadgeVariant, C as CONFETTI_BURST_KEYFRAMES, f as CONFETTI_COLORS, g as ColorToken, h as ConfettiParticle, D as DisplayField, i as DisplayFieldFormat, j as DisplayFieldVariant, F as FxItem, k as FxLifecycle, l as FxOverlayItem, m as FxOverlayKind, a as FxPreset, n as FxProceduralShape, o as FxSpace, p as FxView, q as Icon, r as IconAnimation, s as IconProps, t as IconSize, u as ImageSource, L as LinkAction, P as Point, R as Rect, U as UiError, v as createConfettiParticles, w as fxHash01, x as fxLifecycle, y as resolveFxView, z as resolveIcon } from './fx-Br8zjvu9.js';
+export { B as Button, a as ButtonProps, b as ButtonSize, c as ButtonVariant, I as Input, d as InputProps, P as PatternTile, e as PatternTileProps, f as PatternVariant, S as Select, g as SelectOption, h as SelectOptionGroup, i as SelectProps, j as getTileDimensions } from './Select-C2Uq6t86.js';
+export { E as EventBusContext, a as EventBusContextType, b as EventBusContextTypeExtended, c as EventBusProvider, V as VideoEmbed, d as VideoEmbedProps, e as VideoErrorPayload, f as VideoPlayPayload, g as VideoReadyPayload, h as getGlobalEventBus, s as setGlobalEventBus, u as useEmitEvent, i as useEventBus, j as useEventListener, k as useEventSubscription, l as useRootEventBus } from './EventBusProvider-BFFHfN4O.js';
 import { ClassValue } from 'clsx';
 import { LucideIcon } from 'lucide-react';
-import { EvalContextWire } from '@almadar/core/kernel-wire';
+import { EvalContextWire, TraitSurface } from '@almadar/core/kernel-wire';
 import { U as UIThemeDefinition } from './ThemeContext-DJmO59xd.js';
 export { C as ColorMode, D as DesignTheme, R as ResolvedMode, a as ResolvedTheme, b as Theme, c as ThemeProvider, T as ThemeProviderProps, d as ThemeScope, e as ThemeScopeContext, k as keyInViewerMode, r as registryKeyMode, f as registryKeyTheme, t as themeHasMode, u as useScopedMode, g as useTheme, h as useThemeScope } from './ThemeContext-DJmO59xd.js';
 
@@ -232,7 +232,13 @@ declare namespace AtlasImage {
 
 type AvatarSize = "xs" | "sm" | "md" | "lg" | "xl";
 type AvatarStatus = "online" | "offline" | "away" | "busy";
-/** @accessibleName alt name */
+/**
+ * @accessibleName alt name
+ * @role img
+ * @tokens --color-muted --color-border --color-foreground
+ * @contrast foreground muted
+ * @motion css
+ */
 interface AvatarProps extends A11yProps {
     /**
      * Image source URL
@@ -321,6 +327,8 @@ type BoxShadow = "none" | "sm" | "md" | "lg" | "xl";
 interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
+    /** Inline styles applied to the root element. */
+    style?: React__default.CSSProperties;
     /** Data-theme attribute applied to the root element for CSS theme scoping (e.g. almadar-website-dark). */
     'data-theme'?: string;
     /**
@@ -460,7 +468,13 @@ interface CenterProps extends A11yProps {
  */
 declare const Center: React__default.FC<CenterProps>;
 
-/** @accessibleName label */
+/**
+ * @accessibleName label
+ * @role checkbox
+ * @tokens --color-primary --color-border --color-card --color-foreground
+ * @contrast foreground card
+ * @motion none
+ */
 interface CheckboxProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange" | keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -601,6 +615,11 @@ declare const Dialog: React__default.ForwardRefExoticComponent<DialogProps & Rea
 
 type DividerOrientation = "horizontal" | "vertical";
 type DividerVariant = "solid" | "dashed" | "dotted";
+/**
+ * @role separator
+ * @tokens --color-border
+ * @motion none
+ */
 interface DividerProps extends A11yProps {
     /**
      * Orientation of the divider
@@ -639,6 +658,8 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     onRemove?: () => void;
     /** Disable the remove button (renders without × control) */
     removable?: boolean;
+    /** Pressed state of the pill body (filter toggle), exposed as aria-pressed */
+    selected?: boolean;
     /** Click handler for the body of the pill (filter toggle) */
     onClick?: () => void;
     /** Event name dispatched via event bus when the pill body is clicked. Payload: { label } */
@@ -697,7 +718,12 @@ 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 */
+/**
+ * @accessibleName alt
+ * @role img
+ * @tokens --color-border
+ * @motion none
+ */
 interface ImageProps extends A11yProps {
     /** Image source URL */
     src: AssetUrl;
@@ -884,6 +910,11 @@ declare const Presence: React__default.FC<PresenceProps>;
 type ProgressBarType = "linear" | "circular" | "stepped";
 type ProgressBarVariant = "default" | "primary" | "success" | "warning" | "error" | "danger";
 type ProgressBarColor = ProgressBarVariant;
+/**
+ * @role progressbar
+ * @tokens --color-primary --color-muted --color-error --color-warning --color-foreground
+ * @motion css
+ */
 interface ProgressBarProps extends A11yProps {
     /**
      * Progress value (0-100)
@@ -944,7 +975,12 @@ declare const ProgressBar: React__default.FC<ProgressBarProps>;
  * A radio button component with label support and accessibility.
  */
 
-/** @accessibleName label */
+/**
+ * @accessibleName label
+ * @role radio
+ * @tokens --color-primary --color-border --color-foreground
+ * @motion css
+ */
 interface RadioProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "type" | "size" | keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -1084,6 +1120,11 @@ interface SparklineProps extends A11yProps {
 declare const Sparkline: React__default.FC<SparklineProps>;
 
 type SpinnerSize = "xs" | "sm" | "md" | "lg";
+/**
+ * @role status
+ * @tokens --color-foreground
+ * @motion css
+ */
 interface SpinnerProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -1164,6 +1205,11 @@ declare const HStack: React__default.FC<HStackProps>;
 
 type StatusDotStatus = "online" | "offline" | "away" | "busy" | "warning" | "critical";
 type StatusDotSize = "sm" | "md" | "lg";
+/**
+ * @role status
+ * @tokens --color-success --color-warning --color-error --color-muted-foreground
+ * @motion css
+ */
 interface StatusDotProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -1178,7 +1224,12 @@ interface StatusDotProps extends Omit<React__default.HTMLAttributes<HTMLSpanElem
 }
 declare const StatusDot: React__default.ForwardRefExoticComponent<StatusDotProps & React__default.RefAttributes<HTMLSpanElement>>;
 
-/** @accessibleName label */
+/**
+ * @accessibleName label
+ * @role switch
+ * @tokens --color-primary --color-muted --color-background
+ * @motion css
+ */
 interface SwitchProps extends A11yProps {
     checked?: boolean;
     defaultChecked?: boolean;
@@ -1261,7 +1312,13 @@ interface TextHighlightProps extends A11yProps {
  */
 declare const TextHighlight: React__default.FC<TextHighlightProps>;
 
-/** @accessibleName label */
+/**
+ * @accessibleName label
+ * @role textbox
+ * @tokens --color-card --color-border --color-foreground --color-muted-foreground
+ * @contrast foreground card
+ * @motion none
+ */
 interface TextareaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -1304,6 +1361,14 @@ interface ThemeToggleProps extends A11yProps {
     size?: "sm" | "md" | "lg";
     /** Show label text */
     showLabel?: boolean;
+    /** Accessible action label when the current mode is dark. */
+    switchToLightLabel?: string;
+    /** Accessible action label when the current mode is light. */
+    switchToDarkLabel?: string;
+    /** Visible light mode label. */
+    lightLabel?: string;
+    /** Visible dark mode label. */
+    darkLabel?: string;
 }
 /**
  * ThemeToggle component for switching between light and dark modes
@@ -1354,6 +1419,11 @@ declare namespace TimeSlotCell {
 
 type TrendDirection = "up" | "down" | "flat";
 type TrendIndicatorSize = "sm" | "md" | "lg";
+/**
+ * @role status
+ * @tokens --color-success --color-error --color-muted-foreground
+ * @motion none
+ */
 interface TrendIndicatorProps extends Omit<React__default.HTMLAttributes<HTMLSpanElement>, keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -1389,10 +1459,10 @@ interface TypewriterTextProps extends A11yProps {
     /** Additional class names */
     className?: string;
     /**
-     * Called when the entire text has been revealed
+     * Event emitted (as UI:{onComplete}) when the entire text has been revealed; empty = none
      * @notification
      */
-    onComplete?: () => void;
+    onComplete?: EventKey;
 }
 declare const TypewriterText: React__default.FC<TypewriterTextProps>;
 
@@ -1735,10 +1805,12 @@ type ValueFormat = 'none' | 'date' | 'time' | 'datetime' | 'number' | 'currency'
  * parses it as local midnight instead. Returns null for any other shape.
  */
 declare function parseCalendarDate(value: string): Date | null;
+/** A field value, or the `Date` a local calendar helper builds; a `Date` is never a stored field value (that is its ISO text). */
+type DateLike = FieldValue | Date;
 /** Value for an `<input type="date">`: the LOCAL calendar day. */
-declare function toDateInputValue(value: FieldValue | undefined): string;
+declare function toDateInputValue(value: DateLike | undefined): string;
 /** Value for an `<input type="datetime-local">`: LOCAL wall-clock time. */
-declare function toDateTimeInputValue(value: FieldValue | undefined): string;
+declare function toDateTimeInputValue(value: DateLike | undefined): string;
 declare function formatDate(value: FieldValue | undefined, locale?: string): string;
 declare function formatTime(value: FieldValue | undefined, locale?: string): string;
 declare function formatDateTime(value: FieldValue | undefined, locale?: string): string;
@@ -1965,7 +2037,7 @@ interface NavigationContextValue {
 interface NavigationProviderProps {
     /** The schema to navigate within */
     schema: OrbitalSchema;
-    /** Initial page name (optional, defaults to first page) */
+    /** Initial page name (optional, defaults to the page marked initial, else the first) */
     initialPage?: string;
     /** Whether to update browser URL on navigation (default: true) */
     updateUrl?: boolean;
@@ -2388,11 +2460,15 @@ interface TraitPresence {
     /** The presence of a group: on screen when any member is, absent when no member renders. */
     state(traits: readonly string[]): TraitPresenceState;
 }
+/** The element boxes a wrapper renders, looking through `display: contents` layers. */
+declare function boxesOf(el: Element): Element[];
 declare function createTraitPresence(): TraitPresence;
 /** The one presence registry for this document. */
 declare function getTraitPresence(): TraitPresence;
 /** The traits whose output decides `traitName`'s presence: itself, or every trait sharing its `[shared]` entity's frame (LOLO §11). */
-declare function presenceGroup(traitIndex: TraitIndex, traitName: string): string[];
+declare function presenceGroup(traitIndex: {
+    byName: ReadonlyMap<string, Pick<TraitSurface, 'shared' | 'frameKey'>>;
+}, traitName: string): string[];
 
 /**
  * Content surfaces: the background box behind a content block (table,
@@ -2519,5 +2595,5 @@ declare const localeMeta: Record<SupportedLocale, LocaleMeta>;
  */
 declare function mergeMessages(locale: SupportedLocale, projectMessages: Record<string, string>): Record<string, string>;
 
-export { AnimatedGraphic, AnimatedReveal, Aside, AtlasImage, AtlasPanel, Avatar, BAND_ACCENT_FALLBACK, BAND_EDGE_FILL, BAND_SHAPES, BUILT_IN_THEMES, Box, Card, CardBody, CardContent, CardFooter, CardHeader, CardTitle, Center, Checkbox, ConditionalWrapper, ConfettiEffect, DEFAULT_CURRENCY, DayCell, Dialog, Divider, FilterPill, FlipContainer, GameIcon, HStack, I18nProvider, INLINE_TEXT_ATTR, IconInput, Image, InfiniteScrollSentinel, Label, LawReferenceTooltip, NavStackProvider, NavStackRouterBridge, NavigationProvider, Overlay, PendingScopeContext, Presence, ProgressBar, Radio, RangeSlider, STRETCHED_ABOVE, STRETCHED_CONTROL, SVG_MOTION_CLASSES, SectionHeader, Spacer, Sparkline, Spinner, Stack, StatusDot, SurfaceBoundary, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, Switch, THEME_SCALE_KEYS, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, TraitScopeProvider, TrendIndicator, TypewriterText, Typography, UIThemeDefinition, VStack, atlasFailed, atlasUrlOf, bandEdgeHeight, bandEdgeLayerStyle, bandEdgeMask, bandPadding, beginPending, blit, cn, compareCellValues, coreMessages, createTraitPresence, createTranslate, cssTimeMs, domPassthrough, endPending, entriesFor, evaluateBinding, evaluateBindings, extractRouteParams, findPageByName, findPageByPath, followHref, formatDate, formatDateTime, formatTime, formatValue, getAllPages, getAtlas, getCurrentIconFamily, getDefaultPage, getTraitPresence, guardsHold, isAbsoluteHref, isAtlasAsset, isInertNavStack, isMotionEnabled, isPending, isSpriteSheetAtlas, kebabToPascal, layoutScale, localeMeta, lucideIconKey, matchNavPage, mergeMessages, motionTiming, navLabelsFromItems, newPendingKey, pageEntryLabel, parseCalendarDate, pathMatches, presenceGroup, pressableProps, previousEntry, relabelCurrent, resolveAssetSource, resolveEntryLabels, resolveIconForFamily, resolveLucideByName, rowActivationProps, rowOpenControlProps, sortRows, subRectFor, subscribePending, svgMotionClass, syncNavStack, toDateInputValue, toDateTimeInputValue, useActivePage, useAnimateChanges, useAtlasSliceDataUrl, useContentSurface, useDialogBehavior, useFormatContext, useIconFamily, useInfiniteScroll, useInitPayload, useMediaQuery, useNavStack, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOnSurface, usePendingAction, usePendingRows, usePendingScopeValue, usePrefersReducedMotion, usePresence, useRenderI18n, useResolvedIcon, useScopeHasPending, useTapReveal, useThemeIconStrokeApplies, useTraitScope, useTraitScopeChain, useTranslate };
+export { AnimatedGraphic, AnimatedReveal, Aside, AtlasImage, AtlasPanel, Avatar, BAND_ACCENT_FALLBACK, BAND_EDGE_FILL, BAND_SHAPES, BUILT_IN_THEMES, Box, Card, CardBody, CardContent, CardFooter, CardHeader, CardTitle, Center, Checkbox, ConditionalWrapper, ConfettiEffect, DEFAULT_CURRENCY, DayCell, Dialog, Divider, FilterPill, FlipContainer, GameIcon, HStack, I18nProvider, INLINE_TEXT_ATTR, IconInput, Image, InfiniteScrollSentinel, Label, LawReferenceTooltip, NavStackProvider, NavStackRouterBridge, NavigationProvider, Overlay, PendingScopeContext, Presence, ProgressBar, Radio, RangeSlider, STRETCHED_ABOVE, STRETCHED_CONTROL, SVG_MOTION_CLASSES, SectionHeader, Spacer, Sparkline, Spinner, Stack, StatusDot, SurfaceBoundary, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, Switch, THEME_SCALE_KEYS, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, TraitScopeProvider, TrendIndicator, TypewriterText, Typography, UIThemeDefinition, VStack, atlasFailed, atlasUrlOf, bandEdgeHeight, bandEdgeLayerStyle, bandEdgeMask, bandPadding, beginPending, blit, boxesOf, cn, compareCellValues, coreMessages, createTraitPresence, createTranslate, cssTimeMs, domPassthrough, endPending, entriesFor, evaluateBinding, evaluateBindings, extractRouteParams, findPageByName, findPageByPath, followHref, formatDate, formatDateTime, formatTime, formatValue, getAllPages, getAtlas, getCurrentIconFamily, getDefaultPage, getTraitPresence, guardsHold, isAbsoluteHref, isAtlasAsset, isInertNavStack, isMotionEnabled, isPending, isSpriteSheetAtlas, kebabToPascal, layoutScale, localeMeta, lucideIconKey, matchNavPage, mergeMessages, motionTiming, navLabelsFromItems, newPendingKey, pageEntryLabel, parseCalendarDate, pathMatches, presenceGroup, pressableProps, previousEntry, relabelCurrent, resolveAssetSource, resolveEntryLabels, resolveIconForFamily, resolveLucideByName, rowActivationProps, rowOpenControlProps, sortRows, subRectFor, subscribePending, svgMotionClass, syncNavStack, toDateInputValue, toDateTimeInputValue, useActivePage, useAnimateChanges, useAtlasSliceDataUrl, useContentSurface, useDialogBehavior, useFormatContext, useIconFamily, useInfiniteScroll, useInitPayload, useMediaQuery, useNavStack, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOnSurface, usePendingAction, usePendingRows, usePendingScopeValue, usePrefersReducedMotion, usePresence, useRenderI18n, useResolvedIcon, useScopeHasPending, useTapReveal, useThemeIconStrokeApplies, useTraitScope, useTraitScopeChain, useTranslate };
 export type { AnimatedGraphicProps, AnimatedRevealProps, AsideProps, AssetSource, AtlasImageAsset, AtlasImageProps, AtlasPanelProps, AvatarProps, AvatarSize, AvatarStatus, BandEdge, BandEdgeColor, BandEdgeLayerStyle, BooleanLabels, BoxBg, BoxMargin, BoxPadding, BoxProps, BoxRounded, BoxShadow, CardLook, CardProps, CardShadow, CenterProps, CheckboxProps, ConditionalContext, ConditionalWrapperProps, ConfettiEffectProps, ContentSurface, DayCellProps, DialogBehaviorOptions, DialogProps, DividerOrientation, DividerProps, DividerVariant, DomPassthrough, FilterPillProps, FilterPillSize, FilterPillVariant, FlipContainerProps, FormatContext, GameIconProps, GraphicAnimation, HStackProps, HighlightType, I18nContextValue, I18nProviderProps, IconFamily, ImageAspect, ImageFit, ImagePosition, ImageProps, ImageRounded, InfiniteScrollOptions, InfiniteScrollResult, InfiniteScrollSentinelProps, LabelProps, LawReference, LawReferenceTooltipProps, LocaleMeta, NavItemDecl, NavItemLabels, NavPageDecl, NavStackApi, NavStackProviderProps, NavStackRouterBridgeProps, NavStackState, NavigationContextValue, NavigationProviderProps, NavigationState, OverlayProps, PendingCrumb, PendingScopeValue, PresenceAnimation, PresenceProps, PresenceResult, PressableProps, ProgressBarColor, ProgressBarProps, ProgressBarType, ProgressBarVariant, RadioProps, RangeSliderProps, RangeSliderSize, RenderI18n, RenderedIcon, RenderedIconProps, RevealAnimation, RevealTrigger, RowActivationProps, SectionHeaderProps, SortDirection, SpacerProps, SpacerSize, SparklineColor, SparklineProps, SpinnerProps, SpinnerSize, SpriteRef, StackAlign, StackDirection, StackGap, StackJustify, StackProps, StatusDotProps, StatusDotSize, StatusDotStatus, SubRect, SupportedLocale, SvgBranchProps, SvgConnectionProps, SvgFlowProps, SvgGridProps, SvgLobeProps, SvgMeshProps, SvgMorphProps, SvgMotion, SvgNodeProps, SvgPulseProps, SvgRingProps, SvgShieldProps, SvgStackProps, SwitchProps, TapRevealOptions, TapRevealResult, TextHighlightProps, TextareaProps, ThemeToggleProps, TimeSlotCellProps, TraitPresence, TraitPresenceState, TraitScope, TraitScopeProviderProps, TranslateFunction, TrendDirection, TrendIndicatorProps, TrendIndicatorSize, TypewriterTextProps, TypographyProps, TypographySize, TypographyVariant, UsePresenceOptions, VStackProps, ValueFormat };

package/dist/core.js

@@ -1,2 +1,3 @@
-export { AnimatedGraphic, AnimatedReveal, Aside, AtlasImage, AtlasPanel, Avatar, BAND_ACCENT_FALLBACK, BAND_EDGE_FILL, BAND_SHAPES, BUILT_IN_THEMES, Badge, Box, Button, CONFETTI_BURST_KEYFRAMES, CONFETTI_COLORS, Card, CardBody, CardContent, CardFooter, CardHeader, CardTitle, Center, Checkbox, ConditionalWrapper, ConfettiEffect, DEFAULT_CURRENCY, DayCell, Dialog, Divider, EventBusContext, EventBusProvider, FilterPill, FlipContainer, GameIcon, HStack, I18nProvider, INLINE_TEXT_ATTR, Icon, Image, InfiniteScrollSentinel, Input, Label, LawReferenceTooltip, NavStackProvider, NavStackRouterBridge, NavigationProvider, Overlay, PatternTile, PendingScopeContext, Presence, ProgressBar, Radio, RangeSlider, STRETCHED_ABOVE, STRETCHED_CONTROL, SVG_MOTION_CLASSES, SectionHeader, Select, Spacer, Sparkline, Spinner, Stack, StatusDot, SurfaceBoundary, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, Switch, THEME_SCALE_KEYS, TextHighlight, Textarea, ThemeProvider, ThemeScopeContext, ThemeToggle, TimeSlotCell, TraitScopeProvider, TrendIndicator, TypewriterText, Typography, VStack, VideoEmbed, atlasFailed, atlasUrlOf, bandEdgeHeight, bandEdgeLayerStyle, bandEdgeMask, bandPadding, beginPending, blit, cn, compareCellValues, comparePathSpecificity, coreMessages, createConfettiParticles, createTraitPresence, createTranslate, cssTimeMs, domPassthrough, endPending, entriesFor, evaluateBinding, evaluateBindings, extractRouteParams, findPageByName, findPageByPath, followHref, formatDate, formatDateTime, formatTime, formatValue, fxHash01, fxLifecycle, getAllPages, getAtlas, getCurrentIconFamily, getDefaultPage, getGlobalEventBus, getTileDimensions, getTraitPresence, guardsHold, isAbsoluteHref, isAtlasAsset, isInertNavStack, isMotionEnabled, isPending, isSpriteSheetAtlas, kebabToPascal, keyInViewerMode, layoutScale, localeMeta, lucideIconKey, matchNavPage, matchPath, matchPathAmong, mergeMessages, motionTiming, navLabelsFromItems, newPendingKey, pageEntryLabel, parseCalendarDate, pathMatches, presenceGroup, pressableProps, previousEntry, registryKeyMode, registryKeyTheme, relabelCurrent, resolveAssetSource, resolveEntryLabels, resolveFxView, resolveIcon, resolveIconForFamily, resolveLucideByName, rowActivationProps, rowOpenControlProps, setGlobalEventBus, sortRows, subRectFor, subscribePending, svgMotionClass, syncNavStack, themeHasMode, toDateInputValue, toDateTimeInputValue, useActivePage, useAnimateChanges, useAtlasSliceDataUrl, useContentSurface, useDialogBehavior, useEmitEvent, useEventBus, useEventListener, useEventSubscription, useFormatContext, useIconFamily, useInfiniteScroll, useInitPayload, useMediaQuery, useNavStack, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOnSurface, usePendingAction, usePendingRows, usePendingScopeValue, usePrefersReducedMotion, usePresence, useRenderI18n, useResolvedIcon, useRootEventBus, useScopeHasPending, useScopedMode, useTapReveal, useTheme, useThemeIconStrokeApplies, useThemeScope, useTraitScope, useTraitScopeChain, useTranslate } from './chunk-MBQAMMSE.js';
+"use client";
+export { AnimatedGraphic, AnimatedReveal, Aside, AtlasImage, AtlasPanel, Avatar, BAND_ACCENT_FALLBACK, BAND_EDGE_FILL, BAND_SHAPES, BUILT_IN_THEMES, Badge, Box, Button, CONFETTI_BURST_KEYFRAMES, CONFETTI_COLORS, Card, CardBody, CardContent, CardFooter, CardHeader, CardTitle, Center, Checkbox, ConditionalWrapper, ConfettiEffect, DEFAULT_CURRENCY, DayCell, Dialog, Divider, EventBusContext, EventBusProvider, FilterPill, FlipContainer, GameIcon, HStack, I18nProvider, INLINE_TEXT_ATTR, Icon, Image, InfiniteScrollSentinel, Input, Label, LawReferenceTooltip, NavStackProvider, NavStackRouterBridge, NavigationProvider, Overlay, PatternTile, PendingScopeContext, Presence, ProgressBar, Radio, RangeSlider, STRETCHED_ABOVE, STRETCHED_CONTROL, SVG_MOTION_CLASSES, SectionHeader, Select, Spacer, Sparkline, Spinner, Stack, StatusDot, SurfaceBoundary, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, Switch, THEME_SCALE_KEYS, TextHighlight, Textarea, ThemeProvider, ThemeScopeContext, ThemeToggle, TimeSlotCell, TraitScopeProvider, TrendIndicator, TypewriterText, Typography, VStack, VideoEmbed, atlasFailed, atlasUrlOf, bandEdgeHeight, bandEdgeLayerStyle, bandEdgeMask, bandPadding, beginPending, blit, boxesOf, cn, compareCellValues, comparePathSpecificity, coreMessages, createConfettiParticles, createTraitPresence, createTranslate, cssTimeMs, domPassthrough, endPending, entriesFor, evaluateBinding, evaluateBindings, extractRouteParams, findPageByName, findPageByPath, followHref, formatDate, formatDateTime, formatTime, formatValue, fxHash01, fxLifecycle, getAllPages, getAtlas, getCurrentIconFamily, getDefaultPage, getGlobalEventBus, getTileDimensions, getTraitPresence, guardsHold, isAbsoluteHref, isAtlasAsset, isInertNavStack, isMotionEnabled, isPending, isSpriteSheetAtlas, kebabToPascal, keyInViewerMode, layoutScale, localeMeta, lucideIconKey, matchNavPage, matchPath, matchPathAmong, mergeMessages, motionTiming, navLabelsFromItems, newPendingKey, pageEntryLabel, parseCalendarDate, pathMatches, presenceGroup, pressableProps, previousEntry, registryKeyMode, registryKeyTheme, relabelCurrent, resolveAssetSource, resolveEntryLabels, resolveFxView, resolveIcon, resolveIconForFamily, resolveLucideByName, rowActivationProps, rowOpenControlProps, setGlobalEventBus, sortRows, subRectFor, subscribePending, svgMotionClass, syncNavStack, themeHasMode, toDateInputValue, toDateTimeInputValue, useActivePage, useAnimateChanges, useAtlasSliceDataUrl, useContentSurface, useDialogBehavior, useEmitEvent, useEventBus, useEventListener, useEventSubscription, useFormatContext, useIconFamily, useInfiniteScroll, useInitPayload, useMediaQuery, useNavStack, useNavigateTo, useNavigation, useNavigationId, useNavigationState, useOnSurface, usePendingAction, usePendingRows, usePendingScopeValue, usePrefersReducedMotion, usePresence, useRenderI18n, useResolvedIcon, useRootEventBus, useScopeHasPending, useScopedMode, useTapReveal, useTheme, useThemeIconStrokeApplies, useThemeScope, useTraitScope, useTraitScopeChain, useTranslate } from './chunk-4YXBKHHM.js';
 import './chunk-G7DCAZ22.js';

package/dist/design-classes/index.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var core = require('@almadar/core');
+
 // src/lib/design-classes.ts
 var DESIGN_COLOR_TOKENS = [
   "primary",
@@ -378,7 +380,7 @@ function collectClasses(value, found) {
 }
 function classesOfPart(part) {
   const found = /* @__PURE__ */ new Set();
-  collectClasses(JSON.parse(JSON.stringify(part)), found);
+  collectClasses(core.toPayloadValue(part), found);
   return [...found];
 }
 var classesByOrbital = /* @__PURE__ */ new WeakMap();

package/dist/design-classes/index.js

@@ -1,3 +1,5 @@
+import { toPayloadValue } from '@almadar/core';
+
 // src/lib/design-classes.ts
 var DESIGN_COLOR_TOKENS = [
   "primary",
@@ -376,7 +378,7 @@ function collectClasses(value, found) {
 }
 function classesOfPart(part) {
   const found = /* @__PURE__ */ new Set();
-  collectClasses(JSON.parse(JSON.stringify(part)), found);
+  collectClasses(toPayloadValue(part), found);
   return [...found];
 }
 var classesByOrbital = /* @__PURE__ */ new WeakMap();

package/dist/{fx-CmQjnHmT.d.ts → fx-Br8zjvu9.d.ts}

@@ -198,7 +198,7 @@ interface FxItem {
     id: string;
     /** Effect-kind key into the consumer-declared `FxPreset[]` table. */
     type: string;
-    /** Canonical scene position; when absent the renderer derives it from `x`/`z`/`y`. */
+    /** Scene position `{x, y: ground row, z: height}`; the fx mechanic stamps it from `x`/`z`/`y`, and the layer refuses an item without it. */
     position?: ScenePos;
     /** Scene x in world units. */
     x: number;
@@ -253,11 +253,11 @@ interface FxPreset {
     /** Glow strength — soft shadow blur in world units around procedural particles. */
     glow?: number;
     /** Downward acceleration in world-units/sec² applied to the drift. */
-    gravity?: number;
-    /** Default drift velocities, world-units/sec. */
-    vx?: number;
-    vy?: number;
-    vz?: number;
+    gravity: number;
+    /** Drift velocities in world-units/sec; an item's own velocity wins. `vy` is the height axis, read in 3D only. */
+    vx: number;
+    vy: number;
+    vz: number;
     /** Render substrate routing for this kind. */
     space?: FxSpace;
     /** Screen-space render kind for this kind. */

package/dist/hooks/index.d.ts

@@ -1,6 +1,5 @@
 import { OrbitalSchema, FieldValue, EventPayload, BusEventSource, EntityFrameState, EntityFieldWrite, PageMeta, PageAccess, PageIndexing, LocaleAlternate } from '@almadar/core';
 export { BusEvent, BusEventListener, BusEventSource, BusEventListener as EventListener, UISlot, Unsubscribe } from '@almadar/core';
-export { E as EditorKeyEvent, a as KeyCaptureEntry, K as KeyCaptureTable, U as UseKeyboardRouterOptions, k as keyChord, m as mergeCaptureTables, u as useKeyboardRouter } from '../useKeyboardRouter-Dsq553Ur.js';
 export { D as DEFAULT_SLOTS, S as SlotChangeCallback, a as SlotContent, b as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-CiobNFGb.js';
 import { useEventBus } from '../core.js';
 import * as React$1 from 'react';
@@ -392,6 +391,42 @@ interface UseValidationResult {
 }
 declare function useValidation(): UseValidationResult;
 
+interface KeyCaptureEntry {
+    mode: string;
+    keys: ReadonlySet<string>;
+}
+/** keyed by editorId, or the literal 'shell' for chrome-level bindings */
+type KeyCaptureTable = Readonly<Record<string, KeyCaptureEntry>>;
+interface EditorKeyEvent {
+    editorId: string;
+    key: string;
+    code: string;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    meta: boolean;
+    repeat: boolean;
+}
+/**
+ * Merges several plugins' capture tables into one, per target: keys UNION
+ * across every table that declares the target; `mode` is `'any'` if any
+ * input says so, else the shared mode when every input agrees, else the
+ * distinct modes sorted and `|`-joined. A target present in only one table
+ * passes through unchanged. Pure, deterministic — no heuristics.
+ */
+declare function mergeCaptureTables(tables: readonly KeyCaptureTable[]): KeyCaptureTable;
+/** `"Control+Shift+P"`-style spelling of a keydown: modifiers in the fixed order Control, Alt, Shift, Meta, then `event.key`. */
+declare function keyChord(event: Pick<KeyboardEvent, 'key' | 'ctrlKey' | 'altKey' | 'shiftKey' | 'metaKey'>): string;
+interface UseKeyboardRouterOptions {
+    /** declared data; caller owns it; re-read on every keydown (kept in a ref) */
+    captureTable: KeyCaptureTable;
+    /** default 'KEY' -> emits UI:KEY */
+    keyEvent?: string;
+    /** default true */
+    enabled?: boolean;
+}
+declare function useKeyboardRouter(options: UseKeyboardRouterOptions): void;
+
 /**
  * Hook to bridge UI events to state machine dispatch.
  *
@@ -467,7 +502,7 @@ interface SharedEntityStore {
 }
 /**
  * Create a standalone shared-entity store. Plain factory — no React — so a
- * clock owner (the interpreter's TickScheduler, or a codegen rAF
+ * clock owner (the kernel's tick clock, or a codegen rAF
  * `useEffect`) can hold one instance and pass it to `runTickFrame` without
  * going through a hook.
  */
@@ -507,7 +542,7 @@ declare function useSharedEntitySnapshot(store: SharedEntityStore, entityId: str
  * Run one frame for `entityId`: fold each writer's writes into a running
  * scratch in binding order via `mergeEntityFrame` (field-level, so writer
  * k+1 reads writer k's same-frame writes), then commit the merged result
- * exactly ONCE. Clock-agnostic — the caller (a TickScheduler tick or a
+ * exactly ONCE. Clock-agnostic — the caller (a kernel-clock tick or a
  * codegen rAF loop) invokes this once per frame; it owns no timer itself.
  */
 declare function runTickFrame(entityId: string, orderedWriters: readonly SharedEntityWriter[], store: SharedEntityStore): EntityFrameState;
@@ -932,5 +967,5 @@ declare function usePageHead(input: PageHeadInput | null): void;
  */
 declare function useTickVisibility(traits: readonly string[]): () => boolean;
 
-export { ALMADAR_DND_MIME, SharedEntityStoreContext, claimDelivery, createSharedEntityStore, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useLongPress, usePageHead, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTickVisibility, useTraitListens, useUIEvents, useValidation };
-export type { AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, LongPressHandlers, LongPressOptions, OpenFile, PageHeadInput, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, SelectedFile, SharedEntityStore, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TraitListenSpec, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult };
+export { ALMADAR_DND_MIME, SharedEntityStoreContext, claimDelivery, createSharedEntityStore, keyChord, mergeCaptureTables, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useKeyboardRouter, useLongPress, usePageHead, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTickVisibility, useTraitListens, useUIEvents, useValidation };
+export type { AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, EditorKeyEvent, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, KeyCaptureEntry, KeyCaptureTable, LongPressHandlers, LongPressOptions, OpenFile, PageHeadInput, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, SelectedFile, SharedEntityStore, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TraitListenSpec, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseKeyboardRouterOptions };

package/dist/hooks/index.js

@@ -1,7 +1,8 @@
-export { SharedEntityStoreContext, createSharedEntityStore, runTickFrame, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, usePreview, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useTickVisibility, useTraitListens, useUIEvents, useValidation } from '../chunk-73SRAB4P.js';
-export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-R5O5AUPI.js';
-export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-L2DEKY4J.js';
+"use client";
+export { SharedEntityStoreContext, createSharedEntityStore, runTickFrame, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, usePreview, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useTickVisibility, useTraitListens, useUIEvents, useValidation } from '../chunk-UU57VNS2.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-PRXQGGCO.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-VO2TTLS5.js';
 export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-YHMRX6YA.js';
-import '../chunk-MBQAMMSE.js';
+import '../chunk-4YXBKHHM.js';
 import '../chunk-P4ZFUQFF.js';
 import '../chunk-G7DCAZ22.js';