openplanr 3.1.1 → 3.2.0

package/lib/host-packages/cursor/openplanr/runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources/03-protocol-contracts.js

@@ -4626,7 +4626,22 @@
     }
     return value;
   };
-  var DESIGN_DOCUMENT_SCHEMA = freeze({
+  var FRAME_SCHEMA = {
+    type: "array",
+    minItems: 1,
+    items: {
+      type: "object",
+      additionalProperties: false,
+      required: ["id", "label", "width", "height"],
+      properties: {
+        id: { $ref: "#/$defs/id" },
+        label: { $ref: "#/$defs/text" },
+        width: { type: "integer", minimum: 1, maximum: 16384 },
+        height: { type: "integer", minimum: 1, maximum: 16384 }
+      }
+    }
+  };
+  var DESIGN_DOCUMENT_V1_SCHEMA = freeze({
     $schema: "https://json-schema.org/draft/2020-12/schema",
     $id: "https://openplanr.dev/schemas/v1.9.0/design-document.schema.json",
     "x-openplanr-contract": { id: "design-document", version: "1.9.0" },
@@ -4677,21 +4692,7 @@
         }
       },
       assets: { $ref: "#/$defs/paths" },
-      frames: {
-        type: "array",
-        minItems: 1,
-        items: {
-          type: "object",
-          additionalProperties: false,
-          required: ["id", "label", "width", "height"],
-          properties: {
-            id: { $ref: "#/$defs/id" },
-            label: { $ref: "#/$defs/text" },
-            width: { type: "integer", minimum: 1, maximum: 16384 },
-            height: { type: "integer", minimum: 1, maximum: 16384 }
-          }
-        }
-      },
+      frames: FRAME_SCHEMA,
       screens: {
         type: "array",
         minItems: 1,
@@ -4767,6 +4768,65 @@
       }
     }
   });
+  var DESIGN_DOCUMENT_SCHEMA = freeze({
+    ...DESIGN_DOCUMENT_V1_SCHEMA,
+    $id: "https://openplanr.dev/schemas/v1.20.0/design-document.schema.json",
+    "x-openplanr-contract": { id: "design-document", version: "1.20.0" },
+    properties: {
+      .../** @type {Record<string, unknown>} */
+      DESIGN_DOCUMENT_V1_SCHEMA.properties,
+      frames: {
+        ...FRAME_SCHEMA,
+        items: {
+          ...FRAME_SCHEMA.items,
+          properties: {
+            ...FRAME_SCHEMA.items.properties,
+            height: { anyOf: [{ type: "integer", minimum: 1, maximum: 16384 }, { const: "auto" }] }
+          }
+        }
+      },
+      layout: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          boards: {
+            type: "object",
+            description: "Keys are screenId, screenId/frameId or screenId/frameId/variantId; each ID must exist in the document.",
+            additionalProperties: {
+              type: "object",
+              additionalProperties: false,
+              required: ["x", "y"],
+              properties: {
+                x: { $ref: "#/$defs/coordinate" },
+                y: { $ref: "#/$defs/coordinate" },
+                title: { $ref: "#/$defs/text" }
+              }
+            }
+          },
+          sections: {
+            type: "array",
+            items: {
+              type: "object",
+              additionalProperties: false,
+              required: ["id", "x", "y", "text"],
+              properties: {
+                id: { $ref: "#/$defs/id" },
+                x: { $ref: "#/$defs/coordinate" },
+                y: { $ref: "#/$defs/coordinate" },
+                text: { $ref: "#/$defs/text" },
+                maxW: { type: "integer", minimum: 1, maximum: 16384 }
+              }
+            }
+          }
+        }
+      }
+    },
+    $defs: {
+      .../** @type {Record<string, unknown>} */
+      DESIGN_DOCUMENT_V1_SCHEMA.$defs,
+      coordinate: { type: "number", minimum: -1e7, maximum: 1e7 }
+    }
+  });
 
   // ../protocol/src/workspace-contracts.mjs
   var DESIGN_WORKSPACE_VERSION = "1.0.0";
