@clossys/writer 0.3.9 → 0.5.0

package/dist/site-identity.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The site-identity copy kind: a site's name and tagline, resolved from a
+ * `CopyRegistry` under two reserved entry ids.
+ *
+ * A page-metadata consumer needs exactly two short strings — what the site
+ * is called and one line about it — and needs them to carry the same
+ * approval evidence as any other rendered copy. This module does not add a
+ * second approval path for them. It asks `resolveCopyRef` for
+ * `"site.name"` and `"site.tagline"`, so whatever that resolver refuses
+ * (a draft entry, an approval record that no longer matches its text, an
+ * expired delegate approval, a delegate approval on `"production"` without
+ * the caller's opt-in, a locale mismatch, an unknown id, an invalid
+ * registry or options object) is refused here for the same reason.
+ *
+ * On top of that resolver this module adds two refusals of its own,
+ * because a name and a tagline are literal text rather than templates: an
+ * entry that declares placeholders (or whose text the resolver would
+ * rewrite), and a resolved text that is blank after trimming.
+ *
+ * The result is all-or-nothing. Both fields are always attempted so a
+ * caller sees every problem at once, but `identity` and `resolutions` are
+ * present only when both fields resolved — there is no partial identity.
+ * Nothing here throws for any input; malformed input yields a result with
+ * `complete: false` and an issue. Nothing here reads a brand-facts record
+ * or consumes the result; wiring it into a page-metadata builder is a
+ * separate change.
+ *
+ * No real copy ships here. The ids are reserved names; the words are the
+ * consumer's own.
+ */
+import type { CopyResolveIssue, CopyResolveIssueReason, CopyResolveOptions } from "./resolve.js";
+import type { CopyRegistry, CopyResolution } from "./types.js";
+/** Reserved copy id for the site's name. */
+export declare const SITE_NAME_COPY_ID = "site.name";
+/** Reserved copy id for the site's tagline. */
+export declare const SITE_TAGLINE_COPY_ID = "site.tagline";
+/** Both reserved site-identity copy ids, name first. */
+export declare const SITE_IDENTITY_COPY_IDS: readonly ["site.name", "site.tagline"];
+/** Which half of the site identity an issue is about. */
+export type SiteIdentityField = "name" | "tagline";
+/**
+ * Every reason `resolveSiteIdentity` can report: whatever `resolveCopyRef`
+ * refuses, plus the two refusals specific to site identity.
+ * `"site-identity-blank"` means the resolved text was empty after trimming;
+ * `"site-identity-placeholder"` means the entry declares placeholders or
+ * its text is one the resolver would rewrite.
+ */
+export type SiteIdentityIssueReason = CopyResolveIssueReason | "site-identity-blank" | "site-identity-placeholder";
+/** One reason a site identity could not be resolved, tagged with its field. */
+export interface SiteIdentityIssue extends Omit<CopyResolveIssue, "reason"> {
+    reason: SiteIdentityIssueReason;
+    field: SiteIdentityField;
+}
+/**
+ * The outcome of `resolveSiteIdentity`. `identity` and `resolutions` are
+ * present only when `complete` is `true`; `issues` is empty exactly then.
+ */
+export interface SiteIdentityResolution {
+    complete: boolean;
+    identity?: {
+        name: string;
+        tagline: string;
+    };
+    resolutions?: {
+        name: CopyResolution;
+        tagline: CopyResolution;
+    };
+    issues: SiteIdentityIssue[];
+}
+/** `CopyResolveOptions` plus the requested locale, which is a ref field for the underlying resolver. */
+export type SiteIdentityOptions = CopyResolveOptions & {
+    locale?: string;
+};
+/**
+ * Resolves the site's name and tagline from `registry`, under
+ * `"site.name"` and `"site.tagline"`. Both are attempted on every call and
+ * every issue is reported, tagged with its `field`; `identity` and
+ * `resolutions` are returned only when both resolved.
+ *
+ * `options` are `resolveCopyRef`'s (`target`, `acceptDelegateInProduction`,
+ * `now`) plus an optional `locale`, which is forwarded as the ref's locale
+ * rather than as an option. Malformed options (including a blank or
+ * non-string `locale`) produce an `"invalid-options"` issue per field. Pure
+ * apart from the clock read that `now` defaults to; the registry is not
+ * modified and no input makes this throw.
+ */
+export declare function resolveSiteIdentity(registry: CopyRegistry | unknown, options?: SiteIdentityOptions | unknown): SiteIdentityResolution;
+//# sourceMappingURL=site-identity.d.ts.map

