@almadar/shell-web 0.0.0-stage → 1.0.0

package/dist/hooks/index.js

@@ -0,0 +1,8 @@
+"use client";
+export { SharedEntityStoreContext, createSharedEntityStore, runTickFrame, useAgentChat, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, usePreview, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useTickVisibility, useTraitListens, useUIEvents, useValidation } from '../chunk-UU57VNS2.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-PRXQGGCO.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-VO2TTLS5.js';
+export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-YHMRX6YA.js';
+import '../chunk-4YXBKHHM.js';
+import '../chunk-P4ZFUQFF.js';
+import '../chunk-G7DCAZ22.js';

package/dist/index.d.ts

@@ -0,0 +1,408 @@
+import { KernelModule, KernelServerHandle, IoRequestWire, IoAnswerWire } from '@almadar/shell-runtime/kernel/wire';
+export * from '@almadar/shell-runtime/kernel/wire';
+export * from '@almadar/shell-runtime/kernel/decode';
+import { SecretPorts } from '@almadar/shell-runtime/kernel/secret-ports';
+export * from '@almadar/shell-runtime/kernel/secret-ports';
+export * from '@almadar/shell-runtime/credentials/vault';
+export * from '@almadar/shell-runtime/credentials/scope';
+export * from '@almadar/shell-runtime/effects/in-flight-calls';
+import { OsHostPort } from '@almadar/shell-runtime/kernel/os-port';
+export * from '@almadar/shell-runtime/kernel/os-port';
+export * from '@almadar/shell-runtime/kernel/os-fetch-port';
+export * from '@almadar/shell-browser/kv';
+export * from '@almadar/shell-runtime/kernel/lane';
+import { KernelEngine as KernelEngine$1 } from '@almadar/shell-runtime/kernel/engine';
+export * from '@almadar/shell-runtime/kernel/engine';
+import { KernelHostPorts, KernelAnswerScope } from '@almadar/shell-runtime/kernel/host';
+export * from '@almadar/shell-runtime/kernel/host';
+import { OrbitalSchema, EventRequest, EventResponse, MountSeed, OnDeviceModelPorts, BrowserTabPort, OrbitalDefinition, UISlot, AnyPatternConfig, ResolvedPatternProps, EventSource, SExpr, RuntimeValue } from '@almadar/core';
+export * from '@almadar/shell-runtime/kernel/program-effects';
+export * from '@almadar/shell-browser/page-facts';
+export * from '@almadar/shell-runtime/effects/on-device-model';
+import { FramePostPort, FrameApplied } from '@almadar/shell-runtime/kernel/frame-applier';
+export * from '@almadar/shell-runtime/kernel/frame-applier';
+import { LocalFoldKernel } from '@almadar/shell-runtime/client/client-kernel';
+export { ClientDispatchHooks, ClientEmitOutcome, ClientKernel, ClientKernelOutcome, ClientMountHooks, ClientMountOutcome, LocalFoldKernel } from '@almadar/shell-runtime/client/client-kernel';
+export * from '@almadar/shell-runtime/loader/schema-loader';
+export * from '@almadar/shell-runtime/loader/lazy-page';
+export * from '@almadar/shell-runtime/credentials/env-vars';
+export * from '@almadar/shell-runtime/service/service-provider';
+export * from '@almadar/shell-runtime/service/default-call-service';
+export { AwaitingRegistry } from '@almadar/shell-runtime/client/awaiting';
+export { TraitMountError } from '@almadar/shell-runtime/client/trait-mount-error';
+export { dispatchDeclaredInput } from '@almadar/shell-runtime/client/declared-input-dispatch';
+export { dispatchInbound } from '@almadar/shell-runtime/client/inbound-dispatch';
+export { DEFAULT_THEME_KEY, appNavItems, inlineNavItems, sigilThemeKey } from '@almadar/shell-runtime/client/render-sigils';
+export { RollbackCause, TraitState, TransitionObserver } from '@almadar/shell-runtime/client/trait-types';
+export { StateBook, createInitialTraitState, findInitialState } from '@almadar/shell-runtime/client/state-book';
+export { CircuitStore, FrameOutcome, TraitSnapshot, createMemoryCircuitStore } from '@almadar/shell-runtime/client/circuit-store';
+export { FramesSince, LocalFoldOptions, createLocalFold, paintFrames, paintResponse, paintStates, traceResponse } from '@almadar/shell-runtime/client/local-fold';
+import { EventTransport } from '@almadar/shell-runtime/client/EventTransport';
+export { AccessTokenProvider, COMPRESSED_BODY_MIN_BYTES, EventTransport, EventTransportRegisterResult, HostDispatchListener, HttpTransportOptions, InProcessTransportOptions, OrbitalEvaluator, PushTarget, createHttpTransport, createInProcessTransport, deriveCarriesCircuitState, encodeJsonBody } from '@almadar/shell-runtime/client/EventTransport';
+export { ChannelMessage, ChannelTransportOptions, ServedChannel, TransportChannel, createChannelTransport, holdUntilServed, serveChannel } from '@almadar/shell-runtime/client/channel-transport';
+import { EffectHandlers } from '@almadar/shell-runtime/runtime/types';
+export { BindingContext, Effect, EffectHandlers, EffectResult, EntityRow, EvaluationContextExtensions, EventListener, EventPayload, IEventBus, RuntimeEvent, Unsubscribe } from '@almadar/shell-runtime/runtime/types';
+export { eventRouteKey } from '@almadar/shell-runtime/runtime/events/identity/routing';
+import { NativeMemoryPersistenceAdapter } from '@almadar/shell-runtime/persistence/native-memory';
+import { LocalKernelOptions, openLocalKernel as openLocalKernel$1 } from '@almadar/shell-runtime/runtime/evaluation/local-store-transport';
+export { LocalKernelOptions, LocalStoreTransportOptions, createLocalStoreTransport, localStorePersistence, resolveLocalRows } from '@almadar/shell-runtime/runtime/evaluation/local-store-transport';
+export { ResidenceTransportOptions, createResidenceTransport } from '@almadar/shell-runtime/runtime/evaluation/residence-transport';
+import { KernelModule as KernelModule$1 } from './providers/index.js';
+import { IndexedDbPersistence } from '@almadar/shell-browser/storage';
+export { w as wrapCallbackForEvent } from './wrapCallbackForEvent-B9QLbhxX.js';
+export { a as PERF_NAMESPACE, e as PerfDetail, f as PerfDetailValue, P as PerfEntry, c as clearPerf, p as perfEnd, g as perfGauge, b as perfStart, h as perfStore, d as perfTime, i as perfTimeAsync, j as pushPerfEntry } from './perf-Dr28-AgT.js';
+export { V as VerificationBus, b as bindEventBus, a as bindTraitStateGetter, e as ensureVerificationApi, g as getOrbitalVerification } from './verification-C5pTeMJv.js';
+export * from '@almadar/shell-runtime/events/EventBus';
+export * from '@almadar/shell-runtime/events/emit-stamp';
+import '@almadar/core/patterns';
+
+declare class KernelEngine extends KernelEngine$1 {
+    constructor(kernel: KernelModule, schemaJson: string, ports: KernelHostPorts, entityTypes?: readonly string[], forkedFrom?: KernelServerHandle);
+    static open(kernel: KernelModule, schema: OrbitalSchema, ports: KernelHostPorts): KernelEngine$1;
+}
+
+declare function answerRequest(ports: KernelHostPorts, request: IoRequestWire, scope: KernelAnswerScope): Promise<IoAnswerWire>;
+
+/**
+ * Poll-mode tick driver for a browser host: every animation frame runs `Kernel.frame(now)`, then applies the
+ * `FrameWire`. A frame still pending (folding) skips the next animation frame, so a slow fold never stacks
+ * frames; the kernel drops missed beats. The kernel orders what a frame's dispatches owe the host (EXEC-CONC-8). A hidden page pauses the kernel's clock and stops polling.
+ */
+
+interface TickKernelPort {
+    frame(nowMs: number): string | undefined;
+    framePause(): void;
+    frameResume(): void;
+    tickCount(): number;
+}
+interface VisibilityPort {
+    hidden(): boolean;
+    onChange(listener: () => void): () => void;
+}
+interface TickFramePorts {
+    kernel: TickKernelPort;
+    client: LocalFoldKernel;
+    /** Posts what fired ticks owe; `undefined` for a host with no transport (the frame then only folds locally). */
+    post: FramePostPort | undefined;
+}
+/** One host frame: `Kernel.frame(now())`, then the applier. Shared by the poll driver and by hosts that step on demand. */
+declare function runTickFrame(ports: TickFramePorts, now: () => number): Promise<FrameApplied>;
+interface TickDriverPorts extends TickFramePorts {
+    now(): number;
+    requestFrame(callback: (timestampMs: number) => void): number;
+    cancelFrame(handle: number): void;
+    visibility: VisibilityPort;
+    onApplied?(applied: FrameApplied): void;
+    onError?(error: Error): void;
+}
+interface TickDriver {
+    /** Starts polling when the kernel has ticks and the page is visible; a no-op otherwise. Call again after ticks mount. */
+    start(): void;
+    stop(): void;
+}
+declare function createTickDriver(ports: TickDriverPorts): TickDriver;
+
+/** A row store held by the kernel itself (its `MemoryStore`): what a host with no browser database keeps rows in. */
+declare function nativeMemoryPersistence(kernel: KernelModule): NativeMemoryPersistenceAdapter;
+
+declare function openLocalKernel(options: LocalKernelOptions): ReturnType<typeof openLocalKernel$1>;
+
+/**
+ * The browser store of a program's `[persistent: x, browser]` entities, opened once, and the in-process transport its legs run through. The runtime
+ * host (`useBrowserStore`) and compiled static clients both open it here.
+ */
+
+/** One browser database per app and viewer locale, so a visitor's records stay in one language. */
+declare function browserStoreName(appName: string, locale: string | undefined): string;
+/** Open the store; `null` when no entity is browser-stored. */
+declare function openBrowserStore(databaseName: string, orbitals: readonly OrbitalDefinition[], factory?: IDBFactory): Promise<IndexedDbPersistence | null>;
+interface BrowserStoreTransportOptions {
+    databaseName: string;
+    schema: OrbitalSchema;
+    /** The initialised `@almadar/kernel` module the store's legs run on. */
+    kernel: KernelModule$1;
+    factory?: IDBFactory;
+    /** The viewer's locale: a first visit starts with the entity's `instances` written for it. */
+    locale?: string;
+    /** Answers the program's calls to browser-only services (the client's web-hosted integrations). */
+    callService?: EffectHandlers['callService'];
+    /** The secret, random and credential ports of a leg (`createBrowserSecretPorts`). */
+    secretPorts?: SecretPorts;
+    /** The host's `os` port (`createFetchOsHost(fetch)`); absent, every `os` ask of a leg is denied. */
+    os?: OsHostPort;
+}
+declare function openBrowserStoreTransport(options: BrowserStoreTransportOptions): Promise<EventTransport>;
+/**
+ * A compiled client's bundled `browserSchema.json`, served on the kernel like any local host. The program is the
+ * resolved `orb` output: the kernel validates it when it registers, so the host does not parse it again.
+ */
+declare function openBundledBrowserStore(schema: OrbitalSchema, kernel: KernelModule$1, locale?: string, callService?: EffectHandlers['callService'], secretPorts?: SecretPorts, os?: OsHostPort): Promise<EventTransport>;
+interface BrowserHostOptions {
+    databaseName: string;
+    schema: OrbitalSchema;
+    /** Answers every `call-service` of the program (the host's browser integrations). */
+    callService: EffectHandlers['callService'];
+    /** The secret, random and credential ports of the program (`createBrowserSecretPorts`). */
+    secretPorts?: SecretPorts;
+    /** The on-device model and embedder `browser/prompt` and `browser/embed` ask (the host plugs its Prompt API and embedder in here). */
+    onDevice?: OnDeviceModelPorts;
+    /** The initialised `@almadar/kernel` module the program runs on; this host answers its I/O. */
+    kernel: KernelModule$1;
+    /** The browser's tabs for the `browser/tab-*` effects; absent, a tab ask fails `unavailable`. */
+    tabs?: BrowserTabPort;
+    /** The host's `os` port (`createFetchOsHost(fetch)`): the browser's only os operation is `os/fetch`; absent, every `os` ask is denied. */
+    os?: OsHostPort;
+    factory?: IDBFactory;
+    /** The viewer's locale: a first visit starts with the entity's `instances` written for it. */
+    locale?: string;
+}
+/** A declared input the host ran, with its result; no view asked for it. */
+type InputDispatchListener = (orbital: string, request: EventRequest, response: EventResponse) => void;
+interface BrowserHost extends EventTransport {
+    /** Hear every declared input and tick firing the host runs (e.g. a watched page element), to show it in open views. */
+    onInputDispatched(listener: InputDispatchListener): () => void;
+    /** The kernel's mounts for a client opening `routePath` (EXEC-ENDPOINT-3). */
+    routeMounts(routePath: string): MountSeed[];
+    /** Stop the program's ticks. */
+    close(): void;
+}
+/**
+ * Host a whole program in a browser context with no server (an extension's service worker): its
+ * browser-stored entities in IndexedDB, any other rows in memory, and every `call-service` answered
+ * by `callService`. The host holds the circuit state itself.
+ */
+declare function openBrowserHost(options: BrowserHostOptions): Promise<BrowserHost>;
+
+/**
+ * Runtime contract enforcement for renderer implementations.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Error thrown when a renderer implementation violates the
+ * `@almadar/runtime/ui` contract (e.g. a `SlotManager` is missing required
+ * methods).
+ */
+declare class RendererContractViolationError extends Error {
+    constructor(message: string);
+}
+/**
+ * Structured error returned by {@link validateSlotContent} when a slot content
+ * value does not satisfy the runtime contract.
+ */
+interface SlotContentValidationError {
+    /** Human-readable error message. */
+    readonly message: string;
+    /** Dotted path to the offending field, or `'.'` for the root value. */
+    readonly path: string;
+}
+
+/**
+ * Renderer-agnostic slot contract.
+ *
+ * Any UI library (React, Web Components, Vue, etc.) that wants to render an
+ * Almadar orbital schema must provide an implementation of {@link SlotManager}.
+ * The runtime itself is UI-framework blind: it only knows about UISlots and
+ * pattern configs from @almadar/core.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Metadata that attributes a slot write to the trait/transition that produced it.
+ *
+ * Mirrors the shape previously in `@almadar/ui/types/slot-types`, but grounded
+ * entirely in `@almadar/core` types so the contract lives in the runtime layer.
+ */
+interface SlotSource extends EventSource {
+    /** Trait that emitted the render-ui effect. */
+    trait: string;
+    /** State the trait was in when the effect fired. */
+    state: string;
+    /** Transition (or tick) that carried the effect. */
+    transition: string;
+    /** Effects executed during the transition. */
+    effects: SExpr[];
+}
+/**
+ * One unit of content the runtime asks a renderer to place in a named slot.
+ *
+ * A `null` pattern means "clear this slot". Optional `props` carry resolved
+ * pattern props (e.g. from a render-ui effect's 4th tuple element). `source`
+ * is optional metadata for debug/verification attribution.
+ */
+interface SlotContent {
+    /** Target UI slot from the core UISlot union. */
+    slot: UISlot;
+    /** Pattern config to render, or null to clear the slot. */
+    pattern: AnyPatternConfig | null;
+    /** Resolved props merged on top of the pattern config. */
+    props?: ResolvedPatternProps;
+    /** Attribution metadata for tracing/debugging. */
+    source?: SlotSource;
+}
+/**
+ * Minimal slot-management contract every UI renderer must satisfy.
+ *
+ * The runtime's client effect handlers call `setContent`/`clearSlot` in
+ * response to `render-ui` effects. The renderer owns the actual DOM/
+ * component-tree update, subscription handling, and multi-source merging
+ * policy (e.g. stacking N trait writes into one synthetic container).
+ */
+interface SlotManager {
+    /** Return the latest content for a slot, or undefined if empty. */
+    getContent(slot: UISlot): SlotContent | undefined;
+    /** Place (or replace) content for a slot. */
+    setContent(content: SlotContent): void;
+    /** Clear a slot by writing a null pattern. */
+    clearSlot(slot: UISlot): void;
+    /** Snapshot of all currently populated slots. */
+    getAllSlots(): ReadonlyMap<UISlot, SlotContent>;
+    /** Subscribe to slot changes. Returns an unsubscribe function. */
+    subscribe(listener: (slot: UISlot, content: SlotContent | undefined) => void): () => void;
+}
+/**
+ * Extended slot manager contract that supports the multi-source aggregation
+ * and per-trait sidecar model used by the React `useUISlots` implementation.
+ *
+ * Renderers that need to support `@trait.X` embedding and multiple traits
+ * writing the same slot should implement this interface. The base
+ * {@link SlotManager} remains the minimal contract for simple renderers.
+ */
+interface MultiSourceSlotManager extends SlotManager {
+    /** Return the latest content a given trait rendered, or undefined if none. */
+    getTraitContent(traitName: string): SlotContent | undefined;
+    /** Subscribe to changes in a specific trait's render output. */
+    subscribeTrait(traitName: string, listener: (content: SlotContent | undefined) => void): () => void;
+    /**
+     * Update the per-trait sidecar without writing to a slot.
+     *
+     * Used for embed-aware routing: when a trait is referenced via `@trait.X` by
+     * a sibling layout, its render output should not stack into the layout's
+     * slot; instead the layout embeds the trait's frame and the sidecar keeps
+     * the trait's latest frame queryable.
+     */
+    updateTraitContent(traitName: string, content: Omit<SlotContent, 'source'>): void;
+}
+/**
+ * Aggregate a slot's per-source content map into a single {@link SlotContent}.
+ *
+ * - 0 sources → `undefined` (empty slot).
+ * - 1 source → that source's content verbatim.
+ * - 2+ sources → a synthetic `stack` wrapper whose `children` are the
+ *   pattern configs of each source in insertion order.
+ *
+ * This mirrors the React `useUISlots` aggregation behavior and is provided so
+ * every renderer implements the same multi-source semantics.
+ */
+declare function aggregateSlotContent(slot: UISlot, sources: ReadonlyMap<string, SlotContent>): SlotContent | undefined;
+
+/**
+ * Assert that a value satisfies the {@link SlotManager} contract at runtime.
+ *
+ * @throws RendererContractViolationError when the value is not a valid manager.
+ */
+declare function assertIsSlotManager(value: RuntimeValue): asserts value is SlotManager;
+/**
+ * Assert that a value satisfies the {@link MultiSourceSlotManager} contract.
+ *
+ * @throws RendererContractViolationError when the value is not a valid manager.
+ */
+declare function assertIsMultiSourceSlotManager(value: RuntimeValue): asserts value is MultiSourceSlotManager;
+/**
+ * Validate that a {@link SlotContent} value satisfies the runtime contract.
+ *
+ * Returns an array of validation errors; an empty array means the value is
+ * valid. This lets renderer authors surface contract failures without
+ * exceptions.
+ */
+declare function validateSlotContent(content: SlotContent): SlotContentValidationError[];
+/**
+ * Minimal adapter that turns a `SlotManager` into the shape expected by
+ * {@link createClientEffectHandlers} in `ClientEffectHandlers.ts`.
+ *
+ * This keeps the legacy `SlotSetter.addPattern/clearSlot` surface working while
+ * nudging new renderers toward the fuller `SlotManager` contract.
+ */
+declare function createSlotSetter(manager: SlotManager): {
+    addPattern: (slot: string, pattern: AnyPatternConfig, props?: ResolvedPatternProps) => void;
+    clearSlot: (slot: string) => void;
+};
+
+/**
+ * Build the `trait name → owning orbital` map used to form the qualified
+ * `UI:<orbital>.<trait>.<event>` bus keys that trait state machines subscribe
+ * to. Pure + dependency-free so it can be unit-tested without a render.
+ *
+ * Critically, it backfills from the RESOLVED page bindings, not just the source
+ * `schema.orbitals[].traits`. An auto-pulled sibling trait (e.g. an embedded
+ * `@trait.X` calendar lifted into the orbital by the compiler's sibling-pull)
+ * is absent from the source orbital's `traits[]`, so a source-only map misses
+ * it — leaving its self-subscription unregistered and its own fetch-success
+ * (e.g. `CalendarEventLoaded`) unheard, so the trait sticks in `loading`. A
+ * pulled sibling lands in the same orbital as the page that references it, so
+ * we backfill from the resolved page's owning orbital. Source-declared mappings
+ * win; the IR only fills gaps.
+ */
+interface ResolvedPageTraits {
+    /** Page route path, matched against the source orbital's page paths. */
+    path?: string;
+    /** Resolved trait names mounted on the page (includes pulled siblings). */
+    traitNames: readonly string[];
+}
+/**
+ * Minimal trait-ref shape the mapper actually reads. Structurally widens
+ * `TraitRef` so tests and partial schemas don't have to satisfy every required
+ * inline-trait field (e.g. `scope`) that the mapper never touches.
+ */
+type OrbitalsByTraitTraitInput = string | {
+    ref?: string;
+    name?: string;
+};
+/**
+ * Minimal schema shape the mapper actually reads. Kept local because the
+ * function only needs `orbitals[].{name,traits,pages}`; the full
+ * `OrbitalSchema` carries many more required fields.
+ */
+interface OrbitalsByTraitInput {
+    orbitals: ReadonlyArray<{
+        name: string;
+        traits?: ReadonlyArray<OrbitalsByTraitTraitInput>;
+        pages?: ReadonlyArray<string | {
+            path?: string;
+        }>;
+    }>;
+}
+declare function buildOrbitalsByTrait(schema: OrbitalsByTraitInput | undefined, resolvedPages?: ReadonlyArray<ResolvedPageTraits>): Record<string, string>;
+
+/**
+ * Embed-aware slot routing — static analysis pass.
+ *
+ * Walks every trait's `transitions[].effects` looking for `render-ui`
+ * patterns whose tree contains `@trait.<Name>` string literals. Returns
+ * the flat set of trait names that are referenced this way by some
+ * sibling layout.
+ *
+ * Used by `<OrbPreview>` to route `applyServerEffects` — when an
+ * embedded trait's render-ui effect arrives, the runtime updates that
+ * trait's per-trait sidecar (`traitIndexRef`) only and skips the slot
+ * write. The sibling layout owns the slot and embeds the trait's frame
+ * via `<TraitFrame>`. Mirrors the compiled-path codegen which inlines
+ * the atom views as JSX inside the layout's pattern, never having them
+ * write a shared slot.
+ *
+ * The walker is a structural twin of
+ * `packages/almadar-runtime/src/entities/resolver/reference-resolver.ts`'s
+ * `renameEventsInRenderUiConfig` — same recursive pattern shape, just
+ * collecting `@trait.X` substrings instead of renaming events.
+ *
+ * @packageDocumentation
+ */
+
+declare function collectEmbeddedTraits(schema: OrbitalSchema | undefined | null): ReadonlySet<string>;
+
+/** The `browserPrompt` and `browserEmbed` handlers over a host's ports; absent ports answer `unconfigured`. */
+declare function onDeviceHandlers(ports: OnDeviceModelPorts | undefined): Pick<EffectHandlers, 'browserPrompt' | 'browserEmbed'>;
+
+export { KernelEngine, RendererContractViolationError, aggregateSlotContent, answerRequest, assertIsMultiSourceSlotManager, assertIsSlotManager, browserStoreName, buildOrbitalsByTrait, collectEmbeddedTraits, createSlotSetter, createTickDriver, nativeMemoryPersistence, onDeviceHandlers, openBrowserHost, openBrowserStore, openBrowserStoreTransport, openBundledBrowserStore, openLocalKernel, runTickFrame, validateSlotContent };
+export type { BrowserHost, BrowserHostOptions, BrowserStoreTransportOptions, InputDispatchListener, MultiSourceSlotManager, ResolvedPageTraits, SlotContent, SlotContentValidationError, SlotManager, SlotSource, TickDriver, TickDriverPorts, TickFramePorts, TickKernelPort, VisibilityPort };

