@pygmalionjs/pygmalion 0.8.0 → 0.8.1

package/dist-lib/{CameraLayer-nkNrazn8.js → CameraLayer-B2D29VXQ.js}

@@ -1,5 +1,5 @@
 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 { 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-BAy8W1mJ.js";
 import { useRef as L, useLayoutEffect as h } from "react";
 function v(n) {
   return `translate(${n.panX}px, ${n.panY}px) scale(${n.zoom})`;

package/dist-lib/pygmalion.js

@@ -2,10 +2,10 @@ var Sl = Object.defineProperty;
 var Nl = (t, e, n) => e in t ? Sl(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
 var Zn = (t, e, n) => Nl(t, typeof e != "symbol" ? e + "" : e, n);
 import { jsxs as u, jsx as s, Fragment as Ue } from "react/jsx-runtime";
-import { u as $r, a as dt, i as Il, o as Ge, b as je, r as Cl, f as Pl, c as kl, d as $l, F as Rl, e as Ml, l as jo, g as qi, h as Xi, s as Ms, j as _o, k as Es, m as El, n as vo, p as Al, q as Fl, R as As, t as Tl, v as Ll, w as Dl, x as Ol, y as zl, S as jl, z as _l, L as Bo, A as Ji, B as Bl, C as zn, D as Hl, E as Fs, G as Ts, M as Yr, H as Wl, I as Zi, J as yo, K as Gn, N as Ir, O as jn, P as Yn, Q as es, T as Vl, U as Kl, V as Yl, W as Qi, X as Ls, Y as Gl, Z as ts, _ as ns, $ as Cr, a0 as Ul, a1 as ql, a2 as ea, a3 as Xl, a4 as Jl, a5 as Zl, a6 as Ql, a7 as ec, a8 as tc, a9 as nc, aa as rc, ab as oc, ac as ta, ad as sc, ae as Ds, af as ic, ag as Os, ah as ac, ai as zs, aj as lc, ak as cc, al as dc, am as uc, an as na, ao as fc, ap as pc, aq as hc, ar as ra, as as mc, at as wo, au as js, av as gc, aw as bc, ax as xc, ay as _s, az as So, aA as vc, aB as yc, aC as wc, aD as Ho, aE as rs, aF as Sc, aG as Qr, aH as Nc, aI as Ic, aJ as Cc, aK as Pc, aL as Bs, aM as kc, aN as $c, aO as Rc, aP as Mc } from "./runtime-DdYnT6k4.js";
-import { aQ as wm, aR as Sm, aS as Nm, aT as Im, aU as Cm, aV as Pm, aW as km, aX as $m, aY as Rm, aZ as Mm, a_ as Em, a$ as Am, b0 as Fm, b1 as Tm, b2 as Lm, b3 as Dm, b4 as Om, b5 as zm, b6 as jm, b7 as _m, b8 as Bm, b9 as Hm, ba as Wm, bb as Vm, bc as Km, bd as Ym, be as Gm, bf as Um, bg as qm, bh as Xm, bi as Jm, bj as Zm, bk as Qm, bl as eg, bm as tg, bn as ng, bo as rg, bp as og, bq as sg, br as ig, bs as ag, bt as lg, bu as cg, bv as dg, bw as ug, bx as fg } from "./runtime-DdYnT6k4.js";
+import { u as $r, a as dt, i as Il, o as Ge, b as je, r as Cl, f as Pl, c as kl, d as $l, F as Rl, e as Ml, l as jo, g as qi, h as Xi, s as Ms, j as _o, k as Es, m as El, n as vo, p as Al, q as Fl, R as As, t as Tl, v as Ll, w as Dl, x as Ol, y as zl, S as jl, z as _l, L as Bo, A as Ji, B as Bl, C as zn, D as Hl, E as Fs, G as Ts, M as Yr, H as Wl, I as Zi, J as yo, K as Gn, N as Ir, O as jn, P as Yn, Q as es, T as Vl, U as Kl, V as Yl, W as Qi, X as Ls, Y as Gl, Z as ts, _ as ns, $ as Cr, a0 as Ul, a1 as ql, a2 as ea, a3 as Xl, a4 as Jl, a5 as Zl, a6 as Ql, a7 as ec, a8 as tc, a9 as nc, aa as rc, ab as oc, ac as ta, ad as sc, ae as Ds, af as ic, ag as Os, ah as ac, ai as zs, aj as lc, ak as cc, al as dc, am as uc, an as na, ao as fc, ap as pc, aq as hc, ar as ra, as as mc, at as wo, au as js, av as gc, aw as bc, ax as xc, ay as _s, az as So, aA as vc, aB as yc, aC as wc, aD as Ho, aE as rs, aF as Sc, aG as Qr, aH as Nc, aI as Ic, aJ as Cc, aK as Pc, aL as Bs, aM as kc, aN as $c, aO as Rc, aP as Mc } from "./runtime-BAy8W1mJ.js";
+import { aQ as wm, aR as Sm, aS as Nm, aT as Im, aU as Cm, aV as Pm, aW as km, aX as $m, aY as Rm, aZ as Mm, a_ as Em, a$ as Am, b0 as Fm, b1 as Tm, b2 as Lm, b3 as Dm, b4 as Om, b5 as zm, b6 as jm, b7 as _m, b8 as Bm, b9 as Hm, ba as Wm, bb as Vm, bc as Km, bd as Ym, be as Gm, bf as Um, bg as qm, bh as Xm, bi as Jm, bj as Zm, bk as Qm, bl as eg, bm as tg, bn as ng, bo as rg, bp as og, bq as sg, br as ig, bs as ag, bt as lg, bu as cg, bv as dg, bw as ug, bx as fg } from "./runtime-BAy8W1mJ.js";
 import { useSyncExternalStore as et, useCallback as Ht, useRef as Ae, useState as Y, useEffect as q, useReducer as oa, useMemo as xt, memo as sa, createElement as Pr, useLayoutEffect as dr, useContext as Ec } from "react";
-import { CameraLayer as Ac } from "./CameraLayer-nkNrazn8.js";
+import { CameraLayer as Ac } from "./CameraLayer-B2D29VXQ.js";
 import { createPortal as ia } from "react-dom";
 import { resolveRoutePreviewArtifactStatus as Fc, resolveStaticRoutePreviewSurface as Tc } from "./routePreviewStatus-DTr-UJhV.js";
 function gn(t) {

package/dist-lib/{runtime-DdYnT6k4.js → runtime-BAy8W1mJ.js}

@@ -11962,7 +11962,7 @@ function Jy(t) {
     });
   };
   for (const l of t.declaredScreens) {
-    const d = l.coverageRoutes ?? [], f = typeof l.componentName == "string" && l.componentName.length > 0 ? l.componentName : null;
+    const d = l.coverageRoutes ?? [], f = typeof l.componentName == "string" && l.componentName.trim().length > 0 ? l.componentName : null, h = typeof l.route == "string" && l.route.trim().length > 0 ? _s(l.route) : null;
     if (f != null && e && !e.has(f)) {
       n.push({
         severity: "error",
@@ -11973,7 +11973,7 @@ function Jy(t) {
       });
       continue;
     }
-    const h = f != null ? "fixture" : "mapping", y = /* @__PURE__ */ new Set();
+    const y = f != null ? "fixture" : "mapping", g = /* @__PURE__ */ new Set();
     for (const m of d) {
       if (typeof m != "string" || m.trim().length === 0) {
         n.push({
@@ -11997,12 +11997,23 @@ function Jy(t) {
         });
         continue;
       }
-      y.has(S.path) || (y.add(S.path), u(S, l, h));
+      if (!g.has(S.path)) {
+        if (g.add(S.path), f == null && h == null) {
+          n.push({
+            severity: "error",
+            code: "missing-render-source",
+            screenId: l.id,
+            route: m,
+            message: `Screen ${l.id} maps route ${m} but has no preview route or component fixture. Supply a nonempty route or a registered component before claiming representation.`
+          });
+          continue;
+        }
+        u(S, l, y);
+      }
     }
-    if (typeof l.route != "string") continue;
-    const g = _s(l.route);
-    for (const m of r)
-      y.has(m.path) || Yy(m.path, g) && (y.add(m.path), u(m, l, "preview"));
+    if (h != null)
+      for (const m of r)
+        g.has(m.path) || Yy(m.path, h) && (g.add(m.path), u(m, l, "preview"));
   }
   return { candidates: r.filter((l) => !a.has(l.path)).map((l) => ({
     kind: "route",
@@ -19433,7 +19444,7 @@ function gw(t) {
           stamped: u ? i.isStampedFrozenPreview(u.root) : null
         },
         lodState: a.__debugFrameLodState(),
-        readFramesNow: (await import("./CameraLayer-nkNrazn8.js")).__debugReadEditorFrames(t).find((h) => h.id === n)
+        readFramesNow: (await import("./CameraLayer-B2D29VXQ.js")).__debugReadEditorFrames(t).find((h) => h.id === n)
       };
     },
     /** Flow-session delivery states for headless diagnosis of the captureless supply. */

package/dist-lib/testing.js

@@ -1,5 +1,5 @@
-import { bh as l, aE as u } from "./runtime-DdYnT6k4.js";
-import { aN as b, by as w, bz as E, bA as P, aJ as $, ad as q } from "./runtime-DdYnT6k4.js";
+import { bh as l, aE as u } from "./runtime-BAy8W1mJ.js";
+import { aN as b, by as w, bz as E, bA as P, aJ as $, ad as q } from "./runtime-BAy8W1mJ.js";
 const v = {
   mirror: ["status", "refresh", "refs"],
   session: ["open", "check", "previewVisual", "applyVisual", "revertVisual"],

package/dist-lib/types/editor/surfaceDemands.d.ts

@@ -200,8 +200,10 @@ export interface RouteRepresentation {
  * - `unregistered-component` — the screen's `componentName` is not among
  *   `registeredComponents`: its fixture registration is gone.
  * - `empty-mapping` — a `coverageRoutes` entry is blank.
+ * - `missing-render-source` — a mapped screen has neither a nonempty preview
+ *   route nor a component fixture to render.
  */
-export type RouteCoverageDiagnosticCode = 'unknown-route' | 'unregistered-component' | 'empty-mapping';
+export type RouteCoverageDiagnosticCode = 'unknown-route' | 'unregistered-component' | 'empty-mapping' | 'missing-render-source';
 export interface RouteCoverageDiagnostic {
     severity: 'error';
     code: RouteCoverageDiagnosticCode;

package/docs/coverage-contracts.md

@@ -9,11 +9,12 @@ merges:
 2. **Classification.** Is every user scenario verified exactly once, and by
    which declaration?
 
-They are different questions with different answers. A preview URL proves that
-a route renders; it proves nothing about a user scenario or an interaction. A
-scenario claim proves where a scenario is verified; it says nothing about
-routes nobody declared. The package answers each with its own functions, and a
-green answer to one never stands in for the other.
+They are different questions with different answers. A declared preview URL
+identifies where a screen should render; these static checks do not execute
+that screen or verify a user interaction. A scenario claim identifies the
+declaration responsible for a scenario; it says nothing about routes nobody
+declared. The package answers each with its own functions, and a green answer
+to one never stands in for the other.
 
 Everything here runs in plain Node: no DOM, no Vite server, no editor mount,
 no network. The functions are pure; they take declarations and return
@@ -127,6 +128,18 @@ mapping that names something missing must never keep covering.
 | `unknown-route` | A `coverageRoutes` entry matches no discovered route; it was removed or renamed | `screenId`, `route`, `componentName?` |
 | `unregistered-component` | The screen's `componentName` is not among `registeredComponents` | `screenId`, `componentName` |
 | `empty-mapping` | A `coverageRoutes` entry is blank | `screenId`, `route` |
+| `missing-render-source` | A mapping has no nonempty preview route or component fixture | `screenId`, `route` |
+
+Starting in 0.8.1, `coverageRoutes` alone never represents a route. A mapped
+screen must also supply a nonempty preview `route` or a component fixture.
+Empty or whitespace-only preview routes do not implicitly represent `/`.
+Pass `registeredComponents` to check that every named fixture is registered.
+
+A mapping without a render source produces `missing-render-source` and adds
+no representation. If no other valid screen represents that source route, it
+stays among the candidates. If another screen does represent it, the invalid
+mapping still produces a diagnostic: a gate must inspect both `diagnostics`
+and the candidates' verdicts, even when `candidates` is empty.
 
 `enumerateRouteCandidates(input)` returns `audit.candidates` alone, for a
 caller that only needs the holes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pygmalionjs/pygmalion",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Code-backed DOM design sandbox and visual QA editor",
   "license": "Apache-2.0",
   "repository": {