package/dist/site-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-identity.d.ts","sourceRoot":"","sources":["../src/site-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,4CAA4C;AAC5C,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD,wDAAwD;AACxD,eAAO,MAAM,sBAAsB,wCAAqD,CAAC;AAEzF,yDAAyD;AACzD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,2BAA2B,CAAC;AAEnH,+EAA+E;AAC/E,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IACzE,MAAM,EAAE,uBAAuB,CAAC;IAChC,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,cAAc,CAAC;QAAC,OAAO,EAAE,cAAc,CAAA;KAAE,CAAC;IAChE,MAAM,EAAE,iBAAiB,EAAE,CAAC;CAC7B;AAED,wGAAwG;AACxG,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAc3E;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,GAAG,OAAO,EAChC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,GACtC,sBAAsB,CAmBxB"}

package/dist/site-identity.js

@@ -0,0 +1,82 @@
+/**
+ * The site-identity copy kind: a site's name and tagline, resolved from a
+ * `CopyRegistry` under two reserved entry ids.
+ *
+ * A page-metadata consumer needs exactly two short strings — what the site
+ * is called and one line about it — and needs them to carry the same
+ * approval evidence as any other rendered copy. This module does not add a
+ * second approval path for them. It asks `resolveCopyRef` for
+ * `"site.name"` and `"site.tagline"`, so whatever that resolver refuses
+ * (a draft entry, an approval record that no longer matches its text, an
+ * expired delegate approval, a delegate approval on `"production"` without
+ * the caller's opt-in, a locale mismatch, an unknown id, an invalid
+ * registry or options object) is refused here for the same reason.
+ *
+ * On top of that resolver this module adds two refusals of its own,
+ * because a name and a tagline are literal text rather than templates: an
+ * entry that declares placeholders (or whose text the resolver would
+ * rewrite), and a resolved text that is blank after trimming.
+ *
+ * The result is all-or-nothing. Both fields are always attempted so a
+ * caller sees every problem at once, but `identity` and `resolutions` are
+ * present only when both fields resolved — there is no partial identity.
+ * Nothing here throws for any input; malformed input yields a result with
+ * `complete: false` and an issue. Nothing here reads a brand-facts record
+ * or consumes the result; wiring it into a page-metadata builder is a
+ * separate change.
+ *
+ * No real copy ships here. The ids are reserved names; the words are the
+ * consumer's own.
+ */
+import { prepareOptions, resolveField } from "./field-options.js";
+/** Reserved copy id for the site's name. */
+export const SITE_NAME_COPY_ID = "site.name";
+/** Reserved copy id for the site's tagline. */
+export const SITE_TAGLINE_COPY_ID = "site.tagline";
+/** Both reserved site-identity copy ids, name first. */
+export const SITE_IDENTITY_COPY_IDS = [SITE_NAME_COPY_ID, SITE_TAGLINE_COPY_ID];
+const FIELDS = [
+    { field: "name", id: SITE_NAME_COPY_ID },
+    { field: "tagline", id: SITE_TAGLINE_COPY_ID },
+];
+const LABELS = {
+    optionsSubject: "Site identity",
+    entrySubject: (id) => `Site identity "${id}"`,
+    placeholderReason: "site-identity-placeholder",
+    blankReason: "site-identity-blank",
+};
+/**
+ * Resolves the site's name and tagline from `registry`, under
+ * `"site.name"` and `"site.tagline"`. Both are attempted on every call and
+ * every issue is reported, tagged with its `field`; `identity` and
+ * `resolutions` are returned only when both resolved.
+ *
+ * `options` are `resolveCopyRef`'s (`target`, `acceptDelegateInProduction`,
+ * `now`) plus an optional `locale`, which is forwarded as the ref's locale
+ * rather than as an option. Malformed options (including a blank or
+ * non-string `locale`) produce an `"invalid-options"` issue per field. Pure
+ * apart from the clock read that `now` defaults to; the registry is not
+ * modified and no input makes this throw.
+ */
+export function resolveSiteIdentity(registry, options) {
+    const prepared = prepareOptions(options);
+    const issues = [];
+    const resolved = {};
+    for (const { field, id } of FIELDS) {
+        const outcome = resolveField(registry, field, id, prepared, LABELS);
+        issues.push(...outcome.issues);
+        if (outcome.resolution)
+            resolved[field] = outcome.resolution;
+    }
+    const name = resolved.name;
+    const tagline = resolved.tagline;
+    if (issues.length > 0 || !name || !tagline)
+        return { complete: false, issues };
+    return {
+        complete: true,
+        identity: { name: name.text, tagline: tagline.text },
+        resolutions: { name, tagline },
+        issues: [],
+    };
+}
+//# sourceMappingURL=site-identity.js.map

