@almadar/shell-web 0.1.0 → 1.0.0

package/dist/{ArbitraryClassCompiler-Mzabq-UB.d.ts → ArbitraryClassCompiler-CO_iASBn.d.ts}

@@ -1,7 +1,7 @@
 import * as React from 'react';
 import React__default, { ReactNode, ReactElement } from 'react';
-import { ThemeRef, OrbitalSchema } from '@almadar/core';
-import './EventBusProvider-CVwjkV_2.js';
+import { ThemeRef, UserContext as UserContext$1, FieldValue, OrbitalSchema } from '@almadar/core';
+import './EventBusProvider-BFFHfN4O.js';
 import { T as ThemeProviderProps } from './ThemeContext-DJmO59xd.js';
 
 /**
@@ -75,6 +75,101 @@ interface CurrentPagePathProviderProps {
 declare const CurrentPagePathProvider: React__default.FC<CurrentPagePathProviderProps>;
 declare const useCurrentPagePath: () => string | undefined;
 
+/**
+ * UserContext
+ *
+ * React context for providing user data throughout the application.
+ * Enables @user bindings in S-expressions for role-based UI and permissions.
+ *
+ * Usage:
+ * ```tsx
+ * // In App.tsx or layout
+ * <UserProvider user={{ id: '123', role: 'admin', permissions: ['read', 'write'] }}>
+ *   <App />
+ * </UserProvider>
+ *
+ * // In components - access via hook
+ * const { user, hasRole, hasPermission } = useUser();
+ * if (hasRole('admin')) { ... }
+ * if (hasPermission('delete')) { ... }
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * User data for `@user` bindings — the canonical `UserContext` from
+ * `@almadar/core`, kept under this name for existing consumers. Declaring the
+ * shape locally let it drift from the type both execution paths resolve against.
+ */
+type UserData = UserContext$1;
+/**
+ * User context value.
+ */
+interface UserContextValue {
+    /** Current user data (null if not logged in) */
+    user: UserData | null;
+    /** Check if user is logged in */
+    isLoggedIn: boolean;
+    /** Check if user has a specific role */
+    hasRole: (role: string) => boolean;
+    /** Check if user has a specific permission */
+    hasPermission: (permission: string) => boolean;
+    /** Check if user has any of the specified roles */
+    hasAnyRole: (roles: string[]) => boolean;
+    /** Check if user has all of the specified permissions */
+    hasAllPermissions: (permissions: string[]) => boolean;
+    /** Get a user field by path (for @user.field bindings) */
+    getUserField: (path: string) => FieldValue | undefined;
+}
+declare const UserContext: React__default.Context<UserContextValue | null>;
+interface UserProviderProps {
+    /** User data (null if not logged in) */
+    user?: UserData | null;
+    /** Children to render */
+    children: React__default.ReactNode;
+}
+/**
+ * Provider component that provides user context to the application.
+ *
+ * Provides RBAC helpers and field access for @user bindings.
+ */
+declare function UserProvider({ user, children, }: UserProviderProps): React__default.ReactElement;
+/**
+ * Hook to access the user context.
+ *
+ * Returns default values if used outside of UserProvider (for resilience).
+ *
+ * @example
+ * ```tsx
+ * function AdminPanel() {
+ *   const { user, hasRole, hasPermission } = useUser();
+ *
+ *   if (!hasRole('admin') && !hasPermission('admin:access')) {
+ *     return <AccessDenied />;
+ *   }
+ *
+ *   return <div>Welcome, {user?.name}</div>;
+ * }
+ * ```
+ */
+declare function useUser(): UserContextValue;
+/**
+ * Hook to check if user has a specific role.
+ * Convenience wrapper around useUser().hasRole().
+ */
+declare function useHasRole(role: string): boolean;
+/**
+ * Hook to check if user has a specific permission.
+ * Convenience wrapper around useUser().hasPermission().
+ */
+declare function useHasPermission(permission: string): boolean;
+/**
+ * Hook to get user data for @user bindings in S-expressions.
+ * Returns the user data object compatible with EvaluationContext.user
+ */
+declare function useUserForEvaluation(): UserData | undefined;
+
 /**
  * Arbitrary-value Tailwind classes (`w-[243px]`) in a schema exist only as
  * data, so build-time Tailwind never compiled them. A host that renders
@@ -96,5 +191,5 @@ declare function ArbitraryClassCompilerProvider({ compile, children }: Arbitrary
 declare function resetArbitraryClassStyles(): void;
 declare function useArbitraryClassStyles(schema: OrbitalSchema | null | undefined): void;
 
-export { ARBITRARY_CLASS_STYLE_ID as A, CurrentPagePathContext as C, DesignThemeProvider as D, OrbitalThemeProvider as O, ArbitraryClassCompilerProvider as b, CurrentPagePathProvider as d, useCurrentPagePath as g, useDesignTheme as h, resetArbitraryClassStyles as r, useArbitraryClassStyles as u };
-export type { ArbitraryClassCompiler as a, ArbitraryClassCompilerProviderProps as c, CurrentPagePathProviderProps as e, OrbitalThemeProviderProps as f };
+export { ARBITRARY_CLASS_STYLE_ID as A, CurrentPagePathContext as C, DesignThemeProvider as D, OrbitalThemeProvider as O, UserContext as U, ArbitraryClassCompilerProvider as b, CurrentPagePathProvider as d, UserProvider as i, useCurrentPagePath as k, useDesignTheme as l, useHasPermission as m, useHasRole as n, useUser as o, useUserForEvaluation as p, resetArbitraryClassStyles as r, useArbitraryClassStyles as u };
+export type { ArbitraryClassCompiler as a, ArbitraryClassCompilerProviderProps as c, CurrentPagePathProviderProps as e, OrbitalThemeProviderProps as f, UserContextValue as g, UserData as h, UserProviderProps as j };

package/dist/AvlGlyph-EPJKFEO3.js

@@ -0,0 +1,6 @@
+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

@@ -0,0 +1,9 @@
+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/AvlTransitionDetail-63SD6GZF.js

@@ -0,0 +1,11 @@
+export { AvlTransitionDetail } from './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/AvlTransitionExplainer-ZBTLOM3T.js

@@ -0,0 +1,12 @@
+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

@@ -0,0 +1,11 @@
+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';

package/dist/{Canvas3DHost-_Y-5uLM_.d.ts → Canvas3DHost-BkZQB5l2.d.ts}

@@ -1,7 +1,7 @@
 import { AnimationName, Asset, ScenePos, EventEmit, EventKey } from '@almadar/core';
 import React__default from 'react';
 import * as THREE from 'three';
-import { D as DrawableNode } from './paintDispatch-ChW5mVuK.js';
+import { D as DrawableNode } from './paintDispatch-CuJLsr9Y.js';
 
 /**
  * Sprite Sheet Animation Types

package/dist/{EventBusProvider-CVwjkV_2.d.ts → EventBusProvider-BFFHfN4O.d.ts}

@@ -24,6 +24,18 @@ interface VideoEmbedProps extends A11yProps {
     src?: string;
     /** Accessible name of the player */
     title?: string;