@@ -4851,7 +4911,7 @@
   });
   var designProperties = (
     /** @type {Record<string, { items: { properties: Record<string, unknown>; required: string[] } }>} */
-    structuredClone(DESIGN_DOCUMENT_SCHEMA.properties)
+    structuredClone(DESIGN_DOCUMENT_V1_SCHEMA.properties)
   );
   for (const key of ["kind", "schemaVersion", "brief", "assets", "designSystem"])
     delete designProperties[key];
@@ -4923,7 +4983,7 @@
       },
       ["kind", "schemaVersion", "design", "envelope", "entries", "revision"]
     ),
-    $defs: structuredClone(DESIGN_DOCUMENT_SCHEMA.$defs)
+    $defs: structuredClone(DESIGN_DOCUMENT_V1_SCHEMA.$defs)
   };
   var DESIGN_WORKSPACE_SCHEMAS = Object.freeze({
     "design-review-workspace": DESIGN_WORKSPACE_SCHEMA,
@@ -5037,6 +5097,86 @@
     "diagram-workspace-event": DIAGRAM_WORKSPACE_EVENT_SCHEMA
   });
 
+  // ../protocol/src/shape-library-contracts.mjs
+  var closed5 = (properties) => ({
+    type: "object",
+    additionalProperties: false,
+    required: Object.keys(properties),
+    properties
+  });
+  var unit = { type: "number", minimum: 0, maximum: 1 };
+  var extent = { type: "number", exclusiveMinimum: 0, maximum: 1 };
+  var point2 = closed5({ x: unit, y: unit });
+  var identifier = { type: "string", pattern: "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$", maxLength: 128 };
+  var version = { type: "string", pattern: "^[0-9]+\\.[0-9]+\\.[0-9]+$", maxLength: 32 };
+  var digest6 = { type: "string", pattern: "^sha256:[a-f0-9]{64}$" };
+  var rect = {
+    type: { const: "rect" },
+    x: unit,
+    y: unit,
+    width: extent,
+    height: extent,
+    radius: unit
+  };
+  var ellipse = { type: { const: "ellipse" }, cx: unit, cy: unit, rx: extent, ry: extent };
+  var polygon = {
+    type: { const: "polygon" },
+    points: { type: "array", minItems: 3, maxItems: 32, items: point2 }
+  };
+  var paint = { fill: { enum: ["fill", "none"] }, stroke: { enum: ["stroke", "none"] } };
+  var pixels = { type: "number", minimum: 1, maximum: 1e4 };
+  var SHAPE_REFERENCE_SCHEMA = closed5({
+    packId: identifier,
+    packVersion: version,
+    shapeId: identifier,
+    definitionDigest: digest6
+  });
+  var SHAPE_DEFINITION_SCHEMA = {
+    $schema: "https://json-schema.org/draft/2020-12/schema",
+    $id: "https://openplanr.dev/schemas/v1.21.0/diagram-shape-definition.schema.json",
+    "x-openplanr-contract": { id: "diagram-shape-definition", version: "1.21.0" },
+    ...closed5({
+      ...SHAPE_REFERENCE_SCHEMA.properties,
+      name: { type: "string", minLength: 1, maxLength: 128 },
+      description: { type: "string", maxLength: 1024 },
+      tags: {
+        type: "array",
+        maxItems: 16,
+        uniqueItems: true,
+        items: { type: "string", minLength: 1, maxLength: 64 }
+      },
+      primitives: {
+        type: "array",
+        minItems: 1,
+        maxItems: 32,
+        items: {
+          oneOf: [
+            closed5({ ...rect, ...paint }),
+            closed5({ ...ellipse, ...paint }),
+            closed5({ ...polygon, ...paint }),
+            closed5({
+              type: { const: "line" },
+              x1: unit,
+              y1: unit,
+              x2: unit,
+              y2: unit,
+              stroke: paint.stroke
+            })
+          ]
+        }
+      },
+      attachment: { oneOf: [closed5(rect), closed5(ellipse), closed5(polygon)] },
+      textRegion: closed5({ x: unit, y: unit, width: extent, height: extent }),
+      sizing: closed5({ width: pixels, height: pixels, minWidth: pixels, minHeight: pixels })
+    })
+  };
+  var SHAPE_LIBRARY_SCHEMA = {
+    type: "array",
+    maxItems: 512,
+    items: SHAPE_DEFINITION_SCHEMA
+  };
+  var GEOMETRY_ROUNDOFF = Number.EPSILON * 32;
+
   // ../protocol/src/studio-presentation-contracts.mjs
   var DIAGRAM_PRESENTATION_SCHEMA = {
     $schema: "https://json-schema.org/draft/2020-12/schema",
@@ -5101,6 +5241,67 @@
       DIAGRAM_AUTHORING_BUNDLE_V11_SCHEMA
     ]
   };
