@almadar/shell-web 1.2.0 → 1.3.0

package/dist/components/index.js

@@ -1,32 +1,32 @@
 "use client";
 export { assertUniqueSlotsPerHost } from '../chunk-5QTYQTPS.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';
+export { BehaviorView } from '../chunk-4IFO6QJL.js';
+export { ModuleCard } from '../chunk-TJEB4PII.js';
+import { JsonTreeEditor } from '../chunk-RCB4CKRK.js';
+export { JsonTreeEditor } from '../chunk-RCB4CKRK.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-PD5QUVRE.js';
+import { resolveSheetDirection, frameRect, GridPicker, FormSection } from '../chunk-NIOQT2IE.js';
+export { Card as ActionCard, ActionPalette, ActionTile, ActivationBlock, ActivityRail, AgentActivityFeed, AgentActivityRow, AgentChatFeed, AgentThinkingRow, Alert, AlgoGraphCanvas, AlgorithmCanvas, AnimatedCounter, AnnotatedMedia, 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-NIOQT2IE.js';
+export { FileTree } from '../chunk-RQH6O76X.js';
+import '../chunk-4UAAP6ZN.js';
+import '../chunk-NVSUTIJ2.js';
+import '../chunk-OEWVBYW5.js';
+export { Accordion } from '../chunk-BY2UJWVR.js';
+export { EmptyState } from '../chunk-AYQKZFUH.js';
 import '../chunk-HA2BYO5E.js';
 import '../chunk-PCR37T3U.js';
-import { ThemedPortal } from '../chunk-V5SVGUYN.js';
-export { Popover, Tooltip } from '../chunk-V5SVGUYN.js';
+import { ThemedPortal } from '../chunk-3WSTUUJ7.js';
+export { Popover, Tooltip } from '../chunk-3WSTUUJ7.js';
 import '../chunk-3UQNFRYV.js';
-import '../chunk-LKL5RULQ.js';
+import '../chunk-3OF2X6GG.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-MXN32OVV.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-CB4POLGP.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-QZ6TDP6I.js';
+import '../chunk-FZOX7XTU.js';
 import '../chunk-3BBUBJFF.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 { VStack, Button, HStack, GameIcon, Typography, Box, useTranslate, Badge, Icon, cn, Select, domPassthrough, Switch, Input } from '../chunk-OOG33EGF.js';
 import { getKnownPatterns, getPatternDefinition } from '../chunk-ECC3WQIB.js';
 import '../chunk-AZ74UPG6.js';
 import '../chunk-G7DCAZ22.js';
@@ -1104,4 +1104,9 @@ var EntityDisplayEvents = {
   DESELECT: "DESELECT"
 };
 
-export { ALL_PRESETS, AssetPicker, Coachmark, CollapsibleSection, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EntityDisplayEvents, FEATURE_TYPES, IconPicker, NodeSlotEditor, OnboardingSpotlight, PropertyInspector, StatusBar, TERRAIN_COLORS, TerrainPalette, boardEntity, bool, calculateAttackTargets, calculateValidMoves, createInitialGameState, makeAsset, makeAssetMap, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, pendulum, projectileMotion, rows, springOscillator, str, unitHealth, unitPosition, unitTeam, useAnchorRect, useUnitSpriteAtlas, vec2 };
+// src/components/game/atoms/DrawEmitter.tsx
+function DrawEmitter(_props) {
+  return null;
+}
+
+export { ALL_PRESETS, AssetPicker, Coachmark, CollapsibleSection, DrawEmitter, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EntityDisplayEvents, FEATURE_TYPES, IconPicker, NodeSlotEditor, OnboardingSpotlight, PropertyInspector, StatusBar, TERRAIN_COLORS, TerrainPalette, boardEntity, bool, calculateAttackTargets, calculateValidMoves, createInitialGameState, makeAsset, makeAssetMap, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, pendulum, projectileMotion, rows, springOscillator, str, unitHealth, unitPosition, unitTeam, useAnchorRect, useUnitSpriteAtlas, vec2 };

package/dist/context/index.js

@@ -1,8 +1,8 @@
 "use client";
-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 { DesignThemeProvider, useDesignTheme } from '../chunk-YU2ZNLGI.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-FZOX7XTU.js';
 export { resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-3BBUBJFF.js';
 import '../chunk-ANTJUQRD.js';
-import '../chunk-D5FJU4XC.js';
+import '../chunk-OOG33EGF.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-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';
+import { I as IconInput } from './fx-Bc3yEVED.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-Bc3yEVED.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-DuX0Gvwo.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';
@@ -335,6 +335,9 @@ interface BoxMarquee {
     /** Repeat the content right after itself so the strip never runs out; without it the content leaves and starts over */
     loop: boolean;
 }
+/**
+ * @layoutOnly
+ */
 interface BoxProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, keyof A11yProps>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -454,6 +457,9 @@ declare const CardContent: React__default.ForwardRefExoticComponent<React__defau
 declare const CardBody: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
 declare const CardFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
 
+/**
+ * @layoutOnly
+ */
 interface CenterProps extends A11yProps {
     /** Center inline (width fits content) vs block (full width) */
     inline?: boolean;
@@ -1088,6 +1094,9 @@ declare const SectionHeader: React__default.FC<SectionHeaderProps>;
  */
 
 type SpacerSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'auto';
+/**
+ * @layoutOnly
+ */
 interface SpacerProps extends A11yProps {
     /** Fixed size (auto = flex grow) */
     size?: SpacerSize;
@@ -1162,6 +1171,9 @@ type StackDirection = "horizontal" | "vertical";
 type StackGap = "none" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
 type StackAlign = "start" | "center" | "end" | "stretch" | "baseline";
 type StackJustify = "start" | "center" | "end" | "between" | "around" | "evenly";
+/**
+ * @layoutOnly
+ */
 interface StackProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** Stack direction */
     direction?: StackDirection;
@@ -1244,7 +1256,7 @@ declare const StatusDot: React__default.ForwardRefExoticComponent<StatusDotProps
 /**
  * @accessibleName label
  * @role switch
- * @tokens --color-primary --color-muted --color-background
+ * @tokens --color-primary --color-muted-foreground --color-background
  * @motion css
  */
 interface SwitchProps extends A11yProps {
@@ -1252,7 +1264,9 @@ interface SwitchProps extends A11yProps {
     defaultChecked?: boolean;
     onChange?: (checked: boolean) => void;
     /** Declarative event name — emits UI:{action} with `actionPayload` and the new `checked` value on toggle */
-    action?: EventKey;
+    action?: EventEmit<{
+        checked: boolean;
+    }>;
     /** Payload to include with the action event (the new `checked` is added to it)
      *  @payloadFor action
      */
@@ -1345,7 +1359,10 @@ interface TextareaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
     placeholder?: string;
     /** Number of visible rows */
     rows?: number;
-    /** Controlled value, for a field the program fills or clears. */
+    /** Controlled value, for a field the program fills or clears.
+     *  @changedBy onChange
+     *  @changedBy action
+     */
     value?: string;
     /** Declarative event: fires on ⌘/Ctrl+Enter with `{ value }`. */
     action?: EventEmit<{

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, 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';
+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-OOG33EGF.js';
 import './chunk-G7DCAZ22.js';

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

@@ -1,4 +1,4 @@
-import { A11yProps, Asset, AssetUrl, ScenePos } from '@almadar/core';
+import { A11yProps, Asset, EntityFieldName, AssetUrl, ScenePos } from '@almadar/core';
 import React__default from 'react';
 import { LucideIcon } from 'lucide-react';
 
@@ -94,7 +94,7 @@ type DisplayFieldFormat = 'date' | 'time' | 'datetime' | 'currency' | 'number' |
  */
 interface DisplayField {
     /** Entity field name (dot-notation supported) */
-    name: string;
+    name: EntityFieldName;
     /** Display label (the `name` as written if omitted) */
     label?: string;
     /** Icon shown beside the field */

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-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 { 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-PD5QUVRE.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-CB4POLGP.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-QZ6TDP6I.js';
 export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-ANTJUQRD.js';
-import '../chunk-D5FJU4XC.js';
+import '../chunk-OOG33EGF.js';
 import '../chunk-AZ74UPG6.js';
 import '../chunk-G7DCAZ22.js';

package/dist/index.d.ts

@@ -15,7 +15,7 @@ import { KernelEngine as KernelEngine$1 } from '@almadar/shell-runtime/kernel/en
 export * from '@almadar/shell-runtime/kernel/engine';
 import { KernelHostPorts, KernelAnswerScope } from '@almadar/shell-runtime/kernel/host';
 export * from '@almadar/shell-runtime/kernel/host';
-import { OrbitalSchema, EventRequest, EventResponse, MountSeed, OnDeviceModelPorts, BrowserTabPort, OrbitalDefinition, UISlot, AnyPatternConfig, ResolvedPatternProps, EventSource, SExpr, RuntimeValue } from '@almadar/core';
+import { OrbitalSchema, PersistenceAdapter, EventRequest, EventResponse, MountSeed, OnDeviceModelPorts, BrowserTabPort, OrbitalDefinition, UISlot, AnyPatternConfig, ResolvedPatternProps, EventSource, SExpr, RuntimeValue } from '@almadar/core';
 export * from '@almadar/shell-runtime/kernel/program-effects';
 export * from '@almadar/shell-browser/page-facts';
 export * from '@almadar/shell-runtime/effects/on-device-model';
@@ -23,6 +23,7 @@ import { FramePostPort, FrameApplied } from '@almadar/shell-runtime/kernel/frame
 export * from '@almadar/shell-runtime/kernel/frame-applier';
 import { LocalFoldKernel } from '@almadar/shell-runtime/client/client-kernel';
 export { ClientDispatchHooks, ClientEmitOutcome, ClientKernel, ClientKernelOutcome, ClientMountHooks, ClientMountOutcome, LocalFoldKernel } from '@almadar/shell-runtime/client/client-kernel';
+import { HeldValues } from '@almadar/shell-runtime/kernel/held-values';
 export * from '@almadar/shell-runtime/loader/schema-loader';
 export * from '@almadar/shell-runtime/loader/lazy-page';
 export * from '@almadar/shell-runtime/credentials/env-vars';
@@ -48,10 +49,10 @@ import { LocalKernelOptions, openLocalKernel as openLocalKernel$1 } from '@almad
 export { LocalKernelOptions, LocalStoreTransportOptions, createLocalStoreTransport, localStorePersistence, resolveLocalRows } from '@almadar/shell-runtime/runtime/evaluation/local-store-transport';
 export { ResidenceTransportOptions, createResidenceTransport } from '@almadar/shell-runtime/runtime/evaluation/residence-transport';
 import { KernelModule as KernelModule$1 } from './providers/index.js';
-import { IndexedDbPersistence } from '@almadar/shell-browser/storage';
+import { ChangeRecord } from '@almadar/shell-browser/storage';
+export { V as VerificationBus, b as bindEventBus, a as bindTraitStateGetter, e as ensureVerificationApi, g as getOrbitalVerification } from './verification-C5pTeMJv.js';
 export { w as wrapCallbackForEvent } from './wrapCallbackForEvent-B9QLbhxX.js';
 export { a as PERF_NAMESPACE, e as PerfDetail, f as PerfDetailValue, P as PerfEntry, c as clearPerf, p as perfEnd, g as perfGauge, b as perfStart, h as perfStore, d as perfTime, i as perfTimeAsync, j as pushPerfEntry } from './perf-Dr28-AgT.js';
-export { V as VerificationBus, b as bindEventBus, a as bindTraitStateGetter, e as ensureVerificationApi, g as getOrbitalVerification } from './verification-C5pTeMJv.js';
 export * from '@almadar/shell-runtime/events/EventBus';
 export * from '@almadar/shell-runtime/events/emit-stamp';
 import '@almadar/core/patterns';
@@ -84,6 +85,8 @@ interface TickFramePorts {
     client: LocalFoldKernel;
     /** Posts what fired ticks owe; `undefined` for a host with no transport (the frame then only folds locally). */
     post: FramePostPort | undefined;
+    /** The kernel's held render values (EXEC-DIST-16), which its frames name by reference. */
+    held: HeldValues;
 }
 /** One host frame: `Kernel.frame(now())`, then the applier. Shared by the poll driver and by hosts that step on demand. */
 declare function runTickFrame(ports: TickFramePorts, now: () => number): Promise<FrameApplied>;
@@ -107,6 +110,12 @@ declare function nativeMemoryPersistence(kernel: KernelModule): NativeMemoryPers
 
 declare function openLocalKernel(options: LocalKernelOptions): ReturnType<typeof openLocalKernel$1>;
 
+/** Where a browser keeps rows between visits: it stores and returns whole rows, and answers no query. */
+interface BrowserDatabase extends Pick<PersistenceAdapter, 'create' | 'delete' | 'list'> {
+    /** The write log: empty only for a database no visit has written to. */
+    changes(): Promise<readonly ChangeRecord[]>;
+}
+
 /**
  * The browser store of a program's `[persistent: x, browser]` entities, opened once, and the in-process transport its legs run through. The runtime
  * host (`useBrowserStore`) and compiled static clients both open it here.
@@ -114,8 +123,12 @@ declare function openLocalKernel(options: LocalKernelOptions): ReturnType<typeof
 
 /** One browser database per app and viewer locale, so a visitor's records stay in one language. */
 declare function browserStoreName(appName: string, locale: string | undefined): string;
-/** Open the store; `null` when no entity is browser-stored. */
-declare function openBrowserStore(databaseName: string, orbitals: readonly OrbitalDefinition[], factory?: IDBFactory): Promise<IndexedDbPersistence | null>;
+/** The rows of a browser-stored program, filed by collection: `persistedMemory`'s database over the app's IndexedDB. */
+interface BrowserStore extends BrowserDatabase {
+    close(): void;
+}
+/** Open the store; `null` when no entity is browser-stored. Every entity bound to one collection shares its rows. A program once filed under `formerDatabaseName` has its rows moved in. */
+declare function openBrowserStore(databaseName: string, orbitals: readonly OrbitalDefinition[], factory?: IDBFactory, formerDatabaseName?: string): Promise<BrowserStore | null>;
 interface BrowserStoreTransportOptions {
     databaseName: string;
     schema: OrbitalSchema;

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-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 { runTickFrame, createTickDriver } from './chunk-OXHXISFA.js';
+export { createTickDriver, runTickFrame } from './chunk-OXHXISFA.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-MXN32OVV.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-MXN32OVV.js';
 import { __export, __reExport } from './chunk-G7DCAZ22.js';
 export * from '@almadar/shell-runtime/kernel/wire';
 export * from '@almadar/shell-runtime/kernel/decode';

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

@@ -1,5 +1,5 @@
-import { createTickDriver, runTickFrame } from './chunk-AU7O65OX.js';
-import { presenceGroup, getTraitPresence } from './chunk-D5FJU4XC.js';
+import { createTickDriver, runTickFrame } from './chunk-OXHXISFA.js';
+import { presenceGroup, getTraitPresence } from './chunk-OOG33EGF.js';
 import './chunk-G7DCAZ22.js';
 import { isJsonObject } from '@almadar/core';
 import { createLocalFold, paintResponse, traceResponse } from '@almadar/shell-runtime';
@@ -7,6 +7,7 @@ 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';
+import { HeldValues } from '@almadar/shell-runtime/kernel/held-values';
 
 var log = createLogger("almadar:ui:kernel-client");
 var nextClientSerial = 0;
@@ -21,24 +22,51 @@ var defaultFrameScheduler = (callback) => {
 function parse(text) {
   return JSON.parse(text);
 }
+var heldByKernel = /* @__PURE__ */ new WeakMap();
+function heldOf(k) {
+  let held = heldByKernel.get(k);
+  if (held === void 0) {
+    held = new HeldValues();
+    heldByKernel.set(k, held);
+  }
+  return held;
+}
+function readAnswer(k, text) {
+  const held = heldOf(k);
+  held.release(k.heldReleased());
+  return held.read(text);
+}
 function payloadJson(payload) {
   return payload === void 0 ? void 0 : JSON.stringify(payload);
 }
+var foldTurnsByKernel = /* @__PURE__ */ new WeakMap();
+function foldTurnsOf(k) {
+  let turns = foldTurnsByKernel.get(k);
+  if (turns === void 0) {
+    turns = /* @__PURE__ */ new Map();
+    foldTurnsByKernel.set(k, turns);
+  }
+  return turns;
+}
+var liveStoreByKernel = /* @__PURE__ */ new WeakMap();
 function createKernelClient(opts) {
-  const { store, traitIndex, transport } = opts;
+  const { traitIndex, transport } = opts;
   let loaded;
+  const liveStore = () => loaded === void 0 ? opts.store : liveStoreByKernel.get(loaded) ?? opts.store;
+  const store = new Proxy(opts.store, { get: (_own, key) => Reflect.get(liveStore(), key) });
   const configs = /* @__PURE__ */ new Map();
   const ready = Promise.all([opts.instance, opts.gpu]).then(([k, gpu]) => {
     loaded = k;
+    liveStoreByKernel.set(k, opts.store);
     if (gpu !== void 0) k.installGpu(gpu, (json) => deliverGpuCompletion(k, json));
     return k;
   });
   ready.catch(() => void 0);
   const visibleGroups = [...traitIndex.byName].filter(([, entry]) => entry.ticks.some((tick) => tick.whileVisible)).map(([name]) => [name, presenceGroup(traitIndex, name)]);
-  const foldTurns = /* @__PURE__ */ new Map();
   const runQueuedFolds = (k) => {
+    const foldTurns = foldTurnsOf(k);
     for (let json = k.nextFold(); json !== void 0; json = k.nextFold()) {
-      const next = parse(json);
+      const next = readAnswer(k, json);
       const turn = foldTurns.get(next.ticket);
       if (turn === void 0) throw new Error(`kernel wire: the kernel folded ticket ${next.ticket}, which nothing waits on`);
       foldTurns.delete(next.ticket);
@@ -46,13 +74,13 @@ function createKernelClient(opts) {
       else turn.ran(next.fold);
     }
   };
-  const foldInOrder = (k, flight, answer, alreadyDeliveredJson, baseJson) => settleProgress(k, parse(k.foldInOrder(flight, JSON.stringify(answer), alreadyDeliveredJson, baseJson)));
-  const deliverInOrder = (k, flight, emitted) => settleProgress(k, parse(k.deliverEmitToListeners(flight, JSON.stringify(emitted))));
-  const deliverOriginInOrder = (k, flight, emitted) => settleProgress(k, parse(k.deliverOriginEmit(flight, JSON.stringify(emitted))));
+  const foldInOrder = (k, flight, answer, alreadyDeliveredJson, baseJson) => settleProgress(k, readAnswer(k, k.foldInOrder(flight, JSON.stringify(answer), alreadyDeliveredJson, baseJson)));
+  const deliverInOrder = (k, flight, emitted) => settleProgress(k, readAnswer(k, k.deliverEmitToListeners(flight, JSON.stringify(emitted))));
+  const deliverOriginInOrder = (k, flight, emitted) => settleProgress(k, readAnswer(k, k.deliverOriginEmit(flight, JSON.stringify(emitted))));
   const settleProgress = (k, progress) => {
     if (progress.status === "applied") return Promise.resolve(progress.fold);
     const turn = new Promise((ran, failed) => {
-      foldTurns.set(progress.ticket, { ran, failed });
+      foldTurnsOf(k).set(progress.ticket, { ran, failed });
     });
     queueMicrotask(() => runQueuedFolds(k));
     return turn;
@@ -69,10 +97,11 @@ function createKernelClient(opts) {
   let scopeTail = Promise.resolve();
   const framesSince = (since) => {
     if (loaded === void 0) throw new Error("the kernel is not loaded");
-    return parse(loaded.framesSince(since));
+    return readAnswer(loaded, loaded.framesSince(since));
   };
   const mirror = (response) => paintResponse(store, framesSince, response);
   const traceStreams = /* @__PURE__ */ new Set();
+  const costed = () => [...traceStreams].some((stream) => stream.cost);
   const movedTraits = (item) => {
     const dispatch = item["dispatch"];
     const outcomes = dispatch !== void 0 && dispatch !== null && isJsonObject(dispatch) ? dispatch["outcomes"] ?? null : null;
@@ -81,12 +110,17 @@ function createKernelClient(opts) {
   };
   const publishTrace = (k) => {
     if (traceStreams.size === 0) return;
-    const items = parse(k.takeTrace());
-    if (!Array.isArray(items)) return;
-    for (const item of items) {
-      if (item === null || !isJsonObject(item)) continue;
-      const moved = movedTraits(item);
+    const views = parse(k.takeTraceViews());
+    if (!Array.isArray(views)) return;
+    for (const view of views) {
+      if (view === null || !isJsonObject(view)) continue;
+      const plain = view["plain"];
+      if (plain === void 0 || plain === null || !isJsonObject(plain)) continue;
+      const measured = view["costed"];
+      const costedItem = measured !== void 0 && measured !== null && isJsonObject(measured) ? measured : plain;
+      const moved = movedTraits(plain);
       for (const stream of traceStreams) {
+        const item = stream.cost ? costedItem : plain;
         if (moved.some((t) => stream.traits.has(t))) queueMicrotask(() => stream.onItem(item));
       }
     }
@@ -106,7 +140,7 @@ function createKernelClient(opts) {
     const snapshot = wire.snapshot;
     if (snapshot === null) return { clientEffectsByTrait: [] };
     const trait = wire.seed.trait;
-    const repaint = parse(k.restore(trait, entityId, JSON.stringify(snapshot)));
+    const repaint = readAnswer(k, k.restore(trait, entityId, JSON.stringify(snapshot)));
     if (snapshot.state !== "") store.states.rollbackState(trait, snapshot.state, entityId, "server-rejected");
     mirror(repaint);
     store.notify();
@@ -154,7 +188,7 @@ function createKernelClient(opts) {
     } catch (err) {
       const seeds = mountedSeeds.get(orbital);
       if (!(err instanceof SessionEndedError) || seeds === void 0 || seeds.length === 0) throw err;
-      const reseed = JSON.parse(k.reseedLeg(JSON.stringify(seeds), request.entityId));
+      const reseed = readAnswer(k, k.reseedLeg(JSON.stringify(seeds), request.entityId));
       const mounted = await transport.send(orbital, request.locale !== void 0 ? { ...reseed, locale: request.locale } : reseed);
       await foldAnswer(k, flight, mounted);
       store.notify();
@@ -172,7 +206,7 @@ function createKernelClient(opts) {
     if (transport === void 0) return out;
     const queue = [...legs];
     for (let planned = queue.shift(); planned !== void 0; planned = queue.shift()) {
-      const shaped = planned.keepsState ? planned.leg : JSON.parse(k.statefulLeg(JSON.stringify(planned.leg)));
+      const shaped = planned.keepsState ? planned.leg : readAnswer(k, k.statefulLeg(JSON.stringify(planned.leg)));
       const sent = request.locale !== void 0 ? { ...shaped, locale: request.locale } : shaped;
       const base = k.foldBase(sent.entityByTrait !== void 0 ? JSON.stringify(sent.entityByTrait) : void 0, JSON.stringify(planned.foldSeeded), sent.entityId);
       let posted;
@@ -213,7 +247,7 @@ function createKernelClient(opts) {
       };
       out.success = out.success && posted.success;
       if (posted.error !== void 0) out.error = posted.error;
-      out.rejections.push(...(fold.rejections ?? []).filter((r) => r.code === "effect-failed" || r.code === "repaint-failed"));
+      out.rejections.push(...(fold.rejections ?? []).filter((r) => r.code === "effect-failed" || r.code === "repaint-failed" || r.code === "cascade-capped"));
     }
     return out;
   };
@@ -254,14 +288,17 @@ function createKernelClient(opts) {
       frame: (nowMs) => {
         const presence = getTraitPresence();
         for (const [traitName, group] of visibleGroups) k.setTraitOnScreen(traitName, presence.state(group) !== "off-screen");
-        return k.frame(nowMs);
+        const frame = k.frame(nowMs);
+        heldOf(k).release(k.heldReleased());
+        return frame;
       },
       framePause: () => k.framePause(),
       frameResume: () => k.frameResume(),
       tickCount: () => k.tickCount()
     },
     client: localFold,
-    post: framePost(k)
+    post: framePost(k),
+    held: heldOf(k)
   });
   const dispatchOne = async (request, hooks, progress) => {
     const traitName = request.targetTrait;
@@ -269,13 +306,13 @@ function createKernelClient(opts) {
     const k = await ready;
     await scopeTail;
     if (request.runTick !== void 0) {
-      const response = parse(k.tick(request.runTick.trait, request.runTick.tick, request.entityId));
+      const response = readAnswer(k, k.tick(request.runTick.trait, request.runTick.tick, request.entityId));
       publishTrace(k);
       mirror(response);
       store.notify();
       return { response, mode: parse(k.dispatchMode(request.runTick.trait)) };
     }
-    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)));
+    const wire = readAnswer(k, 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 {
@@ -419,12 +456,12 @@ function createKernelClient(opts) {
   const release = async (left) => {
     if (transport === void 0 || left.length === 0) return;
     await opts.topology;
-    for (const { trait, orbital, leg } of left) {
-      transport.send(orbital, leg).catch((err) => log.warn("unmount-post-failed", { trait, orbital, error: String(err) }));
+    for (const { traits, orbital, leg } of left) {
+      transport.send(orbital, leg).catch((err) => log.warn("unmount-post-failed", { traits, orbital, error: String(err) }));
     }
   };
   const client = {
-    store,
+    store: opts.store,
     dispatch: (request, hooks) => dispatchOne(request, hooks !== void 0 ? [hooks] : [], false),
     dispatchProgress: (request) => dispatchOne(request, [], true),
     foldHostDispatch: async (request, response) => {
@@ -460,7 +497,7 @@ 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, baseRequest.crumb));
+      const mount = readAnswer(k, k.dispatchMount(JSON.stringify(seeds), baseRequest.entityId, payloadJson(baseRequest.payload), baseRequest.route, baseRequest.crumb));
       try {
         return await settleMount(k, mount, seeds, hooks, baseRequest);
       } finally {
@@ -471,15 +508,15 @@ function createKernelClient(opts) {
     routeMounts: async (routePath) => parse((await ready).routeMounts(routePath)),
     pageCircuit: async (page, route) => parse((await ready).pageCircuit(page, route)),
     enter: (routePath, mountKey, traits) => {
-      const entered = scopeTail.then(() => ready).then((k) => parse(k.enter(routePath, `${clientSerial}\0${mountKey}`, JSON.stringify(traits))));
+      const entered = scopeTail.then(() => ready).then((k) => readAnswer(k, k.enter(routePath, `${clientSerial}\0${mountKey}`, JSON.stringify(traits))));
       scopeTail = entered.then(() => void 0, () => void 0);
       return entered.then((answer) => {
         void release(answer.left);
-        return { seeds: answer.seeds, left: answer.left.map((l) => l.trait) };
+        return { seeds: answer.seeds, left: answer.left.flatMap((l) => l.traits) };
       });
     },
     leave: async () => {
-      const left = scopeTail.then(() => ready).then((k) => parse(k.leave()));
+      const left = scopeTail.then(() => ready).then((k) => readAnswer(k, k.leave()));
       scopeTail = left.then(() => void 0, () => void 0);
       await release(await left);
     },
@@ -544,12 +581,16 @@ function createKernelClient(opts) {
         releases.forEach((release2) => release2());
       };
     },
-    traceStream: (traits, onItem) => {
-      const stream = { traits: new Set(traits), onItem };
+    traceStream: (traits, onItem, cost = false) => {
+      const stream = { traits: new Set(traits), onItem, cost };
       traceStreams.add(stream);
-      void ready.then((k) => k.setTraceOn(true)).catch((error) => log.error("trace-stream-failed", { error: error.message }));
+      void ready.then((k) => {
+        k.setTraceOn(true);
+        k.setTraceCost(costed());
+      }).catch((error) => log.error("trace-stream-failed", { error: error.message }));
       return () => {
         traceStreams.delete(stream);
+        loaded?.setTraceCost(costed());
         if (traceStreams.size === 0) loaded?.setTraceOn(false);
       };
     },

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

@@ -28,6 +28,8 @@ interface KernelInstance {
     deliverOriginEmit(flight: number, emittedJson: string): string;
     /** The oldest queued answer that can fold now, folded: a `FoldedNextWire` as JSON, or `undefined` when none waits. */
     nextFold(): string | undefined;
+    /** The held render values (EXEC-DIST-16) the kernel let go of since the last call: a JSON array of ids. */
+    heldReleased(): string;
     /** The flight is done: its answers are folded, or the host gave up on them. */
     endFlight(flight: number): boolean;
     /** The rows a posted leg's answer is folded against; `undefined` when the leg carried none. */
@@ -62,6 +64,10 @@ interface KernelInstance {
     setTraceOn(on: boolean): void;
     /** The trace items recorded since the last take, in dispatch order: a JSON array. */
     takeTrace(): string;
+    /** Measure each recorded dispatch while on (EXEC-COST-1). */
+    setTraceCost(on: boolean): void;
+    /** The items recorded since the last take, each `{ plain, costed? }` (EXEC-COST-1): a JSON array. */
+    takeTraceViews(): string;
     /** Carry each frame response's `effectResults` (omitted otherwise), for a verifier. */
     setFrameEffectResults(carry: boolean): void;
     /** The kernel's mounts for a host start on `side` (`client|server|process|start`): `MountSeed[]` as JSON. */

package/dist/lib/index.d.ts

@@ -1,13 +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-BLuQU1JV.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-Dz5N0oxx.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 '../fx-Bx5RqplG.js';
+import '../fx-Bc3yEVED.js';
 import 'lucide-react';
 import '../EventBusProvider-BFFHfN4O.js';
 import '@almadar/shell-runtime/client/EventTransport';