brand-intent 0.18.0 → 0.19.0

package/package.json

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

@@ -1202,13 +1202,16 @@ export function parseBrandFile(content: string, fileName: string): ParsedBrand {
     if (!Number.isInteger(distance) || distance < 1) throw new Error(`${fileName}: color-families distance must be a whole number ≥ 1, got "${familiesProps.distance}"`);
     if (familiesRaw.length === 0) throw new Error(`${fileName}: color-families declares no family`);
 
-    const shared: Array<{ name: string; hex: string }> = [];
-    for (const ref of (familiesProps.shared ?? '').split(',').map(r => r.trim()).filter(Boolean)) {
-      if (!ref.startsWith('$')) throw new Error(`${fileName}: color-families shared entries must be $refs to brand-colors, got "${ref}"`);
-      const hex = brandColors[ref.slice(1)] ? normalizeHex(brandColors[ref.slice(1)]) : null;
-      if (!hex || !isHex6(hex)) throw new Error(`${fileName}: color-families shared "${ref}" is not a known 6-digit brand color`);
-      shared.push({ name: ref.slice(1), hex });
-    }
+    /** Comma-separated `$refs` to brand-colors (`shared:`, `photo-fallback:`). */
+    const colorRefs = (key: string): Array<{ name: string; hex: string }> =>
+      (familiesProps[key] ?? '').split(',').map(r => r.trim()).filter(Boolean).map(ref => {
+        if (!ref.startsWith('$')) throw new Error(`${fileName}: color-families ${key} entries must be $refs to brand-colors, got "${ref}"`);
+        const hex = brandColors[ref.slice(1)] ? normalizeHex(brandColors[ref.slice(1)]) : null;
+        if (!hex || !isHex6(hex)) throw new Error(`${fileName}: color-families ${key} "${ref}" is not a known 6-digit brand color`);
+        return { name: ref.slice(1), hex };
+      });
+    const shared = colorRefs('shared');
+    const photoFallback = colorRefs('photo-fallback');
 
     const families: ColorFamily[] = [];
     for (const raw of familiesRaw) {
@@ -1245,7 +1248,7 @@ export function parseBrandFile(content: string, fileName: string): ParsedBrand {
       const twin = dated.find(o => o !== f && o.from === f.from);
       if (twin) throw new Error(`${fileName}:${f.line}: families "${twin.name}" and "${f.name}" share from: ${f.from}`);
     }
-    colorFamilies = { order, borrow, distance, shared, families };
+    colorFamilies = { order, borrow, distance, shared, ...(photoFallback.length > 0 ? { photoFallback } : {}), families };
     if (borrow !== 'none' && reachCoversAll(families.length, { order, borrow, distance })) {
       colorWarnings.push(`color-families: borrow "${borrow}" with distance ${distance} reaches every family — the borrow rule has no effect`);
     }

package/parser/types.ts

@@ -168,6 +168,9 @@ export interface ColorFamilies {
   distance: number;
   /** Colors allowed in every family (resolved from `shared:` refs). */
   shared: Array<{ name: string; hex: string }>;
+  /** Text and figure colors for photos no pair reads on, in order of preference (`photo-fallback:` refs).
+   *  Used only over photos, never in pairs or guided generation. Absent when not declared. */
+  photoFallback?: Array<{ name: string; hex: string }>;
   families: ColorFamily[];
 }
 

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

@@ -120,8 +120,8 @@
       }
     },
     "color-families-property": {
-      "comment": "Block keys under color-families: order/borrow/distance/shared",
-      "match": "^( {2})(order|borrow|distance|shared)(:\\s*)(.+)$",
+      "comment": "Block keys under color-families: order/borrow/distance/shared/photo-fallback",
+      "match": "^( {2})(order|borrow|distance|shared|photo-fallback)(:\\s*)(.+)$",
       "captures": {
         "2": { "name": "support.type.property-name.brand-intent-brand" },
         "3": { "name": "punctuation.separator.key-value.brand-intent-brand" },