@certrev/cert-block 2.0.2 → 2.1.0

package/src/components/render-def.ts

@@ -141,6 +141,30 @@ export const COMPENSATED_EXPERT_CUE = 'Compensated expert'
 export const CERT_SCOPE_LINE =
 	'Independent editorial review of this article’s text and sources. Not a product endorsement, nor medical advice.'
 
+/**
+ * 2.1.0: the scope line for an article whose review covered its TEXT only (no references or sources section). Byte-verbatim
+ * copy of the portal's `FTC_DISCLOSURE_LINE_TEXT_ONLY` (`src/lib/embed/ftc-disclosure.ts`; Owen, Console decision
+ * af5b0db5, 2026-10-30: the review line says what the expert actually reviewed). Same curly apostrophe, same contract
+ * status as `CERT_SCOPE_LINE`: never re-word here.
+ */
+export const CERT_SCOPE_LINE_TEXT_ONLY =
+	'Independent editorial review of this article’s text. Not a product endorsement, nor medical advice.'
+
+/**
+ * 2.1.0: what the review covered, the portal's signed `content.expert.reviewScope`. ABSENT means `text_and_sources`: every
+ * envelope signed before the field existed prints exactly as 2.0.2 printed it.
+ */
+export type CertReviewScope = 'text' | 'text_and_sources'
+
+/**
+ * The scope line for a review scope, the ONE rule every face of this package prints by: only an exact `'text'` is the
+ * text-only line; anything else (absent, null, `'text_and_sources'`, a value this version has never heard of) is the full
+ * `CERT_SCOPE_LINE`. The portal's `scopeLineFor` decides the same way.
+ */
+export function certScopeLineFor(reviewScope: unknown): typeof CERT_SCOPE_LINE | typeof CERT_SCOPE_LINE_TEXT_ONLY {
+	return reviewScope === 'text' ? CERT_SCOPE_LINE_TEXT_ONLY : CERT_SCOPE_LINE
+}
+
 /**
  * The delivered display-string EDITION, stamped as `data-certrev-strings-version`
  * so the crawl monitor can assert which verbatim strings a live face should carry.

package/src/modal/cert-modal-view.ts

@@ -29,7 +29,7 @@
 
 import { asText, escapeHtml } from './escape.js'
 import { resizeAvatarUrl } from './avatar-resize.js'
-import { CERT_SCOPE_LINE, formatCertDisplayDate } from './display-strings.js'
+import { formatCertDisplayDate, scopeLineForReview } from './display-strings.js'
 import { checkIcon, chevronMark, verifiedStamp } from './certrev-cert-modal.styles.js'
 
 export interface CertModalCredential {
@@ -48,6 +48,9 @@ export interface CertModalExpert {
 	/** The pre-composed material-connection label ('Compensated expert') or null/absent for
 	 *  a pro-bono reviewer. Present → the disclosure footer renders the label; null/absent → label omitted. */
 	compensationCue?: string | null
+	/** 2.1.0: what the review covered (`'text'` | `'text_and_sources'`, absent = text and sources). Picks the locked
+	 *  scope line the footer prints, never its words. */
+	reviewScope?: string | null
 }
 
 /** The subset of the signed `payload.content` the modals read (structural). */
