@kumwe/studio-core 0.1.0-alpha.8 → 0.1.0-beta.2

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

@@ -0,0 +1,173 @@
+import { type HostAdapter, type StudioDeploymentOperationRoute } from '@kumwe/studio-protocol';
+import { type HttpSchemaValidator } from './http-authoring-contract.js';
+/**
+ * Minimal structural view of an HTTP response the adapter needs: media type,
+ * status code, and raw body text. Deliberately narrower than any platform
+ * response class so implementations from any runtime satisfy it. A missing
+ * `contentType` models a hostile/invalid response and is rejected.
+ */
+export interface HttpResponseLike {
+    /** Parsed response Content-Type; omission is a fail-closed invalid response. */
+    contentType?: string;
+    status: number;
+    /**
+     * Read at most `maximumBytes` decoded transport bytes. Implementations MUST
+     * reject with a reason named `ResponseLimitError` before exceeding it.
+     */
+    text(maximumBytes: number): Promise<string>;
+}
+/** The request shape the adapter hands to the injected transport. */
+export interface HttpRequestInit {
+    body: string;
+    /** Browser credential policy. `same-origin` is the secure default. */
+    credentials: 'include' | 'omit' | 'same-origin';
+    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.
+ *
+ * Core 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 while `@kumwe/studio` supplies the
+ * browser fetch convenience, 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 {
+    /**
+     * Optional deadline rejection for work which happens before fetch receives
+     * the platform signal (notably an asynchronous authentication refresh).
+     */
+    deadline?: PromiseLike<never>;
+    release?(): void;
+    signal: unknown;
+}
+/**
+ * Exact operation endpoints supplied by the host. Missing entries are
+ * unavailable capabilities; the transport never invents a fallback URL.
+ */
+export type HttpHostOperationEndpoints = Readonly<Partial<Record<HttpHostOperationRoute, string>>>;
+export type HttpHostRoutingConfiguration = {
+    /** Each configured operation is posted to its exact host-owned URL. */
+    readonly endpoints: HttpHostOperationEndpoints;
+    readonly kind: 'operation-map';
+} | {
+    /**
+     * Every operation uses one URL. Dispatch is carried only in the fixed
+     * `X-Studio-Operation` header; the canonical JSON body is unchanged.
+     */
+    readonly endpoint: string;
+    readonly kind: 'single-endpoint';
+};
+export interface HttpSameOriginSessionAuthentication {
+    readonly credentials: 'same-origin';
+    readonly csrf: {
+        readonly headerName: string;
+        readonly token: string;
+    };
+    readonly kind: 'same-origin-session';
+}
+export interface HttpBearerTokenAuthentication {
+    readonly credentials: 'omit';
+    /** Closed browser-use window; the server independently verifies the token. */
+    readonly expiresAt: string;
+    readonly issuedAt: string;
+    readonly kind: 'bearer-token';
+    readonly token: string;
+}
+export interface HttpHeaderTokenAuthentication {
+    readonly credentials: 'omit';
+    /** Closed browser-use window; the server independently verifies the token. */
+    readonly expiresAt: string;
+    readonly headerName: string;
+    readonly issuedAt: string;
+    readonly kind: 'header-token';
+    readonly token: string;
+}
+/** Authentication material has exactly one transport projection. */
+export type HttpAuthenticationConfiguration = HttpBearerTokenAuthentication | HttpHeaderTokenAuthentication | HttpSameOriginSessionAuthentication;
+/** Canonical browser/server deployment input for the HTTP HostAdapter. */
+export interface HttpHostTransportConfiguration {
+    readonly authentication: HttpAuthenticationConfiguration;
+    readonly kind: 'http';
+    readonly maximumResponseBytes?: number;
+    readonly requestTimeoutMilliseconds?: number;
+    readonly routing: HttpHostRoutingConfiguration;
+}
+export interface HttpAuthenticationRequest {
+    /** Stable route only; authentication hooks never receive request content. */
+    readonly operation: HttpHostOperationRoute;
+}
+/**
+ * JS-only refresh seam. It runs for every call and may return fresh short-lived
+ * material. Returning `undefined` retains the static deployment value.
+ */
+export type HttpAuthenticationResolver = (request: HttpAuthenticationRequest) => HttpAuthenticationConfiguration | Promise<HttpAuthenticationConfiguration | undefined> | undefined;
+/** Closed route vocabulary implemented by the configured HTTP adapter. */
+export type HttpHostOperationRoute = StudioDeploymentOperationRoute;
+/** Closed route vocabulary accepted in a configured operation map. */
+export declare const HTTP_HOST_OPERATION_ROUTES: readonly HttpHostOperationRoute[];
+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;
+    /** Deterministic clock used only to refuse expired configured credentials. */
+    currentTimeMilliseconds: () => number;
+    fetchImplementation: HttpFetchLike;
+    /**
+     * Produces per-call authentication and CSRF/origin-integrity headers. It is
+     * invoked for every attempt so rotated credentials are not captured once.
+     * `accept` and `content-type` are transport-owned and cannot be overridden.
+     */
+    requestHeaders?: () => Readonly<Record<string, string>>;
+    /**
+     * Resolve or refresh configured authentication for every request. The value
+     * is projected only to the declared header and credential policy; Studio
+     * never treats it as permission or identity data.
+     */
+    resolveAuthentication?: HttpAuthenticationResolver;
+    /**
+     * Optional exact request/result validation. Standalone host integration
+     * conformance supplies this callback using the canonical protocol schemas.
+     */
+    validateSchema?: HttpSchemaValidator;
+}
+/** Explicit alias retained for consumers that emphasize configuration ownership. */
+export type ConfiguredHttpHostAdapterOptions = HttpHostAdapterOptions;
+/**
+ * A `HostAdapter` that speaks canonical JSON over an injected fetch-like
+ * transport. A deployment provides exact per-operation endpoints or one
+ * endpoint selected by the fixed `X-Studio-Operation` header. Production
+ * routing is never inferred from a base URL convention.
+ *
+ * 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
+ * canonical `HostPortFailure` whose `error` satisfies `isHostPortError`, and no
+ * message ever echoes response bodies, addresses, or underlying reasons.
+ */
+export declare function createHttpHostAdapter(configuration: HttpHostTransportConfiguration, options: ConfiguredHttpHostAdapterOptions): 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":"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"}

package/dist/http-host-adapter.js

