@kumwe/studio-core 0.1.0-alpha.8 → 0.1.0-rc.1

package/README.md

@@ -15,16 +15,72 @@ The implemented surface covers:
 - `applyEntryCommand` — the locale-guarded `set-field-value` reducer for entries;
 - `StudioSession` — bounded history behind fail-closed session guards (read-only state, session
   generation, expected revision), dirty tracking, and a validated selection model;
-- `ContributionRuntime` — owner-aware, transactional contribution activation into immutable
-  registry generations with disable, reactivate, trust-revocation, stale-generation refusal, and
-  inspectable unresolved nodes;
+- `openStudioSession` — capability-negotiated Blueprint loading and a headless host-session handle for
+  serialized optimistic saves, raw optional recovery-port access, read-only model `list`/`get`, bounded
+  resource search, stale-generation invalidation, and local idempotent disposal;
+- `projectBlueprintFieldBindings` — an immutable exact-model projection of compatible block-port field
+  candidates, declared authoring controls and stable invalid-binding diagnostics;
+- `ContributionRuntime` — owner-aware, transactional, schema-validated activation of block,
+  pattern, design-vocabulary, migration, inspector, and field-adapter payloads into kind-scoped
+  immutable generations, with disable, reactivate, trust-revocation, stale-generation refusal, and
+  inspectable unresolved contributions;
 - `validateBlueprint` and `BlockRegistry` — schema, limit, lock, and registry validation with
   stable diagnostics;
 - `canonicalStringify` / `canonicalUtf8Bytes` — the canonical cross-language serialization form
   used for checksums.
+- `createCoreLayoutBlockDefinitions` / `resolveCoreLayoutIntent` — first-party section, stack, grid,
+  and columns definitions plus theme-validated responsive intent resolution, with no DOM or stored
+  CSS;
+- `createCoreProductionBlockDefinitions` / `createCoreProductionPatterns` — the standalone 45-block
+  production catalog and ten portable starter compositions, including media, rich content,
+  progressive composites including dialogs, popovers, and notices, data display, and
+  host-authoritative resource/query projections;
+- `coreProductionInitialProperties` — schema-valid defaults used by the Studio insertion path for
+  every first-party type;
+- `parseStudioPresentationIntent` — the closed, CSS-free visual capability contract shared by all
+  first-party inspector surfaces and renderers;
 - `compileStudioPropertySchema` / `assertStudioPropertySchema` — eval-free admission and validation
   for the closed, local-only `studio.profile/schema-property` surface, with stable
   `StudioSchemaProfileError` codes and schema pointers.
 
 The package has no DOM dependency. Web Components, Flutter clients, command-line tools, and server
 adapters can therefore share the same command and validation semantics through the protocol.
