brand-intent 0.3.0 → 0.3.2

package/package.json

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

package/parser/compositionParser.ts

@@ -128,8 +128,6 @@ export interface ParsedDivider {
 
 // ── Constants ─────────────────────────────────────────────────────────────────
 
-/** Backward-compat map: band letters A-F → 0-based row indices */
-const LEGACY_BAND_MAP: Record<string, number> = { A: 0, B: 1, C: 2, D: 3, E: 4, F: 5 };
 const GRID_Y_KEYWORDS = new Set<string>(['top', 'center', 'bottom']);
 
 const VALID_SLOTS = new Set<string>(['primary', 'secondary', 'detail', 'meta', 'cta', 'label']);
@@ -292,16 +290,6 @@ export function parseCompositionFile(content: string, fileName: string): ParsedC
         logo = { row: parseInt(rowMatch[1], 10) - 1, col, size: (rowMatch[3] as 's' | 'm' | 'l') ?? undefined };
         continue;
       }
-      // Backward compat: "logo: band A [col] X"
-      const bandMatch = line.match(/^logo:\s+band\s+([A-F])\s+(?:col\s+)?(left|center|right)(?:\s+(s|m|l))?\s*$/);
-      if (bandMatch) {
-        const row = LEGACY_BAND_MAP[bandMatch[1]];
-        if (row === undefined) throw new Error(`${fileName}:${lineNum}: unknown band "${bandMatch[1]}"`);
-        console.warn(`${fileName}:${lineNum}: deprecated "band ${bandMatch[1]}" syntax — use "row ${row + 1}" instead`);
-        const col = resolveColKeyword(bandMatch[2], fileName, lineNum);
-        logo = { row, col, size: (bandMatch[3] as 's' | 'm' | 'l') ?? undefined };
-        continue;
-      }
       throw new Error(`${fileName}:${lineNum}: invalid logo line "${line}" (expected "logo: row N left|center|right" or "logo: top/center/bottom left|center|right")`);
     }
 
@@ -319,15 +307,6 @@ export function parseCompositionFile(content: string, fileName: string): ParsedC
         icon = { row: parseInt(rowMatch[1], 10) - 1, col, size: (rowMatch[3] as 's' | 'm' | 'l') ?? undefined };
         continue;
       }
-      const bandMatch = line.match(/^icon:\s+band\s+([A-F])\s+(?:col\s+)?(left|center|right)(?:\s+(s|m|l))?\s*$/);
-      if (bandMatch) {
-        const row = LEGACY_BAND_MAP[bandMatch[1]];
-        if (row === undefined) throw new Error(`${fileName}:${lineNum}: unknown band "${bandMatch[1]}"`);
-        console.warn(`${fileName}:${lineNum}: deprecated "band ${bandMatch[1]}" syntax — use "row ${row + 1}" instead`);
-        const col = resolveColKeyword(bandMatch[2], fileName, lineNum);
-        icon = { row, col, size: (bandMatch[3] as 's' | 'm' | 'l') ?? undefined };
-        continue;
-      }
       throw new Error(`${fileName}:${lineNum}: invalid icon line "${line}"`);
     }
 
@@ -511,25 +490,6 @@ export function parseCompositionFile(content: string, fileName: string): ParsedC
       continue;
     }
 
-    // Backward compat: "primary  band D  cols 1--4  left"
-    const bandSlotMatch = line.match(/^(\w+)\s+band\s+([A-F])\s+cols\s+(\S+)\s+(left|center|right)$/);
-    if (bandSlotMatch) {
-      const [, slotId, bandLetter, colRange, align] = bandSlotMatch;
-      if (!VALID_SLOTS.has(slotId)) throw new Error(`${fileName}:${lineNum}: unknown slot "${slotId}"`);
-      const row = LEGACY_BAND_MAP[bandLetter];
-      if (row === undefined) throw new Error(`${fileName}:${lineNum}: unknown band "${bandLetter}"`);
-      console.warn(`${fileName}:${lineNum}: deprecated "band ${bandLetter}" syntax — use "row ${row + 1}" instead`);
-      const cols = parseColRange(colRange, fileName, lineNum, 12);
-      slots.push({
-        id: slotId as SlotId,
-        row,
-        colStart: cols.start,
-        colEnd: cols.end,
-        textAlign: align as 'left' | 'center' | 'right',
-      });
-      continue;
-    }
-
     // Unknown line
     throw new Error(`${fileName}:${lineNum}: unexpected "${line}"`);
   }

package/parser/formatParser.ts

@@ -29,7 +29,7 @@ export interface ParsedFormat {
   dpi?: number;
   bleedMm?: number;
   // Optional grid override — absent means auto portrait/landscape selection
-  grid?: { bands: number; cols: number };
+  grid?: { rows: number; cols: number };
   // Zones — always stored in px (mm values converted during parse)
   danger: ZoneInsets;
   gridCrop: ZoneInsets | null;
@@ -183,12 +183,12 @@ export function parseFormatFile(content: string, fileName: string): ParsedFormat
 
       case 'grid': {
         const parts = value.split(/\s+/);
-        if (parts.length !== 2) throw new Error(`${fileName}:${lineNum}: grid requires "bands cols", got "${value}"`);
-        const bands = parseInt(parts[0], 10);
+        if (parts.length !== 2) throw new Error(`${fileName}:${lineNum}: grid requires "rows cols", got "${value}"`);
+        const rows = parseInt(parts[0], 10);
         const cols  = parseInt(parts[1], 10);
-        if (isNaN(bands) || bands < 1 || isNaN(cols) || cols < 1)
-          throw new Error(`${fileName}:${lineNum}: grid bands and cols must be positive integers`);
-        grid = { bands, cols };
+        if (isNaN(rows) || rows < 1 || isNaN(cols) || cols < 1)
+          throw new Error(`${fileName}:${lineNum}: grid rows and cols must be positive integers`);
+        grid = { rows, cols };
         break;
       }
 

package/parser/index.ts

@@ -15,6 +15,13 @@ export { parsePurposeFile } from './purposeParser';
 export type { ParsedPurpose, ParsedPurposeSlot, Density } from './purposeParser';
 
 export { parseCompositionFile } from './compositionParser';
-export type { ParsedComposition, ParsedFlowRegion, ParsedStickyRegion } from './compositionParser';
+export type {
+  ParsedComposition,
+  ParsedFlowRegion,
+  ParsedStickyRegion,
+  ParsedFlowItem,
+  ParsedImageRegion,
+  GridYKeyword,
+} from './compositionParser';
 
 export type { SlotId, ZoneInsets, TextAlign } from './types';