@hueest/xray 0.2.0 → 0.3.0

package/dist/{plate-Bv6W-GkA.d.ts → plate-BIr62u7l.d.ts}

@@ -5,8 +5,8 @@
  * browser console (`client.ts`) and the Vite server output (`index.ts`) print.
  *
  * Motivation: the serializer silently swallows a handful of capture omissions
- * (an unreadable cross-origin stylesheet, skipped pseudo-elements, a collapsed
- * list run, an over-the-limit subtree). Early adopters asking "why does this
+ * (an unreadable cross-origin stylesheet, skipped pseudo-elements, off-screen
+ * bones dropped at the fold, an over-the-limit subtree). Early adopters asking "why does this
  * skeleton look wrong?" had to read the serializer source to find out. These
  * diagnostics surface those omissions as data the capture process returns, so a
  * caller can log them — without the core performing any console side effects.
@@ -14,7 +14,7 @@
  * Strictly DEV-ONLY (see the plan's decisions and ADR 0008): this type is NOT a
  * public package export and MUST NEVER reach the persisted Plate JSON, the
  * `MergedPlate`, or the production adapter. It rides on the TRANSIENT
- * `ViewCapture.diagnostics` field only, which `captureRegime` populates and the
+ * `ViewIR.diagnostics` field only, which `captureView` populates and the
  * dev client strips before posting (so committed `plates/<name>.json` stays
  * byte-identical to a capture that produced no diagnostics).
  *
@@ -44,10 +44,10 @@ interface CaptureDiagnostic {
  * serializer (or an existing oversized-capture warning folded into the same
  * vocabulary). Kept as a const union so the message table is exhaustive.
  */
-type DiagnosticCode = 'unreadable-stylesheet' | 'unreadable-import' | 'skipped-dynamic-pseudo' | 'skipped-pseudo-element' | 'unsupported-rule' | 'dropped-tag' | 'pruned-run' | 'too-large' | 'invalid-plate-file';
+type DiagnosticCode = 'unreadable-stylesheet' | 'unreadable-import' | 'skipped-dynamic-pseudo' | 'skipped-pseudo-element' | 'unsupported-rule' | 'dropped-tag' | 'dropped-subset' | 'dropped-cropped' | 'too-large' | 'invalid-plate-file';
 //#endregion
 //#region src/plate.d.ts
-type LeafKind = 'text' | 'media' | 'box';
+type LeafKind = 'text' | 'text-block' | 'media' | 'box';
 /**
  * The shipped structural capture of a component's rendered DOM — the data a
  * Skeleton renders from (see CONTEXT.md). Self-contained: pre-serialized chunks
@@ -81,21 +81,27 @@ interface Plate {
 /**
  * One serialized child of a plate root (or of a stitch-bearing node): a
  * stitch-free HTML run (`string`), a stitch to a child plate (`{ r: name }`),
- * or a stitch-bearing element kept real so its inner stitches can mount
- * (`{ c: className, k: chunk[] }`). The framework-neutral render contract: an
- * adapter injects the strings and mounts a child plate at each stitch (ADR 0008).
+ * a stitch-bearing element kept real so its inner stitches can mount
+ * (`{ c: className, k: chunk[] }`), or a templated uniform run (`{ t: html, n }`):
+ * the cell's HTML once plus a repeat count the adapter expands to N copies (Phase
+ * 2). The framework-neutral render contract: an adapter injects the strings,
+ * mounts a child plate at each stitch, and repeats each template (ADR 0008).
  */
 type Chunk = string | {
   r: string;
 } | {
   c: string;
   k: Chunk[];
+} | {
+  t: string;
+  n: number;
 };
 /**
- * A plate after view-merge + classify but before chunk serialization: the
- * build-time RenderNode tree plus its scoped CSS. Produced by `mergeViews` and
- * `capture`, then serialized into the shipped `Plate` (chunks) at load
- * (`serializePlate`). Never shipped to the client.
+ * A plate after the in-browser Serialize (emit + merge/gate + classify) but
+ * before chunk serialization: the build-time RenderNode tree plus its scoped
+ * CSS. Produced by `serializePlateIR` (the structural part of `StoredPlate`) and
+ * the single-View `capture`, then serialized into the shipped `Plate` (chunks) at
+ * load (`serializePlate`). Never shipped to the client.
  */
 interface MergedPlate {
   v: number;
@@ -114,6 +120,12 @@ interface PlateNode {
    * against `Plate.refs` (prod) or the live store (dev).
    */
   ref?: string;
+  /**
+   * A templated uniform run (Phase 2): render this node's subtree `count` times.
+   * The serializer emits the subtree's HTML once plus the count; the adapter
+   * expands it to N copies at render. Absent on ordinary nodes.
+   */
+  count?: number;
   kids?: PlateNode[];
 }
 /**
@@ -126,6 +138,8 @@ interface RenderNode {
   leaf?: LeafKind;
   ref?: string;
   cls?: string;
+  /** A templated uniform run (Phase 2): serialize this subtree once + a count the adapter repeats. */
+  count?: number;
   kids?: RenderNode[];
 }
 /**
@@ -146,8 +160,11 @@ interface PlateRule {
 }
 /**
  * One capture of a component within one viewport view — `[min, max)` in px,
- * either side open-ended when undefined. What the dev client ships to the
- * plugin, and what the plate file accumulates (ADR 0004).
+ * either side open-ended when undefined. The id-form `{ tree, rules }` shape
+ * `emit` projects a measured View into (ADR 0004). NO LONGER the disk/wire shape
+ * after the ADR 0022 cutover — `StoredPlate` (below) is. Kept as the
+ * framework-neutral per-View capture shape, exported for consumers reading the
+ * id-form projection directly.
  */
 interface ViewCapture {
   /** Viewport width at capture time. */
@@ -158,23 +175,31 @@ interface ViewCapture {
   rules: PlateRule[];
   /**
    * TRANSIENT, dev-only capture diagnostics (why this view may be lower
-   * fidelity). Populated by `captureRegime` in the browser; the dev client logs
-   * it and posts it (so the Vite server can print the same text), then it is
-   * STRIPPED at the merge layer (`addCapture`) before persisting. It MUST NEVER
-   * be persisted: it is not part of the committed `plates/<name>.json` shape,
-   * the `isViewCapture` validator does not require it, and `addCapture` drops it
-   * so neither it nor `mergeViews` ever writes it. Absent in production (the
-   * prod adapter ships no capture). See diagnostics.ts and ADR 0008.
+   * fidelity). Captured in the browser (mirrored onto `ViewIR.diagnostics`); the
+   * dev client logs it and posts it alongside the `StoredPlate` (so the Vite
+   * server can print the same text). It MUST NEVER be persisted: it is not part
+   * of the committed
+   * `StoredPlate` disk shape, the validator does not carry it, and the POST
+   * envelope keeps it in a SIBLING field that never reaches the stored artifact
+   * (ADR 0008). Absent in production (the prod adapter ships no capture). See
+   * diagnostics.ts and ADR 0008.
    */
   diagnostics?: CaptureDiagnostic[];
 }
-/** The committed `plates/<name>.json`: per-view captures, merged at load. */
-interface PlateFile {
-  v: number;
-  name: string;
-  /** Width thresholds (view boundaries) derived so far. */
+/**
+ * The committed `plates/<name>.json` shape AFTER the ADR 0022 cutover: the whole
+ * Plate already projected in the browser (the in-browser Serialize folds emit +
+ * the multi-View merge/gate + classify in one session), so disk holds ONE gated,
+ * content-addressed tree + css instead of per-View captures merged at load. It is
+ * a `MergedPlate` (the structural `{tree, css}` `serializePlate` consumes) PLUS the
+ * `breakpoints` the HUD coverage reads — the analysis-only geometry never crosses
+ * the wire (ADR 0021). The gen-side runs `serializePlate(stored) → Plate` (chunks)
+ * at module-load, leaving the Tailwind/Bundle passthrough a clean gen-side seam.
+ * Replaces `PlateFile` (+ `ViewCapture`) on disk and on the `/__xray` wire.
+ */
+interface StoredPlate extends MergedPlate {
+  /** Width thresholds (view boundaries); the HUD coverage derives its bands from these. */
   breakpoints: number[];
-  views: ViewCapture[];
 }
 /** The (unserialized) plate an import resolves to before anything has been captured. */
 declare function emptyPlate(name: string): MergedPlate;
@@ -305,8 +330,8 @@ interface CaptureHook {
   capture?: ToggleStore;
   /** Read side for `<Skeleton>`. */
   plates?: PlateStore;
-  /** Write side for the dev client's HMR-event handler. */
-  updatePlate?: (name: string, plate: Plate) => void;
+  /** Write side for the dev client's HMR-event handler. Returns whether the plate changed. */
+  updatePlate?: (name: string, plate: Plate) => boolean;
   /** Dev-only: run the HUD-triggered capture-all-views sweep via the extension (ADR 0010). */
   captureAllViews?: () => Promise<void>;
   /** Dev-only per-plate breakpoints + captured spans, from disk; fed by the bootstrap. */
@@ -335,4 +360,4 @@ declare global {
   var __XRAY__: CaptureHook | undefined;
 }
 //#endregion
-export { PlateNode as a, emptyPlate as c, PlateFile as i, MergedPlate as n, RenderNode as o, Plate as r, ViewCapture as s, LeafKind as t };
+export { RenderNode as a, emptyPlate as c, PlateNode as i, CaptureDiagnostic as l, MergedPlate as n, StoredPlate as o, Plate as r, ViewCapture as s, LeafKind as t };

package/dist/{plate-DoE1HEXp.js → plate-BRR6d8Se.js}

@@ -42,7 +42,8 @@ const LEAF_CLASS = "xr-leaf";
 * Tokens (ADR 0017 taxonomy). The `--xr-bone-*` family styles an individual
 * Bone: `--xr-bone-color` (fill), `--xr-bone-highlight-color` (sheen),
 * `--xr-bone-border-radius` (+ `--xr-bone-text-border-radius` /
-* `--xr-bone-media-border-radius`), `--xr-bone-animation-duration`, the pulse
+* `--xr-bone-text-block-border-radius` / `--xr-bone-media-border-radius`),
+* `--xr-bone-animation-duration`, the pulse
 * range `--xr-bone-pulse-opacity-min`/`--xr-bone-pulse-opacity-max`,
 * `--xr-bone-animation` (mode: `xr-pulse` | `none` | a custom keyframe), and
 * `--xr-bone-fill` (override the leaf paint, e.g. a sheen gradient built from the
@@ -83,9 +84,12 @@ const BASE_CSS = `
      Never transition opacity directly (the pulse animation owns it). */
   opacity: calc(var(--xr-o) * var(--xr-reveal));
 }
-/* Per-kind defaults: text reads as rounded bars, media as blocks. Re-theme any
-   kind via [data-xr-root] .${LEAF_CLASS}-text { ... }. */
+/* Per-kind defaults: a single text LINE reads as a rounded bar; a multi-line
+   text BLOCK as a soft rect (a tall pill misreads as a button); media carries
+   the author radius, defaulting to the same soft rect. Re-theme any kind via
+   [data-xr-root] .${LEAF_CLASS}-text { ... }. */
 .${LEAF_CLASS}-text { border-radius: var(--xr-bone-text-border-radius, 999px) }
+.${LEAF_CLASS}-text-block { border-radius: var(--xr-bone-text-block-border-radius, var(--xr-bone-border-radius, 4px)) }
 .${LEAF_CLASS}-media { border-radius: var(--xr-bone-media-border-radius, var(--xr-bone-border-radius, 4px)) }
 @keyframes xr-pulse {
   from { --xr-o: var(--xr-bone-pulse-opacity-max, 1) }
@@ -142,7 +146,7 @@ const BASE_CSS = `
 /** The (unserialized) plate an import resolves to before anything has been captured. */
 function emptyPlate(name) {
 	return {
-		v: 1,
+		v: 2,
 		name,
 		tree: null,
 		css: ""