brand-intent 0.4.4 → 0.5.0

package/package.json

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

package/parser/purposeParser.ts

@@ -35,6 +35,8 @@ export interface ParsedPurpose {
   defaultVideo?: string;
   /** When false, hides Take Photo / Upload buttons for this purpose. Default: true. */
   camera?: boolean;
+  /** When false, photo/video analysis skips this purpose (no AI text generation). Default: true. */
+  analyze?: boolean;
   /** Default icon (Phosphor PascalCase name, e.g. "ArrowRight"). */
   defaultIcon?: string;
   /** Default icon weight. */
@@ -48,6 +50,8 @@ export interface ParsedPurposeSlot {
   label: string;
   /** Sample text variants for this slot. Picked randomly on page creation. */
   samples: string[];
+  /** Fixed value — when set, this slot is never AI-generated or shuffled. Mutually exclusive with samples. */
+  value?: string;
   maxLength: number;
   /** 'text' (default) or 'list'. */
   slotType?: 'text' | 'list';
@@ -63,6 +67,8 @@ export interface ParsedPurposeSlot {
   itemGap?: number;
   /** List layout direction: 'vertical' (default) or 'horizontal'. */
   listDirection?: 'vertical' | 'horizontal';
+  /** When true, this slot is editable by the user in consume mode. Default: false. */
+  editable?: boolean;
   typography: {
     fontFamily: string;
     fontWeight: number;
@@ -122,6 +128,7 @@ export function parsePurposeFile(content: string, fileName: string): ParsedPurpo
   let defaultPhoto: string | undefined;
   let defaultVideo: string | undefined;
   let camera: boolean | undefined;
+  let analyze: boolean | undefined;
   let defaultIcon: string | undefined;
   let defaultIconWeight: string | undefined;
   let bgPrompt: string | undefined;
@@ -143,7 +150,7 @@ export function parsePurposeFile(content: string, fileName: string): ParsedPurpo
     const s = currentSlot;
     if (!s.id) throw new Error(`${fileName}:${lineNum}: slot missing id`);
     if (!s.label) throw new Error(`${fileName}:${lineNum}: slot "${s.id}" missing label`);
-    if ((!s.samples || s.samples.length === 0) && !s.iconOnly) throw new Error(`${fileName}:${lineNum}: slot "${s.id}" missing samples`);
+    if ((!s.samples || s.samples.length === 0) && !s.iconOnly && !s.value) throw new Error(`${fileName}:${lineNum}: slot "${s.id}" missing samples or value`);
     if (!s.maxLength) throw new Error(`${fileName}:${lineNum}: slot "${s.id}" missing maxLength`);
     const t = s.typography as ParsedPurposeSlot['typography'];
     if (!s.typographyRef) {
@@ -296,6 +303,12 @@ export function parsePurposeFile(content: string, fileName: string): ParsedPurpo
       continue;
     }
 
+    // Photo/video analysis control
+    if (line.startsWith('analyze:')) {
+      analyze = line.slice(8).trim() !== 'false';
+      continue;
+    }
+
     // Background placeholder prompt: "bg-prompt: Mach dein Selfie"
     if (line.startsWith('bg-prompt:')) {
       bgPrompt = line.slice(10).trim().replace(/^["']|["']$/g, '');
@@ -501,6 +514,14 @@ export function parsePurposeFile(content: string, fileName: string): ParsedPurpo
         currentSlot.label = prop.slice(6).trim();
         continue;
       }
+      if (prop.startsWith('value:')) {
+        const val = prop.slice(6).trim();
+        if (!val) throw new Error(`${fileName}:${lineNum}: empty value`);
+        currentSlot.value = val;
+        // value implies a single-entry samples array for backward compat
+        currentSlot.samples = [val];
+        continue;
+      }
       if (prop.startsWith('samples:')) {
         const raw = prop.slice(8).trim();
         if (!raw) {
@@ -526,6 +547,8 @@ export function parsePurposeFile(content: string, fileName: string): ParsedPurpo
         currentSlot.colorRef = prop.slice(6).trim();
         continue;
       }
+      if (prop === 'editable' || prop === 'editable: true' || prop === 'editable:true') { currentSlot.editable = true; continue; }
+      if (prop === 'editable: false' || prop === 'editable:false') { currentSlot.editable = false; continue; }
       if (prop.startsWith('font:')) {
         // "Die Grotesk 800" → family="Die Grotesk", weight=800  (legacy direct path)
         const value = prop.slice(5).trim();
@@ -601,5 +624,5 @@ export function parsePurposeFile(content: string, fileName: string): ParsedPurpo
     context = contextLines.join('\n').trim();
   }
 
-  return { id, name, description, preferredCompositions: compositions, slots, density, palette, scope, context, voice, defaultLogo, defaultPhoto, defaultVideo, camera, defaultIcon, defaultIconWeight, bgPrompt };
+  return { id, name, description, preferredCompositions: compositions, slots, density, palette, scope, context, voice, defaultLogo, defaultPhoto, defaultVideo, camera, analyze, defaultIcon, defaultIconWeight, bgPrompt };
 }