@aibloom/core 0.2.0

package/README.md

@@ -0,0 +1,16 @@
+# @aibloom/core
+
+Workflow engine, orchestrator, state machine, and design pipeline core for Aibloom.
+
+## Modules
+
+- **State** — State machine with validated transitions, project state store, run record store
+- **Design Docs** — DESIGN.md parser, style fingerprint extractor, token normalizer, conflict detector, fusion option generator, design system synthesizer
+- **Page Planner** — Structured page shape and implementation plan generation
+- **Verification** — Document existence checks and compliance reporting
+
+## Usage
+
+```ts
+import { VibeUIOrchestrator } from "@aibloom/core";
+```

package/dist/design-docs/ConflictDetector.d.ts

@@ -0,0 +1,21 @@
+import { type StyleFingerprint, type StyleConflictReport } from "@aibloom/schemas";
+/**
+ * Detects design conflicts between multiple StyleFingerprints.
+ * Checks 10 dimensions: theme, canvas, accent, typography, radius,
+ * elevation, layout, imagery, motion, anti-patterns.
+ */
+export declare class ConflictDetector {
+    detect(fingerprints: StyleFingerprint[]): StyleConflictReport;
+    private conflict;
+    private defaultRecommendation;
+    private pairs;
+    private haveDifferentValues;
+    private detectDisplayConflict;
+    private elevationSeverity;
+    private detectAntiPatternContradictions;
+    private computeCompatibilityScore;
+    private buildSummary;
+    private findSafeFusions;
+    private recommendOptions;
+}
+//# sourceMappingURL=ConflictDetector.d.ts.map

package/dist/design-docs/ConflictDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictDetector.d.ts","sourceRoot":"","sources":["../../src/design-docs/ConflictDetector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,gBAAgB,EAAuB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAExH;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,mBAAmB;IAqG7D,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,KAAK;IAUb,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAiB7B,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,+BAA+B;IAqBvC,OAAO,CAAC,yBAAyB;IASjC,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,gBAAgB;CAgBzB"}

package/dist/design-docs/ConflictDetector.js