@@ -171,12 +174,13 @@ function certifiedChip(cls: string): string {
  * (`expert.compensationCue`, a FINISHED string off the signed envelope) leads ONLY when the reviewer
  * was compensated; a pro-bono reviewer (null/absent cue) drops the label but keeps the scope line —
  * which makes no compensation claim, so it is true for volunteers too and renders unconditionally.
- * The scope line is the verbatim FTC copy (`CERT_SCOPE_LINE`), never re-assembled here.
+ * The scope line is the verbatim FTC copy (`CERT_SCOPE_LINE`, or 2.1.0's `CERT_SCOPE_LINE_TEXT_ONLY` when the signed
+ * `expert.reviewScope` is `'text'`), never re-assembled here.
  */
 function disclosureFooter(expert: CertModalExpert | null | undefined): string {
 	const cue = asText(expert?.compensationCue).trim()
 	const cueHtml = cue ? `<span class="crm-disclosure__cue">${escapeHtml(cue)}</span> ` : ''
-	return `<div class="crm-disclosure">${cueHtml}${escapeHtml(CERT_SCOPE_LINE)}</div>`
+	return `<div class="crm-disclosure">${cueHtml}${escapeHtml(scopeLineForReview(expert?.reviewScope))}</div>`
 }
 
 /**

package/src/modal/display-strings.ts

@@ -14,7 +14,7 @@
  * never legitimately carry renders nothing (see `formatCertDisplayDate`).
  */
 
-import { FTC_DISCLOSURE_LINE } from "./ftc-disclosure.js";
+import { FTC_DISCLOSURE_LINE, FTC_DISCLOSURE_LINE_TEXT_ONLY } from "./ftc-disclosure.js";
 
 /** The compensation cue (guide "line A"), byte-verbatim from portal `COMPENSATED_EXPERT_CUE`. */
 export const COMPENSATED_EXPERT_CUE = "Compensated expert";
@@ -22,6 +22,19 @@ export const COMPENSATED_EXPERT_CUE = "Compensated expert";
 /** The FTC scope disclaimer, re-exported from the FTC SoT (portal `CERT_SCOPE_LINE = FTC_DISCLOSURE_LINE`). */
 export const CERT_SCOPE_LINE = FTC_DISCLOSURE_LINE;
 
+/** 2.1.0: the text-only scope line (portal `FTC_DISCLOSURE_LINE_TEXT_ONLY`), for a review that covered the text only. */
+export const CERT_SCOPE_LINE_TEXT_ONLY = FTC_DISCLOSURE_LINE_TEXT_ONLY;
+
+/**
+ * 2.1.0: the scope line for the signed `content.expert.reviewScope`. Only an exact `"text"` is the text-only line; absent,
+ * null, `"text_and_sources"` or any other value is `CERT_SCOPE_LINE`, as 2.0.2 printed it. The same rule as
+ * `certScopeLineFor` in `../components/render-def.ts`, repeated because `src/modal/` imports nothing from `src/components/`
+ * (it is bundled standalone into `certrev-cert.js`).
+ */
+export function scopeLineForReview(reviewScope: unknown): typeof CERT_SCOPE_LINE | typeof CERT_SCOPE_LINE_TEXT_ONLY {
+	return reviewScope === "text" ? CERT_SCOPE_LINE_TEXT_ONLY : CERT_SCOPE_LINE;
+}
+
 /**
  * Format a timestamp the way every cert byline renders dates ("Jun 14, 2026", en-US short month,
  * UTC-pinned). Null for an unparseable input — callers treat that as "no date, no byline".

package/src/modal/ftc-disclosure.ts

@@ -15,3 +15,11 @@
 
 export const FTC_DISCLOSURE_LINE =
 	"Independent editorial review of this article’s text and sources. Not a product endorsement, nor medical advice." as const;
+
+/**
+ * 2.1.0: the line for an article whose review covered its TEXT only (no references or sources section): a byte-faithful
+ * copy of the portal's `FTC_DISCLOSURE_LINE_TEXT_ONLY` (Owen, Console decision af5b0db5). Same contract status and curly
+ * apostrophe as `FTC_DISCLOSURE_LINE`.
+ */
+export const FTC_DISCLOSURE_LINE_TEXT_ONLY =
+	"Independent editorial review of this article’s text. Not a product endorsement, nor medical advice." as const;

package/src/reader/render.ts

@@ -49,7 +49,7 @@
  */
 import { asText } from '../components/escape.js'
 import { CERTREV_LINK_REL } from '../components/rel.js'
-import { CERT_SCOPE_LINE, CERT_STRINGS_VERSION, COMPENSATED_EXPERT_CUE } from '../components/render-def.js'
+import { CERT_STRINGS_VERSION, COMPENSATED_EXPERT_CUE, certScopeLineFor } from '../components/render-def.js'
 import type { CertContent } from '../contract/kernel.js'
 import { readerFace } from './face.js'
 import {
@@ -115,6 +115,13 @@ interface Facts {
 	/** The joined credential labels, '' when there are none or the rung shows none (named, minimal). */
 	readonly creds: string
 	readonly hasCue: boolean
+	/**
+	 * The scope sentence, by the signed `expert.reviewScope` (2.1.0, `certScopeLineFor`: `'text'` is the text-only line,
+	 * anything else the full one). It is DIRECT text of the scope element (the demo's `<span class="dg-scope">`), which
+	 * carries the `data-ftc-line` marker itself: no inner span, so the element's `.certrev-r-scope em` cue and the sentence
+	 * are leaves of one element, as the demo paints them. The marker is on exactly one element per render, as before.
+	 */
+	readonly scope: string
 	readonly illus: boolean
 	/** Whether the memo is printed: there is one, and the rung is the memo rung. */
 	readonly hasMemo: boolean
@@ -161,6 +168,7 @@ function readFacts(input: ReaderFaceInput): Facts {
 		showPhoto,
 		creds: rung === 'named' || minimal ? '' : labels.join(', '),
 		hasCue,
+		scope: certScopeLineFor(expert.reviewScope),
 		illus: input.illustrative === true && !hasCue,
 		hasMemo: !isBlank(content.memo) && rung === 'memo',
 		toned: isTonedStyle(style),
@@ -209,13 +217,6 @@ function scopeLead(f: Facts): string {
 	return ''
 }
 
-/**
- * The scope sentence is DIRECT text of the scope element (the demo's `<span class="dg-scope">`), which carries the
- * `data-ftc-line` marker itself: no inner span, so the element's `.certrev-r-scope em` cue and the sentence are leaves of
- * one element, as the demo paints them. The marker is on exactly one element per render, as before.
- */
-const SCOPE = CERT_SCOPE_LINE
-
 /**
  * The muted credential line, empty when the reviewer has no displayed credential (so no "verified" claim prints).
  *
@@ -296,7 +297,7 @@ function bannerCard(f: Facts): string {
 	}
 
 	// POR-9317: the memo card carries the scope line when there is a memo; with none this card is the sole claim face.
-	const scope = scopeOn ? `<div class="certrev-r-scope" data-ftc-disclosure data-ftc-line>${SCOPE}</div>` : ''
+	const scope = scopeOn ? `<div class="certrev-r-scope" data-ftc-disclosure data-ftc-line>${f.scope}</div>` : ''
 
 	return (
 		`${sectionOpen(f, true, f.minimal ? 'Expert reviewed' : credentialAria(f))}\n  <div class="certrev-r-card">\n` +
@@ -324,7 +325,7 @@ function bannerMemo(f: Facts): string {
 		`        <blockquote>${esc(f.content.memo)}</blockquote>${links}</div>\n    </div>\n` +
 		'    <div class="certrev-r-rule"></div>\n    <div class="certrev-r-vfoot">\n' +
 		`      <span class="certrev-r-verified">${readerLogo('mono', 17, '')}Verified by <b>CertREV</b></span>\n` +
-		`      <span class="certrev-r-scope" data-ftc-disclosure data-ftc-line>${scopeLead(f)}${SCOPE}</span>\n    </div>\n  </div>\n</section>`
+		`      <span class="certrev-r-scope" data-ftc-disclosure data-ftc-line>${scopeLead(f)}${f.scope}</span>\n    </div>\n  </div>\n</section>`
 	)
 }
 
@@ -364,7 +365,7 @@ function sidebar(f: Facts): string {
 		`${open}<div class="certrev-r-side-body">\n      <div class="certrev-r-by">${avatar}<div>\n` +
 		`          <b>${esc(f.ename)}${f.creds !== '' ? `<!-- -->, <!-- -->${esc(f.creds)}` : ''}</b>${verifiedLine(f, false)}</div>\n      </div>` +
 		`${fold}${more}` +
-		`<div class="certrev-r-scope" data-ftc-disclosure data-ftc-line>${scopeLead(f)}${SCOPE}</div>\n    </div>` +
+		`<div class="certrev-r-scope" data-ftc-disclosure data-ftc-line>${scopeLead(f)}${f.scope}</div>\n    </div>` +
 		`${links}</div>\n</section>`
 	)
 }

package/src/webcomponent/render-badge-html.ts

@@ -22,9 +22,9 @@ import {
 } from '../components/format.js'
 import { CERTREV_LINK_REL } from '../components/rel.js'
 import {
-	CERT_SCOPE_LINE,
 	CERT_STRINGS_VERSION,
 	type CertRenderDef,
+	certScopeLineFor,
 	resolveRenderTheme,
 	themeCssVarDeclarations,
 } from '../components/render-def.js'
@@ -88,6 +88,8 @@ function attr(name: string, value: string | null | undefined): string {
 export function renderBadgeHtml(payload: CertPayload, opts: RenderBadgeOptions = {}): string {
 	const content: LooseContent = payload?.content ?? {}
 	const expert = content.expert ?? null
+	// 2.1.0: the locked scope line the signed `expert.reviewScope` picks ('text' is the text-only line).
+	const scopeLine = certScopeLineFor((expert as { readonly reviewScope?: unknown } | null)?.reviewScope)
 	const display = resolveDisplay(content.display ?? undefined, opts.accentColor, opts.renderDef)
 	const theme = resolveRenderTheme(opts.renderDef)
 	const style = badgeFace(opts.badgeStyle ?? display.badgeStyle)
@@ -155,14 +157,15 @@ export function renderBadgeHtml(payload: CertPayload, opts: RenderBadgeOptions =
 	// regardless of a render-def, matching the Shopify/WordPress engine fix. The
 	// cue's "expert" links to the reviewer profile; the whole cue tag-strips to the
 	// byte-verbatim COMPENSATED_EXPERT_CUE. The scope line is byte-verbatim
-	// CERT_SCOPE_LINE (its curly apostrophe U+2019 survives escapeHtml untouched).
+	// CERT_SCOPE_LINE (its curly apostrophe U+2019 survives escapeHtml untouched), or 2.1.0's CERT_SCOPE_LINE_TEXT_ONLY
+	// when the signed `expert.reviewScope` is 'text' (`certScopeLineFor`).
 	const cueInner = profileUrl
 		? `Compensated <a class="${C}__cue-link" href="${escapeAttribute(profileUrl)}" rel="${CERTREV_LINK_REL}">expert</a>`
 		: 'Compensated expert'
 	const disclosure =
 		`<div class="${C}__disclosure">` +
 		`<span class="${C}__compensated-cue">${cueInner}</span>` +
-		`<p class="${C}__ftc" data-ftc-disclosure><span data-ftc-line>${escapeHtml(CERT_SCOPE_LINE)}</span></p>` +
+		`<p class="${C}__ftc" data-ftc-disclosure><span data-ftc-line>${escapeHtml(scopeLine)}</span></p>` +
 		`</div>`
 
 	const verify = verifyUrl