@snowcone-app/canvas 0.18.1 → 0.19.1

package/dist/testing/failureFixtures.d.ts

@@ -0,0 +1,25 @@
+import { RealtimeGrant } from '@snowcone-app/sdk';
+/**
+ * An origin that is deliberately on NO shop's asset-origin allowlist. The
+ * `.invalid` TLD is reserved (RFC 2606) — it can never resolve, and the
+ * allowlist check denies it before any fetch is attempted, so the failure is
+ * deterministic and free.
+ */
+export declare const TEST_403_ASSET_URL = "https://assets.test-403.invalid/denied.png";
+/**
+ * A design whose background asset the shop's allowlist is guaranteed to deny —
+ * the deterministic allowlist-denial (403) trigger.
+ */
+export declare function test403Design(): import('../design/design-builder.js').DesignBuilder<"headline", "art">;
+/**
+ * A design that gates `<Editor.Buy>` out of the box: its one personalization
+ * layer (`'name'`, seed `'YOUR NAME'`) is required and still equals its seed,
+ * so Buy renders `data-sc-buy-state="incomplete"` with
+ * `data-sc-buy-missing="layer-seed:name"` until a real value is typed.
+ */
+export declare function testIncompleteDesign(): import('../design/design-builder.js').DesignBuilder<"name", never>;
+/**
+ * A grant factory that always rejects — the deterministic "grant fetch
+ * failed" trigger. The rejection reason is stable for assertions.
+ */
+export declare function failingGrant(reason?: string): () => Promise<RealtimeGrant>;

package/dist/testing.mjs

