studiograph 1.3.48-next.26 → 1.3.48-next.261

package/dist/core/artifact-paged-css.js

@@ -0,0 +1,253 @@
+/**
+ * Sanitize author CSS before it is handed to Paged.js's `previewer.preview()`.
+ *
+ * WHY: Paged.js preprocesses every stylesheet it is given and calls
+ * `new URL(value)` — with NO base argument — on each `url()` token. A scheme-less
+ * / root-relative value (`url('/api/assets/x.otf')`, `url('./logo.png')`, a bare
+ * `url(foo.png)`, a protocol-relative `url('//cdn/x')`, or a fragment
+ * `url('#g')`) makes `new URL()` throw `TypeError: Failed to construct 'URL'`
+ * synchronously, which aborts the ENTIRE pagination run. The catch in the
+ * pagination bootstrap then falls back to an un-paginated, `overflow:hidden`,
+ * margin-less single page — the user-visible "single page, missing margins" bug.
+ *
+ * FIX: neutralize every NON-absolute `url()` token to `url(about:blank)` in the
+ * copy handed to Paged.js. We do NOT absolutize: this Paged-fed copy exists for
+ * `@page` / break / named-page / running-element rules, and the body content's
+ * fonts/backgrounds paint from the head `<style>` sheet (a separate reader that
+ * keeps the real `url()`s) — so neutralizing here is visually invisible for the
+ * common case. (Empirically verified: a same-family `@font-face{src:url(about:blank)}`
+ * does NOT shadow the valid head face — text keeps its font.) ACCEPTED LIMITATION:
+ * an image that lives ONLY in the Paged-generated structure and is styled by a rule
+ * only Paged.js applies — a relative `url()` background in an `@page` margin-box
+ * (`@bottom-right { background: url('./x.png') }`) or a `position:running()` element —
+ * is blanked here (the head sheet's `@page` rules aren't honored by native CSS). An
+ * *absolute* url() in those spots still paints; an `<img>`-based letterhead logo is
+ * untouched (the scanner only rewrites CSS `url()`, never element `src`). Net: a
+ * working multi-page document with one missing relative margin-box image, vs. the
+ * prior behavior where that same CSS crashed pagination entirely. This is why the
+ * decision is neutralize-not-absolutize (no base-URL coupling); see the plan's D2.
+ *
+ * "Absolute" = exactly what `new URL(value)` (no base) accepts without throwing:
+ * a value carrying a URI scheme (`data:`, `blob:`, `http:`, `https:`, `file:`,
+ * `about:`, …). Anything else throws in Paged.js and is neutralized here, so this
+ * helper's predicate mirrors the crash predicate one-to-one.
+ *
+ * The parser is a real `url()` token scanner (not a regex): it skips CSS comments
+ * and string literals so it never matches `url(` inside them, honors `\` escapes
+ * inside the value, and passes absolute tokens through VERBATIM so a `data:` URI
+ * containing parens is never corrupted.
+ *
+ * Out of scope: a `url(` token whose FUNCTION NAME is spelled with an identifier
+ * escape (`u\72l(...)`) is not recognized here, so a relative ref written that way
+ * would still reach Paged.js. No author or tool emits that; if it ever happens the
+ * pagination-failure backstop (the bootstrap catch → host "couldn't paginate" hint)
+ * makes it observable rather than a silent clip — not a silent crash.
+ *
+ * RUNTIME TWIN: the pagination bootstrap can't import this module — it runs inside
+ * a sandboxed iframe. It injects {@link SANITIZE_CSS_URLS_TWIN} (a hand-mirror of
+ * this function, written with `String.raw` so no bundler helper like esbuild's
+ * `__name` and no escaping artifact can leak into the browser copy). The two are
+ * pinned together by `artifact-paged-css.parity.test.ts`, which runs both over a
+ * fixture set and asserts identical output — so a change to one that isn't
+ * mirrored in the other fails CI.
+ */
+export function sanitizeCssUrlsForPagination(css) {
+    if (!css)
+        return css;
+    const len = css.length;
+    const isIdent = (c) => c !== undefined && /[A-Za-z0-9_-]/.test(c);
+    const isSpace = (c) => c !== undefined && /\s/.test(c);
+    // Resolve enough CSS backslash escapes to read a leading URI scheme; a relative
+    // ref is neutralized regardless, so this only needs to be faithful for the
+    // rare escaped-scheme case.
+    const unescape = (s) => s.replace(/\\([0-9a-fA-F]{1,6}\s?|.)/g, (_m, p1) => {
+        if (/^[0-9a-fA-F]/.test(p1)) {
+            const code = parseInt(p1, 16);
+            return Number.isFinite(code) && code > 0 ? String.fromCodePoint(code) : '';
+        }
+        return p1;
+    });
+    // A value is safe iff it carries a URI scheme (`scheme:`), which is precisely
+    // what `new URL(value)` accepts without a base. Scheme-less values (`/x`, `./x`,
+    // `x`, `//host/x`, `#frag`) throw in Paged.js and are neutralized.
+    const isAbsolute = (value) => /^[a-z][a-z0-9+.-]*:/i.test(unescape(value).trim());
+    let out = '';
+    let i = 0;
+    while (i < len) {
+        const c = css[i];
+        // CSS comment — copy through untouched.
+        if (c === '/' && css[i + 1] === '*') {
+            const end = css.indexOf('*/', i + 2);
+            const stop = end === -1 ? len : end + 2;
+            out += css.slice(i, stop);
+            i = stop;
+            continue;
+        }
+        // Top-level string literal — copy through (a url() can't live inside one).
+        if (c === '"' || c === "'") {
+            let j = i + 1;
+            while (j < len) {
+                if (css[j] === '\\') {
+                    j += 2;
+                    continue;
+                }
+                if (css[j] === c) {
+                    j++;
+                    break;
+                }
+                j++;
+            }
+            out += css.slice(i, j);
+            i = j;
+            continue;
+        }
+        // url( function token — only when `url` is a standalone function name (the
+        // preceding char is not an identifier char, so `myurl(` / `figurl(` skip).
+        if ((c === 'u' || c === 'U') && css.slice(i, i + 4).toLowerCase() === 'url(' && !isIdent(css[i - 1])) {
+            let j = i + 4;
+            while (j < len && isSpace(css[j]))
+                j++;
+            let value = '';
+            if (css[j] === '"' || css[j] === "'") {
+                const q = css[j];
+                j++;
+                let raw = '';
+                while (j < len) {
+                    if (css[j] === '\\') {
+                        raw += css[j] + (css[j + 1] ?? '');
+                        j += 2;
+                        continue;
+                    }
+                    if (css[j] === q) {
+                        j++;
+                        break;
+                    }
+                    raw += css[j];
+                    j++;
+                }
+                value = raw;
+                while (j < len && isSpace(css[j]))
+                    j++;
+                if (css[j] === ')')
+                    j++;
+            }
+            else {
+                let raw = '';
+                while (j < len) {
+                    if (css[j] === '\\') {
+                        raw += css[j] + (css[j + 1] ?? '');
+                        j += 2;
+                        continue;
+                    }
+                    if (css[j] === ')') {
+                        j++;
+                        break;
+                    }
+                    raw += css[j];
+                    j++;
+                }
+                value = raw.trim();
+            }
+            if (isAbsolute(value)) {
+                out += css.slice(i, j); // verbatim — never reconstruct (data: URIs stay intact)
+            }
+            else {
+                out += 'url(about:blank)';
+            }
+            i = j;
+            continue;
+        }
+        out += c;
+        i++;
+    }
+    return out;
+}
+/**
+ * The runtime twin of {@link sanitizeCssUrlsForPagination}, injected verbatim into
+ * the pagination bootstrap (which runs inside the sandboxed iframe and can't import
+ * this module). It defines a `sanitizeCssUrlsForPagination(css)` function with
+ * behavior identical to the exported helper above. Written with `String.raw` so
+ * regex escapes (`\s`, `\\`) and the helper's own logic survive untouched — and so
+ * no bundler-injected helper (esbuild `__name`, etc.) can leak in. Kept in lock-step
+ * with the canonical helper by the parity test.
+ */
+export const SANITIZE_CSS_URLS_TWIN = String.raw `
+function sanitizeCssUrlsForPagination(css) {
+  if (!css) return css;
+  var len = css.length;
+  var isIdent = function (c) { return c !== undefined && /[A-Za-z0-9_-]/.test(c); };
+  var isSpace = function (c) { return c !== undefined && /\s/.test(c); };
+  var unescape = function (s) {
+    return s.replace(/\\([0-9a-fA-F]{1,6}\s?|.)/g, function (_m, p1) {
+      if (/^[0-9a-fA-F]/.test(p1)) {
+        var code = parseInt(p1, 16);
+        return Number.isFinite(code) && code > 0 ? String.fromCodePoint(code) : '';
+      }
+      return p1;
+    });
+  };
+  var isAbsolute = function (value) { return /^[a-z][a-z0-9+.-]*:/i.test(unescape(value).trim()); };
+  var out = '';
+  var i = 0;
+  while (i < len) {
+    var c = css[i];
+    if (c === '/' && css[i + 1] === '*') {
+      var end = css.indexOf('*/', i + 2);
+      var stop = end === -1 ? len : end + 2;
+      out += css.slice(i, stop);
+      i = stop;
+      continue;
+    }
+    if (c === '"' || c === "'") {
+      var js = i + 1;
+      while (js < len) {
+        if (css[js] === '\\') { js += 2; continue; }
+        if (css[js] === c) { js++; break; }
+        js++;
+      }
+      out += css.slice(i, js);
+      i = js;
+      continue;
+    }
+    if ((c === 'u' || c === 'U') && css.slice(i, i + 4).toLowerCase() === 'url(' && !isIdent(css[i - 1])) {
+      var j = i + 4;
+      while (j < len && isSpace(css[j])) j++;
+      var value = '';
+      if (css[j] === '"' || css[j] === "'") {
+        var q = css[j];
+        j++;
+        var raw = '';
+        while (j < len) {
+          if (css[j] === '\\') { raw += css[j] + (css[j + 1] || ''); j += 2; continue; }
+          if (css[j] === q) { j++; break; }
+          raw += css[j];
+          j++;
+        }
+        value = raw;
+        while (j < len && isSpace(css[j])) j++;
+        if (css[j] === ')') j++;
+      } else {
+        var rawu = '';
+        while (j < len) {
+          if (css[j] === '\\') { rawu += css[j] + (css[j + 1] || ''); j += 2; continue; }
+          if (css[j] === ')') { j++; break; }
+          rawu += css[j];
+          j++;
+        }
+        value = rawu.trim();
+      }
+      if (isAbsolute(value)) {
+        out += css.slice(i, j);
+      } else {
+        out += 'url(about:blank)';
+      }
+      i = j;
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return out;
+}
+`;
+//# sourceMappingURL=artifact-paged-css.js.map

