brand-intent 0.27.0 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brand-intent",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "description": "An open file format specification for making brand intent machine-readable.",
   "author": "Christophe Stoll <christophe@stoll.studio>",
   "license": "MIT",
@@ -36,7 +36,7 @@
   "scripts": {
     "release": "./scripts/release.sh",
     "typecheck": "tsc -p .",
-    "test": "tsx tests/brandParser.test.ts && tsx tests/identityParser.test.ts && tsx tests/colorSystem.test.ts && tsx tests/icons.test.ts && tsx tests/purposeParser.test.ts && tsx tests/storyParser.test.ts && tsx tests/realBrands.test.ts"
+    "test": "tsx tests/brandParser.test.ts && tsx tests/identityParser.test.ts && tsx tests/colorSystem.test.ts && tsx tests/icons.test.ts && tsx tests/purposeParser.test.ts && tsx tests/storyParser.test.ts && tsx tests/formatParser.test.ts && tsx tests/realBrands.test.ts"
   },
   "devDependencies": {
     "@types/node": "^26.6.5",

package/parser/formatParser.ts

@@ -19,7 +19,7 @@ export interface ParsedFormat {
   name?: string;
   label: string;
   sublabel: string;
-  category: 'instagram' | 'linkedin' | 'print' | 'signage';
+  category: 'instagram' | 'facebook' | 'linkedin' | 'print' | 'signage';
   // Pixel dimensions (always present — computed from mm+dpi for print/signage)
   widthPx: number;
   heightPx: number;
@@ -141,8 +141,8 @@ export function parseFormatFile(content: string, fileName: string): ParsedFormat
         break;
 
       case 'category':
-        if (value !== 'instagram' && value !== 'linkedin' && value !== 'print' && value !== 'signage')
-          throw new Error(`${fileName}:${lineNum}: category must be instagram, linkedin, print, or signage, got "${value}"`);
+        if (value !== 'instagram' && value !== 'facebook' && value !== 'linkedin' && value !== 'print' && value !== 'signage')
+          throw new Error(`${fileName}:${lineNum}: category must be instagram, facebook, linkedin, print, or signage, got "${value}"`);
         category = value;
         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/format.tmLanguage.json

@@ -34,7 +34,7 @@
       }
     },
     "category": {
-      "match": "^(category:)\\s+(instagram|linkedin|print|signage)",
+      "match": "^(category:)\\s+(instagram|facebook|linkedin|print|signage)",
       "captures": {
         "1": { "name": "keyword.control.brand-intent-format" },
         "2": { "name": "entity.name.tag.brand-intent-format" }

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" }
           }