@flyingrobots/bijou 5.0.0 → 7.1.0

package/README.md

@@ -76,6 +76,70 @@ fake duplication rather than a real second API.
 - **`breadcrumb()`**: Path context.
 - **`stepper()`**: Ordered stages in a linear process.
 
+### Theme Authoring
+- **`extendTheme()`**: Build a custom theme from a known-good preset.
+- **`defineThemeSafePairs()`**: Declare reusable foreground/background
+  contrast matrices for `doctorTheme()` and inspector surfaces.
+- **`doctorTheme()`**: Structured checks for invalid colors, weak contrast,
+  and suspicious token reuse.
+- **`themeContrastRatio()`**: Deterministic foreground/background contrast
+  calculation for token-pair tests.
+
+### Mode-Aware Authoring
+- **`renderByMode()`**: Dispatch a component to the current output contract.
+- **`lintModeLowering()`**: Compare explicit semantic facts across output modes.
+- **`modeLoweringReportText()`**: Render a compact lowering report for tests,
+  docs, and review comments.
+- **`defineComponentMetadata()`**: Declare validated package, family, mode,
+  arg, variant, invariant, example, and source facts for tooling.
+- **`componentMetadataSummary()`**: Render compact metadata for docs, MCP
+  payloads, and agent-facing reports.
+- **`defineBlock()`**: Declare a validated reusable block with package, family,
+  scale, mode, slot, variant, config, component, story, semantic facts, optional
+  view data contracts, and command intents.
+- **`standardBlocks` / standard block exports**: Import the first-party
+  standard block definitions for AppShell, ReaderSurface, InspectorPanel,
+  inline status, in-flow status, transient overlay feedback, activity stream,
+  shortcut cues, and progress. These expose contracts, stories, data
+  requirements, command intents, and schema-bound posture, with deterministic
+  first-proof render output across all output modes. Production AppShell
+  behavior remains a later runtime slice.
+- **`defineBlockPackage()`**: Declare exported blocks, docs, tags, version, and
+  Bijou peer compatibility for ordinary NPM block packages.
+- **`defineBlockSchemaAdapter()` / `defineSchemaBlock()`**: Validate unknown
+  boundary data before producing immutable block render input and binding facts,
+  without fetching, subscribing, dispatching, or rendering AppShell.
+- **`blockMetadataSummary()`**: Render compact block metadata for docs, MCP
+  payloads, and agent-facing reports.
+- **`defineAppShellComposition()`**: Compose runtime-backed blocks into logical
+  AppShell slots with an explicit provider scope, without rendering or
+  subscribing.
+- **`blockRenderNode()` / `renderBlockTree()`**: Explicitly render nested block
+  declarations into parent slots when a preview or host intentionally wants a
+  block tree, while ordinary `block.render()` remains a local single-block
+  render contract.
+- **`defineDataRequirement()` / `defineDataProvider()` / `providerScope()`**:
+  Declare data requirements and explicit local provider availability without
+  hidden global registration.
+- **`defineViewData()`**: Group named data requirements for a view or block
+  without binding them to providers.
+- **`resolveProviderRequirement()`**: Resolve a requirement against an explicit
+  local provider scope as frozen metadata, without subscribing or fetching.
+- **`bindingFrameFromSnapshots()`**: Assemble read-only render frames from
+  resolved provider metadata and already-created immutable snapshots.
+- **`bindingSnapshot()` / `bindingFrame()`**: Model provider-delivered plain
+  data as copied, versioned immutable snapshots and read-only render frames.
+- **`commandIntent()`**: Declare user intent outputs as inspectable metadata,
+  without business-logic callbacks or provider mutation handles.
+- **`captureStoryMatrix()`**: Capture every profile/variant pair from a story
+  renderer.
+- **`storyCaptureMatrixText()`**: Render a deterministic multi-mode story
+  matrix for docs and tests.
+- **`createFixturePromotionRecord()`**: Preserve provenance when a fixture,
+  docs page, story, example, or MCP payload is promoted into another surface.
+- **`fixturePromotionText()`**: Render that promotion record for review and
+  agent output.
+
 ## Documentation
 
 - **[GUIDE.md](./GUIDE.md)**: Productive-fast path.