+    /** Text shown when no video is selected */
+    noVideoLabel?: string;
+    /** Text for a YouTube API loading failure */
+    apiUnavailableMessage?: string;
+    /** Text for YouTube error code 2 */
+    invalidVideoMessage?: string;
+    /** Text for YouTube error code 5 or an unknown code */
+    playbackFailedMessage?: string;
+    /** Text for YouTube error code 100 */
+    notFoundMessage?: string;
+    /** Text for YouTube error codes 101 and 150 */
+    notEmbeddableMessage?: string;
     /** Start playback as soon as the player is ready (YouTube ids only) */
     autoplay?: boolean;
     /** Show the player's own controls (YouTube ids only) */

package/dist/FlowCanvas-AUMTWMNG.js

@@ -0,0 +1,26 @@
+export { FlowCanvas } from './chunk-LHP2TK7O.js';
+import './chunk-57DC34LY.js';
+import './chunk-SP5CDJ6K.js';
+import './chunk-CPLN6NBQ.js';
+import './chunk-HH5KSMH5.js';
+import './chunk-REXYVBUO.js';
+import './chunk-AGXD77SL.js';
+import './chunk-TXAUOLWZ.js';
+import './chunk-AB3X7QTE.js';
+import './chunk-DZBQA2OW.js';
+import './chunk-TUPZWTRE.js';
+import './chunk-TZZBINQY.js';
+import './chunk-4T3P43NS.js';
+import './chunk-PCR37T3U.js';
+import './chunk-UXLE3IPR.js';
+import './chunk-ILZ7ORX7.js';
+import './chunk-3VZ36ZKO.js';
+import './chunk-PRXQGGCO.js';
+import './chunk-VO2TTLS5.js';
+import './chunk-AE7VCQB6.js';
+import './chunk-3BBUBJFF.js';
+import './chunk-YHMRX6YA.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-A2LR6VQQ.js';
+import './chunk-P4ZFUQFF.js';
+import './chunk-G7DCAZ22.js';

