@kumwe/studio-core 0.1.0-alpha.10

package/dist/entry-commands.js

@@ -0,0 +1,36 @@
+import { cloneContractValue } from './clone.js';
+import { StudioCommandError } from './commands.js';
+export function applyEntryCommand(entry, command) {
+    if (command.artifactId !== entry.id) {
+        throw new StudioCommandError('node-not-found', `Command targets ${command.artifactId}, not entry ${entry.id}.`);
+    }
+    if (command.payload.locale !== undefined &&
+        entry.locale !== undefined &&
+        command.payload.locale !== entry.locale) {
+        throw new StudioCommandError('locale-mismatch', `Command targets locale ${command.payload.locale}, but the entry stores ${entry.locale}.`);
+    }
+    const next = cloneContractValue(entry);
+    const path = command.payload.fieldPath;
+    let container = next.values;
+    for (const [index, segment] of path.entries()) {
+        if (index === path.length - 1) {
+            setOwnMember(container, segment, cloneContractValue(command.payload.value));
+            break;
+        }
+        const child = Object.hasOwn(container, segment) ? container[segment] : undefined;
+        if (child === null || typeof child !== 'object' || Array.isArray(child)) {
+            throw new StudioCommandError('property-not-found', `Field path segment ${segment} does not resolve to an object value.`);
+        }
+        container = child;
+    }
+    return next;
+}
+function setOwnMember(container, member, value) {
+    Object.defineProperty(container, member, {
+        configurable: true,
+        enumerable: true,
+        value,
+        writable: true,
+    });
+}
+//# sourceMappingURL=entry-commands.js.map

package/dist/entry-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-commands.js","sourceRoot":"","sources":["../src/entry-commands.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,UAAU,iBAAiB,CAC/B,KAAoB,EACpB,OAA6B;IAE7B,IAAI,OAAO,CAAC,UAAU,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,kBAAkB,CAC1B,gBAAgB,EAChB,mBAAmB,OAAO,CAAC,UAAU,eAAe,KAAK,CAAC,EAAE,GAAG,CAChE,CAAC;IACJ,CAAC;IACD,IACE,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS;QACpC,KAAK,CAAC,MAAM,KAAK,SAAS;QAC1B,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EACvC,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,iBAAiB,EACjB,0BAA0B,OAAO,CAAC,OAAO,CAAC,MAAM,0BAA0B,KAAK,CAAC,MAAM,GAAG,CAC1F,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,IAAI,SAAS,GAAe,IAAI,CAAC,MAAM,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9C,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,YAAY,CAAC,SAAS,EAAE,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAC5E,MAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,kBAAkB,CAC1B,oBAAoB,EACpB,sBAAsB,OAAO,uCAAuC,CACrE,CAAC;QACJ,CAAC;QACD,SAAS,GAAG,KAAK,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,SAAqB,EAAE,MAAc,EAAE,KAAgB;IAC3E,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE;QACvC,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,IAAI;QAChB,KAAK;QACL,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/extension-sdk.d.ts

