@loworbitstudio/visor-theme-engine 0.16.0 → 0.17.0

package/dist/adapters/index.d.ts

@@ -1,4 +1,4 @@
-import { k as GeneratedPrimitives, r as SemanticTokens, R as ResolvedThemeConfig } from '../types-BstIS9rL.js';
+import { k as GeneratedPrimitives, r as SemanticTokens, R as ResolvedThemeConfig } from '../types-DqsWwFVZ.js';
 
 /**
  * Adapter types for the Visor theme engine.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, c as VisorBrand, B as BrandSlot, d as BrandSource, e as BrandResolution, f as ThemeBrandResult, g as BrandStrategy, h as BrandStrategyContext, i as BrandStrategyIssue, j as BrandStrategyValidationResult, S as SerializedBrandStrategy, R as ResolvedThemeConfig, k as GeneratedPrimitives, l as ThemeOutput, m as ThemeData, n as VisorThemeConfig, o as FullShadeScale, C as ColorRole, p as SelectiveShadeScale, q as RGB, P as ParsedColor, O as OKLCH, r as SemanticTokens, s as ShadeStep } from './types-BstIS9rL.js';
-export { t as BRAND_VARIANTS, u as BRAND_VISIBILITIES, v as BrandArchetype, w as BrandGoverns, x as BrandLexiconEntry, y as BrandPersonalityTrait, z as BrandPillar, A as BrandPositioning, D as BrandStrategyIssueSeverity, E as BrandToneEntry, H as BrandVariant, I as BrandVisibility, J as BrandVoice, K as BrandVoiceTrait, L as ColorFormat, M as DEFAULT_BRAND_STRATEGY_SURFACES, N as DEFAULT_BRAND_STRATEGY_TONE_STATES, Q as FontSource, U as GOVERNS_WILDCARD, W as RGBA, X as SemanticTokenValue } from './types-BstIS9rL.js';
+import { F as FontResolveOptions, a as FontResolution, V as VisorTypography, b as FontDisplayStrategy, T as ThemeFontResult, G as GoogleFontEntry, c as VisorBrand, B as BrandSlot, d as BrandSource, e as BrandResolution, f as ThemeBrandResult, g as BrandStrategy, h as BrandStrategyContext, i as BrandStrategyIssue, j as BrandStrategyValidationResult, S as SerializedBrandStrategy, R as ResolvedThemeConfig, k as GeneratedPrimitives, l as ThemeOutput, m as ThemeData, n as VisorThemeConfig, o as FullShadeScale, C as ColorRole, p as SelectiveShadeScale, q as RGB, P as ParsedColor, O as OKLCH, r as SemanticTokens, s as ShadeStep } from './types-DqsWwFVZ.js';
+export { t as BRAND_VARIANTS, u as BRAND_VISIBILITIES, v as BrandAccessibility, w as BrandArchetype, x as BrandBoilerplate, y as BrandColorPairing, z as BrandColorUsage, A as BrandContrastTarget, D as BrandGoverns, E as BrandLexiconEntry, H as BrandMessaging, I as BrandPersonalityTrait, J as BrandPillar, K as BrandPositioning, L as BrandStrategyIssueSeverity, M as BrandToneEntry, N as BrandVariant, Q as BrandVisibility, U as BrandVoice, W as BrandVoiceTrait, X as ColorFormat, Y as DEFAULT_BRAND_STRATEGY_SURFACES, Z as DEFAULT_BRAND_STRATEGY_TONE_STATES, _ as FontSource, $ as GOVERNS_WILDCARD, a0 as RGBA, a1 as SemanticTokenValue } from './types-DqsWwFVZ.js';
 
 /**
  * Font resolver — maps font family names to loadable font resources.
@@ -291,8 +291,11 @@ declare function validateBrandStrategy(block: unknown, ctx?: BrandStrategyContex
 /**
  * Serialize a validated brand strategy for the manifest. Returns `null` when
  * `visibility: private`. Optional fields (`archetype.secondary`,
- * `voice.traits[].example`, absent `governs` lists) are emitted only when
- * present, so the agent reads a clean, predictable object.
+ * `voice.traits[].example`, absent `governs` lists, the Phase 2 wave-1 fields
+ * `pillars[].proof` / `messaging` / `taglines` / `boilerplate` / `colorUsage` /
+ * `accessibility`) are emitted only when present, so the agent reads a clean,
+ * predictable object. The Phase 2 fields are all PUBLIC — a private record
+ * never reaches this point, so visibility is enforced once, up top (D4).
  */
 declare function serializeBrandStrategy(strategy: BrandStrategy): SerializedBrandStrategy | null;
 
