@almadar/shell-web 0.1.0 → 1.1.0

package/dist/storage/browser/index.js

@@ -1 +1,2 @@
+"use client";
 export * from '@almadar/shell-browser/storage';

package/dist/test-support.d.ts

@@ -1,10 +1,12 @@
 import { KernelServerClass, KernelModule } from '@almadar/shell-runtime/kernel/wire';
-import { OrbitalSchema, UserContext } from '@almadar/core';
+import { OrbitalSchema } from '@almadar/core';
 import { KernelEngineValue } from './providers/index.js';
 import { KernelModule as KernelModule$1 } from './providers/index.js';
-import { EventTransport } from '@almadar/shell-runtime/client/EventTransport';
-import './verification-C5pTeMJv.js';
+import { EventTransport } from '@almadar/shell-runtime';
 import 'react';
+import '@almadar/shell-runtime/kernel/os-port';
+import '@almadar/shell-browser/kv';
+import './verification-C5pTeMJv.js';
 
 /**
  * A whole `KernelModule` around a scripted `Server`, for tests that drive the engine without the wasm. Every member a
@@ -13,15 +15,17 @@ import 'react';
 declare function stubKernelModule(Server: KernelServerClass, overrides?: Partial<Omit<KernelModule, 'Server'>>): KernelModule;
 
 declare const KERNEL_AVAILABLE: boolean;
+/** The type-contract stamp every test program carries, typed from core's `OrbitalSchema` so a version bump there fails here. */
+declare const TEST_TYPE_CONTRACT_VERSION: NonNullable<OrbitalSchema['typeContractVersion']>;
+/** The stamp option a hook under test hands the kernel: the same version, as a program's stamp. */
+declare const TEST_STAMP: Pick<OrbitalSchema, 'typeContractVersion'>;
 /** The installed language as the bundle a browser host hands a kernel it opens over a local store. */
 declare const TEST_LANGUAGE: string;
 /** The shared kernel module, loaded once, with the render evaluator installed from it. */
 declare function loadTestKernel(): Promise<KernelModule$1>;
-/** The std mock-seed program as `orb` resolves it from the installed packages, the way a Node host does. */
-declare function loadTestSeedProgram(): Promise<OrbitalSchema>;
 declare const KERNEL_ENGINE: KernelEngineValue;
 declare const ENGINES: ReadonlyArray<readonly [string, KernelEngineValue]>;
-/** A client-build kernel instance of its own, as a browser loads it: nothing has installed language data into it. */
+/** A client-build kernel instance of its own, as a browser loads it: initialised, with the language installed once, as the browser kernel loader does. */
 declare function loadFreshClientKernel(): Promise<KernelModule$1>;
 /** Load the WebAssembly and the adapter chunk before a timing-sensitive test: the first dispatch otherwise waits on both. */
 declare function warmKernel(): Promise<void>;
@@ -30,6 +34,9 @@ declare function warmKernel(): Promise<void>;
  * The hosted playground's stateless topology: the program is registered once, and every request runs on a fresh
  * session of it (`KernelEngine.fork`) over the kernel's own memory store, the client carrying the circuit state on the leg.
  */
-declare function statelessKernelTransport(schema: OrbitalSchema, user?: () => Promise<UserContext | undefined>): EventTransport;
+declare function statelessKernelTransport(schema: OrbitalSchema): EventTransport;
+
+/** A `.lolo` program (with any files beside it, such as `locales/en/<app>.json`) as the installed `orb` compiles it for a browser kernel: the stamp, `_metadata.protocols` and dispatch facts included. */
+declare function clientProgram(source: string, files?: Readonly<Record<string, string>>): OrbitalSchema;
 
-export { ENGINES, KERNEL_AVAILABLE, KERNEL_ENGINE, TEST_LANGUAGE, loadFreshClientKernel, loadTestKernel, loadTestSeedProgram, statelessKernelTransport, stubKernelModule, warmKernel };
+export { ENGINES, KERNEL_AVAILABLE, KERNEL_ENGINE, TEST_LANGUAGE, TEST_STAMP, TEST_TYPE_CONTRACT_VERSION, clientProgram, loadFreshClientKernel, loadTestKernel, statelessKernelTransport, stubKernelModule, warmKernel };

package/dist/test-support.js

@@ -1,13 +1,16 @@
-import { createInProcessTransport, src_exports } from './chunk-6P3MWXYE.js';
-import { openLocalKernel, nativeMemoryPersistence } from './chunk-DYEKAA4L.js';
+"use client";
+import { openLocalKernel, nativeMemoryPersistence } from './chunk-ZDRDJKYB.js';
 import './chunk-G7DCAZ22.js';