package/dist/{GameAudioProvider-Cm9BnvmP.d.ts → GameAudioProvider-ceM_n0ey.d.ts}

@@ -1,7 +1,7 @@
 import React__default from 'react';
 import { AudioManifest } from '@almadar/core';
 import { U as UiError } from './fx-CmQjnHmT.js';
-import './EventBusProvider-CVwjkV_2.js';
+import './EventBusProvider-BFFHfN4O.js';
 
 /** Core owns the sound-manifest shape (`@almadar/core` `types/asset.ts`) so the
  *  pattern extractor and the generated `.lolo` factories resolve the same
@@ -41,12 +41,9 @@ declare namespace useGameAudio {
 /**
  * GameAudioProvider
  *
- * Context provider that wires the audio system to the Almadar event bus.
- * Wrap your game organism with this provider, then emit:
- *
- *   emit('UI:PLAY_SOUND', { key: 'footstep' })
- *
- * from anywhere inside the tree and the corresponding sound will play.
+ * Context provider that owns the game audio. While it is mounted, the kernel's
+ * `audio/play-sound`, `audio/stop-sound`, `audio/change-music` and `audio/stop-music`
+ * asks drive it.
  *
  * The provider also exposes `muted`/`setMuted` and `masterVolume`/
  * `setMasterVolume` via the `GameAudioContext` for toggle buttons.

package/dist/KernelEngineContext-CcxGYtlr.d.ts

@@ -0,0 +1,33 @@
+import * as React$1 from 'react';
+import { ReactNode } from 'react';
+import { K as KernelModule, a as KernelLoader } from './kernel-wire-wNdAPfhJ.js';
+import { OsHostPort } from '@almadar/shell-runtime/kernel/os-port';
+
+/** Request the next frame; returns its cancel. `requestAnimationFrame` where the host has one. */
+type FrameScheduler = (callback: (nowMs: number) => void) => () => void;
+
+interface KernelEngineValue {
+    /** Resolves the initialised `@almadar/kernel` module, its language installed (`@almadar/shell-browser/kernel-loader`); shared by every circuit under the provider. */
+    loadModule: () => Promise<KernelModule>;
+    /** Supplies the frame clock the kernel's ticks run on; absent = `requestAnimationFrame`. */
+    scheduleFrame?: FrameScheduler;
+    /** The host's `os` port (`createFetchOsHost(fetch)`) every local-store kernel under the provider is opened with; absent, a program's `os` asks are denied. */
+    os?: OsHostPort;
+}
+declare const KernelEngineContext: React$1.Context<KernelEngineValue | null>;
+/** The kernel the nearest `KernelEngineProvider` supplies; `null` with none above. */
+declare function useKernelEngine(): KernelEngineValue | null;
+/** A circuit mounted with no `KernelEngineProvider` (nor an `OrbPreview` `kernelLoader`) above it. */
+declare class KernelLoaderMissingError extends Error {
+    constructor();
+}
+interface KernelEngineProviderProps {
+    loader: KernelLoader;
+    scheduleFrame?: FrameScheduler;
+    os?: OsHostPort;
+    children?: ReactNode;
+}
+declare function KernelEngineProvider({ loader, scheduleFrame, os, children }: KernelEngineProviderProps): React.ReactElement;
+
+export { KernelEngineContext as a, KernelEngineProvider as b, KernelLoaderMissingError as d, useKernelEngine as u };
+export type { KernelEngineValue as K, KernelEngineProviderProps as c };

package/dist/LayersPanel-M2LHWUFF.js

@@ -0,0 +1,6 @@
+export { LayersPanel, parseLayerId, schemaToLayerItems } from './chunk-3S54FWRC.js';
+import './chunk-57DC34LY.js';
+import './chunk-PCR37T3U.js';
+import './chunk-VO2TTLS5.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-G7DCAZ22.js';

package/dist/ModuleCard-QHDGK5XK.js

@@ -0,0 +1,7 @@
+export { ModuleCard } from './chunk-E6KA4J6N.js';
+import './chunk-HH5KSMH5.js';
+import './chunk-AB3X7QTE.js';
+import './chunk-DZBQA2OW.js';
+import './chunk-UXLE3IPR.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-G7DCAZ22.js';