@@ -1,53 +1,55 @@
-import { e as U, g as I, a as R } from "./editorErrors-DXNfVXtD.js";
-import { jsx as a } from "react/jsx-runtime";
-import { useState as d } from "react";
-import { E as s } from "./EditorContext-5QpqAhjh.js";
-import { T as m } from "./ThemeContext-Rjz25x9X.js";
-import { E as u, A as h, g, I as E } from "./FontAnalyzer-DIlqmyuf.js";
-const M = ({
+import { e as ie, g as oe, a as ae } from "./editorErrors-DXNfVXtD.js";
+import { fetchMockupImage as S, isSnowconeSdkError as b, RenderSession as _, mintRealtimeGrant as R } from "@snowcone-app/sdk";
+import { s as I, d as A } from "./design-builder-v4935TeS.js";
+import { E as y, g as m } from "./EditorContext-5QpqAhjh.js";
+import { jsx as u } from "react/jsx-runtime";
+import { useState as D } from "react";
+import { T as p } from "./ThemeContext-Rjz25x9X.js";
+import { E as T, A as k, g as F, I as x } from "./FontAnalyzer-DIlqmyuf.js";
+const G = ({
   children: t,
-  initialElements: e = [],
-  initialArtboards: n,
+  initialElements: n = [],
+  initialArtboards: e,
   initialSelection: r = null,
-  initialMultiSelection: o = [],
-  initialArtboardConfig: l = {}
+  initialMultiSelection: i = [],
+  initialArtboardConfig: o = {}
 }) => {
-  const [f] = d(() => {
-    const c = new u();
-    return n && n.length > 0 ? n.forEach((i) => {
-      c.createArtboard({
-        name: i.name,
-        width: i.width,
-        height: i.height,
-        backgroundColor: i.backgroundColor
+  const [l] = D(() => {
+    const a = new T();
+    return e && e.length > 0 ? e.forEach((c) => {
+      a.createArtboard({
+        name: c.name,
+        width: c.width,
+        height: c.height,
+        backgroundColor: c.backgroundColor
       });
-    }) : c.createArtboard({
+    }) : a.createArtboard({
       name: "Test Artboard",
       width: 1200,
       height: 1200,
       backgroundColor: "#FFFFFF",
-      ...l
-    }), c;
+      ...o
+    }), a;
   });
-  return /* @__PURE__ */ a(m, { children: /* @__PURE__ */ a(
-    s,
+  return /* @__PURE__ */ u(p, { children: /* @__PURE__ */ u(
+    y,
     {
-      initialArtboardConfig: l,
+      initialArtboardConfig: o,
       children: t
     }
   ) });
-}, S = ({
+}, J = ({
   children: t,
-  initialElements: e = [],
-  initialSelection: n = null,
+  initialElements: n = [],
+  initialSelection: e = null,
   initialMultiSelection: r = [],
-  initialArtboardConfig: o = {}
-}) => /* @__PURE__ */ a(m, { children: /* @__PURE__ */ a(s, { initialArtboardConfig: o, children: t }) });
-function p(t = "custom", e = {}) {
-  const n = g(t);
-  if (!n || !n.Component)
+  initialArtboardConfig: i = {}
+}) => /* @__PURE__ */ u(p, { children: /* @__PURE__ */ u(y, { initialArtboardConfig: i, children: t }) });
+function W(t = "custom", n = {}) {
+  const e = F(t);
+  if (!e || !e.Component)
     throw new Error(`Transform type "${t}" not found in registry`);
-  return new n.Component({
+  return new e.Component({
     transformType: t,
     text: "Test Text",
     fontSize: 32,
@@ -56,12 +58,12 @@ function p(t = "custom", e = {}) {
     x: 100,
     y: 100,
     rotation: 0,
-    ...e
+    ...n
     // eslint-disable-next-line @typescript-eslint/no-explicit-any -- test utility: overrides merge Partial<TextElement> properties with config, which are structurally compatible but not type-assignable
   });
 }
-function k(t = {}) {
-  return new E({
+function j(t = {}) {
+  return new x({
     imageUrl: "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==",
     imageAspectRatio: 1,
     x: 100,
@@ -70,8 +72,8 @@ function k(t = {}) {
     ...t
   });
 }
-function v(t = {}) {
-  return new h({
+function z(t = {}) {
+  return new k({
     name: "Test Artboard",
     width: 1200,
     height: 1200,
@@ -81,65 +83,174 @@ function v(t = {}) {
     ...t
   });
 }
-async function A(t, e = 5e3, n = 100) {
+async function U(t, n = 5e3, e = 100) {
   const r = Date.now();
   for (; !t(); ) {
-    if (Date.now() - r > e)
-      throw new Error(`Timeout waiting for condition after ${e}ms`);
-    await new Promise((o) => setTimeout(o, n));
+    if (Date.now() - r > n)
+      throw new Error(`Timeout waiting for condition after ${n}ms`);
+    await new Promise((i) => setTimeout(i, e));
   }
 }
-async function C(t, e = 5e3) {
-  let n = null;
-  return await A(() => !1, e), n;
+async function Q(t, n = 5e3) {
+  let e = null;
+  return await U(() => !1, n), e;
 }
-function T(t, e = {}) {
-  const n = new KeyboardEvent("keydown", {
+function V(t, n = {}) {
+  const e = new KeyboardEvent("keydown", {
     key: t,
-    ctrlKey: e.ctrl,
-    shiftKey: e.shift,
-    altKey: e.alt,
-    metaKey: e.meta,
+    ctrlKey: n.ctrl,
+    shiftKey: n.shift,
+    altKey: n.alt,
+    metaKey: n.meta,
     bubbles: !0,
     cancelable: !0
   });
-  document.dispatchEvent(n);
+  document.dispatchEvent(e);
 }
-function _(t = 800, e = 600) {
-  const n = document.createElement("canvas");
-  return n.width = t, n.height = e, n;
+function Y(t = 800, n = 600) {
+  const e = document.createElement("canvas");
+  return e.width = t, e.height = n, e;
 }
-function B(t, e) {
-  Object.entries(e).forEach(([n, r]) => {
-    if (t[n] !== r)
+function q(t, n) {
+  Object.entries(n).forEach(([e, r]) => {
+    if (t[e] !== r)
       throw new Error(
-        `Expected element.${n} to be ${r}, got ${t[n]}`
+        `Expected element.${e} to be ${r}, got ${t[e]}`
       );
   });
 }
-function K(t) {
-  const e = t.getBoundingBox();
+function H(t) {
+  const n = t.getBoundingBox();
+  return {
+    x: n.x,
+    y: n.y,
+    width: n.width,
+    height: n.height
+  };
+}
+function N(t) {
+  let n = !1;
+  const e = t.elements.map((r) => {
+    const i = r.name, o = r.text;
+    return !i || typeof o != "string" ? r : (n = !0, { ...r, text: `ASSERT_RENDERS_${i.toUpperCase()}` });
+  });
+  if (!n)
+    throw new m(
+      "E_NO_MUTABLE_BINDING",
+      'this design has no NAMED text layer to mutate for the two-render check. Name one (design().text("…", { name: "headline" })) or pass opts.mutate to define the mutation.',
+      { docSlug: "embed-mode" }
+    );
+  return { ...t, elements: e };
+}
+function M(t, n) {
+  if (t.byteLength !== n.byteLength) return !1;
+  for (let e = 0; e < t.byteLength; e++)
+    if (t[e] !== n[e]) return !1;
+  return !0;
+}
+async function E(t, n, e, r, i) {
+  const o = t();
+  try {
+    return await new Promise((l, a) => {
+      const c = setTimeout(() => {
+        a(
+          new m("E_RENDER_FAILED", `the ${i} render produced no mockup within ${r}ms.`, {
+            phase: i,
+            timeoutMs: r
+          })
+        );
+      }, r);
+      o.onMockups((s) => {
+        const d = s.find((h) => h.imageUrl);
+        d && (clearTimeout(c), l(d));
+      }), o.onError((s) => {
+        clearTimeout(c), a(new m("E_RENDER_FAILED", `the ${i} render failed: ${s}`, { phase: i, error: s }));
+      }), o.renderState(n, I(e)).catch((s) => {
+        clearTimeout(c);
+        const d = s instanceof Error ? s.message : String(s);
+        a(new m("E_RENDER_FAILED", `the ${i} render failed to dispatch: ${d}`, { phase: i, error: d }));
+      });
+    });
+  } finally {
+    o.close();
+  }
+}
+async function w(t, n, e) {
+  try {
+    const r = await S(t, {
+      ...e.fetchImpl ? { fetchImpl: e.fetchImpl } : {}
+    });
+    return { bytes: r.bytes, kind: r.kind };
+  } catch (r) {
+    throw b(r) ? r.code === "ASSET_FORBIDDEN" ? new m(
+      "E_ASSET_FORBIDDEN",
+      `the shop's asset-origin allowlist denied an asset in this design (${n} render). Allow the asset's origin on the shop (or host it on the shop's storage origin).`,
+      { phase: n, url: t, failedAssets: r.data.failedAssets, docSlug: "embed-mode" }
+    ) : r.code === "SHOP_NOT_PROPAGATED" ? r : new m("E_RENDER_FAILED", `the ${n} render's image fetch failed: ${r.message}`, {
+      phase: n,
+      url: t,
+      ...r.data
+    }) : r;
+  }
+}
+async function X(t, n, e) {
+  const r = e.timeoutMs ?? 3e4, i = t.toJSON(), o = i.activeArtboard, l = (e.mutate ?? N)(i), a = e.grant, c = typeof a == "function" ? a : a ? () => Promise.resolve(a) : () => R({
+    shop: e.shop,
+    ...e.apiKey ? { apiKey: e.apiKey } : {},
+    ...e.grantBase ? { base: e.grantBase } : {},
+    ...e.fetchImpl ? { fetch: e.fetchImpl } : {}
+  }), s = () => new _({
+    shop: e.shop,
+    product: n,
+    ...e.wsUrl ? { wsUrl: e.wsUrl } : {},
+    getToken: c
+  }), d = await E(s, o, i, r, "seed"), h = await w(d.imageUrl, "seed", e), g = await E(s, o, l, r, "mutated"), f = await w(g.imageUrl, "mutated", e);
+  if (M(h.bytes, f.bytes))
+    throw new m(
+      "E_BINDING_INERT",
+      "the mutated render is byte-identical to the seed render — the mutation never reached the server, so the binding under test is DEAD. Usual causes: the mutated layer name doesn't exist in the design (check design.layer() names), or opts.mutate returned the seed unchanged.",
+      {
+        seedUrl: d.imageUrl,
+        mutatedUrl: g.imageUrl,
+        bytes: h.bytes.byteLength,
+        docSlug: "embed-mode"
+      }
+    );
   return {
-    x: e.x,
-    y: e.y,
-    width: e.width,
-    height: e.height
+    seed: { url: d.imageUrl, bytes: h.bytes.byteLength, kind: h.kind },
+    mutated: { url: g.imageUrl, bytes: f.bytes.byteLength, kind: f.kind }
   };
 }
+const v = "https://assets.test-403.invalid/denied.png";
+function Z() {
+  return A({ name: "Front", width: 1e3, height: 1e3 }).background(v, { aspectRatio: 1, name: "art" }).text("ALLOWLIST DENIAL FIXTURE", { anchor: "top", name: "headline" });
+}
+function ee() {
+  return A({ name: "Front", width: 1e3, height: 1e3 }).text("YOUR NAME", { anchor: "center", name: "name" });
+}
+function te(t = "failing-grant fixture: grant endpoint unavailable") {
+  return () => Promise.reject(new Error(t));
+}
 export {
-  M as MockEditorProvider,
-  S as MockEditorProviderWithState,
-  B as assertElementProperties,
-  v as createMockArtboard,
-  _ as createMockCanvas,
-  p as createMockElement,
-  k as createMockImageElement,
-  U as expectNoEditorErrors,
-  I as getContainedEditorErrors,
-  K as getElementBounds,
-  R as resetContainedEditorErrors,
-  T as simulateKeyPress,
-  A as waitFor,
-  C as waitForExport
+  G as MockEditorProvider,
+  J as MockEditorProviderWithState,
+  v as TEST_403_ASSET_URL,
+  q as assertElementProperties,
+  X as assertRenders,
+  z as createMockArtboard,
+  Y as createMockCanvas,
+  W as createMockElement,
+  j as createMockImageElement,
+  ie as expectNoEditorErrors,
+  te as failingGrant,
+  oe as getContainedEditorErrors,
+  H as getElementBounds,
+  N as mutateNamedTextLayers,
+  ae as resetContainedEditorErrors,
+  V as simulateKeyPress,
+  Z as test403Design,
+  ee as testIncompleteDesign,
+  U as waitFor,
+  Q as waitForExport
 };
 //# sourceMappingURL=testing.mjs.map

package/dist/testing.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"testing.mjs","sources":["../src/testing/MockEditorProvider.tsx","../src/testing/utils.ts"],"sourcesContent":["/**\n * MockEditorProvider - Lightweight mock for testing custom components\n * Compatible with Vitest (does not require Jest)\n *\n * @example\n * ```tsx\n * import { render } from '@testing-library/react';\n * import { MockEditorProvider } from '@snowcone-app/canvas/embed';\n *\n * test('my component renders', () => {\n *   render(\n *     <MockEditorProvider>\n *       <MyCustomComponent />\n *     </MockEditorProvider>\n *   );\n * });\n * ```\n */\n\nimport React, { useState, ReactNode } from 'react';\nimport { EditorProvider } from '../contexts/EditorContext.js';\nimport { ThemeProvider } from '../contexts/ThemeContext.js';\nimport { ArtboardManager } from '../core/ArtboardManager.js';\nimport { ArtboardElement } from '../core/ArtboardElement.js';\nimport type { TextElement } from '../core/TextElement.js';\nimport type { ImageElement } from '../core/ImageElement.js';\nimport type { GroupElement } from '../core/GroupElement.js';\nimport type { ShapeElement } from '../core/ShapeElement.js';\n\nexport type MockEditorElement = TextElement | ImageElement | GroupElement | ShapeElement;\n\nexport interface MockEditorProviderProps {\n  children: ReactNode;\n\n  /**\n   * Initial elements to populate the editor\n   */\n  initialElements?: MockEditorElement[];\n\n  /**\n   * Initial artboards (default: one artboard)\n   */\n  initialArtboards?: ArtboardElement[];\n\n  /**\n   * Initial selection\n   */\n  initialSelection?: string | null;\n\n  /**\n   * Initial multi-selection\n   */\n  initialMultiSelection?: string[];\n\n  /**\n   * Initial artboard configuration\n   */\n  initialArtboardConfig?: {\n    name?: string;\n    width?: number;\n    height?: number;\n    backgroundColor?: string;\n  };\n}\n\n/**\n * MockEditorProvider - Wraps EditorProvider with test-friendly defaults\n *\n * This is a lightweight wrapper that provides the same EditorContext\n * as the real app, making it perfect for testing custom components.\n */\nexport const MockEditorProvider: React.FC<MockEditorProviderProps> = ({\n  children,\n  initialElements: _initialElements = [],\n  initialArtboards,\n  initialSelection: _initialSelection = null,\n  initialMultiSelection: _initialMultiSelection = [],\n  initialArtboardConfig = {},\n}) => {\n  // Create artboard manager if artboards provided\n  const [_artboardManager] = useState(() => {\n    const manager = new ArtboardManager();\n\n    if (initialArtboards && initialArtboards.length > 0) {\n      // Use provided artboards\n      initialArtboards.forEach(artboard => {\n        manager.createArtboard({\n          name: artboard.name,\n          width: artboard.width,\n          height: artboard.height,\n          backgroundColor: artboard.backgroundColor,\n        });\n      });\n    } else {\n      // Create default artboard\n      manager.createArtboard({\n        name: 'Test Artboard',\n        width: 1200,\n        height: 1200,\n        backgroundColor: '#FFFFFF',\n        ...initialArtboardConfig,\n      });\n    }\n\n    return manager;\n  });\n\n  // Simple wrapper that passes children through to real EditorProvider\n  // The EditorProvider will handle all the state management\n  // ThemeProvider is required because CanvasEditor uses useTheme()\n  return (\n    <ThemeProvider>\n      <EditorProvider\n        initialArtboardConfig={initialArtboardConfig}\n      >\n        {children}\n      </EditorProvider>\n    </ThemeProvider>\n  );\n};\n\n/**\n * MockEditorProviderWithState - For tests that need to control state directly\n *\n * Use this when you need fine-grained control over the editor state.\n * Most tests should use the simpler MockEditorProvider above.\n */\nexport const MockEditorProviderWithState: React.FC<MockEditorProviderProps> = ({\n  children,\n  initialElements: _initialElements = [],\n  initialSelection: _initialSelection = null,\n  initialMultiSelection: _initialMultiSelection = [],\n  initialArtboardConfig = {},\n}) => {\n  return (\n    <ThemeProvider>\n      <EditorProvider initialArtboardConfig={initialArtboardConfig}>\n        {children}\n      </EditorProvider>\n    </ThemeProvider>\n  );\n};\n","/**\n * Testing Utilities - Helpers for creating mock elements and artboards\n * Compatible with Vitest\n */\n\nimport { TextElement } from '../core/TextElement.js';\nimport { ImageElement } from '../core/ImageElement.js';\nimport { ArtboardElement } from '../core/ArtboardElement.js';\nimport { getTransformById } from '../transforms/registry.js';\nimport type { TransformType, ImageElementConfig } from '../types/index.js';\n\n/**\n * Create a mock text element with sensible defaults\n *\n * @example\n * ```tsx\n * const element = createMockElement('custom', {\n *   text: 'Hello World',\n *   fontSize: 48,\n *   fontColor: '#FF0000'\n * });\n * ```\n */\nexport function createMockElement(\n  transformType: TransformType = 'custom',\n  overrides: Partial<TextElement> = {}\n): TextElement {\n  // Get the correct concrete class from registry\n  const transformDef = getTransformById(transformType);\n  if (!transformDef || !transformDef.Component) {\n    throw new Error(`Transform type \"${transformType}\" not found in registry`);\n  }\n\n  // Create element using the concrete class\n  const element = new transformDef.Component({\n    transformType,\n    text: 'Test Text',\n    fontSize: 32,\n    color: '#000000',\n    fontFamily: 'Arial',\n    x: 100,\n    y: 100,\n    rotation: 0,\n    ...overrides,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- test utility: overrides merge Partial<TextElement> properties with config, which are structurally compatible but not type-assignable\n  } as any);\n\n  return element as TextElement;\n}\n\n/**\n * Create a mock image element\n *\n * @example\n * ```tsx\n * const image = createMockImageElement({\n *   imageUrl: 'data:image/png;base64,...',\n *   width: 200,\n *   height: 200\n * });\n * ```\n */\nexport function createMockImageElement(\n  overrides: Partial<ImageElementConfig> = {}\n): ImageElement {\n  const element = new ImageElement({\n    imageUrl: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',\n    imageAspectRatio: 1,\n    x: 100,\n    y: 100,\n    rotation: 0,\n    ...overrides,\n  });\n\n  return element;\n}\n\n/**\n * Create a mock artboard\n *\n * @example\n * ```tsx\n * const artboard = createMockArtboard({\n *   name: 'Front',\n *   width: 1200,\n *   height: 1200,\n *   backgroundColor: '#FFFFFF'\n * });\n * ```\n */\nexport function createMockArtboard(\n  overrides: Partial<{\n    name: string;\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n    backgroundColor: string;\n  }> = {}\n): ArtboardElement {\n  const artboard = new ArtboardElement({\n    name: 'Test Artboard',\n    width: 1200,\n    height: 1200,\n    x: 0,\n    y: 0,\n    backgroundColor: '#FFFFFF',\n    ...overrides,\n  });\n\n  return artboard;\n}\n\n/**\n * Wait for a condition to become true\n * Useful for async testing\n *\n * @example\n * ```tsx\n * await waitFor(() => screen.getByText('Loaded'), 5000);\n * ```\n */\nexport async function waitFor(\n  condition: () => boolean,\n  timeout = 5000,\n  interval = 100\n): Promise<void> {\n  const startTime = Date.now();\n\n  while (!condition()) {\n    if (Date.now() - startTime > timeout) {\n      throw new Error(`Timeout waiting for condition after ${timeout}ms`);\n    }\n    await new Promise(resolve => setTimeout(resolve, interval));\n  }\n}\n\n/**\n * Wait for an export to complete\n * Polls until dataUrl is available\n *\n * @example\n * ```tsx\n * const dataUrl = await waitForExport('artboard-1', 5000);\n * expect(dataUrl).toContain('data:image/png');\n * ```\n */\nexport async function waitForExport(\n  _artboardId: string,\n  timeout = 5000\n): Promise<string | null> {\n  let dataUrl: string | null = null;\n\n  await waitFor(() => {\n    // Check if export completed (this would need to be implemented based on your export state)\n    // For now, just return false as a placeholder\n    return false;\n  }, timeout);\n\n  return dataUrl;\n}\n\n/**\n * Simulate a keyboard event\n * Useful for testing keyboard shortcuts\n *\n * @example\n * ```tsx\n * simulateKeyPress('c', { meta: true }); // Cmd+C\n * ```\n */\nexport function simulateKeyPress(\n  key: string,\n  options: {\n    ctrl?: boolean;\n    shift?: boolean;\n    alt?: boolean;\n    meta?: boolean;\n  } = {}\n): void {\n  const event = new KeyboardEvent('keydown', {\n    key,\n    ctrlKey: options.ctrl,\n    shiftKey: options.shift,\n    altKey: options.alt,\n    metaKey: options.meta,\n    bubbles: true,\n    cancelable: true,\n  });\n\n  document.dispatchEvent(event);\n}\n\n/**\n * Create a mock canvas element for testing\n * Returns an HTMLCanvasElement with mocked context\n *\n * @example\n * ```tsx\n * const canvas = createMockCanvas(800, 600);\n * const ctx = canvas.getContext('2d');\n * ```\n */\nexport function createMockCanvas(\n  width = 800,\n  height = 600\n): HTMLCanvasElement {\n  const canvas = document.createElement('canvas');\n  canvas.width = width;\n  canvas.height = height;\n\n  return canvas;\n}\n\n/**\n * Assert that an element has certain properties\n * Useful for programmatic assertions\n *\n * @example\n * ```tsx\n * assertElementProperties(element, {\n *   text: 'Hello',\n *   fontSize: 48,\n *   fontColor: '#FF0000'\n * });\n * ```\n */\nexport function assertElementProperties(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Test utility: accepts any element type and checks arbitrary properties\n  element: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Test utility: expected values can be any type\n  expected: Record<string, any>\n): void {\n  Object.entries(expected).forEach(([key, value]) => {\n    if (element[key] !== value) {\n      throw new Error(\n        `Expected element.${key} to be ${value}, got ${element[key]}`\n      );\n    }\n  });\n}\n\n/**\n * Get element bounding box for testing\n * Returns computed bounds from the element\n *\n * @example\n * ```tsx\n * const bounds = getElementBounds(element);\n * expect(bounds.width).toBeGreaterThan(0);\n * ```\n */\nexport function getElementBounds(element: TextElement | ImageElement): {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n} {\n  const bbox = element.getBoundingBox();\n\n  return {\n    x: bbox.x,\n    y: bbox.y,\n    width: bbox.width,\n    height: bbox.height,\n  };\n}\n"],"names":["MockEditorProvider","children","_initialElements","initialArtboards","_initialSelection","_initialMultiSelection","initialArtboardConfig","_artboardManager","useState","manager","ArtboardManager","artboard","ThemeProvider","jsx","EditorProvider","MockEditorProviderWithState","createMockElement","transformType","overrides","transformDef","getTransformById","createMockImageElement","ImageElement","createMockArtboard","ArtboardElement","waitFor","condition","timeout","interval","startTime","resolve","waitForExport","_artboardId","dataUrl","simulateKeyPress","key","options","event","createMockCanvas","width","height","canvas","assertElementProperties","element","expected","value","getElementBounds","bbox"],"mappings":"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"}
+{"version":3,"file":"testing.mjs","sources":["../src/testing/MockEditorProvider.tsx","../src/testing/utils.ts","../src/testing/assertRenders.ts","../src/testing/failureFixtures.ts"],"sourcesContent":["/**\n * MockEditorProvider - Lightweight mock for testing custom components\n * Compatible with Vitest (does not require Jest)\n *\n * @example\n * ```tsx\n * import { render } from '@testing-library/react';\n * import { MockEditorProvider } from '@snowcone-app/canvas/embed';\n *\n * test('my component renders', () => {\n *   render(\n *     <MockEditorProvider>\n *       <MyCustomComponent />\n *     </MockEditorProvider>\n *   );\n * });\n * ```\n */\n\nimport React, { useState, ReactNode } from 'react';\nimport { EditorProvider } from '../contexts/EditorContext.js';\nimport { ThemeProvider } from '../contexts/ThemeContext.js';\nimport { ArtboardManager } from '../core/ArtboardManager.js';\nimport { ArtboardElement } from '../core/ArtboardElement.js';\nimport type { TextElement } from '../core/TextElement.js';\nimport type { ImageElement } from '../core/ImageElement.js';\nimport type { GroupElement } from '../core/GroupElement.js';\nimport type { ShapeElement } from '../core/ShapeElement.js';\n\nexport type MockEditorElement = TextElement | ImageElement | GroupElement | ShapeElement;\n\nexport interface MockEditorProviderProps {\n  children: ReactNode;\n\n  /**\n   * Initial elements to populate the editor\n   */\n  initialElements?: MockEditorElement[];\n\n  /**\n   * Initial artboards (default: one artboard)\n   */\n  initialArtboards?: ArtboardElement[];\n\n  /**\n   * Initial selection\n   */\n  initialSelection?: string | null;\n\n  /**\n   * Initial multi-selection\n   */\n  initialMultiSelection?: string[];\n\n  /**\n   * Initial artboard configuration\n   */\n  initialArtboardConfig?: {\n    name?: string;\n    width?: number;\n    height?: number;\n    backgroundColor?: string;\n  };\n}\n\n/**\n * MockEditorProvider - Wraps EditorProvider with test-friendly defaults\n *\n * This is a lightweight wrapper that provides the same EditorContext\n * as the real app, making it perfect for testing custom components.\n */\nexport const MockEditorProvider: React.FC<MockEditorProviderProps> = ({\n  children,\n  initialElements: _initialElements = [],\n  initialArtboards,\n  initialSelection: _initialSelection = null,\n  initialMultiSelection: _initialMultiSelection = [],\n  initialArtboardConfig = {},\n}) => {\n  // Create artboard manager if artboards provided\n  const [_artboardManager] = useState(() => {\n    const manager = new ArtboardManager();\n\n    if (initialArtboards && initialArtboards.length > 0) {\n      // Use provided artboards\n      initialArtboards.forEach(artboard => {\n        manager.createArtboard({\n          name: artboard.name,\n          width: artboard.width,\n          height: artboard.height,\n          backgroundColor: artboard.backgroundColor,\n        });\n      });\n    } else {\n      // Create default artboard\n      manager.createArtboard({\n        name: 'Test Artboard',\n        width: 1200,\n        height: 1200,\n        backgroundColor: '#FFFFFF',\n        ...initialArtboardConfig,\n      });\n    }\n\n    return manager;\n  });\n\n  // Simple wrapper that passes children through to real EditorProvider\n  // The EditorProvider will handle all the state management\n  // ThemeProvider is required because CanvasEditor uses useTheme()\n  return (\n    <ThemeProvider>\n      <EditorProvider\n        initialArtboardConfig={initialArtboardConfig}\n      >\n        {children}\n      </EditorProvider>\n    </ThemeProvider>\n  );\n};\n\n/**\n * MockEditorProviderWithState - For tests that need to control state directly\n *\n * Use this when you need fine-grained control over the editor state.\n * Most tests should use the simpler MockEditorProvider above.\n */\nexport const MockEditorProviderWithState: React.FC<MockEditorProviderProps> = ({\n  children,\n  initialElements: _initialElements = [],\n  initialSelection: _initialSelection = null,\n  initialMultiSelection: _initialMultiSelection = [],\n  initialArtboardConfig = {},\n}) => {\n  return (\n    <ThemeProvider>\n      <EditorProvider initialArtboardConfig={initialArtboardConfig}>\n        {children}\n      </EditorProvider>\n    </ThemeProvider>\n  );\n};\n","/**\n * Testing Utilities - Helpers for creating mock elements and artboards\n * Compatible with Vitest\n */\n\nimport { TextElement } from '../core/TextElement.js';\nimport { ImageElement } from '../core/ImageElement.js';\nimport { ArtboardElement } from '../core/ArtboardElement.js';\nimport { getTransformById } from '../transforms/registry.js';\nimport type { TransformType, ImageElementConfig } from '../types/index.js';\n\n/**\n * Create a mock text element with sensible defaults\n *\n * @example\n * ```tsx\n * const element = createMockElement('custom', {\n *   text: 'Hello World',\n *   fontSize: 48,\n *   fontColor: '#FF0000'\n * });\n * ```\n */\nexport function createMockElement(\n  transformType: TransformType = 'custom',\n  overrides: Partial<TextElement> = {}\n): TextElement {\n  // Get the correct concrete class from registry\n  const transformDef = getTransformById(transformType);\n  if (!transformDef || !transformDef.Component) {\n    throw new Error(`Transform type \"${transformType}\" not found in registry`);\n  }\n\n  // Create element using the concrete class\n  const element = new transformDef.Component({\n    transformType,\n    text: 'Test Text',\n    fontSize: 32,\n    color: '#000000',\n    fontFamily: 'Arial',\n    x: 100,\n    y: 100,\n    rotation: 0,\n    ...overrides,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- test utility: overrides merge Partial<TextElement> properties with config, which are structurally compatible but not type-assignable\n  } as any);\n\n  return element as TextElement;\n}\n\n/**\n * Create a mock image element\n *\n * @example\n * ```tsx\n * const image = createMockImageElement({\n *   imageUrl: 'data:image/png;base64,...',\n *   width: 200,\n *   height: 200\n * });\n * ```\n */\nexport function createMockImageElement(\n  overrides: Partial<ImageElementConfig> = {}\n): ImageElement {\n  const element = new ImageElement({\n    imageUrl: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==',\n    imageAspectRatio: 1,\n    x: 100,\n    y: 100,\n    rotation: 0,\n    ...overrides,\n  });\n\n  return element;\n}\n\n/**\n * Create a mock artboard\n *\n * @example\n * ```tsx\n * const artboard = createMockArtboard({\n *   name: 'Front',\n *   width: 1200,\n *   height: 1200,\n *   backgroundColor: '#FFFFFF'\n * });\n * ```\n */\nexport function createMockArtboard(\n  overrides: Partial<{\n    name: string;\n    width: number;\n    height: number;\n    x: number;\n    y: number;\n    backgroundColor: string;\n  }> = {}\n): ArtboardElement {\n  const artboard = new ArtboardElement({\n    name: 'Test Artboard',\n    width: 1200,\n    height: 1200,\n    x: 0,\n    y: 0,\n    backgroundColor: '#FFFFFF',\n    ...overrides,\n  });\n\n  return artboard;\n}\n\n/**\n * Wait for a condition to become true\n * Useful for async testing\n *\n * @example\n * ```tsx\n * await waitFor(() => screen.getByText('Loaded'), 5000);\n * ```\n */\nexport async function waitFor(\n  condition: () => boolean,\n  timeout = 5000,\n  interval = 100\n): Promise<void> {\n  const startTime = Date.now();\n\n  while (!condition()) {\n    if (Date.now() - startTime > timeout) {\n      throw new Error(`Timeout waiting for condition after ${timeout}ms`);\n    }\n    await new Promise(resolve => setTimeout(resolve, interval));\n  }\n}\n\n/**\n * Wait for an export to complete\n * Polls until dataUrl is available\n *\n * @example\n * ```tsx\n * const dataUrl = await waitForExport('artboard-1', 5000);\n * expect(dataUrl).toContain('data:image/png');\n * ```\n */\nexport async function waitForExport(\n  _artboardId: string,\n  timeout = 5000\n): Promise<string | null> {\n  let dataUrl: string | null = null;\n\n  await waitFor(() => {\n    // Check if export completed (this would need to be implemented based on your export state)\n    // For now, just return false as a placeholder\n    return false;\n  }, timeout);\n\n  return dataUrl;\n}\n\n/**\n * Simulate a keyboard event\n * Useful for testing keyboard shortcuts\n *\n * @example\n * ```tsx\n * simulateKeyPress('c', { meta: true }); // Cmd+C\n * ```\n */\nexport function simulateKeyPress(\n  key: string,\n  options: {\n    ctrl?: boolean;\n    shift?: boolean;\n    alt?: boolean;\n    meta?: boolean;\n  } = {}\n): void {\n  const event = new KeyboardEvent('keydown', {\n    key,\n    ctrlKey: options.ctrl,\n    shiftKey: options.shift,\n    altKey: options.alt,\n    metaKey: options.meta,\n    bubbles: true,\n    cancelable: true,\n  });\n\n  document.dispatchEvent(event);\n}\n\n/**\n * Create a mock canvas element for testing\n * Returns an HTMLCanvasElement with mocked context\n *\n * @example\n * ```tsx\n * const canvas = createMockCanvas(800, 600);\n * const ctx = canvas.getContext('2d');\n * ```\n */\nexport function createMockCanvas(\n  width = 800,\n  height = 600\n): HTMLCanvasElement {\n  const canvas = document.createElement('canvas');\n  canvas.width = width;\n  canvas.height = height;\n\n  return canvas;\n}\n\n/**\n * Assert that an element has certain properties\n * Useful for programmatic assertions\n *\n * @example\n * ```tsx\n * assertElementProperties(element, {\n *   text: 'Hello',\n *   fontSize: 48,\n *   fontColor: '#FF0000'\n * });\n * ```\n */\nexport function assertElementProperties(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Test utility: accepts any element type and checks arbitrary properties\n  element: any,\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Test utility: expected values can be any type\n  expected: Record<string, any>\n): void {\n  Object.entries(expected).forEach(([key, value]) => {\n    if (element[key] !== value) {\n      throw new Error(\n        `Expected element.${key} to be ${value}, got ${element[key]}`\n      );\n    }\n  });\n}\n\n/**\n * Get element bounding box for testing\n * Returns computed bounds from the element\n *\n * @example\n * ```tsx\n * const bounds = getElementBounds(element);\n * expect(bounds.width).toBeGreaterThan(0);\n * ```\n */\nexport function getElementBounds(element: TextElement | ImageElement): {\n  x: number;\n  y: number;\n  width: number;\n  height: number;\n} {\n  const bbox = element.getBoundingBox();\n\n  return {\n    x: bbox.x,\n    y: bbox.y,\n    width: bbox.width,\n    height: bbox.height,\n  };\n}\n","/**\n * `assertRenders(design, product, opts)` — the TWO-RENDER live contract check\n * (agent-DX decision F4, ADR-0085 plan).\n *\n * WHY TWO RENDERS: \"the URL returns an image\" can't catch a DEAD BINDING — a\n * wrong layer name still renders the seed beautifully. So this renders the\n * design twice: once as seeded, once with the personalization bindings\n * mutated, and asserts the encoded image BYTES differ (mockup delivery is\n * deterministic per state, so byte-identical means pixel-identical means the\n * mutation never reached the render).\n *\n * What it proves, in order:\n *  1. the seed design renders: HTTP 200 + real raster bytes (non-blank);\n *  2. the mutated design renders the same way;\n *  3. the two renders DIFFER — the binding is alive.\n *\n * Failures are the structured error contract (E3), never prose-only:\n *  - `E_ASSET_FORBIDDEN` — the shop's asset-origin allowlist denied a design\n *    asset (translated from the server's 403; `data.failedAssets` names it);\n *  - `E_RENDER_FAILED` — render error / timeout / non-image response;\n *  - `E_BINDING_INERT` — both renders byte-identical (dead binding);\n *  - `E_NO_MUTABLE_BINDING` — nothing to mutate and no `mutate` given.\n *  - The SDK's `SHOP_NOT_PROPAGATED` passes through: a freshly minted shop\n *    that never becomes visible is an environment fault, named as such.\n *\n * This talks to the REAL realtime render path (network). Use it in nightly /\n * acceptance jobs and agent verify loops — per-PR unit tests should mock the\n * SDK transport instead (plan: per-PR replay, nightly network-real).\n */\n\nimport {\n  RenderSession,\n  fetchMockupImage,\n  mintRealtimeGrant,\n  type MockupResult,\n  type RealtimeGrant,\n  type RenderProduct,\n} from '@snowcone-app/sdk';\nimport { isSnowconeSdkError } from '@snowcone-app/sdk';\nimport { serializeStateForServer } from '../rendering/serialize-for-server.js';\nimport { EditorError } from '../errors/editorError.js';\nimport type { DesignState } from '../components/editor/designStateStore.js';\n\n/** Anything `design()` produces (or a compatible shape). */\nexport interface RenderableDesign {\n  toJSON(): DesignState;\n}\n\nexport interface AssertRendersOptions {\n  /** Publishable shop id (= shop.id). */\n  shop: string;\n  /** Secret API key (sk_) for the grant; omit for the keyless publishable\n   *  path (sandbox/trial shops — the F1 bootstrap default). */\n  apiKey?: string;\n  /** Pre-fetched grant or grant factory — overrides the mint entirely. */\n  grant?: RealtimeGrant | (() => Promise<RealtimeGrant>);\n  /** Backend base for the keyless/sk grant mint (defaults to prod). */\n  grantBase?: string;\n  /** Override the realtime WS endpoint. */\n  wsUrl?: string;\n  /**\n   * Produce the mutated state for the second render. Default: rewrite the\n   * text of EVERY named text layer to a sentinel (`ASSERT_RENDERS_<name>`).\n   * Throws `E_NO_MUTABLE_BINDING` if the design has no named text layer and\n   * no override is given.\n   */\n  mutate?: (seed: DesignState) => DesignState;\n  /** Per-render timeout (ms). Default 30_000. */\n  timeoutMs?: number;\n  /** Override fetch for the image downloads (tests). */\n  fetchImpl?: typeof fetch;\n}\n\nexport interface AssertRendersResult {\n  /** The seed render's mockup URL + encoded size. */\n  seed: { url: string; bytes: number; kind: string };\n  /** The mutated render's mockup URL + encoded size. */\n  mutated: { url: string; bytes: number; kind: string };\n}\n\n/** Default mutation: every NAMED text layer gets a sentinel value. */\nexport function mutateNamedTextLayers(seed: DesignState): DesignState {\n  let mutatedAny = false;\n  const elements = seed.elements.map((el) => {\n    const name = (el as { name?: string }).name;\n    const text = (el as { text?: string }).text;\n    if (!name || typeof text !== 'string') return el;\n    mutatedAny = true;\n    return { ...el, text: `ASSERT_RENDERS_${name.toUpperCase()}` } as typeof el;\n  });\n  if (!mutatedAny) {\n    throw new EditorError(\n      'E_NO_MUTABLE_BINDING',\n      'this design has no NAMED text layer to mutate for the two-render check. Name one ' +\n        '(design().text(\"…\", { name: \"headline\" })) or pass opts.mutate to define the mutation.',\n      { docSlug: 'embed-mode' },\n    );\n  }\n  return { ...seed, elements };\n}\n\nfunction bytesEqual(a: Uint8Array, b: Uint8Array): boolean {\n  if (a.byteLength !== b.byteLength) return false;\n  for (let i = 0; i < a.byteLength; i++) {\n    if (a[i] !== b[i]) return false;\n  }\n  return true;\n}\n\n/**\n * Render one state on a FRESH session and resolve the first mockup result.\n * One session per render on purpose: a session keeps emitting trailing mockup\n * results (multi-mockup products emit per scene), so reusing it for the\n * second render could resolve the mutated phase with a stale seed emission —\n * and with content-addressed delivery a dead binding makes the two\n * indistinguishable by URL. A fresh session has no history to confuse.\n */\nasync function renderOnce(\n  makeSession: () => RenderSession,\n  placement: string,\n  state: DesignState,\n  timeoutMs: number,\n  label: 'seed' | 'mutated',\n): Promise<MockupResult> {\n  const session = makeSession();\n  try {\n    return await new Promise<MockupResult>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(\n          new EditorError('E_RENDER_FAILED', `the ${label} render produced no mockup within ${timeoutMs}ms.`, {\n            phase: label,\n            timeoutMs,\n          }),\n        );\n      }, timeoutMs);\n      session.onMockups((results) => {\n        const withImage = results.find((r) => r.imageUrl);\n        if (!withImage) return;\n        clearTimeout(timer);\n        resolve(withImage);\n      });\n      session.onError((message) => {\n        clearTimeout(timer);\n        reject(new EditorError('E_RENDER_FAILED', `the ${label} render failed: ${message}`, { phase: label, error: message }));\n      });\n      void session.renderState(placement, serializeStateForServer(state)).catch((err) => {\n        clearTimeout(timer);\n        const message = err instanceof Error ? err.message : String(err);\n        reject(new EditorError('E_RENDER_FAILED', `the ${label} render failed to dispatch: ${message}`, { phase: label, error: message }));\n      });\n    });\n  } finally {\n    session.close();\n  }\n}\n\n/** Fetch + validate one rendered image, translating SDK failures (asset-403 →\n *  `E_ASSET_FORBIDDEN`) into the editor error contract. */\nasync function fetchRender(url: string, label: 'seed' | 'mutated', opts: AssertRendersOptions): Promise<{ bytes: Uint8Array; kind: string }> {\n  try {\n    const img = await fetchMockupImage(url, {\n      ...(opts.fetchImpl ? { fetchImpl: opts.fetchImpl } : {}),\n    });\n    return { bytes: img.bytes, kind: img.kind };\n  } catch (err) {\n    if (isSnowconeSdkError(err)) {\n      if (err.code === 'ASSET_FORBIDDEN') {\n        throw new EditorError(\n          'E_ASSET_FORBIDDEN',\n          `the shop's asset-origin allowlist denied an asset in this design (${label} render). ` +\n            `Allow the asset's origin on the shop (or host it on the shop's storage origin).`,\n          { phase: label, url, failedAssets: err.data.failedAssets, docSlug: 'embed-mode' },\n        );\n      }\n      if (err.code === 'SHOP_NOT_PROPAGATED') throw err; // already structured + named\n      throw new EditorError('E_RENDER_FAILED', `the ${label} render's image fetch failed: ${err.message}`, {\n        phase: label,\n        url,\n        ...err.data,\n      });\n    }\n    throw err;\n  }\n}\n\n/**\n * Prove a design + product render AND that the design's bindings are alive\n * (two-render contract). See the module doc for the failure catalog.\n *\n * @experimental ADR-0085; subject to change until the P4 gate.\n */\nexport async function assertRenders(\n  design: RenderableDesign,\n  product: RenderProduct,\n  opts: AssertRendersOptions,\n): Promise<AssertRendersResult> {\n  const timeoutMs = opts.timeoutMs ?? 30_000;\n  const seed = design.toJSON();\n  const placement = seed.activeArtboard;\n  const mutated = (opts.mutate ?? mutateNamedTextLayers)(seed);\n\n  const grant = opts.grant;\n  const getToken =\n    typeof grant === 'function'\n      ? grant\n      : grant\n        ? () => Promise.resolve(grant)\n        : () =>\n            mintRealtimeGrant({\n              shop: opts.shop,\n              ...(opts.apiKey ? { apiKey: opts.apiKey } : {}),\n              ...(opts.grantBase ? { base: opts.grantBase } : {}),\n              ...(opts.fetchImpl ? { fetch: opts.fetchImpl } : {}),\n            });\n\n  const makeSession = () =>\n    new RenderSession({\n      shop: opts.shop,\n      product,\n      ...(opts.wsUrl ? { wsUrl: opts.wsUrl } : {}),\n      getToken,\n    });\n\n  const seedResult = await renderOnce(makeSession, placement, seed, timeoutMs, 'seed');\n  const seedImage = await fetchRender(seedResult.imageUrl!, 'seed', opts);\n\n  const mutatedResult = await renderOnce(makeSession, placement, mutated, timeoutMs, 'mutated');\n  const mutatedImage = await fetchRender(mutatedResult.imageUrl!, 'mutated', opts);\n\n  if (bytesEqual(seedImage.bytes, mutatedImage.bytes)) {\n    throw new EditorError(\n      'E_BINDING_INERT',\n      'the mutated render is byte-identical to the seed render — the mutation never reached ' +\n        'the server, so the binding under test is DEAD. Usual causes: the mutated layer name ' +\n        \"doesn't exist in the design (check design.layer() names), or opts.mutate returned the \" +\n        'seed unchanged.',\n      {\n        seedUrl: seedResult.imageUrl,\n        mutatedUrl: mutatedResult.imageUrl,\n        bytes: seedImage.bytes.byteLength,\n        docSlug: 'embed-mode',\n      },\n    );\n  }\n\n  return {\n    seed: { url: seedResult.imageUrl!, bytes: seedImage.bytes.byteLength, kind: seedImage.kind },\n    mutated: { url: mutatedResult.imageUrl!, bytes: mutatedImage.bytes.byteLength, kind: mutatedImage.kind },\n  };\n}\n","/**\n * Deterministic failure-mode fixtures (ADR-0085 plan, P2 — the magic-test-card\n * equivalent): trigger each commerce/render failure ON DEMAND so integrators\n * build their error UI against real failures instead of waiting for prod to\n * produce one.\n *\n * These are the CLIENT-ACHIEVABLE fixtures — each works against any shop\n * (including a fresh sandbox shop) with no server cooperation:\n *\n *  - {@link test403Design} — asset-origin allowlist denial. References an\n *    asset on an origin no shop allowlists, so the server's asset fetch is\n *    denied deterministically. Surfaces as a render error (live path) or\n *    `E_ASSET_FORBIDDEN` from `assertRenders`.\n *  - {@link testIncompleteDesign} — Buy completeness failure. A design whose\n *    only personalization layer still carries its seed value, so\n *    `<Editor.Buy>` gates with `layer-seed:<name>` (and `layer:<name>` once\n *    cleared). Pair with `<Editor.TextField layer={d.layer('name')} />`.\n *  - {@link failingGrant} — grant failure. A grant factory that always\n *    rejects; pass as `<Editor.Root grant={failingGrant()}>` to exercise the\n *    \"grant fetch fails\" surface (`onRenderError` + the Preview's\n *    `data-sc-part=\"preview-error\"` state).\n *\n * Server-triggered fixtures (a `test-slow` product for the timeout path, a\n * forced render-error token) need render-edge cooperation and are tracked\n * separately — they are NOT silently stubbed here.\n */\n\nimport { design } from '../design/design-builder.js';\nimport type { RealtimeGrant } from '@snowcone-app/sdk';\n\n/**\n * An origin that is deliberately on NO shop's asset-origin allowlist. The\n * `.invalid` TLD is reserved (RFC 2606) — it can never resolve, and the\n * allowlist check denies it before any fetch is attempted, so the failure is\n * deterministic and free.\n */\nexport const TEST_403_ASSET_URL = 'https://assets.test-403.invalid/denied.png';\n\n/**\n * A design whose background asset the shop's allowlist is guaranteed to deny —\n * the deterministic allowlist-denial (403) trigger.\n */\nexport function test403Design() {\n  return design({ name: 'Front', width: 1000, height: 1000 })\n    .background(TEST_403_ASSET_URL, { aspectRatio: 1, name: 'art' })\n    .text('ALLOWLIST DENIAL FIXTURE', { anchor: 'top', name: 'headline' });\n}\n\n/**\n * A design that gates `<Editor.Buy>` out of the box: its one personalization\n * layer (`'name'`, seed `'YOUR NAME'`) is required and still equals its seed,\n * so Buy renders `data-sc-buy-state=\"incomplete\"` with\n * `data-sc-buy-missing=\"layer-seed:name\"` until a real value is typed.\n */\nexport function testIncompleteDesign() {\n  return design({ name: 'Front', width: 1000, height: 1000 })\n    .text('YOUR NAME', { anchor: 'center', name: 'name' });\n}\n\n/**\n * A grant factory that always rejects — the deterministic \"grant fetch\n * failed\" trigger. The rejection reason is stable for assertions.\n */\nexport function failingGrant(reason = 'failing-grant fixture: grant endpoint unavailable'): () => Promise<RealtimeGrant> {\n  return () => Promise.reject(new Error(reason));\n}\n"],"names":["MockEditorProvider","children","_initialElements","initialArtboards","_initialSelection","_initialMultiSelection","initialArtboardConfig","_artboardManager","useState","manager","ArtboardManager","artboard","ThemeProvider","jsx","EditorProvider","MockEditorProviderWithState","createMockElement","transformType","overrides","transformDef","getTransformById","createMockImageElement","ImageElement","createMockArtboard","ArtboardElement","waitFor","condition","timeout","interval","startTime","resolve","waitForExport","_artboardId","dataUrl","simulateKeyPress","key","options","event","createMockCanvas","width","height","canvas","assertElementProperties","element","expected","value","getElementBounds","bbox","mutateNamedTextLayers","seed","mutatedAny","elements","el","name","text","EditorError","bytesEqual","a","b","i","renderOnce","makeSession","placement","state","timeoutMs","label","session","reject","timer","results","withImage","r","message","serializeStateForServer","err","fetchRender","url","opts","img","fetchMockupImage","isSnowconeSdkError","assertRenders","design","product","mutated","grant","getToken","mintRealtimeGrant","RenderSession","seedResult","seedImage","mutatedResult","mutatedImage","TEST_403_ASSET_URL","test403Design","testIncompleteDesign","failingGrant","reason"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snowcone-app/canvas",
-  "version": "0.18.1",
+  "version": "0.19.1",
   "description": "Self-contained canvas editor component for e-commerce product customization",
   "type": "module",
   "main": "./dist/index.mjs",
@@ -107,7 +107,7 @@
     "react-colorful": "^5.6.1",
     "tailwind-merge": "^3.0.0",
     "tailwind-variants": "^3.1.1",
-    "@snowcone-app/sdk": "0.14.0"
+    "@snowcone-app/sdk": "0.15.0"
   },
   "devDependencies": {
     "@axe-core/playwright": "^4.11.0",
@@ -169,7 +169,7 @@
     "vite-plugin-node-polyfills": "^0.24.0",
     "vitest": "^3.2.4",
     "zod": "^4.1.12",
-    "@snowcone-app/ui": "0.2.4"
+    "@snowcone-app/ui": "0.2.5"
   },
   "scripts": {
     "dev": "vite",