@certrev/cert-block 0.2.0 → 0.5.0

package/dist/components/render-cert-block.d.ts

@@ -19,10 +19,23 @@
  * hooks on the ROOT element so the block is self-contained on a storefront that does
  * NOT define the guide's `:root` — the accent (`--ba`), its auto-contrast ink
  * (`--ba-fg`), the corner radius (`--br`), the body font (`--bf`) and surface
- * (`--surface`) come from the resolved theme; the navy trust tints + the fixed
- * label/serif/wordmark fonts are LOCKED literals (guide "the lock is legal, not
- * aesthetic"). A brand themes accent / font / corners / surface; the navy chrome ink
- * stays fixed.
+ * (`--surface`) come from the resolved theme; the fixed mono label font (`--font-mono`)
+ * is a LOCKED literal (guide "the lock is legal, not aesthetic"). Names, the memo quote,
+ * disclosures, links, and the "CertREV" wordmark ride the body font; the serif/grotesk
+ * slots remain reachable only as a brand's themeable body-font choice.
+ *
+ * V2 BRAND-INK (Phase 1, parity with the portal Liquid/CSS engines): a brand may lift TWO
+ * more chrome surfaces off their hardcoded navy literals — the header/seal bar (`barInk`,
+ * with its auto-contrast `barInkFg`) and the FREE-content trust ink (`inkColor`: reviewer/
+ * author names, title, credential, bio, initials + the derived muted scale). These reach
+ * the root as the exact `--certrev-bar-bg` / `--certrev-bar-fg` / `--certrev-ink` wire vars
+ * the Shopify/WordPress engines emit — but ONLY when the def sets them, so a no-def face is
+ * byte-identical. The bar consumes `var(--certrev-bar-bg, #0a1b3f)` / `var(--certrev-bar-fg,
+ * #fff)`; the free content consumes the `--cr-ink` family (`--cr-ink` = `var(--certrev-ink,
+ * #0a1b3f)`, with `-sub`/`-soft` muted derivations). The LOCKED trust text — the compensation
+ * cue, the FTC scope line, "Credential verified by CertREV", the WRITTEN/REVIEWED BY labels,
+ * and the certified date — NEVER follows `inkColor`; it stays on the navy `--navy*` scale so a
+ * brand ink can never drag legally load-bearing text below its floor.
  *
  * COMPLIANCE (LOCKED, non-negotiable): the three material disclosures always render
  * on a CLAIM face (banner + sidebar) — the compensation cue, the byte-exact FTC
@@ -35,10 +48,27 @@
  * interpolated value is escaped — `escapeHtml` for content, `escapeAttribute` for
  * attribute values, `safeHttpUrl` for hrefs. Theme tokens are re-validated
  * (`resolveBlockTheme`) and only ever emitted as strict hex / length / enum-stack.
+ *
+ * PLACED-FIELDS STRICTNESS (WS-B): Visibility is decided by the engine's
+ * `placedFields` alone; `rung` is a stamp, never a branch; an absent face
+ * grandfathers the 0.3.0 full-facts render byte-for-byte.
  */
 import { type ResolvedBlockTheme } from './render-def.js';
 /** The three LOCKED placement faces. */
 export type CertBlockMode = 'banner' | 'sidebar' | 'floating';
+/** All layouts renderCertBlock can paint: the three locked modes + the engine's free-composition face. */
+export type CertBlockLayout = CertBlockMode | 'custom';
+/**
+ * The portal engine's resolved face (assertCompliantRender output). `rung` is
+ * INFORMATIONAL ONLY — stamped as data, NEVER branched on for visibility.
+ * `placedFields` is the single source of what renders. Plain strings (not a closed
+ * union) so a future engine field id degrades to "not painted here" instead of a
+ * type break.
+ */
+export interface CertBlockFace {
+    readonly rung: string;
+    readonly placedFields: readonly string[];
+}
 /**
  * The cert facts + LOCKED display strings a face renders. Facts are escaped; the
  * three locked strings (`compensationCue`, `scopeLine`, `credentialLine`) are
@@ -75,10 +105,25 @@ export interface CertBlockFacts {
 }
 /** The full input to `renderCertBlock`. */
 export interface RenderCertBlockInput {
-    readonly mode: CertBlockMode;
+    readonly mode: CertBlockLayout;
     /** RESOLVED theme tokens (the portal bakes these). Absent/invalid tokens fall back to navy. */
     readonly theme?: Partial<ResolvedBlockTheme>;
     readonly facts: CertBlockFacts;
+    /**
+     * OPTIONAL engine face. ABSENT ⇒ grandfathered full-facts render, byte-identical
+     * to 0.3.0 (published callers unaffected). PRESENT ⇒ strict placedFields render.
+     */
+    readonly face?: CertBlockFace;
+    /**
+     * BANNER memo placement (POR-10741 — first-class split, retires the CertReviewCard
+     * string-hack). Default `'full'` = header card + memo card in ONE root, BYTE-IDENTICAL
+     * to prior behavior. `'header'` / `'memo'` render ONLY that card in its own themed root,
+     * so a headless exporter can place the memo as its OWN block under the article body
+     * (the "banner → body → memo" layout) WITHOUT string-splitting the rendered HTML — and
+     * without duplicating the options payload (each block carries only what its card needs).
+     * Ignored outside banner mode.
+     */
+    readonly part?: 'full' | 'header' | 'memo';
 }
 /**
  * Render the LOCKED CertREV cert design as an SSR-safe HTML string for one of the

package/dist/components/render-cert-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render-cert-block.d.ts","sourceRoot":"","sources":["../../src/components/render-cert-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,OAAO,EAMN,KAAK,kBAAkB,EAEvB,MAAM,iBAAiB,CAAA;AAExB,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oFAAoF;IACpF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;IAC5B,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC5C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAC9B;AAmSD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAWnE"}
+{"version":3,"file":"render-cert-block.d.ts","sourceRoot":"","sources":["../../src/components/render-cert-block.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAIH,OAAO,EAMN,KAAK,kBAAkB,EAEvB,MAAM,iBAAiB,CAAA;AAExB,wCAAwC;AACxC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;AAE7D,0GAA0G;AAC1G,MAAM,MAAM,eAAe,GAAG,aAAa,GAAG,QAAQ,CAAA;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;CACxC;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,qFAAqF;IACrF,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,iFAAiF;IACjF,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAA;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,oFAAoF;IACpF,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAChC;AAED,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,+FAA+F;IAC/F,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAC5C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAA;IAC7B;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAA;CAC1C;AAkhBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA+BnE"}