@kumwe/studio-testkit 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/http-host-adapter.d.ts

@@ -0,0 +1,74 @@
+import { type HostAdapter } from '@kumwe/studio-protocol';
+/**
+ * Minimal structural view of an HTTP response the adapter needs: the status
+ * code and the raw body text. Deliberately narrower than any platform
+ * response class so implementations from any runtime satisfy it.
+ */
+export interface HttpResponseLike {
+    status: number;
+    text(): Promise<string>;
+}
+/** The request shape the adapter hands to the injected transport. */
+export interface HttpRequestInit {
+    body: string;
+    headers: Record<string, string>;
+    method: 'POST';
+    /** Opaque abort signal produced by the injected timeout factory, if any. */
+    signal?: unknown;
+}
+/**
+ * The injected fetch-like transport — the adapter's portability seam.
+ *
+ * Testkit source is deliberately free of host globals (no fetch, no DOM, no
+ * Node), so the embedder supplies the platform transport: a Node test injects
+ * a `node:http`-backed implementation, a browser host would inject the
+ * platform fetch, and either stays outside this package. The function must
+ * resolve with the terminal HTTP response (any status) and reject only for
+ * transport-level failures: network refusal, connection loss, or an abort
+ * raised by the injected timeout signal.
+ */
+export type HttpFetchLike = (url: string, init: HttpRequestInit) => Promise<HttpResponseLike>;
+/**
+ * An abort signal handle minted per request by the injected timeout factory.
+ * `signal` is passed through to the transport untouched; `release` (when
+ * present) is invoked once the request settles so timer-backed factories can
+ * clean up.
+ */
+export interface HttpTimeoutHandle {
+    release?(): void;
+    signal: unknown;
+}
+export interface HttpHostAdapterOptions {
+    /**
+     * Second half of the portability seam: mints the per-request timeout
+     * signal. When omitted, requests carry no deadline. A rejection whose
+     * reason is named `AbortError` or `TimeoutError` is mapped to the canonical
+     * deadline failure.
+     */
+    createTimeoutSignal?: (timeoutMilliseconds: number) => HttpTimeoutHandle;
+    fetchImplementation: HttpFetchLike;
+    /** Transport deadline handed to `createTimeoutSignal`. Defaults to 10 000. */
+    timeoutMilliseconds?: number;
+}
+/**
+ * A `HostAdapter` that speaks JSON over an injected fetch-like transport to a
+ * host server: every port operation becomes
+ * `POST {baseUrl}/ports/{port}/{operation}` with a
+ * `{ arguments, context }` JSON body.
+ *
+ * Success responses (2xx) must carry a `HostPortResult` JSON body. Failure
+ * responses that carry a guard-conforming `HostPortError` body are re-thrown
+ * as that canonical error, so a host-authored category (with its safe
+ * revision on conflicts) crosses the transport intact. Everything else is
+ * mapped onto the canonical host error categories without disclosing
+ * transport details: network refusal and deadline expiry become
+ * `unavailable`, HTTP statuses map by class (401 `unauthenticated`, 403
+ * `forbidden`, 404 `not-found`, 409 `conflict`, 413 `limit-exceeded`, 422
+ * `validation-failed`, 429 `rate-limited`, 5xx `internal`/`unavailable`), and
+ * a malformed body — unparseable JSON, a result without `value`, or an error
+ * document the guard rejects — becomes `internal`. Every rejection is a
+ * `TestbedHostError` whose `error` satisfies `isHostPortError`, and no
+ * message ever echoes response bodies, addresses, or underlying reasons.
+ */
+export declare function createHttpHostAdapter(baseUrl: string, options: HttpHostAdapterOptions): HostAdapter;
+//# sourceMappingURL=http-host-adapter.d.ts.map

package/dist/http-host-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-host-adapter.d.ts","sourceRoot":"","sources":["../src/http-host-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,WAAW,EAkBjB,MAAM,wBAAwB,CAAC;AAGhC;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE9F;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,IAAI,IAAI,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,iBAAiB,CAAC;IACzE,mBAAmB,EAAE,aAAa,CAAC;IACnC,8EAA8E;IAC9E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AASD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,sBAAsB,GAC9B,WAAW,CAmKb"}

package/dist/http-host-adapter.js

