@almadar/shell-web 0.1.0 → 1.1.0

package/dist/{TraitValueFrame-4G3KOUBR.css → OrbInspector-VMTMZHNQ.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/{Select-mDZIwNqN.d.ts → Select-C2Uq6t86.d.ts}

@@ -1,10 +1,16 @@
 import React__default from 'react';
 import { A11yProps, Asset, EventKey, EventPayload, EventEmit } from '@almadar/core';
-import { I as IconInput } from './fx-CmQjnHmT.js';
+import { I as IconInput } from './fx-Br8zjvu9.js';
 
 type ButtonVariant = "primary" | "secondary" | "ghost" | "danger" | "success" | "warning" | "default" | "link";
 type ButtonSize = "sm" | "md" | "lg";
-/** @accessibleName label */
+/**
+ * @accessibleName label
+ * @role button
+ * @tokens --color-primary --color-primary-foreground --color-foreground
+ * @contrast primary-foreground primary
+ * @motion css
+ */
 interface ButtonProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, keyof A11yProps | 'onClick'>, A11yProps {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -34,6 +40,8 @@ interface ButtonProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButto
     label?: string;
     /** Disable the button (greys out, blocks click events) */
     disabled?: boolean;
+    /** Native button type. `type` is reserved for the pattern discriminator in schema render specs. */
+    htmlType?: "button" | "submit" | "reset";
     /** Makes the button a link: `#anchor` scrolls, an absolute URL loads, a path navigates in-app */
     href?: string;
     /**
@@ -50,7 +58,13 @@ interface SelectOption$1 {
     value: string;
     label: string;
 }
-/** @accessibleName label */
+/**
+ * @accessibleName label
+ * @role textbox
+ * @tokens --color-card --color-border --color-foreground --color-muted-foreground
+ * @contrast foreground card
+ * @motion css
+ */
 interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, "onChange" | Exclude<keyof A11yProps, "role" | "dir">>, Omit<A11yProps, "role" | "dir"> {
     /** Additional CSS classes applied to the root element. */
     className?: string;
@@ -98,43 +112,15 @@ interface InputProps extends Omit<React__default.InputHTMLAttributes<HTMLInputEl
 }
 declare const Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement>>;
 
-/**
- * PatternTile Atom
- *
- * Mathematically correct Islamic geometric pattern tiles using the
- * Polygons-in-Contact (PIC) method (Hankin 1925, formalized by Kaplan 2005).
- *
- * Construction: A regular polygon tiling is overlaid with star motifs.
- * Each motif touches the enclosing polygon at EDGE MIDPOINTS only.
- * Two rays emanate from each midpoint into the polygon at a specific
- * CONTACT ANGLE (theta). Where rays from adjacent midpoints intersect,
- * they form the star points. Gap tiles (squares, triangles) between
- * polygons receive inferred geometry by extending boundary rays inward.
- *
- * Variants:
- *   star8  — 8-fold star-and-cross on 4.8.8 tiling (theta = 67.5 deg)
- *   star6  — 6-fold star on hexagonal tiling (theta = 60 deg)
- *   khatam — 8-fold rosette with interlocking kites (theta = 72 deg)
- *   star10 — 10-fold girih on decagonal tiling (theta = 72 deg)
- *   star12 — 12-fold on dodecagonal tiling (theta = 75 deg)
- *
- * All tiles use stroke only (no fill), rendering as transparent overlays.
- */
-
 type PatternVariant = 'star8' | 'star6' | 'khatam' | 'star10' | 'star12' | 'rosette-double' | 'rosette-filled' | 'seigaiha' | 'greek-key' | 'celtic-knot' | 'kolam' | 'arch' | 'arabesque-vine' | 'arabesque-net';
 interface PatternTileProps extends A11yProps {
-    /** Which geometric pattern to render */
     variant?: PatternVariant;
-    /** Tile unit size in SVG units */
     size?: number;
-    /** Stroke color (CSS variable or hex) */
     color?: string;
-    /** Line thickness */
     strokeWidth?: number;
     className?: string;
 }
 declare const PatternTile: React__default.FC<PatternTileProps>;
-/** Returns the tile dimensions for a given variant and size */
 declare function getTileDimensions(variant: PatternVariant, size: number): {
     width: number;
     height: number;

package/dist/ServerBridge-Bqsj-lOU.d.ts

@@ -0,0 +1,124 @@
+import * as React from 'react';
+import React__default, { ReactNode } from 'react';
+import { EntityRow, TraitConfig, SkeletonNode, OrbitalSchema } from '@almadar/core';
+import { EventTransport, AccessTokenProvider } from '@almadar/shell-runtime/client/EventTransport';
+import './verification-C5pTeMJv.js';
+
+/**
+ * Read + subscribe surface over the live trait binding stores. Snapshots
+ * are cached objects — a new reference only when the trait's entity
+ * actually changed (the `useSyncExternalStore` contract).
+ */
+interface EntityBindingSource {
+    /** Current entity snapshot for a trait (shared-entity traits read the shared store). */
+    getEntitySnapshot: (traitName: string) => EntityRow;
+    /** Merged render-time config (declared defaults < resolved < call-site). */
+    getConfig: (traitName: string) => TraitConfig | undefined;
+    /** Current state-machine state — evaluation context for `@state` in marked expressions. */
+    getState: (traitName: string) => string;
+    /** Subscribe to entity commits for a trait. Returns unsubscribe. */
+    subscribe: (traitName: string, callback: () => void) => () => void;
+}
+declare const EntityBindingContext: React.Context<EntityBindingSource | null>;
+/**
+ * Bridge one trait's live bindings into React. With no provider (compiled
+ * shell, static renders) or no owning trait, returns empty bindings and
+ * never re-renders — markers resolve to the same `undefined` they would
+ * have resolved to at flush time against an empty entity.
+ */
+declare function useEntityBindingSnapshot(traitName: string | undefined): {
+    entity: EntityRow;
+    config: TraitConfig | undefined;
+    state: string;
+};
+
+interface AwaitingSkeletonSource {
+    /** The predicted skeleton for a top-level slot, from a non-embedded awaiting render. */
+    forSlot: (slot: string) => SkeletonNode | undefined;
+    /** The predicted skeleton for an embedded trait's frame. */
+    forTrait: (traitName: string) => SkeletonNode | undefined;
+    subscribe: (callback: () => void) => () => void;
+    getVersion: () => number;
+}
+declare const AwaitingSkeletonContext: React.Context<AwaitingSkeletonSource | null>;
+declare function useAwaitingSkeleton(target: {
+    slot: string;
+} | {
+    trait: string;
+}): SkeletonNode | undefined;
+
+/**
+ * EntitySchemaContext
+ *
+ * Provides the kernel's answer for which orbital owns each trait on the page.
+ * Not a data store: entity rows flow through the state machine's `@payload.data`
+ * binding and land on the rendering component's `entity` prop.
+ *
+ * @packageDocumentation
+ */
+
+interface EntitySchemaContextValue {
+    /** Per-trait owning-orbital name, as the kernel's page circuit answers it; scopes each slot's events. */
+    orbitalsByTrait: ReadonlyMap<string, string>;
+}
+interface EntitySchemaProviderProps {
+    orbitalsByTrait: ReadonlyMap<string, string>;
+    children: React__default.ReactNode;
+}
+declare function EntitySchemaProvider({ orbitalsByTrait, children, }: EntitySchemaProviderProps): React__default.ReactElement;
+declare function useEntitySchema(): EntitySchemaContextValue;
+/** Null when no provider is present (UISlotRenderer may render outside one in compiled mode). */
+declare function useEntitySchemaOptional(): EntitySchemaContextValue | null;
+
+interface ServerBridgeContextValue {
+    connected: boolean;
+    /**
+     * From the transport's `register()` result
+     * (`EventTransportRegisterResult.carriesCircuitState`, `@almadar/runtime`):
+     * `true` = the stateless topology (a posted leg must carry
+     * `traits`/`entityByTrait`), `false` = the server (or an in-process
+     * evaluator) holds circuit state itself.
+     */
+    carriesCircuitState: boolean;
+    /** `register()` has resolved, so `carriesCircuitState` is the transport's
+     *  real topology rather than the pre-register guess. */
+    topologyKnown: boolean;
+    /** The ONE transport this bridge manages the register/unregister
+     *  lifecycle for — `useCircuitKernel` dispatches through it directly. */
+    transport: EventTransport;
+}
+/**
+ * @deprecated Alias for `@almadar/runtime`'s `EventTransport` (plan P5) —
+ * kept only because in-package consumers (`OrbPreview.tsx`) still import the name.
+ * Import `EventTransport` directly in new code.
+ */
+type ServerBridgeTransport = EventTransport;
+
+/**
+ * Access the server bridge. Returns a no-op stub when outside the provider —
+ * `useCircuitKernel` treats an absent/no-op transport as offline (plan G7).
+ */
+declare function useServerBridge(): ServerBridgeContextValue;
+interface ServerBridgeProviderProps {
+    schema: OrbitalSchema;
+    /** HTTP server URL (canonical playground-runtime / apps/builder-server). */
+    serverUrl?: string;
+    /**
+     * Custom `EventTransport` (plan P5, `@almadar/runtime`). Use this for
+     * in-process execution (e.g. an in-process test harness invokes
+     * `OrbitalServerRuntime.processOrbitalEvent` directly via
+     * `createInProcessTransport`). Mutually exclusive with `serverUrl`.
+     */
+    transport?: EventTransport;
+    /**
+     * Bearer token for the HTTP transport (`Authorization` on every fetch, and on the
+     * request that mints the SSE stream's single-use ticket, since EventSource cannot set headers).
+     * Ignored with a custom `transport`.
+     */
+    getAccessToken?: AccessTokenProvider;
+    children: ReactNode;
+}
+declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, getAccessToken, children, }: ServerBridgeProviderProps): React.JSX.Element;
+
+export { EntitySchemaProvider as b, ServerBridgeProvider as e, useEntitySchemaOptional as f, useServerBridge as g, AwaitingSkeletonContext as h, EntityBindingContext as i, useAwaitingSkeleton as k, useEntityBindingSnapshot as l, useEntitySchema as u };
+export type { AwaitingSkeletonSource as A, EntityBindingSource as E, ServerBridgeTransport as S, EntitySchemaContextValue as a, EntitySchemaProviderProps as c, ServerBridgeContextValue as d, ServerBridgeProviderProps as j };