package/dist/core/active-binding-collection.d.ts

@@ -0,0 +1,49 @@
+import { type DataRequirement, type ProviderId, type ViewDataContract } from './binding.js';
+import { type BindingLifecycleOwner, type BindingLifecycleRecord } from './binding-lifecycle.js';
+declare const ACTIVE_BINDING_ENTRY_BRAND: unique symbol;
+declare const ACTIVE_BINDING_COLLECTION_BRAND: unique symbol;
+export interface ActiveBindingEntryInput {
+    readonly owner: BindingLifecycleOwner;
+    readonly requirement: DataRequirement;
+    readonly providerId?: string;
+}
+export interface ActiveBindingEntry {
+    readonly [ACTIVE_BINDING_ENTRY_BRAND]: true;
+    readonly owner: BindingLifecycleOwner;
+    readonly requirement: DataRequirement;
+    readonly providerId?: ProviderId;
+}
+export interface ActiveBindingProviderAssignment {
+    readonly requirementId: string;
+    readonly providerId: string;
+}
+export interface ActiveBindingContractInput {
+    readonly owner: BindingLifecycleOwner;
+    readonly contract: ViewDataContract;
+    readonly providerIds?: readonly ActiveBindingProviderAssignment[];
+}
+export interface CollectActiveBindingsInput {
+    readonly entries?: readonly ActiveBindingEntry[];
+    readonly contracts?: readonly ActiveBindingContractInput[];
+}
+export declare class ActiveBindingCollection {
+    #private;
+    readonly [ACTIVE_BINDING_COLLECTION_BRAND]: true;
+    constructor(entries: readonly ActiveBindingEntry[]);
+    entries(): readonly ActiveBindingEntry[];
+    requirements(): readonly DataRequirement[];
+    owners(): readonly BindingLifecycleOwner[];
+    lifecycleRecords(): readonly BindingLifecycleRecord[];
+    get(ownerId: string, requirementId: string): ActiveBindingEntry | undefined;
+    has(ownerId: string, requirementId: string): boolean;
+    byOwner(ownerId: string): readonly ActiveBindingEntry[];
+    byRequirement(requirementId: string): readonly ActiveBindingEntry[];
+    with(entry: ActiveBindingEntry): ActiveBindingCollection;
+}
+export declare function activeBindingEntry(input: ActiveBindingEntryInput): ActiveBindingEntry;
+export declare function isActiveBindingEntry(value: unknown): value is ActiveBindingEntry;
+export declare function activeBindingCollection(entries: readonly ActiveBindingEntry[]): ActiveBindingCollection;
+export declare function isActiveBindingCollection(value: unknown): value is ActiveBindingCollection;
+export declare function collectActiveBindings(input: CollectActiveBindingsInput): ActiveBindingCollection;
+export {};
+//# sourceMappingURL=active-binding-collection.d.ts.map

package/dist/core/active-binding-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-binding-collection.d.ts","sourceRoot":"","sources":["../../src/core/active-binding-collection.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,UAAU,EAEf,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,QAAA,MAAM,0BAA0B,EAAE,OAAO,MAAqC,CAAC;AAC/E,QAAA,MAAM,+BAA+B,EAAE,OAAO,MAA0C,CAAC;AAEzF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,0BAA0B,CAAC,EAAE,IAAI,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;CAClC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAC;CACnE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,0BAA0B,EAAE,CAAC;CAC5D;AAED,qBAAa,uBAAuB;;IAClC,QAAQ,CAAC,CAAC,+BAA+B,CAAC,EAAG,IAAI,CAAC;gBAItC,OAAO,EAAE,SAAS,kBAAkB,EAAE;IA6ClD,OAAO,IAAI,SAAS,kBAAkB,EAAE;IAIxC,YAAY,IAAI,SAAS,eAAe,EAAE;IAW1C,MAAM,IAAI,SAAS,qBAAqB,EAAE;IAW1C,gBAAgB,IAAI,SAAS,sBAAsB,EAAE;IAWrD,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAe3E,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;IAIpD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE;IAYvD,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE;IAYnE,IAAI,CAAC,KAAK,EAAE,kBAAkB,GAAG,uBAAuB;CAGzD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,kBAAkB,CAwBrF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAOhF;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GACrC,uBAAuB,CAEzB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAO1F;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,uBAAuB,CAiBzB"}