@@ -0,0 +1,241 @@
+import { isHostPortError, STUDIO_CONTRACT_VERSION, } from '@kumwe/studio-protocol';
+import { TestbedHostError } from './host-testbed.js';
+/**
+ * A `HostAdapter` that speaks JSON over an injected fetch-like transport to a
+ * host server: every port operation becomes
+ * `POST {baseUrl}/ports/{port}/{operation}` with a
+ * `{ arguments, context }` JSON body.
+ *
+ * Success responses (2xx) must carry a `HostPortResult` JSON body. Failure
+ * responses that carry a guard-conforming `HostPortError` body are re-thrown
+ * as that canonical error, so a host-authored category (with its safe
+ * revision on conflicts) crosses the transport intact. Everything else is
+ * mapped onto the canonical host error categories without disclosing
+ * transport details: network refusal and deadline expiry become
+ * `unavailable`, HTTP statuses map by class (401 `unauthenticated`, 403
+ * `forbidden`, 404 `not-found`, 409 `conflict`, 413 `limit-exceeded`, 422
+ * `validation-failed`, 429 `rate-limited`, 5xx `internal`/`unavailable`), and
+ * a malformed body — unparseable JSON, a result without `value`, or an error
+ * document the guard rejects — becomes `internal`. Every rejection is a
+ * `TestbedHostError` whose `error` satisfies `isHostPortError`, and no
+ * message ever echoes response bodies, addresses, or underlying reasons.
+ */
+export function createHttpHostAdapter(baseUrl, options) {
+    const base = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+    const timeoutMilliseconds = options.timeoutMilliseconds ?? 10_000;
+    let correlationSerial = 0;
+    function createError(failure) {
+        correlationSerial += 1;
+        const error = {
+            category: failure.category,
+            contractVersion: STUDIO_CONTRACT_VERSION,
+            correlationId: `http-transport-${correlationSerial}`,
+            kind: 'host-error',
+            message: { defaultMessage: failure.defaultMessage, key: failure.key },
+            retryable: failure.retryable,
+        };
+        return new TestbedHostError(error);
+    }
+    async function call(portName, operation, callArguments, context) {
+        const handle = options.createTimeoutSignal?.(timeoutMilliseconds);
+        let response;
+        try {
+            response = await options.fetchImplementation(`${base}/ports/${portName}/${operation}`, {
+                body: JSON.stringify({ arguments: callArguments, context }),
+                headers: { 'content-type': 'application/json' },
+                method: 'POST',
+                ...(handle === undefined ? {} : { signal: handle.signal }),
+            });
+        }
+        catch (reason) {
+            throw createError(classifyTransportFailure(reason));
+        }
+        finally {
+            handle?.release?.();
+        }
+        let bodyText;
+        try {
+            bodyText = await response.text();
+        }
+        catch {
+            throw createError(malformedResponse());
+        }
+        if (response.status >= 200 && response.status < 300) {
+            const parsed = parseJson(bodyText);
+            if (!isHostPortResult(parsed)) {
+                throw createError(malformedResponse());
+            }
+            const result = {
+                ...(parsed.revision === undefined ? {} : { revision: parsed.revision }),
+                value: parsed.value,
+            };
+            return result;
+        }
+        const parsed = parseJson(bodyText);
+        if (isHostPortError(parsed)) {
+            // The host authored a canonical error; transport it verbatim.
+            throw new TestbedHostError(parsed);
+        }
+        throw createError(statusFailure(response.status));
+    }
+    return {
+        artifact: {
+            dependencies(reference, context) {
+                return call('artifact', 'dependencies', { reference: asJson(reference) }, context);
+            },
+            load(reference, context) {
+                return call('artifact', 'load', { reference: asJson(reference) }, context);
+            },
+            publish(reference, context) {
+                return call('artifact', 'publish', { reference: asJson(reference) }, context);
+            },
+            save(document, context) {
+                return call('artifact', 'save', { document: asJson(document) }, context);
+            },
+            unpublish(reference, context) {
+                return call('artifact', 'unpublish', { reference: asJson(reference) }, context);
+            },
+        },
+        localization: {
+            messages(locale, namespaces, context) {
+                return call('localization', 'messages', { locale, namespaces }, context);
+            },
+        },
+        media: {
+            get(assetId, context) {
+                return call('media', 'get', { assetId }, context);
+            },
+            list(query, context) {
+                return call('media', 'list', { query: asJson(query) }, context);
+            },
+        },
+        permission: {
+            explain(operation, context) {
+                return call('permission', 'explain', { operation }, context);
+            },
+            refresh(context) {
+                return call('permission', 'refresh', {}, context);
+            },
+        },
+        preview: {
+            cancel(draftDigest, context) {
+                return call('preview', 'cancel', { draftDigest }, context);
+            },
+            render(payload, context) {
+                return call('preview', 'render', { payload: asJson(payload) }, context);
+            },
+        },
+        recovery: {
+            discard(context) {
+                return call('recovery', 'discard', {}, context);
+            },
+            load(context) {
+                return call('recovery', 'load', {}, context);
+            },
+            store(envelope, context) {
+                return call('recovery', 'store', { envelope }, context);
+            },
+        },
+        resource: {
+            search(query, context) {
+                return call('resource', 'search', { query: asJson(query) }, context);
+            },
+        },
+        telemetry: {
+            emit(event, context) {
+                return call('telemetry', 'emit', { event: asJson(event) }, context);
+            },
+        },
+    };
+}
+/** Serializable typed values cross the wire as their JSON projections. */
+function asJson(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+function parseJson(text) {
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return undefined;
+    }
+}
+function isHostPortResult(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        return false;
+    }
+    const record = value;
+    if (!Object.hasOwn(record, 'value')) {
+        return false;
+    }
+    const revision = record.revision;
+    if (revision !== undefined && (typeof revision !== 'string' || revision.length === 0)) {
+        return false;
+    }
+    return Object.keys(record).every((key) => key === 'value' || key === 'revision');
+}
+function classifyTransportFailure(reason) {
+    const name = typeof reason === 'object' && reason !== null && 'name' in reason ? reason.name : undefined;
+    if (name === 'AbortError' || name === 'TimeoutError') {
+        // The injected deadline signal fired before the host answered.
+        return {
+            category: 'unavailable',
+            defaultMessage: 'The host did not respond within the transport deadline.',
+            key: 'studio.testkit/http-timeout',
+            retryable: true,
+        };
+    }
+    return {
+        category: 'unavailable',
+        defaultMessage: 'The host could not be reached.',
+        key: 'studio.testkit/http-unreachable',
+        retryable: true,
+    };
+}
+function malformedResponse() {
+    return {
+        category: 'internal',
+        defaultMessage: 'The host response could not be interpreted.',
+        key: 'studio.testkit/http-malformed-response',
+        retryable: false,
+    };
+}
+function statusFailure(status) {
+    const category = categoryForStatus(status);
+    return {
+        category,
+        defaultMessage: 'The host rejected the request.',
+        key: `studio.testkit/http-status-${category}`,
+        retryable: category === 'rate-limited' || category === 'unavailable',
+    };
+}
+function categoryForStatus(status) {
+    switch (status) {
+        case 401:
+            return 'unauthenticated';
+        case 403:
+            return 'forbidden';
+        case 404:
+            return 'not-found';
+        case 408:
+            return 'unavailable';
+        case 409:
+            return 'conflict';
+        case 413:
+            return 'limit-exceeded';
+        case 422:
+            return 'validation-failed';
+        case 429:
+            return 'rate-limited';
+        case 502:
+        case 503:
+        case 504:
+            return 'unavailable';
+        default:
+            if (status >= 400 && status < 500) {
+                return 'invalid-request';
+            }
+            return 'internal';
+    }
+}
+//# sourceMappingURL=http-host-adapter.js.map