package/dist/site-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-identity.js","sourceRoot":"","sources":["../src/site-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlE,4CAA4C;AAC5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE7C,+CAA+C;AAC/C,MAAM,CAAC,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAEnD,wDAAwD;AACxD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,iBAAiB,EAAE,oBAAoB,CAAU,CAAC;AAkCzF,MAAM,MAAM,GAAwD;IAClE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,EAAE;IACxC,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,oBAAoB,EAAE;CAC/C,CAAC;AAEF,MAAM,MAAM,GAAqE;IAC/E,cAAc,EAAE,eAAe;IAC/B,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,kBAAkB,EAAE,GAAG;IAC7C,iBAAiB,EAAE,2BAA2B;IAC9C,WAAW,EAAE,qBAAqB;CACnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgC,EAChC,OAAuC;IAEvC,MAAM,QAAQ,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAuD,EAAE,CAAC;IACxE,KAAK,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,MAAM,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpE,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,OAAO,CAAC,UAAU;YAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAC/D,CAAC;IAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC/E,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;QACpD,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;QAC9B,MAAM,EAAE,EAAE;KACX,CAAC;AACJ,CAAC"}

package/dist/treatment-word-budget.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Treatment-level word budgets for registry entries — display headings,
+ * eyebrows, button labels, and other short treatments that are not body
+ * measure. Pure gate: takes an already-validated `CopyRegistry`, never I/O.
+ */
+import type { CopyEntryId, CopyRegistry } from "./types.js";
+/** Known slot treatments with a default maximum word count when the entry omits `maxWords`. */
+export declare const DEFAULT_TREATMENT_WORD_BUDGETS: Readonly<Record<string, number>>;
+export type TreatmentWordBudgetRule = "word-budget-exceeded" | "unknown-treatment";
+export interface TreatmentWordBudgetFinding {
+    rule: TreatmentWordBudgetRule;
+    severity: "error";
+    entryId: CopyEntryId;
+    treatment: string;
+    maxWords: number;
+    actualWords: number;
+    message: string;
+}
+export interface TreatmentWordBudgetResult {
+    entriesChecked: number;
+    findings: TreatmentWordBudgetFinding[];
+}
+/** Counts words in resolved copy text (whitespace-separated tokens). */
+export declare function countCopyWords(text: string): number;
+/**
+ * Fails when an approved entry declares a `treatment` (or `maxWords`) and
+ * its `text` exceeds the applicable budget. Draft and retired entries are
+ * skipped — only copy that can resolve at render is measured.
+ */
+export declare function checkTreatmentWordBudgets(registry: CopyRegistry): TreatmentWordBudgetResult;
+//# sourceMappingURL=treatment-word-budget.d.ts.map

