@kumwe/studio-core 0.1.0-alpha.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kumwe Studio contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

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

package/THIRD_PARTY_NOTICES.md

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

package/dist/binding-projection.d.ts

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

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

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

package/dist/binding-projection.js

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

package/dist/binding-projection.js.map

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

package/dist/canonical.d.ts

@@ -0,0 +1,20 @@
+import type { JsonValue } from '@kumwe/studio-protocol';
+export interface CanonicalSerializationOptions {
+    maximumDepth?: number;
+}
+/**
+ * Serialize a bounded JSON value into the canonical cross-language form the
+ * portability contract defines for checksums: UTF-8 JSON, object members
+ * sorted by Unicode code unit, arrays in semantic order, minimal ECMA-404
+ * string escaping, and finite numbers only. Every conforming runtime MUST
+ * produce byte-identical output for the same value.
+ */
+export declare function canonicalStringify(value: JsonValue, options?: Readonly<CanonicalSerializationOptions>): string;
+/**
+ * The canonical UTF-8 bytes of a value; checksums in Studio contracts are
+ * computed over exactly these bytes with the algorithm the referencing
+ * contract names (SRI-style sha256 unless stated otherwise). Encoding is
+ * implemented locally so the core stays free of DOM and platform globals.
+ */
+export declare function canonicalUtf8Bytes(value: JsonValue, options?: Readonly<CanonicalSerializationOptions>): Uint8Array;
+//# sourceMappingURL=canonical.d.ts.map

package/dist/canonical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical.d.ts","sourceRoot":"","sources":["../src/canonical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,WAAW,6BAA6B;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,QAAQ,CAAC,6BAA6B,CAAM,GACpD,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,OAAO,GAAE,QAAQ,CAAC,6BAA6B,CAAM,GACpD,UAAU,CA4BZ"}

package/dist/canonical.js

