@almadar/shell-web 1.0.0 → 1.1.0

package/dist/{paintDispatch-CuJLsr9Y.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 { 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
@@ -656,7 +653,7 @@ 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[]>>;
@@ -684,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,6 @@
 {
   "name": "@almadar/shell-web",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "orbRelease": {
     "severity": "normal"
   },
@@ -64,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",
@@ -134,11 +129,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^11.1.0",
+    "@almadar/core": "^11.3.0",
     "@almadar/kernel": "^19.0.1",
-    "@almadar/logger": "^2.1.0",
-    "@almadar/std": "^17.0.0",
-    "@almadar/syntax": "^2.0.0",
+    "@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",
@@ -166,14 +161,11 @@
     "remark-math": "^6.0.0",
     "tailwind-merge": "^2.2.0",
     "zod": "^4.6.7",
-    "@almadar/shell-browser": "^1.0.0",
-    "@almadar/shell-runtime": "^1.0.0"
+    "@almadar/shell-browser": "^1.1.0",
+    "@almadar/shell-runtime": "^1.1.0"
   },
   "devDependencies": {
     "@almadar/eslint-plugin": "^3.0.0",
-    "@react-three/drei": "^10.7.7",
-    "@react-three/fiber": "^9.6.0",
-    "@react-three/postprocessing": "3.0.4",
     "@tanstack/react-query": "^5.0.0",
     "@testing-library/jest-dom": "^6.4.0",
     "@testing-library/react": "^14.2.0",
@@ -184,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",
@@ -198,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",
@@ -223,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/dist/AvlGlyph-EPJKFEO3.js

@@ -1,6 +0,0 @@
-export { AVL_GLYPH_KINDS, AvlGlyph } from './chunk-CPLN6NBQ.js';
-import './chunk-HH5KSMH5.js';
-import './chunk-DZBQA2OW.js';
-import './chunk-UXLE3IPR.js';
-import './chunk-4YXBKHHM.js';
-import './chunk-G7DCAZ22.js';

package/dist/AvlStateMachine-RKZIKNGC.js

@@ -1,9 +0,0 @@
-export { AvlStateMachine, BODY_CHAR, MARGIN, MAX_SCALE, MIN_SCALE, MONO_CHAR, PILL_H, metricsFor, pillWidth } from './chunk-SP5CDJ6K.js';
-import './chunk-TXAUOLWZ.js';
-import './chunk-AB3X7QTE.js';
-import './chunk-DZBQA2OW.js';
-import './chunk-TZZBINQY.js';
-import './chunk-PCR37T3U.js';
-import './chunk-UXLE3IPR.js';
-import './chunk-4YXBKHHM.js';
-import './chunk-G7DCAZ22.js';

package/dist/AvlTransitionExplainer-ZBTLOM3T.js

@@ -1,12 +0,0 @@
-export { AvlTransitionExplainer } from './chunk-X3DMMX27.js';
-import './chunk-K4MOPSEL.js';
-import './chunk-ILQXJ2AR.js';
-import './chunk-REXYVBUO.js';
-import './chunk-AGXD77SL.js';
-import './chunk-TXAUOLWZ.js';
-import './chunk-AB3X7QTE.js';
-import './chunk-DZBQA2OW.js';
-import './chunk-PCR37T3U.js';
-import './chunk-UXLE3IPR.js';
-import './chunk-4YXBKHHM.js';
-import './chunk-G7DCAZ22.js';

package/dist/BehaviorView-YS5G4GNB.js

@@ -1,11 +0,0 @@
-export { BehaviorView } from './chunk-ROICKAU7.js';
-import './chunk-SP5CDJ6K.js';
-import './chunk-AGXD77SL.js';
-import './chunk-TXAUOLWZ.js';
-import './chunk-AB3X7QTE.js';
-import './chunk-DZBQA2OW.js';
-import './chunk-TZZBINQY.js';
-import './chunk-PCR37T3U.js';
-import './chunk-UXLE3IPR.js';
-import './chunk-4YXBKHHM.js';
-import './chunk-G7DCAZ22.js';