package/dist/core/active-binding-collection.js

@@ -0,0 +1,264 @@
+import { isDataRequirement, isViewDataContract, } from './binding.js';
+import { bindingLifecycleRecord, isBindingLifecycleOwner, } from './binding-lifecycle.js';
+const ACTIVE_BINDING_ENTRY_BRAND = Symbol('ActiveBindingEntry');
+const ACTIVE_BINDING_COLLECTION_BRAND = Symbol('ActiveBindingCollection');
+export class ActiveBindingCollection {
+    [ACTIVE_BINDING_COLLECTION_BRAND];
+    #entries;
+    #entriesByKey;
+    constructor(entries) {
+        if (!Array.isArray(entries)) {
+            throw new Error('active binding collection: entries must be an array');
+        }
+        Object.defineProperty(this, ACTIVE_BINDING_COLLECTION_BRAND, { value: true });
+        const entriesByKey = new Map();
+        const entryIndexesByKey = new Map();
+        const normalizedEntries = [];
+        entries.forEach((entry, index) => {
+            if (!isActiveBindingEntry(entry)) {
+                throw new Error(`active binding collection: entry at index ${index} was not created by activeBindingEntry()`);
+            }
+            const key = activeBindingKey(entry.owner.id, entry.requirement.id);
+            const existingEntry = entriesByKey.get(key);
+            if (existingEntry !== undefined) {
+                const mergedEntry = mergeDuplicateEntry(existingEntry, entry);
+                const existingIndex = entryIndexesByKey.get(key);
+                if (existingIndex === undefined) {
+                    throw new Error(`active binding collection: missing index for owner ${entry.owner.id} `
+                        + `requirement ${entry.requirement.id}`);
+                }
+                entriesByKey.set(key, mergedEntry);
+                normalizedEntries[existingIndex] = mergedEntry;
+                return;
+            }
+            entriesByKey.set(key, entry);
+            entryIndexesByKey.set(key, normalizedEntries.length);
+            normalizedEntries.push(entry);
+        });
+        this.#entries = Object.freeze(normalizedEntries);
+        this.#entriesByKey = entriesByKey;
+        Object.freeze(this);
+    }
+    entries() {
+        return Object.freeze([...this.#entries]);
+    }
+    requirements() {
+        const requirementsById = new Map();
+        this.#entries.forEach((entry) => {
+            if (!requirementsById.has(entry.requirement.id)) {
+                requirementsById.set(entry.requirement.id, entry.requirement);
+            }
+        });
+        return Object.freeze([...requirementsById.values()]);
+    }
+    owners() {
+        const ownersById = new Map();
+        this.#entries.forEach((entry) => {
+            if (!ownersById.has(entry.owner.id)) {
+                ownersById.set(entry.owner.id, entry.owner);
+            }
+        });
+        return Object.freeze([...ownersById.values()]);
+    }
+    lifecycleRecords() {
+        return Object.freeze(this.#entries.map((entry) => bindingLifecycleRecord({
+            owner: entry.owner,
+            requirementId: entry.requirement.id,
+            providerId: entry.providerId,
+            facts: entry.requirement.facts,
+        })));
+    }
+    get(ownerId, requirementId) {
+        return this.#entriesByKey.get(activeBindingKey(normalizeRequiredText({
+            scope: 'active binding collection',
+            field: 'ownerId',
+            value: ownerId,
+        }), normalizeRequiredText({
+            scope: 'active binding collection',
+            field: 'requirementId',
+            value: requirementId,
+        })));
+    }
+    has(ownerId, requirementId) {
+        return this.get(ownerId, requirementId) !== undefined;
+    }
+    byOwner(ownerId) {
+        const normalizedOwnerId = normalizeRequiredText({
+            scope: 'active binding collection',
+            field: 'ownerId',
+            value: ownerId,
+        });
+        return Object.freeze(this.#entries.filter((entry) => entry.owner.id === normalizedOwnerId));
+    }
+    byRequirement(requirementId) {
+        const normalizedRequirementId = normalizeRequiredText({
+            scope: 'active binding collection',
+            field: 'requirementId',
+            value: requirementId,
+        });
+        return Object.freeze(this.#entries.filter((entry) => entry.requirement.id === normalizedRequirementId));
+    }
+    with(entry) {
+        return new ActiveBindingCollection([...this.#entries, entry]);
+    }
+}
+export function activeBindingEntry(input) {
+    if (!isBindingLifecycleOwner(input.owner)) {
+        throw new Error('active binding entry: owner was not created by defineBindingLifecycleOwner()');
+    }
+    if (!isDataRequirement(input.requirement)) {
+        throw new Error('active binding entry: requirement was not created by defineDataRequirement()');
+    }
+    const entry = {
+        owner: input.owner,
+        requirement: input.requirement,
+        providerId: optionalRequiredText({
+            scope: 'active binding entry',
+            field: 'providerId',
+            value: input.providerId,
+        }),
+    };
+    Object.defineProperty(entry, ACTIVE_BINDING_ENTRY_BRAND, { value: true });
+    return Object.freeze(entry);
+}
+export function isActiveBindingEntry(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && Object.prototype.hasOwnProperty.call(value, ACTIVE_BINDING_ENTRY_BRAND)
+        && value[ACTIVE_BINDING_ENTRY_BRAND] === true);
+}
+export function activeBindingCollection(entries) {
+    return new ActiveBindingCollection(entries);
+}
+export function isActiveBindingCollection(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && Object.prototype.hasOwnProperty.call(value, ACTIVE_BINDING_COLLECTION_BRAND)
+        && value[ACTIVE_BINDING_COLLECTION_BRAND] === true);
+}
+export function collectActiveBindings(input) {
+    if (input === undefined || input === null || typeof input !== 'object' || Array.isArray(input)) {
+        throw new Error('active binding collection: input must be an object');
+    }
+    if (input.entries !== undefined && !Array.isArray(input.entries)) {
+        throw new Error('active binding collection: entries must be an array');
+    }
+    if (input.contracts !== undefined && !Array.isArray(input.contracts)) {
+        throw new Error('active binding collection: contracts must be an array');
+    }
+    const entries = [...(input.entries ?? [])];
+    (input.contracts ?? []).forEach((source, index) => {
+        entries.push(...activeBindingEntriesFromContract(source, index));
+    });
+    return new ActiveBindingCollection(entries);
+}
+function activeBindingEntriesFromContract(source, index) {
+    if (!isObjectRecord(source)) {
+        throw new Error(`active binding collection: contract ${index} must be an object`);
+    }
+    if (!isBindingLifecycleOwner(source.owner)) {
+        throw new Error(`active binding collection: contract ${index} owner was not created by defineBindingLifecycleOwner()`);
+    }
+    if (!isViewDataContract(source.contract)) {
+        throw new Error(`active binding collection: contract ${index} was not created by defineViewData()`);
+    }
+    const providerIds = providerAssignmentsByRequirementId(source.providerIds);
+    const requirementIds = new Set(source.contract.requirementIds());
+    providerIds.forEach((_, requirementId) => {
+        if (!requirementIds.has(requirementId)) {
+            throw new Error(`active binding collection: provider assignment ${requirementId} `
+                + `does not match contract ${index}`);
+        }
+    });
+    const requirements = source.contract.requirements().map((requirement, requirementIndex) => {
+        if (!isDataRequirement(requirement)) {
+            throw new Error(`active binding collection: contract ${index} requirement ${requirementIndex} `
+                + 'was not created by defineDataRequirement()');
+        }
+        return requirement;
+    });
+    return Object.freeze(requirements.map((requirement) => activeBindingEntry({
+        owner: source.owner,
+        requirement,
+        providerId: providerIds.get(requirement.id),
+    })));
+}
+function providerAssignmentsByRequirementId(assignments) {
+    if (assignments === undefined) {
+        return new Map();
+    }
+    if (!Array.isArray(assignments)) {
+        throw new Error('active binding collection: providerIds must be an array');
+    }
+    if (assignments.length === 0) {
+        return new Map();
+    }
+    const providerIds = new Map();
+    assignments.forEach((assignment, index) => {
+        if (!isObjectRecord(assignment)) {
+            throw new Error(`active binding collection: provider assignment ${index} must be an object`);
+        }
+        if (typeof assignment['requirementId'] !== 'string') {
+            throw new Error(`active binding collection: provider assignment ${index} `
+                + 'requirementId must be a string');
+        }
+        if (typeof assignment['providerId'] !== 'string') {
+            throw new Error(`active binding collection: provider assignment ${index} providerId must be a string`);
+        }
+        const requirementId = normalizeRequiredText({
+            scope: 'active binding collection',
+            field: 'requirementId',
+            value: assignment['requirementId'],
+        });
+        if (providerIds.has(requirementId)) {
+            throw new Error(`active binding collection: duplicate provider assignment ${requirementId}`);
+        }
+        providerIds.set(requirementId, normalizeRequiredText({
+            scope: 'active binding collection',
+            field: 'providerId',
+            value: assignment['providerId'],
+        }));
+    });
+    return providerIds;
+}
+function activeBindingKey(ownerId, requirementId) {
+    return `${ownerId}\u0000${requirementId}`;
+}
+function isObjectRecord(value) {
+    return Boolean(value && typeof value === 'object' && !Array.isArray(value));
+}
+function mergeDuplicateEntry(existingEntry, incomingEntry) {
+    if (existingEntry.providerId !== undefined
+        && incomingEntry.providerId !== undefined
+        && existingEntry.providerId !== incomingEntry.providerId) {
+        throw new Error(`active binding collection: conflicting providers for owner ${incomingEntry.owner.id} `
+            + `requirement ${incomingEntry.requirement.id}`);
+    }
+    const providerId = existingEntry.providerId ?? incomingEntry.providerId;
+    if (providerId === existingEntry.providerId) {
+        return existingEntry;
+    }
+    return activeBindingEntry({
+        owner: existingEntry.owner,
+        requirement: existingEntry.requirement,
+        providerId,
+    });
+}
+function normalizeRequiredText(options) {
+    const normalized = options.value.trim();
+    if (normalized === '') {
+        throw new Error(`${options.scope}: ${options.field} is required`);
+    }
+    return normalized;
+}
+function optionalRequiredText(options) {
+    if (options.value === undefined) {
+        return undefined;
+    }
+    return normalizeRequiredText({
+        scope: options.scope,
+        field: options.field,
+        value: options.value,
+    });
+}
+//# sourceMappingURL=active-binding-collection.js.map

package/dist/core/active-binding-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-binding-collection.js","sourceRoot":"","sources":["../../src/core/active-binding-collection.ts"],"names":[],"mappings":"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"}

package/dist/core/app-shell-composition.d.ts

@@ -0,0 +1,44 @@
+import { type BindingFact, type CommandIntent, type ProviderScope, type ViewDataContract } from './binding.js';
+import { type BlockDefinition } from './block-metadata.js';
+declare const APP_SHELL_COMPOSITION_BRAND: unique symbol;
+export type AppShellSlotId = 'navigation' | 'content' | 'inspector' | 'status' | 'overlays';
+export type AppShellSlotContent = BlockDefinition | readonly AppShellSlotContent[];
+export interface AppShellSlots {
+    readonly navigation?: AppShellSlotContent;
+    readonly content: AppShellSlotContent;
+    readonly inspector?: AppShellSlotContent;
+    readonly status?: AppShellSlotContent;
+    readonly overlays?: AppShellSlotContent;
+}
+export interface AppShellCompositionInput {
+    readonly id?: string;
+    readonly label?: string;
+    readonly description?: string;
+    readonly providers?: ProviderScope;
+    readonly slots: AppShellSlots;
+    readonly facts?: readonly BindingFact[];
+}
+export interface AppShellSlot {
+    readonly id: AppShellSlotId;
+    readonly blocks: readonly BlockDefinition[];
+}
+export declare class AppShellComposition {
+    #private;
+    readonly [APP_SHELL_COMPOSITION_BRAND] = true;
+    readonly id?: string;
+    readonly label?: string;
+    readonly description?: string;
+    readonly facts: readonly BindingFact[];
+    constructor(input: AppShellCompositionInput);
+    slotIds(): readonly AppShellSlotId[];
+    slots(): readonly AppShellSlot[];
+    slot(slotId: AppShellSlotId): readonly BlockDefinition[];
+    blocks(): readonly BlockDefinition[];
+    dataContracts(): readonly ViewDataContract[];
+    commandIntents(): readonly CommandIntent[];
+    providerScope(): ProviderScope | undefined;
+}
+export declare function defineAppShellComposition(input: AppShellCompositionInput): AppShellComposition;
+export declare function isAppShellComposition(value: unknown): value is AppShellComposition;
+export {};
+//# sourceMappingURL=app-shell-composition.d.ts.map

package/dist/core/app-shell-composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-shell-composition.d.ts","sourceRoot":"","sources":["../../src/core/app-shell-composition.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qBAAqB,CAAC;AAE7B,QAAA,MAAM,2BAA2B,EAAE,OAAO,MAAsC,CAAC;AAEjF,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,SAAS,GACT,WAAW,GACX,QAAQ,GACR,UAAU,CAAC;AAEf,MAAM,MAAM,mBAAmB,GAC3B,eAAe,GACf,SAAS,mBAAmB,EAAE,CAAC;AAEnC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,cAAc,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAC;CAC7C;AAYD,qBAAa,mBAAmB;;IAC9B,QAAQ,CAAC,CAAC,2BAA2B,CAAC,QAAQ;IAG9C,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;gBAE3B,KAAK,EAAE,wBAAwB;IAuB3C,OAAO,IAAI,SAAS,cAAc,EAAE;IAIpC,KAAK,IAAI,SAAS,YAAY,EAAE;IAIhC,IAAI,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,eAAe,EAAE;IAIxD,MAAM,IAAI,SAAS,eAAe,EAAE;IAMpC,aAAa,IAAI,SAAS,gBAAgB,EAAE;IAM5C,cAAc,IAAI,SAAS,aAAa,EAAE;IAM1C,aAAa,IAAI,aAAa,GAAG,SAAS;CAG3C;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,wBAAwB,GAC9B,mBAAmB,CAErB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAMlF"}

package/dist/core/app-shell-composition.js

@@ -0,0 +1,123 @@
+import { isProviderScope, } from './binding.js';
+import { isBlockDefinition, } from './block-metadata.js';
+const APP_SHELL_COMPOSITION_BRAND = Symbol('AppShellComposition');
+const APP_SHELL_SLOT_IDS = [
+    'navigation',
+    'content',
+    'inspector',
+    'status',
+    'overlays',
+];
+const EMPTY_FACTS = Object.freeze([]);
+const EMPTY_BLOCKS = Object.freeze([]);
+export class AppShellComposition {
+    [APP_SHELL_COMPOSITION_BRAND] = true;
+    #slotsById;
+    #providers;
+    id;
+    label;
+    description;
+    facts;
+    constructor(input) {
+        if (input === undefined || input === null || typeof input !== 'object' || Array.isArray(input)) {
+            throw new Error('app shell composition: input must be an object');
+        }
+        if (input.providers !== undefined && !isProviderScope(input.providers)) {
+            throw new Error('app shell composition: providers must be created by providerScope()');
+        }
+        const slotsById = normalizeSlots(input.slots);
+        if (!slotsById.has('content')) {
+            throw new Error('app shell composition: content slot is required');
+        }
+        this.#slotsById = slotsById;
+        this.#providers = input.providers;
+        this.id = optionalTrimmedText(input.id);
+        this.label = optionalTrimmedText(input.label);
+        this.description = optionalTrimmedText(input.description);
+        this.facts = freezeFacts(input.facts);
+        Object.freeze(this);
+    }
+    slotIds() {
+        return Object.freeze([...this.#slotsById.keys()]);
+    }
+    slots() {
+        return Object.freeze([...this.#slotsById.values()]);
+    }
+    slot(slotId) {
+        return this.#slotsById.get(normalizeSlotId(slotId))?.blocks ?? EMPTY_BLOCKS;
+    }
+    blocks() {
+        return Object.freeze([...this.#slotsById.values()].flatMap((slot) => slot.blocks));
+    }
+    dataContracts() {
+        return Object.freeze(this.blocks().flatMap((block) => (block.data === undefined ? [] : [block.data])));
+    }
+    commandIntents() {
+        return Object.freeze(this.blocks().flatMap((block) => block.commands ?? []));
+    }
+    providerScope() {
+        return this.#providers;
+    }
+}
+export function defineAppShellComposition(input) {
+    return new AppShellComposition(input);
+}
+export function isAppShellComposition(value) {
+    return Boolean(value
+        && typeof value === 'object'
+        && value[APP_SHELL_COMPOSITION_BRAND] === true);
+}
+function normalizeSlots(slots) {
+    if (slots === undefined || slots === null || typeof slots !== 'object' || Array.isArray(slots)) {
+        throw new Error('app shell composition: slots must be an object');
+    }
+    const slotsById = new Map();
+    for (const [rawSlotId, content] of Object.entries(slots)) {
+        if (content === undefined) {
+            continue;
+        }
+        const slotId = normalizeSlotId(rawSlotId);
+        if (slotsById.has(slotId)) {
+            throw new Error(`app shell composition: duplicate slot ${slotId}`);
+        }
+        const blocks = normalizeSlotContent(content, `slots.${slotId}`);
+        if (blocks.length === 0) {
+            throw new Error(`app shell composition: slot ${slotId} must include at least one block`);
+        }
+        slotsById.set(slotId, Object.freeze({
+            id: slotId,
+            blocks,
+        }));
+    }
+    return slotsById;
+}
+function normalizeSlotContent(content, path) {
+    if (Array.isArray(content)) {
+        return Object.freeze(content.flatMap((item, index) => normalizeSlotContent(item, `${path}[${index}]`)));
+    }
+    if (!isBlockDefinition(content)) {
+        throw new Error(`${path}: slot content must be created by defineBlock()`);
+    }
+    return Object.freeze([content]);
+}
+function normalizeSlotId(slotId) {
+    const normalized = slotId.trim();
+    if (!APP_SHELL_SLOT_IDS.includes(normalized)) {
+        throw new Error(`app shell composition: unsupported slot ${normalized}`);
+    }
+    return normalized;
+}
+function optionalTrimmedText(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.trim();
+    return normalized === '' ? undefined : normalized;
+}
+function freezeFacts(facts) {
+    if (facts === undefined || facts.length === 0) {
+        return EMPTY_FACTS;
+    }
+    return Object.freeze(facts.map((fact) => Object.freeze({ ...fact })));
+}
+//# sourceMappingURL=app-shell-composition.js.map

package/dist/core/app-shell-composition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-shell-composition.js","sourceRoot":"","sources":["../../src/core/app-shell-composition.ts"],"names":[],"mappings":"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"}

package/dist/core/binding-frame-update.d.ts

@@ -0,0 +1,18 @@
+import { type ActiveBindingCollection } from './active-binding-collection.js';
+import { type BindingFact, type BindingFrame, type BindingIssue, type BindingSnapshot, type ProviderResolution, type ProviderScope } from './binding.js';
+import { type BindingLifecycleRecord } from './binding-lifecycle.js';
+export interface BindingFrameUpdateFromSnapshotsInput {
+    readonly collection: ActiveBindingCollection;
+    readonly scope: ProviderScope;
+    readonly snapshots: readonly BindingSnapshot[];
+    readonly records?: readonly BindingLifecycleRecord[];
+}
+export interface BindingFrameUpdate {
+    readonly frame: BindingFrame;
+    readonly records: readonly BindingLifecycleRecord[];
+    readonly resolutions: readonly ProviderResolution[];
+    readonly issues: readonly BindingIssue[];
+    readonly facts: readonly BindingFact[];
+}
+export declare function bindingFrameUpdateFromSnapshots(input: BindingFrameUpdateFromSnapshotsInput): BindingFrameUpdate;
+//# sourceMappingURL=binding-frame-update.d.ts.map

package/dist/core/binding-frame-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-frame-update.d.ts","sourceRoot":"","sources":["../../src/core/binding-frame-update.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAEnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,UAAU,EAAE,uBAAuB,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,eAAe,EAAE,CAAC;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACpD,QAAQ,CAAC,WAAW,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;CACxC;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,oCAAoC,GAC1C,kBAAkB,CA0DpB"}