brand-intent 0.11.0 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brand-intent",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "An open file format specification for making brand intent machine-readable.",
   "author": "Christophe Stoll <christophe@stoll.studio>",
   "license": "MIT",

package/parser/brandParser.ts

@@ -202,7 +202,7 @@ export interface ParsedDividerDef {
 const GROUP_KEYWORDS = new Set<string>(['primary', 'secondary', 'accent', 'neutral']);
 const NEUTRAL_ROLES = new Set<NeutralRole>(['light', 'subtle', 'mid', 'muted', 'dark']);
 const STATE_KEYS = new Set<string>(['problem', 'warning', 'success', 'info', 'inactive']);
-const VALID_COLOR_MODES = new Set<ColorMode>(['static', 'dynamic', 'guided']);
+const VALID_COLOR_MODES = new Set<ColorMode>(['static', 'dynamic', 'guided', 'brand']);
 const VALID_STRATEGIES = new Set<PaletteStrategy>(['monochrome', 'duotone', 'tricolor', 'spectrum']);
 const VALID_ADHERENCES = new Set<Adherence>(['strict', 'on-brand', 'flexible']);
 const TONE_CLASSES = new Set<ToneClass>(['light', 'mid', 'dark']);
@@ -847,7 +847,7 @@ export function parseBrandFile(content: string, fileName: string): ParsedBrand {
         break;
       case 'color-mode':
         if (!VALID_COLOR_MODES.has(value as ColorMode)) {
-          throw new Error(`${fileName}:${lineNum}: color-mode must be "static", "dynamic", or "guided", got "${value}"`);
+          throw new Error(`${fileName}:${lineNum}: color-mode must be "static", "dynamic", "guided", or "brand", got "${value}"`);
         }
         result.colorMode = value as ColorMode;
         break;
@@ -1198,6 +1198,11 @@ export function parseBrandFile(content: string, fileName: string): ParsedBrand {
     }
   }
 
+  // color-mode: brand starts pages from a declared theme, so it needs at least one.
+  if (result.colorMode === 'brand' && Object.keys(themes).length === 0) {
+    throw new Error(`${fileName}: color-mode: brand requires at least one theme (a theme block or a valid color-families pair)`);
+  }
+
   if (Object.keys(themes).length > 0) {
     result.themes = themes;
     result.themeDescriptions = themeDescriptions;

package/parser/types.ts

@@ -19,7 +19,7 @@ export type TextAlign = 'left' | 'center' | 'right' | 'justify';
 // ── Guided colors (v0.8.0) ────────────────────────────────────────────────────
 
 /** Color resolution mode declared at the brand level. */
-export type ColorMode = 'static' | 'dynamic' | 'guided';
+export type ColorMode = 'static' | 'dynamic' | 'guided' | 'brand';
 
 /** Palette construction strategy for guided shuffle (Path A only). */
 export type PaletteStrategy = 'monochrome' | 'duotone' | 'tricolor' | 'spectrum';