@brandsystem/mcp 0.3.0

package/dist/lib/brand-dir.js

@@ -0,0 +1,270 @@
+import { readFile, writeFile, mkdir, access, readdir, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { stringify, parse } from "yaml";
+import { SCHEMA_VERSION, BrandConfigSchema, CoreIdentitySchema, NeedsClarificationSchema, VisualIdentitySchema, MessagingSchema, ContentStrategySchema, TokensFileSchema, BrandRuntimeSchema, InteractionPolicySchema } from "../schemas/index.js";
+export class BrandDir {
+    root;
+    brandPath;
+    locks = new Map();
+    constructor(cwd) {
+        this.root = cwd;
+        this.brandPath = join(cwd, ".brand");
+    }
+    async withLock(filename, fn) {
+        const prev = this.locks.get(filename) ?? Promise.resolve();
+        let resolve;
+        const next = new Promise((r) => { resolve = r; });
+        this.locks.set(filename, next);
+        await prev;
+        try {
+            return await fn();
+        }
+        finally {
+            resolve();
+        }
+    }
+    path(...segments) {
+        const full = join(this.brandPath, ...segments);
+        const resolved = resolve(full);
+        if (!resolved.startsWith(resolve(this.brandPath))) {
+            throw new Error(`Path traversal blocked: ${segments.join("/")}`);
+        }
+        return full;
+    }
+    async exists() {
+        try {
+            await access(this.brandPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async scaffold() {
+        await mkdir(this.brandPath, { recursive: true });
+        await mkdir(this.path("assets", "logo"), { recursive: true });
+    }
+    /**
+     * Scaffold + write initial config and empty core identity in one call.
+     * Shared by brand_start and brand_init to avoid duplicated init logic.
+     */
+    async initBrand(config) {
+        await this.scaffold();
+        await this.writeConfig(config);
+        await this.writeCoreIdentity({
+            schema_version: SCHEMA_VERSION,
+            colors: [],
+            typography: [],
+            logo: [],
+            spacing: null,
+        });
+    }
+    // --- YAML helpers ---
+    async readYaml(filename) {
+        const content = await readFile(this.path(filename), "utf-8");
+        return parse(content);
+    }
+    async writeYaml(filename, data) {
+        await this.withLock(filename, async () => {
+            const content = stringify(data, { lineWidth: 120 });
+            await writeFile(this.path(filename), content, "utf-8");
+        });
+    }
+    // --- JSON helpers ---
+    async readJson(filename) {
+        const content = await readFile(this.path(filename), "utf-8");
+        return JSON.parse(content);
+    }
+    async writeJson(filename, data) {
+        await this.withLock(filename, async () => {
+            const content = JSON.stringify(data, null, 2);
+            await writeFile(this.path(filename), content, "utf-8");
+        });
+    }
+    // --- Config ---
+    async readConfig() {
+        const raw = await this.readYaml("brand.config.yaml");
+        return BrandConfigSchema.parse(raw);
+    }
+    async writeConfig(data) {
+        await this.writeYaml("brand.config.yaml", data);
+    }
+    // --- Core Identity ---
+    async readCoreIdentity() {
+        const raw = await this.readYaml("core-identity.yaml");
+        return CoreIdentitySchema.parse(raw);
+    }
+    async writeCoreIdentity(data) {
+        await this.writeYaml("core-identity.yaml", data);
+    }
+    // --- Tokens ---
+    async readTokens() {
+        const raw = await this.readJson("tokens.json");
+        return TokensFileSchema.parse(raw);
+    }
+    async writeTokens(data) {
+        await this.writeJson("tokens.json", data);
+    }
+    // --- Needs Clarification ---
+    async readClarifications() {
+        const raw = await this.readYaml("needs-clarification.yaml");
+        return NeedsClarificationSchema.parse(raw);
+    }
+    async writeClarifications(data) {
+        await this.writeYaml("needs-clarification.yaml", data);
+    }
+    // --- Visual Identity (Session 2) ---
+    async readVisualIdentity() {
+        const raw = await this.readYaml("visual-identity.yaml");
+        return VisualIdentitySchema.parse(raw);
+    }
+    async writeVisualIdentity(data) {
+        await this.writeYaml("visual-identity.yaml", data);
+    }
+    async hasVisualIdentity() {
+        try {
+            await access(this.path("visual-identity.yaml"));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async writeMarkdown(filename, content) {
+        await this.withLock(filename, async () => {
+            await writeFile(this.path(filename), content, "utf-8");
+        });
+    }
+    async readMarkdown(filename) {
+        return readFile(this.path(filename), "utf-8");
+    }
+    // --- Messaging (Session 3) ---
+    async readMessaging() {
+        const raw = await this.readYaml("messaging.yaml");
+        return MessagingSchema.parse(raw);
+    }
+    async writeMessaging(data) {
+        await this.writeYaml("messaging.yaml", data);
+    }
+    async hasMessaging() {
+        try {
+            await access(this.path("messaging.yaml"));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // --- Content Strategy (Session 4) ---
+    async readStrategy() {
+        const raw = await this.readYaml("strategy.yaml");
+        return ContentStrategySchema.parse(raw);
+    }
+    async writeStrategy(data) {
+        await this.writeYaml("strategy.yaml", data);
+    }
+    async hasStrategy() {
+        try {
+            await access(this.path("strategy.yaml"));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // --- Runtime + Policy ---
+    async readRuntime() {
+        const raw = await this.readJson("brand-runtime.json");
+        return BrandRuntimeSchema.parse(raw);
+    }
+    async writeRuntime(data) {
+        await this.writeJson("brand-runtime.json", data);
+    }
+    async readPolicy() {
+        const raw = await this.readJson("interaction-policy.json");
+        return InteractionPolicySchema.parse(raw);
+    }
+    async writePolicy(data) {
+        await this.writeJson("interaction-policy.json", data);
+    }
+    async hasRuntime() {
+        try {
+            await access(this.path("brand-runtime.json"));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // --- Asset scanning ---
+    async listAssets(subdir) {
+        const dir = this.path("assets", subdir);
+        try {
+            const entries = await readdir(dir);
+            return entries.filter((e) => !e.startsWith(".") && !e.endsWith(".md") && e !== "MANIFEST.yaml");
+        }
+        catch {
+            return [];
+        }
+    }
+    async listAssetDirs() {
+        const assetsDir = this.path("assets");
+        try {
+            const entries = await readdir(assetsDir);
+            const dirs = [];
+            for (const entry of entries) {
+                const s = await stat(join(assetsDir, entry));
+                if (s.isDirectory())
+                    dirs.push(entry);
+            }
+            return dirs;
+        }
+        catch {
+            return [];
+        }
+    }
+    // --- Assets ---
+    async writeAsset(relativePath, content) {
+        const MAX_ASSET_BYTES = 10 * 1024 * 1024; // 10 MB
+        const size = typeof content === "string" ? Buffer.byteLength(content, "utf-8") : content.length;
+        if (size > MAX_ASSET_BYTES) {
+            throw new Error(`Asset "${relativePath}" is ${(size / 1024 / 1024).toFixed(1)}MB, exceeding the 10MB limit`);
+        }
+        await this.withLock(`asset:${relativePath}`, async () => {
+            const fullPath = join(this.brandPath, "assets", relativePath);
+            const resolved = resolve(fullPath);
+            const assetsDir = resolve(this.brandPath, "assets");
+            // Allow writing to .brand/ root for specific files
+            const brandDir = resolve(this.brandPath);
+            if (!resolved.startsWith(assetsDir) && !resolved.startsWith(brandDir)) {
+                throw new Error(`Path traversal blocked: ${relativePath} resolves outside .brand/`);
+            }
+            const dir = resolved.substring(0, resolved.lastIndexOf("/"));
+            await mkdir(dir, { recursive: true });
+            await writeFile(resolved, content, typeof content === "string" ? "utf-8" : undefined);
+        });
+    }
+    async readAsset(relativePath) {
+        return readFile(this.path("assets", relativePath), "utf-8");
+    }
+    // --- Asset Manifests ---
+    async readManifest(subdir) {
+        try {
+            const content = await readFile(this.path("assets", subdir, "MANIFEST.yaml"), "utf-8");
+            const parsed = parse(content);
+            return parsed ?? { assets: [] };
+        }
+        catch {
+            return { assets: [] };
+        }
+    }
+    async writeManifest(subdir, data) {
+        await this.withLock(`manifest:${subdir}`, async () => {
+            const dir = this.path("assets", subdir);
+            await mkdir(dir, { recursive: true });
+            const content = stringify(data, { lineWidth: 120 });
+            await writeFile(join(dir, "MANIFEST.yaml"), content, "utf-8");
+        });
+    }
+}
+//# sourceMappingURL=brand-dir.js.map

package/dist/lib/brand-dir.js.map

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

package/dist/lib/color-namer.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Generate clean, human-readable color names from hex values and roles.
+ * Replaces raw CSS property names with meaningful labels.
+ */
+/**
+ * Generate a clean, human-readable name for a color.
+ *
+ * Priority:
+ * 1. If role is assigned (not "unknown"): capitalize the role
+ * 2. If hex is recognizable: generate from color family
+ * 3. Fall back to hex value
+ */
+export declare function generateColorName(hex: string, role: string): string;
+/**
+ * Determine if a raw name is a CSS artifact that should be replaced
+ * with a clean generated name.
+ */
+export declare function isCssArtifactName(name: string, hex: string): boolean;
+/**
+ * Clean a color name: if it looks like a CSS artifact, replace with
+ * a human-readable generated name. Otherwise keep the original.
+ */
+export declare function cleanColorName(color: {
+    name: string;
+    value: string;
+    role: string;
+}): string;
+//# sourceMappingURL=color-namer.d.ts.map

package/dist/lib/color-namer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-namer.d.ts","sourceRoot":"","sources":["../../src/lib/color-namer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA4GH;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAapE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAK3F"}

package/dist/lib/color-namer.js

@@ -0,0 +1,155 @@
+/**
+ * Generate clean, human-readable color names from hex values and roles.
+ * Replaces raw CSS property names with meaningful labels.
+ */
+function hexToRGB(hex) {
+    const h = hex.replace("#", "");
+    return {
+        r: parseInt(h.substring(0, 2), 16),
+        g: parseInt(h.substring(2, 4), 16),
+        b: parseInt(h.substring(4, 6), 16),
+    };
+}
+function rgbToHSL(rgb) {
+    const r = rgb.r / 255;
+    const g = rgb.g / 255;
+    const b = rgb.b / 255;
+    const max = Math.max(r, g, b);
+    const min = Math.min(r, g, b);
+    const l = (max + min) / 2;
+    let h = 0;
+    let s = 0;
+    if (max !== min) {
+        const d = max - min;
+        s = l > 0.5 ? d / (2 - max - min) : d / (max + min);
+        switch (max) {
+            case r:
+                h = ((g - b) / d + (g < b ? 6 : 0)) / 6;
+                break;
+            case g:
+                h = ((b - r) / d + 2) / 6;
+                break;
+            case b:
+                h = ((r - g) / d + 4) / 6;
+                break;
+        }
+    }
+    return { h: h * 360, s: s * 100, l: l * 100 };
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+/**
+ * Determine the closest color family name from a hex value.
+ * Returns a human-readable name like "Red", "Dark Blue", "Light Coral", etc.
+ */
+function colorFamilyFromHex(hex) {
+    const rgb = hexToRGB(hex);
+    const hsl = rgbToHSL(rgb);
+    // Near-black
+    if (hsl.l < 8)
+        return "Black";
+    // Near-white
+    if (hsl.l > 95)
+        return "White";
+    // Very low saturation = gray
+    if (hsl.s < 10) {
+        if (hsl.l < 30)
+            return "Dark Gray";
+        if (hsl.l < 60)
+            return "Gray";
+        return "Light Gray";
+    }
+    // Determine base hue name
+    let baseName;
+    const h = hsl.h;
+    if (h < 10 || h >= 350)
+        baseName = "Red";
+    else if (h < 25)
+        baseName = "Vermilion";
+    else if (h < 40)
+        baseName = "Orange";
+    else if (h < 50)
+        baseName = "Amber";
+    else if (h < 65)
+        baseName = "Yellow";
+    else if (h < 80)
+        baseName = "Lime";
+    else if (h < 160)
+        baseName = "Green";
+    else if (h < 180)
+        baseName = "Teal";
+    else if (h < 200)
+        baseName = "Cyan";
+    else if (h < 240)
+        baseName = "Blue";
+    else if (h < 270)
+        baseName = "Indigo";
+    else if (h < 290)
+        baseName = "Violet";
+    else if (h < 320)
+        baseName = "Purple";
+    else if (h < 340)
+        baseName = "Magenta";
+    else
+        baseName = "Pink";
+    // Refine: coral range (h 0-20, s 60-100, l 50-70)
+    if (h >= 0 && h < 20 && hsl.s > 60 && hsl.l > 45 && hsl.l < 75) {
+        baseName = "Coral";
+    }
+    // Add lightness modifier
+    if (hsl.l < 25)
+        return `Dark ${baseName}`;
+    if (hsl.l > 75)
+        return `Light ${baseName}`;
+    return baseName;
+}
+/**
+ * Generate a clean, human-readable name for a color.
+ *
+ * Priority:
+ * 1. If role is assigned (not "unknown"): capitalize the role
+ * 2. If hex is recognizable: generate from color family
+ * 3. Fall back to hex value
+ */
+export function generateColorName(hex, role) {
+    // If a meaningful role is assigned, use it
+    if (role && role !== "unknown") {
+        return capitalize(role);
+    }
+    // Generate a name from the hex color
+    return colorFamilyFromHex(hex);
+}
+/**
+ * Determine if a raw name is a CSS artifact that should be replaced
+ * with a clean generated name.
+ */
+export function isCssArtifactName(name, hex) {
+    // CSS property patterns
+    if (/^(color|background|border-color|fill|stroke|outline)/.test(name))
+        return true;
+    // Tailwind-style patterns
+    if (/^(--tw-|tw )/.test(name))
+        return true;
+    // Raw CSS variable names that look like property refs
+    if (/^(ring|shadow|divide|placeholder)/.test(name))
+        return true;
+    // Name contains the hex value itself
+    if (name.includes(hex))
+        return true;
+    // Name is just a CSS property + some value
+    if (/^[\w-]+\s+#[0-9a-f]{3,8}$/i.test(name))
+        return true;
+    return false;
+}
+/**
+ * Clean a color name: if it looks like a CSS artifact, replace with
+ * a human-readable generated name. Otherwise keep the original.
+ */
+export function cleanColorName(color) {
+    if (isCssArtifactName(color.name, color.value)) {
+        return generateColorName(color.value, color.role);
+    }
+    return color.name;
+}
+//# sourceMappingURL=color-namer.js.map

package/dist/lib/color-namer.js.map

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

package/dist/lib/confidence.d.ts

@@ -0,0 +1,19 @@
+import type { Confidence, Source, ColorEntry, TypographyEntry } from "../types/index.js";
+export declare function sourceWins(a: Source, b: Source): Source;
+export declare function confidenceRank(c: Confidence): number;
+/** Should this value go into tokens.json? (high or medium confidence) */
+export declare function isTokenWorthy(confidence: Confidence): boolean;
+/** Should this value go into needs-clarification? (low confidence) */
+export declare function needsClarification(confidence: Confidence): boolean;
+/**
+ * Merge a new color entry into an existing array.
+ * If a color with the same role exists and the new source has higher precedence, replace it.
+ * If same source, keep the one with higher confidence.
+ */
+export declare function mergeColor(existing: ColorEntry[], incoming: ColorEntry): ColorEntry[];
+/**
+ * Merge a new typography entry into an existing array.
+ * Match by family name (case-insensitive).
+ */
+export declare function mergeTypography(existing: TypographyEntry[], incoming: TypographyEntry): TypographyEntry[];
+//# sourceMappingURL=confidence.d.ts.map

package/dist/lib/confidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confidence.d.ts","sourceRoot":"","sources":["../../src/lib/confidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAgBzF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE7D;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAElE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,UAAU,GAAG,UAAU,EAAE,CAqBrF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,eAAe,EAAE,EAC3B,QAAQ,EAAE,eAAe,GACxB,eAAe,EAAE,CAqBnB"}

package/dist/lib/confidence.js

@@ -0,0 +1,66 @@
+/** Source precedence: figma > manual > web */
+const SOURCE_RANK = {
+    figma: 3,
+    manual: 2,
+    web: 1,
+};
+const CONFIDENCE_RANK = {
+    confirmed: 4,
+    high: 3,
+    medium: 2,
+    low: 1,
+};
+export function sourceWins(a, b) {
+    return SOURCE_RANK[a] >= SOURCE_RANK[b] ? a : b;
+}
+export function confidenceRank(c) {
+    return CONFIDENCE_RANK[c];
+}
+/** Should this value go into tokens.json? (high or medium confidence) */
+export function isTokenWorthy(confidence) {
+    return CONFIDENCE_RANK[confidence] >= CONFIDENCE_RANK.medium;
+}
+/** Should this value go into needs-clarification? (low confidence) */
+export function needsClarification(confidence) {
+    return CONFIDENCE_RANK[confidence] <= CONFIDENCE_RANK.low;
+}
+/**
+ * Merge a new color entry into an existing array.
+ * If a color with the same role exists and the new source has higher precedence, replace it.
+ * If same source, keep the one with higher confidence.
+ */
+export function mergeColor(existing, incoming) {
+    const idx = existing.findIndex((e) => e.role === incoming.role && e.role !== "unknown");
+    if (idx === -1) {
+        return [...existing, incoming];
+    }
+    const current = existing[idx];
+    if (SOURCE_RANK[incoming.source] > SOURCE_RANK[current.source] ||
+        (incoming.source === current.source &&
+            CONFIDENCE_RANK[incoming.confidence] > CONFIDENCE_RANK[current.confidence])) {
+        const result = [...existing];
+        result[idx] = incoming;
+        return result;
+    }
+    return existing;
+}
+/**
+ * Merge a new typography entry into an existing array.
+ * Match by family name (case-insensitive).
+ */
+export function mergeTypography(existing, incoming) {
+    const idx = existing.findIndex((e) => e.family.toLowerCase() === incoming.family.toLowerCase() && e.name === incoming.name);
+    if (idx === -1) {
+        return [...existing, incoming];
+    }
+    const current = existing[idx];
+    if (SOURCE_RANK[incoming.source] > SOURCE_RANK[current.source] ||
+        (incoming.source === current.source &&
+            CONFIDENCE_RANK[incoming.confidence] > CONFIDENCE_RANK[current.confidence])) {
+        const result = [...existing];
+        result[idx] = incoming;
+        return result;
+    }
+    return existing;
+}
+//# sourceMappingURL=confidence.js.map

package/dist/lib/confidence.js.map

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

package/dist/lib/content-scorer.d.ts

@@ -0,0 +1,38 @@
+import { BrandDir } from "./brand-dir.js";
+import type { CoreIdentityData, VisualIdentityData, MessagingData } from "../schemas/index.js";
+export interface DimensionScore {
+    score: number;
+    weight: number;
+    details: Record<string, unknown>;
+}
+export interface ContentScore {
+    overall: number;
+    dimensions: {
+        token_compliance?: DimensionScore;
+        visual_compliance?: DimensionScore;
+        voice_alignment?: DimensionScore;
+        message_coverage?: DimensionScore;
+    };
+    dimensions_available: string[];
+    dimensions_locked: string[];
+    issues: ContentIssue[];
+}
+export interface ContentIssue {
+    dimension: string;
+    severity: "critical" | "warning" | "info";
+    message: string;
+    detail?: string;
+}
+export interface BrandContext {
+    identity: CoreIdentityData;
+    visual: VisualIdentityData | null;
+    messaging: MessagingData | null;
+    config: {
+        client_name: string;
+        session: number;
+    };
+}
+export declare function loadBrandContext(brandDir: BrandDir): Promise<BrandContext>;
+export declare function isHtmlContent(content: string): boolean;
+export declare function scoreContent(content: string, isHtml: boolean, ctx: BrandContext): ContentScore;
+//# sourceMappingURL=content-scorer.d.ts.map

package/dist/lib/content-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-scorer.d.ts","sourceRoot":"","sources":["../../src/lib/content-scorer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,EACV,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,EACd,MAAM,qBAAqB,CAAC;AAO7B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,gBAAgB,CAAC,EAAE,cAAc,CAAC;QAClC,iBAAiB,CAAC,EAAE,cAAc,CAAC;QACnC,eAAe,CAAC,EAAE,cAAc,CAAC;QACjC,gBAAgB,CAAC,EAAE,cAAc,CAAC;KACnC,CAAC;IACF,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AA4ND,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CA0BhF;AAMD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEtD;AAMD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,YAAY,GAChB,YAAY,CAyDd"}