-import { execFileSync } from 'child_process';
-import { existsSync, readFileSync } from 'fs';
+import { existsSync, readFileSync, mkdtempSync, writeFileSync, mkdirSync, rmSync } from 'fs';
 import { createRequire } from 'module';
-import { join } from 'path';
+import { join, dirname } from 'path';
 import { pathToFileURL } from 'url';
-import { OrbitalSchemaSchema, installKernelEvaluator } from '@almadar/core';
+import { installKernelEvaluator, parseOrbitalSchema } from '@almadar/core';
+import { installNativeLanguages } from '@almadar/syntax';
 import { readLanguageBundle } from '@almadar/core/language-data';
+import { createInProcessTransport, evaluateOnKernel } from '@almadar/shell-runtime';
+import { execFileSync } from 'child_process';
+import { tmpdir } from 'os';
 
 // src/test-support/stub-kernel-module.ts
 function stubKernelModule(Server, overrides = {}) {
@@ -19,10 +22,12 @@ function stubKernelModule(Server, overrides = {}) {
     osGlobMatches: () => false,
     isPublicAddress: () => false,
     osDeferringOps: () => "[]",
+    contractQueryWithoutProgram: () => "null",
     osStreamOps: () => "[]",
     osCompletionEvent: () => "null",
     substrateCompletionEvent: () => "null",
     tabUrlMatches: () => false,
+    parseEventRequest: unexpected("parseEventRequest"),
     installLanguage: unexpected("installLanguage"),
     evaluateMany: unexpected("evaluateMany"),
     resolveValues: unexpected("resolveValues"),
@@ -33,6 +38,19 @@ function stubKernelModule(Server, overrides = {}) {
     scopeRows: unexpected("scopeRows"),
     checkMutationAccess: unexpected("checkMutationAccess"),
     resolveRowBinding: unexpected("resolveRowBinding"),
+    eventWires: unexpected("eventWires"),
+    validatePacks: unexpected("validatePacks"),
+    expandFxLayer: unexpected("expandFxLayer"),
+    resolveFxView: unexpected("resolveFxView"),
+    fxLifecycle: unexpected("fxLifecycle"),
+    fxHash01: unexpected("fxHash01"),
+    skinWorldMatrices: unexpected("skinWorldMatrices"),
+    skinVertices: unexpected("skinVertices"),
+    skinComposeAffine: unexpected("skinComposeAffine"),
+    skinInvertAffine: unexpected("skinInvertAffine"),
+    skinApplyAffine: unexpected("skinApplyAffine"),
+    skinTriangleAffine: unexpected("skinTriangleAffine"),
+    skinVertexBounds: unexpected("skinVertexBounds"),
     ...overrides
   };
 }
@@ -61,22 +79,17 @@ async function load() {
   glue.initSync({ module: readFileSync(files.wasm) });
   glue.installLanguage(TEST_LANGUAGE);
   installKernelEvaluator(glue);
+  installNativeLanguages();
   return glue;
 }
+var TEST_TYPE_CONTRACT_VERSION = 1;
+var TEST_STAMP = { typeContractVersion: TEST_TYPE_CONTRACT_VERSION };
 var TEST_LANGUAGE = JSON.stringify(readLanguageBundle(process.cwd()));
 var shared;
 function loadTestKernel() {
   return shared ??= load();
 }
-var WHICH_LINE = /^(\/\S+\.(?:orb|lolo)) \((.+)\)$/;
-function loadTestSeedProgram() {
-  const run = (args) => execFileSync("orb", [...args], { cwd: process.cwd(), encoding: "utf8", maxBuffer: 512 * 1024 * 1024 });
-  const which = run(["behaviors", "which", "std/behaviors/std-mock-seed"]).trim().split("\n").pop() ?? "";
-  const match = WHICH_LINE.exec(which);
-  if (match === null) return Promise.reject(new Error(`std/behaviors/std-mock-seed is not installed: ${which}`));
-  return Promise.resolve(OrbitalSchemaSchema.parse(JSON.parse(run(["resolve", match[1]]))));
-}
-var KERNEL_ENGINE = { loadModule: () => loadTestKernel(), loadLanguage: () => Promise.resolve(TEST_LANGUAGE), loadSeedProgram: loadTestSeedProgram };
+var KERNEL_ENGINE = { loadModule: () => loadTestKernel() };
 var ENGINES = KERNEL_AVAILABLE ? [["kernel", KERNEL_ENGINE]] : [];
 async function loadFreshClientKernel() {
   const dir = process.env.ALMADAR_KERNEL_DIR;
@@ -86,29 +99,83 @@ async function loadFreshClientKernel() {
     `${pathToFileURL(files.glue).href}?fresh=${Math.random()}`
   );
   glue.initSync({ module: readFileSync(files.wasm) });
+  glue.installLanguage(TEST_LANGUAGE);
   installKernelEvaluator(glue);
+  installNativeLanguages();
   return glue;
 }
 async function warmKernel() {
   if (!KERNEL_AVAILABLE) return;
   await KERNEL_ENGINE.loadModule();
-  await import('./kernel-client-ZH4PSMCN.js');
+  await import('./kernel-client-JW6OH5FX.js');
 }
-
-// src/test-support/stateless-kernel.ts
-function statelessKernelTransport(schema, user = async () => void 0) {
+function statelessKernelTransport(schema) {
   let template;
   return createInProcessTransport(async (orbital, request) => {
-    const viewer = await user();
-    template ??= loadTestKernel().then((kernel) => openLocalKernel({ kernel, language: TEST_LANGUAGE, schema, persistence: nativeMemoryPersistence(kernel) }));
+    template ??= loadTestKernel().then((kernel) => openLocalKernel({ kernel, schema, persistence: nativeMemoryPersistence(kernel) }));
     const engine = (await template).fork();
     try {
-      engine.seedRuntimeMock(viewer?.id);
-      return await (0, src_exports.evaluateOnKernel)({ engine, orbital }, request, viewer, request.locale);
+      return await evaluateOnKernel({ engine, orbital }, request, request.locale);
     } finally {
       engine.dispose();
     }
   }, { carriesCircuitState: true });
 }
+var lowered = /* @__PURE__ */ new Map();
+var lockDir = join(tmpdir(), "almadar-client-program.lock");
+function holderAlive() {
+  try {
+    process.kill(Number(readFileSync(join(lockDir, "pid"), "utf8")), 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function compileExclusively(compile) {
+  const wait = new Int32Array(new SharedArrayBuffer(4));
+  for (; ; ) {
+    try {
+      mkdirSync(lockDir);
+      writeFileSync(join(lockDir, "pid"), String(process.pid));
+      break;
+    } catch (error) {
+      if (!(error instanceof Error) || !("code" in error) || error.code !== "EEXIST") throw error;
+      if (!holderAlive()) rmSync(lockDir, { recursive: true, force: true });
+      Atomics.wait(wait, 0, 0, 25);
+    }
+  }
+  try {
+    return compile();
+  } finally {
+    rmSync(lockDir, { recursive: true, force: true });
+  }
+}
+function clientProgram(source, files = {}) {
+  const bin = process.env.ORB_BIN;
+  if (bin === void 0 || bin === "") throw new Error("clientProgram: set ORB_BIN to the installed orb binary that lowers the test programs");
+  const key = JSON.stringify([source, files]);
+  const known = lowered.get(key);
+  if (known !== void 0) return structuredClone(known);
+  const dir = mkdtempSync(join(tmpdir(), "client-program-"));
+  try {
+    const file = join(dir, "program.lolo");
+    writeFileSync(file, source);
+    const served = join(dir, "out/packages/client/public");
+    for (const [path, text] of Object.entries(files)) {
+      for (const target of [join(dir, path), join(served, path)]) {
+        mkdirSync(dirname(target), { recursive: true });
+        writeFileSync(target, text);
+      }
+    }
+    const schema = compileExclusively(() => {
+      execFileSync(bin, ["compile", file, "-o", join(dir, "out"), "--mode", "client"], { cwd: dir, stdio: "pipe" });
+      return parseOrbitalSchema(JSON.parse(readFileSync(join(served, "program.client.orb"), "utf8")));
+    });
+    lowered.set(key, schema);
+    return structuredClone(schema);
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+}
 
-export { ENGINES, KERNEL_AVAILABLE, KERNEL_ENGINE, TEST_LANGUAGE, loadFreshClientKernel, loadTestKernel, loadTestSeedProgram, statelessKernelTransport, stubKernelModule, warmKernel };
+export { ENGINES, KERNEL_AVAILABLE, KERNEL_ENGINE, TEST_LANGUAGE, TEST_STAMP, TEST_TYPE_CONTRACT_VERSION, clientProgram, loadFreshClientKernel, loadTestKernel, statelessKernelTransport, stubKernelModule, warmKernel };

package/dist/{paintDispatch-ChW5mVuK.d.ts → verificationRegistry-oopV1J1n.d.ts}

@@ -1,7 +1,9 @@
 import React__default from 'react';
-import { ScenePos, Asset } from '@almadar/core';
-import { P as Point, R as Rect, F as FxItem, a as FxPreset } from './fx-CmQjnHmT.js';
-import './EventBusProvider-CVwjkV_2.js';
+import { ScenePos, Asset, OrbitalVerificationAPI, TraitStateSnapshot, EventPayload, BusEvent, VerificationCheck, BridgeHealth, VerificationSnapshot, VerificationSummary, TransitionTrace, EventRequest, EventResponse, ServerResponseTrace, EffectTrace, CheckStatus, ServerEffectResult, AssetLoadStatus } from '@almadar/core';
+import { P as Point, R as Rect, F as FxItem, a as FxPreset } from './fx-Br8zjvu9.js';
+import './EventBusProvider-BFFHfN4O.js';
+import { EventTransport } from '@almadar/shell-runtime/client/EventTransport';
+import './verification-C5pTeMJv.js';
 
 /** A polyline/polygon vertex in pixel space. */
 interface PainterPoint {
@@ -77,8 +79,7 @@ interface DrawableBase {
  * `draw-shape` — the neutral vector-fill/stroke drawable atom (dimension-agnostic).
  *
  * ONE descriptor (`DrawShapeProps`, grounded in core `ScenePos`) with TWO
- * backends: `paintShape` (2D, here) and an R3F ground-plane mesh (`Shape3D` in
- * `lib/drawable/mesh3d`, kept OUT of this file so the 2D path never pulls R3F).
+ * backends: `paintShape` (2D, here) and a ground-plane mesh in orbital-canvas's 3D scene.
  * Paints a cell footprint, an axis-aligned rect, an ellipse, a poly, or an SVG
  * path at a scene position, fill and/or stroke. Genre uses (tile fallback, iso/hex
  * diamond fallback, cell highlight, feature disc, unit selection ring, unit
@@ -229,9 +230,7 @@ declare function DrawShape(props: DrawShapeProps): React__default.JSX.Element |
  *
  * ONE descriptor (`DrawSpriteProps`, grounded in core `ScenePos` + `Asset`) with
  * TWO backends: `paintSprite` (2D, here — via the portable `Painter2D` seam) and
- * an R3F mesh (`Sprite3D` in `lib/drawable/mesh3d`, kept OUT of this file so the
- * 2D paint path never pulls `three`/`drei` into an app bundle — the codebase
- * code-splits R3F). The canvas host picks the backend by `mode`; that is what
+ * orbital-canvas's 3D scene (the `canvas` mode:"3d" mapper). The canvas host picks the backend by `mode`; that is what
  * makes canvas-2d and canvas-3d the same `children` interface. Genre uses (tile,
  * unit body, feature, effect, movement ghost, background cover) are all this atom
  * with different `anchor`/`size`/`frame`/`flip`/`shadow` — composed in `.lolo`,
@@ -276,8 +275,7 @@ declare function DrawSprite(_props: DrawSpriteProps): React__default.JSX.Element
  * `draw-text` — the neutral text drawable atom (dimension-agnostic).
  *
  * ONE descriptor (`DrawTextProps`, grounded in core `ScenePos`) with TWO backends:
- * `paintText` (2D, here) and an R3F billboarded `<Text>` (`Text3D` in
- * `lib/drawable/mesh3d`, kept OUT of this file so the 2D path never pulls R3F).
+ * `paintText` (2D, here) and billboarded text in orbital-canvas's 3D scene.
  * Paints a string at a scene position with font/color/alignment. The React
  * component renders `null` (a drawable is painted by the host, not the DOM).
  */
@@ -312,9 +310,8 @@ declare function DrawText(_props: DrawTextProps): React__default.JSX.Element | n
 /**
  * `draw-mesh` — the volumetric 3D drawable atom (3D-canvas backend).
  *
- * ONE descriptor (`DrawMeshProps`, grounded in core `ScenePos`) with the R3F
- * backend `Mesh3D` in `lib/drawable/three/DrawMesh3D` (kept OUT of this file so
- * the 2D path never pulls three). A parametric primitive (box, sphere, capsule,
+ * ONE descriptor (`DrawMeshProps`, grounded in core `ScenePos`) drawn by
+ * orbital-canvas's 3D scene. A parametric primitive (box, sphere, capsule,
  * cylinder, cone, torus, plane, circle — `plane`/`circle` lie flat in the
  * scene ground plane facing up, matching the 2D painter) or a raw-geometry `polyhedron`
  * (`vertices` + `faces` as plain data) at a scene position — `position.z` is
@@ -646,27 +643,17 @@ declare function DrawTextLayer(_props: DrawTextLayerProps): React__default.JSX.E
 /**
  * `draw-fx-layer` — the batched transient-effects pass in one descriptor.
  *
- * Collapses the fx triple every board used to hand-roll (message text layer +
- * sprite fallback layer + vector-art group per fx entry) into ONE node:
- * `{ type: draw-fx-layer, items: @entity.fx, presets: @config.fxPresets, … }`.
- * NAME-BLIND: each item's look comes from its resolved typed fields via the
- * consumer-declared `FxPreset[]` table — never a kind→look table in here.
- * Render priority per item: vector `art[type].idle` (draw-group) → sprite
- * `sprites[type]` (draw-sprite) → a procedural seeded recipe
- * (spark/ring/puff/streak draw-shapes); a `message` always adds a rising,
- * fading draw-text. Expansion is PURE (descriptors → descriptors, routed
- * through the normal paint dispatch); per-frame smoothness comes from the host
- * paint clock against each item's `bornAt`, while the fx mechanic's ttl decay
- * stays the authoritative removal clock. `space: "screen"` entries are skipped
- * — the `fx-overlay` core molecule owns those. The React component renders
- * `null` (a drawable is painted by the host, not the DOM).
+ * The descriptor and its paint clock go to the shared Rust projector through
+ * the installed kernel WASM module. `std-fx-particles` owns ttl and removal;
+ * the projector derives world-space art, sprites, shapes, and messages. The
+ * React component renders `null` because its canvas host paints the result.
  */
 
 interface DrawFxLayerProps extends DrawableBase {
     type: 'draw-fx-layer';
     /** The live fx entries — the mechanic's `@entity.fx` list passed whole; `space: "screen"` entries are skipped (the overlay owns those). */
     items: FxItem[];
-    /** Consumer-declared effect vocabulary — one row per fx `type` (look + recipe). Unknown types fall back to a neutral spark burst. */
+    /** Consumer-declared effect vocabulary — one row per fx `type` (look, recipe and motion). An item whose `type` has no row draws only from its own fields, and a missing required field is a typed error. */
     presets?: FxPreset[];
     /** Vector art per fx type (an asset-art map: type → anim-state → drawables); a type's `idle` state wins over sprites/procedural. */
     art?: Record<string, Record<string, DrawableNode[]>>;
@@ -694,5 +681,120 @@ declare function DrawFxLayer(_props: DrawFxLayerProps): React__default.JSX.Eleme
 /** Every drawable descriptor. The host's `children` are a `DrawableNode[]`. */
 type DrawableNode = DrawSpriteProps | DrawShapeProps | DrawTextProps | DrawGroupProps | DrawMeshProps | DrawSkinnedMeshProps | DrawSpriteLayerProps | DrawShapeLayerProps | DrawTextLayerProps | DrawFxLayerProps;
 
-export { DrawFxLayer as e, DrawGroup as f, DrawMesh as g, DrawShape as h, DrawShapeLayer as i, DrawSkinnedMesh as j, DrawSprite as k, DrawSpriteLayer as l, DrawText as m, DrawTextLayer as n };
-export type { DrawableNode as D, MeshShapeKind as M, Projector as P, MeshMaterial as a, DrawGroupProps as b, DrawTextProps as c, DrawMeshProps as d };
+/**
+ * Verification Registry - Tracks runtime verification checks and transition traces
+ *
+ * Provides:
+ * 1. A checklist of pass/fail checks (INIT has fetch, bridge connected, etc.)
+ * 2. A full transition timeline with effect execution results
+ * 3. ServerBridge health snapshot
+ * 4. window.__orbitalVerification for Playwright/automation
+ *
+ * @packageDocumentation
+ */
+
+type ChangeListener = () => void;
+/**
+ * Per-trait snapshot getter. Each generated trait logic hook (or
+ * `useTraitStateMachine` trait binding) registers one on mount so the
+ * verifier can read the live reducer state for that trait.
+ */
+type TraitSnapshotGetter = () => TraitStateSnapshot;
+declare function registerCheck(id: string, label: string, status?: CheckStatus, details?: string): void;
+declare function updateCheck(id: string, status: CheckStatus, details?: string): void;
+declare function getAllChecks(): VerificationCheck[];
+declare function recordTransition(trace: Omit<TransitionTrace, "id">): void;
+declare function getTransitions(): TransitionTrace[];
+declare function getTransitionsForTrait(traitName: string): TransitionTrace[];
+/**
+ * Record a server response as a timeline entry.
+ * Creates a synthetic transition entry with type "server-response" to show
+ * what the server returned (clientEffects, data counts, emitted events).
+ *
+ * `effectResults` — the server's persist/set/call-service outcomes, already
+ * mapped to `EffectTrace` by the caller — populate `entry.effects` so a
+ * denied or failed persist is visible on this synthetic entry too. Before
+ * this it was always `[]`: the ONLY entry the driver's per-event
+ * `server:<orbital>` lookup (`default-snapshot.ts`'s `lastEffectResultsFor`)
+ * can find carried nothing.
+ */
+declare function recordServerResponse(orbitalName: string, event: string, response: Omit<ServerResponseTrace, "orbitalName" | "timestamp"> & {
+    effectResults?: EffectTrace[];
+}): void;
+/** A server response's `effectResults` as timeline traces, carrying each persist's real outcome (entity, action, resulting id, denied). */
+declare function serverEffectTraces(results: readonly ServerEffectResult[] | undefined): EffectTrace[];
+/** Record one answered server leg on the timeline as a `server:<orbital>` trace. */
+declare function recordOrbitalResponse(orbitalName: string, request: EventRequest, response: EventResponse): void;
+/** `transport` with every answered post recorded on the verification timeline; the one place the circuit client's server responses are captured. */
+declare function recordingTransport(transport: EventTransport): EventTransport;
+declare function updateBridgeHealth(health: BridgeHealth): void;
+declare function getBridgeHealth(): BridgeHealth | null;
+declare function getSummary(): VerificationSummary;
+declare function getSnapshot(): VerificationSnapshot;
+/**
+ * Per-trait snapshot for the verifier.
+ *
+ * Iterates every registered trait getter and collects the live reducer
+ * state. Empty until at least one trait hook calls `registerTraitSnapshot`.
+ * A getter that throws is logged and skipped — one broken trait must not
+ * poison the rest of the snapshot.
+ */
+declare function getTraitSnapshots(): TraitStateSnapshot[];
+declare function subscribeToVerification(listener: ChangeListener): () => void;
+declare global {
+    interface Window {
+        __orbitalVerification?: OrbitalVerificationAPI;
+    }
+}
+/** Whether a verifier is driving this page: the `__ALMADAR_VERIFY__` window flag it sets before the bundle runs. */
+declare function verifierAttached(): boolean;
+/**
+ * Wait for a transition matching the given event to appear.
+ * Returns the trace or null on timeout.
+ */
+declare function waitForTransition(event: string, timeoutMs?: number): Promise<TransitionTrace | null>;
+/**
+ * Bind the EventBus so automation can send events and log emissions.
+ * Call this during app initialization.
+ */
+declare function bindEventBus(eventBus: {
+    emit: (type: string, payload?: EventPayload) => void;
+    onAny?: (listener: (event: BusEvent) => void) => () => void;
+}): void;
+declare function bindConfigApplier(applyConfig: NonNullable<OrbitalVerificationAPI['applyConfig']>): () => void;
+/**
+ * Bind a trait state getter so automation can query current states.
+ */
+declare function bindTraitStateGetter(getter: (traitName: string) => string | undefined): void;
+/**
+ * Register a per-trait snapshot provider. The generated trait logic hook
+ * (or `useTraitStateMachine`) calls this once on mount, passing a getter
+ * that reads the current reducer state via a ref. Returns an unregister
+ * function for cleanup on unmount.
+ *
+ * Calling this twice for the same `traitName` replaces the previous
+ * getter (e.g. page navigation remounts the trait; the new registration
+ * wins).
+ */
+declare function registerTraitSnapshot(traitName: string, getter: TraitSnapshotGetter): () => void;
+/**
+ * Register a canvas frame capture function.
+ * Called by game organisms (IsometricCanvas, PlatformerCanvas)
+ * so the verifier can snapshot canvas content at checkpoints.
+ */
+declare function bindCanvasCapture(captureFn: () => string | null): void;
+/**
+ * Bind a reader for the last drawables list received by a canvas host.
+ * Lets verification scripts inspect exactly which neutral descriptors reached
+ * the painter without re-deriving them from state.
+ */
+declare function bindLastDrawables(getDrawables: () => DrawableNode[] | null): void;
+/**
+ * Update asset load status for canvas verification.
+ * Game organisms call this when images load or fail.
+ */
+declare function updateAssetStatus(url: string, status: AssetLoadStatus): void;
+declare function clearVerification(): void;
+
+export { DrawFxLayer as A, DrawGroup as B, DrawMesh as C, DrawShape as E, DrawShapeLayer as F, DrawSkinnedMesh as G, DrawSprite as H, DrawSpriteLayer as I, DrawText as J, DrawTextLayer as K, bindConfigApplier as a, bindCanvasCapture as b, bindEventBus as c, bindLastDrawables as d, bindTraitStateGetter as e, clearVerification as f, getAllChecks as g, getBridgeHealth as h, getSnapshot as i, getSummary as j, getTraitSnapshots as k, getTransitions as l, getTransitionsForTrait as m, recordServerResponse as n, recordTransition as o, recordingTransport as p, registerCheck as q, recordOrbitalResponse as r, registerTraitSnapshot as s, serverEffectTraces as t, subscribeToVerification as u, updateAssetStatus as v, updateBridgeHealth as w, updateCheck as x, verifierAttached as y, waitForTransition as z };
+export type { DrawableNode as D, MeshShapeKind as M, Projector as P, TraitSnapshotGetter as T };

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@almadar/shell-web",
-  "version": "0.1.0",
+  "version": "1.1.0",
+  "orbRelease": {
+    "severity": "normal"
+  },
   "description": "Almadar TS shell web renderer pack: the browser host ports of the kernel (transports, stores, client kernel, http/oauth/os ports) and the React render substrate (components, hooks, providers, preview runtime, themes, Tailwind preset) the generated web app and the TS host program import.",
   "license": "BUSL-1.1",
   "type": "module",
@@ -61,11 +64,6 @@
       "import": "./dist/lib/index.js",
       "default": "./dist/lib/index.js"
     },
-    "./three": {
-      "types": "./dist/three/index.d.ts",
-      "import": "./dist/three/index.js",
-      "default": "./dist/three/index.js"
-    },
     "./avl": {
       "types": "./dist/avl/index.d.ts",
       "import": "./dist/avl/index.js",
@@ -115,6 +113,7 @@
     "dist",
     "src/core/locales",
     "src/core/tokens/native-tokens.json",
+    "src/core/lib/band-shapes.json",
     "themes",
     "index.css",
     "tailwind-preset.cjs",
@@ -130,11 +129,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.129.0",
-    "@almadar/kernel": "^18.0.0",
-    "@almadar/logger": "^1.18.0",
-    "@almadar/std": "^16.255.0",
-    "@almadar/syntax": "^1.21.0",
+    "@almadar/core": "^11.3.0",
+    "@almadar/kernel": "^19.0.1",
+    "@almadar/logger": "^2.3.0",
+    "@almadar/std": "^17.1.0",
+    "@almadar/syntax": "^2.1.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -162,14 +161,11 @@
     "remark-math": "^6.0.0",
     "tailwind-merge": "^2.2.0",
     "zod": "^4.6.7",
-    "@almadar/shell-browser": "^0.1.0",
-    "@almadar/shell-runtime": "^0.1.0"
+    "@almadar/shell-browser": "^1.1.0",
+    "@almadar/shell-runtime": "^1.1.0"
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": "^2.22.0",
-    "@react-three/drei": "^10.7.7",
-    "@react-three/fiber": "^9.6.0",
-    "@react-three/postprocessing": "3.0.4",
+    "@almadar/eslint-plugin": "^3.0.0",
     "@tanstack/react-query": "^5.0.0",
     "@testing-library/jest-dom": "^6.4.0",
     "@testing-library/react": "^14.2.0",
@@ -180,7 +176,6 @@
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@types/react-syntax-highlighter": "^15.5.0",
-    "@types/three": "^0.160.0",
     "@typescript-eslint/parser": "8.65.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@vitejs/plugin-react": "^4.2.0",
@@ -194,14 +189,11 @@
     "jsdom": "^24.0.0",
     "katex": "^0.16.0",
     "postcss": "^8.4.35",
-    "postprocessing": "6.39.0",
     "react": "^19.0.0",
     "react-compiler-runtime": "19.0.0-beta-af1b7da-20250417",
     "react-dom": "^19.0.0",
     "react-router-dom": "^7.18.2",
     "tailwindcss": "^3.4.0",
-    "three": "^0.160.1",
-    "three-stdlib": "^2.35.6",
     "tsup": "^9.0.0",
     "tsx": "^4.7.0",
     "turbo": "^2.8.17",
@@ -219,30 +211,14 @@
     "node": ">=22.19.0"
   },
   "peerDependencies": {
-    "@react-three/drei": "^10.7.7",
-    "@react-three/fiber": "^9.0.0",
-    "@react-three/postprocessing": "^3.0.0",
     "@tanstack/react-query": "^5.0.0",
     "postcss": "^8.4.35",
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
     "react-router-dom": "^7.0.0",
-    "tailwindcss": "^3.4.0",
-    "three": "^0.160.0"
+    "tailwindcss": "^3.4.0"
   },
   "peerDependenciesMeta": {
-    "@react-three/drei": {
-      "optional": true
-    },
-    "@react-three/fiber": {
-      "optional": true
-    },
-    "@react-three/postprocessing": {
-      "optional": true
-    },
-    "three": {
-      "optional": true
-    },
     "postcss": {
       "optional": true
     },

package/src/core/lib/band-shapes.json

@@ -0,0 +1,7 @@
+{
+  "wave": "M0 60 C240 100 480 100 720 60 C960 20 1200 20 1440 60 V100 H0 Z",
+  "arc": "M0 100 Q720 0 1440 100 Z",
+  "tilt": "M0 100 L1440 0 V100 Z",
+  "step": "M0 100 V75 H360 V50 H720 V25 H1080 V0 H1440 V100 Z",
+  "scallop": "M0 100 V40 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 a60 40 0 0 1 120 0 V100 Z"
+}

package/src/core/locales/ar.json

@@ -109,6 +109,9 @@
   "aria.closeToast": "إغلاق التنبيه",
   "aria.closeAlert": "إغلاق التنبيه",
   "aria.removeFilter": "إزالة الفلتر",
+  "aria.chart": "مخطط",
+  "aria.graph": "مخطط شبكي",
+  "aria.pageNavigation": "التنقل بين الصفحات",
   "aria.closeDrawer": "إغلاق اللوحة",
   "aria.closePanel": "إغلاق اللوحة",
   "aria.dockPanel": "اللوحة الجانبية",
@@ -323,6 +326,15 @@
   "docSearch.placeholder": "البحث في الوثائق...",
   "stateMachine.loading": "جارٍ تحميل آلة الحالة…",
   "stateMachine.noStateMachine": "لا توجد آلة حالة لعرضها",
+  "stateMachine.background": "يعمل في الخلفية",
+  "stateMachine.linked": "مدارات أخرى تتحدث معها هذه الصفحة",
+  "stateMachine.guarded": "محروس: يعمل فقط عندما يتحقق شرطه",
+  "stateMachine.selfEvents": "{{state}}: {{count}} أحداث تبقى في هذه الحالة",
+  "stateMachine.boxLabel": "{{trait}}: {{state}} ({{count}} حالات)",
+  "stateMachine.boxLabelIdle": "{{trait}} ({{count}} حالات)",
+  "stateMachine.wireLabel": "{{from}} يرسل {{event}} إلى {{to}}",
+  "stateMachine.expand": "افتح {{trait}} في مكانه",
+  "stateMachine.collapse": "أغلق {{trait}}",
   "avl.trigger": "المُشغِّل",
   "avl.guard": "الحارس",
   "avl.effects": "التأثيرات",
@@ -340,6 +352,8 @@
   "avl.noTraitData": "لا توجد بيانات سمة",
   "avl.computingLayout": "جارٍ حساب التخطيط...",
   "avl.noStateMachine": "لا توجد آلة حالات",
+  "avl.layoutFailed": "تعذّر تحميل تخطيط آلة الحالات.",
+  "avl.pendingSourceState": "تم تحديد مصدر الانتقال",
   "avl.listensFor": "يستمع إلى {{event}}",
   "avl.emits": "يُصدر {{event}}",
   "avl.pageLayout": "تخطيط الصفحة",
@@ -906,6 +920,7 @@
   "gridPicker.all": "الكل",
   "gridPicker.moreRefine": "+{{count}} أخرى — دقّق بحثك",
   "graphCanvas.noNodes": "لا توجد عقد لعرضها.",
+  "graphCanvas.selectedNode": "المحدد: {{label}}",
   "codeBlock.noCode": "لا يوجد كود لعرضه.",
   "codeBlock.region": "الشيفرة البرمجية",
   "fab.action": "إجراء",
@@ -948,10 +963,6 @@
   "videoEmbed.notFound": "لم يتم العثور على الفيديو أو أنه خاص",
   "videoEmbed.notEmbeddable": "مالك الفيديو لا يسمح بتضمينه",
   "videoEmbed.noVideo": "لم يتم اختيار فيديو",
-  "themeToggle.switchToLight": "التبديل إلى الوضع الفاتح",
-  "themeToggle.switchToDark": "التبديل إلى الوضع الداكن",
-  "themeToggle.light": "فاتح",
-  "themeToggle.dark": "داكن",
   "avatar.alt": "الصورة الرمزية",
   "avatar.status": "الحالة: {{status}}",
   "avatar.status.online": "متصل",
@@ -1259,5 +1270,7 @@
   "debug.replayForward": "الخطوة التالية",
   "debug.replayPlay": "تشغيل",
   "debug.replayPause": "إيقاف مؤقت",
-  "debug.replayStep": "{{step}} / {{total}}"
+  "debug.replayStep": "{{step}} / {{total}}",
+  "stateMachine.inspect": "فحص: اختر سمة من الصفحة",
+  "stateMachine.inspectHint": "انقر جزءًا من الصفحة · Esc للإيقاف"
 }