@almadar/shell-web 1.0.0 → 1.1.0

package/dist/components/index.js

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

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-Br8zjvu9.js';
+export { B as Badge, b as BadgeColor, c as BadgeProps, d as BadgeSize, e as BadgeVariant, C as CONFETTI_BURST_KEYFRAMES, f as CONFETTI_COLORS, g as ColorToken, h as ConfettiParticle, D as DisplayField, i as DisplayFieldFormat, j as DisplayFieldVariant, F as FxItem, k as FxLifecycle, l as FxOverlayItem, m as FxOverlayKind, a as FxPreset, n as FxProceduralShape, o as FxSpace, p as FxView, q as Icon, r as IconAnimation, s as IconProps, t as IconSize, u as ImageSource, L as LinkAction, P as Point, R as Rect, U as UiError, v as createConfettiParticles, w as fxHash01, x as fxLifecycle, y as resolveFxView, z as resolveIcon } from './fx-Br8zjvu9.js';
+export { B as Button, a as ButtonProps, b as ButtonSize, c as ButtonVariant, I as Input, d as InputProps, P as PatternTile, e as PatternTileProps, f as PatternVariant, S as Select, g as SelectOption, h as SelectOptionGroup, i as SelectProps, j as getTileDimensions } from './Select-C2Uq6t86.js';
 export { E as EventBusContext, a as EventBusContextType, b as EventBusContextTypeExtended, c as EventBusProvider, V as VideoEmbed, d as VideoEmbedProps, e as VideoErrorPayload, f as VideoPlayPayload, g as VideoReadyPayload, h as getGlobalEventBus, s as setGlobalEventBus, u as useEmitEvent, i as useEventBus, j as useEventListener, k as useEventSubscription, l as useRootEventBus } from './EventBusProvider-BFFHfN4O.js';
 import { ClassValue } from 'clsx';
 import { LucideIcon } from 'lucide-react';

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

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

package/dist/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/{kernel-client-TZKGHJRY.js → kernel-client-JW6OH5FX.js}

@@ -2,10 +2,11 @@ import { createTickDriver, runTickFrame } from './chunk-AU7O65OX.js';
 import { presenceGroup, getTraitPresence } from './chunk-4YXBKHHM.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);
