@pygmalionjs/pygmalion 0.6.35 → 0.7.1

package/README.md

@@ -174,22 +174,32 @@ defaults, adoption, and code-generation metadata revision-bound without putting
 functions in JSON.
 Repository-owned generated-code intent belongs in `codegenProject` so its
 frame contracts and prompt provenance switch with the same catalog.
-Then opt the editor into the endpoint:
+Then opt the editor into the exact-preview services through its transport:
 
 ```tsx
-const { appOrigin, previewRevision } = usePygmalionProject();
-
-<PygmalionEditor
-  previewCacheNamespace="my-product"
-  previewRevision={previewRevision}
-  appOrigin={appOrigin ?? undefined}
-  previewCatalogEndpoint="/__pygmalion-route-preview/artifact/catalog"
-/>
+// Once, for the editor's lifetime. The catalog endpoint derives from the
+// artifact endpoint; pass `previewCatalog: null` to run artifacts alone.
+const transport = createViteTransport({ endpoints: { previewArtifact: true } });
+const runtime = createEditorRuntime({ transport });
+
+function Editor() {
+  const { appOrigin, previewRevision } = usePygmalionProject({ transport });
+  return (
+    <PygmalionEditor
+      runtime={runtime}
+      previewCacheNamespace="my-product"
+      previewRevision={previewRevision}
+      appOrigin={appOrigin ?? undefined}
+    />
+  );
+}
 ```
 
-Pass the runtime's full `previewRevision`; the editor derives its source SHA
-for the catalog request while retaining the session mutation counter for screen
-cache invalidation.
+Every request the editor and the project hook make goes through that
+transport, so the two talk to one service; [The editor transport](./docs/transport.md)
+lists its operations, paths, and errors. Pass the hook's full
+`previewRevision`; the editor derives its source SHA for the catalog request
+while retaining the session mutation counter for screen cache invalidation.
 
 The editor validates both namespace and source revision before installation.
 While another checkout is preparing, it keeps the last complete catalog,
@@ -395,9 +405,9 @@ Artifact v3 preserves every registered frame with one explicit outcome:
 their last stable DOM and screenshot while CI remains red. A failed strict
 capture therefore cannot silently leave an older artifact active.
 
-When `previewArtifactEndpoint` is configured, an embedded artifact with another
-namespace or source revision is treated only as a visibly outdated, last-known
-preview. It does not count toward `data-preview-warm`. Each frame exposes its
+When the transport configures a preview artifact endpoint, an embedded
+artifact with another namespace or source revision is treated only as a
+visibly outdated, last-known preview. It does not count toward `data-preview-warm`. Each frame exposes its
 exact-resolution lifecycle through `data-artifact-resolution`: `checking`,
 `outdated`, `generating`, `error`, or `exact`. Transport, validation, and
 generation failures stay visible on the frame with a retry action. A current
@@ -447,4 +457,15 @@ npm run lint:language
 - [Editor usability](./EDITOR-USABILITY.md) defines interaction coverage.
 - [Product readiness](./PRODUCTIZATION.md) defines quality gates and remaining
   work.
-- [Contributing](./CONTRIBUTING.md) defines the required commit format.
+- [The editor transport](./docs/transport.md) defines the one object every
+  request goes through, its endpoint table, and its error model.
+- [Upgrading to 0.7](./docs/migration-0.7.md) maps the removed module-level
+  exports to the editor runtime and the removed endpoint props to the
+  transport.
+- [Contributing](./CONTRIBUTING.md) defines the required commit format and the
+  release flow.
+- [Changelog](./CHANGELOG.md) lists what each published version changed.
+
+## License
+
+Pygmalion is released under the [Apache License 2.0](./LICENSE).

package/dist-lib/CameraLayer-D2wrEPwG.js