package/dist/treatment-word-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treatment-word-budget.d.ts","sourceRoot":"","sources":["../src/treatment-word-budget.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAC;AAE/E,+FAA+F;AAC/F,eAAO,MAAM,8BAA8B,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3E,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;AAEnF,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD;AAiBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,YAAY,GAAG,yBAAyB,CAwC3F"}

package/dist/treatment-word-budget.js

@@ -0,0 +1,80 @@
+/**
+ * Treatment-level word budgets for registry entries — display headings,
+ * eyebrows, button labels, and other short treatments that are not body
+ * measure. Pure gate: takes an already-validated `CopyRegistry`, never I/O.
+ */
+/** Known slot treatments with a default maximum word count when the entry omits `maxWords`. */
+export const DEFAULT_TREATMENT_WORD_BUDGETS = {
+    "display-heading": 12,
+    eyebrow: 8,
+    button: 6,
+};
+/** Counts words in resolved copy text (whitespace-separated tokens). */
+export function countCopyWords(text) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0)
+        return 0;
+    return trimmed.split(/\s+/u).length;
+}
+function budgetForEntry(entry) {
+    const treatment = entry.treatment;
+    if (typeof treatment !== "string" || treatment.trim().length === 0)
+        return undefined;
+    const normalized = treatment.trim();
+    if (entry.maxWords !== undefined) {
+        if (typeof entry.maxWords !== "number" || !Number.isFinite(entry.maxWords) || entry.maxWords < 1) {
+            return undefined;
+        }
+        return { treatment: normalized, maxWords: Math.floor(entry.maxWords) };
+    }
+    const defaultMax = DEFAULT_TREATMENT_WORD_BUDGETS[normalized];
+    if (defaultMax === undefined)
+        return undefined;
+    return { treatment: normalized, maxWords: defaultMax };
+}
+/**
+ * Fails when an approved entry declares a `treatment` (or `maxWords`) and
+ * its `text` exceeds the applicable budget. Draft and retired entries are
+ * skipped — only copy that can resolve at render is measured.
+ */
+export function checkTreatmentWordBudgets(registry) {
+    const findings = [];
+    let entriesChecked = 0;
+    for (const entry of registry.entries) {
+        if (entry.status !== "approved")
+            continue;
+        const budget = budgetForEntry(entry);
+        if (!budget) {
+            if (typeof entry.treatment === "string" && entry.treatment.trim().length > 0) {
+                const normalized = entry.treatment.trim();
+                if (entry.maxWords === undefined && DEFAULT_TREATMENT_WORD_BUDGETS[normalized] === undefined) {
+                    findings.push({
+                        rule: "unknown-treatment",
+                        severity: "error",
+                        entryId: entry.id,
+                        treatment: normalized,
+                        maxWords: 0,
+                        actualWords: countCopyWords(entry.text),
+                        message: `Entry "${entry.id}" declares treatment "${normalized}" with no maxWords and no built-in default — add maxWords or use a known treatment (${Object.keys(DEFAULT_TREATMENT_WORD_BUDGETS).join(", ")}).`,
+                    });
+                }
+            }
+            continue;
+        }
+        entriesChecked++;
+        const actualWords = countCopyWords(entry.text);
+        if (actualWords > budget.maxWords) {
+            findings.push({
+                rule: "word-budget-exceeded",
+                severity: "error",
+                entryId: entry.id,
+                treatment: budget.treatment,
+                maxWords: budget.maxWords,
+                actualWords,
+                message: `Entry "${entry.id}" (${budget.treatment}) has ${actualWords} word(s) but the budget is ${budget.maxWords}.`,
+            });
+        }
+    }
+    return { entriesChecked, findings };
+}
+//# sourceMappingURL=treatment-word-budget.js.map