@@ -0,0 +1,221 @@
+import { SCHEMA_VERSION } from "@aibloom/schemas";
+/**
+ * Detects design conflicts between multiple StyleFingerprints.
+ * Checks 10 dimensions: theme, canvas, accent, typography, radius,
+ * elevation, layout, imagery, motion, anti-patterns.
+ */
+export class ConflictDetector {
+    detect(fingerprints) {
+        if (fingerprints.length < 2) {
+            return {
+                schemaVersion: SCHEMA_VERSION,
+                compatibilityScore: 100,
+                fusionRisk: "low",
+                summary: "Single reference — no conflicts to detect.",
+                conflicts: [],
+                safeFusions: [],
+                nonNegotiableConflicts: [],
+                recommendedOptions: [],
+            };
+        }
+        const conflicts = [];
+        const pairs = this.pairs(fingerprints);
+        for (const [a, b] of pairs) {
+            const refs = [a.id, b.id];
+            // 1. Theme
+            if (a.theme && b.theme && a.theme !== b.theme) {
+                conflicts.push(this.conflict("theme", refs, "weak-conflict", a.theme, b.theme, 1));
+            }
+            // 2. Canvas
+            if (this.haveDifferentValues(a.colorSystem.canvas, b.colorSystem.canvas)) {
+                conflicts.push(this.conflict("canvas", refs, "strong-conflict", "canvas color", "canvas color", 2));
+            }
+            // 3. Accent
+            if (this.haveDifferentValues(a.colorSystem.accent, b.colorSystem.accent)) {
+                conflicts.push(this.conflict("accent", refs, "strong-conflict", a.colorSystem.accent[0] ?? "?", b.colorSystem.accent[0] ?? "?", 3));
+            }
+            // 4. Typography
+            if (a.typography.display && b.typography.display) {
+                const displayConflict = this.detectDisplayConflict(a, b);
+                if (displayConflict)
+                    conflicts.push(displayConflict);
+            }
+            // 5. Radius
+            if (a.shapeLanguage.cardRadius && b.shapeLanguage.cardRadius
+                && a.shapeLanguage.cardRadius !== b.shapeLanguage.cardRadius) {
+                conflicts.push(this.conflict("radius", refs, "strong-conflict", a.shapeLanguage.cardRadius, b.shapeLanguage.cardRadius, 2));
+            }
+            // 6. Elevation
+            if (a.shapeLanguage.shadowStyle !== b.shapeLanguage.shadowStyle) {
+                const severity = this.elevationSeverity(a.shapeLanguage.shadowStyle, b.shapeLanguage.shadowStyle);
+                conflicts.push(this.conflict("elevation", refs, "strong-conflict", a.shapeLanguage.shadowStyle, b.shapeLanguage.shadowStyle, severity));
+            }
+            // 7. Layout
+            if (a.layoutLanguage.heroPattern && b.layoutLanguage.heroPattern
+                && a.layoutLanguage.heroPattern !== b.layoutLanguage.heroPattern) {
+                conflicts.push(this.conflict("layout", refs, "weak-conflict", a.layoutLanguage.heroPattern, b.layoutLanguage.heroPattern, 1));
+            }
+            // 8. Imagery
+            if (this.haveDifferentValues(a.imagery.allowed, b.imagery.allowed)) {
+                conflicts.push(this.conflict("imagery", refs, "weak-conflict", "imagery rules", "imagery rules", 1));
+            }
+            // 9. Components
+            if (this.haveDifferentValues(a.componentLanguage, b.componentLanguage)) {
+                conflicts.push(this.conflict("components", refs, "weak-conflict", "component language", "component language", 1));
+            }
+            // 10. Motion
+            if (a.motion.inferredTone !== b.motion.inferredTone) {
+                conflicts.push(this.conflict("motion", refs, "compatible", a.motion.inferredTone, b.motion.inferredTone, 0));
+            }
+            // 11. Anti-patterns contradiction
+            const apConflicts = this.detectAntiPatternContradictions(a, b);
+            conflicts.push(...apConflicts);
+        }
+        const score = this.computeCompatibilityScore(conflicts);
+        const risk = score >= 70 ? "low" : score >= 40 ? "medium" : "high";
+        return {
+            schemaVersion: SCHEMA_VERSION,
+            compatibilityScore: score,
+            fusionRisk: risk,
+            summary: this.buildSummary(conflicts, score),
+            conflicts,
+            safeFusions: this.findSafeFusions(fingerprints),
+            nonNegotiableConflicts: conflicts
+                .filter((c) => c.severity >= 3)
+                .map((c) => ({ description: c.explanation, refA: c.references[0], refB: c.references[1] })),
+            recommendedOptions: this.recommendOptions(conflicts, fingerprints),
+        };
+    }
+    conflict(dimension, references, relation, valA, valB, severity) {
+        return {
+            dimension,
+            references,
+            relation,
+            severity,
+            explanation: `${dimension}: "${valA}" vs "${valB}"`,
+            recommendation: this.defaultRecommendation(dimension),
+        };
+    }
+    defaultRecommendation(dimension) {
+        const recs = {
+            theme: "Ensure both can be light, or choose one theme direction.",
+            canvas: "Choose one canvas color as primary, or split by page type.",
+            accent: "Select one primary accent color. The other can be used sparingly as decorative.",
+            typography: "Cannot mix two display type systems. Choose one as primary.",
+            radius: "Use one radius system consistently across the project.",
+            elevation: "Shadow and no-shadow cannot coexist globally. Split by page type.",
+            layout: "Hero patterns can differ by page type.",
+            imagery: "Imagery styles can differ by page context.",
+            components: "Component language can be unified, choosing the stronger convention where they differ.",
+            motion: "Motion tones can coexist when used contextually.",
+            "anti-patterns": "Resolve contradictory rules by choosing the stricter or more relevant constraint.",
+        };
+        return recs[dimension] ?? "Choose one approach or split by context.";
+    }
+    pairs(list) {
+        const result = [];
+        for (let i = 0; i < list.length; i++) {
+            for (let j = i + 1; j < list.length; j++) {
+                result.push([list[i], list[j]]);
+            }
+        }
+        return result;
+    }
+    haveDifferentValues(a, b) {
+        if (a.length === 0 && b.length === 0)
+            return false;
+        const setA = new Set(a.map((v) => v.toLowerCase()));
+        const setB = new Set(b.map((v) => v.toLowerCase()));
+        return !a.every((v) => setB.has(v.toLowerCase()))
+            || !b.every((v) => setA.has(v.toLowerCase()));
+    }
+    detectDisplayConflict(a, b) {
+        const aFamily = a.typography.display.family.toLowerCase();
+        const bFamily = b.typography.display.family.toLowerCase();
+        const aTone = a.typography.display.tone.toLowerCase();
+        const bTone = b.typography.display.tone.toLowerCase();
+        if (aFamily === bFamily && aTone === bTone)
+            return null;
+        // Serif vs condensed/brutalist is a strong conflict
+        if ((/serif|editorial/i.test(aTone) && /condensed|brutalist|bold/i.test(bTone))
+            || (/serif|editorial/i.test(bTone) && /condensed|brutalist|bold/i.test(aTone))) {
+            return this.conflict("typography", [a.id, b.id], "strong-conflict", aFamily, bFamily, 3);
+        }
+        return this.conflict("typography", [a.id, b.id], "weak-conflict", aFamily, bFamily, 1);
+    }
+    elevationSeverity(a, b) {
+        if ((a === "none" && b !== "none") || (b === "none" && a !== "none"))
+            return 3;
+        if (a === b)
+            return 0;
+        return 2;
+    }
+    detectAntiPatternContradictions(a, b) {
+        const conflicts = [];
+        for (const ap of a.antiPatterns) {
+            // Check if B's Do's recommend what A has as anti-pattern
+            const apLower = ap.toLowerCase();
+            for (const comp of b.componentLanguage) {
+                if (comp.toLowerCase().includes(apLower.replace(/don['']?t\s*/, ""))) {
+                    conflicts.push({
+                        dimension: "anti-patterns",
+                        references: [a.id, b.id],
+                        relation: "mutually-exclusive",
+                        severity: 3,
+                        explanation: `${a.name} forbids: "${ap}", but ${b.name} recommends similar patterns.`,
+                        recommendation: "Choose which reference's constraint to follow.",
+                    });
+                }
+            }
+        }
+        return conflicts;
+    }
+    computeCompatibilityScore(conflicts) {
+        // Start at 100, deduct based on severity
+        let score = 100;
+        for (const c of conflicts) {
+            score -= c.severity * 10;
+        }
+        return Math.max(0, Math.min(100, score));
+    }
+    buildSummary(conflicts, score) {
+        const strongConflicts = conflicts.filter((c) => c.severity >= 3);
+        const dimensions = [...new Set(strongConflicts.map((c) => c.dimension))];
+        if (score >= 80)
+            return "High compatibility. Minor differences that can be merged automatically.";
+        if (score >= 50)
+            return `Moderate compatibility. Notable conflicts in: ${dimensions.join(", ")}. User choice recommended.`;
+        return `Low compatibility (score: ${score}). Strong conflicts in: ${dimensions.join(", ")}. User must choose fusion strategy.`;
+    }
+    findSafeFusions(fingerprints) {
+        const safe = [];
+        const shared = new Set();
+        for (const fp of fingerprints) {
+            for (const ap of fp.antiPatterns) {
+                if (shared.has(ap.toLowerCase())) {
+                    safe.push(ap);
+                }
+                shared.add(ap.toLowerCase());
+            }
+        }
+        if (safe.length === 0)
+            safe.push("No shared anti-patterns detected — fusion may require manual guidance.");
+        return safe;
+    }
+    recommendOptions(conflicts, fingerprints) {
+        const options = [];
+        const score = this.computeCompatibilityScore(conflicts);
+        options.push("primary-plus-accent");
+        if (fingerprints.length === 2)
+            options.push("page-type-split");
+        if (score < 60) {
+            options.push("new-derived-system");
+            options.push("reject-and-restart");
+        }
+        else {
+            options.push("layered-fusion");
+        }
+        return options;
+    }
+}
+//# sourceMappingURL=ConflictDetector.js.map