package/dist/OrbInspector-QCPEPUPH.js

@@ -0,0 +1,26 @@
+export { OrbInspector } from './chunk-LHP2TK7O.js';
+import './chunk-57DC34LY.js';
+import './chunk-SP5CDJ6K.js';
+import './chunk-CPLN6NBQ.js';
+import './chunk-HH5KSMH5.js';
+import './chunk-REXYVBUO.js';
+import './chunk-AGXD77SL.js';
+import './chunk-TXAUOLWZ.js';
+import './chunk-AB3X7QTE.js';
+import './chunk-DZBQA2OW.js';
+import './chunk-TUPZWTRE.js';
+import './chunk-TZZBINQY.js';
+import './chunk-4T3P43NS.js';
+import './chunk-PCR37T3U.js';
+import './chunk-UXLE3IPR.js';
+import './chunk-ILZ7ORX7.js';
+import './chunk-3VZ36ZKO.js';
+import './chunk-PRXQGGCO.js';
+import './chunk-VO2TTLS5.js';
+import './chunk-AE7VCQB6.js';
+import './chunk-3BBUBJFF.js';
+import './chunk-YHMRX6YA.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-A2LR6VQQ.js';
+import './chunk-P4ZFUQFF.js';
+import './chunk-G7DCAZ22.js';

package/dist/{Select-mDZIwNqN.d.ts → Select-B-iDdnvE.d.ts}

@@ -4,7 +4,13 @@ import { I as IconInput } from './fx-CmQjnHmT.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 };

package/dist/UISlotRenderer-C7WWOK43.js

@@ -0,0 +1,26 @@
+export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternProps, renderPatternValue } from './chunk-LHP2TK7O.js';
+import './chunk-57DC34LY.js';
+import './chunk-SP5CDJ6K.js';
+import './chunk-CPLN6NBQ.js';
+import './chunk-HH5KSMH5.js';
+import './chunk-REXYVBUO.js';
+import './chunk-AGXD77SL.js';
+import './chunk-TXAUOLWZ.js';
+import './chunk-AB3X7QTE.js';
+import './chunk-DZBQA2OW.js';
+import './chunk-TUPZWTRE.js';
+import './chunk-TZZBINQY.js';
+import './chunk-4T3P43NS.js';
+import './chunk-PCR37T3U.js';
+import './chunk-UXLE3IPR.js';
+import './chunk-ILZ7ORX7.js';
+import './chunk-3VZ36ZKO.js';
+import './chunk-PRXQGGCO.js';
+import './chunk-VO2TTLS5.js';
+import './chunk-AE7VCQB6.js';
+import './chunk-3BBUBJFF.js';
+import './chunk-YHMRX6YA.js';
+import './chunk-4YXBKHHM.js';
+import './chunk-A2LR6VQQ.js';
+import './chunk-P4ZFUQFF.js';
+import './chunk-G7DCAZ22.js';

package/dist/auth/browser/index.js

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

package/dist/auth/react/index.d.ts

@@ -2,6 +2,7 @@ import { ReactNode, ReactElement } from 'react';
 import { ViewerAuthority, UserContext } from '@almadar/core';
 import { BrowserAuth, SignedInUser } from '@almadar/shell-browser/auth';
 export { BrowserAuth, SignedInUser } from '@almadar/shell-browser/auth';
+import { HostSignInRequest, HostSignInAnswer } from '@almadar/shell-runtime/kernel/host';
 
 /** The provider's resolved viewer authority — `@almadar/core`'s {@link ViewerAuthority}. */
 type AuthAuthority = ViewerAuthority;
@@ -44,6 +45,12 @@ interface DevPersonas {
  * user, so `@user` resolves as in production.
  */
 declare function useDevPersonas(apiBase: string): DevPersonas;
+/**
+ * The host's `auth/sign-in` action over a connected Firebase auth: each method of the request is the one call the
+ * auth surface offers for it. A provider failure keeps the kind its code names (`FIREBASE_FAILURE_KIND`); a code the
+ * table does not list is `unavailable`.
+ */
+declare function hostSignIn(auth: BrowserAuth): (request: HostSignInRequest) => Promise<HostSignInAnswer>;
 
-export { AuthProvider, useAuth, useDevPersonas, useOptionalAuth };
+export { AuthProvider, hostSignIn, useAuth, useDevPersonas, useOptionalAuth };
 export type { AuthAuthority, AuthContextValue, AuthProviderProps, DevPersonas };