@@ -0,0 +1 @@
+import{HostPortFailure as e,isHostPortError as t,STUDIO_CONTRACT_VERSION as n}from"@kumwe/studio-protocol";import{AUTHORING_HTTP_OPERATIONS as r}from"./http-authoring-contract.js";import{parseJsonRejectingDuplicateMembers as i}from"./strict-json.js";import{assertStudioTokenLifetime as a,isAuthenticationLifetimeFailure as o}from"./authentication-lifetime.js";export const HTTP_HOST_OPERATION_ROUTES=Object.freeze(`artifact/dependencies.artifact/load.artifact/publish.artifact/save.artifact/unpublish.authoring/list-types.authoring/plan-save.authoring/resolve-target.authoring/save-as-new-type.authoring/save-item.authoring/save-new-type-version.authoring/start.localization/messages.media/abort-upload.media/authorize-upload.media/complete-upload.media/get.media/import-external.media/list.media/upload-status.model/get.model/list.permission/explain.permission/refresh.preview/cancel.preview/render.recovery/discard.recovery/load.recovery/store.resource/search.telemetry/emit`.split(`.`));export function createHttpHostAdapter(i,a){let s=M(i,a),c=0;function v(t){c+=1;let r={category:t.category,contractVersion:n,correlationId:`http-transport-${c}`,kind:`host-error`,message:{defaultMessage:t.defaultMessage,key:t.key},retryable:t.retryable};return new e(r)}async function y(n,r,i,c,u=`https://schemas.kumwe.org/studio/v1/host-request.schema.json`,y=`https://schemas.kumwe.org/studio/v1/host-result.schema.json`){let M=`${n}/${r}`,N=s.resolveTarget(M);if(N===void 0)throw v(T());let P={arguments:i,context:c};if(a.validateSchema!==void 0){let e;try{e=a.validateSchema(u,P)}catch{throw v(E())}if(!e)throw v(S())}let F;try{F=JSON.stringify(P)}catch{throw v(S())}let I;try{I=a.createTimeoutSignal?.(s.timeoutMilliseconds)}catch{throw v(D())}try{let n;if(a.resolveAuthentication!==void 0)try{n=await _(Promise.resolve().then(()=>a.resolveAuthentication?.({operation:M})),I)}catch(e){throw v(h(e)?m(e):C())}let r,i;try{let e=n??s.authentication,t=e?.kind===`same-origin-session`?void 0:s.currentTimeMilliseconds?.();if(t!==void 0&&!Number.isFinite(t))throw TypeError(`The configured transport clock returned an invalid time.`);r=e===void 0?void 0:R(e,t),i=H(r?.headers,a.requestHeaders?.(),N.operationHeader)}catch(e){throw v(o(e)?w():S())}let c;try{c=await _(a.fetchImplementation(N.url,{body:F,credentials:r?.credentials??s.credentials,headers:i,method:`POST`,...I===void 0?{}:{signal:I.signal}}),I)}catch(e){throw v(g(e)?S():m(e))}if(c.contentType===void 0||!j(c.contentType))throw v(x());let u;try{u=await _(c.text(s.maximumResponseBytes),I)}catch(e){throw v(A(e)?O():h(e)?m(e):x())}if(K(u)>s.maximumResponseBytes)throw v(O());if(c.status>=200&&c.status<300){let e=d(u);if(!p(e)||a.validateSchema!==void 0&&!k(a.validateSchema,y,e))throw v(x());return{...e.revision===void 0?{}:{revision:e.revision},value:e.value}}let b=d(u);throw t(b)?f(b)?new e(b):v(x()):l(b)?v(x()):v(q(c.status))}finally{b(I)}}return{artifact:{dependencies(e,t){return y(`artifact`,`dependencies`,{reference:u(e)},t)},load(e,t){return y(`artifact`,`load`,{reference:u(e)},t)},publish(e,t){return y(`artifact`,`publish`,{reference:u(e)},t)},save(e,t){return y(`artifact`,`save`,{document:u(e)},t)},unpublish(e,t){return y(`artifact`,`unpublish`,{reference:u(e)},t)}},authoring:{listTypes(e,t){return y(`authoring`,`list-types`,{query:u(e)},t,r.listTypes.requestSchema,r.listTypes.responseSchema)},planSave(e,t){return y(`authoring`,`plan-save`,{intent:u(e)},t,r.planSave.requestSchema,r.planSave.responseSchema)},resolveTarget(e,t){return y(`authoring`,`resolve-target`,{request:u(e)},t,r.resolveTarget.requestSchema,r.resolveTarget.responseSchema)},saveAsNewType(e,t){return y(`authoring`,`save-as-new-type`,{request:u(e)},t,r.saveAsNewType.requestSchema,r.saveAsNewType.responseSchema)},saveItem(e,t){return y(`authoring`,`save-item`,{request:u(e)},t,r.saveItem.requestSchema,r.saveItem.responseSchema)},saveNewTypeVersion(e,t){return y(`authoring`,`save-new-type-version`,{request:u(e)},t,r.saveNewTypeVersion.requestSchema,r.saveNewTypeVersion.responseSchema)},start(e,t){return y(`authoring`,`start`,{request:u(e)},t,r.start.requestSchema,r.start.responseSchema)}},localization:{messages(e,t,n){return y(`localization`,`messages`,{locale:e,namespaces:t},n)}},media:{abortUpload(e,t){return y(`media`,`abort-upload`,{uploadId:e},t)},authorizeUpload(e,t){return y(`media`,`authorize-upload`,{request:u(e)},t)},completeUpload(e,t){return y(`media`,`complete-upload`,{uploadId:e},t)},get(e,t){return y(`media`,`get`,{assetId:e},t)},importExternal(e,t){return y(`media`,`import-external`,{url:e},t)},list(e,t){return y(`media`,`list`,{query:u(e)},t)},uploadStatus(e,t){return y(`media`,`upload-status`,{assetId:e},t)}},model:{get(e,t){return y(`model`,`get`,{reference:u(e)},t)},list(e){return y(`model`,`list`,{},e)}},permission:{explain(e,t){return y(`permission`,`explain`,{operation:e},t)},refresh(e){return y(`permission`,`refresh`,{},e)}},preview:{cancel(e,t){return y(`preview`,`cancel`,{draftDigest:e},t)},render(e,t){return y(`preview`,`render`,{payload:u(e)},t)}},recovery:{discard(e){return y(`recovery`,`discard`,{},e)},load(e){return y(`recovery`,`load`,{},e)},store(e,t){return y(`recovery`,`store`,{envelope:e},t)}},resource:{search(e,t){return y(`resource`,`search`,{query:u(e)},t)}},telemetry:{emit(e,t){return y(`telemetry`,`emit`,{event:u(e)},t)}}}}function l(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&e.kind===`host-error`}function u(e){return JSON.parse(JSON.stringify(e))}function d(e){try{return i(e,64)}catch{return}}function f(e){return e.revision!==void 0&&e.category!==`conflict`?!1:e.retryAfterMilliseconds===void 0||e.retryable&&(e.category===`rate-limited`||e.category===`unavailable`)}function p(e){if(typeof e!=`object`||!e||Array.isArray(e))return!1;let t=e;if(!Object.hasOwn(t,`value`))return!1;let n=t.revision;return n!==void 0&&(typeof n!=`string`||n.length===0)?!1:Object.keys(t).every(e=>e===`value`||e===`revision`)}function m(e){return h(e)?{category:`unavailable`,defaultMessage:`The host did not respond within the transport deadline.`,key:`studio.transport/http-timeout`,retryable:!0}:{category:`unavailable`,defaultMessage:`The host could not be reached.`,key:`studio.transport/http-unreachable`,retryable:!0}}function h(e){let t=typeof e==`object`&&e&&`name`in e?e.name:void 0;return t===`AbortError`||t===`TimeoutError`}function g(e){return(typeof e==`object`&&e&&`name`in e?e.name:void 0)===`InvalidRequestError`}async function _(e,t){if(t?.deadline!==void 0)return Promise.race([Promise.resolve(e),Promise.resolve(t.deadline)]);let n=v(t?.signal);if(n===void 0)return e;if(n.aborted)throw y(n.reason);let r=()=>void 0,i=new Promise((e,t)=>{r=()=>t(y(n.reason)),n.addEventListener(`abort`,r,{once:!0})});try{return await Promise.race([Promise.resolve(e),i])}finally{n.removeEventListener(`abort`,r)}}function v(e){if(!(typeof e!=`object`||!e||!(`aborted`in e)||typeof e.aborted!=`boolean`||!(`addEventListener`in e)||typeof e.addEventListener!=`function`||!(`removeEventListener`in e)||typeof e.removeEventListener!=`function`))return e}function y(e){if(h(e))return e;let t=Error(`The Studio host request exceeded its deadline.`);return t.name=`TimeoutError`,t}function b(e){try{e?.release?.()}catch{}}function x(){return{category:`internal`,defaultMessage:`The host response could not be interpreted.`,key:`studio.transport/http-malformed-response`,retryable:!1}}function S(){return{category:`invalid-request`,defaultMessage:`The Studio request does not match the host transport contract.`,key:`studio.transport/http-invalid-request`,retryable:!1}}function C(){return{category:`unavailable`,defaultMessage:`The request authentication material could not be refreshed.`,key:`studio.transport/http-authentication-unavailable`,retryable:!0}}function w(){return{category:`unauthenticated`,defaultMessage:`The configured request authentication material is not currently valid.`,key:`studio.transport/http-authentication-invalid-lifetime`,retryable:!1}}function T(){return{category:`incompatible`,defaultMessage:`The requested host operation has no configured transport route.`,key:`studio.transport/http-route-unavailable`,retryable:!1}}function E(){return{category:`internal`,defaultMessage:`The Studio transport schema validator failed.`,key:`studio.transport/http-schema-validator-failed`,retryable:!1}}function D(){return{category:`internal`,defaultMessage:`The Studio transport deadline could not be initialized.`,key:`studio.transport/http-timeout-factory-failed`,retryable:!1}}function O(){return{category:`limit-exceeded`,defaultMessage:`The host response exceeds the configured transport limit.`,key:`studio.transport/http-response-too-large`,retryable:!1}}function k(e,t,n){try{return e(t,n)}catch{return!1}}function A(e){return typeof e==`object`&&!!e&&`name`in e&&e.name===`ResponseLimitError`}function j(e){return e.split(`;`,1)[0]?.trim().toLowerCase()===`application/json`}function M(e,t){if(e.kind!==`http`)throw TypeError(`A canonical HTTP transport configuration is required.`);F(e,[`authentication`,`kind`,`maximumResponseBytes`,`requestTimeoutMilliseconds`,`routing`],`HTTP transport configuration`);let n=e.requestTimeoutMilliseconds??1e4,r=e.maximumResponseBytes??67108864;if(P(n,100,12e4,`requestTimeoutMilliseconds`),P(r,1024,67108864,`maximumResponseBytes`),typeof t.currentTimeMilliseconds!=`function`)throw TypeError(`Configured HTTP transports require an injected deterministic clock.`);return{authentication:z(e.authentication),credentials:`omit`,currentTimeMilliseconds:t.currentTimeMilliseconds,maximumResponseBytes:r,resolveTarget:N(e.routing),timeoutMilliseconds:n}}function N(e){if(typeof e!=`object`||!e)throw TypeError(`A canonical HTTP routing configuration is required.`);if(e.kind===`single-endpoint`){F(e,[`endpoint`,`kind`],`single-endpoint routing`);let t=I(e.endpoint,`routing.endpoint`);return e=>({operationHeader:e,url:t})}if(e.kind!==`operation-map`)throw TypeError(`Unknown HTTP routing configuration.`);if(F(e,[`endpoints`,`kind`],`operation-map routing`),typeof e.endpoints!=`object`||e.endpoints===null)throw TypeError(`routing.endpoints must be an object.`);let t={},n=new Set(HTTP_HOST_OPERATION_ROUTES);for(let[r,i]of Object.entries(e.endpoints)){if(!n.has(r))throw TypeError(`routing.endpoints contains an unknown operation.`);t[r]=I(i,`routing.endpoints.${r}`)}return e=>{let n=t[e];return n===void 0?void 0:{url:n}}}function P(e,t,n,r){if(!Number.isSafeInteger(e)||e<t||e>n)throw TypeError(`${r} must be a safe integer from ${t} through ${n}.`)}function F(e,t,n){let r=new Set(t);if(Object.keys(e).some(e=>!r.has(e)))throw TypeError(`${n} contains an unknown member.`)}function I(e,t){if(typeof e!=`string`||e.length===0||e.length>2048||e.trim()!==e||/\s/u.test(e)||e.includes(`#`)||e.includes(`\\`))throw TypeError(`${t} must be an exact HTTP(S) URL reference without whitespace or a fragment.`);let n=e.indexOf(`?`),r=n===-1?e:e.slice(0,n);if(r.length===0)throw TypeError(`${t} must contain a non-empty HTTP endpoint path.`);let i;if(r.startsWith(`https://`)||r.startsWith(`http://`)){let e=r.indexOf(`://`)+3,n=r.indexOf(`/`,e);L(n===-1?r.slice(e):r.slice(e,n),t),i=n===-1?``:r.slice(n)}else{if(r.startsWith(`//`)||/^[A-Za-z][A-Za-z0-9+.-]*:/u.test(r))throw TypeError(`${t} must be an HTTP(S) URL or a same-origin path.`);i=r}if(i.includes(`//`)||/%(?:2f|5c)/iu.test(i))throw TypeError(`${t} path must not contain ambiguous separators.`);for(let e of i.split(`/`)){let n=e.replaceAll(/%2e/giu,`.`);if(n===`.`||n===`..`)throw TypeError(`${t} path must not contain dot segments.`)}return e}function L(e,t){if(e.length===0||e!==e.toLowerCase()||e.includes(`@`)||e.includes(`%`)||e.endsWith(`.`))throw TypeError(`${t} must contain one canonical host without embedded credentials.`);let n=/^(\[[0-9a-f:.]+\])(?::([0-9]+))?$/u.exec(e),r=/^([a-z0-9](?:[a-z0-9.-]*[a-z0-9])?)(?::([0-9]+))?$/u.exec(e),i=n??r;if(i===null||r?.[1]?.includes(`..`)===!0)throw TypeError(`${t} must contain a canonical HTTP host.`);let a=i[2];if(a!==void 0&&(a!==String(Number(a))||Number(a)<1||Number(a)>65535))throw TypeError(`${t} must contain a canonical HTTP port.`)}function R(e,t){if(typeof e!=`object`||!e)throw TypeError(`A canonical HTTP authentication configuration is required.`);let n,r,i;switch(e.kind){case`same-origin-session`:if(F(e,[`credentials`,`csrf`,`kind`],`same-origin session authentication`),e.credentials!==`same-origin`||typeof e.csrf!=`object`||e.csrf===null)throw TypeError(`Invalid same-origin session authentication configuration.`);F(e.csrf,[`headerName`,`token`],`CSRF configuration`),n=`same-origin`,r=V(e.csrf.headerName,`csrf.headerName`),i=B(e.csrf.token,4096,`csrf.token`);break;case`bearer-token`:if(F(e,[`credentials`,`expiresAt`,`issuedAt`,`kind`,`token`],`bearer-token authentication`),e.credentials!==`omit`)throw TypeError(`Bearer authentication must omit ambient credentials.`);a(e,t),n=`omit`,r=`authorization`,i=`Bearer ${B(e.token,8192,`authentication.token`)}`;break;case`header-token`:if(F(e,[`credentials`,`expiresAt`,`headerName`,`issuedAt`,`kind`,`token`],`header-token authentication`),e.credentials!==`omit`)throw TypeError(`Header-token authentication must omit ambient credentials.`);a(e,t),n=`omit`,r=V(e.headerName,`authentication.headerName`),i=B(e.token,8192,`authentication.token`);break;default:throw TypeError(`Unknown HTTP authentication configuration.`)}let o={};return U(o,{[r]:i}),{credentials:n,headers:o}}function z(e){switch(R(e),e.kind){case`same-origin-session`:{let t=e.csrf.token;return{credentials:`same-origin`,csrf:{headerName:e.csrf.headerName,token:t},kind:`same-origin-session`}}case`bearer-token`:{let t=e.token;return{credentials:`omit`,expiresAt:e.expiresAt,issuedAt:e.issuedAt,kind:`bearer-token`,token:t}}case`header-token`:{let t=e.token;return{credentials:`omit`,expiresAt:e.expiresAt,headerName:e.headerName,issuedAt:e.issuedAt,kind:`header-token`,token:t}}}}function B(e,t,n){if(typeof e!=`string`||e.length===0||e.length>t||/\s/u.test(e)||W(e))throw TypeError(`${n} must be one bounded HTTP ByteString token.`);return e}function V(e,t){if(typeof e!=`string`)throw TypeError(`${t} must be a safe custom HTTP field name.`);let n=e.toLowerCase();if(e.length>100||!/^[!#$%&'*+.^_`|~0-9a-z-]+$/u.test(n)||n===`accept`||n===`authorization`||n===`content-type`||n===`x-studio-operation`||!G(n))throw TypeError(`${t} must be a safe custom HTTP field name.`);return e}function H(e,t,n){let r={};if(U(r,e),U(r,t),n!==void 0){if(Object.hasOwn(r,`x-studio-operation`))throw TypeError(`Transport-owned HTTP headers cannot be overridden.`);r[`x-studio-operation`]=n}return r.accept=`application/json`,r[`content-type`]=`application/json`,r}function U(e,t){let n=Object.entries(t??{});if(n.length>100)throw TypeError(`Too many HTTP request headers.`);for(let[t,r]of n){let n=t.toLowerCase();if(t.length>100||!/^[!#$%&'*+.^_`|~0-9a-z-]+$/u.test(n)||typeof r!=`string`||r.length>8192||r.trim()!==r||W(r)||!G(n))throw TypeError(`Invalid HTTP request header.`);if(n===`accept`||n===`content-type`||n===`x-studio-operation`)throw TypeError(`Transport-owned HTTP headers cannot be overridden.`);if(Object.hasOwn(e,n))throw TypeError(`Duplicate HTTP request header.`);e[n]=r}}function W(e){for(let t=0;t<e.length;t+=1){let n=e.charCodeAt(t);if(n<=8||n>=10&&n<=31||n===127||n>255)return!0}return!1}function G(e){if(e.startsWith(`proxy-`)||e.startsWith(`sec-`)||e.startsWith(`access-control-`)||e===`forwarded`||e.startsWith(`x-forwarded-`))return!1;switch(e){case`connection`:case`content-length`:case`cookie`:case`date`:case`expect`:case`host`:case`keep-alive`:case`origin`:case`referer`:case`set-cookie`:case`te`:case`trailer`:case`transfer-encoding`:case`upgrade`:case`user-agent`:case`via`:return!1;default:return!0}}function K(e){let t=0;for(let n of e){let e=n.codePointAt(0)??0;t+=e<=127?1:e<=2047?2:e<=65535?3:4}return t}function q(e){let t=J(e);return{category:t,defaultMessage:`The host rejected the request.`,key:`studio.transport/http-status-${t}`,retryable:t===`rate-limited`||t===`unavailable`}}function J(e){switch(e){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:return e>=400&&e<500?`invalid-request`:`internal`}}

package/dist/index.d.ts

@@ -1,9 +1,19 @@
 export { canonicalStringify, canonicalUtf8Bytes, type CanonicalSerializationOptions, } from './canonical.js';
+export { projectBlueprintFieldBindings, type BlueprintFieldBindingProjection, type FieldBindingCandidate, type FieldBindingPortProjection, type FieldBindingProjectionStatus, type NodeFieldBindingProjection, } from './binding-projection.js';
+export { isAuthoringSaveIntent, isAuthoringSessionSnapshot, openContextualStudioSession, preflightContextualStudioSession, type OpenContextualStudioSessionOptions, type PreflightContextualStudioSessionOptions, type StudioContextualArtifactStateVersions, type StudioContextualDirtyArtifacts, type StudioContextualHostSessionHandle, type StudioContextualPreflightHandle, type StudioContextualSaveIntentOptions, type StudioContextualSession, type StudioContextualTypeCatalog, } from './contextual-session.js';
+export { assertStudioDeploymentConfiguration, validateStudioDeploymentConfiguration, } from './deployment-validation.js';
+export { assertStudioTokenLifetime, isAuthenticationLifetimeFailure, isStudioTokenLifetimeValid, STUDIO_TOKEN_MAXIMUM_LIFETIME_MILLISECONDS, type StudioTokenLifetime, } from './authentication-lifetime.js';
 export { applyCommand, invertCommand, StudioCommandError, type InverseCommandOptions, type StudioCommandErrorCode, } from './commands.js';
-export { ContributionRuntime, RegistryGeneration, StudioContributionError, type ExtensionContributions, type ExtensionInventory, type GenerationOptions, type UnresolvedNodeReport, } from './contributions.js';
+export { ContributionRuntime, RegistryGeneration, StudioContributionError, type ExtensionContributions, type ExtensionInventory, type GenerationOptions, type AuthoringTargetRuntimeOptions, type ResolvedAuthoringTarget, type StudioCompositionContribution, type StudioCompositionContributionKind, type StudioLifecycleContribution, type StudioLifecycleContributionKind, type UnresolvedNodeReport, } from './contributions.js';
 export { activateStudioPlugin, defineStudioPlugin, unresolvedDeclaredContributions, type StudioPluginDefinition, } from './extension-sdk.js';
 export { applyEntryCommand } from './entry-commands.js';
 export { StudioHistory } from './history.js';
+export { CORE_LAYOUT_BLOCK_TYPES, CORE_LAYOUT_THEME_CONTROLS, CoreLayoutError, coreLayoutInitialProperties, createCoreLayoutBlockDefinitions, isCoreLayoutBlockType, resolveCoreLayoutIntent, type CoreLayoutAlignment, type CoreLayoutBlockDefinitionOptions, type CoreLayoutBlockType, type CoreLayoutCollapse, type CoreLayoutDirection, type CoreLayoutErrorCode, type CoreLayoutIntent, type CoreLayoutPropertyResolution, type CoreLayoutSpacing, type CoreLayoutVisibility, } from './layout.js';
+export { CORE_PRODUCTION_BLOCK_TYPES, CORE_PRODUCTION_CONTROL_IDS, CORE_PRODUCTION_PATTERN_IDS, coreProductionInitialProperties, createCoreProductionBlockDefinitions, createCoreProductionPatterns, isCoreProductionBlockType, type CoreProductionBlockTypeMap, type CoreProductionControlIdMap, type CoreProductionBlockType, } from './production.js';
+export { parseStudioChartSpec, parseStudioDrawingDocument, parseStudioMoneyValue, parseStudioPresentationIntent, parseStudioTableDocument, } from './production-values.js';
+export { openStudioSession, STUDIO_RESOURCE_SEARCH_LIMITS, StudioHostSessionError, type OpenStudioSessionOptions, type StudioHostSessionErrorCode, type StudioHostSessionHandle, type StudioHostSessionIdentifierFactories, type StudioHostSessionModels, type StudioHostSessionRecovery, type StudioHostSessionResources, } from './host-session.js';
+export { AUTHORING_HTTP_OPERATIONS, AUTHORING_HTTP_OPERATIONS_BY_ROUTE, AUTHORING_HTTP_SCHEMA_ID, type AuthoringHttpOperationContract, type AuthoringHttpOperationRegistry, type AuthoringHttpRoute, type HttpSchemaValidator, } from './http-authoring-contract.js';
+export { createHttpHostAdapter, HTTP_HOST_OPERATION_ROUTES, type ConfiguredHttpHostAdapterOptions, type HttpAuthenticationConfiguration, type HttpAuthenticationRequest, type HttpAuthenticationResolver, type HttpBearerTokenAuthentication, type HttpFetchLike, type HttpHeaderTokenAuthentication, type HttpHostAdapterOptions, type HttpHostOperationEndpoints, type HttpHostOperationRoute, type HttpHostRoutingConfiguration, type HttpHostTransportConfiguration, type HttpRequestInit, type HttpResponseLike, type HttpSameOriginSessionAuthentication, type HttpTimeoutHandle, } from './http-host-adapter.js';
 export { applyModelCommand } from './model-commands.js';
 export { permittedCommandTypes, resolveSessionMode, STUDIO_SESSION_MODES, type StudioCommandType, } from './modes.js';
 export { RECIPE_MARKER_PROPERTY, recipeSelectionOperations } from './recipes.js';
@@ -11,6 +21,8 @@ export { MigrationRunner, StudioMigrationError, type MigratableArtifactKind, typ
 export { negotiateCapabilities, type CapabilityNegotiationOptions, type CapabilityNegotiationResult, } from './negotiation.js';
 export { compareSemanticVersions, normalizeVersionRange, parseSemanticVersion, satisfiesVersionRange, type ParsedSemanticVersion, } from './semver.js';
 export { StudioSession, type StudioSessionOptions } from './session.js';
+export { assertBlueprintWithinSessionPolicy, assertEntryWithinSessionPolicy, assertModelWithinSessionPolicy, STUDIO_PROTOCOL_MAXIMUM_COMMAND_POLICY_LIMITS, type StudioCommandPolicyLimits, type StudioSessionPolicyOptions, } from './session-policy.js';
+export { parseJsonRejectingDuplicateMembers } from './strict-json.js';
 export { BlockRegistry, type BlockRegistrationOptions, type ResolvedBlockRegistration, } from './registry.js';
 export { assertStudioPropertySchema, compileStudioPropertySchema, STUDIO_SCHEMA_PROFILE_ERROR_CODES, STUDIO_SCHEMA_PROFILE_LIMITS, StudioSchemaProfileError, type StudioPropertySchemaValidator, type StudioSchemaProfileErrorCode, } from './schema-profile.js';
 export { STUDIO_DEFAULT_URL_POLICY, validateExternalUrl, type ExternalUrlPolicy, type ExternalUrlRejectionReason, type ExternalUrlValidationResult, } from './url-policy.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,6BAA6B,GACnC,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,GAC5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,+BAA+B,EAC/B,KAAK,sBAAsB,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,qBAAqB,EACrB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,GACjC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,qBAAqB,GAC3B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,KAAK,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EACL,aAAa,EACb,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,GAC/B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,2BAA2B,EAC3B,iCAAiC,EACjC,4BAA4B,EAC5B,wBAAwB,EACxB,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,GAClC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,0BAA0B,EAC/B,KAAK,2BAA2B,GACjC,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,iBAAiB,EACjB,KAAK,0BAA0B,EAC/B,KAAK,yBAAyB,GAC/B,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,18 +1 @@
-export { canonicalStringify, canonicalUtf8Bytes, } from './canonical.js';
-export { applyCommand, invertCommand, StudioCommandError, } from './commands.js';
-export { ContributionRuntime, RegistryGeneration, StudioContributionError, } from './contributions.js';
-export { activateStudioPlugin, defineStudioPlugin, unresolvedDeclaredContributions, } from './extension-sdk.js';
-export { applyEntryCommand } from './entry-commands.js';
-export { StudioHistory } from './history.js';
-export { applyModelCommand } from './model-commands.js';
-export { permittedCommandTypes, resolveSessionMode, STUDIO_SESSION_MODES, } from './modes.js';
-export { RECIPE_MARKER_PROPERTY, recipeSelectionOperations } from './recipes.js';
-export { MigrationRunner, StudioMigrationError, } from './migrations.js';
-export { negotiateCapabilities, } from './negotiation.js';
-export { compareSemanticVersions, normalizeVersionRange, parseSemanticVersion, satisfiesVersionRange, } from './semver.js';
-export { StudioSession } from './session.js';
-export { BlockRegistry, } from './registry.js';
-export { assertStudioPropertySchema, compileStudioPropertySchema, STUDIO_SCHEMA_PROFILE_ERROR_CODES, STUDIO_SCHEMA_PROFILE_LIMITS, StudioSchemaProfileError, } from './schema-profile.js';
-export { STUDIO_DEFAULT_URL_POLICY, validateExternalUrl, } from './url-policy.js';
-export { validateBlueprint, } from './validation.js';
-//# sourceMappingURL=index.js.map
+export{canonicalStringify,canonicalUtf8Bytes}from"./canonical.js";export{projectBlueprintFieldBindings}from"./binding-projection.js";export{isAuthoringSaveIntent,isAuthoringSessionSnapshot,openContextualStudioSession,preflightContextualStudioSession}from"./contextual-session.js";export{assertStudioDeploymentConfiguration,validateStudioDeploymentConfiguration}from"./deployment-validation.js";export{assertStudioTokenLifetime,isAuthenticationLifetimeFailure,isStudioTokenLifetimeValid,STUDIO_TOKEN_MAXIMUM_LIFETIME_MILLISECONDS}from"./authentication-lifetime.js";export{applyCommand,invertCommand,StudioCommandError}from"./commands.js";export{ContributionRuntime,RegistryGeneration,StudioContributionError}from"./contributions.js";export{activateStudioPlugin,defineStudioPlugin,unresolvedDeclaredContributions}from"./extension-sdk.js";export{applyEntryCommand}from"./entry-commands.js";export{StudioHistory}from"./history.js";export{CORE_LAYOUT_BLOCK_TYPES,CORE_LAYOUT_THEME_CONTROLS,CoreLayoutError,coreLayoutInitialProperties,createCoreLayoutBlockDefinitions,isCoreLayoutBlockType,resolveCoreLayoutIntent}from"./layout.js";export{CORE_PRODUCTION_BLOCK_TYPES,CORE_PRODUCTION_CONTROL_IDS,CORE_PRODUCTION_PATTERN_IDS,coreProductionInitialProperties,createCoreProductionBlockDefinitions,createCoreProductionPatterns,isCoreProductionBlockType}from"./production.js";export{parseStudioChartSpec,parseStudioDrawingDocument,parseStudioMoneyValue,parseStudioPresentationIntent,parseStudioTableDocument}from"./production-values.js";export{openStudioSession,STUDIO_RESOURCE_SEARCH_LIMITS,StudioHostSessionError}from"./host-session.js";export{AUTHORING_HTTP_OPERATIONS,AUTHORING_HTTP_OPERATIONS_BY_ROUTE,AUTHORING_HTTP_SCHEMA_ID}from"./http-authoring-contract.js";export{createHttpHostAdapter,HTTP_HOST_OPERATION_ROUTES}from"./http-host-adapter.js";export{applyModelCommand}from"./model-commands.js";export{permittedCommandTypes,resolveSessionMode,STUDIO_SESSION_MODES}from"./modes.js";export{RECIPE_MARKER_PROPERTY,recipeSelectionOperations}from"./recipes.js";export{MigrationRunner,StudioMigrationError}from"./migrations.js";export{negotiateCapabilities}from"./negotiation.js";export{compareSemanticVersions,normalizeVersionRange,parseSemanticVersion,satisfiesVersionRange}from"./semver.js";export{StudioSession}from"./session.js";export{assertBlueprintWithinSessionPolicy,assertEntryWithinSessionPolicy,assertModelWithinSessionPolicy,STUDIO_PROTOCOL_MAXIMUM_COMMAND_POLICY_LIMITS}from"./session-policy.js";export{parseJsonRejectingDuplicateMembers}from"./strict-json.js";export{BlockRegistry}from"./registry.js";export{assertStudioPropertySchema,compileStudioPropertySchema,STUDIO_SCHEMA_PROFILE_ERROR_CODES,STUDIO_SCHEMA_PROFILE_LIMITS,StudioSchemaProfileError}from"./schema-profile.js";export{STUDIO_DEFAULT_URL_POLICY,validateExternalUrl}from"./url-policy.js";export{validateBlueprint}from"./validation.js";

package/dist/layout.d.ts

@@ -0,0 +1,66 @@
+import { type BlockDefinition, type BlockType, type BlueprintNode, type JsonObject, type LocalName, type RendererRequirement, type ThemeDocument, type ThemeViewport } from '@kumwe/studio-protocol';
+/** The portable layout block family shipped by Studio. */
+export declare const CORE_LAYOUT_BLOCK_TYPES: Readonly<{
+    columns: 'studio.core/columns';
+    grid: 'studio.core/grid';
+    section: 'studio.core/section';
+    stack: 'studio.core/stack';
+}>;
+export type CoreLayoutBlockType = (typeof CORE_LAYOUT_BLOCK_TYPES)[keyof typeof CORE_LAYOUT_BLOCK_TYPES];
+/** Canonical theme-control identifiers understood by every core layout block. */
+export declare const CORE_LAYOUT_THEME_CONTROLS: Readonly<{
+    alignment: 'layout-alignment';
+    collapse: 'layout-collapse';
+    direction: 'layout-direction';
+    spacing: 'layout-spacing';
+    visibility: 'layout-visibility';
+}>;
+export type CoreLayoutAlignment = 'center' | 'end' | 'start' | 'stretch';
+export type CoreLayoutCollapse = 'preserve' | 'stack' | 'wrap';
+export type CoreLayoutDirection = 'block' | 'inline';
+export type CoreLayoutSpacing = 'comfortable' | 'compact' | 'none' | 'spacious';
+export type CoreLayoutVisibility = 'hidden' | 'visible';
+export interface CoreLayoutBlockDefinitionOptions {
+    /** Additional host block types admitted into every composable layout slot. */
+    acceptedChildTypes?: readonly BlockType[];
+    /** Trusted renderer capabilities required for this definition family. */
+    rendererRequirements?: readonly RendererRequirement[];
+}
+export interface CoreLayoutPropertyResolution<T> {
+    source: 'base' | 'default' | 'viewport';
+    value: T;
+    viewport?: LocalName;
+}
+export interface CoreLayoutIntent {
+    alignment: CoreLayoutPropertyResolution<CoreLayoutAlignment>;
+    collapse?: CoreLayoutPropertyResolution<CoreLayoutCollapse>;
+    columns?: CoreLayoutPropertyResolution<number>;
+    direction?: CoreLayoutPropertyResolution<CoreLayoutDirection>;
+    spacing: CoreLayoutPropertyResolution<CoreLayoutSpacing>;
+    visibility: CoreLayoutPropertyResolution<CoreLayoutVisibility>;
+}
+export type CoreLayoutErrorCode = 'invalid-layout-property' | 'theme-choice-missing' | 'theme-control-missing' | 'unsupported-layout-block' | 'viewport-missing';
+/** Stable fail-closed error for renderer and authoring layout resolution. */
+export declare class CoreLayoutError extends Error {
+    readonly code: CoreLayoutErrorCode;
+    constructor(code: CoreLayoutErrorCode, message: string);
+}
+/** True only for the four canonical Studio layout block types. */
+export declare function isCoreLayoutBlockType(type: BlockType): type is CoreLayoutBlockType;
+/**
+ * Creates the canonical section, stack, grid, and columns definitions. The
+ * family owns its bounded semantic properties while the host explicitly adds
+ * content block types and trusted renderer capabilities; no wildcard slot or
+ * renderer authority is invented.
+ */
+export declare function createCoreLayoutBlockDefinitions(options?: Readonly<CoreLayoutBlockDefinitionOptions>): BlockDefinition[];
+/** Minimal persisted properties for a newly inserted core layout node. */
+export declare function coreLayoutInitialProperties(type: CoreLayoutBlockType): JsonObject;
+/**
+ * Resolves one layout node for a named theme viewport. Responsive values use
+ * the active viewport override when present and otherwise inherit the base
+ * value, with defaults remaining runtime semantics rather than stored noise.
+ * Every token reference must be declared by the active theme.
+ */
+export declare function resolveCoreLayoutIntent(node: Readonly<BlueprintNode>, viewport: Readonly<ThemeViewport>, theme: Readonly<ThemeDocument>): CoreLayoutIntent;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

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

package/dist/layout.js

@@ -0,0 +1 @@
+import{STUDIO_CONTRACT_VERSION as e}from"@kumwe/studio-protocol";import{cloneContractValue as t}from"./clone.js";export const CORE_LAYOUT_BLOCK_TYPES=Object.freeze({columns:`studio.core/columns`,grid:`studio.core/grid`,section:`studio.core/section`,stack:`studio.core/stack`});export const CORE_LAYOUT_THEME_CONTROLS=Object.freeze({alignment:`layout-alignment`,collapse:`layout-collapse`,direction:`layout-direction`,spacing:`layout-spacing`,visibility:`layout-visibility`});export class CoreLayoutError extends Error{code;constructor(e,t){super(t),this.name=`CoreLayoutError`,this.code=e}}const a=Object.freeze([{capability:`studio.renderer/layout`,surface:`preview`,versions:`^1.0.0`},{capability:`studio.renderer/layout`,surface:`web`,versions:`^1.0.0`}]),o=[`center`,`end`,`start`,`stretch`],s=[`preserve`,`stack`,`wrap`],c=[`block`,`inline`],l=[`comfortable`,`compact`,`none`,`spacious`],u=[`hidden`,`visible`];export function isCoreLayoutBlockType(e){return Object.values(CORE_LAYOUT_BLOCK_TYPES).includes(e)}export function createCoreLayoutBlockDefinitions(e={}){let r=g([...Object.values(CORE_LAYOUT_BLOCK_TYPES),...e.acceptedChildTypes??[]]),i=t(e.rendererRequirements??a);if(i.length===0)throw RangeError(`Core layout blocks require at least one trusted renderer capability.`);return[f(`section`,r,i),f(`stack`,r,i),f(`grid`,r,i),f(`columns`,r,i)]}export function coreLayoutInitialProperties(e){switch(e){case CORE_LAYOUT_BLOCK_TYPES.section:return{};case CORE_LAYOUT_BLOCK_TYPES.stack:return{direction:`block`};case CORE_LAYOUT_BLOCK_TYPES.grid:case CORE_LAYOUT_BLOCK_TYPES.columns:return{collapse:`stack`,columns:1}}}export function resolveCoreLayoutIntent(e,t,a){if(!isCoreLayoutBlockType(e.type))throw new CoreLayoutError(`unsupported-layout-block`,`Block ${e.type} is not a canonical Studio layout block.`);if(!a.viewports.some(e=>e.id===t.id))throw new CoreLayoutError(`viewport-missing`,`Theme ${a.id} does not declare viewport ${t.id}.`);let d={alignment:v(e,t,a,`alignment`,CORE_LAYOUT_THEME_CONTROLS.alignment,o,`stretch`),spacing:v(e,t,a,`spacing`,CORE_LAYOUT_THEME_CONTROLS.spacing,l,`comfortable`),visibility:v(e,t,a,`visibility`,CORE_LAYOUT_THEME_CONTROLS.visibility,u,`visible`)};return e.type===CORE_LAYOUT_BLOCK_TYPES.stack&&(d.direction=v(e,t,a,`direction`,CORE_LAYOUT_THEME_CONTROLS.direction,c,`block`)),(e.type===CORE_LAYOUT_BLOCK_TYPES.grid||e.type===CORE_LAYOUT_BLOCK_TYPES.columns)&&(d.collapse=v(e,t,a,`collapse`,CORE_LAYOUT_THEME_CONTROLS.collapse,s,`stack`),d.columns=y(e,t,`columns`,1,12,1)),d}function f(i,a,o){let s=CORE_LAYOUT_BLOCK_TYPES[i],c=`${i.charAt(0).toUpperCase()}${i.slice(1)}`,l=[CORE_LAYOUT_THEME_CONTROLS.alignment,CORE_LAYOUT_THEME_CONTROLS.spacing,CORE_LAYOUT_THEME_CONTROLS.visibility];return i===`stack`&&l.push(CORE_LAYOUT_THEME_CONTROLS.direction),(i===`grid`||i===`columns`)&&l.push(CORE_LAYOUT_THEME_CONTROLS.collapse),{accessibility:{accessibleName:i===`section`?`derived`:`not-applicable`,category:i===`section`?`landmark`:`structural`,keyboard:{defaultMessage:`Use the outline commands to insert, move, and reorder layout children.`,key:`studio.blocks/layout-keyboard`},outputChecks:[`studio.check/reading-order`,`studio.check/reflow`],reducedMotion:`not-applicable`},category:`studio.category/layout`,contractVersion:e,editingModes:[`blueprint`,`content`],icon:{kind:`symbol`,value:i},kind:`block-definition`,label:{defaultMessage:c,key:`studio.blocks/${i}`},owner:{id:`studio.core/blocks`,version:`1.0.0`},ports:[],propertyControls:l.map(e=>({control:`studio.control/${e}`,property:h(e)})),propertySchema:m(i),rendererRequirements:t([...o]),revision:`layout-${i}-r1`,slots:[p(i,a)],themeControls:l,type:s,version:`1.0.0`}}function p(e,n){let r=e===`section`?`content`:`items`;return{accepts:{types:t(n)},id:r,label:{defaultMessage:e===`section`?`Content`:`Items`,key:e===`section`?`studio.blocks/section-content`:`studio.blocks/layout-items`},maximum:100,minimum:0,ordered:!0}}function m(e){let t={alignment:{enum:[...o]},spacing:{enum:[...l]},visibility:{enum:[...u]}};return e===`stack`&&(t.direction={enum:[...c]}),(e===`grid`||e===`columns`)&&(t.collapse={enum:[...s]},t.columns={maximum:12,minimum:1,type:`integer`}),{additionalProperties:!1,properties:t,type:`object`}}function h(e){switch(e){case CORE_LAYOUT_THEME_CONTROLS.alignment:return`alignment`;case CORE_LAYOUT_THEME_CONTROLS.collapse:return`collapse`;case CORE_LAYOUT_THEME_CONTROLS.direction:return`direction`;case CORE_LAYOUT_THEME_CONTROLS.spacing:return`spacing`;case CORE_LAYOUT_THEME_CONTROLS.visibility:return`visibility`;default:throw RangeError(`Unknown core layout control ${e}.`)}}function g(e){let t=[...new Set(e)];if(t.sort((e,t)=>e<t?-1:+(e>t)),t.length===0)throw RangeError(`A core layout slot requires at least one accepted block type.`);return t}function _(e,t,n){let r=e.responsive?.[n]?.[t.id];if(r!==void 0)return{source:`viewport`,value:r,viewport:t.id};let i=e.properties[n];return i===void 0?{source:`default`,value:void 0}:{source:`base`,value:i}}function v(e,t,n,r,a,o,s){let c=_(e,t,r),l=c.value??s;if(typeof l!=`string`||!o.includes(l))throw new CoreLayoutError(`invalid-layout-property`,`Property ${r} on node ${e.id} is not a supported layout token.`);let u=n.designControls.find(e=>e.id===a);if(u===void 0)throw new CoreLayoutError(`theme-control-missing`,`Theme ${n.id} does not declare required layout control ${a}.`);if(!u.choices.some(e=>e.id===l))throw new CoreLayoutError(`theme-choice-missing`,`Theme ${n.id} does not declare ${l} for layout control ${a}.`);return{source:c.source,value:l,...c.viewport===void 0?{}:{viewport:c.viewport}}}function y(e,t,n,r,a,o){let s=_(e,t,n),c=s.value??o;if(typeof c!=`number`||!Number.isInteger(c)||c<r||c>a)throw new CoreLayoutError(`invalid-layout-property`,`Property ${n} on node ${e.id} must be an integer from ${r} through ${a}.`);return{source:s.source,value:c,...s.viewport===void 0?{}:{viewport:s.viewport}}}

package/dist/migrations.js

@@ -1,83 +1 @@
-import { cloneContractValue } from './clone.js';
-import { normalizeVersionRange, parseSemanticVersion, satisfiesVersionRange } from './semver.js';
-export class StudioMigrationError extends Error {
-    code;
-    diagnostics;
-    constructor(code, message, diagnostics = []) {
-        super(message);
-        this.name = 'StudioMigrationError';
-        this.code = code;
-        this.diagnostics = diagnostics;
-    }
-}
-/**
- * The deterministic migration runner the versioning contract defines.
- * Migration operates on a copy, validates the complete result before
- * acceptance, never mutates or replaces the original revision, refuses
- * lossy transformations without explicit confirmation, and rejects
- * reapplication once a document has left a migration's source range.
- */
-export class MigrationRunner {
-    #migrations = new Map();
-    register(migration) {
-        if (this.#migrations.has(migration.id)) {
-            throw new StudioMigrationError('duplicate-migration', `Migration ${migration.id} is already registered.`);
-        }
-        if (migration.artifactKinds.length === 0) {
-            throw new StudioMigrationError('not-applicable', `Migration ${migration.id} declares no artifact kinds.`);
-        }
-        normalizeVersionRange(migration.sourceVersions);
-        parseSemanticVersion(migration.targetVersion);
-        if (satisfiesVersionRange(migration.targetVersion, migration.sourceVersions)) {
-            throw new StudioMigrationError('invalid-result', `Migration ${migration.id} targets a version inside its own source range, so reapplication could never be rejected.`);
-        }
-        this.#migrations.set(migration.id, migration);
-    }
-    migrations() {
-        return [...this.#migrations.values()];
-    }
-    /** Ordered migrations whose source range and artifact kind match the document. */
-    plan(document) {
-        return this.migrations()
-            .filter((migration) => migration.artifactKinds.includes(document.kind) &&
-            satisfiesVersionRange(document.version, migration.sourceVersions))
-            .sort((left, right) => (left.id < right.id ? -1 : 1));
-    }
-    apply(document, migrationId, options = {}) {
-        const migration = this.#migrations.get(migrationId);
-        if (migration === undefined) {
-            throw new StudioMigrationError('unknown-migration', `Migration ${migrationId} is not registered.`);
-        }
-        if (!migration.artifactKinds.includes(document.kind)) {
-            throw new StudioMigrationError('not-applicable', `Migration ${migrationId} does not cover ${document.kind} artifacts.`);
-        }
-        if (!satisfiesVersionRange(document.version, migration.sourceVersions)) {
-            const code = document.version === migration.targetVersion ? 'already-applied' : 'not-applicable';
-            throw new StudioMigrationError(code, `Document version ${document.version} is outside the source range of ${migrationId}.`);
-        }
-        if (migration.lossClassification === 'lossy' && options.confirmLossy !== true) {
-            throw new StudioMigrationError('confirmation-required', `Migration ${migrationId} is lossy and requires explicit confirmation.`);
-        }
-        const migrated = migration.migrate(cloneContractValue(document));
-        const diagnostics = [];
-        if (migrated.kind !== document.kind) {
-            throw new StudioMigrationError('invalid-result', `Migration ${migrationId} changed the artifact kind from ${document.kind} to ${migrated.kind}.`);
-        }
-        if (migrated.version !== migration.targetVersion) {
-            throw new StudioMigrationError('invalid-result', `Migration ${migrationId} produced version ${migrated.version}, not the declared target ${migration.targetVersion}.`);
-        }
-        if (options.validate !== undefined) {
-            const validationDiagnostics = options.validate(migrated);
-            diagnostics.push(...validationDiagnostics);
-            if (validationDiagnostics.some((entry) => entry.severity === 'blocking' || entry.severity === 'error')) {
-                throw new StudioMigrationError('invalid-result', `Migration ${migrationId} produced an invalid document.`, validationDiagnostics);
-            }
-        }
-        return {
-            diagnostics,
-            document: migrated,
-            migrationId,
-        };
-    }
-}
-//# sourceMappingURL=migrations.js.map
+import{cloneContractValue as e}from"./clone.js";import{normalizeVersionRange as t,parseSemanticVersion as n,satisfiesVersionRange as r}from"./semver.js";export class StudioMigrationError extends Error{code;diagnostics;constructor(e,t,n=[]){super(t),this.name=`StudioMigrationError`,this.code=e,this.diagnostics=n}}export class MigrationRunner{#migrations=new Map;register(e){if(this.#migrations.has(e.id))throw new StudioMigrationError(`duplicate-migration`,`Migration ${e.id} is already registered.`);if(e.artifactKinds.length===0)throw new StudioMigrationError(`not-applicable`,`Migration ${e.id} declares no artifact kinds.`);if(t(e.sourceVersions),n(e.targetVersion),r(e.targetVersion,e.sourceVersions))throw new StudioMigrationError(`invalid-result`,`Migration ${e.id} targets a version inside its own source range, so reapplication could never be rejected.`);this.#migrations.set(e.id,e)}migrations(){return[...this.#migrations.values()]}plan(e){return this.migrations().filter(t=>t.artifactKinds.includes(e.kind)&&r(e.version,t.sourceVersions)).sort((e,t)=>e.id<t.id?-1:1)}apply(t,n,i={}){let a=this.#migrations.get(n);if(a===void 0)throw new StudioMigrationError(`unknown-migration`,`Migration ${n} is not registered.`);if(!a.artifactKinds.includes(t.kind))throw new StudioMigrationError(`not-applicable`,`Migration ${n} does not cover ${t.kind} artifacts.`);if(!r(t.version,a.sourceVersions)){let e=t.version===a.targetVersion?`already-applied`:`not-applicable`;throw new StudioMigrationError(e,`Document version ${t.version} is outside the source range of ${n}.`)}if(a.lossClassification===`lossy`&&i.confirmLossy!==!0)throw new StudioMigrationError(`confirmation-required`,`Migration ${n} is lossy and requires explicit confirmation.`);let o=a.migrate(e(t)),s=[];if(o.kind!==t.kind)throw new StudioMigrationError(`invalid-result`,`Migration ${n} changed the artifact kind from ${t.kind} to ${o.kind}.`);if(o.version!==a.targetVersion)throw new StudioMigrationError(`invalid-result`,`Migration ${n} produced version ${o.version}, not the declared target ${a.targetVersion}.`);if(i.validate!==void 0){let e=i.validate(o);if(s.push(...e),e.some(e=>e.severity===`blocking`||e.severity===`error`))throw new StudioMigrationError(`invalid-result`,`Migration ${n} produced an invalid document.`,e)}return{diagnostics:s,document:o,migrationId:n}}}

package/dist/model-commands.js

@@ -1,21 +1 @@
-import { cloneContractValue } from './clone.js';
-import { StudioCommandError } from './commands.js';
-export function applyModelCommand(model, command) {
-    if (command.artifactId !== model.id) {
-        throw new StudioCommandError('node-not-found', `Command targets ${command.artifactId}, not content model ${model.id}.`);
-    }
-    if (model.status !== 'draft') {
-        throw new StudioCommandError('artifact-not-draft', `Content model ${model.id} is ${model.status}; fields are added through a new draft.`);
-    }
-    if (model.fields.some((field) => field.id === command.payload.field.id)) {
-        throw new StudioCommandError('duplicate-field', `Field ${command.payload.field.id} already exists on ${model.id}.`);
-    }
-    const position = command.payload.position ?? model.fields.length;
-    if (!Number.isInteger(position) || position < 0 || position > model.fields.length) {
-        throw new StudioCommandError('invalid-index', `Field position ${position} is outside the model's field list.`);
-    }
-    const next = cloneContractValue(model);
-    next.fields.splice(position, 0, cloneContractValue(command.payload.field));
-    return next;
-}
-//# sourceMappingURL=model-commands.js.map
+import{cloneContractValue as e}from"./clone.js";import{StudioCommandError as t}from"./commands.js";export function applyModelCommand(n,r){if(r.artifactId!==n.id)throw new t(`node-not-found`,`Command targets ${r.artifactId}, not content model ${n.id}.`);if(n.status!==`draft`)throw new t(`artifact-not-draft`,`Content model ${n.id} is ${n.status}; fields are added through a new draft.`);if(n.fields.some(e=>e.id===r.payload.field.id))throw new t(`duplicate-field`,`Field ${r.payload.field.id} already exists on ${n.id}.`);let i=r.payload.position??n.fields.length;if(!Number.isInteger(i)||i<0||i>n.fields.length)throw new t(`invalid-index`,`Field position ${i} is outside the model's field list.`);let a=e(n);return a.fields.splice(i,0,e(r.payload.field)),a}