package/dist/http-host-adapter.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { type BlockDefinition, type BlockSlotDefinition, type BlockType, type BlueprintDocument, type BlueprintBlockLock, type BlueprintNode, type JsonSchema, type StudioConfiguration, type StudioDiagnostic } from '@kumwe/studio-protocol';
 export { createHostRequestContextFixture, createTestbedHost, TestbedHostError, type HostRequestContextFixtureOptions, type TestbedControls, type TestbedHost, type TestbedHostOptions, type TestbedPortName, } from './host-testbed.js';
+export { createHttpHostAdapter, type HttpFetchLike, type HttpHostAdapterOptions, type HttpRequestInit, type HttpResponseLike, type HttpTimeoutHandle, } from './http-host-adapter.js';
 export interface BlueprintFixtureOptions {
     blockLocks?: BlueprintBlockLock[];
     id?: string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,gCAAgC,EACrC,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACzC,YAAY,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACzC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,iBAAiB,CAiB/F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA2B1E;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,mBAAmB,CAqErB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,SAAS,eAAe,EAAE,GACtC,IAAI,CAKN;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAgB,WAAW,EAAE,gBAAgB,EAAE,CAAC;gBAE7B,WAAW,EAAE,gBAAgB,EAAE;CASnD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,gCAAgC,EACrC,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,EACrB,KAAK,aAAa,EAClB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,KAAK,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC9B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAChC,IAAI,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;IACzC,YAAY,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;CACzC;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,GAAG,iBAAiB,CAiB/F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CA2B1E;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,mBAAmB,CAqErB;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,SAAS,eAAe,EAAE,GACtC,IAAI,CAKN;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,SAAgB,WAAW,EAAE,gBAAgB,EAAE,CAAC;gBAE7B,WAAW,EAAE,gBAAgB,EAAE;CASnD"}

package/dist/index.js

@@ -1,6 +1,7 @@
 import { BlockRegistry, validateBlueprint } from '@kumwe/studio-core';
 import { STUDIO_CONTRACT_VERSION, STUDIO_WIRE_PROTOCOL_VERSION, } from '@kumwe/studio-protocol';
 export { createHostRequestContextFixture, createTestbedHost, TestbedHostError, } from './host-testbed.js';
+export { createHttpHostAdapter, } from './http-host-adapter.js';
 export function createBlueprintFixture(options = {}) {
     return {
         contractVersion: STUDIO_CONTRACT_VERSION,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EACL,uBAAuB,EACvB,4BAA4B,GAU7B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,+BAA+B,EAC/B,iBAAiB,EACjB,gBAAgB,GAMjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,qBAAqB,GAMtB,MAAM,wBAAwB,CAAC;AAuBhC,MAAM,UAAU,sBAAsB,CAAC,UAAmC,EAAE;IAC1E,OAAO;QACL,eAAe,EAAE,uBAAuB;QACxC,cAAc,EAAE;YACd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC;YAC5C,KAAK,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE;SAC3E;QACD,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,gBAAgB;QAClC,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,EAAE,cAAc,EAAE,gBAAgB,EAAE,GAAG,EAAE,uBAAuB,EAAE;QACzE,KAAK,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1E,KAAK,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,OAAO,EAAE,eAAe,EAAE;QAC9D,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,cAAc;QAC5C,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,MAAM,EAAE,OAAO;QACf,OAAO,EAAE,OAAO;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAyB;IACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC;IAC5C,OAAO;QACL,aAAa,EAAE;YACb,cAAc,EAAE,gBAAgB;YAChC,QAAQ,EAAE,YAAY;YACtB,QAAQ,EAAE,EAAE,cAAc,EAAE,uBAAuB,EAAE,GAAG,EAAE,4BAA4B,EAAE;YACxF,YAAY,EAAE,CAAC,yBAAyB,CAAC;YACzC,aAAa,EAAE,gBAAgB;SAChC;QACD,QAAQ,EAAE,sBAAsB;QAChC,eAAe,EAAE,uBAAuB;QACxC,YAAY,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;QACtC,IAAI,EAAE,kBAAkB;QACxB,KAAK,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,yBAAyB,EAAE;QAChE,KAAK,EAAE,EAAE,EAAE,EAAE,qBAAqB,EAAE,OAAO,EAAE,eAAe,EAAE;QAC9D,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC,cAAc,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACxE,oBAAoB,EAAE;YACpB,EAAE,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE;SAC/E;QACD,QAAQ,EAAE,UAAU;QACpB,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC;QACtC,aAAa,EAAE,EAAE;QACjB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,UAA6C,EAAE;IAE/C,OAAO;QACL,KAAK,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,EAAE,EAAE,mBAAmB,EAAE;QAC9D,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE;QACV,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,QAAQ;QACxC,eAAe,EAAE,uBAAuB;QACxC,kBAAkB,EAAE;YAClB,QAAQ,EAAE,SAAS;YACnB,SAAS,EAAE,KAAK;YAChB,iBAAiB,EAAE,QAAQ;YAC3B,eAAe,EAAE,MAAM;SACxB;QACD,QAAQ,EAAE;YACR,oBAAoB,EAAE,KAAK;YAC3B,aAAa,EAAE,KAAK;YACpB,gBAAgB,EAAE,KAAK;YACvB,iBAAiB,EAAE,KAAK;YACxB,mBAAmB,EAAE,KAAK;YAC1B,eAAe,EAAE,KAAK;SACvB;QACD,gBAAgB,EAAE;YAChB,YAAY,EAAE,EAAE;YAChB,eAAe,EAAE,uBAAuB;YACxC,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;YACzE,IAAI,EAAE,mBAAmB;YACzB,KAAK,EAAE,EAAE;YACT,gBAAgB,EAAE,CAAC,4BAA4B,CAAC;SACjD;QACD,MAAM,EAAE;YACN,kBAAkB,EAAE,KAAK;YACzB,eAAe,EAAE,GAAG;YACpB,yBAAyB,EAAE,GAAG;YAC9B,QAAQ,EAAE,EAAE;YACZ,iBAAiB,EAAE,SAAS;YAC5B,iBAAiB,EAAE,GAAG;YACtB,cAAc,EAAE,SAAS;YACzB,aAAa,EAAE,EAAE;YACjB,mBAAmB,EAAE,aAAa;YAClC,QAAQ,EAAE,KAAK;YACf,cAAc,EAAE,EAAE;YAClB,eAAe,EAAE,UAAU;YAC3B,2BAA2B,EAAE,GAAG;YAChC,gBAAgB,EAAE,SAAS;YAC3B,gBAAgB,EAAE,SAAS;YAC3B,gBAAgB,EAAE,EAAE;YACpB,eAAe,EAAE,EAAE;SACpB;QACD,MAAM,EAAE;YACN,SAAS,EAAE,KAAK;YAChB,SAAS,EAAE,EAAE;YACb,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,KAAK;SAChB;QACD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,WAAW;QACjC,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE;QACX,eAAe,EAAE,4BAA4B;QAC7C,OAAO,EAAE,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,IAAI,EAAE;QACtF,iBAAiB,EAAE,YAAY;QAC/B,SAAS,EAAE,cAAc;QACzB,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,UAAU;QAChD,eAAe,EAAE;YACf,GAAG,EAAE,eAAe;YACpB,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,qBAAqB;SAC/B;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAA4B,EAC5B,WAAuC;IAEvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,IAAI,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/B,WAAW,CAAqB;IAEhD,YAAmB,WAA+B;QAChD,KAAK,CACH,WAAW;aACR,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,CAAC,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;aACrF,IAAI,CAAC,IAAI,CAAC,CACd,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAC7C,CAAC;CACF;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC"}

package/fixtures/design-vocabulary.example.json

@@ -0,0 +1,85 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "design-vocabulary",
+  "id": "org.example.catalog/product-vocabulary",
+  "version": "1.0.0",
+  "owner": {
+    "id": "org.example/catalog",
+    "version": "1.0.0"
+  },
+  "label": {
+    "key": "org.example.catalog/product-vocabulary",
+    "defaultMessage": "Product design vocabulary"
+  },
+  "designControls": [
+    {
+      "id": "card-density",
+      "kind": "enum",
+      "label": {
+        "key": "org.example.catalog/card-density",
+        "defaultMessage": "Card density"
+      },
+      "choices": [
+        {
+          "id": "compact",
+          "label": {
+            "key": "org.example.catalog/card-density-compact",
+            "defaultMessage": "Compact"
+          }
+        },
+        {
+          "id": "comfortable",
+          "label": {
+            "key": "org.example.catalog/card-density-comfortable",
+            "defaultMessage": "Comfortable"
+          }
+        }
+      ]
+    },
+    {
+      "id": "card-width",
+      "kind": "size-role",
+      "label": {
+        "key": "org.example.catalog/card-width",
+        "defaultMessage": "Card width"
+      },
+      "choices": [
+        {
+          "id": "full",
+          "label": {
+            "key": "org.example.catalog/card-width-full",
+            "defaultMessage": "Full"
+          }
+        },
+        {
+          "id": "half",
+          "label": {
+            "key": "org.example.catalog/card-width-half",
+            "defaultMessage": "Half"
+          }
+        },
+        {
+          "id": "quarter",
+          "label": {
+            "key": "org.example.catalog/card-width-quarter",
+            "defaultMessage": "Quarter"
+          }
+        }
+      ]
+    }
+  ],
+  "recipes": [
+    {
+      "id": "price-compact",
+      "blockType": "org.example.catalog/price",
+      "label": {
+        "key": "org.example.catalog/price-compact",
+        "defaultMessage": "Compact price"
+      },
+      "designValues": {
+        "card-density": "compact",
+        "card-width": "quarter"
+      }
+    }
+  ]
+}

package/fixtures/migration.example.json

@@ -0,0 +1,22 @@
+{
+  "contractVersion": "0.1-draft",
+  "kind": "migration",
+  "id": "org.example.catalog/price-to-money",
+  "version": "1.1.0",
+  "owner": {
+    "id": "org.example/catalog",
+    "version": "1.1.0"
+  },
+  "label": {
+    "key": "org.example.catalog/price-to-money",
+    "defaultMessage": "Price becomes typed money"
+  },
+  "description": {
+    "key": "org.example.catalog/price-to-money-description",
+    "defaultMessage": "Rewrites plain price properties into the typed money value shape."
+  },
+  "artifactKinds": ["blueprint", "entry"],
+  "sourceVersions": ">=1.0.0 <1.1.0",
+  "targetVersion": "1.1.0",
+  "lossClassification": "lossless"
+}

package/invalid/blueprint.revoking-slot-marker.json

@@ -0,0 +1,57 @@
+{
+  "schema": "blueprint.schema.json",
+  "description": "The per-slot composition marker only grants composability; a revoking marker is rejected.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "dependencyLock": {
+      "blocks": [
+        {
+          "revision": "block-r1",
+          "type": "studio.vector/section",
+          "version": "1.0.0"
+        }
+      ],
+      "theme": {
+        "id": "studio.vector/theme",
+        "revision": "theme-r1",
+        "version": "1.0.0"
+      }
+    },
+    "id": "vector.blueprint",
+    "kind": "blueprint",
+    "label": {
+      "defaultMessage": "Vector Blueprint",
+      "key": "studio.vector/blueprint"
+    },
+    "model": {
+      "id": "studio.vector/model",
+      "revision": "model-r1",
+      "version": "1.0.0"
+    },
+    "owner": {
+      "id": "studio.vector/suite",
+      "version": "0.1.0-alpha.0"
+    },
+    "revision": "blueprint-r1",
+    "roots": [
+      {
+        "authoring": {
+          "mode": "structural",
+          "slots": {
+            "main": {
+              "composable": false
+            }
+          }
+        },
+        "bindings": {},
+        "id": "section-a",
+        "properties": {},
+        "slots": {},
+        "type": "studio.vector/section",
+        "version": "1.0.0"
+      }
+    ],
+    "status": "draft",
+    "version": "1.0.0"
+  }
+}