package/dist/design-docs/ConflictDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConflictDetector.js","sourceRoot":"","sources":["../../src/design-docs/ConflictDetector.ts"],"names":[],"mappings":"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"}

package/dist/design-docs/DesignDocParser.d.ts

@@ -0,0 +1,17 @@
+import { type DesignReferenceDocument } from "@aibloom/schemas";
+interface ParseInput {
+    path: string;
+    name?: string;
+    sourceType: "refero" | "figma-export" | "manual" | "unknown";
+}
+/**
+ * Parses a Markdown DESIGN.md into a structured DesignReferenceDocument.
+ * Handles headings, paragraphs, tables, and fenced code blocks.
+ */
+export declare class DesignDocParser {
+    parse(input: ParseInput): Promise<DesignReferenceDocument>;
+    private extractTitle;
+    private extractSections;
+}
+export {};
+//# sourceMappingURL=DesignDocParser.d.ts.map

package/dist/design-docs/DesignDocParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignDocParser.d.ts","sourceRoot":"","sources":["../../src/design-docs/DesignDocParser.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAUhF,UAAU,UAAU;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,QAAQ,GAAG,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC9D;AAED;;;GAGG;AACH,qBAAa,eAAe;IACpB,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAoBhE,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;CAwFxB"}

package/dist/design-docs/DesignDocParser.js

