brand-intent 0.29.0 → 0.31.0

package/examples/krume/formats/instagram-4-5-feed-portrait.format

@@ -7,6 +7,7 @@ id:       4:5
 label:    4:5
 sublabel: Feed Portrait
 category: instagram
+post:     feed
 
 size:     1080 1350
 grid:     5 4           # 5 rows × 4 columns

package/package.json

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

package/parser/formatParser.ts

@@ -20,6 +20,8 @@ export interface ParsedFormat {
   label: string;
   sublabel: string;
   category: 'instagram' | 'facebook' | 'linkedin' | 'print' | 'signage';
+  /** How the page is posted (from `post:`). Absent = the format is not posted. */
+  post?: 'feed' | 'story';
   // Pixel dimensions (always present — computed from mm+dpi for print/signage)
   widthPx: number;
   heightPx: number;
@@ -97,6 +99,7 @@ export function parseFormatFile(content: string, fileName: string): ParsedFormat
   let label: string | undefined;
   let sublabel: string | undefined;
   let category: ParsedFormat['category'] | undefined;
+  let post: ParsedFormat['post'];
   let widthPx: number | undefined;
   let heightPx: number | undefined;
   let widthMm: number | undefined;
@@ -146,6 +149,12 @@ export function parseFormatFile(content: string, fileName: string): ParsedFormat
         category = value;
         break;
 
+      case 'post':
+        if (value !== 'feed' && value !== 'story')
+          throw new Error(`${fileName}:${lineNum}: post must be feed or story, got "${value}"`);
+        post = value;
+        break;
+
       case 'size': {
         // "1080 1350" (px) or "594mm 297mm" (mm)
         const parts = value.split(/\s+/);
@@ -261,7 +270,7 @@ export function parseFormatFile(content: string, fileName: string): ParsedFormat
   }
 
   return {
-    id, name, label, sublabel, category,
+    id, name, label, sublabel, category, post,
     widthPx, heightPx,
     widthMm, heightMm,
     dpi: dpi ?? (category === 'print' || category === 'signage' ? effectiveDpi : undefined),

package/parser/storyParser.ts

@@ -40,8 +40,9 @@ 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;
+  /** Photo ids; override the purpose's `photo:` default for this page. Implementations pick one per
+   *  story date, the same one every time for that date. */
+  photos?: 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. */
@@ -198,7 +199,7 @@ export function parseStoryFile(content: string, fileName: string): ParsedStory {
       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?.key === 'photo') currentPage.photos = read.value.split(',').map(id => id.trim()).filter(Boolean);
       else if (read) currentPage.composition = read.value;
       continue;
     }
@@ -317,7 +318,9 @@ 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`);
+    for (const id of page.photos ?? []) {
+      if (brand.photos && !brand.photos.includes(id)) say(`${where}: photo "${id}" does not exist`);
+    }
     checkTexts(where, purpose, page.texts);
   });
   story.examples.forEach((ex, i) => {

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

@@ -6,6 +6,7 @@
     { "include": "#id-field" },
     { "include": "#name-field" },
     { "include": "#category" },
+    { "include": "#post" },
     { "include": "#purposes" },
     { "include": "#size" },
     { "include": "#grid" },
@@ -40,6 +41,13 @@
         "2": { "name": "entity.name.tag.brand-intent-format" }
       }
     },
+    "post": {
+      "match": "^(post:)\\s+(feed|story)",
+      "captures": {
+        "1": { "name": "keyword.control.brand-intent-format" },
+        "2": { "name": "entity.name.tag.brand-intent-format" }
+      }
+    },
     "purposes": {
       "match": "^(purposes:)\\s+(.*)",
       "captures": {
@@ -86,7 +94,7 @@
     },
     "keyword-partial": {
       "comment": "Fallback: color the keyword token on incomplete lines (while typing)",
-      "match": "^(id:|name:|category:|purposes:|size:|grid:|dpi:|bleed:|comfort:|danger:|crop:|label:|sublabel:)(?=\\s|$)",
+      "match": "^(id:|name:|category:|post:|purposes:|size:|grid:|dpi:|bleed:|comfort:|danger:|crop:|label:|sublabel:)(?=\\s|$)",
       "captures": {
         "1": { "name": "keyword.control.brand-intent-format" }
       }