+  function withShapeReferences(schema6) {
+    const copy = structuredClone(schema6);
+    function visit(value) {
+      if (!value || typeof value !== "object") return;
+      if (value.properties?.shape && value.properties?.strokeWidth && value.properties?.fontSize)
+        value.properties.shapeRef = SHAPE_REFERENCE_SCHEMA;
+      for (const child of Object.values(value)) visit(child);
+    }
+    visit(copy);
+    return copy;
+  }
+  function versionSchema(schema6, name) {
+    return {
+      ...schema6,
+      $id: `https://openplanr.dev/schemas/v1.21.0/${name}.schema.json`,
+      "x-openplanr-contract": { id: name, version: "1.21.0" }
+    };
+  }
+  var DIAGRAM_AUTHORING_BUNDLE_V12_SCHEMA = versionSchema(
+    withShapeReferences(DIAGRAM_AUTHORING_BUNDLE_V11_SCHEMA),
+    "diagram-authoring-bundle"
+  );
+  Object.assign(DIAGRAM_AUTHORING_BUNDLE_V12_SCHEMA.properties, {
+    schemaVersion: { const: "1.2.0" },
+    protocolVersion: { const: "1.21.0" },
+    shapeLibrary: SHAPE_LIBRARY_SCHEMA
+  });
+  DIAGRAM_AUTHORING_BUNDLE_V12_SCHEMA.required = DIAGRAM_AUTHORING_BUNDLE_V12_SCHEMA.required.filter((key) => key !== "studioPresentation").concat("shapeLibrary");
+  var DIAGRAM_EDIT_TRANSACTION_V12_SCHEMA = versionSchema(
+    withShapeReferences(DIAGRAM_EDIT_TRANSACTION_V11_SCHEMA),
+    "diagram-edit-transaction"
+  );
+  Object.assign(DIAGRAM_EDIT_TRANSACTION_V12_SCHEMA.properties, {
+    schemaVersion: { const: "1.2.0" },
+    protocolVersion: { const: "1.21.0" }
+  });
+  DIAGRAM_EDIT_TRANSACTION_V12_SCHEMA.properties.operations.items.oneOf.push({
+    type: "object",
+    additionalProperties: false,
+    required: ["type", "before", "after"],
+    properties: {
+      type: { const: "set-shape-library" },
+      before: { anyOf: [SHAPE_LIBRARY_SCHEMA, { type: "null" }] },
+      after: { anyOf: [SHAPE_LIBRARY_SCHEMA, { type: "null" }] }
+    }
+  });
+  var DIAGRAM_REVIEW_BUNDLE_V12_SCHEMA = versionSchema(
+    structuredClone(DIAGRAM_REVIEW_BUNDLE_SCHEMA),
+    "diagram-review-bundle"
+  );
+  Object.assign(DIAGRAM_REVIEW_BUNDLE_V12_SCHEMA.properties, {
+    schemaVersion: { const: "1.2.0" },
+    presentation: DIAGRAM_PRESENTATION_SCHEMA,
+    authored: {
+      oneOf: [
+        DIAGRAM_AUTHORING_SCHEMAS["diagram-authoring-bundle"],
+        DIAGRAM_AUTHORING_BUNDLE_V11_SCHEMA,
+        DIAGRAM_AUTHORING_BUNDLE_V12_SCHEMA
+      ]
+    }
+  });
 
   // ../protocol/src/large-object-limits.mjs
   var LARGE_OBJECT_LIMITS = Object.freeze({
@@ -5124,10 +5325,10 @@
   var LARGE_OBJECT_VERSION = "2.0.0";
   var RESOURCE_HTML_SEGMENT_ENCODING = "openplanr.html-segments.utf8-v1";
   var id6 = { type: "string", pattern: "^[A-Za-z0-9_-]{22,64}$" };
-  var digest6 = { type: "string", pattern: "^[a-f0-9]{64}$" };
+  var digest7 = { type: "string", pattern: "^[a-f0-9]{64}$" };
   var signature3 = { type: "string", pattern: "^[A-Za-z0-9_-]{86}$" };
   var integer2 = (max, min = 0) => ({ type: "integer", minimum: min, maximum: max });
-  var closed5 = (properties, required = Object.keys(properties)) => ({
+  var closed6 = (properties, required = Object.keys(properties)) => ({
     type: "object",
     additionalProperties: false,
     properties,
@@ -5135,23 +5336,23 @@
   });
   var iso2 = { type: "string", format: "date-time", maxLength: 40 };
   var codec = { enum: ["identity", "deflate-raw"] };
-  var publicKey2 = closed5({
+  var publicKey2 = closed6({
     kty: { const: "EC" },
     crv: { const: "P-256" },
     x: { type: "string", pattern: "^[A-Za-z0-9_-]{43}$" },
     y: { type: "string", pattern: "^[A-Za-z0-9_-]{43}$" }
   });
-  var keyring = closed5({
+  var keyring = closed6({
     iv: { type: "string", pattern: "^[A-Za-z0-9_-]{16}$" },
     ciphertext: { type: "string", pattern: "^[A-Za-z0-9_-]+$", maxLength: 65536 }
   });
-  var chunk = closed5({
+  var chunk = closed6({
     index: integer2(128),
     byteLength: integer2(LARGE_OBJECT_LIMITS.chunkBytes, 17),
     iv: { type: "string", pattern: "^[A-Za-z0-9_-]{16}$" },
-    sha256: digest6
+    sha256: digest7
   });
-  var catalogSpan = closed5({
+  var catalogSpan = closed6({
     offset: integer2(LARGE_OBJECT_LIMITS.decodedBytes),
     encodedBytes: integer2(LARGE_OBJECT_LIMITS.catalogBytes, 1),
     decodedBytes: integer2(LARGE_OBJECT_LIMITS.catalogBytes, 1),
@@ -5161,7 +5362,7 @@
     $schema: "https://json-schema.org/draft/2020-12/schema",
     $id: `https://openplanr.dev/schemas/v1.17.0/${name}.schema.json`,
     "x-openplanr-contract": { id: name, version: "1.17.0" },
-    ...closed5(properties, required)
+    ...closed6(properties, required)
   });
   var ENCRYPTED_RESOURCE_MANIFEST_SCHEMA = schema5("encrypted-resource-manifest", {
     schemaVersion: { const: LARGE_OBJECT_VERSION },
@@ -5183,8 +5384,8 @@
     expectedVersion: integer2(Number.MAX_SAFE_INTEGER),
     epoch: integer2(Number.MAX_SAFE_INTEGER, 1),
     ownerPublicKey: publicKey2,
-    ownerAuthHash: digest6,
-    reviewerAuthHash: digest6,
+    ownerAuthHash: digest7,
+    reviewerAuthHash: digest7,
     keyring,
     manifest: ENCRYPTED_RESOURCE_MANIFEST_SCHEMA,
     signature: signature3
@@ -5193,7 +5394,7 @@
     schemaVersion: { const: LARGE_OBJECT_VERSION },
     workspaceId: id6,
     operationId: id6,
-    manifestSha256: digest6,
+    manifestSha256: digest7,
     signature: signature3
   });
   var ENCRYPTED_UPLOAD_RECEIPT_SCHEMA = schema5("encrypted-upload-receipt", {
@@ -5201,7 +5402,7 @@
     workspaceId: id6,
     operationId: id6,
     revisionId: id6,
-    manifestSha256: digest6,
+    manifestSha256: digest7,
     status: { const: "committed" },
     version: integer2(Number.MAX_SAFE_INTEGER, 1),
     committedAt: iso2
@@ -5213,14 +5414,14 @@
       workspaceId: id6,
       operationId: id6,
       revisionId: id6,
-      manifestSha256: digest6,
+      manifestSha256: digest7,
       status: { enum: ["prepared", "committed"] },
       receivedChunks: {
         type: "array",
         maxItems: LARGE_OBJECT_LIMITS.chunks,
-        items: closed5({
+        items: closed6({
           index: integer2(128),
-          sha256: digest6,
+          sha256: digest7,
           byteLength: integer2(LARGE_OBJECT_LIMITS.chunkBytes, 17)
         })
       },
@@ -5260,14 +5461,14 @@
     authorPublicKey: publicKey2,
     signature: signature3
   });
-  var resource = closed5({
+  var resource = closed6({
     id: { type: "string", pattern: "^r[0-9]{1,4}$" },
     type: { enum: ["html-segments", "shared-block", "asset"] },
     offset: integer2(LARGE_OBJECT_LIMITS.decodedBytes),
     encodedBytes: integer2(LARGE_OBJECT_LIMITS.decodedBytes, 1),
     decodedBytes: integer2(LARGE_OBJECT_LIMITS.decodedBytes, 1),
     codec,
-    sha256: digest6
+    sha256: digest7
   });
   var RESOURCE_CATALOG_SCHEMA = schema5("resource-catalog", {
     schemaVersion: { const: "1.0.0" },
@@ -5285,11 +5486,11 @@
       type: "array",
       minItems: 1,
       maxItems: LARGE_OBJECT_LIMITS.sources,
-      items: closed5({
+      items: closed6({
         id: { type: "string", minLength: 1, maxLength: 128 },
         resourceId: resource.properties.id,
         htmlBytes: integer2(LARGE_OBJECT_LIMITS.uniqueHtmlBytes, 1),
-        sha256: digest6
+        sha256: digest7
       })
     },
     viewSources: {
@@ -5298,7 +5499,7 @@
       additionalProperties: { type: "string", minLength: 1, maxLength: 128 }
     }
   });
-  RESOURCE_CATALOG_SCHEMA.properties.reviewOf = digest6;
+  RESOURCE_CATALOG_SCHEMA.properties.reviewOf = digest7;
   var companyId = { type: "string", pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$" };
   var companyScope = { organizationId: companyId, projectId: companyId, artifactId: companyId };
   var COMPANY_RESOURCE_MANIFEST_SCHEMA = schema5("company-resource-manifest", {
@@ -5315,10 +5516,10 @@
       type: "array",
       minItems: 1,
       maxItems: 128,
-      items: closed5({
+      items: closed6({
         index: integer2(127),
         byteLength: integer2(LARGE_OBJECT_LIMITS.chunkBytes, 1),
-        sha256: digest6
+        sha256: digest7
       })
     }
   });
@@ -5333,7 +5534,7 @@
     ...companyScope,
     operationId: id6,
     revisionId: id6,
-    manifestSha256: digest6,
+    manifestSha256: digest7,
     contentDigest: { type: "string", pattern: "^sha256:[a-f0-9]{64}$" },
     status: { const: "committed" },
     committedAt: iso2
@@ -5347,9 +5548,9 @@
       receivedChunks: {
         type: "array",
         maxItems: 128,
-        items: closed5({
+        items: closed6({
           index: integer2(127),
-          sha256: digest6,
+          sha256: digest7,
           byteLength: integer2(LARGE_OBJECT_LIMITS.chunkBytes, 1)
         })
       },
@@ -5373,7 +5574,7 @@
     protocolVersion: { const: "1.17.0" },
     contentDigest: { type: "string", pattern: "^sha256:[a-f0-9]{64}$" },
     byteLength: integer2(LARGE_OBJECT_LIMITS.decodedBytes, 1),
-    contentReference: closed5({ transport: { const: "resources-v2" }, manifestSha256: digest6 })
+    contentReference: closed6({ transport: { const: "resources-v2" }, manifestSha256: digest7 })
   });
   ENTERPRISE_ARTIFACT_REVISION_V11_SCHEMA.required.push("contentReference", "protocolVersion");
   var WORKSPACE_MANAGEMENT_V2_SCHEMA = schema5("workspace-management-v2", {
@@ -5387,7 +5588,7 @@
     operationId: id6,
     expectedVersion: integer2(Number.MAX_SAFE_INTEGER, 1),
     epoch: integer2(Number.MAX_SAFE_INTEGER, 2),
-    reviewerAuthHash: digest6,
+    reviewerAuthHash: digest7,
     keyring,
     signature: signature3
   });

package/lib/host-packages/cursor/openplanr/runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources/06-artifact-review-ui.js

@@ -20,7 +20,7 @@
         throw new TypeError("A review operation needs a stable identity.");
       return JSON.stringify([scopeKey, id7]);
     };
-    let closed6 = false, draining = null;
+    let closed7 = false, draining = null;
     const listeners = /* @__PURE__ */ new Set();
     const heartbeats = /* @__PURE__ */ new Set();
     const channel = typeof globalThis.BroadcastChannel === "function" ? new globalThis.BroadcastChannel(databaseName) : null;
@@ -56,14 +56,14 @@
       request.onsuccess = () => {
         const db = request.result;
         db.onversionchange = () => db.close();
-        if (closed6) db.close();
+        if (closed7) db.close();
         resolve(db);
       };
     });
     void database.catch(() => {
     });
     async function transaction(mode, work) {
-      if (closed6) throw new Error("Review custody has closed.");
+      if (closed7) throw new Error("Review custody has closed.");
       const db = await database;
       return new Promise((resolve, reject) => {
         const tx = db.transaction("operations", mode), store = tx.objectStore("operations");
@@ -278,7 +278,7 @@
         if (draining) return draining;
         const owner = globalThis.crypto.randomUUID();
         draining = (async () => {
-          while (!closed6) {
+          while (!closed7) {
             const entry = await claim(owner);
             if (!entry) return;
             const heartbeat = globalThis.setInterval(
@@ -334,7 +334,7 @@
         return () => listeners.delete(listener);
       },
       close() {
-        closed6 = true;
+        closed7 = true;
         for (const heartbeat of heartbeats) globalThis.clearInterval(heartbeat);
         heartbeats.clear();
         channel?.close();
@@ -605,14 +605,14 @@
     if (x >= 0 && y >= 0 && w >= 0 && h >= 0 && x + w <= 1 && y + h <= 1) {
       return { x, y, w, h };
     }
-    const unit = (value) => Math.round(Math.min(1, Math.max(0, value)) * 1e6) / 1e6;
-    const boundedX = unit(x);
-    const boundedY = unit(y);
+    const unit2 = (value) => Math.round(Math.min(1, Math.max(0, value)) * 1e6) / 1e6;
+    const boundedX = unit2(x);
+    const boundedY = unit2(y);
     return {
       x: boundedX,
       y: boundedY,
-      w: Math.round(Math.min(unit(w), 1 - boundedX) * 1e6) / 1e6,
-      h: Math.round(Math.min(unit(h), 1 - boundedY) * 1e6) / 1e6
+      w: Math.round(Math.min(unit2(w), 1 - boundedX) * 1e6) / 1e6,
+      h: Math.round(Math.min(unit2(h), 1 - boundedY) * 1e6) / 1e6
     };
   }
   function normalizeViewport(viewport) {
@@ -1700,8 +1700,8 @@
       snapshotDrafts,
       getReviewOf: () => controller.getReview()?.reviewOf ?? reviewOf,
       restoreDrafts(snapshot2) {
-        const digest7 = controller.getReview()?.reviewOf ?? reviewOf;
-        if (!snapshot2 || snapshot2.reviewOf !== digest7) return false;
+        const digest8 = controller.getReview()?.reviewOf ?? reviewOf;
+        if (!snapshot2 || snapshot2.reviewOf !== digest8) return false;
         if (typeof snapshot2.identity === "string") {
           const name = snapshot2.identity.slice(0, ARTIFACT_REVIEW_LIMITS.authorName);
           controller.setIdentity(name.trim() ? { ...controller.getIdentity(), name } : null);

package/lib/host-packages/cursor/openplanr/runtime/design/scripts/runtime/packages/artifact/templates/artifact-review-stage.js.sources/08-artifact-review-ui.js

@@ -1648,23 +1648,23 @@
     }
     return Object.freeze([state.activeArtifactId]);
   }
-  function assertRect2(rect) {
-    if (!rect || !Number.isFinite(rect.left) || !Number.isFinite(rect.top) || !Number.isFinite(rect.width) || !Number.isFinite(rect.height) || rect.width <= 0 || rect.height <= 0) {
+  function assertRect2(rect2) {
+    if (!rect2 || !Number.isFinite(rect2.left) || !Number.isFinite(rect2.top) || !Number.isFinite(rect2.width) || !Number.isFinite(rect2.height) || rect2.width <= 0 || rect2.height <= 0) {
       throw new RangeError("Artifact bounds must have positive finite dimensions.");
     }
   }
-  function clientPointToNormalized(rect, point2) {
-    assertRect2(rect);
+  function clientPointToNormalized(rect2, point3) {
+    assertRect2(rect2);
     return Object.freeze({
-      x: normalized2((finite2(point2?.x ?? point2?.clientX) - rect.left) / rect.width),
-      y: normalized2((finite2(point2?.y ?? point2?.clientY) - rect.top) / rect.height)
+      x: normalized2((finite2(point3?.x ?? point3?.clientX) - rect2.left) / rect2.width),
+      y: normalized2((finite2(point3?.y ?? point3?.clientY) - rect2.top) / rect2.height)
     });
   }
-  function normalizedPointToClient(rect, point2) {
-    assertRect2(rect);
+  function normalizedPointToClient(rect2, point3) {
+    assertRect2(rect2);
     return Object.freeze({
-      x: rect.left + normalized2(point2?.x) * rect.width,
-      y: rect.top + normalized2(point2?.y) * rect.height
+      x: rect2.left + normalized2(point3?.x) * rect2.width,
+      y: rect2.top + normalized2(point3?.y) * rect2.height
     });
   }
   function parseDataScript(document2, id7) {
@@ -1786,6 +1786,8 @@
     }
     const frameDiagnostics = /* @__PURE__ */ new Map();
     const frameLoads = /* @__PURE__ */ new Map();
+    const frameHolds = /* @__PURE__ */ new Map();
+    const frameHoldWaiters = /* @__PURE__ */ new Set();
     const frameSlots = /* @__PURE__ */ new Map();
     if (frameBudget !== null) {
       for (const [id7, frame] of frames) {
@@ -2184,12 +2186,14 @@
     function disposeStage() {
       if (disposed) return true;
       disposed = true;
+      wakeFrameDemand();
       for (const id7 of [...frameLoads.keys()]) releaseFrame(id7);
       for (const remove of cleanup.splice(0)) remove();
       return true;
     }
     const controller = Object.freeze({
       frameBudget,
+      holdFrames,
       ensureFrames,
       retryFrames,
       getFrameDiagnostics: () => [...frameDiagnostics.values()],
@@ -2311,6 +2315,7 @@
       const record2 = frameLoads.get(artifactId);
       if (!record2) return;
       frameLoads.delete(artifactId);
+      wakeFrameDemand();
       record2.cancelled = true;
       record2.abort.abort();
       record2.unlisten?.();
@@ -2482,6 +2487,29 @@
       })().catch(fail);
       return record2.promise;
     }
+    function wakeFrameDemand() {
+      for (const resolve of frameHoldWaiters) resolve();
+      frameHoldWaiters.clear();
+    }
+    function holdFrames(artifactIds) {
+      if (disposed) throw cancelledFrame();
+      if (!Array.isArray(artifactIds) || artifactIds.some((id7) => !frames.has(id7))) {
+        throw new TypeError("Requested artifact frames must be known artifact IDs.");
+      }
+      const ids2 = [...new Set(artifactIds)];
+      for (const id7 of ids2) frameHolds.set(id7, (frameHolds.get(id7) ?? 0) + 1);
+      let released = false;
+      return () => {
+        if (released) return;
+        released = true;
+        for (const id7 of ids2) {
+          const count2 = frameHolds.get(id7) ?? 0;
+          if (count2 > 1) frameHolds.set(id7, count2 - 1);
+          else frameHolds.delete(id7);
+        }
+        wakeFrameDemand();
+      };
+    }
     function ensureFrames(artifactIds, isCurrent = () => true) {
       if (disposed || !isCurrent()) return Promise.reject(cancelledFrame());
       if (!Array.isArray(artifactIds) || artifactIds.some((id7) => typeof id7 !== "string" || !frames.has(id7))) {
@@ -2493,7 +2521,7 @@
           new RangeError(`At most ${frameBudget} artifact frames may be requested together.`)
         );
       }
-      if (frameBudget === null)
+      if (frameBudget === null || requested.every((id7) => frameLoads.has(id7)))
         return Promise.all(requested.map((id7) => assignArtifactSource(stageArtifactById(state, id7))));
       const run = async () => {
         if (disposed || !isCurrent()) throw cancelledFrame();
@@ -2501,8 +2529,13 @@
           if (disposed || !isCurrent()) throw cancelledFrame();
           if (!frameLoads.has(id7)) {
             while (frameLoads.size >= frameBudget) {
-              const candidates = [...frameLoads].filter(([loadedId]) => !requested.includes(loadedId)).sort((a, b) => a[1].used - b[1].used);
-              if (!candidates.length) throw new Error("The artifact frame budget is exhausted.");
+              const candidates = [...frameLoads].filter(([loadedId]) => !requested.includes(loadedId) && !frameHolds.has(loadedId)).sort((a, b) => a[1].used - b[1].used);
+              if (!candidates.length) {
+                if (!frameHolds.size) throw new Error("The artifact frame budget is exhausted.");
+                await new Promise((resolve) => frameHoldWaiters.add(resolve));
+                if (disposed || !isCurrent()) throw cancelledFrame();
+                continue;
+              }
               releaseFrame(candidates[0][0]);
             }
           }
@@ -2527,7 +2560,7 @@
     }
     function cancelInactiveLoads(ids2) {
       for (const [id7, record2] of frameLoads) {
-        if (record2.status === "loading" && !ids2.includes(id7)) releaseFrame(id7);
+        if (record2.status === "loading" && !ids2.includes(id7) && !frameHolds.has(id7)) releaseFrame(id7);
       }
     }
     async function activateVisibleFrames() {