package/dist/core/artifact-paged-css.js.map

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

package/dist/core/artifact-patch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Frame-addressable artifact patching (P4.1).
+ *
+ * `applyArtifactPatch` is the pure, surface-neutral core that lets an agent edit
+ * ONE frame (or one shared file / the token map) of a v2 artifact without
+ * re-emitting the whole bundle. Both `patch_artifact` surfaces — the in-app chat
+ * tool and the MCP tool — load the current bundle, call this to apply an ordered
+ * op list to a working copy, then hand the result to {@link
+ * (ArtifactStore:class).write} (the single write path, which re-validates as the
+ * authority and enforces the same OCC as a `create_artifact` update).
+ *
+ * The win is addressing, not storage: the bundle is still persisted whole, but
+ * the AGENT names "frame 7" instead of re-sending the deck. `patch_frame_content`
+ * is bounded to a single frame's text, so a substring edit can never corrupt the
+ * JSON envelope or a sibling frame — the failure mode that made `patch_entity` on
+ * an artifact body unsafe.
+ *
+ * This module owns op SHAPE + ADDRESSING validation only (unknown frame id, no
+ * substring match, non-permutation reorder, unsafe path, ...). It does NOT run
+ * the whole-bundle {@link validateArtifactBundle} — that stays the store's job,
+ * the single validation authority, so geometry/library/byte-cap rules are
+ * checked in exactly one place. Op input is accepted untyped (the tool boundary
+ * passes it through, mirroring how the `bundle` param is `unknown`) and parsed
+ * here, so the zod/typebox schemas never drift from the real contract.
+ */
+import { type ArtifactBundle } from './artifact-frame-model.js';
+/** Op-level failure — a bad addressing/shape problem the agent can fix and
+ *  retry (unknown frame id, zero/ambiguous substring match, non-permutation
+ *  reorder, malformed op). Surface tools map this to a recoverable tool error,
+ *  never a thrown turn. Distinct from the store's whole-bundle
+ *  `ArtifactWriteError('invalid')`. */
+export declare class ArtifactPatchError extends Error {
+    constructor(message: string);
+}
+export declare const ARTIFACT_PATCH_OP_KINDS: readonly ["set_frame_content", "patch_frame_content", "set_frame_meta", "add_frame", "remove_frame", "reorder_frames", "set_shared_file", "remove_shared_file", "set_tokens"];
+export type ArtifactPatchOpKind = typeof ARTIFACT_PATCH_OP_KINDS[number];
+export interface ArtifactPatchResult {
+    /** The mutated bundle (NOT yet whole-bundle-validated — the caller hands it to
+     *  ArtifactStore.write, which validates + normalizes as the authority). */
+    bundle: ArtifactBundle;
+    /** Frame ids whose content or metadata an op touched, or that an op added
+     *  (de-duplicated, in first-touch order). Drives the return-rich-lite signal
+     *  + the agent's "which frames changed" feedback. */
+    changedFrameIds: string[];
+    /** Frame ids an op removed. */
+    removedFrameIds: string[];
+    /** Whether a reorder_frames op ran (the order changed). */
+    reordered: boolean;
+}
+/**
+ * Apply an ordered op list to a COPY of `bundle`, returning the mutated bundle +
+ * a change summary. Ops apply in order against the running result, so a later op
+ * sees an earlier op's edits (e.g. add_frame then reorder_frames including the
+ * new id). Throws {@link ArtifactPatchError} on the first op-level problem,
+ * leaving the input bundle untouched (it is never mutated; the copy is
+ * discarded by the caller on throw).
+ */
+export declare function applyArtifactPatch(bundle: ArtifactBundle, ops: unknown): ArtifactPatchResult;