@@ -0,0 +1,112 @@
+import fs from "node:fs/promises";
+import { SCHEMA_VERSION } from "@aibloom/schemas";
+/**
+ * Parses a Markdown DESIGN.md into a structured DesignReferenceDocument.
+ * Handles headings, paragraphs, tables, and fenced code blocks.
+ */
+export class DesignDocParser {
+    async parse(input) {
+        const rawText = await fs.readFile(input.path, "utf-8");
+        const sections = this.extractSections(rawText);
+        const id = input.name
+            ? `ref-${input.name.toLowerCase().replace(/\s+/g, "-")}`
+            : `ref-${Date.now()}`;
+        return {
+            schemaVersion: SCHEMA_VERSION,
+            id,
+            name: input.name ?? this.extractTitle(rawText) ?? "unnamed",
+            sourceType: input.sourceType,
+            originalPath: input.path,
+            sections,
+            rawText,
+            importedAt: new Date().toISOString(),
+        };
+    }
+    extractTitle(raw) {
+        const match = raw.match(/^#\s+(.+)$/m);
+        return match ? match[1].trim() : null;
+    }
+    extractSections(raw) {
+        const lines = raw.split("\n");
+        const sections = [];
+        let currentSection = null;
+        let inCodeBlock = false;
+        let codeBlockContent = "";
+        let tableBuffer = [];
+        function flushSection() {
+            if (currentSection) {
+                // Flush any pending table
+                if (tableBuffer.length > 0) {
+                    currentSection.tables.push(tableBuffer.join("\n"));
+                    tableBuffer = [];
+                }
+                sections.push(currentSection);
+            }
+        }
+        function flushTable() {
+            if (tableBuffer.length > 0 && currentSection) {
+                currentSection.tables.push(tableBuffer.join("\n"));
+                tableBuffer = [];
+            }
+        }
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Handle code blocks
+            if (line.trimStart().startsWith("```")) {
+                if (!inCodeBlock) {
+                    inCodeBlock = true;
+                    codeBlockContent = "";
+                    flushTable();
+                    continue;
+                }
+                else {
+                    inCodeBlock = false;
+                    if (currentSection) {
+                        currentSection.codeBlocks.push(codeBlockContent);
+                    }
+                    continue;
+                }
+            }
+            if (inCodeBlock) {
+                codeBlockContent += line + "\n";
+                continue;
+            }
+            // Detect headings
+            const headingMatch = line.match(/^(#{1,6})\s+(.+)$/);
+            if (headingMatch) {
+                flushSection();
+                currentSection = {
+                    heading: headingMatch[2].trim(),
+                    level: headingMatch[1].length,
+                    content: "",
+                    tables: [],
+                    codeBlocks: [],
+                };
+                continue;
+            }
+            // Detect table rows (line contains | and starts with |)
+            if (line.trimStart().startsWith("|")) {
+                // Check if it's a separator row (|---|...|)
+                if (/^\|[\s\-:]+\|/.test(line)) {
+                    tableBuffer.push(line);
+                    continue;
+                }
+                tableBuffer.push(line);
+                continue;
+            }
+            else {
+                flushTable();
+            }
+            // Regular content
+            if (currentSection && line.trim()) {
+                currentSection.content += line + "\n";
+            }
+            else if (currentSection) {
+                currentSection.content += "\n";
+            }
+        }
+        flushSection();
+        return sections;
+    }
+}
+//# sourceMappingURL=DesignDocParser.js.map

package/dist/design-docs/DesignDocParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignDocParser.js","sourceRoot":"","sources":["../../src/design-docs/DesignDocParser.ts"],"names":[],"mappings":"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"}

package/dist/design-docs/DesignSystemSynthesizer.d.ts

@@ -0,0 +1,9 @@
+import { type StyleFingerprint, type FusionDecision, type SynthesizedDesignSystem } from "@aibloom/schemas";
+/**
+ * Synthesizes a project-level DESIGN.md from resolved fingerprints and a fusion decision.
+ * Produces: DESIGN.md content, DESIGN_FUSION_BRIEF.md content, and a source map.
+ */
+export declare class DesignSystemSynthesizer {
+    synthesize(fingerprints: StyleFingerprint[], fusionDecision: FusionDecision): SynthesizedDesignSystem;
+}
+//# sourceMappingURL=DesignSystemSynthesizer.d.ts.map

package/dist/design-docs/DesignSystemSynthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignSystemSynthesizer.d.ts","sourceRoot":"","sources":["../../src/design-docs/DesignSystemSynthesizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,uBAAuB,EAA6B,MAAM,kBAAkB,CAAC;AAEvJ;;;GAGG;AACH,qBAAa,uBAAuB;IAClC,UAAU,CACR,YAAY,EAAE,gBAAgB,EAAE,EAChC,cAAc,EAAE,cAAc,GAC7B,uBAAuB;CAuJ3B"}

package/dist/design-docs/DesignSystemSynthesizer.js

@@ -0,0 +1,141 @@
+import { SCHEMA_VERSION } from "@aibloom/schemas";
+/**
+ * Synthesizes a project-level DESIGN.md from resolved fingerprints and a fusion decision.
+ * Produces: DESIGN.md content, DESIGN_FUSION_BRIEF.md content, and a source map.
+ */
+export class DesignSystemSynthesizer {
+    synthesize(fingerprints, fusionDecision) {
+        const primary = fingerprints.find((f) => fusionDecision.finalReferenceRoles[f.id] === "primary");
+        const secondary = fingerprints.filter((f) => fusionDecision.finalReferenceRoles[f.id] === "secondary");
+        const decisions = [];
+        let decisionCounter = 0;
+        function record(dimension, finalRule, sourceIds, treatment) {
+            decisions.push({
+                decisionId: `DS-${String(++decisionCounter).padStart(3, "0")}`,
+                dimension,
+                finalRule,
+                sourceReferenceIds: sourceIds,
+                treatment,
+                rationale: `Fusion strategy: ${fusionDecision.selectedStrategy}`,
+            });
+        }
+        // Build the project DESIGN.md content
+        let content = "# Project Design System\n\n";
+        content += `Generated from: ${fingerprints.map((f) => f.name).join(", ")}\n`;
+        content += `Fusion strategy: ${fusionDecision.selectedStrategy}\n`;
+        content += `User instruction: ${fusionDecision.userInstruction}\n\n`;
+        // Personality
+        content += "## 1. Personality\n\n";
+        const personality = primary?.personality ?? fingerprints.flatMap((f) => f.personality);
+        content += `- ${personality.join(", ")}\n\n`;
+        record("personality", personality.join(", "), primary ? [primary.id] : fingerprints.map((f) => f.id), "adopted");
+        // Visual Metaphor
+        if (primary?.visualMetaphor) {
+            content += "## 2. Visual Metaphor\n\n";
+            content += `${primary.visualMetaphor}\n\n`;
+            record("visual-metaphor", primary.visualMetaphor, [primary.id], "adopted");
+        }
+        // Color System
+        content += "## 3. Color System\n\n";
+        if (primary) {
+            content += "| Role | Hex | Usage |\n|------|-----|-------|\n";
+            for (const hex of primary.colorSystem.canvas) {
+                content += `| Canvas | ${hex} | Page background |\n`;
+                record("canvas", hex, [primary.id], "adopted");
+            }
+            for (const hex of primary.colorSystem.accent) {
+                content += `| Accent | ${hex} | Primary CTA |\n`;
+                record("accent", hex, [primary.id], "adopted");
+            }
+            for (const hex of primary.colorSystem.text) {
+                content += `| Text | ${hex} | Body text |\n`;
+            }
+            if (secondary.length > 0) {
+                for (const s of secondary) {
+                    for (const hex of s.colorSystem.accent) {
+                        content += `| Accent Alt | ${hex} | Secondary accent (from ${s.name}) |\n`;
+                        record("accent-alt", hex, [s.id], "adapted");
+                    }
+                }
+            }
+        }
+        else {
+            // Derived: pull from all
+            for (const fp of fingerprints) {
+                content += `### From ${fp.name}\n\n`;
+                content += `| Role | Hex | Usage |\n|------|-----|-------|\n`;
+                for (const hex of fp.colorSystem.accent) {
+                    content += `| Accent | ${hex} | CTA |\n`;
+                }
+                for (const hex of fp.colorSystem.canvas) {
+                    content += `| Canvas | ${hex} | Background |\n`;
+                }
+            }
+        }
+        content += "\n";
+        // Typography
+        content += "## 4. Typography\n\n";
+        if (primary?.typography.display) {
+            content += `### Display\n- Family: ${primary.typography.display.family}\n`;
+            content += `- Substitutes: ${primary.typography.display.substitutes.join(", ")}\n`;
+            content += `- Sizes: ${primary.typography.display.sizes.join(", ")}\n\n`;
+            record("typography-display", primary.typography.display.family, [primary.id], "adopted");
+        }
+        if (primary?.typography.body) {
+            content += `### Body\n- Family: ${primary.typography.body.family}\n`;
+            content += `- Substitutes: ${primary.typography.body.substitutes.join(", ")}\n`;
+            content += `- Sizes: ${primary.typography.body.sizes.join(", ")}\n\n`;
+            record("typography-body", primary.typography.body.family, [primary.id], "adopted");
+        }
+        // Shape
+        content += "## 5. Shape & Surface\n\n";
+        if (primary) {
+            content += `- Card radius: ${primary.shapeLanguage.cardRadius ?? "16px"}\n`;
+            content += `- Button radius: ${primary.shapeLanguage.buttonRadius ?? "8px"}\n`;
+            content += `- Shadow: ${primary.shapeLanguage.shadowStyle}\n\n`;
+            record("radius", primary.shapeLanguage.cardRadius ?? "16px", [primary.id], "adopted");
+            record("elevation", primary.shapeLanguage.shadowStyle, [primary.id], "adopted");
+        }
+        // Anti-patterns
+        content += "## 6. Anti-patterns\n\n";
+        const allAntiPatterns = [...new Set(fingerprints.flatMap((f) => f.antiPatterns))];
+        for (const ap of allAntiPatterns) {
+            content += `- ${ap}\n`;
+        }
+        record("anti-patterns", `${allAntiPatterns.length} rules`, fingerprints.map((f) => f.id), "derived");
+        // Hard Constraints
+        content += "\n## 7. Hard Constraints\n\n";
+        const allConstraints = [...new Set(fingerprints.flatMap((f) => f.hardConstraints))];
+        for (const hc of allConstraints) {
+            content += `- ${hc}\n`;
+        }
+        // Page-type strategy
+        if (fusionDecision.selectedStrategy === "page-type-split") {
+            content += "\n## 8. Page-type Strategy\n\n";
+            const roles = fusionDecision.finalReferenceRoles;
+            for (const [refId, role] of Object.entries(roles)) {
+                const fp = fingerprints.find((f) => f.id === refId);
+                if (fp) {
+                    content += `- ${role === "primary" ? "Dashboard/App" : "Marketing/Landing"}: ${fp.name} style\n`;
+                }
+            }
+            content += `\nUser notes: ${fusionDecision.userInstruction}\n`;
+        }
+        // Source Map Summary
+        content += "\n## 9. Source Map\n\n";
+        content += "| Decision ID | Dimension | Rule | Source | Treatment |\n";
+        content += "|-------------|-----------|------|--------|-----------|\n";
+        for (const d of decisions) {
+            content += `| ${d.decisionId} | ${d.dimension} | ${d.finalRule.slice(0, 60)} | ${d.sourceReferenceIds.join(", ")} | ${d.treatment} |\n`;
+        }
+        return {
+            schemaVersion: SCHEMA_VERSION,
+            designPath: "/DESIGN.md",
+            fusionBriefPath: "/docs/design-references/design-fusion-brief.md",
+            sourceMapPath: "/docs/ui/design-source-map.md",
+            decisions,
+            content,
+        };
+    }
+}
+//# sourceMappingURL=DesignSystemSynthesizer.js.map

package/dist/design-docs/DesignSystemSynthesizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignSystemSynthesizer.js","sourceRoot":"","sources":["../../src/design-docs/DesignSystemSynthesizer.ts"],"names":[],"mappings":"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"}

package/dist/design-docs/FusionOptionGenerator.d.ts

@@ -0,0 +1,11 @@
+import type { StyleFingerprint, StyleConflictReport, FusionOption } from "@aibloom/schemas";
+/**
+ * Generates 3-5 user-selectable fusion options when multiple design references
+ * have conflicts. Supports: primary-accent, page-type-split, layered-fusion,
+ * contextual-fusion, new-derived-system.
+ */
+export declare class FusionOptionGenerator {
+    generate(fingerprints: StyleFingerprint[], conflictReport: StyleConflictReport): FusionOption[];
+    private buildOption;
+}
+//# sourceMappingURL=FusionOptionGenerator.d.ts.map

package/dist/design-docs/FusionOptionGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FusionOptionGenerator.d.ts","sourceRoot":"","sources":["../../src/design-docs/FusionOptionGenerator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAE5F;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,QAAQ,CACN,YAAY,EAAE,gBAAgB,EAAE,EAChC,cAAc,EAAE,mBAAmB,GAClC,YAAY,EAAE;IA8IjB,OAAO,CAAC,WAAW;CAyBpB"}