@almadar/shell-web 0.0.0-stage → 0.1.0

package/dist/hooks/index.js

@@ -0,0 +1,7 @@
+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-73SRAB4P.js';
+export { claimDelivery, keyChord, mergeCaptureTables, parseQueryBinding, useAuthContext, useCanvasGestures, useDragReorder, useKeyboardRouter, useLongPress, usePageHead, usePullToRefresh, useQuerySingleton, useSwipeGesture } from '../chunk-R5O5AUPI.js';
+export { ALMADAR_DND_MIME, useDraggable, useDropZone } from '../chunk-L2DEKY4J.js';
+export { DEFAULT_SLOTS, useUISlotManager } from '../chunk-YHMRX6YA.js';
+import '../chunk-MBQAMMSE.js';
+import '../chunk-P4ZFUQFF.js';
+import '../chunk-G7DCAZ22.js';

package/dist/index.d.ts

@@ -0,0 +1,486 @@
+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';
+export * from '@almadar/shell-runtime/kernel/beacon';
+import { HttpPorts } from '@almadar/shell-runtime/kernel/http';
+export * from '@almadar/shell-runtime/kernel/http';
+export * from '@almadar/shell-runtime/credentials/store';
+export * from '@almadar/shell-runtime/credentials/scope';
+export * from '@almadar/shell-runtime/effects/in-flight-calls';
+export * from '@almadar/shell-runtime/kernel/oauth-port';
+export * from '@almadar/shell-runtime/kernel/os-port';
+export * from '@almadar/shell-browser/kv';
+export * from '@almadar/shell-runtime/kernel/oauth-effects';
+import { DispatchLane } from '@almadar/shell-runtime/kernel/lane';
+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, PersistenceAdapter, UserContext, OrbitalEventRequest, OrbitalEventResponse, MountSeed, OnDeviceModelPorts, BrowserTabPort, MessageCatalogs, OrbitalDefinition, RuntimeValue, UISlot, AnyPatternConfig, ResolvedPatternProps, EventSource, SExpr, ResolvedTrait, ResolvedIR } 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, 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/http-loader';
+export * from '@almadar/shell-runtime/loader/lazy-page';
+export * from '@almadar/shell-runtime/credentials/env-vars';
+export * from '@almadar/shell-runtime/credentials/seed';
+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, findMatchingTransitions, findTransition } from '@almadar/shell-runtime/client/state-book';
+export { CircuitStore, TraitSnapshot, createMemoryCircuitStore } from '@almadar/shell-runtime/client/circuit-store';
+export { LocalFoldOptions, createLocalFold, mirrorResponse, 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, BrowserFileMeta, BrowserFilePickerOptions, BrowserGeolocationOptions, BrowserGeolocationPosition, ConfigContext, Effect, EffectContext, EffectHandlers, EffectResult, EntityRow, EvaluationContextExtensions, EventListener, EventPayload, ExecutionEnvironment, HANDLER_MANIFEST, HttpEffectReport, IEventBus, RuntimeConfig, RuntimeEvent, TransitionResult, Unsubscribe, isEffectTuple } from '@almadar/shell-runtime/runtime/types';
+export { TickHandle, TickScheduler, createTickScheduler } from '@almadar/shell-runtime/runtime/time/TickScheduler';
+export { CronFields, cronMatches, cronMinuteKey, isValidCronExpression, parseCron, parseCronField } from '@almadar/shell-runtime/runtime/time/cron';
+export { isValidDurationString, parseDurationString } from '@almadar/shell-runtime/runtime/time/duration';
+export { ListenSourceDescriptor, RouteSourceMeta, buildSourceMatcher, eventRouteKey, parseListenSource } from '@almadar/shell-runtime/runtime/events/identity/routing';
+export { buildTraitIndex } from '@almadar/shell-runtime/runtime/traits/trait-index';
+export { CollectedListenerTarget, collectListenerTargets } from '@almadar/shell-runtime/runtime/traits/listen-targets';
+export { ParsedOrbitalTraits, parseOrbitalTraits } from '@almadar/shell-runtime/runtime/traits/OrbitalTraitParsing';
+import { BrowserSeedHost } from '@almadar/shell-runtime/runtime/entities/seedBrowserStore';
+export { seedBrowserStore } from '@almadar/shell-runtime/runtime/entities/seedBrowserStore';
+import { MockSeedHost } from '@almadar/shell-runtime/runtime/entities/mockStoreSeed';
+export { MockSeedHost, MockSeedViewer, MockSeeded, bindDeclaredCollections, restampMockOwner, seedMockStore } from '@almadar/shell-runtime/runtime/entities/mockStoreSeed';
+export { MockSeedEngine, SeedOwnerJournal, StdMockSeed, readSeededStores } from '@almadar/shell-runtime/runtime/entities/std-mock-seed';
+import { KernelModule as KernelModule$1, SeedProgramLoader } from './providers/index.js';
+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 { IndexedDbPersistence } from '@almadar/shell-browser/storage';
+import * as index$1 from '@almadar/shell-runtime/runtime/effects/composition/index';
+export { ComposeBehaviorsInput, ComposeBehaviorsResult, EventWiringEntry, LayoutStrategy, PipeStep, applyEventWiring, composeBehaviors, detectLayoutStrategy, pipeBehaviors } from '@almadar/shell-runtime/runtime/effects/composition/index';
+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';
+export * from '@almadar/shell-runtime/client/ServerBridge';
+import '@almadar/core/patterns';
+
+function _mergeNamespaces(n, m) {
+  m.forEach(function (e) {
+    e && typeof e !== 'string' && !Array.isArray(e) && Object.keys(e).forEach(function (k) {
+      if (k !== 'default' && !(k in n)) {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  });
+  return Object.freeze(n);
+}
+
+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 takes one `DispatchLane` turn,
+ * runs `Kernel.frame(now)` inside it, then applies the `FrameWire`. A frame still pending (waiting on
+ * the lane or folding) skips the next animation frame, so a stalled lane never stacks frames; the
+ * kernel drops missed beats. 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;
+    lane: DispatchLane;
+    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: a lane turn around `Kernel.frame(now())` (read once the lane is held), 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;
+
+/**
+ * The web host's side of the native `std-mock-seed` program: it opens the program on a kernel of its own (a browser
+ * store is seeded before the app's kernel exists) or forks it off the app's kernel (a mock store shares the app's
+ * entity and policy metadata), and hands the seeder to the shared seed rules in `@almadar/shell-runtime`.
+ *
+ * @packageDocumentation
+ */
+
+/** Where a browser store gets the seed program: the kernel and language it runs on and the loader that resolves the program. */
+interface BrowserStoreSeeding {
+    kernel: KernelModule$1;
+    language: string;
+    loadSeedProgram: SeedProgramLoader;
+    /** The app being seeded: its composition of std-mock-seed, if any, sets the declared seeding values. */
+    app: OrbitalSchema;
+}
+/** Run `use` with a browser-store seed host; the seed program opens on first ask and is released after. */
+declare function withBrowserSeeder<T>(seeding: BrowserStoreSeeding, use: (host: BrowserSeedHost) => Promise<T>): Promise<T>;
+/** Run `use` with a mock-store seed host whose seed program is forked off `app`; the fork is released after. */
+declare function withForkedSeeder<T>(app: KernelEngine, appSchema: OrbitalSchema, loadSeedProgram: SeedProgramLoader, persistence: PersistenceAdapter, user: UserContext | undefined, use: (host: MockSeedHost) => Promise<T>): Promise<T>;
+
+/** 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 and
+ * seeded 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 and seed the store; `null` when no entity is browser-stored. */
+declare function openBrowserStore(databaseName: string, orbitals: readonly OrbitalDefinition[], seeding: BrowserStoreSeeding, factory?: IDBFactory, locale?: string): Promise<IndexedDbPersistence | null>;
+interface BrowserStoreTransportOptions {
+    databaseName: string;
+    schema: OrbitalSchema;
+    /** The initialised `@almadar/kernel` module the store's legs run on. */
+    kernel: KernelModule$1;
+    /** The language bundle as JSON (`LanguageBundle`) the kernel is opened with: a browser has no `node_modules` to read it from. */
+    language: string;
+    /** Resolves the std mock-seed program that seeds the store when it is first opened. */
+    loadSeedProgram: SeedProgramLoader;
+    factory?: IDBFactory;
+    /** The viewer's locale: picks the entity's rows for it when the store is first seeded. */
+    locale?: string;
+    /** Answers the program's calls to browser-only services (the client's web-hosted integrations). */
+    callService?: EffectHandlers['callService'];
+    /** What a leg's client-site `http` runs on (`createBrowserHttpPorts`). */
+    http?: HttpPorts;
+    /** The program's message catalogs, so a leg's `i18n/t` resolves for the request's locale. */
+    messages?: MessageCatalogs;
+}
+declare function openBrowserStoreTransport(options: BrowserStoreTransportOptions): Promise<EventTransport>;
+/**
+ * A compiled client's bundled `browserSchema.json`, parsed by this runtime's own core (the client's core may predate
+ * the browser-storage fields), served on the kernel like any local host.
+ */
+declare function openBundledBrowserStore(bundled: RuntimeValue, kernel: KernelModule$1, language: string, loadSeedProgram: SeedProgramLoader, locale?: string, callService?: EffectHandlers['callService'], messages?: MessageCatalogs, http?: HttpPorts): Promise<EventTransport>;
+interface BrowserHostOptions {
+    databaseName: string;
+    schema: OrbitalSchema;
+    /** Answers every `call-service` of the program (the host's browser integrations). */
+    callService: EffectHandlers['callService'];
+    /** What the program's client-site `http` effects run on (`createBrowserHttpPorts`). */
+    http?: HttpPorts;
+    /** 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 language bundle as JSON (`LanguageBundle`) the kernel is opened with: a browser has no `node_modules` to read it from. */
+    language: string;
+    /** Resolves the std mock-seed program that seeds the store when it is first opened. */
+    loadSeedProgram: SeedProgramLoader;
+    /** The browser's tabs for the `browser/tab-*` effects; absent, a tab ask fails `unavailable`. */
+    tabs?: BrowserTabPort;
+    factory?: IDBFactory;
+    locale?: string;
+}
+/** A declared input the host ran, with its result; no view asked for it. */
+type InputDispatchListener = (orbital: string, request: OrbitalEventRequest, response: OrbitalEventResponse) => 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>;
+
+var index = /*#__PURE__*/_mergeNamespaces({
+  __proto__: null
+}, [index$1]);
+
+/**
+ * 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[];
+    /** Resolved trait definition that owns the transition (optional attribution). */
+    traitDefinition?: ResolvedTrait;
+}
+/**
+ * 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>;
+
+/**
+ * Trait → linked record for entity-schema enrichment. A page binding's record (call-site rebind)
+ * comes first; every other resolved trait — an embedded one is on no page — maps to its own.
+ *
+ * @packageDocumentation
+ */
+
+declare function buildTraitLinkedEntities(ir: Pick<ResolvedIR, 'traits' | 'pages'>): Map<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 collectTraitRefsFromResolvedTrait(trait: ResolvedTrait): Set<string>;
+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, buildTraitLinkedEntities, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, index as composition, createSlotSetter, createTickDriver, nativeMemoryPersistence, onDeviceHandlers, openBrowserHost, openBrowserStore, openBrowserStoreTransport, openBundledBrowserStore, openLocalKernel, runTickFrame, validateSlotContent, withBrowserSeeder, withForkedSeeder };
+export type { BrowserHost, BrowserHostOptions, BrowserStoreSeeding, BrowserStoreTransportOptions, InputDispatchListener, MultiSourceSlotManager, ResolvedPageTraits, SlotContent, SlotContentValidationError, SlotManager, SlotSource, TickDriver, TickDriverPorts, TickFramePorts, TickKernelPort, VisibilityPort };

package/dist/index.js

@@ -0,0 +1,38 @@
+export { AwaitingRegistry, COMPRESSED_BODY_MIN_BYTES, DEFAULT_THEME_KEY, KernelEngine, StateBook, TraitMountError, answerRequest, appNavItems, createChannelTransport, createHttpTransport, createInProcessTransport, createInitialTraitState, createLocalFold, createMemoryCircuitStore, createTickDriver, deriveCarriesCircuitState, dispatchDeclaredInput, dispatchInbound, encodeJsonBody, findInitialState, findMatchingTransitions, findTransition, holdUntilServed, inlineNavItems, mirrorResponse, onDeviceHandlers, runTickFrame, serveChannel, sigilThemeKey, traceResponse } from './chunk-6P3MWXYE.js';
+import { types_exports, std_mock_seed_exports, TickScheduler_exports, composition_exports, mockStoreSeed_exports, routing_exports, trait_index_exports, listen_targets_exports, local_store_transport_exports, residence_transport_exports, cron_exports, duration_exports, OrbitalTraitParsing_exports, seedBrowserStore_exports } from './chunk-DYEKAA4L.js';
+export { PERF_NAMESPACE, RendererContractViolationError, aggregateSlotContent, assertIsMultiSourceSlotManager, assertIsSlotManager, bindEventBus, bindTraitStateGetter, browserStoreName, buildOrbitalsByTrait, buildTraitLinkedEntities, clearPerf, collectEmbeddedTraits, collectTraitRefsFromResolvedTrait, composition_exports as composition, createSlotSetter, ensureVerificationApi, getOrbitalVerification, nativeMemoryPersistence, openBrowserHost, openBrowserStore, openBrowserStoreTransport, openBundledBrowserStore, openLocalKernel, perfEnd, perfGauge, perfStart, perfStore, perfTime, perfTimeAsync, pushPerfEntry, validateSlotContent, withBrowserSeeder, withForkedSeeder, wrapCallbackForEvent } from './chunk-DYEKAA4L.js';
+import './chunk-G7DCAZ22.js';
+
+var export_HANDLER_MANIFEST = types_exports.HANDLER_MANIFEST;
+var export_StdMockSeed = std_mock_seed_exports.StdMockSeed;
+var export_TickScheduler = TickScheduler_exports.TickScheduler;
+var export_applyEventWiring = composition_exports.applyEventWiring;
+var export_bindDeclaredCollections = mockStoreSeed_exports.bindDeclaredCollections;
+var export_buildSourceMatcher = routing_exports.buildSourceMatcher;
+var export_buildTraitIndex = trait_index_exports.buildTraitIndex;
+var export_collectListenerTargets = listen_targets_exports.collectListenerTargets;
+var export_composeBehaviors = composition_exports.composeBehaviors;
+var export_createLocalStoreTransport = local_store_transport_exports.createLocalStoreTransport;
+var export_createResidenceTransport = residence_transport_exports.createResidenceTransport;
+var export_createTickScheduler = TickScheduler_exports.createTickScheduler;
+var export_cronMatches = cron_exports.cronMatches;
+var export_cronMinuteKey = cron_exports.cronMinuteKey;
+var export_detectLayoutStrategy = composition_exports.detectLayoutStrategy;
+var export_eventRouteKey = routing_exports.eventRouteKey;
+var export_isEffectTuple = types_exports.isEffectTuple;
+var export_isValidCronExpression = cron_exports.isValidCronExpression;
+var export_isValidDurationString = duration_exports.isValidDurationString;
+var export_localStorePersistence = local_store_transport_exports.localStorePersistence;
+var export_parseCron = cron_exports.parseCron;
+var export_parseCronField = cron_exports.parseCronField;
+var export_parseDurationString = duration_exports.parseDurationString;
+var export_parseListenSource = routing_exports.parseListenSource;
+var export_parseOrbitalTraits = OrbitalTraitParsing_exports.parseOrbitalTraits;
+var export_pipeBehaviors = composition_exports.pipeBehaviors;
+var export_readSeededStores = std_mock_seed_exports.readSeededStores;
+var export_resolveLocalRows = local_store_transport_exports.resolveLocalRows;
+var export_restampMockOwner = mockStoreSeed_exports.restampMockOwner;
+var export_seedBrowserStore = seedBrowserStore_exports.seedBrowserStore;
+var export_seedMockStore = mockStoreSeed_exports.seedMockStore;
+
+export { export_HANDLER_MANIFEST as HANDLER_MANIFEST, export_StdMockSeed as StdMockSeed, export_TickScheduler as TickScheduler, export_applyEventWiring as applyEventWiring, export_bindDeclaredCollections as bindDeclaredCollections, export_buildSourceMatcher as buildSourceMatcher, export_buildTraitIndex as buildTraitIndex, export_collectListenerTargets as collectListenerTargets, export_composeBehaviors as composeBehaviors, export_createLocalStoreTransport as createLocalStoreTransport, export_createResidenceTransport as createResidenceTransport, export_createTickScheduler as createTickScheduler, export_cronMatches as cronMatches, export_cronMinuteKey as cronMinuteKey, export_detectLayoutStrategy as detectLayoutStrategy, export_eventRouteKey as eventRouteKey, export_isEffectTuple as isEffectTuple, export_isValidCronExpression as isValidCronExpression, export_isValidDurationString as isValidDurationString, export_localStorePersistence as localStorePersistence, export_parseCron as parseCron, export_parseCronField as parseCronField, export_parseDurationString as parseDurationString, export_parseListenSource as parseListenSource, export_parseOrbitalTraits as parseOrbitalTraits, export_pipeBehaviors as pipeBehaviors, export_readSeededStores as readSeededStores, export_resolveLocalRows as resolveLocalRows, export_restampMockOwner as restampMockOwner, export_seedBrowserStore as seedBrowserStore, export_seedMockStore as seedMockStore };