@almadar/shell-web 1.0.0 → 1.1.0

package/dist/providers/index.d.ts

@@ -5,19 +5,17 @@ import '../EventBusProvider-BFFHfN4O.js';
 import { UIThemeDefinition } from '../core.js';
 export { A as ARBITRARY_CLASS_STYLE_ID, a as ArbitraryClassCompiler, b as ArbitraryClassCompilerProvider, c as ArbitraryClassCompilerProviderProps, C as CurrentPagePathContext, d as CurrentPagePathProvider, e as CurrentPagePathProviderProps, D as DesignThemeProvider, O as OrbitalThemeProvider, f as OrbitalThemeProviderProps, U as UserContext, g as UserContextValue, h as UserData, i as UserProvider, j as UserProviderProps, r as resetArbitraryClassStyles, u as useArbitraryClassStyles, k as useCurrentPagePath, l as useDesignTheme, m as useHasPermission, n as useHasRole, o as useUser, p as useUserForEvaluation } from '../ArbitraryClassCompiler-CO_iASBn.js';
 export { h as AwaitingSkeletonContext, A as AwaitingSkeletonSource, i as EntityBindingContext, E as EntityBindingSource, a as EntitySchemaContextValue, b as EntitySchemaProvider, c as EntitySchemaProviderProps, d as ServerBridgeContextValue, e as ServerBridgeProvider, j as ServerBridgeProviderProps, S as ServerBridgeTransport, k as useAwaitingSkeleton, l as useEntityBindingSnapshot, u as useEntitySchema, f as useEntitySchemaOptional, g as useServerBridge } from '../ServerBridge-Bqsj-lOU.js';
-export { a as KernelEngineContext, b as KernelEngineProvider, c as KernelEngineProviderProps, K as KernelEngineValue, d as KernelLoaderMissingError, u as useKernelEngine } from '../KernelEngineContext-CcxGYtlr.js';
-export { b as KernelInstance, a as KernelLoader, K as KernelModule } from '../kernel-wire-wNdAPfhJ.js';
-import '../verificationRegistry-CVrcxG1s.js';
-export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-ceM_n0ey.js';
-export { A as Avl3DConfig, a as Avl3DContext, b as Avl3DModelOverrides, u as useAvl3DConfig, c as useAvl3DPalette } from '../avl-3d-context-BycmO6tG.js';
+export { a as KernelEngineContext, b as KernelEngineProvider, c as KernelEngineProviderProps, K as KernelEngineValue, d as KernelLoaderMissingError, u as useKernelEngine } from '../KernelEngineContext-CPeWQMAz.js';
+export { b as KernelInstance, a as KernelLoader, K as KernelModule } from '../kernel-wire-DGAySGhX.js';
+import '../verificationRegistry-oopV1J1n.js';
+export { G as GameAudioContext, a as GameAudioContextValue, b as GameAudioProvider, c as GameAudioProviderProps, u as useGameAudioContext, d as useGameAudioContextOptional } from '../GameAudioProvider-D7wo5ryN.js';
 export { AccessTokenProvider } from '@almadar/shell-runtime/client/EventTransport';
 import '../verification-C5pTeMJv.js';
 import '@almadar/shell-runtime/kernel/os-port';
+import '@almadar/shell-runtime/kernel/wire';
 import '@almadar/shell-browser/kv';
-import '../paintDispatch-CuJLsr9Y.js';
-import '../fx-CmQjnHmT.js';
+import '../fx-Br8zjvu9.js';
 import 'lucide-react';