@@ -856,6 +859,27 @@ var properties = {
 					"private"
 				],
 				description: "Client brands are private and are omitted from the public agent manifest."
+			},
+			messaging: {
+				$ref: "#/$defs/brandMessaging"
+			},
+			taglines: {
+				type: "array",
+				items: {
+					type: "string",
+					minLength: 1
+				},
+				minItems: 1,
+				description: "Phase 2 wave-1 (VI-541). Permanent, brand-level signature line(s) — who the brand is, not what it sells this quarter."
+			},
+			boilerplate: {
+				$ref: "#/$defs/brandBoilerplate"
+			},
+			colorUsage: {
+				$ref: "#/$defs/brandColorUsage"
+			},
+			accessibility: {
+				$ref: "#/$defs/brandAccessibility"
 			}
 		}
 	},
@@ -1208,6 +1232,15 @@ var $defs = {
 			},
 			governs: {
 				$ref: "#/$defs/brandGoverns"
+			},
+			proof: {
+				type: "array",
+				items: {
+					type: "string",
+					minLength: 1
+				},
+				minItems: 1,
+				description: "Phase 2 wave-1 (VI-541). Reasons-to-believe — checkable evidence backing this pillar's claim (the message-house foundation)."
 			}
 		}
 	},
@@ -1298,6 +1331,134 @@ var $defs = {
 				minLength: 1
 			}
 		}