+
+## Blueprint host-session composition
+
+`openStudioSession(hostAdapter, options)` consumes a complete, host-resolved `StudioConfiguration` from
+`OpenStudioSessionOptions`. Its injected `StudioHostSessionIdentifierFactories` provide deterministic
+`requestId(operationId)` and `idempotencyKey(operationId)` values. Opening requires
+`mode: blueprint`, `composite: single`, either session state, and the configured Blueprint reference;
+it passes the resolved Blueprint/read-only mode, session generation, resource context, locale,
+protocol, and history limit through the headless lifecycle. It does not perform the host handshake,
+automatically load model/theme dependencies, fabricate an artifact for model/content/hybrid
+configuration, or provide a transport.
+
+The returned handle serializes saves against the latest accepted host revision and coalesces matching
+concurrent intents. An exact retry after failure retains its idempotency key. If the document changes
+while a snapshot is saving, the success advances the accepted revision but the newer state remains
+dirty. Every current, undo, and redo snapshot carries that accepted revision without a local state-version
+change, so later history and exact preview staging use one coherent base. Conflicts and other refusals
+preserve the document, history, selection, and saved baseline.
+
+`StudioHostSessionHandle.recovery` is a `StudioHostSessionRecovery` with direct `store`, `load`, and
+`discard` calls when the optional port is present, and is `undefined` otherwise. The core does not
+synthesize or reconcile recovery envelopes. A
+`studio.host/stale-session-generation` diagnostic invalidates the complete handle. `dispose()` is
+local and idempotent and does not imply host teardown or preview cleanup. See
+[ADR 0020](../../docs/decisions/0020-blueprint-host-session-composition.md) for the deliberate scope.
+
+`StudioHostSessionHandle.models` is present only when the negotiated model port and adapter both implement
+`list` and `get`. Results are canonical-schema validated, exact-coordinate checked and detached before they
+leave the boundary; stale generation invalidates the whole handle. The surface is deliberately read-only.
+Pass an authorized active model to `projectBlueprintFieldBindings(blueprint, model, definitions)` to derive
+portable candidates and diagnostics without changing any input. See
+[ADR 0024](../../docs/decisions/0024-read-only-model-binding-projection.md).
+
+`StudioHostSessionHandle.resources` is present only when the negotiated resource port advertises
+`studio.operation/resource.search` and the adapter implements it. `search` validates and clones bounded
+queries before allocating a request, then accepts only detached pages whose stable, unique hit IDs and
+qualified message references match the requested resource type. Malformed adapter output becomes a safe
+`studio.host/unexpected-resource-result` failure. This is a read-only discovery surface: hosts still own
+authorization and resolution, and first-party dynamic resource/query bindings remain read-only in Studio.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,9 @@
+# Third-party notices
+
+<!-- Generated by scripts/generate-third-party-notices.mjs. Do not edit by hand. -->
+
+Package: `@kumwe/studio-core`
+
+Production closure SHA-256: `4f53cda18c2baa0c0354bb5f9a3ecbe5ed12ab4d8e11ba873c2f11161202b945`
+
+This package has no third-party runtime dependencies.

package/dist/binding-projection.d.ts

@@ -0,0 +1,47 @@
+import type { BlockDefinition, BlueprintDocument, ContentFieldKind, ContentModelDocument, FieldBinding, FieldDefinition, LocalName, LockedArtifactReference, MessageReference, QualifiedName, StudioDiagnostic } from '@kumwe/studio-protocol';
+/** The stable outcomes a binding port can expose to any authoring shell. */
+export type FieldBindingProjectionStatus = 'invalid' | 'non-field-source' | 'resolved' | 'unbound';
+/** One model field that can be bound to one exact block port. */
+export interface FieldBindingCandidate {
+    readonly cardinality: FieldDefinition['cardinality'];
+    readonly control?: QualifiedName;
+    readonly fieldPath: readonly LocalName[];
+    readonly itemKind?: Exclude<ContentFieldKind, 'collection'>;
+    readonly kind: ContentFieldKind;
+    readonly label: MessageReference;
+}
+/** Deterministic projection of one declared or preserved node binding port. */
+export interface FieldBindingPortProjection {
+    readonly binding?: FieldBinding;
+    readonly boundFieldPath?: readonly LocalName[];
+    readonly candidates: readonly FieldBindingCandidate[];
+    readonly multiple?: boolean;
+    readonly port: LocalName;
+    readonly required?: boolean;
+    readonly status: FieldBindingProjectionStatus;
+    readonly valueType?: string;
+}
+/** Deterministic projection of all binding affordances on one Blueprint node. */
+export interface NodeFieldBindingProjection {
+    readonly nodeId: string;
+    readonly ports: readonly FieldBindingPortProjection[];
+}
+/**
+ * Read-only, language-neutral view of a Blueprint's bindings against one exact
+ * host-projected model revision.
+ */
+export interface BlueprintFieldBindingProjection {
+    readonly diagnostics: readonly StudioDiagnostic[];
+    readonly model: LockedArtifactReference;
+    readonly nodes: readonly NodeFieldBindingProjection[];
+}
+/**
+ * Projects the active model into field-binding affordances and diagnostics.
+ *
+ * The function never changes a model, Blueprint, block definition, workflow,
+ * translation, or permission value. It accepts only already-authorized model
+ * projections and returns detached JSON-compatible snapshots. Field IDs, not
+ * labels or storage names, are the only binding coordinates.
+ */
+export declare function projectBlueprintFieldBindings(blueprint: BlueprintDocument, model: ContentModelDocument, definitions: readonly BlockDefinition[]): BlueprintFieldBindingProjection;
+//# sourceMappingURL=binding-projection.d.ts.map