package/dist/treatment-word-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"treatment-word-budget.js","sourceRoot":"","sources":["../src/treatment-word-budget.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -28,13 +28,15 @@
  * This file ships no example content of anyone's real copy. Every field
  * here is either required-and-generic or a structural placeholder —
  * filling in an actual product's actual sentences is a consumer's job.
- * See "The single most important constraint" in the README: this package
- * is to `@clossys/writer/voice` what `@example/ui` is to
- * `@example/ui/tokens` — a vocabulary layer over a contract layer,
- * never a source of real words. If a doc comment, a test fixture, or a
- * README example in this package ever reads like something a product
- * would actually show a user, that is a bug in this package, not a
- * feature of it.
+ * The one exemption is the shipped US English front-door defaults
+ * (`front-door.ts`, `FRONT_DOOR_COPY_EN`, and the README's "Front-door
+ * copy" section): a closed, reserved set of ids, owned by this package, whose
+ * words ship as data so every sign-in surface need not carry its own. Outside
+ * that set this package is to `@clossys/writer/voice` what `@example/ui` is
+ * to `@example/ui/tokens` — a vocabulary layer over a contract layer, never a
+ * source of real words. If a doc comment, a test fixture, or a README example
+ * outside the front-door set ever reads like something a product would
+ * actually show a user, that is a bug in this package, not a feature of it.
  */
 /**
  * A stable address for one `CopyEntry`, unique within its `CopyRecord`.
@@ -147,6 +149,17 @@ export interface CopyEntry {
      * same seam, one layer over).
      */
     factRef?: string;
+    /**
+     * Named slot treatment for word-budget governance — e.g. `display-heading`,
+     * `eyebrow`, `button`. When set on an approved registry entry, `writer-check`
+     * applies `maxWords` or the built-in default for that treatment.
+     */
+    treatment?: string;
+    /**
+     * Maximum word count for this entry's `text` when `treatment` is set.
+     * Overrides the built-in default table when present.
+     */
+    maxWords?: number;
 }
 /**
  * Content-derived provenance for one target-locale translation. Present only
@@ -190,6 +203,40 @@ export interface CopyTranslationProvenance {
     /** Opaque reviewer identifier, mirroring `translatedBy` — never a personal name. */
     reviewedBy?: string;
 }