@@ -0,0 +1,415 @@
+import { jsx as G } from "react/jsx-runtime";
+import { a6 as U, R as A, Y as q, ab as O, ad as J, a7 as Q, af as Z, ac as ee, bB as te } from "./runtime-DRkTU9eq.js";
+import { useRef as ne, useLayoutEffect as N } from "react";
+import { d as re, e as oe } from "./frameLodRuntime-CU0IYaSu.js";
+function Ee({
+  editMode: e,
+  tool: t,
+  hasRoute: r,
+  liveOriginReady: n,
+  backgroundOnly: o = !1
+}) {
+  return !e && t === "select" && r && n && !o;
+}
+function ie(e, t, r) {
+  return t !== "select" ? !1 : e || r;
+}
+const Y = Object.freeze({
+  frameId: null,
+  phase: "idle",
+  scroll: null
+}), P = /* @__PURE__ */ new Set();
+let u = Y, v = null;
+function L(e) {
+  u = e;
+  for (const t of P) t();
+}
+function y(e) {
+  return Number.isFinite(e) ? e : 0;
+}
+function X(e) {
+  const t = Math.max(0, y(e.viewportWidth)), r = Math.max(0, y(e.viewportHeight)), n = Math.max(t, y(e.contentWidth)), o = Math.max(r, y(e.contentHeight)), s = Math.max(0, y(e.maxX)), a = Math.max(0, y(e.maxY));
+  return {
+    x: Math.min(s, Math.max(0, y(e.x))),
+    y: Math.min(a, Math.max(0, y(e.y))),
+    maxX: s,
+    maxY: a,
+    viewportWidth: t,
+    viewportHeight: r,
+    contentWidth: n,
+    contentHeight: o
+  };
+}
+function se(e, t) {
+  return e ? e.x === t.x && e.y === t.y && e.maxX === t.maxX && e.maxY === t.maxY && e.viewportWidth === t.viewportWidth && e.viewportHeight === t.viewportHeight && e.contentWidth === t.contentWidth && e.contentHeight === t.contentHeight : !1;
+}
+function x(e) {
+  const t = v;
+  t && (v = null, t.unsubscribe(), e && u.frameId === t.frameId && (u.phase === "preview" || u.phase === "interacting") && L({ frameId: t.frameId, phase: "starting", scroll: null }));
+}
+function Le(e) {
+  var t, r;
+  if (e) {
+    if (u.frameId === e) {
+      (r = v == null ? void 0 : (t = v.adapter).focus) == null || r.call(t);
+      return;
+    }
+    x(!1), L({ frameId: e, phase: "starting", scroll: null });
+  }
+}
+function F(e) {
+  return u.frameId == null || e != null && u.frameId !== e ? !1 : (x(!1), L(Y), !0);
+}
+function xe(e, t) {
+  return u.frameId == null || t && u.frameId === e ? !1 : F();
+}
+function ke() {
+  return u;
+}
+function Ie(e) {
+  return P.add(e), () => P.delete(e);
+}
+function ae(e, t) {
+  return B(e, t, "interacting");
+}
+function B(e, t, r) {
+  var o, s;
+  if (u.frameId !== e) return () => {
+  };
+  x(!1);
+  const n = () => {
+    if (u.frameId !== e || (v == null ? void 0 : v.adapter) !== t) return;
+    const a = X(t.readScroll());
+    u.phase === r && se(u.scroll, a) || L({ frameId: e, phase: r, scroll: a });
+  };
+  return v = {
+    frameId: e,
+    adapter: t,
+    phase: r,
+    unsubscribe: ((o = t.subscribe) == null ? void 0 : o.call(t, n)) ?? (() => {
+    })
+  }, n(), (s = t.focus) == null || s.call(t), () => {
+    (v == null ? void 0 : v.adapter) === t && x(!0);
+  };
+}
+function Pe(e, t, r) {
+  const n = t.host.ownerDocument.defaultView;
+  if (!n) return () => {
+  };
+  let o = r;
+  return B(e, {
+    readScroll: () => j(o),
+    scrollTo: ({ x: a, y: i }) => {
+      try {
+        o.scrollTo({ left: a, top: i, behavior: "auto" });
+      } catch {
+        o.scrollLeft = a, o.scrollTop = i;
+      }
+      o.scrollLeft !== a && (o.scrollLeft = a), o.scrollTop !== i && (o.scrollTop = i);
+    },
+    subscribe: (a) => {
+      const i = (l) => {
+        const c = l.target;
+        c instanceof n.HTMLElement && (c.scrollHeight > c.clientHeight || c.scrollWidth > c.clientWidth) && (o = c), a();
+      }, f = (l) => {
+        !(l instanceof n.KeyboardEvent) || l.key !== "Escape" || (l.preventDefault(), l.stopImmediatePropagation(), F(e));
+      }, w = (l) => {
+        var S;
+        const c = l.target;
+        (S = c == null ? void 0 : c.closest) != null && S.call(c, "a[href]") && l.preventDefault();
+      }, g = (l) => l.preventDefault();
+      return t.addEventListener("scroll", i, !0), t.addEventListener("keydown", f, !0), t.addEventListener("click", w, !0), t.addEventListener("submit", g, !0), () => {
+        t.removeEventListener("scroll", i, !0), t.removeEventListener("keydown", f, !0), t.removeEventListener("click", w, !0), t.removeEventListener("submit", g, !0);
+      };
+    }
+  }, "preview");
+}
+function Fe(e) {
+  const t = v;
+  if (!t || u.phase !== "preview" && u.phase !== "interacting" || !u.scroll)
+    return !1;
+  t.adapter.scrollTo({
+    x: e.x ?? u.scroll.x,
+    y: e.y ?? u.scroll.y
+  });
+  const r = X(t.adapter.readScroll());
+  return L({
+    frameId: t.frameId,
+    phase: t.phase,
+    scroll: r
+  }), !0;
+}
+function j(e) {
+  return {
+    x: e.scrollLeft,
+    y: e.scrollTop,
+    maxX: Math.max(0, e.scrollWidth - e.clientWidth),
+    maxY: Math.max(0, e.scrollHeight - e.clientHeight),
+    viewportWidth: e.clientWidth,
+    viewportHeight: e.clientHeight,
+    contentWidth: e.scrollWidth,
+    contentHeight: e.scrollHeight
+  };
+}
+function I(e, t) {
+  try {
+    const r = new URL(e), n = new URL(t, r);
+    return r.origin === n.origin && r.pathname === n.pathname;
+  } catch {
+    return !1;
+  }
+}
+function ce(e, t) {
+  const r = e.location.href, n = e.history, o = n.pushState, s = n.replaceState, a = n.back, i = n.forward, f = n.go, w = e.open, g = (d) => d == null || I(
+    r,
+    new URL(String(d), e.location.href).href
+  ), l = (d, p, m) => {
+    g(m) && o.call(n, d, p, m);
+  }, c = (d, p, m) => {
+    g(m) && s.call(n, d, p, m);
+  }, S = () => {
+  }, H = () => {
+  }, W = () => {
+  }, M = (() => null);
+  n.pushState = l, n.replaceState = c, n.back = S, n.forward = H, n.go = W, e.open = M;
+  const R = (d) => {
+    var D;
+    const p = d.target, m = (D = p == null ? void 0 : p.closest) == null ? void 0 : D.call(p, "a[href]");
+    if (!m) return;
+    (m.target && m.target.toLowerCase() !== "_self" || !I(
+      r,
+      m.href
+    )) && d.preventDefault();
+  }, T = (d) => d.preventDefault(), b = e.navigation, C = (d) => {
+    var m;
+    const p = (m = d.destination) == null ? void 0 : m.url;
+    p && !I(r, p) && d.cancelable && d.preventDefault();
+  };
+  return t.addEventListener("click", R, !0), t.addEventListener("submit", T, !0), b == null || b.addEventListener("navigate", C), () => {
+    t.removeEventListener("click", R, !0), t.removeEventListener("submit", T, !0), b == null || b.removeEventListener("navigate", C), n.pushState === l && (n.pushState = o), n.replaceState === c && (n.replaceState = s), n.back === S && (n.back = a), n.forward === H && (n.forward = i), n.go === W && (n.go = f), e.open === M && (e.open = w);
+  };
+}
+function He(e, t) {
+  const r = t.contentWindow, n = t.contentDocument, o = n == null ? void 0 : n.scrollingElement;
+  if (!r || !n || !o)
+    return () => {
+    };
+  let s = o;
+  return ae(e, {
+    readScroll: () => j(s),
+    scrollTo: ({ x: i, y: f }) => s.scrollTo({ left: i, top: f }),
+    focus: () => {
+      t.focus(), r.focus();
+    },
+    subscribe: (i) => {
+      const f = ce(
+        r,
+        n
+      ), w = (l) => {
+        const c = l.target;
+        c != null && c.nodeType === 1 && (c.scrollHeight > c.clientHeight || c.scrollWidth > c.clientWidth) && (s = c), i();
+      }, g = (l) => {
+        l.key === "Escape" && (l.preventDefault(), l.stopImmediatePropagation(), F(e));
+      };
+      return n.addEventListener("scroll", w, !0), r.addEventListener("resize", i), r.addEventListener("keydown", g, !0), () => {
+        f(), n.removeEventListener("scroll", w, !0), r.removeEventListener("resize", i), r.removeEventListener("keydown", g, !0);
+      };
+    }
+  });
+}
+const le = /* @__PURE__ */ new Set(), E = /* @__PURE__ */ new Map();
+let h = [];
+const ue = 2;
+function K(e, t) {
+  for (const n of [...le]) n();
+  const r = /* @__PURE__ */ new Set();
+  for (const n of e) t.includes(n) || r.add(n);
+  for (const n of t) e.includes(n) || r.add(n);
+  for (const n of r) {
+    const o = E.get(n);
+    if (o)
+      for (const s of [...o]) s();
+  }
+}
+function We(e, t = ue) {
+  if (!e) return !1;
+  const r = Math.max(1, t);
+  if (h[0] === e && h.length <= r) return !1;
+  const n = [e, ...h.filter((s) => s !== e)].slice(0, r);
+  if (n.length === h.length && n.every((s, a) => s === h[a]))
+    return !1;
+  const o = h;
+  return h = n, K(o, n), !0;
+}
+function Me(e) {
+  if (!h.includes(e)) return;
+  const t = h;
+  h = h.filter((r) => r !== e), K(t, h);
+}
+function fe(e) {
+  return h.includes(e);
+}
+function Re() {
+  return h;
+}
+function Te(e, t) {
+  let r = E.get(e);
+  return r || (r = /* @__PURE__ */ new Set(), E.set(e, r)), r.add(t), () => {
+    r.delete(t), r.size === 0 && E.get(e) === r && E.delete(e);
+  };
+}
+function _(e) {
+  return `translate(${e.panX}px, ${e.panY}px) scale(${e.zoom})`;
+}
+function $(e, t, r) {
+  return ie(e, t, r) ? void 0 : "none";
+}
+function z(e, t) {
+  return $(
+    e.editMode,
+    e.tool,
+    t != null
+  );
+}
+const k = /* @__PURE__ */ new WeakMap();
+function de(e, t, r) {
+  if (e.route == null) return 0;
+  const n = Q(e) ?? e.route, o = e.width ?? 390, s = e.height ?? 600, a = te();
+  let i = k.get(e);
+  (!i || i.revision !== t || i.epoch !== a || i.route !== n || i.width !== o || i.height !== s) && (i = {
+    revision: t,
+    epoch: a,
+    route: n,
+    width: o,
+    height: s,
+    key: O(e, t, r)
+  }, k.set(e, i));
+  const f = Z(i.key);
+  if (f != null) return f.length * 2;
+  const w = ee(i.key);
+  return w ? w.bodyHtml.length * 2 : 0;
+}
+function he(e, t, r) {
+  var i;
+  if (e.route == null) return null;
+  const n = k.get(e), o = (n == null ? void 0 : n.key) ?? O(e, t, r), s = (i = J(o)) == null ? void 0 : i.screenshot;
+  if (!s) return null;
+  const a = e.width ?? 390;
+  return a > 0 ? s.width / a : null;
+}
+function me(e) {
+  return V(e).map((r) => {
+    var o;
+    const n = e.store.pages.find((s) => s.id === r.id);
+    return {
+      ...r,
+      memoKey: n ? (o = k.get(n)) == null ? void 0 : o.key : void 0
+    };
+  });
+}
+function V(e) {
+  const t = e.store, r = e.host.previewRevision, n = t.selectedCanvasObject;
+  return t.pages.filter(
+    (o) => (o.canvas ?? "default") === t.activeCanvas && t.isScreenStateShown(o)
+  ).map((o) => ({
+    id: o.id,
+    rect: {
+      x: o.x ?? 0,
+      y: o.y ?? 0,
+      width: o.width ?? 390,
+      height: q(o)
+    },
+    pinned: o.id === t.activePageId || (n == null ? void 0 : n.kind) === "frame" && n.id === o.id || // Catalog sheets need a full first render to replace their 1x1 seed.
+    // Their live DOM remains mounted afterwards; offscreen paint may be skipped.
+    oe(o) || fe(o.id),
+    weightBytes: de(o, r, o.id === t.activePageId),
+    screenshotDensity: he(
+      o,
+      r,
+      o.id === t.activePageId
+    )
+  }));
+}
+let ve = 0;
+function pe({
+  children: e,
+  interactionFrameId: t = null
+}) {
+  const r = U(), n = r.store, o = ne(null);
+  return N(() => {
+    const s = o.current;
+    if (!s) return;
+    const a = new A(`CameraLayer#${++ve}`, () => {
+      a.isDisposed || i();
+    }), i = () => {
+      a.track(() => {
+        s.style.transform = _(n), s.style.pointerEvents = z(n, t) ?? "";
+      });
+    };
+    return i(), () => a.dispose();
+  }, [n, t]), N(() => {
+    const s = re({
+      readCamera: () => ({
+        panX: n.panX,
+        panY: n.panY,
+        zoom: n.zoom,
+        canvas: n.activeCanvas
+      }),
+      readFrames: () => V(r),
+      readViewport: () => {
+        var i;
+        const a = (i = o.current) == null ? void 0 : i.parentElement;
+        if (a) {
+          const f = a.getBoundingClientRect();
+          if (f.width > 0 && f.height > 0)
+            return { width: f.width, height: f.height };
+        }
+        return { width: window.innerWidth, height: window.innerHeight };
+      }
+    });
+    return s.start(), () => s.stop();
+  }, [n, r]), /* @__PURE__ */ G(
+    "div",
+    {
+      ref: o,
+      "data-canvas-camera": !0,
+      style: {
+        position: "absolute",
+        left: 0,
+        top: 0,
+        transform: _(n),
+        transformOrigin: "0 0",
+        transition: "none",
+        willChange: "transform",
+        pointerEvents: z(n, t)
+      },
+      children: e
+    }
+  );
+}
+const Ce = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
+  __proto__: null,
+  CameraLayer: pe,
+  __debugReadEditorFrames: me,
+  resolveCameraPointerEvents: $
+}, Symbol.toStringTag, { value: "Module" }));
+export {
+  pe as C,
+  ue as P,
+  He as a,
+  Ie as b,
+  Pe as c,
+  xe as d,
+  F as e,
+  I as f,
+  ke as g,
+  fe as h,
+  Ee as i,
+  Le as j,
+  Re as k,
+  Fe as l,
+  Ce as m,
+  We as n,
+  Me as r,
+  Te as s
+};