brand-intent 0.10.0 → 0.12.0

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "brand-intent",
-  "version": "0.10.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",
   "repository": {
     "type": "git",
-    "url": "https://github.com/studiostoll/brand-intent.git"
+    "url": "git+https://github.com/studiostoll/brand-intent.git"
   },
   "homepage": "https://intent.stoll.studio",
   "bin": {
-    "brand-intent": "./cli/index.mjs"
+    "brand-intent": "cli/index.mjs"
   },
   "exports": {
     ".": {

package/parser/brandParser.ts

@@ -126,6 +126,8 @@ export interface ParsedAssetDef {
   /** Logos only: artwork per horizontal placement, declared via `align-left` / `align-center` / `align-right`
    *  sub-blocks. Consumers render the variant matching where the logo sits, else the base `src`. */
   alignVariants?: Partial<Record<LogoAlign, { src: string; aspectRatio?: number }>>;
+  /** Library group (e.g. "experimental"). Consumers list each group as its own section after the ungrouped assets. */
+  group?: string;
 }
 
 export type LogoAlign = 'left' | 'center' | 'right';
@@ -200,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']);
@@ -845,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;
@@ -1196,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;
@@ -1292,6 +1299,7 @@ export function parseBrandFile(content: string, fileName: string): ParsedBrand {
     if (raw.props['loop'] === 'true') def.loop = true;
     if (raw.props['gltf']) def.gltfSrc = raw.props['gltf'];
     if (raw.props['generator']) def.generator = raw.props['generator'];
+    if (raw.props['group']) def.group = raw.props['group'];
     // generator-params are stored as "generator-params.KEY" by the sub-block parser.
     const paramEntries: [string, number][] = [];
     for (const [k, v] of Object.entries(raw.props)) {

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';