@pygmalionjs/pygmalion 0.7.3 → 0.8.0

package/README.ko.md

@@ -319,14 +319,22 @@ captureStoryboardCase({
 하나의 시나리오는 반드시 한 분류에만 속해야 합니다. 잘못된 참조, 누락된
 시나리오, 중복 분류가 있으면 에디터를 열기 전에 검증이 실패합니다.
 
+모든 소스 라우트가 표현되었는지는 별개의 질문이며 에디터 없이 답합니다.
+`auditRouteCoverage`는 호스트가 발견한 라우트를 호스트가 선언한 화면(구체적인
+프리뷰, 명시적인 `coverageRoutes` 매핑, 등록된 컴포넌트 fixture)과 대조합니다.
+`validateSurfaceDemands`는 나머지 라우트에 내린 판정이 실제로 선언된 대상을
+가리키는지 확인합니다. 요약 함수는 제외 항목과 todo 항목을 커버리지와 따로
+셉니다. 식별자, 진단, 호스트에 남는 책임은
+[Coverage contracts](./docs/coverage-contracts.md)가 정의합니다.
+
 화면 레시피는 `click`, `focus`, `hover`, `focus-visible`, `active`, `fill`,
 `check`, `press`, `scroll`, `wait`, `storage` 단계를 지원합니다. 각 프레임이 항상
 같은 애플리케이션 상태를 재현하도록 결정적인 레시피와 assertion을 사용하세요.
 어떤 변형이 프레임인지, 상호작용 상태인지, 조건 상태인지, 편집 가능한
 매개변수인지, 모션 프리뷰인지, 동작 전용 QA인지는
 [화면 상태 계약](./docs/screen-state-contract.md)이 정의합니다. 렌더링된 CSS와
-Web Animations 대상은 오른쪽 패널의 Motion 컨트롤에 자동으로 나타납니다. 재생,
-일시 정지, 초기화, 대상 격리, 단계 스크러빙을 지원합니다.
+Web Animations 대상은 캡처를 위해 자동으로 찾아 정착시킵니다. 라이브 프레임은
+제품의 모션을 그대로 재생합니다.
 
 ### 제품 라우트와 프리뷰 진입 라우트 분리하기
 
@@ -457,8 +465,15 @@ npm run lint:language
 - [Product readiness](./PRODUCTIZATION.md): 품질 기준과 남은 작업을 정의합니다.
 - [The editor transport](./docs/transport.md): 모든 요청이 거치는 하나의
   객체를 정의합니다. 엔드포인트 표와 오류 모델도 여기에 있습니다.
+- [Coverage contracts](./docs/coverage-contracts.md): 호스트의 소스 라우트
+  게이트를 정의합니다. 라우트를 식별하는 기준과 프리뷰·명시적 매핑·fixture로
+  표현하는 방법, 시나리오를 정확히 한 번 분류하는 규칙, 진단을 소스로 연결하는
+  방식이 여기에 있습니다.
 - [Upgrading to 0.7](./docs/migration-0.7.md): 사라진 모듈 수준 export를
   에디터 런타임으로, 사라진 엔드포인트 prop을 transport로 대응시킵니다.
+- [Upgrading to 0.8](./docs/migration-0.8.md): 런타임으로 옮겨간 것들, 커버리지
+  계약, 라이브 캔버스, 그리고 Next.js 호스트를 위한 0.6 → 0.8 체크리스트를
+  정리합니다.
 - [Contributing](./CONTRIBUTING.md): 필수 커밋 형식과 릴리스 절차를 정의합니다.
 - [Changelog](./CHANGELOG.md): 발행된 각 버전이 무엇을 바꿨는지 기록합니다.
 

package/README.md

@@ -319,14 +319,23 @@ either:
 A scenario must appear in exactly one category. Invalid references, missing
 coverage, and duplicate classifications fail before the editor opens.
 
+Whether every source route is represented is a separate question, answered
+headless: `auditRouteCoverage` compares the routes the host discovered with
+the screens it declared (a concrete preview, an explicit `coverageRoutes`
+mapping, or a registered component fixture), `validateSurfaceDemands` checks
+the verdicts for the rest against the declarations they name, and the
+summaries count exclusions and todo items apart from coverage.
+[Coverage contracts](./docs/coverage-contracts.md) defines the identities,
+the diagnostics, and what stays in the host.
+
 Screen recipes support `click`, `focus`, `hover`, `focus-visible`, `active`,
 `fill`, `check`, `press`, `scroll`, `wait`, and `storage` steps. Use deterministic recipes
 and assertions so each frame represents a repeatable application state. The
 [screen state contract](./docs/screen-state-contract.md) defines when a
 variation is a frame, an interaction state, a condition state, an editable
 parameter, a motion preview, or behavior-only QA. Rendered CSS and Web
-Animations targets are automatically available in the right-panel Motion
-controls with play, pause, reset, target isolation, and phase scrubbing.
+Animations targets are discovered and settled for captures; a live frame
+plays the product's own motion.
 
 ### Keep product routes separate from preview entry routes
 
@@ -459,9 +468,16 @@ npm run lint:language
   work.
 - [The editor transport](./docs/transport.md) defines the one object every
   request goes through, its endpoint table, and its error model.
+- [Coverage contracts](./docs/coverage-contracts.md) defines how a host's
+  source-route gate identifies routes, represents them by preview, mapping,
+  or fixture, classifies scenarios exactly once, and joins diagnostics back
+  to source.
 - [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.
+- [Upgrading to 0.8](./docs/migration-0.8.md) lists what moved onto the
+  runtime, the coverage contracts, the live canvas, and a 0.6 to 0.8
+  checklist for a Next.js host.
 - [Contributing](./CONTRIBUTING.md) defines the required commit format and the
   release flow.
 - [Changelog](./CHANGELOG.md) lists what each published version changed.

package/dist-lib/CameraLayer-nkNrazn8.js

@@ -0,0 +1,159 @@
+import { jsx as p } from "react/jsx-runtime";
+import { a as C, R as P, at as g, bB as R, bC as b, C as E, bD as k, P as m, K as I } from "./runtime-DdYnT6k4.js";
+import { useRef as L, useLayoutEffect as h } from "react";
+function v(n) {
+  return `translate(${n.panX}px, ${n.panY}px) scale(${n.zoom})`;
+}
+function x(n, e, i, r = !1) {
+  return r || k(n, e, i) ? void 0 : "none";
+}
+function f(n, e) {
+  return x(
+    n.editMode,
+    n.tool,
+    e != null,
+    n.inspectOn
+  );
+}
+const l = /* @__PURE__ */ new WeakMap();
+function z(n, e, i, r) {
+  if (e.route == null) return 0;
+  const t = I(e) ?? e.route, a = e.width ?? 390, o = e.height ?? 600, c = n.declarations.getPreviewIdentityEpoch();
+  let s = l.get(e);
+  (!s || s.revision !== i || s.epoch !== c || s.route !== t || s.width !== a || s.height !== o) && (s = {
+    revision: i,
+    epoch: c,
+    route: t,
+    width: a,
+    height: o,
+    key: m(n, e, i, r)
+  }, l.set(e, s));
+  const d = n.previews.getRoutePreviewSnapshot(s.key);
+  if (d != null) return d.length * 2;
+  const u = n.previews.getRoutePreviewShadowArtifact(s.key);
+  return u ? u.bodyHtml.length * 2 : 0;
+}
+function F(n, e, i, r) {
+  var s;
+  if (e.route == null) return null;
+  const t = l.get(e), a = (t == null ? void 0 : t.key) ?? m(n, e, i, r), o = (s = n.previews.getRoutePreviewArtifactOutcome(a)) == null ? void 0 : s.screenshot;
+  if (!o) return null;
+  const c = e.width ?? 390;
+  return c > 0 ? o.width / c : null;
+}
+function W(n) {
+  return w(n).map((i) => {
+    var t;
+    const r = n.store.pages.find((a) => a.id === i.id);
+    return {
+      ...i,
+      memoKey: r ? (t = l.get(r)) == null ? void 0 : t.key : void 0
+    };
+  });
+}
+function w(n) {
+  const e = n.store, i = n.host.previewRevision, r = e.selectedCanvasObject;
+  return e.pages.filter(
+    (t) => (t.canvas ?? "default") === e.activeCanvas && (e.isScreenStateShown(t) || e.isScreenStateStandby(t))
+  ).map((t) => ({
+    id: t.id,
+    rect: {
+      x: t.x ?? 0,
+      y: t.y ?? 0,
+      width: t.width ?? 390,
+      height: E(t)
+    },
+    pinned: t.id === e.activePageId || (r == null ? void 0 : r.kind) === "frame" && r.id === t.id || // A standby variant renders its full surface hidden at the group's
+    // slot, so the switch to it has nothing left to mount.
+    e.isScreenStateStandby(t) || // Catalog sheets need a full first render to replace their 1x1 seed.
+    // Their live DOM remains mounted afterwards; offscreen paint may be skipped.
+    b(t) || n.schedulers.previewIntent.hasPreviewIntent(t.id),
+    weightBytes: z(n, t, i, t.id === e.activePageId),
+    screenshotDensity: F(
+      n,
+      t,
+      i,
+      t.id === e.activePageId
+    )
+  }));
+}
+let B = 0;
+function $({
+  children: n,
+  interactionFrameId: e = null
+}) {
+  const i = C(), r = i.store, t = L(null);
+  return h(() => {
+    const a = t.current;
+    if (!a) return;
+    const o = new P(`CameraLayer#${++B}`, () => {
+      o.isDisposed || c();
+    }), c = () => {
+      o.track(() => {
+        a.style.transform = v(r), a.style.pointerEvents = f(r, e) ?? "";
+      });
+    };
+    return c(), () => o.dispose();
+  }, [r, e]), h(() => {
+    const a = i.schedulers.frameLod.createFrameLodController({
+      readCamera: () => ({
+        panX: r.panX,
+        panY: r.panY,
+        zoom: r.zoom,
+        canvas: r.activeCanvas
+      }),
+      readFrames: () => w(i),
+      // The live-screen budget follows the camera: the active frame first,
+      // then the frames nearest the viewport take the remaining slots.
+      onRecompute: ({ frames: o, camera: c, viewport: s }) => {
+        const { liveScreens: d } = i.schedulers, { activeId: u, siblingIds: y, groupSize: S } = g(() => ({
+          activeId: r.activePageId,
+          siblingIds: r.activeScreenStateSiblingIds,
+          groupSize: r.activeScreenStateGroup.length
+        }));
+        d.setLiveScreenGroupSize(S), d.setLiveScreenCandidates(
+          R({
+            frames: o,
+            camera: c,
+            viewport: s,
+            activeId: u,
+            preferredIds: y
+          })
+        );
+      },
+      readViewport: () => {
+        var c;
+        const o = (c = t.current) == null ? void 0 : c.parentElement;
+        if (o) {
+          const s = o.getBoundingClientRect();
+          if (s.width > 0 && s.height > 0)
+            return { width: s.width, height: s.height };
+        }
+        return { width: window.innerWidth, height: window.innerHeight };
+      }
+    });
+    return a.start(), () => a.stop();
+  }, [r, i]), /* @__PURE__ */ p(
+    "div",
+    {
+      ref: t,
+      "data-canvas-camera": !0,
+      style: {
+        position: "absolute",
+        left: 0,
+        top: 0,
+        transform: v(r),
+        transformOrigin: "0 0",
+        transition: "none",
+        willChange: "transform",
+        pointerEvents: f(r, e)
+      },
+      children: n
+    }
+  );
+}
+export {
+  $ as CameraLayer,
+  W as __debugReadEditorFrames,
+  x as resolveCameraPointerEvents
+};