-import 'three';
 
 /**
  * SelectionProvider - Manages selected entity state

package/dist/providers/index.js

@@ -1,22 +1,18 @@
 "use client";
-export { Avl3DContext, useAvl3DConfig, useAvl3DPalette } from '../chunk-EOWMARUB.js';
-export { AwaitingSkeletonContext, EntityBindingContext, EntitySchemaProvider, GameAudioContext, GameAudioProvider, KernelEngineContext, KernelEngineProvider, KernelLoaderMissingError, OrbitalProvider, PageAccessHost, RenderSlotProvider, RowSetResolverProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, VerificationProvider, mapServerEffectResults, useAwaitingSkeleton, useEntityBindingSnapshot, useEntitySchema, useEntitySchemaOptional, useGameAudioContext, useGameAudioContextOptional, useKernelEngine, useRenderSlot, useRowSetResolver, useRowSetResolverHandle, useSelection, useSelectionOptional, useServerBridge } from '../chunk-LHP2TK7O.js';
+export { AwaitingSkeletonContext, EntityBindingContext, EntitySchemaProvider, GameAudioContext, GameAudioProvider, KernelEngineContext, KernelEngineProvider, KernelLoaderMissingError, OrbitalProvider, PageAccessHost, RenderSlotProvider, RowSetResolverProvider, SelectionContext, SelectionProvider, ServerBridgeProvider, VerificationProvider, mapServerEffectResults, useAwaitingSkeleton, useEntityBindingSnapshot, useEntitySchema, useEntitySchemaOptional, useGameAudioContext, useGameAudioContextOptional, useKernelEngine, useRenderSlot, useRowSetResolver, useRowSetResolverHandle, useSelection, useSelectionOptional, useServerBridge } from '../chunk-MS4K3K2R.js';
 import '../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';
 import '../chunk-REXYVBUO.js';
 import '../chunk-AGXD77SL.js';
-import '../chunk-TXAUOLWZ.js';
-import '../chunk-AB3X7QTE.js';
-import '../chunk-DZBQA2OW.js';
-import '../chunk-TUPZWTRE.js';
-import '../chunk-TZZBINQY.js';
-import '../chunk-4T3P43NS.js';
+import '../chunk-M74BCDBQ.js';
 import '../chunk-PCR37T3U.js';
-import '../chunk-UXLE3IPR.js';
-import '../chunk-ILZ7ORX7.js';
-import '../chunk-3VZ36ZKO.js';
+import '../chunk-PRLHKBXG.js';
+import '../chunk-FAKU5F62.js';
+import '../chunk-2WGR4TDJ.js';
+import '../chunk-TZZBINQY.js';
+import '../chunk-ZDRDJKYB.js';
 export { EditorFocusProvider, useEditorFocus } from '../chunk-PRXQGGCO.js';
 import '../chunk-VO2TTLS5.js';
 export { DesignThemeProvider, useDesignTheme } from '../chunk-UTDC2NEA.js';

package/dist/runtime/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:

package/dist/runtime/index.d.ts

@@ -14,6 +14,7 @@ import { HostSignInRequest, HostSignInAnswer, HostConsentRequest, HostConsentAns
 import React__default from 'react';
 import { SchemaLoader } from '@almadar/shell-runtime';
 import { KernelLoader } from '../providers/index.js';
+import { KernelCanvas3DFactory, KernelSceneCanvasFactory } from '@almadar/shell-runtime/kernel/wire';
 export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-CPzrxLo9.js';
 export { p as profilerOnRender, u as usePerfBuffer } from '../perf-CKiBKbkw.js';
 import '../useUISlots-CiobNFGb.js';
@@ -144,6 +145,10 @@ interface OrbPreviewProps {
      * preview runs under whatever engine the host's own `KernelEngineProvider` selects.
      */
     kernelLoader?: KernelLoader;
+    /** With `kernelLoader`: makes the 3D view a `canvas` mode:"3d" draws on (`(canvas) => Canvas3D.create(canvas)`). */
+    canvas3d?: KernelCanvas3DFactory;
+    /** With `kernelLoader`: makes the scene canvas the learning and 2D canvases draw on (`(canvas) => SceneCanvas.create(canvas)`). */
+    sceneCanvas?: KernelSceneCanvasFactory;
     /**
      * How long (ms) to wait for the server bridge to connect before assuming
      * it's unreachable and falling back to local-only execution. Default
@@ -230,7 +235,7 @@ interface OrbPreviewProps {
     /** Answers `auth/consent` in place of the popup the web host opens: the shell's own authorize window. */
     onConsentAsk?: (request: HostConsentRequest) => Promise<HostConsentAnswer>;
 }
