@almadar/shell-web 1.0.0 → 1.2.0

package/dist/components/index.js

@@ -1,37 +1,34 @@
 "use client";
 export { assertUniqueSlotsPerHost } from '../chunk-5QTYQTPS.js';
-export { BehaviorView } from '../chunk-ROICKAU7.js';
-export { ModuleCard } from '../chunk-E6KA4J6N.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-LHP2TK7O.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, GuestView, 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-LHP2TK7O.js';
-export { FileTree } from '../chunk-57DC34LY.js';
-import '../chunk-SP5CDJ6K.js';
-import '../chunk-CPLN6NBQ.js';
-import '../chunk-HH5KSMH5.js';
-export { Accordion } from '../chunk-REXYVBUO.js';
-export { EmptyState } from '../chunk-AGXD77SL.js';
-import '../chunk-TXAUOLWZ.js';
-import { ThemedPortal } from '../chunk-AB3X7QTE.js';
-export { Popover, Tooltip } from '../chunk-AB3X7QTE.js';
-import '../chunk-DZBQA2OW.js';
-export { parseLessonSegments, parseMarkdownWithCodeBlocks } from '../chunk-TUPZWTRE.js';
-import '../chunk-TZZBINQY.js';
-export { DrawFxLayer, DrawGroup, DrawMesh, DrawShape, DrawSkinnedMesh } from '../chunk-4T3P43NS.js';
+export { BehaviorView } from '../chunk-B23EZH2P.js';
+export { ModuleCard } from '../chunk-7UCL26QB.js';
+import { JsonTreeEditor } from '../chunk-JEN4EIUF.js';
+export { JsonTreeEditor } from '../chunk-JEN4EIUF.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-PWXZN5G5.js';
+import { resolveSheetDirection, frameRect, GridPicker, FormSection } from '../chunk-TAEOMNDK.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, parseMarkdownWithCodeBlocks, preloadCodeHighlighter, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, sanitizeRichHtml, screenToIso, tickAnimationState, toCodeLanguage, transitionAnimation, useCamera, useCompactLayout, useDockLayout, useGameAudio, useGameAudioContext, useImageCache } from '../chunk-TAEOMNDK.js';
+export { FileTree } from '../chunk-AL2XXMYR.js';
+import '../chunk-RDPELAFQ.js';
+import '../chunk-CCO2ZH7F.js';
+import '../chunk-DPDKBY6Z.js';
+export { Accordion } from '../chunk-3DA36FOA.js';
+export { EmptyState } from '../chunk-3YUMGEEW.js';
+import '../chunk-HA2BYO5E.js';
 import '../chunk-PCR37T3U.js';
-import '../chunk-UXLE3IPR.js';
-import '../chunk-ILZ7ORX7.js';
-import '../chunk-3VZ36ZKO.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 { ThemedPortal } from '../chunk-V5SVGUYN.js';
+export { Popover, Tooltip } from '../chunk-V5SVGUYN.js';
+import '../chunk-3UQNFRYV.js';
+import '../chunk-LKL5RULQ.js';
+import '../chunk-TZZBINQY.js';
+import '../chunk-ZDRDJKYB.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-S3LS3B7N.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-GHAF7QUD.js';
+import '../chunk-2LNXLMK3.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-4YXBKHHM.js';
-import { getKnownPatterns, getPatternDefinition } from '../chunk-A2LR6VQQ.js';
-import '../chunk-P4ZFUQFF.js';
+export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-ANTJUQRD.js';
+import { VStack, Button, HStack, GameIcon, Typography, Box, useTranslate, Badge, Icon, cn, Select, domPassthrough, Switch, Input } from '../chunk-D5FJU4XC.js';
+import { getKnownPatterns, getPatternDefinition } from '../chunk-ECC3WQIB.js';
+import '../chunk-AZ74UPG6.js';
 import '../chunk-G7DCAZ22.js';
 import React4, { useRef, useState, useMemo, useEffect, useCallback, useLayoutEffect } from 'react';
 import * as LucideIcons from 'lucide-react';

package/dist/context/index.d.ts

@@ -1,8 +1,8 @@
-export { U as UISlotContext, a as UISlotProvider, u as useSlotContent, b as useSlotHasContent, c as useUISlots } from '../UISlotContext-Dl_ewwCI.js';
+export { U as UISlotContext, a as UISlotProvider, u as useSlotContent, b as useSlotHasContent, c as useUISlots } from '../UISlotContext-7r0SQdTL.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 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';
+export { S as SlotChangeCallback, a as SlotContent, b as SlotRenderConfig, U as UISlotManager } from '../useUISlots-BLcGd__D.js';
 import 'react';
 import '../EventBusProvider-BFFHfN4O.js';
 import '../ThemeContext-DJmO59xd.js';

package/dist/context/index.js

@@ -1,8 +1,8 @@
 "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 { DesignThemeProvider, useDesignTheme } from '../chunk-KTYOYEVA.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-2LNXLMK3.js';
 export { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-3BBUBJFF.js';
-import '../chunk-YHMRX6YA.js';
-import '../chunk-4YXBKHHM.js';
-import '../chunk-P4ZFUQFF.js';
+import '../chunk-ANTJUQRD.js';
+import '../chunk-D5FJU4XC.js';
+import '../chunk-AZ74UPG6.js';
 import '../chunk-G7DCAZ22.js';

package/dist/core.d.ts

@@ -2,9 +2,9 @@ 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, 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-B-iDdnvE.js';
+import { I as IconInput } from './fx-Bx5RqplG.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 isColorToken, z as resolveColorToken, A as resolveFxView, E as resolveIcon } from './fx-Bx5RqplG.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-BJ8Fgc8A.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';
@@ -324,6 +324,17 @@ type BoxMargin = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "auto";
 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";
+/** An endless strip: the content moves toward `direction` at `speed` px/s. */
+interface BoxMarquee {
+    /** "start" moves toward the reading start (left in LTR), "end" toward the reading end */
+    direction: "start" | "end";
+    /** Speed in pixels per second */
+    speed: number;
+    /** Clip the strip to the box and fade its two edges */
+    clip: boolean;
+    /** Repeat the content right after itself so the strip never runs out; without it the content leaves and starts over */
+    loop: boolean;
+}
 interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -398,6 +409,8 @@ interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, k
     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;
+    /** Scroll the content as a moving strip (pauses on hover; stands still and wraps under reduced motion) */
+    marquee?: BoxMarquee;
     /** Scene behind the band's content (photo, illustration, pattern); never takes clicks */
     backdrop?: React__default.ReactNode;
     /** Children elements */
@@ -666,6 +679,10 @@ interface FilterPillProps extends Omit<React__default.HTMLAttributes<HTMLSpanEle
     clickEvent?: EventEmit<{
         label: string | number | undefined;
     }>;
+    /** Payload sent with clickEvent beside the label, so a pill rendered from data names its item without matching on text
+     *  @payloadFor clickEvent
+     */
+    clickPayload?: EventPayload;
     /** Event name dispatched via event bus when the remove (×) button is clicked. Payload: { label }
      *  @offByDefault */
     removeEvent?: EventEmit<{
@@ -2596,4 +2613,4 @@ 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, 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 };
+export type { AnimatedGraphicProps, AnimatedRevealProps, AsideProps, AssetSource, AtlasImageAsset, AtlasImageProps, AtlasPanelProps, AvatarProps, AvatarSize, AvatarStatus, BandEdge, BandEdgeColor, BandEdgeLayerStyle, BooleanLabels, BoxBg, BoxMargin, BoxMarquee, 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,3 +1,3 @@
 "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';
+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, isColorToken, 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, resolveColorToken, 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-D5FJU4XC.js';
 import './chunk-G7DCAZ22.js';

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

@@ -40,6 +40,9 @@ declare const Badge: React__default.ForwardRefExoticComponent<BadgeProps & React
  * over a bare `string` for any `color` or `variant` prop.
  */
 type ColorToken = 'primary' | 'secondary' | 'success' | 'warning' | 'error' | 'muted';
+declare function isColorToken(value: string): value is ColorToken;
+/** A palette token's CSS variable, or the raw CSS color value passed through. */
+declare function resolveColorToken(color: ColorToken | string): string;
 /**
  * Concrete error-state shape read by display components (`error.message`,
  * occasionally `error.stack`). Structurally assignable from the global `Error`,
@@ -198,7 +201,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 +256,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. */
@@ -367,5 +370,5 @@ declare function createConfettiParticles(count: number, seed: string): ConfettiP
 /** The confetti burst keyframes (per-particle travel via CSS custom props). */
 declare const CONFETTI_BURST_KEYFRAMES = "\n@keyframes confetti-burst {\n  0% {\n    opacity: 1;\n    transform: translate(0, 0) rotate(0deg) scale(1);\n  }\n  70% {\n    opacity: 1;\n  }\n  100% {\n    opacity: 0;\n    transform: translate(var(--confetti-tx), var(--confetti-ty)) rotate(var(--confetti-rotate)) scale(0.5);\n  }\n}\n";
 
-export { Badge as B, CONFETTI_BURST_KEYFRAMES as C, CONFETTI_COLORS as f, Icon as q, createConfettiParticles as v, fxHash01 as w, fxLifecycle as x, resolveFxView as y, resolveIcon as z };
+export { resolveFxView as A, Badge as B, CONFETTI_BURST_KEYFRAMES as C, resolveIcon as E, CONFETTI_COLORS as f, Icon as q, createConfettiParticles as v, fxHash01 as w, fxLifecycle as x, isColorToken as y, resolveColorToken as z };
 export type { DisplayField as D, FxItem as F, IconInput as I, LinkAction as L, Point as P, Rect as R, UiError as U, FxPreset as a, BadgeColor as b, BadgeProps as c, BadgeSize as d, BadgeVariant as e, ColorToken as g, ConfettiParticle as h, DisplayFieldFormat as i, DisplayFieldVariant as j, FxLifecycle as k, FxOverlayItem as l, FxOverlayKind as m, FxProceduralShape as n, FxSpace as o, FxView as p, IconAnimation as r, IconProps as s, IconSize as t, ImageSource as u };

package/dist/hooks/index.d.ts

@@ -1,6 +1,6 @@
 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 { D as DEFAULT_SLOTS, S as SlotChangeCallback, a as SlotContent, b as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-CiobNFGb.js';
+export { D as DEFAULT_SLOTS, S as SlotChangeCallback, a as SlotContent, b as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-BLcGd__D.js';
 import { useEventBus } from '../core.js';
 import * as React$1 from 'react';
 import React__default from 'react';
@@ -899,7 +899,7 @@ interface GitHubRepo {
 /**
  * Hook to get GitHub connection status
  */
-declare function useGitHubStatus(): _tanstack_react_query.UseQueryResult<GitHubStatus, Error>;
+declare function useGitHubStatus(): _tanstack_react_query.UseQueryResult<NoInfer<GitHubStatus>, Error>;
 /**
  * Hook to connect GitHub (initiate OAuth flow)
  */
@@ -913,23 +913,23 @@ declare function useDisconnectGitHub(): _tanstack_react_query.UseMutationResult<
 /**
  * Hook to list GitHub repositories
  */
-declare function useGitHubRepos(page?: number, perPage?: number): _tanstack_react_query.UseQueryResult<{
+declare function useGitHubRepos(page?: number, perPage?: number): _tanstack_react_query.UseQueryResult<NoInfer<{
     repos: GitHubRepo[];
     page: number;
     perPage: number;
-}, Error>;
+}>, Error>;
 /**
  * Hook to get repository details
  */
-declare function useGitHubRepo(owner: string, repo: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<{
+declare function useGitHubRepo(owner: string, repo: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<NoInfer<{
     repo: GitHubRepo;
-}, Error>;
+}>, Error>;
 /**
  * Hook to list repository branches
  */
-declare function useGitHubBranches(owner: string, repo: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<{
+declare function useGitHubBranches(owner: string, repo: string, enabled?: boolean): _tanstack_react_query.UseQueryResult<NoInfer<{
     branches: string[];
-}, Error>;
+}>, Error>;
 
 /**
  * The active page's document head on client navigation — the same declared

package/dist/hooks/index.js

@@ -1,8 +1,8 @@
 "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-4YXBKHHM.js';
-import '../chunk-P4ZFUQFF.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-PWXZN5G5.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-S3LS3B7N.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-GHAF7QUD.js';
+export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-ANTJUQRD.js';
+import '../chunk-D5FJU4XC.js';
+import '../chunk-AZ74UPG6.js';
 import '../chunk-G7DCAZ22.js';

package/dist/index.d.ts

@@ -130,6 +130,8 @@ interface BrowserStoreTransportOptions {
     secretPorts?: SecretPorts;
     /** The host's `os` port (`createFetchOsHost(fetch)`); absent, every `os` ask of a leg is denied. */
     os?: OsHostPort;
+    /** The browser's GPU answerer (the kernel module's `GpuHost`), installed into the kernel; absent, every `gpu/` ask answers `unsupported`. */
+    gpu?: KernelHostPorts['gpu'];
 }
 declare function openBrowserStoreTransport(options: BrowserStoreTransportOptions): Promise<EventTransport>;
 /**
@@ -152,6 +154,8 @@ interface BrowserHostOptions {
     tabs?: BrowserTabPort;
     /** The host's `os` port (`createFetchOsHost(fetch)`): the browser's only os operation is `os/fetch`; absent, every `os` ask is denied. */
     os?: OsHostPort;
+    /** The browser's GPU answerer (the kernel module's `GpuHost`), installed into the kernel: every `gpu/` ask is answered there and its bytes never reach this host; absent, a `gpu/` ask answers `unsupported`. */
+    gpu?: KernelHostPorts['gpu'];
     factory?: IDBFactory;
     /** The viewer's locale: a first visit starts with the entity's `instances` written for it. */
     locale?: string;

package/dist/index.js

@@ -1,8 +1,8 @@
 "use client";
 import { runTickFrame, createTickDriver } from './chunk-AU7O65OX.js';
 export { createTickDriver, runTickFrame } from './chunk-AU7O65OX.js';
-import { wrapCallbackForEvent, validateSlotContent, local_store_transport_exports, pushPerfEntry, perfTimeAsync, perfTime, perfStore, perfStart, perfGauge, perfEnd, openLocalKernel, openBundledBrowserStore, openBrowserStoreTransport, openBrowserStore, openBrowserHost, nativeMemoryPersistence, getOrbitalVerification, eventRouteKey, ensureVerificationApi, createSlotSetter, createResidenceTransport, collectEmbeddedTraits, clearPerf, buildOrbitalsByTrait, browserStoreName, bindTraitStateGetter, bindEventBus, assertIsSlotManager, assertIsMultiSourceSlotManager, aggregateSlotContent, RendererContractViolationError, PERF_NAMESPACE, webHostActions } from './chunk-3VZ36ZKO.js';
-export { PERF_NAMESPACE, RendererContractViolationError, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, browserStoreName, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, createResidenceTransport, createSlotSetter, ensureVerificationApi, eventRouteKey, getOrbitalVerification, nativeMemoryPersistence, openBrowserHost, openBrowserStore, openBrowserStoreTransport, openBundledBrowserStore, openLocalKernel, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './chunk-3VZ36ZKO.js';
+import { wrapCallbackForEvent, validateSlotContent, local_store_transport_exports, pushPerfEntry, perfTimeAsync, perfTime, perfStore, perfStart, perfGauge, perfEnd, openLocalKernel, openBundledBrowserStore, openBrowserStoreTransport, openBrowserStore, openBrowserHost, nativeMemoryPersistence, getOrbitalVerification, eventRouteKey, ensureVerificationApi, createSlotSetter, createResidenceTransport, collectEmbeddedTraits, clearPerf, buildOrbitalsByTrait, browserStoreName, bindTraitStateGetter, bindEventBus, assertIsSlotManager, assertIsMultiSourceSlotManager, aggregateSlotContent, RendererContractViolationError, PERF_NAMESPACE, webHostActions } from './chunk-ZDRDJKYB.js';
+export { PERF_NAMESPACE, RendererContractViolationError, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, browserStoreName, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, createResidenceTransport, createSlotSetter, ensureVerificationApi, eventRouteKey, getOrbitalVerification, nativeMemoryPersistence, openBrowserHost, openBrowserStore, openBrowserStoreTransport, openBundledBrowserStore, openLocalKernel, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './chunk-ZDRDJKYB.js';
 import { __export, __reExport } from './chunk-G7DCAZ22.js';
 export * from '@almadar/shell-runtime/kernel/wire';
 export * from '@almadar/shell-runtime/kernel/decode';

package/dist/{katexPlugin-FA7NX4PE.css → katexPlugin-BUHVNRBJ.css}

@@ -1,4 +1,4 @@
-/* node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css */
+/* ../../../../../node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css */
 @font-face {
   font-display: block;
   font-family: KaTeX_AMS;

package/dist/{kernel-client-TZKGHJRY.js → kernel-client-NMZ56JVU.js}

@@ -1,11 +1,12 @@
 import { createTickDriver, runTickFrame } from './chunk-AU7O65OX.js';
-import { presenceGroup, getTraitPresence } from './chunk-4YXBKHHM.js';
+import { presenceGroup, getTraitPresence } from './chunk-D5FJU4XC.js';
 import './chunk-G7DCAZ22.js';
 import { isJsonObject } from '@almadar/core';
-import { createLocalFold, traceResponse, paintResponse } from '@almadar/shell-runtime';
+import { createLocalFold, paintResponse, traceResponse } from '@almadar/shell-runtime';
 import { TraitMountError } from '@almadar/shell-runtime/client/trait-mount-error';
 import { SessionEndedError } from '@almadar/shell-runtime/client/EventTransport';
 import { createLogger } from '@almadar/logger';
+import { decodeHeldCompletion } from '@almadar/shell-runtime/kernel/decode';
 
 var log = createLogger("almadar:ui:kernel-client");
 var nextClientSerial = 0;
@@ -27,8 +28,9 @@ function createKernelClient(opts) {
   const { store, traitIndex, transport } = opts;
   let loaded;
   const configs = /* @__PURE__ */ new Map();
-  const ready = opts.instance.then((k) => {
+  const ready = Promise.all([opts.instance, opts.gpu]).then(([k, gpu]) => {
     loaded = k;
+    if (gpu !== void 0) k.installGpu(gpu, (json) => deliverGpuCompletion(k, json));
     return k;
   });
   ready.catch(() => void 0);
@@ -273,13 +275,30 @@ function createKernelClient(opts) {
       store.notify();
       return { response, mode: parse(k.dispatchMode(request.runTick.trait)) };
     }
-    const wire = parse(k.dispatch(traitName, request.entityId, request.event, payloadJson(request.payload)));
+    const wire = parse(request.heldPayload !== void 0 ? k.dispatchHeld(traitName, request.entityId, request.event, request.heldPayload) : k.dispatch(traitName, request.entityId, request.event, payloadJson(request.payload)));
     try {
       return await settleDispatch(k, wire, request, hooks, progress);
     } finally {
       endFlight(k, wire.flight);
     }
   };
+  const framePainters = /* @__PURE__ */ new Set();
+  const deliverGpuCompletion = (k, json) => {
+    const completion = decodeHeldCompletion(json);
+    if (completion === null) return;
+    const request = {
+      event: completion.event,
+      targetTrait: completion.traitName,
+      heldPayload: completion.heldPayload,
+      ...completion.entityId !== void 0 ? { entityId: completion.entityId } : {}
+    };
+    dispatchOne(request, [], false).then((outcome) => {
+      for (const paint of framePainters) paint([outcome]);
+    }).catch((error) => {
+      k.dropHeldPayload(completion.heldPayload);
+      log.error("gpu-completion-failed", { trait: completion.traitName, event: completion.event, error: error.message });
+    });
+  };
   const settleDispatch = async (k, wire, request, hooks, progress) => {
     log.debug("dispatch", { trait: wire.seed.trait, event: request.event, mode: wire.mode, legs: wire.serverLegs.length, success: wire.response.success, states: wire.response.states, effects: (wire.response.clientEffectsByTrait ?? []).map((e) => `${e.traitName}:${e.effect[0]}:${e.effect[1] ?? ""}`), emitted: wire.response.emittedEvents.map((e) => e.event) });
     trace(k, wire.response);
@@ -305,12 +324,14 @@ function createKernelClient(opts) {
       const kept = mountedSeeds.get(wire.orbital) ?? [];
       if (!kept.some((s) => s.trait === wire.seed.trait)) mountedSeeds.set(wire.orbital, [...kept, { trait: wire.seed.trait, event: seeds.find((s) => s.trait === wire.seed.trait)?.event ?? "INIT" }]);
     }
-    for (const wire of wires) {
+    const announced = mount.announced;
+    for (const wire of announced !== null ? [announced, ...wires] : wires) {
       log.debug("mount", { trait: wire.seed.trait, event: wire.seed.event, mode: wire.mode, legs: wire.serverLegs.length, success: wire.response.success });
       trace(k, wire.response);
       mirror(wire.response);
     }
     store.notify();
+    if (announced !== null) hooks?.onLocal?.(announced.seed.trait, announced.response);
     for (const wire of wires) hooks?.onLocal?.(wire.seed.trait, wire.response);
     const outcome = {
       seeds: wires.map((w) => ({ trait: w.seed.trait, event: w.seed.event, mode: w.mode, local: w.response })),
@@ -321,6 +342,20 @@ function createKernelClient(opts) {
       emittedEvents: []
     };
     if (transport === void 0) return outcome;
+    if (announced !== null && announced.serverLegs.length > 0) {
+      let posted;
+      try {
+        posted = await post(k, announced, baseRequest, { rollback: false, awaiting: false });
+      } finally {
+        endFlight(k, announced.flight);
+      }
+      outcome.posted = true;
+      outcome.success = outcome.success && posted.success;
+      if (posted.error !== void 0) outcome.error = posted.error;
+      outcome.rejections.push(...posted.rejections);
+      outcome.serverEffects.clientEffectsByTrait?.push(...posted.serverEffects.clientEffectsByTrait ?? []);
+      outcome.emittedEvents.push(...posted.foldedEmits);
+    }
     const topology = await opts.topology;
     const groups = (topology.carriesCircuitState ? mount.legs : mount.statefulLegs).map((group) => {
       const answered = wires.filter((w) => group.seeds.some((s) => s.trait === w.seed.trait && s.event === w.seed.event));
@@ -345,6 +380,22 @@ function createKernelClient(opts) {
       outcome.serverEffects.clientEffectsByTrait?.push(...posted.serverEffects.clientEffectsByTrait ?? []);
       outcome.emittedEvents.push(...posted.foldedEmits);
     }
+    for (const hop of mount.hops) {
+      const flight = k.openFlight();
+      let posted;
+      try {
+        const planned = { orbital: hop.orbital, leg: hop.leg, keepsState: true, alreadyDelivered: [], foldSeeded: [], wires: [], flight };
+        posted = await sendLegs(k, [planned], baseRequest, { rollback: false, mount: false }, outcome.seeds[0].local);
+      } finally {
+        endFlight(k, flight);
+      }
+      outcome.posted = true;
+      outcome.success = outcome.success && posted.success;
+      if (posted.error !== void 0) outcome.error = posted.error;
+      outcome.rejections.push(...posted.rejections);
+      outcome.serverEffects.clientEffectsByTrait?.push(...posted.serverEffects.clientEffectsByTrait ?? []);
+      outcome.emittedEvents.push(...posted.foldedEmits);
+    }
     return outcome;
   };
   const deliver = async (emitted, fold) => {
@@ -409,10 +460,11 @@ function createKernelClient(opts) {
       await scopeTail;
       const baseRequest = base ?? {};
       k.mount(JSON.stringify(seeds.map((s) => s.trait)));
-      const mount = parse(k.dispatchMount(JSON.stringify(seeds), baseRequest.entityId, payloadJson(baseRequest.payload), baseRequest.route));
+      const mount = parse(k.dispatchMount(JSON.stringify(seeds), baseRequest.entityId, payloadJson(baseRequest.payload), baseRequest.route, baseRequest.crumb));
       try {
         return await settleMount(k, mount, seeds, hooks, baseRequest);
       } finally {
+        if (mount.announced !== null) endFlight(k, mount.announced.flight);
         for (const wire of mount.seeds) endFlight(k, wire.flight);
       }
     },
@@ -441,6 +493,7 @@ function createKernelClient(opts) {
     framePause: () => loaded?.framePause(),
     frameResume: () => loaded?.frameResume(),
     startFrames: (onFrame, schedule = defaultFrameScheduler) => {
+      framePainters.add(onFrame);
       const presence = getTraitPresence();
       const releases = visibleGroups.map(([, group]) => presence.watch(group));
       let stopped = false;
@@ -486,6 +539,7 @@ function createKernelClient(opts) {
       }).catch((error) => log.error("kernel-frame-failed", { error: error.message }));
       return () => {
         stopped = true;
+        framePainters.delete(onFrame);
         driver?.stop();
         releases.forEach((release2) => release2());
       };

package/dist/{kernel-wire-wNdAPfhJ.d.ts → kernel-wire-CRsHtLsf.d.ts}

@@ -1,3 +1,4 @@
+import { KernelGpuHost } from '@almadar/shell-runtime/kernel/wire';
 import { KernelModule as KernelModule$1 } from '@almadar/shell-browser/kv';
 import './verification-C5pTeMJv.js';
 
@@ -11,6 +12,12 @@ import './verification-C5pTeMJv.js';
 /** The `Kernel` class `@almadar/kernel` exports: JSON strings in, JSON strings out. */
 interface KernelInstance {
     dispatch(traitName: string, entityId: string | undefined, event: string, payloadJson?: string): string;
+    /** Install the GPU answerer: every `gpu/` ask is held in the kernel and answered in ask order, and each outcome's route event reaches `completed` as `HeldGpuCompletion` JSON (`null` when it takes no route) for the host to dispatch with `dispatchHeld`. */
+    installGpu(gpu: KernelGpuHost, completed: (completionJson: string) => void): void;
+    /** `dispatch` with the payload the kernel holds under `heldPayload` (a gpu completion's), taken once. */
+    dispatchHeld(traitName: string, entityId: string | undefined, event: string, heldPayload: number): string;
+    /** Drop a held completion payload no dispatch will take. */
+    dropHeldPayload(heldPayload: number): boolean;
     /** A flight for work the kernel did not wire (a dispatch the host ran on its own, a frame's browser leg). */
     openFlight(): number;
     /** `applyServerResponse` in flight order (EXEC-CONC-8): a `FoldProgressWire` as JSON, folded now or queued behind an older flight. */
@@ -29,7 +36,7 @@ interface KernelInstance {
     /** The mount a reconnecting client posts to rebuild its session: the seeds with the state and frame this client holds for each. */
     reseedLeg(seedsJson: string, entityId?: string): string;
     foldBase(carriedJson: string | undefined, seededJson: string, entityId?: string): string | undefined;
-    dispatchMount(seedsJson: string, entityId?: string, payloadJson?: string, route?: string): string;
+    dispatchMount(seedsJson: string, entityId?: string, payloadJson?: string, route?: string, crumb?: string): string;
     /** The frame delta a painter at version `since` of this kernel's frames needs (`FrameDelta` JSON): empty when current, else a snapshot. */
     framesSince(since: number): string;
     restore(traitName: string, entityId: string | undefined, snapshotJson: string): string;

package/dist/lib/index.d.ts

@@ -1,14 +1,13 @@
 import { FieldValue, EntityRow, EventKey, EnterAnimation } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary, getNestedValue } from '@almadar/core';
 export { p as profilerOnRender, u as usePerfBuffer } from '../perf-CKiBKbkw.js';
-export { T as TraitSnapshotGetter, b as bindCanvasCapture, a as bindConfigApplier, c as bindEventBus, d as bindLastDrawables, e as bindTraitStateGetter, f as clearVerification, g as getAllChecks, h as getBridgeHealth, i as getSnapshot, j as getSummary, k as getTraitSnapshots, l as getTransitions, m as getTransitionsForTrait, r as recordOrbitalResponse, n as recordServerResponse, o as recordTransition, p as recordingTransport, q as registerCheck, s as registerTraitSnapshot, t as serverEffectTraces, u as subscribeToVerification, v as updateAssetStatus, w as updateBridgeHealth, x as updateCheck, y as verifierAttached, z as waitForTransition } from '../verificationRegistry-CVrcxG1s.js';
-export { A as ApplyOperatorInput, a as ApplyOperatorResult, C as ContentSegment, E as EDITOR_MOTIONS, b as EDITOR_OPERATORS, c as EditorMotion, d as EditorOperator, I as INDENT_UNIT, L as LessonSegment, e as applyMotion, f as applyOperator, i as isEditorMotion, g as isEditorOperator, m as motionRange, p as parseContentSegments, h as parseLessonSegments, j as parseMarkdownWithCodeBlocks } from '../parseLessonSegments-GpCeMrb2.js';
+export { T as TraitSnapshotGetter, b as bindCanvasCapture, a as bindConfigApplier, c as bindEventBus, d as bindLastDrawables, e as bindTraitStateGetter, f as clearVerification, g as getAllChecks, h as getBridgeHealth, i as getSnapshot, j as getSummary, k as getTraitSnapshots, l as getTransitions, m as getTransitionsForTrait, r as recordOrbitalResponse, n as recordServerResponse, o as recordTransition, p as recordingTransport, q as registerCheck, s as registerTraitSnapshot, t as serverEffectTraces, u as subscribeToVerification, v as updateAssetStatus, w as updateBridgeHealth, x as updateCheck, y as verifierAttached, z as waitForTransition } from '../verificationRegistry-BLuQU1JV.js';
+export { A as ApplyOperatorInput, a as ApplyOperatorResult, C as ContentSegment, E as EDITOR_MOTIONS, b as EDITOR_OPERATORS, c as EditorMotion, d as EditorOperator, I as INDENT_UNIT, L as LessonSegment, e as applyMotion, f as applyOperator, i as isEditorMotion, g as isEditorOperator, m as motionRange, p as parseContentSegments, h as parseMarkdownWithCodeBlocks } from '../SegmentRenderer-BAQ6Jwf6.js';
 export { D as DENSITY_ELEMENT_VARS, a as DENSITY_SPACING_VARS, b as DIAGRAM_VARS, E as ELEVATION_VARS, F as FlatVarEntry, G as GEOMETRY_VARS, I as ICONOGRAPHY_VARS, L as LEGACY_PREFIXES, M as MOTION_DURATION_KEYS, c as MOTION_EASING_KEYS, d as MOTION_INTENT_VARS, e as MOTION_SHAPE_VARS, S as SCENE_VARS, f as SURFACE_VARS, g as StringValueKey, h as TYPE_FAMILY_VARS, i as TYPE_HEADING_VARS, j as TYPE_INTENT_VARS, k as TYPE_SIZE_KEYS, T as ThemeMode, l as enterKeyframe, r as resolveThemeForRuntime, t as themeTokensToCssVars } from '../themeTokens-CRd8AEDF.js';
 export { a as PERF_NAMESPACE, P as PerfEntry, c as clearPerf, p as perfEnd, g as perfGauge, b as perfStart, d as perfTime, i as perfTimeAsync } from '../perf-Dr28-AgT.js';
 import 'react';
 import '../verification-C5pTeMJv.js';
-import '../paintDispatch-CuJLsr9Y.js';
-import '../fx-CmQjnHmT.js';
+import '../fx-Bx5RqplG.js';
 import 'lucide-react';
 import '../EventBusProvider-BFFHfN4O.js';
 import '@almadar/shell-runtime/client/EventTransport';