@@ -0,0 +1,51 @@
+import type { BlockDefinition, DesignVocabulary, FieldAdapterContribution, InspectorContribution, MigrationDeclaration, PatternDocument, PluginManifest, UnresolvedContribution, UnresolvedContributionReference } from '@kumwe/studio-protocol';
+import { ContributionRuntime, type GenerationOptions, type RegistryGeneration } from './contributions.js';
+/**
+ * One authored Studio plugin: the declarative manifest plus the concrete
+ * canonical composition payloads the manifest declares. All six payload
+ * families are validated and activated transactionally; other manifest kinds
+ * remain resource-backed host declarations.
+ */
+export interface StudioPluginDefinition {
+    blocks?: readonly BlockDefinition[];
+    designVocabularies?: readonly DesignVocabulary[];
+    fieldAdapters?: readonly FieldAdapterContribution[];
+    inspectors?: readonly InspectorContribution[];
+    manifest: PluginManifest;
+    migrations?: readonly MigrationDeclaration[];
+    patterns?: readonly PatternDocument[];
+}
+/**
+ * The typed authoring entry point for extension developers. At compile time
+ * this is an identity function: the argument is checked against the closed
+ * protocol types, so a typo is an editor error. At runtime it front-loads
+ * activation: the canonical plugin-manifest schema, the namespace and
+ * declaration coherence rules of the plugin contract, and the contribution
+ * runtime's own activation checks (applied through a dry-run activation, not
+ * a reimplementation). It adds no invariant of its own — everything it
+ * rejects would be rejected identically at activation. Violations throw the
+ * runtime's `StudioContributionError` with blocking diagnostics; the
+ * validated definition is deep-frozen and returned.
+ */
+export declare function defineStudioPlugin<TDefinition extends StudioPluginDefinition>(definition: TDefinition): TDefinition;
+/**
+ * Activate an authored plugin definition on a contribution runtime. The
+ * manifest-level coherence checks run first and fail closed before the
+ * runtime transaction begins; the runtime then applies its own activation
+ * rules unchanged, so a rejected definition never disturbs the active
+ * generation.
+ */
+export declare function activateStudioPlugin(runtime: ContributionRuntime, definition: StudioPluginDefinition, options: Readonly<GenerationOptions>): RegistryGeneration;
+/**
+ * The portable unresolved-contribution documents for declared, non-block
+ * contribution references (field adapters, patterns, transforms, renderer
+ * capabilities, and the other manifest kinds). This mirrors the reason
+ * mapping the runtime applies to Blueprint block nodes, lifted from
+ * registered block versions to manifest declarations: an unknown id is
+ * `not-installed`, an undeclared version is `incompatible`, a trust-revoked
+ * owner is `owner-revoked`, and any other inactive owner is
+ * `owner-disabled`. References the current generation resolves produce no
+ * document.
+ */
+export declare function unresolvedDeclaredContributions(runtime: ContributionRuntime, plugins: readonly StudioPluginDefinition[], references: readonly UnresolvedContributionReference[]): UnresolvedContribution[];
+//# sourceMappingURL=extension-sdk.d.ts.map

package/dist/extension-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-sdk.d.ts","sourceRoot":"","sources":["../src/extension-sdk.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAEhB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EAEpB,eAAe,EAEf,cAAc,EAGd,sBAAsB,EAEtB,+BAA+B,EAChC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EAGnB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,oBAAoB,CAAC;AAG5B;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,kBAAkB,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACjD,aAAa,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACpD,UAAU,CAAC,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAC9C,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC7C,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACvC;AAeD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,SAAS,sBAAsB,EAC3E,UAAU,EAAE,WAAW,GACtB,WAAW,CAOb;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAC5B,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GACnC,kBAAkB,CAGpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,EAAE,SAAS,sBAAsB,EAAE,EAC1C,UAAU,EAAE,SAAS,+BAA+B,EAAE,GACrD,sBAAsB,EAAE,CAsC1B"}

package/dist/extension-sdk.js