package/dist/core/artifact-patch.js

@@ -0,0 +1,309 @@
+/**
+ * Frame-addressable artifact patching (P4.1).
+ *
+ * `applyArtifactPatch` is the pure, surface-neutral core that lets an agent edit
+ * ONE frame (or one shared file / the token map) of a v2 artifact without
+ * re-emitting the whole bundle. Both `patch_artifact` surfaces — the in-app chat
+ * tool and the MCP tool — load the current bundle, call this to apply an ordered
+ * op list to a working copy, then hand the result to {@link
+ * (ArtifactStore:class).write} (the single write path, which re-validates as the
+ * authority and enforces the same OCC as a `create_artifact` update).
+ *
+ * The win is addressing, not storage: the bundle is still persisted whole, but
+ * the AGENT names "frame 7" instead of re-sending the deck. `patch_frame_content`
+ * is bounded to a single frame's text, so a substring edit can never corrupt the
+ * JSON envelope or a sibling frame — the failure mode that made `patch_entity` on
+ * an artifact body unsafe.
+ *
+ * This module owns op SHAPE + ADDRESSING validation only (unknown frame id, no
+ * substring match, non-permutation reorder, unsafe path, ...). It does NOT run
+ * the whole-bundle {@link validateArtifactBundle} — that stays the store's job,
+ * the single validation authority, so geometry/library/byte-cap rules are
+ * checked in exactly one place. Op input is accepted untyped (the tool boundary
+ * passes it through, mirroring how the `bundle` param is `unknown`) and parsed
+ * here, so the zod/typebox schemas never drift from the real contract.
+ */
+import { ARTIFACT_FRAME_LAYOUTS, ARTIFACT_DISPLAY_BACKGROUNDS, normalizeBackgroundValue, } from './artifact-frame-model.js';
+/** Op-level failure — a bad addressing/shape problem the agent can fix and
+ *  retry (unknown frame id, zero/ambiguous substring match, non-permutation
+ *  reorder, malformed op). Surface tools map this to a recoverable tool error,
+ *  never a thrown turn. Distinct from the store's whole-bundle
+ *  `ArtifactWriteError('invalid')`. */
+export class ArtifactPatchError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ArtifactPatchError';
+    }
+}
+export const ARTIFACT_PATCH_OP_KINDS = [
+    'set_frame_content',
+    'patch_frame_content',
+    'set_frame_meta',
+    'add_frame',
+    'remove_frame',
+    'reorder_frames',
+    'set_shared_file',
+    'remove_shared_file',
+    'set_tokens',
+];
+function isRecord(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+/** Deep clone via JSON round-trip — the bundle is pure JSON (frames, shared
+ *  files, tokens are all strings/numbers), so this is exact and keeps the input
+ *  bundle untouched (ops mutate the copy). */
+function cloneBundle(bundle) {
+    return JSON.parse(JSON.stringify(bundle));
+}
+function frameLabel(frame) {
+    return frame.title ? `"${frame.title}" (${frame.id})` : frame.id;
+}
+function requireString(value, field, opKind) {
+    if (typeof value !== 'string') {
+        throw new ArtifactPatchError(`${opKind}.${field} must be a string`);
+    }
+    return value;
+}
+function findFrame(bundle, frameId, opKind) {
+    if (typeof frameId !== 'string' || !frameId.trim()) {
+        throw new ArtifactPatchError(`${opKind}.frameId must be a non-empty string`);
+    }
+    const frame = bundle.frames.find((f) => f.id === frameId);
+    if (!frame) {
+        const ids = bundle.frames.map((f) => f.id).join(', ');
+        throw new ArtifactPatchError(`${opKind}: no frame with id "${frameId}". Existing frame ids: ${ids}.`);
+    }
+    return frame;
+}
+/** Apply one op to the working bundle. Records touched/removed ids and the
+ *  reorder flag back through `acc`. Throws {@link ArtifactPatchError} on any
+ *  addressing/shape problem. */
+function applyOp(bundle, rawOp, index, acc) {
+    if (!isRecord(rawOp)) {
+        throw new ArtifactPatchError(`ops[${index}] must be an object`);
+    }
+    const kind = rawOp.op;
+    if (typeof kind !== 'string' || !ARTIFACT_PATCH_OP_KINDS.includes(kind)) {
+        throw new ArtifactPatchError(`ops[${index}].op must be one of: ${ARTIFACT_PATCH_OP_KINDS.join(', ')} (got ${JSON.stringify(rawOp.op)})`);
+    }
+    switch (kind) {
+        case 'set_frame_content': {
+            const frame = findFrame(bundle, rawOp.frameId, kind);
+            frame.content = requireString(rawOp.content, 'content', kind);
+            acc.changed.add(frame.id);
+            return;
+        }
+        case 'patch_frame_content': {
+            const frame = findFrame(bundle, rawOp.frameId, kind);
+            const find = requireString(rawOp.find, 'find', kind);
+            const replace = requireString(rawOp.replace, 'replace', kind);
+            if (find === '') {
+                throw new ArtifactPatchError(`${kind}: \`find\` must be a non-empty string`);
+            }
+            if (find === replace) {
+                throw new ArtifactPatchError(`${kind}: \`find\` and \`replace\` are identical — nothing to do on frame ${frameLabel(frame)}`);
+            }
+            const occurrences = countOccurrences(frame.content, find);
+            if (occurrences === 0) {
+                throw new ArtifactPatchError(`${kind}: \`find\` substring not present in frame ${frameLabel(frame)}.`);
+            }
+            if (rawOp.expectedCount !== undefined) {
+                if (typeof rawOp.expectedCount !== 'number' || !Number.isInteger(rawOp.expectedCount) || rawOp.expectedCount < 1) {
+                    throw new ArtifactPatchError(`${kind}.expectedCount must be a positive integer`);
+                }
+                if (rawOp.expectedCount !== occurrences) {
+                    throw new ArtifactPatchError(`${kind}: expected ${rawOp.expectedCount} occurrence(s) of \`find\` in frame ${frameLabel(frame)}, found ${occurrences}. Refine \`find\` or fix expectedCount so you don't edit the wrong text.`);
+                }
+            }
+            // Replace ALL occurrences (parity with patch_entity); literal, not regex.
+            frame.content = frame.content.split(find).join(replace);
+            acc.changed.add(frame.id);
+            return;
+        }
+        case 'set_frame_meta': {
+            const frame = findFrame(bundle, rawOp.frameId, kind);
+            let touched = false;
+            if (rawOp.title !== undefined) {
+                const title = requireString(rawOp.title, 'title', kind);
+                // Empty/whitespace title CLEARS it (falls back to "Frame N" chrome);
+                // a non-empty value sets it (the store re-validates length).
+                if (title.trim() === '')
+                    delete frame.title;
+                else
+                    frame.title = title.trim();
+                touched = true;
+            }
+            if (rawOp.layout !== undefined) {
+                if (typeof rawOp.layout !== 'string' || !ARTIFACT_FRAME_LAYOUTS.includes(rawOp.layout)) {
+                    throw new ArtifactPatchError(`${kind}.layout must be one of: ${ARTIFACT_FRAME_LAYOUTS.join(', ')}`);
+                }
+                frame.layout = rawOp.layout;
+                touched = true;
+            }
+            if (rawOp.geometry !== undefined) {
+                // geometry is REPLACED wholesale, not merged — require both fields so a
+                // `{ width }`-only op fails with a clear message here instead of a
+                // low-level "geometry.height must be…" from the store after it has
+                // silently dropped the existing height. Numeric bounds stay the store's
+                // whole-bundle validate (single authority for the geometry rules).
+                if (!isRecord(rawOp.geometry) || rawOp.geometry.width === undefined || rawOp.geometry.height === undefined) {
+                    throw new ArtifactPatchError(`${kind}.geometry must be a full { width, height } object (it replaces the frame's geometry, it does not merge)`);
+                }
+                frame.geometry = rawOp.geometry;
+                touched = true;
+            }
+            if (rawOp.background !== undefined) {
+                const bg = rawOp.background;
+                // Empty string clears the per-frame override (inherits display default).
+                if (bg === '' || bg === null) {
+                    delete frame.background;
+                }
+                else {
+                    // Same grammar as create_artifact: a keyword OR a safe custom CSS
+                    // color/gradient (shared normalizer — set_frame_meta used to reject
+                    // custom colors that create accepted, forcing a `transparent` workaround).
+                    const normalized = normalizeBackgroundValue(bg);
+                    if (normalized === null) {
+                        throw new ArtifactPatchError(`${kind}.background must be ${ARTIFACT_DISPLAY_BACKGROUNDS.join(' / ')}, a safe CSS color/gradient, or "" to clear`);
+                    }
+                    frame.background = normalized;
+                }
+                touched = true;
+            }
+            if (!touched) {
+                throw new ArtifactPatchError(`${kind}: nothing to change — pass at least one of title, layout, geometry, background.`);
+            }
+            acc.changed.add(frame.id);
+            return;
+        }
+        case 'add_frame': {
+            if (!isRecord(rawOp.frame)) {
+                throw new ArtifactPatchError(`${kind}.frame must be a frame object ({ id, layout, geometry, content, ... })`);
+            }
+            const newId = rawOp.frame.id;
+            if (typeof newId !== 'string' || !newId.trim()) {
+                throw new ArtifactPatchError(`${kind}.frame.id must be a non-empty string`);
+            }
+            if (bundle.frames.some((f) => f.id === newId)) {
+                throw new ArtifactPatchError(`${kind}: a frame with id "${newId}" already exists. Pick a unique id.`);
+            }
+            // `content` must be a string up front: a later op in this batch (e.g.
+            // patch_frame_content on the new frame) would otherwise hit a generic
+            // TypeError instead of a recoverable ArtifactPatchError. The store's
+            // whole-bundle validate enforces the rest (layout enum, geometry bounds).
+            if (typeof rawOp.frame.content !== 'string') {
+                throw new ArtifactPatchError(`${kind}.frame.content must be a string`);
+            }
+            const frame = rawOp.frame;
+            let at = bundle.frames.length;
+            if (rawOp.atIndex !== undefined) {
+                if (typeof rawOp.atIndex !== 'number' || !Number.isInteger(rawOp.atIndex) || rawOp.atIndex < 0) {
+                    throw new ArtifactPatchError(`${kind}.atIndex must be a non-negative integer`);
+                }
+                at = Math.min(rawOp.atIndex, bundle.frames.length);
+            }
+            bundle.frames.splice(at, 0, frame);
+            acc.changed.add(newId);
+            // If this id was removed earlier in the same batch, it's a replacement,
+            // not a removal — don't report it as both removed and changed.
+            acc.removed.delete(newId);
+            return;
+        }
+        case 'remove_frame': {
+            const frame = findFrame(bundle, rawOp.frameId, kind);
+            if (bundle.frames.length === 1) {
+                throw new ArtifactPatchError(`${kind}: cannot remove the only frame — an artifact must have at least one frame. Replace its content instead, or delete the whole artifact entry.`);
+            }
+            bundle.frames = bundle.frames.filter((f) => f.id !== frame.id);
+            acc.removed.add(frame.id);
+            // A frame removed earlier in the batch should not also count as "changed".
+            acc.changed.delete(frame.id);
+            return;
+        }
+        case 'reorder_frames': {
+            if (!Array.isArray(rawOp.order) || rawOp.order.some((id) => typeof id !== 'string')) {
+                throw new ArtifactPatchError(`${kind}.order must be an array of frame ids`);
+            }
+            const order = rawOp.order;
+            const current = bundle.frames.map((f) => f.id);
+            if (order.length !== current.length || new Set(order).size !== order.length || !current.every((id) => order.includes(id))) {
+                throw new ArtifactPatchError(`${kind}.order must be a permutation of the current frame ids (each exactly once). Current order: [${current.join(', ')}].`);
+            }
+            const byId = new Map(bundle.frames.map((f) => [f.id, f]));
+            const next = order.map((id) => byId.get(id));
+            // OR, never assign: a later identity-reorder in the same batch must not
+            // clear an earlier real reorder's flag.
+            acc.reordered = acc.reordered || current.some((id, i) => id !== order[i]);
+            bundle.frames = next;
+            return;
+        }
+        case 'set_shared_file': {
+            const path = requireString(rawOp.path, 'path', kind);
+            const content = requireString(rawOp.content, 'content', kind);
+            // Path safety + extension allowlist is the store's whole-bundle validate.
+            const shared = bundle.shared ?? (bundle.shared = {});
+            const files = shared.files ?? (shared.files = {});
+            files[path] = content;
+            return;
+        }
+        case 'remove_shared_file': {
+            const path = requireString(rawOp.path, 'path', kind);
+            const files = bundle.shared?.files;
+            if (!files || !(path in files)) {
+                const existing = files ? Object.keys(files).join(', ') : '(none)';
+                throw new ArtifactPatchError(`${kind}: no shared file at "${path}". Existing shared files: ${existing}.`);
+            }
+            delete files[path];
+            if (Object.keys(files).length === 0)
+                delete bundle.shared.files;
+            return;
+        }
+        case 'set_tokens': {
+            if (!isRecord(rawOp.tokens)) {
+                throw new ArtifactPatchError(`${kind}.tokens must be an object of name → CSS value`);
+            }
+            // Replace the whole token map (it's a small global). Token-name/value
+            // validation is the store's whole-bundle validate. An empty object clears
+            // tokens (the store drops an empty map).
+            bundle.tokens = rawOp.tokens;
+            return;
+        }
+    }
+}
+function countOccurrences(haystack, needle) {
+    if (needle === '')
+        return 0;
+    let count = 0;
+    let from = 0;
+    for (;;) {
+        const at = haystack.indexOf(needle, from);
+        if (at === -1)
+            break;
+        count++;
+        from = at + needle.length;
+    }
+    return count;
+}
+/**
+ * Apply an ordered op list to a COPY of `bundle`, returning the mutated bundle +
+ * a change summary. Ops apply in order against the running result, so a later op
+ * sees an earlier op's edits (e.g. add_frame then reorder_frames including the
+ * new id). Throws {@link ArtifactPatchError} on the first op-level problem,
+ * leaving the input bundle untouched (it is never mutated; the copy is
+ * discarded by the caller on throw).
+ */
+export function applyArtifactPatch(bundle, ops) {
+    if (!Array.isArray(ops) || ops.length === 0) {
+        throw new ArtifactPatchError('ops must be a non-empty array of patch operations');
+    }
+    const working = cloneBundle(bundle);
+    const acc = { changed: new Set(), removed: new Set(), reordered: false };
+    ops.forEach((op, index) => applyOp(working, op, index, acc));
+    return {
+        bundle: working,
+        changedFrameIds: [...acc.changed],
+        removedFrameIds: [...acc.removed],
+        reordered: acc.reordered,
+    };
+}
+//# sourceMappingURL=artifact-patch.js.map

package/dist/core/artifact-patch.js.map

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