package/dist/binding-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-projection.d.ts","sourceRoot":"","sources":["../src/binding-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EAEjB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EAEf,SAAS,EACT,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAGhC,4EAA4E;AAC5E,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,kBAAkB,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnG,iEAAiE;AACjE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IAC5D,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;CAClC;AAED,+EAA+E;AAC/E,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACtD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,WAAW,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACvD;AAgBD;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,iBAAiB,EAC5B,KAAK,EAAE,oBAAoB,EAC3B,WAAW,EAAE,SAAS,eAAe,EAAE,GACtC,+BAA+B,CA6BjC"}

package/dist/binding-projection.js

@@ -0,0 +1,253 @@
+import { cloneContractValue } from './clone.js';
+/**
+ * Projects the active model into field-binding affordances and diagnostics.
+ *
+ * The function never changes a model, Blueprint, block definition, workflow,
+ * translation, or permission value. It accepts only already-authorized model
+ * projections and returns detached JSON-compatible snapshots. Field IDs, not
+ * labels or storage names, are the only binding coordinates.
+ */
+export function projectBlueprintFieldBindings(blueprint, model, definitions) {
+    const documentSnapshot = cloneContractValue(blueprint);
+    const modelSnapshot = cloneContractValue(model);
+    const definitionSnapshots = cloneContractValue(definitions);
+    const diagnostics = [];
+    const modelReference = cloneContractValue(documentSnapshot.model);
+    const modelCompatible = appendModelCoordinateDiagnostics(documentSnapshot, modelSnapshot, diagnostics);
+    const indexedDefinitions = new Map();
+    for (const definition of definitionSnapshots) {
+        indexedDefinitions.set(blockKey(definition.type, definition.version), definition);
+    }
+    const context = {
+        blueprintId: documentSnapshot.id,
+        definitions: indexedDefinitions,
+        diagnostics,
+        fields: modelCompatible ? flattenModelFields(modelSnapshot.fields) : [],
+        modelCompatible,
+        modelReference,
+    };
+    const nodes = [];
+    visitNodes(documentSnapshot.roots, (node) => {
+        nodes.push(projectNode(node, context));
+    });
+    return cloneContractValue({ diagnostics, model: modelReference, nodes });
+}
+function appendModelCoordinateDiagnostics(blueprint, model, diagnostics) {
+    let compatible = true;
+    for (const mismatch of [
+        {
+            actual: model.id,
+            code: 'studio.binding/model-id-mismatch',
+            expected: blueprint.model.id,
+            member: 'id',
+        },
+        {
+            actual: model.version,
+            code: 'studio.binding/model-version-mismatch',
+            expected: blueprint.model.version,
+            member: 'version',
+        },
+        {
+            actual: model.revision,
+            code: 'studio.binding/model-revision-mismatch',
+            expected: blueprint.model.revision,
+            member: 'revision',
+        },
+    ]) {
+        if (mismatch.actual === mismatch.expected) {
+            continue;
+        }
+        compatible = false;
+        diagnostics.push(diagnostic(mismatch.code, `The projected model ${mismatch.member} {actual} does not match the Blueprint lock {expected}.`, 'error', {
+            actual: mismatch.actual,
+            expected: mismatch.expected,
+            member: mismatch.member,
+        }, { artifactId: blueprint.id }));
+    }
+    return compatible;
+}
+function projectNode(node, context) {
+    const definition = context.definitions.get(blockKey(node.type, node.version));
+    const declaredPorts = definition?.ports ?? [];
+    const declaredIds = new Set(declaredPorts.map((port) => port.id));
+    const preservedPortIds = Object.keys(node.bindings)
+        .filter((port) => !declaredIds.has(port))
+        .sort(compareCodeUnits);
+    const ports = [
+        ...declaredPorts.map((port) => projectPort(node, port, context)),
+        ...preservedPortIds.map((port) => projectMissingPort(node, port, context)),
+    ];
+    return { nodeId: node.id, ports };
+}
+function projectPort(node, port, context) {
+    const candidates = context.modelCompatible
+        ? context.fields
+            .filter((candidate) => candidate.field.authoring?.hidden !== true && fieldMatchesPort(candidate.field, port))
+            .map(({ field, fieldPath }) => candidateProjection(field, fieldPath))
+        : [];
+    const binding = node.bindings[port.id];
+    if (binding === undefined) {
+        if (port.required) {
+            context.diagnostics.push(diagnostic('studio.binding/required-port-unbound', 'Required block port {port} is not bound to a source.', 'warning', { port: port.id }, { artifactId: context.blueprintId, nodeId: node.id }));
+        }
+        return {
+            candidates,
+            multiple: port.multiple,
+            port: port.id,
+            required: port.required,
+            status: 'unbound',
+            valueType: port.valueType,
+        };
+    }
+    if (binding.source.kind !== 'entry-field') {
+        return {
+            binding: cloneContractValue(binding),
+            candidates,
+            multiple: port.multiple,
+            port: port.id,
+            required: port.required,
+            status: 'non-field-source',
+            valueType: port.valueType,
+        };
+    }
+    const fieldPath = [...binding.source.fieldPath];
+    if (!context.modelCompatible) {
+        return invalidProjection(port, binding, fieldPath, candidates);
+    }
+    const resolution = resolveFieldPath(context.fields, fieldPath);
+    if (resolution === undefined) {
+        context.diagnostics.push(diagnostic('studio.binding/field-missing', 'Binding port {port} addresses field path {fieldPath}, which the locked model no longer declares.', 'error', { fieldPath: fieldPath.join('.'), port: port.id }, { artifactId: context.blueprintId, fieldPath, nodeId: node.id }));
+        return invalidProjection(port, binding, fieldPath, candidates);
+    }
+    if (fieldIsMultiple(resolution.field) !== port.multiple) {
+        context.diagnostics.push(diagnostic('studio.binding/field-cardinality-incompatible', 'Binding port {port} and field {fieldPath} no longer have compatible cardinality.', 'error', { fieldPath: fieldPath.join('.'), port: port.id }, { artifactId: context.blueprintId, fieldPath, nodeId: node.id }));
+        return invalidProjection(port, binding, fieldPath, candidates);
+    }
+    if (!fieldKindMatchesValueType(resolution.field, port.valueType)) {
+        context.diagnostics.push(diagnostic('studio.binding/field-kind-incompatible', 'Binding port {port} expects {valueType}, but field {fieldPath} now projects as {fieldKind}.', 'error', {
+            fieldKind: effectiveFieldKind(resolution.field),
+            fieldPath: fieldPath.join('.'),
+            port: port.id,
+            valueType: port.valueType,
+        }, { artifactId: context.blueprintId, fieldPath, nodeId: node.id }));
+        return invalidProjection(port, binding, fieldPath, candidates);
+    }
+    return {
+        binding: cloneContractValue(binding),
+        boundFieldPath: fieldPath,
+        candidates,
+        multiple: port.multiple,
+        port: port.id,
+        required: port.required,
+        status: 'resolved',
+        valueType: port.valueType,
+    };
+}
+function projectMissingPort(node, port, context) {
+    const binding = node.bindings[port];
+    if (binding === undefined) {
+        return { candidates: [], port, status: 'invalid' };
+    }
+    context.diagnostics.push(diagnostic('studio.binding/port-missing', 'Binding port {port} is not declared by the locked block definition.', 'error', { port }, { artifactId: context.blueprintId, nodeId: node.id }));
+    return {
+        binding: cloneContractValue(binding),
+        ...(binding.source.kind === 'entry-field'
+            ? { boundFieldPath: [...binding.source.fieldPath] }
+            : {}),
+        candidates: [],
+        port,
+        status: 'invalid',
+    };
+}
+function invalidProjection(port, binding, fieldPath, candidates) {
+    return {
+        binding: cloneContractValue(binding),
+        boundFieldPath: [...fieldPath],
+        candidates,
+        multiple: port.multiple,
+        port: port.id,
+        required: port.required,
+        status: 'invalid',
+        valueType: port.valueType,
+    };
+}
+function candidateProjection(field, fieldPath) {
+    return {
+        cardinality: field.cardinality,
+        ...(field.authoring?.control === undefined ? {} : { control: field.authoring.control }),
+        fieldPath: [...fieldPath],
+        ...(field.itemKind === undefined ? {} : { itemKind: field.itemKind }),
+        kind: field.kind,
+        label: cloneContractValue(field.label),
+    };
+}
+function flattenModelFields(fields) {
+    const flattened = [];
+    const visit = (siblings, prefix) => {
+        const ordered = siblings
+            .map((field, index) => ({ field, index }))
+            .sort((left, right) => (left.field.authoring?.order ?? Number.MAX_SAFE_INTEGER) -
+            (right.field.authoring?.order ?? Number.MAX_SAFE_INTEGER) || left.index - right.index);
+        for (const { field } of ordered) {
+            const fieldPath = [...prefix, field.id];
+            flattened.push({ field, fieldPath });
+            if (field.kind === 'object' && field.cardinality === 'one' && field.fields !== undefined) {
+                visit(field.fields, fieldPath);
+            }
+        }
+    };
+    visit(fields, []);
+    return flattened;
+}
+function resolveFieldPath(fields, fieldPath) {
+    return fields.find((candidate) => samePath(candidate.fieldPath, fieldPath));
+}
+function fieldMatchesPort(field, port) {
+    return (fieldIsMultiple(field) === port.multiple && fieldKindMatchesValueType(field, port.valueType));
+}
+function fieldIsMultiple(field) {
+    return field.cardinality === 'many';
+}
+function fieldKindMatchesValueType(field, valueType) {
+    const kind = effectiveFieldKind(field);
+    if (kind === valueType) {
+        return true;
+    }
+    if (valueType === 'text') {
+        return kind === 'string' || kind === 'enum';
+    }
+    if (valueType === 'number') {
+        return kind === 'decimal' || kind === 'integer';
+    }
+    return false;
+}
+function effectiveFieldKind(field) {
+    return field.kind === 'collection' ? (field.itemKind ?? 'object') : field.kind;
+}
+function visitNodes(nodes, visit) {
+    for (const node of nodes) {
+        visit(node);
+        for (const slot of Object.keys(node.slots).sort(compareCodeUnits)) {
+            visitNodes(node.slots[slot] ?? [], visit);
+        }
+    }
+}
+function diagnostic(code, defaultMessage, severity, parameters, location) {
+    return {
+        code,
+        ...(location === undefined ? {} : { location }),
+        message: { defaultMessage, key: code },
+        ...(parameters === undefined ? {} : { parameters }),
+        severity,
+    };
+}
+function blockKey(type, version) {
+    return `${type}@${version}`;
+}
+function samePath(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function compareCodeUnits(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=binding-projection.js.map

package/dist/binding-projection.js.map

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

package/dist/contributions.d.ts

@@ -1,8 +1,15 @@
-import type { BlockDefinition, BlockType, BlueprintDocument, ExtensionLifecycleState, NodeId, OwnerReference, Revision, StudioDiagnostic, UnresolvedContribution, UnresolvedContributionReason } from '@kumwe/studio-protocol';
+import type { BlockDefinition, BlockType, BlueprintDocument, DesignVocabulary, ExtensionLifecycleState, FieldAdapterContribution, InspectorContribution, MigrationDeclaration, NodeId, OwnerReference, PatternDocument, Revision, StudioDiagnostic, UnresolvedContribution, UnresolvedContributionReference, UnresolvedContributionReason } from '@kumwe/studio-protocol';
 import { BlockRegistry } from './registry.js';
 export interface ExtensionContributions {
     blocks: BlockDefinition[];
+    designVocabularies?: DesignVocabulary[];
+    fieldAdapters?: FieldAdapterContribution[];
+    inspectors?: InspectorContribution[];
+    migrations?: MigrationDeclaration[];
+    patterns?: PatternDocument[];
 }
+export type StudioCompositionContributionKind = 'block' | 'design-vocabulary' | 'field-adapter' | 'inspector' | 'migration' | 'pattern';
+export type StudioCompositionContribution = BlockDefinition | DesignVocabulary | FieldAdapterContribution | InspectorContribution | MigrationDeclaration | PatternDocument;
 export interface ExtensionInventory {
     diagnostics: StudioDiagnostic[];
     owner: OwnerReference;
@@ -22,18 +29,29 @@ export declare class StudioContributionError extends Error {
     readonly diagnostics: StudioDiagnostic[];
     constructor(message: string, diagnostics: StudioDiagnostic[]);
 }
+interface ContributionEntry {
+    id: string;
+    kind: StudioCompositionContributionKind;
+    owner: OwnerReference;
+    payload: StudioCompositionContribution;
+    version: string;
+}
 /**
  * One immutable, resolvable registry generation. A generation never changes
  * after publication; lifecycle transitions publish a successor instead.
  */
 export declare class RegistryGeneration {
     #private;
-    constructor(generation: Revision, owners: readonly OwnerReference[], registry: BlockRegistry);
+    constructor(generation: Revision, owners: readonly OwnerReference[], registry: BlockRegistry, contributions?: readonly ContributionEntry[]);
     get generation(): Revision;
     get registry(): BlockRegistry;
     blocks(): BlockDefinition[];
     owners(): OwnerReference[];
     resolveBlock(type: BlockType, version: string): BlockDefinition | undefined;
+    /** Resolve one of the six canonical composition payload kinds by exact identity. */
+    resolveContribution(kind: StudioCompositionContributionKind, id: string, version: string): StudioCompositionContribution | undefined;
+    /** Enumerate one canonical kind in deterministic identity/version order. */
+    contributions(kind: StudioCompositionContributionKind): StudioCompositionContribution[];
 }
 /**
  * The owner-aware contribution runtime. Activation is transactional: a
@@ -61,5 +79,15 @@ export declare class ContributionRuntime {
      * owner.
      */
     unresolvedContributions(document: BlueprintDocument): UnresolvedContribution[];
+    /**
+     * Resolve the lifecycle reason for any canonical contribution reference.
+     * Identity is kind-scoped, so a pattern can never satisfy a field-adapter
+     * reference merely because their IDs and versions match.
+     */
+    unresolvedReference(reference: UnresolvedContributionReference): {
+        owner?: OwnerReference;
+        reason: UnresolvedContributionReason;
+    } | undefined;
 }
+export {};
 //# sourceMappingURL=contributions.d.ts.map

package/dist/contributions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contributions.d.ts","sourceRoot":"","sources":["../src/contributions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,iBAAiB,EAEjB,uBAAuB,EACvB,MAAM,EACN,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,KAAK,EAAE,uBAAuB,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,QAAQ,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,4BAA4B,CAAC;IACrC,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAgB,WAAW,EAAE,gBAAgB,EAAE,CAAC;gBAE7B,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,gBAAgB,EAAE;CAKpE;AASD;;;GAGG;AACH,qBAAa,kBAAkB;;gBAM3B,UAAU,EAAE,QAAQ,EACpB,MAAM,EAAE,SAAS,cAAc,EAAE,EACjC,QAAQ,EAAE,aAAa;IAOzB,IAAW,UAAU,IAAI,QAAQ,CAEhC;IAED,IAAW,QAAQ,IAAI,aAAa,CAEnC;IAEM,MAAM,IAAI,eAAe,EAAE;IAI3B,MAAM,IAAI,cAAc,EAAE;IAI1B,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;CAGnF;AAiBD;;;;;;;GAOG;AACH,qBAAa,mBAAmB;;gBAIX,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC;IAIvD,IAAW,OAAO,IAAI,kBAAkB,CAEvC;IAEM,QAAQ,CACb,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAC/C,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACnC,kBAAkB;IA8Bd,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,kBAAkB;IAOlF,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,kBAAkB;IAarF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,kBAAkB;IAUtF,aAAa,CAAC,UAAU,EAAE,QAAQ,GAAG,kBAAkB;IAUvD,SAAS,IAAI,kBAAkB,EAAE;IAUjC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,oBAAoB,EAAE;IA4B3E;;;;;OAKG;IACI,uBAAuB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,sBAAsB,EAAE;CAgKtF"}
+{"version":3,"file":"contributions.d.ts","sourceRoot":"","sources":["../src/contributions.ts"],"names":[],"mappings":"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"}