@kumwe/studio-preview 0.1.0-alpha.10

package/dist/preview-identity.d.ts

@@ -0,0 +1,29 @@
+import { type CanonicalSerializationOptions } from '@kumwe/studio-core';
+import type { BlueprintDocument, NodeId, StableId, StudioArtifact } from '@kumwe/studio-protocol';
+export interface PreviewDigestOptions extends CanonicalSerializationOptions {
+    /** Web Crypto implementation used to hash the canonical bytes. */
+    subtle?: Pick<SubtleCrypto, 'digest'>;
+}
+export interface PreviewMarkerInventory {
+    markerMap: Record<StableId, NodeId>;
+    markers: StableId[];
+}
+/**
+ * Return the exact digest preimage for a complete, schema-valid Studio draft.
+ * No transport envelope, prefix, BOM, viewport, revision override, or trailing
+ * newline is added: the preimage is only the canonical UTF-8 artifact bytes.
+ * The authoritative host MUST schema- and semantics-validate the artifact
+ * before treating this helper's result as a valid draft identity.
+ */
+export declare function canonicalPreviewDraftBytes(draft: StudioArtifact, options?: Readonly<CanonicalSerializationOptions>): Uint8Array;
+/** Compute the lowercase SHA-256 hex identity of a complete Studio draft. */
+export declare function computePreviewDraftDigest(draft: StudioArtifact, options?: Readonly<PreviewDigestOptions>): Promise<string>;
+/** Create the canonical marker for one zero-based Blueprint preorder ordinal. */
+export declare function createPreviewMarker(draftDigest: string, ordinal: number): StableId;
+/**
+ * Build the portable marker inventory for a Blueprint. Traversal is roots in
+ * array order, each node before descendants, slot names in ascending UTF-16
+ * code-unit order, and children in array order. Node ids must be unique.
+ */
+export declare function createPreviewMarkerInventory(draft: BlueprintDocument, draftDigest: string): PreviewMarkerInventory;
+//# sourceMappingURL=preview-identity.d.ts.map

package/dist/preview-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-identity.d.ts","sourceRoot":"","sources":["../src/preview-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EACV,iBAAiB,EAGjB,MAAM,EACN,QAAQ,EACR,cAAc,EACf,MAAM,wBAAwB,CAAC;AAKhC,MAAM,WAAW,oBAAqB,SAAQ,6BAA6B;IACzE,kEAAkE;IAClE,MAAM,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACpC,OAAO,EAAE,QAAQ,EAAE,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,QAAQ,CAAC,6BAA6B,CAAM,GACpD,UAAU,CAEZ;AAED,6EAA6E;AAC7E,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,QAAQ,CAAC,oBAAoB,CAAM,GAC3C,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAQlF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAClB,sBAAsB,CA4BxB"}

package/dist/preview-identity.js

@@ -0,0 +1,61 @@
+import { canonicalUtf8Bytes } from '@kumwe/studio-core';
+const draftDigestPattern = /^[0-9a-f]{64}$/u;
+const maximumMarkerOrdinal = 99_999;
+/**
+ * Return the exact digest preimage for a complete, schema-valid Studio draft.
+ * No transport envelope, prefix, BOM, viewport, revision override, or trailing
+ * newline is added: the preimage is only the canonical UTF-8 artifact bytes.
+ * The authoritative host MUST schema- and semantics-validate the artifact
+ * before treating this helper's result as a valid draft identity.
+ */
+export function canonicalPreviewDraftBytes(draft, options = {}) {
+    return canonicalUtf8Bytes(draft, options);
+}
+/** Compute the lowercase SHA-256 hex identity of a complete Studio draft. */
+export async function computePreviewDraftDigest(draft, options = {}) {
+    const subtle = options.subtle ?? globalThis.crypto.subtle;
+    const serializationOptions = options.maximumDepth === undefined ? {} : { maximumDepth: options.maximumDepth };
+    const preimage = Uint8Array.from(canonicalPreviewDraftBytes(draft, serializationOptions));
+    const digest = await subtle.digest('SHA-256', preimage);
+    return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, '0')).join('');
+}
+/** Create the canonical marker for one zero-based Blueprint preorder ordinal. */
+export function createPreviewMarker(draftDigest, ordinal) {
+    if (!draftDigestPattern.test(draftDigest)) {
+        throw new TypeError('Preview draft digest must be 64 lowercase hexadecimal characters.');
+    }
+    if (!Number.isSafeInteger(ordinal) || ordinal < 0 || ordinal > maximumMarkerOrdinal) {
+        throw new RangeError(`Preview marker ordinal must be between 0 and ${maximumMarkerOrdinal}.`);
+    }
+    return `studio.preview/node/${draftDigest}/${ordinal}`;
+}
+/**
+ * Build the portable marker inventory for a Blueprint. Traversal is roots in
+ * array order, each node before descendants, slot names in ascending UTF-16
+ * code-unit order, and children in array order. Node ids must be unique.
+ */
+export function createPreviewMarkerInventory(draft, draftDigest) {
+    const markerMap = {};
+    const markers = [];
+    const nodeIds = new Set();
+    const visit = (node) => {
+        if (nodeIds.has(node.id)) {
+            throw new TypeError(`Preview marker inventory cannot contain duplicate node id ${node.id}.`);
+        }
+        nodeIds.add(node.id);
+        const marker = createPreviewMarker(draftDigest, markers.length);
+        markers.push(marker);
+        markerMap[marker] = node.id;
+        const slots = Object.entries(node.slots).sort(([left], [right]) => left < right ? -1 : left > right ? 1 : 0);
+        for (const [, children] of slots) {
+            for (const child of children) {
+                visit(child);
+            }
+        }
+    };
+    for (const root of draft.roots) {
+        visit(root);
+    }
+    return { markerMap, markers };
+}
+//# sourceMappingURL=preview-identity.js.map

package/dist/preview-identity.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@kumwe/studio-preview",
+  "version": "0.1.0-alpha.10",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kumwe/studio.git",
+    "directory": "packages/preview"
+  },
+  "homepage": "https://github.com/kumwe/studio/tree/main/packages/preview#readme",
+  "bugs": "https://github.com/kumwe/studio/issues",
+  "description": "Origin-bound request channel for server-rendered Studio previews.",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
+    "third-party-licenses",
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "@kumwe/studio-core": "0.1.0-alpha.10",
+    "@kumwe/studio-protocol": "0.1.0-alpha.10"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  }
+}