@almadar/shell-web 0.1.0 → 1.0.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-3VZ36ZKO.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-TZKGHJRY.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/three/index.d.ts

@@ -1,18 +1,18 @@
-import { C as CanvasPointLightConfig } from '../Canvas3DHost-_Y-5uLM_.js';
+import { C as CanvasPointLightConfig } from '../Canvas3DHost-BkZQB5l2.js';
 import { IsometricTile, IsometricUnit, IsometricFeature } from '../components/index.js';
-export { c as Canvas3DHost, d as Canvas3DHostHandle, e as Canvas3DHostProps, c as GameCanvas3D, U as UnitAnimationState } from '../Canvas3DHost-_Y-5uLM_.js';
+export { c as Canvas3DHost, d as Canvas3DHostHandle, e as Canvas3DHostProps, c as GameCanvas3D, U as UnitAnimationState } from '../Canvas3DHost-BkZQB5l2.js';
 import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import * as THREE from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { JsonObject, EventEmit, OrbitalSchema } from '@almadar/core';
 import { ZoomLevel } from '../avl/index.js';
-import { b as Avl3DModelOverrides } from '../avl-3d-context-BIRKWpaL.js';
-export { d as AVL_3D_COLORS, A as Avl3DConfig, a as Avl3DContext, C as CAMERA_POSITIONS, P as Position3D, e as arcCurve3D, f as fibonacciSpherePositions, g as goldenSpiralPositions, o as orbitRingPositions, s as selfLoopCurve3D, t as treeLayout3D, u as useAvl3DConfig } from '../avl-3d-context-BIRKWpaL.js';
+import { b as Avl3DModelOverrides } from '../avl-3d-context-BycmO6tG.js';
+export { d as AVL_3D_COLORS, A as Avl3DConfig, a as Avl3DContext, C as CAMERA_POSITIONS, P as Position3D, e as arcCurve3D, f as fibonacciSpherePositions, g as goldenSpiralPositions, o as orbitRingPositions, s as selfLoopCurve3D, t as treeLayout3D, u as useAvl3DConfig } from '../avl-3d-context-BycmO6tG.js';
 import { ApplicationLevelData, OrbitalLevelData, TraitLevelData, TransitionLevelData } from '../avl/index.js';
-import '../paintDispatch-ChW5mVuK.js';
+import '../paintDispatch-CuJLsr9Y.js';
 import '../fx-CmQjnHmT.js';
 import 'lucide-react';