+	},
+	brandMessaging: {
+		type: "object",
+		description: "Phase 2 wave-1 (VI-541). Message-house roof — the single umbrella message above the pillars.",
+		additionalProperties: false,
+		required: [
+			"roof"
+		],
+		properties: {
+			roof: {
+				type: "string",
+				minLength: 1,
+				description: "One overarching statement the pillars support."
+			}
+		}
+	},
+	brandBoilerplate: {
+		type: "object",
+		description: "Phase 2 wave-1 (VI-541). Reusable \"about us\" copy — short and long forms.",
+		additionalProperties: false,
+		required: [
+			"short",
+			"long"
+		],
+		properties: {
+			short: {
+				type: "string",
+				minLength: 1
+			},
+			long: {
+				type: "string",
+				minLength: 1
+			}
+		}
+	},
+	brandColorPairing: {
+		type: "object",
+		description: "A color-pairing rule expressed as brand intent (not a computed value).",
+		additionalProperties: false,
+		required: [
+			"use",
+			"with",
+			"rule"
+		],
+		properties: {
+			use: {
+				type: "string",
+				minLength: 1,
+				description: "The token or role being used (e.g. --primary)."
+			},
+			"with": {
+				type: "string",
+				minLength: 1,
+				description: "What it pairs against (token, role, or surface)."
+			},
+			rule: {
+				type: "string",
+				minLength: 1,
+				description: "The intent — when and how the pairing is allowed."
+			}
+		}
+	},
+	brandColorUsage: {
+		type: "object",
+		description: "Phase 2 wave-1 (VI-541). Color-usage intent — the brand's allowed pairings.",
+		additionalProperties: false,
+		required: [
+			"pairings"
+		],
+		properties: {
+			pairings: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/brandColorPairing"
+				},
+				minItems: 1
+			}
+		}
+	},
+	brandContrastTarget: {
+		type: "object",
+		description: "A contrast target expressed as brand intent (a WCAG 2.1 AA threshold).",
+		additionalProperties: false,
+		required: [
+			"context",
+			"ratio"
+		],
+		properties: {
+			context: {
+				type: "string",
+				minLength: 1,
+				description: "The text/UI context the target applies to."
+			},
+			ratio: {
+				type: "string",
+				minLength: 1,
+				description: "The minimum contrast ratio (e.g. \"4.5:1\")."
+			}
+		}
+	},
+	brandAccessibility: {
+		type: "object",
+		description: "Phase 2 wave-1 (VI-541). Accessibility intent — the standard and its contrast targets (authored as intent; live computation is the render surface's concern).",
+		additionalProperties: false,
+		required: [
+			"standard",
+			"contrast",
+			"intent"
+		],
+		properties: {
+			standard: {
+				type: "string",
+				minLength: 1,
+				description: "The conformance standard. Visor targets \"WCAG 2.1 AA\"."
+			},
+			contrast: {
+				type: "array",
+				items: {
+					$ref: "#/$defs/brandContrastTarget"
+				},
+				minItems: 1
+			},
+			intent: {
+				type: "string",
+				minLength: 1,
+				description: "How the brand applies the standard (intent, not computed results)."
+			}
+		}
 	}
 };
 var visorTheme_schema = {

package/dist/index.js

@@ -248,7 +248,13 @@ var TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
   "tone",
   "lexicon",
   "core",
-  "visibility"
+  "visibility",
+  // Phase 2 wave-1 (VI-541) — all optional.
+  "messaging",
+  "taglines",
+  "boilerplate",
+  "colorUsage",
+  "accessibility"
 ]);
 var GOVERNS_KEYS = /* @__PURE__ */ new Set(["tokens", "components", "surfaces"]);
 function checkBrandStrategyStructure(block) {
@@ -347,6 +353,64 @@ function checkBrandStrategyStructure(block) {
   if (!isNonEmptyString(block.visibility) || !BRAND_VISIBILITIES.includes(block.visibility)) {
     errors.push(error("BRAND_STRATEGY_VISIBILITY", `'brand-strategy.visibility' is required and must be one of: ${BRAND_VISIBILITIES.join(", ")}`, "brand-strategy.visibility"));
   }
+  errors.push(...checkPhase2Structure(block));
+  return errors;
+}
+function checkPhase2Structure(block) {
+  const errors = [];
+  if (block.messaging !== void 0) {
+    const messaging = block.messaging;
+    if (!isObject(messaging) || !isNonEmptyString(messaging.roof)) {
+      errors.push(error("BRAND_STRATEGY_MESSAGING", "'brand-strategy.messaging' must be an object with a non-empty 'roof' string", "brand-strategy.messaging"));
+    }
+  }
+  if (block.taglines !== void 0) {
+    if (!isStringArray(block.taglines) || block.taglines.length === 0) {
+      errors.push(error("BRAND_STRATEGY_TAGLINES", "'brand-strategy.taglines' must be a non-empty array of strings when present", "brand-strategy.taglines"));
+    } else if (!block.taglines.every(isNonEmptyString)) {
+      errors.push(error("BRAND_STRATEGY_TAGLINES", "'brand-strategy.taglines' entries must be non-empty strings", "brand-strategy.taglines"));
+    }
+  }
+  if (block.boilerplate !== void 0) {
+    const boilerplate = block.boilerplate;
+    if (!isObject(boilerplate) || !isNonEmptyString(boilerplate.short) || !isNonEmptyString(boilerplate.long)) {
+      errors.push(error("BRAND_STRATEGY_BOILERPLATE", "'brand-strategy.boilerplate' must be an object with non-empty 'short' and 'long' strings", "brand-strategy.boilerplate"));
+    }
+  }
+  if (block.colorUsage !== void 0) {
+    const colorUsage = block.colorUsage;
+    if (!isObject(colorUsage) || !Array.isArray(colorUsage.pairings) || colorUsage.pairings.length === 0) {
+      errors.push(error("BRAND_STRATEGY_COLOR_USAGE", "'brand-strategy.colorUsage' must be an object with a non-empty 'pairings' array", "brand-strategy.colorUsage"));
+    } else {
+      colorUsage.pairings.forEach((pairing, i) => {
+        if (!isObject(pairing) || !isNonEmptyString(pairing.use) || !isNonEmptyString(pairing.with) || !isNonEmptyString(pairing.rule)) {
+          errors.push(error("BRAND_STRATEGY_COLOR_USAGE", `'brand-strategy.colorUsage.pairings[${i}]' must have non-empty 'use', 'with', and 'rule' strings`, `brand-strategy.colorUsage.pairings[${i}]`));
+        }
+      });
+    }
+  }
+  if (block.accessibility !== void 0) {
+    const accessibility = block.accessibility;
+    if (!isObject(accessibility)) {
+      errors.push(error("BRAND_STRATEGY_ACCESSIBILITY", "'brand-strategy.accessibility' must be an object", "brand-strategy.accessibility"));
+    } else {
+      if (!isNonEmptyString(accessibility.standard)) {
+        errors.push(error("BRAND_STRATEGY_ACCESSIBILITY", "'brand-strategy.accessibility.standard' is required and must be a non-empty string", "brand-strategy.accessibility.standard"));
+      }
+      if (!isNonEmptyString(accessibility.intent)) {
+        errors.push(error("BRAND_STRATEGY_ACCESSIBILITY", "'brand-strategy.accessibility.intent' is required and must be a non-empty string", "brand-strategy.accessibility.intent"));
+      }
+      if (!Array.isArray(accessibility.contrast) || accessibility.contrast.length === 0) {
+        errors.push(error("BRAND_STRATEGY_ACCESSIBILITY", "'brand-strategy.accessibility.contrast' must be a non-empty array", "brand-strategy.accessibility.contrast"));
+      } else {
+        accessibility.contrast.forEach((target, i) => {
+          if (!isObject(target) || !isNonEmptyString(target.context) || !isNonEmptyString(target.ratio)) {
+            errors.push(error("BRAND_STRATEGY_ACCESSIBILITY", `'brand-strategy.accessibility.contrast[${i}]' must have non-empty 'context' and 'ratio' strings`, `brand-strategy.accessibility.contrast[${i}]`));
+          }
+        });
+      }
+    }
+  }
   return errors;
 }
 function checkPillarStructure(pillar, index) {
@@ -383,6 +447,13 @@ function checkPillarStructure(pillar, index) {
       errors.push(error("BRAND_STRATEGY_GOVERNS", `'${path}.governs' must declare at least one of: ${[...GOVERNS_KEYS].join(", ")}`, `${path}.governs`));
     }
   }
+  if (pillar.proof !== void 0) {
+    if (!isStringArray(pillar.proof) || pillar.proof.length === 0) {
+      errors.push(error("BRAND_STRATEGY_PROOF", `'${path}.proof' must be a non-empty array of strings when present`, `${path}.proof`));
+    } else if (!pillar.proof.every(isNonEmptyString)) {
+      errors.push(error("BRAND_STRATEGY_PROOF", `'${path}.proof' entries must be non-empty strings`, `${path}.proof`));
+    }
+  }
   return errors;
 }
 function checkBrandStrategyCoherence(strategy, ctx = {}) {
@@ -442,6 +513,15 @@ function compactGoverns(governs) {
   if (governs.surfaces) out.surfaces = [...governs.surfaces];
   return out;
 }
+function serializePillar(p) {
+  const pillar = {
+    id: p.id,
+    statement: p.statement,
+    governs: compactGoverns(p.governs)
+  };
+  if (p.proof !== void 0) pillar.proof = [...p.proof];
+  return pillar;
+}
 function serializeBrandStrategy(strategy) {
   if (strategy.visibility === "private") {
     return null;
@@ -453,7 +533,7 @@ function serializeBrandStrategy(strategy) {
   for (const [state, entry] of Object.entries(strategy.tone)) {
     tone[state] = { feeling: entry.feeling, example: entry.example };
   }
-  return {
+  const serialized = {
     positioning: {
       onliness: strategy.positioning.onliness,
       category: strategy.positioning.category,
@@ -462,11 +542,7 @@ function serializeBrandStrategy(strategy) {
     essence: [...strategy.essence],
     personality: strategy.personality.map((p) => ({ trait: p.trait, not: p.not })),
     archetype,
-    pillars: strategy.pillars.map((p) => ({
-      id: p.id,
-      statement: p.statement,
-      governs: compactGoverns(p.governs)
-    })),
+    pillars: strategy.pillars.map(serializePillar),
     voice: {
       traits: strategy.voice.traits.map((t) => {
         const trait = {
@@ -483,6 +559,38 @@ function serializeBrandStrategy(strategy) {
     core: [...strategy.core],
     visibility: strategy.visibility
   };
+  if (strategy.messaging !== void 0) {
+    serialized.messaging = { roof: strategy.messaging.roof };
+  }
+  if (strategy.taglines !== void 0) {
+    serialized.taglines = [...strategy.taglines];
+  }
+  if (strategy.boilerplate !== void 0) {
+    serialized.boilerplate = {
+      short: strategy.boilerplate.short,
+      long: strategy.boilerplate.long
+    };
+  }
+  if (strategy.colorUsage !== void 0) {
+    serialized.colorUsage = {
+      pairings: strategy.colorUsage.pairings.map((p) => ({
+        use: p.use,
+        with: p.with,
+        rule: p.rule
+      }))
+    };
+  }
+  if (strategy.accessibility !== void 0) {
+    serialized.accessibility = {
+      standard: strategy.accessibility.standard,
+      contrast: strategy.accessibility.contrast.map((c) => ({
+        context: c.context,
+        ratio: c.ratio
+      })),
+      intent: strategy.accessibility.intent
+    };
+  }
+  return serialized;
 }
 
 // src/pipeline.ts
@@ -834,7 +942,17 @@ var visor_theme_schema_default = {
           type: "string",
           enum: ["public", "private"],
           description: "Client brands are private and are omitted from the public agent manifest."
-        }
+        },
+        messaging: { $ref: "#/$defs/brandMessaging" },
+        taglines: {
+          type: "array",
+          items: { type: "string", minLength: 1 },
+          minItems: 1,
+          description: "Phase 2 wave-1 (VI-541). Permanent, brand-level signature line(s) \u2014 who the brand is, not what it sells this quarter."
+        },
+        boilerplate: { $ref: "#/$defs/brandBoilerplate" },
+        colorUsage: { $ref: "#/$defs/brandColorUsage" },
+        accessibility: { $ref: "#/$defs/brandAccessibility" }
       }
     },
     spacing: {
@@ -1056,7 +1174,13 @@ var visor_theme_schema_default = {
       properties: {
         id: { type: "string", minLength: 1 },
         statement: { type: "string", minLength: 1, description: "The pillar's claim in one line." },
-        governs: { $ref: "#/$defs/brandGoverns" }
+        governs: { $ref: "#/$defs/brandGoverns" },
+        proof: {
+          type: "array",
+          items: { type: "string", minLength: 1 },
+          minItems: 1,
+          description: "Phase 2 wave-1 (VI-541). Reasons-to-believe \u2014 checkable evidence backing this pillar's claim (the message-house foundation)."
+        }
       }
     },
     brandVoice: {
@@ -1099,6 +1223,66 @@ var visor_theme_schema_default = {
         use: { type: "string", minLength: 1 },
         avoid: { type: "string", minLength: 1 }
       }
+    },
+    brandMessaging: {
+      type: "object",
+      description: "Phase 2 wave-1 (VI-541). Message-house roof \u2014 the single umbrella message above the pillars.",
+      additionalProperties: false,
+      required: ["roof"],
+      properties: {
+        roof: { type: "string", minLength: 1, description: "One overarching statement the pillars support." }
+      }
+    },
+    brandBoilerplate: {
+      type: "object",
+      description: 'Phase 2 wave-1 (VI-541). Reusable "about us" copy \u2014 short and long forms.',
+      additionalProperties: false,
+      required: ["short", "long"],
+      properties: {
+        short: { type: "string", minLength: 1 },
+        long: { type: "string", minLength: 1 }
+      }
+    },
+    brandColorPairing: {
+      type: "object",
+      description: "A color-pairing rule expressed as brand intent (not a computed value).",
+      additionalProperties: false,
+      required: ["use", "with", "rule"],
+      properties: {
+        use: { type: "string", minLength: 1, description: "The token or role being used (e.g. --primary)." },
+        with: { type: "string", minLength: 1, description: "What it pairs against (token, role, or surface)." },
+        rule: { type: "string", minLength: 1, description: "The intent \u2014 when and how the pairing is allowed." }
+      }
+    },
+    brandColorUsage: {
+      type: "object",
+      description: "Phase 2 wave-1 (VI-541). Color-usage intent \u2014 the brand's allowed pairings.",
+      additionalProperties: false,
+      required: ["pairings"],
+      properties: {
+        pairings: { type: "array", items: { $ref: "#/$defs/brandColorPairing" }, minItems: 1 }
+      }
+    },
+    brandContrastTarget: {
+      type: "object",
+      description: "A contrast target expressed as brand intent (a WCAG 2.1 AA threshold).",
+      additionalProperties: false,
+      required: ["context", "ratio"],
+      properties: {
+        context: { type: "string", minLength: 1, description: "The text/UI context the target applies to." },
+        ratio: { type: "string", minLength: 1, description: 'The minimum contrast ratio (e.g. "4.5:1").' }
+      }
+    },
+    brandAccessibility: {
+      type: "object",
+      description: "Phase 2 wave-1 (VI-541). Accessibility intent \u2014 the standard and its contrast targets (authored as intent; live computation is the render surface's concern).",
+      additionalProperties: false,
+      required: ["standard", "contrast", "intent"],
+      properties: {
+        standard: { type: "string", minLength: 1, description: 'The conformance standard. Visor targets "WCAG 2.1 AA".' },
+        contrast: { type: "array", items: { $ref: "#/$defs/brandContrastTarget" }, minItems: 1 },
+        intent: { type: "string", minLength: 1, description: "How the brand applies the standard (intent, not computed results)." }
+      }
     }
   }
 };

package/dist/{types-BstIS9rL.d.ts → types-DqsWwFVZ.d.ts}

@@ -291,6 +291,12 @@ interface BrandPillar {
     statement: string;
     /** What the pillar governs (coherence-checked against the live system). */
     governs: BrandGoverns;
+    /**
+     * Reasons-to-believe — the message-house foundation (VI-541, Phase 2 wave-1).
+     * Concrete, checkable evidence backing this pillar's claim. Optional so a
+     * record can carry pillars without proof points.
+     */
+    proof?: string[];
 }
 /** A fixed voice trait with a worked example. */
 interface BrandVoiceTrait {
@@ -319,15 +325,56 @@ interface BrandLexiconEntry {
     use: string;
     avoid: string;
 }
+/** Message-house roof — the single umbrella message above the pillars. */
+interface BrandMessaging {
+    /** One overarching statement the pillars support (message-house roof). */
+    roof: string;
+}
+/** Reusable "about us" copy — short and long forms. */
+interface BrandBoilerplate {
+    short: string;
+    long: string;
+}
+/** A color-pairing rule expressed as brand intent (not a computed value). */
+interface BrandColorPairing {
+    /** The token or role being used (e.g. `--primary`). */
+    use: string;
+    /** What it pairs against (token, role, or surface). */
+    with: string;
+    /** The intent — when and how the pairing is allowed. */
+    rule: string;
+}
+/** Color-usage intent — the brand's allowed pairings. */
+interface BrandColorUsage {
+    pairings: BrandColorPairing[];
+}
+/** A contrast target expressed as brand intent (a WCAG 2.1 AA threshold). */
+interface BrandContrastTarget {
+    /** The text/UI context the target applies to. */
+    context: string;
+    /** The minimum contrast ratio (e.g. "4.5:1"). */
+    ratio: string;
+}
+/** Accessibility intent — the standard and its contrast targets. */
+interface BrandAccessibility {
+    /** The conformance standard. Visor targets "WCAG 2.1 AA". */
+    standard: string;
+    /** WCAG 2.1 AA contrast targets, authored as intent (live computation is the render surface's concern). */
+    contrast: BrandContrastTarget[];
+    /** How the brand applies the standard (intent, not computed results). */
+    intent: string;
+}
 /** Visibility of a brand strategy. Client brands are `private`. */
 type BrandVisibility = "public" | "private";
 /**
  * The `brand-strategy` block — strategy + verbal identity as data.
  *
  * `tone` is keyed by UI state (`error`, `success`, …); the keys are validated
- * against the recognized UI states (coherence check D2). All ten fields are
- * required in v1 — F1 authors the full record, and the downstream Workbench
- * surfaces render each section.
+ * against the recognized UI states (coherence check D2). The ten Phase 1 fields
+ * are required in v1 — F1 authors the full record, and the downstream Workbench
+ * surfaces render each section. The Phase 2 wave-1 fields (`messaging`,
+ * `taglines`, `boilerplate`, `colorUsage`, `accessibility`; VI-541) are optional
+ * so a record — e.g. a private client brand — can omit them.
  */
 interface BrandStrategy {
     positioning: BrandPositioning;
@@ -343,6 +390,16 @@ interface BrandStrategy {
     /** Aaker core/extended — the immutable subset, as section names. */
     core: string[];
     visibility: BrandVisibility;
+    /** Message-house roof — the umbrella message above the pillars. */
+    messaging?: BrandMessaging;
+    /** Permanent, brand-level signature line(s) — who the brand is, not what it sells this quarter. */
+    taglines?: string[];
+    /** Reusable "about us" copy — short and long forms. */
+    boilerplate?: BrandBoilerplate;
+    /** Color-usage intent — the brand's allowed pairings. */
+    colorUsage?: BrandColorUsage;
+    /** Accessibility intent — WCAG 2.1 AA standard + contrast targets. */
+    accessibility?: BrandAccessibility;
 }
 /**
  * The agent-facing projection of a brand strategy, embedded in
@@ -779,4 +836,4 @@ interface ThemeData {
     output: ThemeOutput;
 }
 
-export { type BrandPositioning as A, type BrandSlot as B, type ColorRole as C, type BrandStrategyIssueSeverity as D, type BrandToneEntry as E, type FontResolveOptions as F, type GoogleFontEntry as G, type BrandVariant as H, type BrandVisibility as I, type BrandVoice as J, type BrandVoiceTrait as K, type ColorFormat as L, DEFAULT_BRAND_STRATEGY_SURFACES as M, DEFAULT_BRAND_STRATEGY_TONE_STATES as N, type OKLCH as O, type ParsedColor as P, type FontSource as Q, type ResolvedThemeConfig as R, type SerializedBrandStrategy as S, type ThemeFontResult as T, GOVERNS_WILDCARD as U, type VisorTypography as V, type RGBA as W, type SemanticTokenValue as X, type FontResolution as a, type FontDisplayStrategy as b, type VisorBrand as c, type BrandSource as d, type BrandResolution as e, type ThemeBrandResult as f, type BrandStrategy as g, type BrandStrategyContext as h, type BrandStrategyIssue as i, type BrandStrategyValidationResult as j, type GeneratedPrimitives as k, type ThemeOutput as l, type ThemeData as m, type VisorThemeConfig as n, type FullShadeScale as o, type SelectiveShadeScale as p, type RGB as q, type SemanticTokens as r, type ShadeStep as s, BRAND_VARIANTS as t, BRAND_VISIBILITIES as u, type BrandArchetype as v, type BrandGoverns as w, type BrandLexiconEntry as x, type BrandPersonalityTrait as y, type BrandPillar as z };
+export { GOVERNS_WILDCARD as $, type BrandContrastTarget as A, type BrandSlot as B, type ColorRole as C, type BrandGoverns as D, type BrandLexiconEntry as E, type FontResolveOptions as F, type GoogleFontEntry as G, type BrandMessaging as H, type BrandPersonalityTrait as I, type BrandPillar as J, type BrandPositioning as K, type BrandStrategyIssueSeverity as L, type BrandToneEntry as M, type BrandVariant as N, type OKLCH as O, type ParsedColor as P, type BrandVisibility as Q, type ResolvedThemeConfig as R, type SerializedBrandStrategy as S, type ThemeFontResult as T, type BrandVoice as U, type VisorTypography as V, type BrandVoiceTrait as W, type ColorFormat as X, DEFAULT_BRAND_STRATEGY_SURFACES as Y, DEFAULT_BRAND_STRATEGY_TONE_STATES as Z, type FontSource as _, type FontResolution as a, type RGBA as a0, type SemanticTokenValue as a1, type FontDisplayStrategy as b, type VisorBrand as c, type BrandSource as d, type BrandResolution as e, type ThemeBrandResult as f, type BrandStrategy as g, type BrandStrategyContext as h, type BrandStrategyIssue as i, type BrandStrategyValidationResult as j, type GeneratedPrimitives as k, type ThemeOutput as l, type ThemeData as m, type VisorThemeConfig as n, type FullShadeScale as o, type SelectiveShadeScale as p, type RGB as q, type SemanticTokens as r, type ShadeStep as s, BRAND_VARIANTS as t, BRAND_VISIBILITIES as u, type BrandAccessibility as v, type BrandArchetype as w, type BrandBoilerplate as x, type BrandColorPairing as y, type BrandColorUsage as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loworbitstudio/visor-theme-engine",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Theme engine for the Visor design system — shade generation, token mapping, font resolution, and import/export for .visor.yaml themes.",
   "type": "module",
   "main": "./dist/index.js",

package/src/visor-theme.schema.json

@@ -343,7 +343,17 @@
           "type": "string",
           "enum": ["public", "private"],
           "description": "Client brands are private and are omitted from the public agent manifest."
-        }
+        },
+        "messaging": { "$ref": "#/$defs/brandMessaging" },
+        "taglines": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "minItems": 1,
+          "description": "Phase 2 wave-1 (VI-541). Permanent, brand-level signature line(s) — who the brand is, not what it sells this quarter."
+        },
+        "boilerplate": { "$ref": "#/$defs/brandBoilerplate" },
+        "colorUsage": { "$ref": "#/$defs/brandColorUsage" },
+        "accessibility": { "$ref": "#/$defs/brandAccessibility" }
       }
     },
     "spacing": {
@@ -565,7 +575,13 @@
       "properties": {
         "id": { "type": "string", "minLength": 1 },
         "statement": { "type": "string", "minLength": 1, "description": "The pillar's claim in one line." },
-        "governs": { "$ref": "#/$defs/brandGoverns" }
+        "governs": { "$ref": "#/$defs/brandGoverns" },
+        "proof": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 },
+          "minItems": 1,
+          "description": "Phase 2 wave-1 (VI-541). Reasons-to-believe — checkable evidence backing this pillar's claim (the message-house foundation)."
+        }
       }
     },
     "brandVoice": {
@@ -608,6 +624,66 @@
         "use": { "type": "string", "minLength": 1 },
         "avoid": { "type": "string", "minLength": 1 }
       }
+    },
+    "brandMessaging": {
+      "type": "object",
+      "description": "Phase 2 wave-1 (VI-541). Message-house roof — the single umbrella message above the pillars.",
+      "additionalProperties": false,
+      "required": ["roof"],
+      "properties": {
+        "roof": { "type": "string", "minLength": 1, "description": "One overarching statement the pillars support." }
+      }
+    },
+    "brandBoilerplate": {
+      "type": "object",
+      "description": "Phase 2 wave-1 (VI-541). Reusable \"about us\" copy — short and long forms.",
+      "additionalProperties": false,
+      "required": ["short", "long"],
+      "properties": {
+        "short": { "type": "string", "minLength": 1 },
+        "long": { "type": "string", "minLength": 1 }
+      }
+    },
+    "brandColorPairing": {
+      "type": "object",
+      "description": "A color-pairing rule expressed as brand intent (not a computed value).",
+      "additionalProperties": false,
+      "required": ["use", "with", "rule"],
+      "properties": {
+        "use": { "type": "string", "minLength": 1, "description": "The token or role being used (e.g. --primary)." },
+        "with": { "type": "string", "minLength": 1, "description": "What it pairs against (token, role, or surface)." },
+        "rule": { "type": "string", "minLength": 1, "description": "The intent — when and how the pairing is allowed." }
+      }
+    },
+    "brandColorUsage": {
+      "type": "object",
+      "description": "Phase 2 wave-1 (VI-541). Color-usage intent — the brand's allowed pairings.",
+      "additionalProperties": false,
+      "required": ["pairings"],
+      "properties": {
+        "pairings": { "type": "array", "items": { "$ref": "#/$defs/brandColorPairing" }, "minItems": 1 }
+      }
+    },
+    "brandContrastTarget": {
+      "type": "object",
+      "description": "A contrast target expressed as brand intent (a WCAG 2.1 AA threshold).",
+      "additionalProperties": false,
+      "required": ["context", "ratio"],
+      "properties": {
+        "context": { "type": "string", "minLength": 1, "description": "The text/UI context the target applies to." },
+        "ratio": { "type": "string", "minLength": 1, "description": "The minimum contrast ratio (e.g. \"4.5:1\")." }
+      }
+    },
+    "brandAccessibility": {
+      "type": "object",
+      "description": "Phase 2 wave-1 (VI-541). Accessibility intent — the standard and its contrast targets (authored as intent; live computation is the render surface's concern).",
+      "additionalProperties": false,
+      "required": ["standard", "contrast", "intent"],
+      "properties": {
+        "standard": { "type": "string", "minLength": 1, "description": "The conformance standard. Visor targets \"WCAG 2.1 AA\"." },
+        "contrast": { "type": "array", "items": { "$ref": "#/$defs/brandContrastTarget" }, "minItems": 1 },
+        "intent": { "type": "string", "minLength": 1, "description": "How the brand applies the standard (intent, not computed results)." }
+      }
     }
   }
 }