package/invalid/design-vocabulary.unknown-control-kind.json

@@ -0,0 +1,38 @@
+{
+  "schema": "design-vocabulary.schema.json",
+  "description": "Design controls carry only the closed design-control kind vocabulary.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "design-vocabulary",
+    "id": "org.example.catalog/product-vocabulary",
+    "version": "1.0.0",
+    "owner": {
+      "id": "org.example/catalog",
+      "version": "1.0.0"
+    },
+    "label": {
+      "key": "org.example.catalog/product-vocabulary",
+      "defaultMessage": "Product design vocabulary"
+    },
+    "designControls": [
+      {
+        "id": "card-face",
+        "kind": "font-role",
+        "label": {
+          "key": "org.example.catalog/card-face",
+          "defaultMessage": "Card face"
+        },
+        "choices": [
+          {
+            "id": "serif",
+            "label": {
+              "key": "org.example.catalog/card-face-serif",
+              "defaultMessage": "Serif"
+            }
+          }
+        ]
+      }
+    ],
+    "recipes": []
+  }
+}

package/invalid/migration.empty-artifact-kinds.json

@@ -0,0 +1,22 @@
+{
+  "schema": "migration.schema.json",
+  "description": "A migration declaration must cover at least one artifact kind.",
+  "value": {
+    "contractVersion": "0.1-draft",
+    "kind": "migration",
+    "id": "org.example.catalog/price-to-money",
+    "version": "1.1.0",
+    "owner": {
+      "id": "org.example/catalog",
+      "version": "1.1.0"
+    },
+    "label": {
+      "key": "org.example.catalog/price-to-money",
+      "defaultMessage": "Price becomes typed money"
+    },
+    "artifactKinds": [],
+    "sourceVersions": ">=1.0.0 <1.1.0",
+    "targetVersion": "1.1.0",
+    "lossClassification": "lossless"
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kumwe/studio-testkit",
-  "version": "0.1.0-alpha.4",
+  "version": "0.1.0-alpha.6",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/kumwe/studio.git",
@@ -34,8 +34,8 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@kumwe/studio-core": "0.1.0-alpha.4",
-    "@kumwe/studio-protocol": "0.1.0-alpha.2"
+    "@kumwe/studio-core": "0.1.0-alpha.6",
+    "@kumwe/studio-protocol": "0.1.0-alpha.4"
   },
   "publishConfig": {
     "access": "public",