-declare function OrbPreview({ schema, mockData, height, frame, className, serverUrl, transport, getAccessToken, kernelLoader, initialPagePath, isolated, fit, onPageChange, authority, localFallbackTimeoutMs, themeOverride, paused, lazyLoader, schemaPath, onUnmatchedNavigate, onSignIn, onSignOut, onSignInAsk, onConsentAsk, }: OrbPreviewProps): React__default.ReactElement;
+declare function OrbPreview({ schema, mockData, height, frame, className, serverUrl, transport, getAccessToken, kernelLoader, canvas3d, sceneCanvas, initialPagePath, isolated, fit, onPageChange, authority, localFallbackTimeoutMs, themeOverride, paused, lazyLoader, schemaPath, onUnmatchedNavigate, onSignIn, onSignOut, onSignInAsk, onConsentAsk, }: OrbPreviewProps): React__default.ReactElement;
 declare namespace OrbPreview {
     var displayName: string;
 }

package/dist/runtime/index.js

@@ -1,22 +1,19 @@
 "use client";
 export { assertUniqueSlotsPerHost } from '../chunk-5QTYQTPS.js';
-export { EntitySchemaProvider, OrbPreview, ServerBridgeProvider, useEntitySchema, useEntitySchemaOptional, useServerBridge, useTraitStateMachine } from '../chunk-LHP2TK7O.js';
+export { EntitySchemaProvider, OrbPreview, ServerBridgeProvider, useEntitySchema, useEntitySchemaOptional, useServerBridge, useTraitStateMachine } from '../chunk-MS4K3K2R.js';
 import '../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';
 import '../chunk-REXYVBUO.js';
 import '../chunk-AGXD77SL.js';
-import '../chunk-TXAUOLWZ.js';
-import '../chunk-AB3X7QTE.js';
-import '../chunk-DZBQA2OW.js';
-export { profilerOnRender, usePerfBuffer } from '../chunk-TUPZWTRE.js';
-import '../chunk-TZZBINQY.js';
-import '../chunk-4T3P43NS.js';
+import '../chunk-M74BCDBQ.js';
 import '../chunk-PCR37T3U.js';
-import '../chunk-UXLE3IPR.js';
-import '../chunk-ILZ7ORX7.js';
-export { PERF_NAMESPACE, clearPerf, perfEnd, perfStart, perfTime, wrapCallbackForEvent } from '../chunk-3VZ36ZKO.js';
+import '../chunk-PRLHKBXG.js';
+import '../chunk-FAKU5F62.js';
+export { profilerOnRender, usePerfBuffer } from '../chunk-2WGR4TDJ.js';
+import '../chunk-TZZBINQY.js';
+export { PERF_NAMESPACE, clearPerf, perfEnd, perfStart, perfTime, wrapCallbackForEvent } from '../chunk-ZDRDJKYB.js';
 import '../chunk-PRXQGGCO.js';
 import '../chunk-VO2TTLS5.js';
 import '../chunk-AE7VCQB6.js';

package/dist/test-support.js

@@ -1,5 +1,5 @@
 "use client";
-import { openLocalKernel, nativeMemoryPersistence } from './chunk-3VZ36ZKO.js';
+import { openLocalKernel, nativeMemoryPersistence } from './chunk-ZDRDJKYB.js';
 import './chunk-G7DCAZ22.js';
 import { existsSync, readFileSync, mkdtempSync, writeFileSync, mkdirSync, rmSync } from 'fs';
 import { createRequire } from 'module';
@@ -107,7 +107,7 @@ async function loadFreshClientKernel() {
 async function warmKernel() {
   if (!KERNEL_AVAILABLE) return;
   await KERNEL_ENGINE.loadModule();
-  await import('./kernel-client-TZKGHJRY.js');
+  await import('./kernel-client-JW6OH5FX.js');
 }
 function statelessKernelTransport(schema) {
   let template;