@almadar/shell-web 0.1.0 → 1.1.0

package/dist/ServerBridge-Cm1On51b.d.ts

@@ -1,233 +0,0 @@
-import * as React from 'react';
-import React__default, { ReactNode } from 'react';
-import { EntityRow, TraitConfig, SkeletonNode, ResolvedEntity, EventPayload, ResolvedTrait, ResolvedTraitBinding, 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
- *
- * Minimal context providing entity schema definitions (field metadata).
- * This is NOT a data store — actual entity rows flow through the state
- * machine's `@payload.data` binding on the emitting trait's fetch-success
- * transition and land on the rendering component's `entity` prop.
- *
- * Replaces EntityStore's schema functionality without the mock data generation.
- *
- * @packageDocumentation
- */
-
-interface EntitySchemaContextValue {
-    /** Entity definitions (schema metadata only) */
-    entities: Map<string, ResolvedEntity>;
-    /**
-     * Per-trait linkedEntity name. `ResolvedTrait` itself doesn't carry
-     * linkedEntity (it lives on `ResolvedTraitBinding` at the page-binding
-     * level), so OrbPreview pre-projects every page's trait bindings into
-     * a flat `traitName → entityName` map for the slot renderer.
-     *
-     * Used by SlotContentRenderer to resolve `entityDef` via
-     * `traitLinkedEntities.get(sourceTrait) → entities.get(...)` when the
-     * rendered pattern's `entity:` prop is a resolved value (V2 path)
-     * rather than a string entity-name. Without this lookup, form-section
-     * can't enrich its fields with entity field metadata (values enum,
-     * etc.) and an enum field renders as a plain text input. Closes VR3.
-     */
-    traitLinkedEntities: ReadonlyMap<string, string>;
-    /**
-     * Per-trait owning-orbital name. Same shape as `traitLinkedEntities`,
-     * built from `schema.orbitals[].traits[]`. UISlotRenderer uses this
-     * to wrap each slot's rendered subtree in `TraitScopeProvider` so
-     * descendant pure components (Button, etc.) emit qualified
-     * `UI:Orbital.Trait.EVENT` keys via the scoped useEventBus.
-     */
-    orbitalsByTrait: ReadonlyMap<string, string>;
-}
-interface EntitySchemaProviderProps {
-    /** Entity definitions from resolved schema */
-    entities: ResolvedEntity[];
-    /**
-     * Per-trait linkedEntity name, projected from every page's
-     * ResolvedTraitBinding. Optional for back-compat; when omitted,
-     * SlotContentRenderer's enrichment path can only follow the
-     * legacy V1 string-entity-name lookup.
-     */
-    traitLinkedEntities?: ReadonlyMap<string, string>;
-    /**
-     * Per-trait owning-orbital name. Required for the runtime path's
-     * trait-scoped event qualification (Button etc. emit qualified keys
-     * via TraitScopeProvider). Optional for back-compat with consumers
-     * that don't yet thread the orbital map through.
-     */
-    orbitalsByTrait?: ReadonlyMap<string, string>;
-    /** Children */
-    children: React__default.ReactNode;
-}
-/**
- * Provides entity schema definitions to the component tree.
- *
- * This is a lightweight provider that only holds schema metadata (field definitions).
- * Actual entity rows arrive via `@payload.data` on the rendering trait's
- * success transition — they do NOT live in this context.
- */
-declare function EntitySchemaProvider({ entities, traitLinkedEntities, orbitalsByTrait, children, }: EntitySchemaProviderProps): React__default.ReactElement;
-/**
- * Access entity schema definitions.
- * Use this for field metadata (form building, filter enrichment).
- * Actual entity rows flow via `@payload.data` on the state machine's
- * success transition — never read them from a context.
- */
-declare function useEntitySchema(): EntitySchemaContextValue;
-/**
- * Safe version of useEntitySchema that returns null when no provider is present.
- * Used by UISlotRenderer which may render outside an EntitySchemaProvider (compiled mode).
- */
-declare function useEntitySchemaOptional(): EntitySchemaContextValue | null;
-
-/**
- * TraitProvider Component
- *
- * Provides trait state machines to child components via React context.
- *
- * @packageDocumentation
- */
-
-interface TraitInstance {
-    /** Trait name */
-    name: string;
-    /** Current state */
-    currentState: string;
-    /** Available events (can be triggered) */
-    availableEvents: string[];
-    /** Dispatch an event to the state machine */
-    dispatch: (eventKey: string, payload?: EventPayload) => void;
-    /** Check if an event can be dispatched */
-    canDispatch: (eventKey: string) => boolean;
-    /** Get the full trait definition */
-    trait: ResolvedTrait;
-}
-interface TraitContextValue {
-    /** All trait instances on this page */
-    traits: Map<string, TraitInstance>;
-    /** Get a trait instance by name */
-    getTrait: (name: string) => TraitInstance | undefined;
-    /** Dispatch an event to a specific trait */
-    dispatchToTrait: (traitName: string, eventKey: string, payload?: EventPayload) => void;
-    /** Check if an event can be dispatched to a trait */
-    canDispatch: (traitName: string, eventKey: string) => boolean;
-}
-declare const TraitContext: React__default.Context<TraitContextValue | null>;
-interface TraitProviderProps {
-    /** Trait bindings for this page */
-    traits: ResolvedTraitBinding[];
-    /** Entity map for context */
-    entities: Map<string, ResolvedEntity>;
-    /** Children to render */
-    children: React__default.ReactNode;
-}
-declare function TraitProvider({ traits: traitBindings, children, }: TraitProviderProps): React__default.ReactElement;
-/**
- * Access the trait context from within the TraitProvider.
- */
-declare function useTraitContext(): TraitContextValue;
-/**
- * Access a specific trait instance.
- */
-declare function useTrait(traitName: string): TraitInstance | undefined;
-
-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`,
- * `OrbitalPluginHost.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 { TraitContext as T, EntitySchemaProvider as b, ServerBridgeProvider as e, TraitProvider as h, useEntitySchemaOptional as j, useServerBridge as k, useTrait as l, useTraitContext as m, AwaitingSkeletonContext as n, EntityBindingContext as o, useAwaitingSkeleton as q, useEntityBindingSnapshot as r, useEntitySchema as u };
-export type { AwaitingSkeletonSource as A, EntityBindingSource as E, ServerBridgeTransport as S, EntitySchemaContextValue as a, EntitySchemaProviderProps as c, ServerBridgeContextValue as d, TraitContextValue as f, TraitInstance as g, TraitProviderProps as i, ServerBridgeProviderProps as p };

package/dist/TraitValueFrame-2PJGLLVI.js

@@ -1,28 +0,0 @@
-export { MountedInit, TraitValueFrame, TraitValueMountContext, TraitValueMountProvider, TraitValueFrame_default as default } from './chunk-FIW6WN23.js';
-import './chunk-GYTPOFVC.js';
-import './chunk-YDNJLLG6.js';
-import './chunk-KVQS4GXU.js';
-import './chunk-L677XGY3.js';
-import './chunk-FP3WIKTC.js';
-import './chunk-42FY4RYA.js';
-import './chunk-FAJDTHWC.js';
-import './chunk-GAR5TQ5B.js';
-import './chunk-SJGJJKBY.js';
-import './chunk-DZ42OJQC.js';
-import './chunk-P4LNHAFI.js';
-import './chunk-TZZBINQY.js';
-import './chunk-PC7K4SK7.js';
-import './chunk-VFF5OO47.js';
-import './chunk-DFNZUYX4.js';
-import './chunk-B4BU77LT.js';
-import './chunk-6P3MWXYE.js';
-import './chunk-DYEKAA4L.js';
-import './chunk-R5O5AUPI.js';
-import './chunk-L2DEKY4J.js';
-import './chunk-AILY3XPS.js';
-import './chunk-3BBUBJFF.js';
-import './chunk-YHMRX6YA.js';
-import './chunk-MBQAMMSE.js';
-import './chunk-A2LR6VQQ.js';
-import './chunk-P4ZFUQFF.js';
-import './chunk-G7DCAZ22.js';

package/dist/UISlotRenderer-JKFSX24W.js

@@ -1,27 +0,0 @@
-export { SlotContainedContext, SlotContentRenderer, SuspenseConfigProvider, UISlotComponent, UISlotRenderer, renderPatternProps, renderPatternValue } from './chunk-GYTPOFVC.js';
-import './chunk-YDNJLLG6.js';
-import './chunk-KVQS4GXU.js';
-import './chunk-L677XGY3.js';
-import './chunk-FP3WIKTC.js';
-import './chunk-42FY4RYA.js';
-import './chunk-FAJDTHWC.js';
-import './chunk-GAR5TQ5B.js';
-import './chunk-SJGJJKBY.js';
-import './chunk-DZ42OJQC.js';
-import './chunk-P4LNHAFI.js';
-import './chunk-TZZBINQY.js';
-import './chunk-PC7K4SK7.js';
-import './chunk-VFF5OO47.js';
-import './chunk-DFNZUYX4.js';
-import './chunk-B4BU77LT.js';
-import './chunk-6P3MWXYE.js';
-import './chunk-DYEKAA4L.js';
-import './chunk-R5O5AUPI.js';
-import './chunk-L2DEKY4J.js';
-import './chunk-AILY3XPS.js';
-import './chunk-3BBUBJFF.js';
-import './chunk-YHMRX6YA.js';
-import './chunk-MBQAMMSE.js';
-import './chunk-A2LR6VQQ.js';
-import './chunk-P4ZFUQFF.js';
-import './chunk-G7DCAZ22.js';