-import '../EventBusProvider-CVwjkV_2.js';
+import '../EventBusProvider-BFFHfN4O.js';
 
 /**
  * Scene3D

package/dist/three/index.js

@@ -1,13 +1,13 @@
-import { goldenSpiralPositions, forceDirectedPositions, Avl3DOrbitalNode, Avl3DCrossWire, Avl3DEntityCore, fibonacciSpherePositions, Avl3DLabel, Avl3DStateNode, Avl3DTransitionArc, Avl3DExprTree, AVL_3D_COLORS, zoomReducer, initialZoomState, CAMERA_POSITIONS, getBreadcrumbs, Avl3DTooltip } from '../chunk-DJ433ET5.js';
-export { AVL_3D_COLORS, CAMERA_POSITIONS, arcCurve3D, fibonacciSpherePositions, goldenSpiralPositions, orbitRingPositions, selfLoopCurve3D, treeLayout3D } from '../chunk-DJ433ET5.js';
+"use client";
+import { goldenSpiralPositions, forceDirectedPositions, Avl3DOrbitalNode, Avl3DCrossWire, Avl3DEntityCore, fibonacciSpherePositions, Avl3DLabel, Avl3DStateNode, Avl3DTransitionArc, Avl3DExprTree, AVL_3D_COLORS, zoomReducer, initialZoomState, CAMERA_POSITIONS, getBreadcrumbs, Avl3DTooltip } from '../chunk-GFXCPUMX.js';
+export { AVL_3D_COLORS, CAMERA_POSITIONS, arcCurve3D, fibonacciSpherePositions, goldenSpiralPositions, orbitRingPositions, selfLoopCurve3D, treeLayout3D } from '../chunk-GFXCPUMX.js';
 import { useAvl3DPalette, Avl3DContext } from '../chunk-EOWMARUB.js';
 export { Avl3DContext, useAvl3DConfig } from '../chunk-EOWMARUB.js';
-import { useOnScreen, useCanvasTheme, withSeries, resolveDrawableColors, markColor, applySceneMaterials, collectDrawnItems, buildHitIndex, withPreviewPosition, isValidScenePos, isAnimatedShape, applyShapeAnimation, expandFxLayer, isAnimatedGroup, applyMeshAnimation, spriteAssetState, SPRITE_FALLBACK_FILL, isAnimatedMesh, clampSegments, polyhedronBounds } from '../chunk-PC7K4SK7.js';
-import { parseTransitionLevel, parseTraitLevel, parseOrbitalLevel, parseApplicationLevel } from '../chunk-VFF5OO47.js';
-import { AVL_INK, resolveThemeColor } from '../chunk-DFNZUYX4.js';
-import { keyMapCode, resolveKeyMapEvent } from '../chunk-B4BU77LT.js';
-import '../chunk-DYEKAA4L.js';
-import { useEventBus, useTranslate, cn, useEmitEvent, isAtlasAsset, getAtlas, subRectFor, Box, HStack, Typography, pressableProps, useTheme, useThemeScope } from '../chunk-MBQAMMSE.js';
+import { useOnScreen, useCanvasTheme, withSeries, resolveDrawableColors, markColor, applySceneMaterials, collectDrawnItems, buildHitIndex, withPreviewPosition, isValidScenePos, isAnimatedShape, applyShapeAnimation, expandFxLayer, isAnimatedGroup, applyMeshAnimation, spriteAssetState, SPRITE_FALLBACK_FILL, isAnimatedMesh, clampSegments, polyhedronBounds } from '../chunk-4T3P43NS.js';
+import { parseTransitionLevel, parseTraitLevel, parseOrbitalLevel, parseApplicationLevel } from '../chunk-PCR37T3U.js';
+import { AVL_INK, resolveThemeColor } from '../chunk-UXLE3IPR.js';
+import { keyMapCode, resolveKeyMapEvent } from '../chunk-ILZ7ORX7.js';
+import { usePrefersReducedMotion, useEventBus, useTranslate, cn, useEmitEvent, isAtlasAsset, getAtlas, subRectFor, Box, HStack, Typography, pressableProps, useTheme, useThemeScope } from '../chunk-4YXBKHHM.js';
 import '../chunk-G7DCAZ22.js';
 import React3, { createContext, forwardRef, useRef, useState, useMemo, useEffect, useCallback, useImperativeHandle, Component, useContext, useReducer, useLayoutEffect } from 'react';
 import { Canvas, useThree, useFrame } from '@react-three/fiber';
@@ -46,12 +46,12 @@ function useGameCanvas3DEvents(options) {
     (tile, event) => {
       if (tileClickEvent) {
         emit(tileClickEvent, {
-          tileId: tile.id,
+          ...tile.id !== void 0 ? { tileId: tile.id } : {},
           x: tile.x,
           z: tile.z ?? tile.y ?? 0,
-          type: tile.type,
-          terrain: tile.terrain,
-          elevation: tile.elevation
+          ...tile.type !== void 0 ? { type: tile.type } : {},
+          ...tile.terrain !== void 0 ? { terrain: tile.terrain } : {},
+          ...tile.elevation !== void 0 ? { elevation: tile.elevation } : {}
         });
       }
       optionsRef.current.onTileClick?.(tile, event);
@@ -63,14 +63,14 @@ function useGameCanvas3DEvents(options) {
       if (unitClickEvent) {
         emit(unitClickEvent, {
           unitId: unit.id,
-          x: unit.x,
+          ...unit.x !== void 0 ? { x: unit.x } : {},
           z: unit.z ?? unit.y ?? 0,
-          unitType: unit.unitType,
-          name: unit.name,
-          team: unit.team,
-          faction: unit.faction,
-          health: unit.health,
-          maxHealth: unit.maxHealth
+          ...unit.unitType !== void 0 ? { unitType: unit.unitType } : {},
+          ...unit.name !== void 0 ? { name: unit.name } : {},
+          ...unit.team !== void 0 ? { team: unit.team } : {},
+          ...unit.faction !== void 0 ? { faction: unit.faction } : {},
+          ...unit.health !== void 0 ? { health: unit.health } : {},
+          ...unit.maxHealth !== void 0 ? { maxHealth: unit.maxHealth } : {}
         });
       }
       optionsRef.current.onUnitClick?.(unit, event);
@@ -81,11 +81,11 @@ function useGameCanvas3DEvents(options) {
     (feature, event) => {
       if (featureClickEvent) {
         emit(featureClickEvent, {
-          featureId: feature.id,
+          ...feature.id !== void 0 ? { featureId: feature.id } : {},
           x: feature.x,
           z: feature.z ?? feature.y ?? 0,
           type: feature.type,
-          elevation: feature.elevation
+          ...feature.elevation !== void 0 ? { elevation: feature.elevation } : {}
         });
       }
       optionsRef.current.onFeatureClick?.(feature, event);
@@ -110,10 +110,10 @@ function useGameCanvas3DEvents(options) {
       if (tile) {
         if (tileHoverEvent) {
           emit(tileHoverEvent, {
-            tileId: tile.id,
+            ...tile.id !== void 0 ? { tileId: tile.id } : {},
             x: tile.x,
             z: tile.z ?? tile.y ?? 0,
-            type: tile.type
+            ...tile.type !== void 0 ? { type: tile.type } : {}
           });
         }
       } else {
@@ -406,10 +406,11 @@ function FollowCamera3D({
   offset
 }) {
   const { camera } = useThree();
+  const reducedMotion = usePrefersReducedMotion();
   const look = useRef(new THREE5.Vector3(target[0], target[1], target[2]));
   const goal = useRef(new THREE5.Vector3());
   useFrame((_, delta) => {
-    const t = Math.min(1, delta * 5);
+    const t = reducedMotion ? 1 : Math.min(1, delta * 5);
     goal.current.set(target[0] + offset[0], target[1] + offset[1], target[2] + offset[2]);
     camera.position.lerp(goal.current, t);
     look.current.lerp(goal.current.set(target[0], target[1], target[2]), t);
@@ -565,8 +566,9 @@ function ModelLoader({
       action.fadeOut(0.15);
     };
   }, [mixer, clips, animation]);
+  const reducedMotion = usePrefersReducedMotion();
   useFrame((_, delta) => {
-    mixer?.update(delta);
+    if (!reducedMotion) mixer?.update(delta);
   });
   const normFactor = useMemo(() => {
     if (!model) return 1;
@@ -818,8 +820,9 @@ function Shape3D({ node, projector, groupOpacity = 1 }) {
   const animated = isAnimatedShape(node);
   const validPos = isValidScenePos(node.position);
   const world = validPos ? projector.toWorld(node.position) : [0, 0, 0];
+  const reducedMotion = usePrefersReducedMotion();
   useFrame(({ clock }) => {
-    if (!animated || !groupRef.current) return;
+    if (!animated || reducedMotion || !groupRef.current) return;
     const view = applyShapeAnimation(node, clock.elapsedTime * 1e3);
     groupRef.current.position.set(
       world[0] + (view.offsetX ?? 0) * projector.cellSize,
@@ -1098,8 +1101,9 @@ function Mesh3D({
     const g = geo?.geometry;
     return () => g?.dispose();
   }, [geo]);
+  const reducedMotion = usePrefersReducedMotion();
   useFrame(({ clock }) => {
-    if (!animated || !groupRef.current) return;
+    if (!animated || reducedMotion || !groupRef.current) return;
     const state = applyMeshAnimation(node, clock.elapsedTime * 1e3);
     if (!state) return;
     const [wx, wy, wz] = baseWorld;
@@ -1230,8 +1234,9 @@ function Group3D({
     if (!node.bone || !boneStore || !boneObject) return;
     return boneStore.register(node.bone, boneObject);
   }, [node.bone, boneStore, boneObject]);
+  const reducedMotion = usePrefersReducedMotion();
   useFrame(({ clock }) => {
-    if (!animated || !ref.current) return;
+    if (!animated || reducedMotion || !ref.current) return;
     const state = applyMeshAnimation(node, clock.elapsedTime * 1e3);
     if (!state) return;
     const cell = projector.cellSize;
@@ -1260,12 +1265,13 @@ function FxLayer3D({
 }) {
   const [, setFrame] = useState(0);
   const live = Array.isArray(node.items) && node.items.length > 0;
+  const reducedMotion = usePrefersReducedMotion();
   useFrame(() => {
-    if (live) setFrame((f) => (f + 1) % 1e6);
+    if (live && !reducedMotion) setFrame((f) => (f + 1) % 1e6);
   });
   if (!live) return null;
   const epochNow = typeof performance !== "undefined" ? performance.timeOrigin + performance.now() : 0;
-  const children = expandFxLayer(node, epochNow, "3d", void 0, void 0);
+  const children = expandFxLayer(node, epochNow, "3d", projector.cellSize, void 0);
   return /* @__PURE__ */ jsx(Fragment, { children: children.map((c, i) => /* @__PURE__ */ jsx(Drawable3D, { node: c, projector, groupOpacity }, i)) });
 }
 var DEFAULT_GRID_CONFIG = {
@@ -1344,6 +1350,7 @@ var Canvas3DHost = forwardRef(
     moveEvent
   }, ref) => {
     const containerRef = useRef(null);
+    const reducedMotion = usePrefersReducedMotion();
     const onScreen = useOnScreen(containerRef);
     const controlsRef = useRef(null);
     const [internalError, setInternalError] = useState(null);
@@ -1767,7 +1774,7 @@ var Canvas3DHost = forwardRef(
                       ref: controlsRef,
                       enabled: controlsEnabled && !editable && cameraMode !== "follow" && cameraMode !== "chase",
                       target: cameraTarget,
-                      enableDamping: true,
+                      enableDamping: !reducedMotion,
                       dampingFactor: 0.05,
                       enableZoom: true,
                       enablePan: true,
@@ -1853,6 +1860,7 @@ var Camera3D = forwardRef(
       return () => {
       };
     }, [mode, fov, zoom, viewport.aspect, set]);
+    const reducedMotion = usePrefersReducedMotion();
     useFrame(() => {
       if (onChange) {
         onChange(camera);
@@ -1898,7 +1906,7 @@ var Camera3D = forwardRef(
         minDistance,
         maxDistance,
         maxPolarAngle,
-        enableDamping: true,
+        enableDamping: !reducedMotion,
         dampingFactor: 0.05
       }
     );
@@ -3010,8 +3018,9 @@ var Avl3DApplicationScene = ({
     });
     return map;
   }, [data.orbitals, orbitalPositions]);
+  const reducedMotion = usePrefersReducedMotion();
   useFrame((_, delta) => {
-    if (!groupRef.current) return;
+    if (!groupRef.current || reducedMotion) return;
     groupRef.current.rotation.y += delta * 0.03;
   });
   return /* @__PURE__ */ jsxs("group", { ref: groupRef, children: [
@@ -3068,8 +3077,9 @@ function TraitOrbit({
   const angleRef = useRef(Math.random() * Math.PI * 2);
   const palette = useAvl3DPalette();
   const { t } = useTranslate();
+  const reducedMotion = usePrefersReducedMotion();
   useFrame((_, delta) => {
-    angleRef.current += delta * speed;
+    if (!reducedMotion) angleRef.current += delta * speed;
     if (!groupRef.current) return;
     const x = radius * Math.cos(angleRef.current);
     const flatZ = radius * Math.sin(angleRef.current);
@@ -3589,20 +3599,21 @@ function CameraController({ targetPosition, targetLookAt, animated }) {
   const targetPosVec = useRef(new THREE5.Vector3(...targetPosition));
   const targetLookVec = useRef(new THREE5.Vector3(...targetLookAt));
   const isAnimating = useRef(false);
+  const reducedMotion = usePrefersReducedMotion();
   useEffect(() => {
     const newTarget = new THREE5.Vector3(...targetPosition);
     const newLookAt = new THREE5.Vector3(...targetLookAt);
     if (!newTarget.equals(targetPosVec.current) || !newLookAt.equals(targetLookVec.current)) {
       targetPosVec.current.copy(newTarget);
       targetLookVec.current.copy(newLookAt);
-      if (animated) {
+      if (animated && !reducedMotion) {
         isAnimating.current = true;
       } else {
         camera.position.copy(targetPosVec.current);
         camera.lookAt(targetLookVec.current.x, targetLookVec.current.y, targetLookVec.current.z);
       }
     }
-  }, [targetPosition, targetLookAt, animated, camera]);
+  }, [targetPosition, targetLookAt, animated, reducedMotion, camera]);
   useFrame((_, delta) => {
     if (!isAnimating.current) return;
     const speed = 3;
@@ -3620,10 +3631,11 @@ function CameraController({ targetPosition, targetLookAt, animated }) {
 function SceneFade({ animating, children }) {
   const groupRef = useRef(null);
   const opacityRef = useRef(1);
+  const reducedMotion = usePrefersReducedMotion();
   useFrame((_, delta) => {
     if (!groupRef.current) return;
     const target = animating ? 0 : 1;
-    opacityRef.current = THREE5.MathUtils.damp(opacityRef.current, target, 5, delta);
+    opacityRef.current = reducedMotion ? target : THREE5.MathUtils.damp(opacityRef.current, target, 5, delta);
     groupRef.current.visible = opacityRef.current > 0.05;
     const s = 0.9 + opacityRef.current * 0.1;
     groupRef.current.scale.setScalar(s);

package/dist/{verificationRegistry-CabxhfTv.d.ts → verificationRegistry-CVrcxG1s.d.ts}

@@ -1,5 +1,5 @@
-import { D as DrawableNode } from './paintDispatch-ChW5mVuK.js';
-import { OrbitalVerificationAPI, TraitStateSnapshot, EventPayload, BusEvent, VerificationCheck, BridgeHealth, VerificationSnapshot, VerificationSummary, TransitionTrace, OrbitalEventRequest, OrbitalEventResponse, ServerResponseTrace, EffectTrace, CheckStatus, ServerEffectResult, AssetLoadStatus } from '@almadar/core';
+import { D as DrawableNode } from './paintDispatch-CuJLsr9Y.js';
+import { OrbitalVerificationAPI, TraitStateSnapshot, EventPayload, BusEvent, VerificationCheck, BridgeHealth, VerificationSnapshot, VerificationSummary, TransitionTrace, EventRequest, EventResponse, ServerResponseTrace, EffectTrace, CheckStatus, ServerEffectResult, AssetLoadStatus } from '@almadar/core';
 import { EventTransport } from '@almadar/shell-runtime/client/EventTransport';
 import './verification-C5pTeMJv.js';
 
@@ -46,7 +46,7 @@ declare function recordServerResponse(orbitalName: string, event: string, respon
 /** 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: OrbitalEventRequest, response: OrbitalEventResponse): void;
+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;

package/package.json

@@ -1,6 +1,9 @@
 {
   "name": "@almadar/shell-web",
-  "version": "0.1.0",
+  "version": "1.0.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",
@@ -115,6 +118,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 +134,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.1.0",
+    "@almadar/kernel": "^19.0.1",
+    "@almadar/logger": "^2.1.0",
+    "@almadar/std": "^17.0.0",
+    "@almadar/syntax": "^2.0.0",
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
@@ -162,11 +166,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.0.0",
+    "@almadar/shell-runtime": "^1.0.0"
   },
   "devDependencies": {
-    "@almadar/eslint-plugin": "^2.22.0",
+    "@almadar/eslint-plugin": "^3.0.0",
     "@react-three/drei": "^10.7.7",
     "@react-three/fiber": "^9.6.0",
     "@react-three/postprocessing": "3.0.4",

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 للإيقاف"
 }