@@ -441,6 +460,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 +506,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-DGAySGhX.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. */

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 { 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-oopV1J1n.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 { 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-Br8zjvu9.js';
 import 'lucide-react';
 import '../EventBusProvider-BFFHfN4O.js';
 import '@almadar/shell-runtime/client/EventTransport';

package/dist/lib/index.js

@@ -1,8 +1,7 @@
 "use client";
-export { EDITOR_MOTIONS, EDITOR_OPERATORS, ENTER_SLOT_CLASS, INDENT_UNIT, MAX_ENTER_DELAY, applyMotion, applyOperator, asEnterAnimation, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, computeLineDiff, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, enterClassName, getAllTicks, getAllTraits, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getTick, getTrait, initDebugShortcut, isDebugEnabled, isEditorMotion, isEditorOperator, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, motionRange, onDebugToggle, parseContentSegments, parseLessonSegments, parseMarkdownWithCodeBlocks2 as parseMarkdownWithCodeBlocks, profilerOnRender, recordGuardEvaluation, registerTick, registerTrait, resolveImageUrl, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, toggleDebug, unregisterTick, unregisterTrait, updateGuardResult, updateTickExecution, updateTraitState, usePerfBuffer } from '../chunk-TUPZWTRE.js';
+export { EDITOR_MOTIONS, EDITOR_OPERATORS, ENTER_SLOT_CLASS, INDENT_UNIT, MAX_ENTER_DELAY, applyMotion, applyOperator, asEnterAnimation, bindCanvasCapture, bindConfigApplier, bindEventBus, bindLastDrawables, bindTraitStateGetter, clearDebugEvents, clearEntityProvider, clearGuardHistory, clearTicks, clearTraits, clearVerification, computeLineDiff, debug, debugCollision, debugError, debugGameState, debugGroup, debugGroupEnd, debugInput, debugPhysics, debugTable, debugTime, debugTimeEnd, debugWarn, enterClassName, getAllChecks, getAllTicks, getAllTraits, getBridgeHealth, getDebugEvents, getEntitiesByType, getEntityById, getEntitySnapshot, getEventsBySource, getEventsByType, getGuardEvaluationsForTrait, getGuardHistory, getNestedValue, getRecentEvents, getRecentGuardEvaluations, getSnapshot, getSummary, getTick, getTrait, getTraitSnapshots, getTransitions, getTransitionsForTrait, initDebugShortcut, isDebugEnabled, isEditableTarget, isEditorMotion, isEditorOperator, keyMapCode, logDebugEvent, logEffectExecuted, logError, logEventFired, logInfo, logStateChange, logWarning, motionRange, onDebugToggle, parseContentSegments, parseLessonSegments, parseMarkdownWithCodeBlocks2 as parseMarkdownWithCodeBlocks, profilerOnRender, recordGuardEvaluation, recordOrbitalResponse, recordServerResponse, recordTransition, recordingTransport, registerCheck, registerTick, registerTrait, registerTraitSnapshot, resolveImageUrl, resolveKeyMapEvent, serverEffectTraces, setDebugEnabled, setEntityProvider, setTickActive, subscribeToDebugEvents, subscribeToGuardChanges, subscribeToTickChanges, subscribeToTraitChanges, subscribeToVerification, toggleDebug, unregisterTick, unregisterTrait, updateAssetStatus, updateBridgeHealth, updateCheck, updateGuardResult, updateTickExecution, updateTraitState, usePerfBuffer, verifierAttached, waitForTransition } from '../chunk-2WGR4TDJ.js';
 export { arrowheadPath, brainIconPath, eightPointedStarPath, gearTeethPath, lockIconPath, pipeIconPath } from '../chunk-TZZBINQY.js';
-export { bindCanvasCapture, bindConfigApplier, bindEventBus, bindLastDrawables, bindTraitStateGetter, clearVerification, getAllChecks, getBridgeHealth, getSnapshot, getSummary, getTraitSnapshots, getTransitions, getTransitionsForTrait, isEditableTarget, keyMapCode, recordOrbitalResponse, recordServerResponse, recordTransition, recordingTransport, registerCheck, registerTraitSnapshot, resolveKeyMapEvent, serverEffectTraces, subscribeToVerification, updateAssetStatus, updateBridgeHealth, updateCheck, verifierAttached, waitForTransition } from '../chunk-ILZ7ORX7.js';
-export { PERF_NAMESPACE, clearPerf, perfEnd, perfGauge, perfStart, perfTime, perfTimeAsync } from '../chunk-3VZ36ZKO.js';
+export { PERF_NAMESPACE, clearPerf, perfEnd, perfGauge, perfStart, perfTime, perfTimeAsync } from '../chunk-ZDRDJKYB.js';
 export { DENSITY_ELEMENT_VARS, DENSITY_SPACING_VARS, DIAGRAM_VARS, ELEVATION_VARS, GEOMETRY_VARS, ICONOGRAPHY_VARS, LEGACY_PREFIXES, MOTION_DURATION_KEYS, MOTION_EASING_KEYS, MOTION_INTENT_VARS, MOTION_SHAPE_VARS, SCENE_VARS, SURFACE_VARS, TYPE_FAMILY_VARS, TYPE_HEADING_VARS, TYPE_INTENT_VARS, TYPE_SIZE_KEYS, enterKeyframe, resolveThemeForRuntime, themeTokensToCssVars } from '../chunk-3BBUBJFF.js';
 import '../chunk-4YXBKHHM.js';
 import '../chunk-G7DCAZ22.js';

package/dist/providers/index.css

@@ -1160,7 +1160,195 @@ body {
   counter-reset: katexEqnNo mmlEqnNo;
 }
 
-/* src/lib/drawable/three/Canvas3DLoadingState.css */
+/* src/lib/drawable/orbital/OrbitalCanvas3D.css */
+.game-canvas-3d {
+  background: #1a1a2e;
+  border-radius: 8px;
+}
+.game-canvas-3d canvas {
+  display: block;
+  width: 100%;
+  height: 100%;
+}
+.game-canvas-3d--loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background:
+    linear-gradient(
+      135deg,
+      #1a1a2e 0%,
+      #16213e 100%);
+}
+.game-canvas-3d__loading {
+  padding: 20px 40px;
+  background: rgba(255, 255, 255, 0.1);
+  border-radius: 8px;
+  color: #ffffff;
+  font-size: 16px;
+  animation: pulse 1.5s ease-in-out infinite;
+}
+.game-canvas-3d--error {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background:
+    linear-gradient(
+      135deg,
+      #2e1a1a 0%,
+      #3e1616 100%);
+}
+.game-canvas-3d__error {
+  position: relative;
+  z-index: 1;
+  padding: 20px 40px;
+  background: rgba(255, 0, 0, 0.2);
+  border: 1px solid rgba(255, 0, 0, 0.3);
+  border-radius: 8px;
+  color: #ff6b6b;
+  font-size: 14px;
+}
+.game-canvas-3d__coordinates {
+  position: absolute;
+  bottom: 20px;
+  left: 20px;
+  padding: 8px 16px;
+  background: rgba(0, 0, 0, 0.7);
+  border-radius: 4px;
+  color: #ffffff;
+  font-family: monospace;
+  font-size: 12px;
+  pointer-events: none;
+  z-index: 10;
+}
+.game-canvas-3d__tile-info {
+  position: absolute;
+  top: 20px;
+  left: 20px;
+  padding: 12px 16px;
+  background: rgba(0, 0, 0, 0.8);
+  border-radius: 6px;
+  color: #ffffff;
+  pointer-events: none;
+  z-index: 10;
+  min-width: 120px;
+}
+.tile-info__type {
+  font-weight: 600;
+  font-size: 14px;
+  text-transform: capitalize;
+  margin-bottom: 4px;
+}
+.tile-info__terrain {
+  font-size: 12px;
+  color: #aaaaaa;
+}
+@keyframes pulse {
+  0%, 100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.5;
+  }
+}
+.game-canvas-3d[data-camera-mode=isometric]::before {
+  content: "Isometric";
+  position: absolute;
+  top: 20px;
+  right: 20px;
+  padding: 6px 12px;
+  background: rgba(0, 0, 0, 0.6);
+  border-radius: 4px;
+  color: #ffffff;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  pointer-events: none;
+}
+.game-canvas-3d[data-camera-mode=perspective]::before {
+  content: "Perspective";
+  position: absolute;
+  top: 20px;
+  right: 20px;
+  padding: 6px 12px;
+  background: rgba(0, 0, 0, 0.6);
+  border-radius: 4px;
+  color: #ffffff;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  pointer-events: none;
+}
+.game-canvas-3d[data-camera-mode=top-down]::before {
+  content: "Top Down";
+  position: absolute;
+  top: 20px;
+  right: 20px;
+  padding: 6px 12px;
+  background: rgba(0, 0, 0, 0.6);
+  border-radius: 4px;
+  color: #ffffff;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 1px;
+  pointer-events: none;
+}
+.game-canvas-3d[data-overlay=hidden] .game-canvas-3d__coordinates,
+.game-canvas-3d[data-overlay=hidden] .game-canvas-3d__tile-info,
+.game-canvas-3d[data-overlay=hidden]::before {
+  display: none;
+}
+.game-canvas-3d[data-orientation=rotated] {
+}
+.game-canvas-3d canvas {
+  cursor: crosshair;
+}
+.game-canvas-3d canvas:active {
+  cursor: grabbing;
+}
+@media (max-width: 768px) {
+  .game-canvas-3d__coordinates,
+  .game-canvas-3d__tile-info {
+    font-size: 10px;
+    padding: 6px 10px;
+  }
+  .game-canvas-3d::before {
+    font-size: 9px;
+    padding: 4px 8px;
+  }
+}
+.game-canvas-3d:focus {
+  outline: 2px solid #4488ff;
+  outline-offset: 2px;
+}
+.game-canvas-3d canvas {
+  transition: opacity 0.3s ease;
+}
+.game-canvas-3d__context-menu {
+  position: absolute;
+  background: rgba(0, 0, 0, 0.9);
+  border: 1px solid rgba(255, 255, 255, 0.1);
+  border-radius: 6px;
+  padding: 8px 0;
+  min-width: 150px;
+  z-index: 100;
+}
+.game-canvas-3d__context-menu-item {
+  padding: 8px 16px;
+  color: #ffffff;
+  cursor: pointer;
+  font-size: 13px;
+  transition: background 0.15s ease;
+}
+.game-canvas-3d__context-menu-item:hover {
+  background: rgba(255, 255, 255, 0.1);
+}
+.game-canvas-3d__context-menu-item--danger {
+  color: #ff6b6b;
+}
+.game-canvas-3d__context-menu-item--danger:hover {
+  background: rgba(255, 0, 0, 0.2);
+}
 .canvas-3d-loading {
   position: absolute;
   inset: 0;
@@ -1312,8 +1500,6 @@ body {
     font-size: 12px;
   }
 }
-
-/* src/lib/drawable/three/Canvas3DErrorBoundary.css */
 .canvas-3d-error {
   position: absolute;
   inset: 0;
@@ -1476,194 +1662,6 @@ body {
   }
 }
 
-/* src/lib/drawable/three/Canvas3DHost.css */
-.game-canvas-3d {
-  background: #1a1a2e;
-  border-radius: 8px;
-}
-.game-canvas-3d canvas {
-  display: block;
-  width: 100%;
-  height: 100%;
-}
-.game-canvas-3d--loading {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  background:
-    linear-gradient(
-      135deg,
-      #1a1a2e 0%,
-      #16213e 100%);
-}
-.game-canvas-3d__loading {
-  padding: 20px 40px;
-  background: rgba(255, 255, 255, 0.1);
-  border-radius: 8px;
-  color: #ffffff;
-  font-size: 16px;
-  animation: pulse 1.5s ease-in-out infinite;
-}
-.game-canvas-3d--error {
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  background:
-    linear-gradient(
-      135deg,
-      #2e1a1a 0%,
-      #3e1616 100%);
-}
-.game-canvas-3d__error {
-  padding: 20px 40px;
-  background: rgba(255, 0, 0, 0.2);
-  border: 1px solid rgba(255, 0, 0, 0.3);
-  border-radius: 8px;
-  color: #ff6b6b;
-  font-size: 14px;
-}
-.game-canvas-3d__coordinates {
-  position: absolute;
-  bottom: 20px;
-  left: 20px;
-  padding: 8px 16px;
-  background: rgba(0, 0, 0, 0.7);
-  border-radius: 4px;
-  color: #ffffff;
-  font-family: monospace;
-  font-size: 12px;
-  pointer-events: none;
-  z-index: 10;
-}
-.game-canvas-3d__tile-info {
-  position: absolute;
-  top: 20px;
-  left: 20px;
-  padding: 12px 16px;
-  background: rgba(0, 0, 0, 0.8);
-  border-radius: 6px;
-  color: #ffffff;
-  pointer-events: none;
-  z-index: 10;
-  min-width: 120px;
-}
-.tile-info__type {
-  font-weight: 600;
-  font-size: 14px;
-  text-transform: capitalize;
-  margin-bottom: 4px;
-}
-.tile-info__terrain {
-  font-size: 12px;
-  color: #aaaaaa;
-}
-@keyframes pulse {
-  0%, 100% {
-    opacity: 1;
-  }
-  50% {
-    opacity: 0.5;
-  }
-}
-.game-canvas-3d[data-camera-mode=isometric]::before {
-  content: "Isometric";
-  position: absolute;
-  top: 20px;
-  right: 20px;
-  padding: 6px 12px;
-  background: rgba(0, 0, 0, 0.6);
-  border-radius: 4px;
-  color: #ffffff;
-  font-size: 11px;
-  text-transform: uppercase;
-  letter-spacing: 1px;
-  pointer-events: none;
-}
-.game-canvas-3d[data-camera-mode=perspective]::before {
-  content: "Perspective";
-  position: absolute;
-  top: 20px;
-  right: 20px;
-  padding: 6px 12px;
-  background: rgba(0, 0, 0, 0.6);
-  border-radius: 4px;
-  color: #ffffff;
-  font-size: 11px;
-  text-transform: uppercase;
-  letter-spacing: 1px;
-  pointer-events: none;
-}
-.game-canvas-3d[data-camera-mode=top-down]::before {
-  content: "Top Down";
-  position: absolute;
-  top: 20px;
-  right: 20px;
-  padding: 6px 12px;
-  background: rgba(0, 0, 0, 0.6);
-  border-radius: 4px;
-  color: #ffffff;
-  font-size: 11px;
-  text-transform: uppercase;
-  letter-spacing: 1px;
-  pointer-events: none;
-}
-.game-canvas-3d[data-overlay=hidden] .game-canvas-3d__coordinates,
-.game-canvas-3d[data-overlay=hidden] .game-canvas-3d__tile-info,
-.game-canvas-3d[data-overlay=hidden]::before {
-  display: none;
-}
-.game-canvas-3d[data-orientation=rotated] {
-}
-.game-canvas-3d canvas {
-  cursor: crosshair;
-}
-.game-canvas-3d canvas:active {
-  cursor: grabbing;
-}
-@media (max-width: 768px) {
-  .game-canvas-3d__coordinates,
-  .game-canvas-3d__tile-info {
-    font-size: 10px;
-    padding: 6px 10px;
-  }
-  .game-canvas-3d::before {
-    font-size: 9px;
-    padding: 4px 8px;
-  }
-}
-.game-canvas-3d:focus {
-  outline: 2px solid #4488ff;
-  outline-offset: 2px;
-}
-.game-canvas-3d canvas {
-  transition: opacity 0.3s ease;
-}
-.game-canvas-3d__context-menu {
-  position: absolute;
-  background: rgba(0, 0, 0, 0.9);
-  border: 1px solid rgba(255, 255, 255, 0.1);
-  border-radius: 6px;
-  padding: 8px 0;
-  min-width: 150px;
-  z-index: 100;
-}
-.game-canvas-3d__context-menu-item {
-  padding: 8px 16px;
-  color: #ffffff;
-  cursor: pointer;
-  font-size: 13px;
-  transition: background 0.15s ease;
-}
-.game-canvas-3d__context-menu-item:hover {
-  background: rgba(255, 255, 255, 0.1);
-}
-.game-canvas-3d__context-menu-item--danger {
-  color: #ff6b6b;
-}
-.game-canvas-3d__context-menu-item--danger:hover {
-  background: rgba(255, 0, 0, 0.2);
-}
-
 /* src/components/core/organisms/debug/RuntimeDebugger.css */
 .runtime-debugger {
   font-family: