@buoy-design/core 0.1.1 → 0.1.2

package/dist/graph/collectors/usages.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Usage Collector
+ *
+ * Finds where tokens and components are used across the codebase.
+ * Detects CSS variables, Tailwind classes, and hardcoded values.
+ */
+export type UsageType = 'css-var' | 'tailwind' | 'js-import' | 'hardcoded' | 'scss-var';
+export interface TokenUsage {
+    tokenName: string;
+    filePath: string;
+    lineNumber: number;
+    columnNumber: number;
+    usageType: UsageType;
+    context: string;
+    rawValue?: string;
+}
+export interface ComponentUsage {
+    componentName: string;
+    filePath: string;
+    lineNumber: number;
+    propsUsed: string[];
+    hasChildren: boolean;
+    context: string;
+}
+export interface UsageCollectorOptions {
+    /** Root directory to scan */
+    projectRoot: string;
+    /** File patterns to include */
+    include?: string[];
+    /** File patterns to exclude */
+    exclude?: string[];
+    /** Known token names to match against */
+    knownTokens?: string[];
+    /** Known component names to match against */
+    knownComponents?: string[];
+}
+export interface UsageCollectorResult {
+    tokenUsages: TokenUsage[];
+    componentUsages: ComponentUsage[];
+    hardcodedValues: TokenUsage[];
+    stats: {
+        filesScanned: number;
+        tokenUsagesFound: number;
+        componentUsagesFound: number;
+        hardcodedValuesFound: number;
+    };
+}
+/**
+ * Collect token and component usages from the codebase
+ */
+export declare function collectUsages(options: UsageCollectorOptions): Promise<UsageCollectorResult>;
+/**
+ * Find all hardcoded color values in the codebase
+ */
+export declare function findHardcodedColors(projectRoot: string): Promise<TokenUsage[]>;
+/**
+ * Find all CSS variable usages
+ */
+export declare function findCSSVariableUsages(projectRoot: string): Promise<TokenUsage[]>;
+/**
+ * Find usages of a specific token
+ */
+export declare function findTokenUsagesInFiles(projectRoot: string, tokenName: string): Promise<TokenUsage[]>;
+/**
+ * Find usages of a specific component
+ */
+export declare function findComponentUsagesInFiles(projectRoot: string, componentName: string): Promise<ComponentUsage[]>;
+//# sourceMappingURL=usages.d.ts.map

package/dist/graph/collectors/usages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usages.d.ts","sourceRoot":"","sources":["../../../src/graph/collectors/usages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAC;AAExF,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AA+BD;;GAEG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAiI/B;AA4JD;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAQvB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC,CAMvB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,EAAE,CAAC,CAM3B"}

package/dist/graph/collectors/usages.js