package/dist/index.js

@@ -0,0 +1,178 @@
+"use client";
+import { runTickFrame, createTickDriver } from './chunk-AU7O65OX.js';
+export { createTickDriver, runTickFrame } from './chunk-AU7O65OX.js';
+import { wrapCallbackForEvent, validateSlotContent, local_store_transport_exports, pushPerfEntry, perfTimeAsync, perfTime, perfStore, perfStart, perfGauge, perfEnd, openLocalKernel, openBundledBrowserStore, openBrowserStoreTransport, openBrowserStore, openBrowserHost, nativeMemoryPersistence, getOrbitalVerification, eventRouteKey, ensureVerificationApi, createSlotSetter, createResidenceTransport, collectEmbeddedTraits, clearPerf, buildOrbitalsByTrait, browserStoreName, bindTraitStateGetter, bindEventBus, assertIsSlotManager, assertIsMultiSourceSlotManager, aggregateSlotContent, RendererContractViolationError, PERF_NAMESPACE, webHostActions } from './chunk-3VZ36ZKO.js';
+export { PERF_NAMESPACE, RendererContractViolationError, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, browserStoreName, buildOrbitalsByTrait, clearPerf, collectEmbeddedTraits, createResidenceTransport, createSlotSetter, ensureVerificationApi, eventRouteKey, getOrbitalVerification, nativeMemoryPersistence, openBrowserHost, openBrowserStore, openBrowserStoreTransport, openBundledBrowserStore, openLocalKernel, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, pushPerfEntry, validateSlotContent, wrapCallbackForEvent } from './chunk-3VZ36ZKO.js';
+import { __export, __reExport } from './chunk-G7DCAZ22.js';
+export * from '@almadar/shell-runtime/kernel/wire';
+export * from '@almadar/shell-runtime/kernel/decode';
+export * from '@almadar/shell-runtime/kernel/secret-ports';
+export * from '@almadar/shell-runtime/credentials/vault';
+export * from '@almadar/shell-runtime/credentials/scope';
+export * from '@almadar/shell-runtime/effects/in-flight-calls';
+export * from '@almadar/shell-runtime/kernel/os-port';
+export * from '@almadar/shell-runtime/kernel/os-fetch-port';
+import * as kv_star from '@almadar/shell-browser/kv';
+export * from '@almadar/shell-runtime/kernel/lane';
+import * as engine_star from '@almadar/shell-runtime/kernel/engine';
+import { KernelEngine as KernelEngine$1 } from '@almadar/shell-runtime/kernel/engine';
+import * as page_facts_star from '@almadar/shell-browser/page-facts';
+import { readPageFacts } from '@almadar/shell-browser/page-facts';
+import * as host_star from '@almadar/shell-runtime/kernel/host';
+import { answerRequest as answerRequest$1 } from '@almadar/shell-runtime/kernel/host';
+export * from '@almadar/shell-runtime/kernel/program-effects';
+import { embedOnDevice, promptOnDevice } from '@almadar/shell-runtime/effects/on-device-model';
+export * from '@almadar/shell-runtime/effects/on-device-model';
+export * from '@almadar/shell-runtime/kernel/frame-applier';
+export * from '@almadar/shell-runtime/loader/schema-loader';
+export * from '@almadar/shell-runtime/loader/lazy-page';
+export * from '@almadar/shell-runtime/credentials/env-vars';
+export * from '@almadar/shell-runtime/service/service-provider';
+export * from '@almadar/shell-runtime/service/default-call-service';
+import { AwaitingRegistry } from '@almadar/shell-runtime/client/awaiting';
+export { AwaitingRegistry } from '@almadar/shell-runtime/client/awaiting';
+import { TraitMountError } from '@almadar/shell-runtime/client/trait-mount-error';
+export { TraitMountError } from '@almadar/shell-runtime/client/trait-mount-error';
+import { dispatchDeclaredInput } from '@almadar/shell-runtime/client/declared-input-dispatch';
+export { dispatchDeclaredInput } from '@almadar/shell-runtime/client/declared-input-dispatch';
+import { dispatchInbound } from '@almadar/shell-runtime/client/inbound-dispatch';
+export { dispatchInbound } from '@almadar/shell-runtime/client/inbound-dispatch';
+import { sigilThemeKey, inlineNavItems, appNavItems, DEFAULT_THEME_KEY } from '@almadar/shell-runtime/client/render-sigils';
+export { DEFAULT_THEME_KEY, appNavItems, inlineNavItems, sigilThemeKey } from '@almadar/shell-runtime/client/render-sigils';
+import { findInitialState, createInitialTraitState, StateBook } from '@almadar/shell-runtime/client/state-book';
+export { StateBook, createInitialTraitState, findInitialState } from '@almadar/shell-runtime/client/state-book';
+import { createMemoryCircuitStore } from '@almadar/shell-runtime/client/circuit-store';
+export { createMemoryCircuitStore } from '@almadar/shell-runtime/client/circuit-store';
+import { traceResponse, paintStates, paintResponse, paintFrames, createLocalFold } from '@almadar/shell-runtime/client/local-fold';
+export { createLocalFold, paintFrames, paintResponse, paintStates, traceResponse } from '@almadar/shell-runtime/client/local-fold';
+import { encodeJsonBody, deriveCarriesCircuitState, createInProcessTransport, createHttpTransport, COMPRESSED_BODY_MIN_BYTES } from '@almadar/shell-runtime/client/EventTransport';
+export { COMPRESSED_BODY_MIN_BYTES, createHttpTransport, createInProcessTransport, deriveCarriesCircuitState, encodeJsonBody } from '@almadar/shell-runtime/client/EventTransport';
+import { serveChannel, holdUntilServed, createChannelTransport } from '@almadar/shell-runtime/client/channel-transport';
+export { createChannelTransport, holdUntilServed, serveChannel } from '@almadar/shell-runtime/client/channel-transport';
+export * from '@almadar/shell-runtime/events/EventBus';
+export * from '@almadar/shell-runtime/events/emit-stamp';
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  AwaitingRegistry: () => AwaitingRegistry,
+  COMPRESSED_BODY_MIN_BYTES: () => COMPRESSED_BODY_MIN_BYTES,
+  DEFAULT_THEME_KEY: () => DEFAULT_THEME_KEY,
+  KernelEngine: () => KernelEngine,
+  PERF_NAMESPACE: () => PERF_NAMESPACE,
+  RendererContractViolationError: () => RendererContractViolationError,
+  StateBook: () => StateBook,
+  TraitMountError: () => TraitMountError,
+  aggregateSlotContent: () => aggregateSlotContent,
+  answerRequest: () => answerRequest,
+  appNavItems: () => appNavItems,
+  assertIsMultiSourceSlotManager: () => assertIsMultiSourceSlotManager,
+  assertIsSlotManager: () => assertIsSlotManager,
+  bindEventBus: () => bindEventBus,
+  bindTraitStateGetter: () => bindTraitStateGetter,
+  browserStoreName: () => browserStoreName,
+  buildOrbitalsByTrait: () => buildOrbitalsByTrait,
+  clearPerf: () => clearPerf,
+  collectEmbeddedTraits: () => collectEmbeddedTraits,
+  createChannelTransport: () => createChannelTransport,
+  createHttpTransport: () => createHttpTransport,
+  createInProcessTransport: () => createInProcessTransport,
+  createInitialTraitState: () => createInitialTraitState,
+  createLocalFold: () => createLocalFold,
+  createLocalStoreTransport: () => local_store_transport_exports.createLocalStoreTransport,
+  createMemoryCircuitStore: () => createMemoryCircuitStore,
+  createResidenceTransport: () => createResidenceTransport,
+  createSlotSetter: () => createSlotSetter,
+  createTickDriver: () => createTickDriver,
+  deriveCarriesCircuitState: () => deriveCarriesCircuitState,
+  dispatchDeclaredInput: () => dispatchDeclaredInput,
+  dispatchInbound: () => dispatchInbound,
+  encodeJsonBody: () => encodeJsonBody,
+  ensureVerificationApi: () => ensureVerificationApi,
+  eventRouteKey: () => eventRouteKey,
+  findInitialState: () => findInitialState,
+  getOrbitalVerification: () => getOrbitalVerification,
+  holdUntilServed: () => holdUntilServed,
+  inlineNavItems: () => inlineNavItems,
+  localStorePersistence: () => local_store_transport_exports.localStorePersistence,
+  nativeMemoryPersistence: () => nativeMemoryPersistence,
+  onDeviceHandlers: () => onDeviceHandlers,
+  openBrowserHost: () => openBrowserHost,
+  openBrowserStore: () => openBrowserStore,
+  openBrowserStoreTransport: () => openBrowserStoreTransport,
+  openBundledBrowserStore: () => openBundledBrowserStore,
+  openLocalKernel: () => openLocalKernel,
+  paintFrames: () => paintFrames,
+  paintResponse: () => paintResponse,
+  paintStates: () => paintStates,
+  perfEnd: () => perfEnd,
+  perfGauge: () => perfGauge,
+  perfStart: () => perfStart,
+  perfStore: () => perfStore,
+  perfTime: () => perfTime,
+  perfTimeAsync: () => perfTimeAsync,
+  pushPerfEntry: () => pushPerfEntry,
+  resolveLocalRows: () => local_store_transport_exports.resolveLocalRows,
+  runTickFrame: () => runTickFrame,
+  serveChannel: () => serveChannel,
+  sigilThemeKey: () => sigilThemeKey,
+  traceResponse: () => traceResponse,
+  validateSlotContent: () => validateSlotContent,
+  wrapCallbackForEvent: () => wrapCallbackForEvent
+});
+
+// src/kernel/kv-web.ts
+var kv_web_exports = {};
+__reExport(kv_web_exports, kv_star);
+
+// src/index.ts
+__reExport(src_exports, kv_web_exports);
+
+// src/kernel/engine.ts
+var engine_exports = {};
+__export(engine_exports, {
+  KernelEngine: () => KernelEngine
+});
+__reExport(engine_exports, engine_star);
+var KernelEngine = class extends KernelEngine$1 {
+  constructor(kernel, schemaJson, ports, entityTypes = [], forkedFrom) {
+    super(kernel, schemaJson, { ...ports, pageFacts: ports.pageFacts ?? readPageFacts, hostActions: ports.hostActions ?? webHostActions }, entityTypes, forkedFrom);
+  }
+  static open(kernel, schema, ports) {
+    return KernelEngine$1.open(kernel, schema, { ...ports, pageFacts: ports.pageFacts ?? readPageFacts, hostActions: ports.hostActions ?? webHostActions });
+  }
+};
+
+// src/index.ts
+__reExport(src_exports, engine_exports);
+
+// src/kernel/host.ts
+var host_exports = {};
+__export(host_exports, {
+  answerRequest: () => answerRequest
+});
+__reExport(host_exports, host_star);
+function answerRequest(ports, request, scope) {
+  return answerRequest$1({ ...ports, pageFacts: ports.pageFacts ?? readPageFacts, hostActions: ports.hostActions ?? webHostActions }, request, scope);
+}
+
+// src/index.ts
+__reExport(src_exports, host_exports);
+
+// src/effects/page-facts.ts
+var page_facts_exports = {};
+__reExport(page_facts_exports, page_facts_star);
+
+// src/index.ts
+__reExport(src_exports, page_facts_exports);
+function onDeviceHandlers(ports) {
+  return {
+    browserPrompt: (text, schemaText, key, signal) => promptOnDevice(ports, text, schemaText, key, signal),
+    browserEmbed: (texts, key, signal) => embedOnDevice(ports, texts, key, signal)
+  };
+}
+var export_createLocalStoreTransport = local_store_transport_exports.createLocalStoreTransport;
+var export_localStorePersistence = local_store_transport_exports.localStorePersistence;
+var export_resolveLocalRows = local_store_transport_exports.resolveLocalRows;
+
+export { KernelEngine, answerRequest, export_createLocalStoreTransport as createLocalStoreTransport, export_localStorePersistence as localStorePersistence, onDeviceHandlers, export_resolveLocalRows as resolveLocalRows };