brand-intent 0.26.0 → 0.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brand-intent",
-  "version": "0.26.0",
+  "version": "0.28.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

@@ -57,20 +57,6 @@ export interface ParsedBrand {
   locale: string;
   /** Named font primitives: name → font definition. First entry is the brand default. */
   fonts?: Record<string, ParsedFontDef>;
-  /** Token source type: 'figma' | 'inline' */
-  tokensSource: 'figma' | 'inline';
-  /** Figma file key (only when tokensSource === 'figma') */
-  figmaFileKey?: string;
-  /** Figma collection name (only when tokensSource === 'figma') */
-  figmaCollection?: string;
-  /** Path to the runtime tokens file (relative to /src) */
-  tokensFile: string;
-  /** Path to app icon asset (relative to /public), used for PWA icon */
-  appIcon?: string;
-  /** Path to favicon asset (relative to /public), used for browser tab icon */
-  favicon?: string;
-  /** Path to OG image asset (relative to /public), used for social sharing previews */
-  ogImage?: string;
   /** Core brand color primitives: name → hex (e.g. primary, secondary, accent1, accent2, white).
    *  Always present when any colors are declared — grouped-syntax brands get a flat projection
    *  generated from all entries, so legacy consumers keep working unchanged. */
@@ -103,11 +89,11 @@ export interface ParsedBrand {
   themePairs?: Record<string, ThemePair>;
   /** Non-fatal color findings: rule violations, rejected family pairs, reach config hints. */
   colorWarnings?: string[];
-  /** Inline themes: theme name → slot name → resolved hex color (only when tokensSource === 'inline') */
+  /** Inline themes: theme name → slot name → resolved hex color */
   themes?: Record<string, Record<string, string>>;
   /** Print annotations from inline # comments: slot name → annotation text */
   themeDescriptions?: Record<string, string>;
-  /** Spacing scale (only when tokensSource === 'inline') */
+  /** Spacing scale */
   spacing?: { unit: string; xs: number; s: number; m: number; l: number; xl: number };
   /** Divider style definitions: name → divider config */
   dividers?: Record<string, ParsedDividerDef>;
@@ -450,10 +436,7 @@ export function parseBrandFile(content: string, fileName: string): ParsedBrand {
     return { slot, value, line: lineNum };
   };
 
-  const result: Partial<ParsedBrand> = {
-    tokensFile: 'tokens.json',
-    tokensSource: 'figma',
-  };
+  const result: Partial<ParsedBrand> = {};
 
   type ActiveBlock = 'none' | 'brand-colors' | 'state-colors' | 'color-bounds' | 'color-adherence' | 'color-rules' | 'tones' | 'levels' | 'color-families' | 'theme' | 'spacing' | 'divider' | 'typography' | 'font' | 'logo' | 'photo' | 'video' | 'illustration' | 'label' | 'cta' | 'icons' | 'counter' | 'framing' | 'camera' | 'photo-look' | 'windows';
   let activeBlock: ActiveBlock = 'none';
@@ -1164,19 +1147,6 @@ export function parseBrandFile(content: string, fileName: string): ParsedBrand {
       case 'name':         result.name = value; break;
       case 'language':     result.language = value; break;
       case 'locale':       result.locale = value; break;
-      case 'tokens':
-        if (value === 'figma' || value === 'inline') {
-          result.tokensSource = value;
-        } else {
-          console.warn(`${fileName}:${lineNum}: unknown tokens source "${value}", defaulting to "figma"`);
-        }
-        break;
-      case 'figma-file-key':    result.figmaFileKey = value; break;
-      case 'figma-collection':  result.figmaCollection = value; break;
-      case 'tokens-file':       result.tokensFile = value; break;
-      case 'app-icon':          result.appIcon = value; break;
-      case 'favicon':           result.favicon = value; break;
-      case 'og-image':          result.ogImage = value; break;
       case 'spacing':
         activeBlock = 'spacing';
         break;

package/parser/storyParser.ts

@@ -40,6 +40,8 @@ export interface ParsedStoryPage {
   composition?: string;
   /** Illustration ids; implementations pick one per story date, the same one every time for that date. */
   illustrations?: string[];
+  /** Photo id; overrides the purpose's `photo:` default for this page. */
+  photo?: string;
   /** Page topic: what this page adds to the story. */
   topic?: string;
   /** Fixed slot texts, may contain `{variable}`s. A slot the page doesn't name is open. */
@@ -192,10 +194,11 @@ export function parseStoryFile(content: string, fileName: string): ParsedStory {
     // Page lines (2-space)
     if (currentPage) {
       if (indent !== 2) throw new Error(`${fileName}:${lineNum}: unexpected indent in page (page keys use 2 spaces)`);
-      const read = readKey(line, lineNum, currentPage, ['purpose', 'composition', 'illustration'], true);
+      const read = readKey(line, lineNum, currentPage, ['purpose', 'composition', 'illustration', 'photo'], true);
       if (read && 'multi' in read) { multiKey = read.multi; multiIndent = 4; }
       else if (read?.key === 'purpose') currentPage.purpose = read.value;
       else if (read?.key === 'illustration') currentPage.illustrations = read.value.split(',').map(id => id.trim()).filter(Boolean);
+      else if (read?.key === 'photo') currentPage.photo = read.value;
       else if (read) currentPage.composition = read.value;
       continue;
     }
@@ -281,7 +284,7 @@ export function parseStoryFile(content: string, fileName: string): ParsedStory {
  *  empty when the story fits. Variables count at their longest form for `maxLength`. */
 export function checkStory(
   story: ParsedStory,
-  brand: { purposes: ParsedPurpose[]; compositions: string[]; formats: string[]; illustrations?: string[] },
+  brand: { purposes: ParsedPurpose[]; compositions: string[]; formats: string[]; illustrations?: string[]; photos?: string[] },
   fileName: string,
 ): string[] {
   const problems: string[] = [];
@@ -314,6 +317,7 @@ export function checkStory(
     for (const id of page.illustrations ?? []) {
       if (brand.illustrations && !brand.illustrations.includes(id)) say(`${where}: illustration "${id}" does not exist`);
     }
+    if (page.photo && brand.photos && !brand.photos.includes(page.photo)) say(`${where}: photo "${page.photo}" does not exist`);
     checkTexts(where, purpose, page.texts);
   });
   story.examples.forEach((ex, i) => {

package/vscode-extension/syntaxes/brand.tmLanguage.json

@@ -6,7 +6,6 @@
     { "include": "#comment" },
     { "include": "#id-field" },
     { "include": "#name-field" },
-    { "include": "#tokens-enum" },
     { "include": "#brand-colors-header" },
     { "include": "#state-colors-header" },
     { "include": "#color-bounds-header" },
@@ -80,13 +79,6 @@
         "2": { "name": "string.unquoted.brand-intent-brand" }
       }
     },
-    "tokens-enum": {
-      "match": "^(tokens:)\\s+(figma|inline)",
-      "captures": {
-        "1": { "name": "keyword.control.brand-intent-brand" },
-        "2": { "name": "entity.name.tag.brand-intent-brand" }
-      }
-    },
     "brand-colors-header": {
       "match": "^(brand-colors)\\s*$",
       "captures": {
@@ -535,7 +527,7 @@
       }
     },
     "string-field": {
-      "match": "^(language|locale|app-icon|favicon|og-image|figma-file-key|figma-collection|tokens-file|spacing):?\\s*(.+)?",
+      "match": "^(language|locale|spacing):?\\s*(.+)?",
       "captures": {
         "1": { "name": "support.type.property-name.brand-intent-brand" },
         "2": { "name": "string.unquoted.brand-intent-brand" }
@@ -543,7 +535,7 @@
     },
     "keyword-partial": {
       "comment": "Fallback: color the keyword token on incomplete lines (while typing)",
-      "match": "^(id:|name:|language:|locale:|app-icon:|favicon:|og-image:|tokens:|figma-file-key:|figma-collection:|tokens-file:|spacing:|label:|cta:|color-mode:|color-strategy:|color-adherence:|brand-colors|state-colors|color-bounds|color-rules|color-families|theme|divider|font|typography|logo|photo|video|illustration|icons|counter|framing|windows)(?=\\s|$)",
+      "match": "^(id:|name:|language:|locale:|spacing:|label:|cta:|color-mode:|color-strategy:|color-adherence:|brand-colors|state-colors|color-bounds|color-rules|color-families|theme|divider|font|typography|logo|photo|video|illustration|icons|counter|framing|windows)(?=\\s|$)",
       "captures": {
         "1": { "name": "keyword.control.brand-intent-brand" }
       }

package/vscode-extension/syntaxes/story.tmLanguage.json

@@ -37,7 +37,7 @@
       }
     },
     "reference": {
-      "match": "^\\s+(purpose|composition|illustration)(:)\\s+([\\w:, -]+)",
+      "match": "^\\s+(purpose|composition|illustration|photo)(:)\\s+([\\w:, -]+)",
       "captures": {
         "1": { "name": "support.type.property-name.brand-intent-story" },
         "2": { "name": "punctuation.separator.brand-intent-story" },
@@ -66,7 +66,7 @@
           }
         },
         {
-          "match": "^\\s+(purpose|composition|illustration|topic|primary|secondary|detail|meta|cta|label)(?=:|\\s|$)",
+          "match": "^\\s+(purpose|composition|illustration|photo|topic|primary|secondary|detail|meta|cta|label)(?=:|\\s|$)",
           "captures": {
             "1": { "name": "support.type.property-name.brand-intent-story" }
           }