@@ -0,0 +1,100 @@
+const DEFAULT_MAXIMUM_DEPTH = 64;
+/**
+ * Serialize a bounded JSON value into the canonical cross-language form the
+ * portability contract defines for checksums: UTF-8 JSON, object members
+ * sorted by Unicode code unit, arrays in semantic order, minimal ECMA-404
+ * string escaping, and finite numbers only. Every conforming runtime MUST
+ * produce byte-identical output for the same value.
+ */
+export function canonicalStringify(value, options = {}) {
+    const maximumDepth = options.maximumDepth ?? DEFAULT_MAXIMUM_DEPTH;
+    if (!Number.isInteger(maximumDepth) || maximumDepth < 1) {
+        throw new RangeError('Canonical serialization depth must be a positive integer.');
+    }
+    return serialize(value, maximumDepth, 0);
+}
+/**
+ * The canonical UTF-8 bytes of a value; checksums in Studio contracts are
+ * computed over exactly these bytes with the algorithm the referencing
+ * contract names (SRI-style sha256 unless stated otherwise). Encoding is
+ * implemented locally so the core stays free of DOM and platform globals.
+ */
+export function canonicalUtf8Bytes(value, options = {}) {
+    const text = canonicalStringify(value, options);
+    const bytes = [];
+    for (const character of text) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint === undefined) {
+            break;
+        }
+        if (codePoint <= 0x7f) {
+            bytes.push(codePoint);
+        }
+        else if (codePoint <= 0x7ff) {
+            bytes.push(0xc0 | (codePoint >> 6), 0x80 | (codePoint & 0x3f));
+        }
+        else if (codePoint <= 0xffff) {
+            bytes.push(0xe0 | (codePoint >> 12), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+        }
+        else {
+            bytes.push(0xf0 | (codePoint >> 18), 0x80 | ((codePoint >> 12) & 0x3f), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+        }
+    }
+    return Uint8Array.from(bytes);
+}
+function serialize(value, maximumDepth, depth) {
+    if (value === null) {
+        return 'null';
+    }
+    switch (typeof value) {
+        case 'boolean':
+            return value ? 'true' : 'false';
+        case 'number': {
+            if (!Number.isFinite(value)) {
+                throw new TypeError('Canonical JSON cannot represent a non-finite number.');
+            }
+            // JSON.stringify implements the deterministic ECMAScript number
+            // grammar; Object.is separates -0, which canonicalizes to 0.
+            return JSON.stringify(Object.is(value, -0) ? 0 : value);
+        }
+        case 'string':
+            return JSON.stringify(value);
+        case 'object':
+            break;
+        default:
+            throw new TypeError(`Canonical JSON cannot represent a ${typeof value} value.`);
+    }
+    if (depth >= maximumDepth) {
+        throw new RangeError(`Canonical serialization exceeds the depth limit of ${maximumDepth}.`);
+    }
+    if (Array.isArray(value)) {
+        const items = value.map((item) => {
+            if (item === undefined) {
+                throw new TypeError('Canonical JSON arrays cannot contain undefined entries.');
+            }
+            return serialize(item, maximumDepth, depth + 1);
+        });
+        return `[${items.join(',')}]`;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype !== Object.prototype && prototype !== null) {
+        throw new TypeError('Canonical JSON only serializes plain objects and arrays.');
+    }
+    const members = Object.keys(value).sort(compareCodeUnits);
+    const parts = [];
+    for (const member of members) {
+        if (member === '__proto__' || member === 'prototype' || member === 'constructor') {
+            throw new TypeError(`Canonical JSON forbids the object member name ${member}.`);
+        }
+        const memberValue = value[member];
+        if (memberValue === undefined) {
+            continue;
+        }
+        parts.push(`${JSON.stringify(member)}:${serialize(memberValue, maximumDepth, depth + 1)}`);
+    }
+    return `{${parts.join(',')}}`;
+}
+function compareCodeUnits(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+//# sourceMappingURL=canonical.js.map

package/dist/canonical.js.map

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

package/dist/clone.d.ts

@@ -0,0 +1,2 @@
+export declare function cloneContractValue<T>(value: T): T;
+//# sourceMappingURL=clone.d.ts.map

package/dist/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAAA,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEjD"}

package/dist/clone.js

@@ -0,0 +1,4 @@
+export function cloneContractValue(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+//# sourceMappingURL=clone.js.map

package/dist/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../src/clone.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAI,KAAQ;IAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAM,CAAC;AAChD,CAAC"}

package/dist/commands.d.ts

@@ -0,0 +1,18 @@
+import type { BlueprintBatchOperation, BlueprintCommand, BlueprintDocument, StableId } from '@kumwe/studio-protocol';
+export type StudioCommandErrorCode = 'artifact-not-draft' | 'binding-not-found' | 'duplicate-field' | 'duplicate-node' | 'illegal-move' | 'invalid-batch' | 'invalid-id-map' | 'invalid-index' | 'invalid-order' | 'locale-mismatch' | 'mode-forbidden' | 'node-not-found' | 'parent-not-found' | 'property-not-found' | 'read-only-session' | 'stale-generation' | 'stale-state' | 'unsupported-command';
+export declare class StudioCommandError extends Error {
+    readonly code: StudioCommandErrorCode;
+    constructor(code: StudioCommandErrorCode, message: string);
+}
+export interface InverseCommandOptions {
+    id: StableId;
+}
+export declare function applyCommand(document: BlueprintDocument, command: BlueprintCommand): BlueprintDocument;
+export declare function invertCommand(document: BlueprintDocument, command: BlueprintCommand, options: Readonly<InverseCommandOptions>): BlueprintCommand;
+/**
+ * Applies one batchable operation to a document in place. Exported for the
+ * package-internal hybrid-bound trial evaluation in `modes.ts`; the public
+ * reducer surface remains `applyCommand`.
+ */
+export declare function applyOperation(document: BlueprintDocument, operation: BlueprintBatchOperation): void;
+//# sourceMappingURL=commands.d.ts.map

package/dist/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EASjB,QAAQ,EAET,MAAM,wBAAwB,CAAC;AAGhC,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,gBAAgB,GAChB,cAAc,GACd,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,aAAa,GACb,qBAAqB,CAAC;AAE1B,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,SAAgB,IAAI,EAAE,sBAAsB,CAAC;gBAE1B,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAKjE;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,QAAQ,CAAC;CACd;AAUD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,gBAAgB,GACxB,iBAAiB,CAqBnB;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACvC,gBAAgB,CA4DlB;AA2BD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,uBAAuB,GACjC,IAAI,CAgPN"}