@@ -0,0 +1,260 @@
+import { commonSchema, pluginManifestSchema, STUDIO_CONTRACT_VERSION, } from '@kumwe/studio-protocol';
+import { cloneContractValue } from './clone.js';
+import { ContributionRuntime, StudioContributionError, } from './contributions.js';
+import { compileProfileSchema } from './profile-validator.js';
+const validateManifestSchema = compileProfileSchema(pluginManifestSchema, {
+    schemas: [commonSchema],
+});
+const canonicalContributionKinds = new Set([
+    'block',
+    'design-vocabulary',
+    'field-adapter',
+    'inspector',
+    'migration',
+    'pattern',
+]);
+/**
+ * The typed authoring entry point for extension developers. At compile time
+ * this is an identity function: the argument is checked against the closed
+ * protocol types, so a typo is an editor error. At runtime it front-loads
+ * activation: the canonical plugin-manifest schema, the namespace and
+ * declaration coherence rules of the plugin contract, and the contribution
+ * runtime's own activation checks (applied through a dry-run activation, not
+ * a reimplementation). It adds no invariant of its own — everything it
+ * rejects would be rejected identically at activation. Violations throw the
+ * runtime's `StudioContributionError` with blocking diagnostics; the
+ * validated definition is deep-frozen and returned.
+ */
+export function defineStudioPlugin(definition) {
+    assertCoherentDefinition(definition);
+    const dryRun = new ContributionRuntime({ generation: 'authoring-mirror-0' });
+    dryRun.activate(definition.manifest.owner, mutableContributions(definition), {
+        generation: 'authoring-mirror-1',
+    });
+    return deepFreeze(definition);
+}
+/**
+ * Activate an authored plugin definition on a contribution runtime. The
+ * manifest-level coherence checks run first and fail closed before the
+ * runtime transaction begins; the runtime then applies its own activation
+ * rules unchanged, so a rejected definition never disturbs the active
+ * generation.
+ */
+export function activateStudioPlugin(runtime, definition, options) {
+    assertCoherentDefinition(definition);
+    return runtime.activate(definition.manifest.owner, mutableContributions(definition), options);
+}
+/**
+ * The portable unresolved-contribution documents for declared, non-block
+ * contribution references (field adapters, patterns, transforms, renderer
+ * capabilities, and the other manifest kinds). This mirrors the reason
+ * mapping the runtime applies to Blueprint block nodes, lifted from
+ * registered block versions to manifest declarations: an unknown id is
+ * `not-installed`, an undeclared version is `incompatible`, a trust-revoked
+ * owner is `owner-revoked`, and any other inactive owner is
+ * `owner-disabled`. References the current generation resolves produce no
+ * document.
+ */
+export function unresolvedDeclaredContributions(runtime, plugins, references) {
+    const states = new Map(runtime.inventory().map((entry) => [entry.owner.id, entry.state]));
+    const unresolved = [];
+    const seen = new Set();
+    for (const reference of references) {
+        const key = `${reference.contribution}:${reference.id}@${reference.version}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        const resolution = canonicalContributionKinds.has(reference.contribution)
+            ? runtime.unresolvedReference(reference)
+            : resolveDeclaredReference(states, plugins, reference);
+        if (resolution === undefined) {
+            continue;
+        }
+        const document = {
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            diagnostics: [
+                {
+                    code: 'studio.validation/contribution-unavailable',
+                    message: {
+                        defaultMessage: `The ${reference.id} ${reference.contribution} contribution is currently unavailable; its content is preserved.`,
+                        key: 'studio.validation/contribution-unavailable',
+                    },
+                    severity: 'warning',
+                },
+            ],
+            kind: 'unresolved-contribution',
+            reason: resolution.reason,
+            reference: cloneContractValue(reference),
+        };
+        if (resolution.owner !== undefined) {
+            document.owner = cloneContractValue(resolution.owner);
+        }
+        unresolved.push(document);
+    }
+    return unresolved;
+}
+function resolveDeclaredReference(states, plugins, reference) {
+    for (const plugin of plugins) {
+        const versions = plugin.manifest.contributions
+            .filter((contribution) => contribution.kind === reference.contribution && contribution.id === reference.id)
+            .map((contribution) => contribution.version);
+        if (versions.length === 0) {
+            continue;
+        }
+        const owner = plugin.manifest.owner;
+        const state = states.get(owner.id);
+        if (state === undefined) {
+            return { reason: 'not-installed' };
+        }
+        if (!versions.includes(reference.version)) {
+            return { owner, reason: 'incompatible' };
+        }
+        if (state === 'trust-revoked') {
+            return { owner, reason: 'owner-revoked' };
+        }
+        if (state === 'active') {
+            return undefined;
+        }
+        return { owner, reason: 'owner-disabled' };
+    }
+    return { reason: 'not-installed' };
+}
+function assertCoherentDefinition(definition) {
+    const diagnostics = collectDefinitionDiagnostics(definition);
+    if (diagnostics.length > 0) {
+        throw new StudioContributionError(`Definition of ${definition.manifest.id} was rejected: ${diagnostics
+            .map((diagnostic) => diagnostic.code)
+            .join(', ')}.`, diagnostics);
+    }
+}
+function collectDefinitionDiagnostics(definition) {
+    const diagnostics = [];
+    const manifest = definition.manifest;
+    if (!validateManifestSchema.validate(manifest)) {
+        for (const error of validateManifestSchema.errors ?? []) {
+            diagnostics.push(coherenceDiagnostic('studio.contribution/invalid-manifest', `Manifest ${error.instancePath === '' ? 'document' : error.instancePath} ${error.message}.`, error.instancePath === '' ? undefined : error.instancePath));
+        }
+        return diagnostics;
+    }
+    const namespace = namespaceOf(manifest.id);
+    const declared = new Set();
+    for (const contribution of manifest.contributions) {
+        if (!isUnderNamespace(contribution.id, namespace)) {
+            diagnostics.push(coherenceDiagnostic('studio.contribution/foreign-namespace', `Contribution ${contribution.id} is outside the ${namespace} namespace owned by ${manifest.id}.`));
+        }
+        const key = declarationKey(contribution.kind, contribution.id, contribution.version);
+        if (declared.has(key)) {
+            diagnostics.push(coherenceDiagnostic('studio.contribution/duplicate-contribution', `${contribution.kind} contribution ${contribution.id}@${contribution.version} is declared twice by ${manifest.id}.`));
+        }
+        declared.add(key);
+        if (contribution.executable === true && manifest.activation !== 'executable') {
+            diagnostics.push(coherenceDiagnostic('studio.contribution/undeclared-executable', `Contribution ${contribution.id} is executable, but ${manifest.id} declares declarative activation.`));
+        }
+    }
+    const declaredCapabilities = new Set([...manifest.requiredCapabilities, ...manifest.optionalCapabilities].map((capability) => capability.id));
+    const payloadEntries = definitionContributionEntries(definition);
+    const payloadKeys = new Set();
+    for (const entry of payloadEntries) {
+        const key = declarationKey(entry.kind, entry.id, entry.version);
+        payloadKeys.add(key);
+        if (!declared.has(key)) {
+            diagnostics.push(coherenceDiagnostic('studio.contribution/undeclared-registration', `${entry.kind} ${entry.id}@${entry.version} is not declared by ${manifest.id}.`));
+        }
+        for (const capability of entry.requiredCapabilities) {
+            if (!declaredCapabilities.has(capability)) {
+                diagnostics.push(coherenceDiagnostic('studio.contribution/undeclared-capability', `${entry.kind} ${entry.id} requires the ${capability} capability, which ${manifest.id} does not declare.`));
+            }
+        }
+    }
+    for (const contribution of manifest.contributions) {
+        if (canonicalContributionKinds.has(contribution.kind) &&
+            !payloadKeys.has(declarationKey(contribution.kind, contribution.id, contribution.version))) {
+            diagnostics.push(coherenceDiagnostic('studio.contribution/missing-registration', `${contribution.kind} ${contribution.id}@${contribution.version} has no canonical payload in ${manifest.id}.`));
+        }
+    }
+    return diagnostics;
+}
+function definitionContributionEntries(definition) {
+    return [
+        ...(definition.blocks ?? []).map((payload) => ({
+            id: payload.type,
+            kind: 'block',
+            requiredCapabilities: payload.rendererRequirements.map((requirement) => requirement.capability),
+            version: payload.version,
+        })),
+        ...(definition.designVocabularies ?? []).map((payload) => ({
+            id: payload.id,
+            kind: 'design-vocabulary',
+            requiredCapabilities: [],
+            version: payload.version,
+        })),
+        ...(definition.fieldAdapters ?? []).map((payload) => ({
+            id: payload.id,
+            kind: 'field-adapter',
+            requiredCapabilities: payload.requiredCapability === undefined ? [] : [payload.requiredCapability],
+            version: payload.version,
+        })),
+        ...(definition.inspectors ?? []).map((payload) => ({
+            id: payload.id,
+            kind: 'inspector',
+            requiredCapabilities: payload.requiredCapability === undefined ? [] : [payload.requiredCapability],
+            version: payload.version,
+        })),
+        ...(definition.migrations ?? []).map((payload) => ({
+            id: payload.id,
+            kind: 'migration',
+            requiredCapabilities: [],
+            version: payload.version,
+        })),
+        ...(definition.patterns ?? []).map((payload) => ({
+            id: payload.id,
+            kind: 'pattern',
+            requiredCapabilities: [],
+            version: payload.version,
+        })),
+    ];
+}
+function mutableContributions(definition) {
+    return {
+        blocks: [...(definition.blocks ?? [])],
+        designVocabularies: [...(definition.designVocabularies ?? [])],
+        fieldAdapters: [...(definition.fieldAdapters ?? [])],
+        inspectors: [...(definition.inspectors ?? [])],
+        migrations: [...(definition.migrations ?? [])],
+        patterns: [...(definition.patterns ?? [])],
+    };
+}
+function declarationKey(kind, id, version) {
+    return `${kind}\u0000${id}\u0000${version}`;
+}
+function namespaceOf(id) {
+    const separator = id.indexOf('/');
+    return separator === -1 ? id : id.slice(0, separator);
+}
+function isUnderNamespace(id, namespace) {
+    const candidate = namespaceOf(id);
+    return candidate === namespace || candidate.startsWith(`${namespace}.`);
+}
+function coherenceDiagnostic(code, message, jsonPointer) {
+    const diagnostic = {
+        code,
+        message: { defaultMessage: message, key: 'studio.contribution/activation' },
+        severity: 'blocking',
+    };
+    if (jsonPointer !== undefined) {
+        diagnostic.location = { jsonPointer };
+    }
+    return diagnostic;
+}
+function deepFreeze(value) {
+    if (value === null || typeof value !== 'object' || Object.isFrozen(value)) {
+        return value;
+    }
+    Object.freeze(value);
+    for (const entry of Object.values(value)) {
+        deepFreeze(entry);
+    }
+    return value;
+}
+//# sourceMappingURL=extension-sdk.js.map

package/dist/extension-sdk.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,22 @@
+import type { BlueprintCommand, BlueprintDocument, Revision } from '@kumwe/studio-protocol';
+export declare class StudioHistory {
+    #private;
+    constructor(document: BlueprintDocument, maximumEntries?: number);
+    get canRedo(): boolean;
+    get canUndo(): boolean;
+    get current(): BlueprintDocument;
+    get stateVersion(): number;
+    /**
+     * Advances the host-authored revision carried by every local snapshot.
+     *
+     * A successful optimistic save establishes one new base revision for the
+     * complete local timeline. Rebasing the current, past, and future snapshots
+     * keeps later commands and preview staging on that base without fabricating
+     * an edit, changing the history topology, or advancing `stateVersion`.
+     */
+    rebaseRevision(revision: Revision): BlueprintDocument;
+    execute(command: BlueprintCommand): BlueprintDocument;
+    redo(): BlueprintDocument;
+    undo(): BlueprintDocument;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAI5F,qBAAa,aAAa;;gBAOL,QAAQ,EAAE,iBAAiB,EAAE,cAAc,SAAM;IAQpE,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,OAAO,IAAI,iBAAiB,CAEtC;IAED,IAAW,YAAY,IAAI,MAAM,CAEhC;IAED;;;;;;;OAOG;IACI,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB;IAWrD,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB;IAkBrD,IAAI,IAAI,iBAAiB;IAWzB,IAAI,IAAI,iBAAiB;CAUjC"}

package/dist/history.js

@@ -0,0 +1,81 @@
+import { applyCommand, StudioCommandError } from './commands.js';
+import { cloneContractValue } from './clone.js';
+export class StudioHistory {
+    #maximumEntries;
+    #current;
+    #future = [];
+    #past = [];
+    #stateVersion = 0;
+    constructor(document, maximumEntries = 100) {
+        if (!Number.isInteger(maximumEntries) || maximumEntries < 1) {
+            throw new RangeError('History maximum must be a positive integer.');
+        }
+        this.#current = cloneContractValue(document);
+        this.#maximumEntries = maximumEntries;
+    }
+    get canRedo() {
+        return this.#future.length > 0;
+    }
+    get canUndo() {
+        return this.#past.length > 0;
+    }
+    get current() {
+        return cloneContractValue(this.#current);
+    }
+    get stateVersion() {
+        return this.#stateVersion;
+    }
+    /**
+     * Advances the host-authored revision carried by every local snapshot.
+     *
+     * A successful optimistic save establishes one new base revision for the
+     * complete local timeline. Rebasing the current, past, and future snapshots
+     * keeps later commands and preview staging on that base without fabricating
+     * an edit, changing the history topology, or advancing `stateVersion`.
+     */
+    rebaseRevision(revision) {
+        const rebase = (document) => ({
+            ...document,
+            revision,
+        });
+        this.#current = rebase(this.#current);
+        this.#past = this.#past.map(rebase);
+        this.#future = this.#future.map(rebase);
+        return this.current;
+    }
+    execute(command) {
+        if (command.baseStateVersion !== this.#stateVersion) {
+            throw new StudioCommandError('stale-state', `Command state ${command.baseStateVersion} does not match ${this.#stateVersion}.`);
+        }
+        const next = applyCommand(this.#current, command);
+        this.#past.push(this.#current);
+        if (this.#past.length > this.#maximumEntries) {
+            this.#past.shift();
+        }
+        this.#current = next;
+        this.#future = [];
+        this.#stateVersion += 1;
+        return this.current;
+    }
+    redo() {
+        const next = this.#future.pop();
+        if (next === undefined) {
+            return this.current;
+        }
+        this.#past.push(this.#current);
+        this.#current = next;
+        this.#stateVersion += 1;
+        return this.current;
+    }
+    undo() {
+        const previous = this.#past.pop();
+        if (previous === undefined) {
+            return this.current;
+        }
+        this.#future.push(this.#current);
+        this.#current = previous;
+        this.#stateVersion += 1;
+        return this.current;
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/host-session.d.ts

@@ -0,0 +1,74 @@
+import { type ArtifactReference, type ContentModelDocument, type HostAdapter, type HostPortResult, type JsonObject, type QualifiedName, type ResourceSearchPage, type ResourceSearchQuery, type Revision, type StableId, type StudioConfiguration, type StudioDiagnostic } from '@kumwe/studio-protocol';
+import { type CapabilityNegotiationResult } from './negotiation.js';
+import { StudioSession } from './session.js';
+/** Public bounds enforced before a composed session invokes resource search. */
+export declare const STUDIO_RESOURCE_SEARCH_LIMITS: Readonly<{
+    maximumCursorLength: number;
+    maximumLimit: number;
+    maximumSearchLength: number;
+    minimumLimit: number;
+}>;
+export interface StudioHostSessionIdentifierFactories {
+    /** Allocates a session-unique request identifier for one host attempt. */
+    requestId(operationId: QualifiedName): StableId;
+    /** Allocates a mutation identifier; exact failed-intent retries reuse it. */
+    idempotencyKey(operationId: QualifiedName): StableId;
+}
+export interface OpenStudioSessionOptions {
+    /** A schema-valid, resolved, immutable configuration supplied by the host. */
+    configuration: StudioConfiguration;
+    /** Injected so core never depends on clocks, randomness, DOM, or Node APIs. */
+    identifiers: StudioHostSessionIdentifierFactories;
+    /** Additional port capabilities whose absence should be diagnosed as degradation. */
+    optionalPorts?: readonly QualifiedName[];
+}
+export interface StudioHostSessionRecovery {
+    discard(): Promise<HostPortResult<null>>;
+    load(): Promise<HostPortResult<JsonObject | null>>;
+    store(envelope: JsonObject): Promise<HostPortResult<null>>;
+}
+/** Read-only access to the authorized model projection behind this session. */
+export interface StudioHostSessionModels {
+    get(reference: ArtifactReference): Promise<HostPortResult<ContentModelDocument>>;
+    list(): Promise<HostPortResult<ContentModelDocument[]>>;
+}
+/** Read-only discovery of host-authorized resources behind this session. */
+export interface StudioHostSessionResources {
+    search(query: ResourceSearchQuery): Promise<HostPortResult<ResourceSearchPage>>;
+}
+export interface StudioHostSessionHandle {
+    /** The complete open-time negotiation and profile diagnostics. */
+    readonly diagnostics: readonly StudioDiagnostic[];
+    readonly disposed: boolean;
+    readonly invalidated: boolean;
+    readonly negotiation: CapabilityNegotiationResult;
+    /** Present only when the model port advertises and implements both read operations. */
+    readonly models: StudioHostSessionModels | undefined;
+    /** Present only when feature policy, advertised operations, and adapter agree. */
+    readonly recovery: StudioHostSessionRecovery | undefined;
+    /** Present only when the resource port advertises and implements search. */
+    readonly resources: StudioHostSessionResources | undefined;
+    /** The most recent host-accepted Blueprint revision. */
+    readonly revision: Revision;
+    readonly session: StudioSession;
+    /** Local, idempotent teardown. It never invents a host teardown operation. */
+    dispose(): void;
+    save(): Promise<HostPortResult<null>>;
+}
+export type StudioHostSessionErrorCode = 'configuration-blocked' | 'disposed' | 'invalid-identifier' | 'invalid-model-reference' | 'invalid-resource-query' | 'read-only-session' | 'unexpected-artifact';
+/** A local composition/state failure, distinct from a host-port rejection. */
+export declare class StudioHostSessionError extends Error {
+    readonly code: StudioHostSessionErrorCode;
+    readonly diagnostics: readonly StudioDiagnostic[];
+    constructor(code: StudioHostSessionErrorCode, message: string, diagnostics?: readonly StudioDiagnostic[]);
+}
+/**
+ * Composes the DOM-free editing engine with one resolved host configuration.
+ *
+ * The current contract-safe profile opens a single Blueprint only. It does
+ * not fabricate entry/model state, infer a transport, stage preview drafts,
+ * or reconcile recovery data. Those capabilities require their own explicit
+ * contracts.
+ */
+export declare function openStudioSession(adapter: HostAdapter, options: Readonly<OpenStudioSessionOptions>): Promise<StudioHostSessionHandle>;
+//# sourceMappingURL=host-session.d.ts.map

package/dist/host-session.d.ts.map

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