+/** Who recorded an approval: the copy owner, or a delegate acting for them. */
+export type CopyApprover = "owner" | "delegate";
+/**
+ * The delegate an approval was recorded by, and the entry-id namespaces they
+ * may approve. `id` is an opaque identifier, never a personal name. Each
+ * `scope` item is a dot-separated namespace with no wildcard; an entry is in
+ * scope when its id equals an item or starts with `item + "."`.
+ */
+export interface CopyDelegateScope {
+    id: string;
+    scope: string[];
+}
+/**
+ * The recorded approval of one registry entry, written by
+ * `writer-check approve` rather than by hand. `textFingerprint` pins the
+ * approval to the exact text that was approved: once `text` changes, the
+ * record no longer matches and the resolver refuses the entry
+ * (`approval-stale`) until it is approved again.
+ */
+export interface CopyApproval {
+    approvedBy: CopyApprover;
+    /** ISO 8601 UTC timestamp of the approval. */
+    approvedAt: string;
+    /** `computeCopyFingerprint(entry.text)` at the moment of approval. */
+    textFingerprint: string;
+    /** The algorithm `textFingerprint` was computed with — `COPY_FINGERPRINT_ALGORITHM`. */
+    fingerprintAlgorithm: string;
+    /** Required when `approvedBy` is `"delegate"`; forbidden for `"owner"`. */
+    delegate?: CopyDelegateScope;
+    /** Required when `approvedBy` is `"delegate"`; forbidden for `"owner"`. */
+    pendingOwnerReview?: boolean;
+    /** Delegate records only: ISO 8601 UTC expiry, strictly after `approvedAt`. */
+    expiresAt?: string;
+}
 /** A `CopyEntry` that is eligible to participate in a rendered registry. */
 export interface CopyRegistryEntry extends CopyEntry {
     status: CopyEntryStatus;
@@ -206,6 +253,12 @@ export interface CopyRegistryEntry extends CopyEntry {
      * never collapsed into one signal.
      */
     translation?: CopyTranslationProvenance;
+    /**
+     * The approval record, present only on an `approved` entry that has one.
+     * Optional: an `approved` entry without a record keeps resolving exactly
+     * as it did before this field existed. See `CopyApproval`.
+     */
+    approval?: CopyApproval;
 }
 /**
  * One consumer's complete, registered set of copy entries. This is the
@@ -229,6 +282,20 @@ export interface CopyRegistry extends CopyRecord {
     source: CopySource;
     entries: CopyRegistryEntry[];
 }
+/** The approval facts a resolution carries (`CopyResolution.approval`). */
+export type CopyResolutionApproval = {
+    approvedBy: "owner";
+    pendingOwnerReview: false;
+} | {
+    approvedBy: "delegate";
+    pendingOwnerReview: boolean;
+    /**
+     * Present only when this delegate-approved entry resolved on "production"
+     * because the `approvalPlan` authorized it: that plan's canonical digest.
+     * Absent when `acceptDelegateInProduction` authorized it, and on "preview".
+     */
+    authorizingPlanDigest?: string;
+};
 /** A successful, fully traced resolution of one copy reference. */
 export interface CopyResolution {
     ref: CopyRef;
@@ -238,6 +305,8 @@ export interface CopyResolution {
     locale: CopyLocale;
     source: CopySource;
     entryId: CopyEntryId;
+    /** Present only when the resolved entry carries an approval record. */
+    approval?: CopyResolutionApproval;
 }
 /** Resolver shape for callers that need rendered audience text. */
 export type CopyResolver = (ref: CopyRef) => CopyResolution | undefined;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAMH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAMjC;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,4EAA4E;AAC5E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,WAAW,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;CAC9C;AAED,8EAA8E;AAC9E,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AAE/D;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,wFAAwF;IACxF,EAAE,EAAE,WAAW,CAAC;IAChB,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;;OAMG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;;;;;OAMG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,MAAM,EAAE,eAAe,CAAC;IACxB;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,EAAE,yBAAyB,CAAC;CACzC;AAMD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAa,SAAQ,UAAU;IAC9C,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,UAAU,CAAC;IACnB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,cAAc,GAAG,SAAS,CAAC;AAMxE;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,WAAW;IAC1B,uHAAuH;IACvH,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,oHAAoH;IACpH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -28,13 +28,15 @@
  * This file ships no example content of anyone's real copy. Every field
  * here is either required-and-generic or a structural placeholder —
  * filling in an actual product's actual sentences is a consumer's job.
- * See "The single most important constraint" in the README: this package
- * is to `@clossys/writer/voice` what `@example/ui` is to
- * `@example/ui/tokens` — a vocabulary layer over a contract layer,
- * never a source of real words. If a doc comment, a test fixture, or a
- * README example in this package ever reads like something a product
- * would actually show a user, that is a bug in this package, not a
- * feature of it.
+ * The one exemption is the shipped US English front-door defaults
+ * (`front-door.ts`, `FRONT_DOOR_COPY_EN`, and the README's "Front-door
+ * copy" section): a closed, reserved set of ids, owned by this package, whose
+ * words ship as data so every sign-in surface need not carry its own. Outside
+ * that set this package is to `@clossys/writer/voice` what `@example/ui` is
+ * to `@example/ui/tokens` — a vocabulary layer over a contract layer, never a
+ * source of real words. If a doc comment, a test fixture, or a README example
+ * outside the front-door set ever reads like something a product would
+ * actually show a user, that is a bug in this package, not a feature of it.
  */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG"}

package/fit-signals.json

@@ -0,0 +1,11 @@
+{
+  "schemaVersion": 1,
+  "role": "@clossys/writer",
+  "signals": [
+    {
+      "id": "ships-audience-facing-copy",
+      "prompt": "The repository ships text a person outside the team reads: interface strings, page copy, or other audience-facing prose in its source.",
+      "evidenceKind": "repository-structure"
+    }
+  ]
+}