@@ -0,0 +1,244 @@
+/**
+ * Usage Collector
+ *
+ * Finds where tokens and components are used across the codebase.
+ * Detects CSS variables, Tailwind classes, and hardcoded values.
+ */
+import { readFile } from 'fs/promises';
+import { glob } from 'glob';
+import { join } from 'path';
+// ============================================================================
+// Patterns
+// ============================================================================
+// CSS variable usage: var(--name) or var(--name, fallback)
+const CSS_VAR_PATTERN = /var\(\s*--([a-zA-Z0-9_-]+)(?:\s*,\s*[^)]+)?\s*\)/g;
+// SCSS variable usage: $name
+const SCSS_VAR_PATTERN = /\$([a-zA-Z][a-zA-Z0-9_-]*)/g;
+// Tailwind arbitrary value: [#fff] or [16px]
+const TAILWIND_ARBITRARY_PATTERN = /(?:bg|text|border|ring|shadow|fill|stroke)-\[([^\]]+)\]/g;
+// Hardcoded hex colors: #fff, #ffffff, #ffffffff
+const HEX_COLOR_PATTERN = /#([0-9a-fA-F]{3,8})\b/g;
+// Hardcoded RGB/RGBA: rgb(255, 255, 255), rgba(0, 0, 0, 0.5)
+const RGB_PATTERN = /rgba?\(\s*\d+\s*,\s*\d+\s*,\s*\d+(?:\s*,\s*[\d.]+)?\s*\)/g;
+// Hardcoded HSL: hsl(0, 0%, 100%), hsla(0, 0%, 0%, 0.5)
+const HSL_PATTERN = /hsla?\(\s*\d+\s*,\s*[\d.]+%\s*,\s*[\d.]+%(?:\s*,\s*[\d.]+)?\s*\)/g;
+// JSX component usage: <ComponentName ... />
+const JSX_COMPONENT_PATTERN = /<([A-Z][a-zA-Z0-9]*)\s*(?:[^>]*?)(?:\/>|>)/g;
+// ============================================================================
+// Collector
+// ============================================================================
+/**
+ * Collect token and component usages from the codebase
+ */
+export async function collectUsages(options) {
+    const { projectRoot, include = ['**/*.{ts,tsx,js,jsx,vue,svelte,css,scss,sass,less}'], exclude = ['**/node_modules/**', '**/dist/**', '**/build/**', '**/.next/**'], } = options;
+    // Find all matching files
+    const files = await glob(include, {
+        cwd: projectRoot,
+        ignore: exclude,
+        absolute: false,
+    });
+    const tokenUsages = [];
+    const componentUsages = [];
+    const hardcodedValues = [];
+    for (const file of files) {
+        const fullPath = join(projectRoot, file);
+        let content;
+        try {
+            content = await readFile(fullPath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split('\n');
+        // Collect CSS variable usages
+        collectPatternUsages(content, lines, file, CSS_VAR_PATTERN, 'css-var', tokenUsages);
+        // Collect SCSS variable usages
+        if (file.endsWith('.scss') || file.endsWith('.sass')) {
+            collectPatternUsages(content, lines, file, SCSS_VAR_PATTERN, 'scss-var', tokenUsages);
+        }
+        // Collect hardcoded colors
+        collectPatternUsages(content, lines, file, HEX_COLOR_PATTERN, 'hardcoded', hardcodedValues, true);
+        collectPatternUsages(content, lines, file, RGB_PATTERN, 'hardcoded', hardcodedValues, true);
+        collectPatternUsages(content, lines, file, HSL_PATTERN, 'hardcoded', hardcodedValues, true);
+        // Collect Tailwind arbitrary values
+        collectPatternUsages(content, lines, file, TAILWIND_ARBITRARY_PATTERN, 'tailwind', hardcodedValues, true);
+        // Collect component usages (JSX files only)
+        if (file.endsWith('.tsx') || file.endsWith('.jsx') || file.endsWith('.vue')) {
+            collectComponentUsages(content, lines, file, componentUsages, options.knownComponents);
+        }
+    }
+    // Filter to known tokens if provided
+    let filteredTokenUsages = tokenUsages;
+    if (options.knownTokens && options.knownTokens.length > 0) {
+        const knownSet = new Set(options.knownTokens.map(t => t.toLowerCase()));
+        filteredTokenUsages = tokenUsages.filter(u => knownSet.has(u.tokenName.toLowerCase()));
+    }
+    // Filter to known components if provided
+    let filteredComponentUsages = componentUsages;
+    if (options.knownComponents && options.knownComponents.length > 0) {
+        const knownSet = new Set(options.knownComponents);
+        filteredComponentUsages = componentUsages.filter(u => knownSet.has(u.componentName));
+    }
+    return {
+        tokenUsages: filteredTokenUsages,
+        componentUsages: filteredComponentUsages,
+        hardcodedValues,
+        stats: {
+            filesScanned: files.length,
+            tokenUsagesFound: filteredTokenUsages.length,
+            componentUsagesFound: filteredComponentUsages.length,
+            hardcodedValuesFound: hardcodedValues.length,
+        },
+    };
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function collectPatternUsages(content, lines, filePath, pattern, usageType, usages, storeRawValue = false) {
+    // Reset pattern state
+    pattern.lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const { lineNumber, columnNumber } = getPosition(content, match.index);
+        const line = lines[lineNumber - 1] ?? '';
+        // Skip if in a comment
+        if (isInComment(line, columnNumber))
+            continue;
+        // Get context (surrounding lines)
+        const contextStart = Math.max(0, lineNumber - 2);
+        const contextEnd = Math.min(lines.length, lineNumber + 1);
+        const context = lines.slice(contextStart, contextEnd).join('\n');
+        usages.push({
+            tokenName: match[1] ?? match[0],
+            filePath,
+            lineNumber,
+            columnNumber,
+            usageType,
+            context,
+            rawValue: storeRawValue ? match[0] : undefined,
+        });
+    }
+}
+function collectComponentUsages(content, lines, filePath, usages, knownComponents) {
+    const pattern = new RegExp(JSX_COMPONENT_PATTERN.source, 'g');
+    // Built-in HTML elements and React fragments to skip
+    const skipComponents = new Set([
+        'Fragment',
+        'React',
+        'Suspense',
+        'StrictMode',
+        'Provider',
+        'Consumer',
+    ]);
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        const componentName = match[1];
+        if (!componentName)
+            continue;
+        // Skip built-in/common wrappers
+        if (skipComponents.has(componentName))
+            continue;
+        // If we have known components, only include those
+        if (knownComponents && !knownComponents.includes(componentName))
+            continue;
+        const { lineNumber, columnNumber } = getPosition(content, match.index);
+        const line = lines[lineNumber - 1] ?? '';
+        // Skip if in a comment
+        if (isInComment(line, columnNumber))
+            continue;
+        // Extract props from the JSX
+        const propsUsed = extractProps(match[0]);
+        // Check if has children (not self-closing)
+        const hasChildren = !match[0].endsWith('/>');
+        // Get context
+        const contextStart = Math.max(0, lineNumber - 2);
+        const contextEnd = Math.min(lines.length, lineNumber + 2);
+        const context = lines.slice(contextStart, contextEnd).join('\n');
+        usages.push({
+            componentName,
+            filePath,
+            lineNumber,
+            propsUsed,
+            hasChildren,
+            context,
+        });
+    }
+}
+function getPosition(content, index) {
+    const before = content.slice(0, index);
+    const lineNumber = (before.match(/\n/g) ?? []).length + 1;
+    const lastNewline = before.lastIndexOf('\n');
+    const columnNumber = index - lastNewline;
+    return { lineNumber, columnNumber };
+}
+function isInComment(line, column) {
+    // Check for // comment before the position
+    const commentIndex = line.indexOf('//');
+    if (commentIndex !== -1 && commentIndex < column) {
+        return true;
+    }
+    // Check for /* comment (simplified - doesn't handle multi-line)
+    const blockCommentStart = line.indexOf('/*');
+    const blockCommentEnd = line.indexOf('*/');
+    if (blockCommentStart !== -1 &&
+        blockCommentStart < column &&
+        (blockCommentEnd === -1 || blockCommentEnd > column)) {
+        return true;
+    }
+    return false;
+}
+function extractProps(jsxString) {
+    const props = [];
+    // Simple regex to extract prop names
+    // Matches: propName= or propName (for boolean props)
+    const propPattern = /\s([a-zA-Z][a-zA-Z0-9]*)(?:=|\s|\/?>)/g;
+    let match;
+    while ((match = propPattern.exec(jsxString)) !== null) {
+        const propName = match[1];
+        if (propName && !['className', 'style', 'key', 'ref'].includes(propName)) {
+            props.push(propName);
+        }
+    }
+    return [...new Set(props)];
+}
+// ============================================================================
+// Specialized Collectors
+// ============================================================================
+/**
+ * Find all hardcoded color values in the codebase
+ */
+export async function findHardcodedColors(projectRoot) {
+    const result = await collectUsages({ projectRoot });
+    return result.hardcodedValues.filter((u) => u.rawValue?.startsWith('#') ||
+        u.rawValue?.startsWith('rgb') ||
+        u.rawValue?.startsWith('hsl'));
+}
+/**
+ * Find all CSS variable usages
+ */
+export async function findCSSVariableUsages(projectRoot) {
+    const result = await collectUsages({ projectRoot });
+    return result.tokenUsages.filter((u) => u.usageType === 'css-var');
+}
+/**
+ * Find usages of a specific token
+ */
+export async function findTokenUsagesInFiles(projectRoot, tokenName) {
+    const result = await collectUsages({
+        projectRoot,
+        knownTokens: [tokenName],
+    });
+    return result.tokenUsages;
+}
+/**
+ * Find usages of a specific component
+ */
+export async function findComponentUsagesInFiles(projectRoot, componentName) {
+    const result = await collectUsages({
+        projectRoot,
+        knownComponents: [componentName],
+    });
+    return result.componentUsages;
+}
+//# sourceMappingURL=usages.js.map

package/dist/graph/collectors/usages.js.map

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

package/dist/graph/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Design System Knowledge Graph
+ *
+ * A graph-based representation of the design system that enables
+ * powerful queries about relationships, impact, and ownership.
+ */
+export * from './types.js';
+export { createGraph, nodeId, edgeId, addNode, updateNode, addEdge, getNodesByType, getEdgesByType, getOutEdgesByType, getInEdgesByType, getGraphStats, exportToJSON, importFromJSON, exportToDOT, exportToCytoscape, GraphBuilder, type DesignSystemGraph, } from './builder.js';
+export { findTokenUsages, findUnusedTokens, findDriftingTokens, findComponentRenderers, findUntestedComponents, findUndocumentedComponents, analyzeImpact, findOwnership, findDriftAuthor, findRepeatOffenders, findDeprecatedUsages, findDriftInPR, findFilesChangedInPR, calculateCoverage, } from './queries.js';
+export * from './collectors/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,WAAW,EACX,MAAM,EACN,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,EACP,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAEL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAElB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAE1B,aAAa,EAEb,aAAa,EACb,eAAe,EAEf,mBAAmB,EACnB,oBAAoB,EAEpB,aAAa,EACb,oBAAoB,EAEpB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAGtB,cAAc,uBAAuB,CAAC"}

package/dist/graph/index.js

@@ -0,0 +1,29 @@
+/**
+ * Design System Knowledge Graph
+ *
+ * A graph-based representation of the design system that enables
+ * powerful queries about relationships, impact, and ownership.
+ */
+// Types
+export * from './types.js';
+// Graph building
+export { createGraph, nodeId, edgeId, addNode, updateNode, addEdge, getNodesByType, getEdgesByType, getOutEdgesByType, getInEdgesByType, getGraphStats, exportToJSON, importFromJSON, exportToDOT, exportToCytoscape, GraphBuilder, } from './builder.js';
+// Queries
+export { 
+// Token queries
+findTokenUsages, findUnusedTokens, findDriftingTokens, 
+// Component queries
+findComponentRenderers, findUntestedComponents, findUndocumentedComponents, 
+// Impact analysis
+analyzeImpact, 
+// Ownership
+findOwnership, findDriftAuthor, 
+// Pattern detection
+findRepeatOffenders, findDeprecatedUsages, 
+// PR analysis
+findDriftInPR, findFilesChangedInPR, 
+// Coverage
+calculateCoverage, } from './queries.js';
+// Collectors
+export * from './collectors/index.js';
+//# sourceMappingURL=index.js.map

package/dist/graph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,QAAQ;AACR,cAAc,YAAY,CAAC;AAE3B,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,MAAM,EACN,MAAM,EACN,OAAO,EACP,UAAU,EACV,OAAO,EACP,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,YAAY,GAEb,MAAM,cAAc,CAAC;AAEtB,UAAU;AACV,OAAO;AACL,gBAAgB;AAChB,eAAe,EACf,gBAAgB,EAChB,kBAAkB;AAClB,oBAAoB;AACpB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B;AAC1B,kBAAkB;AAClB,aAAa;AACb,YAAY;AACZ,aAAa,EACb,eAAe;AACf,oBAAoB;AACpB,mBAAmB,EACnB,oBAAoB;AACpB,cAAc;AACd,aAAa,EACb,oBAAoB;AACpB,WAAW;AACX,iBAAiB,GAClB,MAAM,cAAc,CAAC;AAEtB,aAAa;AACb,cAAc,uBAAuB,CAAC"}

package/dist/graph/queries.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Graph Queries
+ *
+ * Query functions for analyzing the design system graph.
+ * Enables questions like "Who introduced this drift?" and "What uses this token?"
+ */
+import type { ImpactAnalysis, OwnershipInfo, UsageInfo } from './types.js';
+import { type DesignSystemGraph } from './builder.js';
+/**
+ * Find all usages of a token across the codebase
+ */
+export declare function findTokenUsages(graph: DesignSystemGraph, tokenId: string): UsageInfo;
+/**
+ * Find tokens that are defined but never used
+ */
+export declare function findUnusedTokens(graph: DesignSystemGraph): string[];
+/**
+ * Find tokens that drift from their W3C definition
+ */
+export declare function findDriftingTokens(graph: DesignSystemGraph): Array<{
+    tokenId: string;
+    expectedValue: string;
+    actualValue: string;
+}>;
+/**
+ * Find all components that render a given component
+ */
+export declare function findComponentRenderers(graph: DesignSystemGraph, componentId: string): string[];
+/**
+ * Find components without test coverage
+ */
+export declare function findUntestedComponents(graph: DesignSystemGraph): string[];
+/**
+ * Find components without Storybook documentation
+ */
+export declare function findUndocumentedComponents(graph: DesignSystemGraph): string[];
+/**
+ * Analyze the impact of changing a token or component
+ */
+export declare function analyzeImpact(graph: DesignSystemGraph, entityId: string, maxDepth?: number): ImpactAnalysis;
+/**
+ * Find who owns a file or component based on git history
+ */
+export declare function findOwnership(graph: DesignSystemGraph, entityId: string): OwnershipInfo | null;
+/**
+ * Find who introduced a drift signal
+ */
+export declare function findDriftAuthor(graph: DesignSystemGraph, driftSignalId: string): string | null;
+/**
+ * Find files that frequently have drift (repeat offenders)
+ */
+export declare function findRepeatOffenders(graph: DesignSystemGraph, threshold?: number): Array<{
+    file: string;
+    driftCount: number;
+}>;
+/**
+ * Find deprecated tokens that are still being used
+ */
+export declare function findDeprecatedUsages(graph: DesignSystemGraph): Array<{
+    token: string;
+    usageCount: number;
+    usedIn: string[];
+}>;
+/**
+ * Find drift signals in a specific PR
+ */
+export declare function findDriftInPR(graph: DesignSystemGraph, prId: string): string[];
+/**
+ * Find what files were changed in a PR
+ */
+export declare function findFilesChangedInPR(graph: DesignSystemGraph, prId: string): string[];
+/**
+ * Calculate design system coverage metrics
+ */
+export declare function calculateCoverage(graph: DesignSystemGraph): {
+    tokenCoverage: number;
+    componentCoverage: number;
+    testCoverage: number;
+    storyCoverage: number;
+};
+//# sourceMappingURL=queries.d.ts.map

package/dist/graph/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/graph/queries.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAIV,cAAc,EACd,aAAa,EACb,SAAS,EACV,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,iBAAiB,EAKvB,MAAM,cAAc,CAAC;AAMtB;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,GACd,SAAS,CA8BX;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAKnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,GACvB,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BxE;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAmBV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAKzE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAK7E;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,SAAI,GACX,cAAc,CAuEhB;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,MAAM,GACf,aAAa,GAAG,IAAI,CAgEtB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,iBAAiB,EACxB,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,IAAI,CAoCf;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,iBAAiB,EACxB,SAAS,SAAI,GACZ,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,GACvB,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgChE;AAMD;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CAiBV;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,EAAE,CA2BV;AAMD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB,CA6BA"}