@libar-dev/architect 1.0.0-pre.3

package/dist/scanner/gherkin-ast-parser.js

@@ -0,0 +1,507 @@
+/**
+ * @architect
+ * @architect-scanner
+ * @architect-pattern GherkinASTParser
+ * @architect-status completed
+ * @architect-implements GherkinRulesSupport
+ * @architect-uses GherkinTypes
+ * @architect-used-by GherkinScanner
+ * @architect-arch-role infrastructure
+ * @architect-arch-context scanner
+ * @architect-arch-layer infrastructure
+ *
+ * ## GherkinASTParser - Parse Feature Files Using Cucumber Gherkin
+ *
+ * Parses Gherkin feature files using @cucumber/gherkin and extracts structured data
+ * including feature metadata, tags, scenarios, and steps.
+ *
+ * ### Supported Formats
+ *
+ * - **Classic Gherkin** (`.feature`) - Standard Gherkin syntax
+ * - **MDG - Markdown with Gherkin** (`.feature.md`) - Rich Markdown with embedded Gherkin
+ *
+ * MDG files use Markdown headers for keywords (`# Feature:`, `## Scenario:`) and
+ * list items for steps (`* Given`, `* When`, `* Then`). They render beautifully
+ * in GitHub while remaining parseable for documentation generation.
+ *
+ * ### Rule Keyword Support
+ *
+ * Both formats support the Gherkin v6+ `Rule:` keyword for grouping scenarios
+ * under business rules. Scenarios inside Rules are extracted with a synthetic
+ * `rule:Rule-Name` tag for traceability.
+ *
+ * ### When to Use
+ *
+ * - When parsing Gherkin .feature files for pattern extraction
+ * - When parsing MDG .feature.md files for PRD generation
+ * - When converting acceptance criteria to documentation
+ * - When building multi-source documentation pipelines
+ */
+import { Parser, AstBuilder, GherkinClassicTokenMatcher, GherkinInMarkdownTokenMatcher, } from '@cucumber/gherkin';
+import * as Messages from '@cucumber/messages';
+import { GherkinFeatureSchema, GherkinScenarioSchema, GherkinBackgroundSchema, GherkinRuleSchema, } from '../validation-schemas/feature.js';
+import { Result as R } from '../types/index.js';
+import { buildRegistry, } from '../taxonomy/index.js';
+import { createRegexBuilders } from '../config/regex-builders.js';
+import { createDefaultTagRegistry } from '../validation-schemas/tag-registry.js';
+/**
+ * Default regex builders for tag normalization.
+ * Uses the default registry configuration.
+ */
+const DEFAULT_BUILDERS = (() => {
+    const registry = createDefaultTagRegistry();
+    return createRegexBuilders(registry.tagPrefix, registry.fileOptInTag);
+})();
+/**
+ * Module-level lookup map from tag name to its registry definition.
+ * Built once from the TagRegistry, reused across all extractPatternTags() calls.
+ */
+const TAG_LOOKUP = new Map(buildRegistry().metadataTags.map((def) => [def.tag, def]));
+/** Convert kebab-case to camelCase (e.g., "depends-on" → "dependsOn") */
+function kebabToCamel(s) {
+    return s.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+/**
+ * Normalize a Gherkin tag by stripping prefixes
+ *
+ * Removes `@` prefix and then the configured tag prefix (from registry)
+ * to produce a canonical tag name.
+ *
+ * @param tag - Tag string to normalize (e.g., "@architect-pattern:MyPattern")
+ * @param registry - Optional TagRegistry for custom prefix configuration
+ * @returns Normalized tag name (e.g., "pattern:MyPattern")
+ *
+ * @example
+ * normalizeTag("@architect-pattern:MyPattern") // "pattern:MyPattern"
+ * normalizeTag("@acceptance-criteria")          // "acceptance-criteria"
+ *
+ * // With custom registry
+ * const registry = { tagPrefix: "@acme-", fileOptInTag: "@acme", ... };
+ * normalizeTag("@acme-pattern:MyPattern", registry) // "pattern:MyPattern"
+ */
+function normalizeTag(tag, registry) {
+    // Use registry-based builders if provided, otherwise use defaults
+    const builders = registry
+        ? createRegexBuilders(registry.tagPrefix, registry.fileOptInTag)
+        : DEFAULT_BUILDERS;
+    // Normalize using the registry-configured prefix
+    let normalized = builders.normalizeTag(tag);
+    // Strip @ prefix if still present after normalization
+    if (normalized.startsWith('@')) {
+        normalized = normalized.substring(1);
+    }
+    return normalized;
+}
+/**
+ * Extract a DataTable from a Cucumber Messages DataTable
+ *
+ * Converts the Cucumber AST DataTable format to our simplified structure
+ * with headers and row objects.
+ *
+ * @param dataTable - Cucumber Messages DataTable
+ * @returns GherkinDataTable with headers and rows
+ */
+function extractDataTable(dataTable) {
+    const rows = dataTable.rows;
+    if (rows.length === 0) {
+        return { headers: [], rows: [] };
+    }
+    // First row is headers
+    const headerRow = rows[0];
+    const headers = headerRow?.cells.map((cell) => cell.value) ?? [];
+    // Remaining rows are data
+    const dataRows = [];
+    for (let i = 1; i < rows.length; i++) {
+        const row = rows[i];
+        if (!row)
+            continue;
+        const rowObj = {};
+        for (let j = 0; j < headers.length; j++) {
+            const header = headers[j];
+            const cell = row.cells[j];
+            if (header !== undefined) {
+                rowObj[header] = cell?.value ?? '';
+            }
+        }
+        dataRows.push(rowObj);
+    }
+    return { headers, rows: dataRows };
+}
+/**
+ * Extract steps from Cucumber AST steps, including DataTables and DocStrings
+ *
+ * @param steps - Cucumber AST steps
+ * @returns Array of GherkinStep with optional dataTable and docString
+ */
+function extractSteps(steps) {
+    return steps.map((step) => {
+        const gherkinStep = {
+            keyword: step.keyword.trim(),
+            text: step.text,
+            ...(step.dataTable && { dataTable: extractDataTable(step.dataTable) }),
+            ...(step.docString && {
+                docString: {
+                    content: step.docString.content,
+                    ...(step.docString.mediaType && { mediaType: step.docString.mediaType }),
+                },
+            }),
+        };
+        return gherkinStep;
+    });
+}
+/**
+ * Extract Examples tables from a Scenario Outline
+ *
+ * Converts Cucumber AST Examples tables to our simplified structure with
+ * headers and row objects. Each Examples block can have its own name and tags.
+ *
+ * @param examples - Cucumber AST Examples array from a Scenario Outline
+ * @param registry - Optional TagRegistry for tag normalization
+ * @returns Array of GherkinExamples with headers and rows
+ */
+function extractExamples(examples, registry) {
+    return examples
+        .filter((ex) => ex.tableHeader) // Only process examples with valid headers
+        .map((ex) => {
+        // Extract headers from tableHeader
+        const headers = ex.tableHeader?.cells.map((c) => c.value) ?? [];
+        // Extract rows as header->value maps
+        const rows = ex.tableBody.map((row) => {
+            const rowObj = {};
+            headers.forEach((h, i) => {
+                rowObj[h] = row.cells[i]?.value ?? '';
+            });
+            return rowObj;
+        });
+        const desc = ex.description.trim();
+        return {
+            name: ex.name,
+            ...(desc && { description: desc }),
+            tags: ex.tags.map((t) => normalizeTag(t.name, registry)),
+            headers,
+            rows,
+            line: ex.location.line,
+        };
+    });
+}
+/**
+ * Parse a Gherkin feature file and extract structured data
+ *
+ * @param content - Feature file content
+ * @param filePath - Path to the feature file (for error reporting)
+ * @returns Result containing parsed feature data or error
+ *
+ * @example
+ * ```typescript
+ * const content = `
+ * @pattern:MyPattern @phase:15 @status:roadmap
+ * Feature: My Pattern
+ *   A description of the pattern.
+ *
+ *   @acceptance-criteria
+ *   Scenario: Happy path
+ *     Given initial state
+ *     When action occurs
+ *     Then outcome happens
+ * `;
+ *
+ * const result = parseFeatureFile(content, 'my-pattern.feature');
+ * if (result.ok) {
+ *   const { feature, scenarios } = result.value;
+ *   console.log(feature.name); // "My Pattern"
+ *   console.log(feature.tags); // ["pattern:MyPattern", "phase:15", "status:roadmap"]
+ *   console.log(scenarios.length); // 1
+ * }
+ * ```
+ */
+export function parseFeatureFile(content, filePath) {
+    try {
+        // Detect MDG (Markdown with Gherkin) format based on file extension
+        // MDG files use .feature.md extension and require GherkinInMarkdownTokenMatcher
+        const isMDG = filePath.endsWith('.feature.md');
+        const tokenMatcher = isMDG
+            ? new GherkinInMarkdownTokenMatcher()
+            : new GherkinClassicTokenMatcher();
+        const parser = new Parser(new AstBuilder(Messages.IdGenerator.uuid()), tokenMatcher);
+        const gherkinDocument = parser.parse(content);
+        if (!gherkinDocument.feature) {
+            return R.err({
+                file: filePath,
+                error: {
+                    message: 'No feature found in file',
+                },
+            });
+        }
+        const cucumberFeature = gherkinDocument.feature;
+        // Extract feature-level data
+        const feature = {
+            name: cucumberFeature.name,
+            description: cucumberFeature.description.trim(),
+            tags: cucumberFeature.tags.map((tag) => normalizeTag(tag.name)),
+            language: cucumberFeature.language,
+            line: cucumberFeature.location.line,
+        };
+        // Extract background (if present)
+        let background;
+        // Extract rules (Gherkin v6+ business rule groupings)
+        const rules = [];
+        // Extract scenarios (including those nested inside Rules)
+        const scenarios = [];
+        for (const child of cucumberFeature.children) {
+            // Handle Background section
+            if (child.background) {
+                const bg = child.background;
+                const desc = bg.description.trim();
+                background = {
+                    name: bg.name,
+                    // Use spread to conditionally include description (exactOptionalPropertyTypes)
+                    ...(desc && { description: desc }),
+                    steps: extractSteps(bg.steps),
+                    line: bg.location.line,
+                };
+            }
+            // Handle Scenario (at feature level)
+            else if (child.scenario) {
+                const scenario = child.scenario;
+                const examples = extractExamples(scenario.examples);
+                scenarios.push({
+                    name: scenario.name,
+                    description: scenario.description.trim(),
+                    tags: scenario.tags.map((tag) => normalizeTag(tag.name)),
+                    steps: extractSteps(scenario.steps),
+                    ...(examples.length > 0 && { examples }),
+                    line: scenario.location.line,
+                });
+            }
+            // Handle Rule keyword (Gherkin v6+) - capture as first-class entity
+            // Rules group scenarios under business rules with rich descriptions
+            else if (child.rule) {
+                const cucumberRule = child.rule;
+                const ruleTags = cucumberRule.tags.map((tag) => normalizeTag(tag.name));
+                const ruleScenarios = [];
+                // Extract scenarios nested inside the Rule
+                for (const ruleChild of cucumberRule.children) {
+                    if (ruleChild.scenario) {
+                        const scenario = ruleChild.scenario;
+                        const scenarioTags = scenario.tags.map((tag) => normalizeTag(tag.name));
+                        const examples = extractExamples(scenario.examples);
+                        const parsedScenario = {
+                            name: scenario.name,
+                            description: scenario.description.trim(),
+                            tags: scenarioTags,
+                            steps: extractSteps(scenario.steps),
+                            ...(examples.length > 0 && { examples }),
+                            line: scenario.location.line,
+                        };
+                        // Add to rule's scenarios
+                        ruleScenarios.push(parsedScenario);
+                        // Also add to flat list for consumer convenience
+                        // Include rule context in scenario tags for traceability
+                        const ruleNameTag = `rule:${cucumberRule.name.replace(/\s+/g, '-')}`;
+                        scenarios.push({
+                            ...parsedScenario,
+                            // Merge rule tags with scenario tags, add rule context
+                            tags: [...ruleTags, ...scenarioTags, ruleNameTag],
+                        });
+                    }
+                    // Handle Background inside Rule
+                    else if (ruleChild.background && !background) {
+                        const bg = ruleChild.background;
+                        const desc = bg.description.trim();
+                        background = {
+                            name: bg.name,
+                            ...(desc && { description: desc }),
+                            steps: extractSteps(bg.steps),
+                            line: bg.location.line,
+                        };
+                    }
+                }
+                // Add the rule with its scenarios
+                rules.push({
+                    name: cucumberRule.name,
+                    description: cucumberRule.description.trim(),
+                    tags: ruleTags,
+                    scenarios: ruleScenarios,
+                    line: cucumberRule.location.line,
+                });
+            }
+        }
+        // Validate parsed data against schemas (schema-first enforcement)
+        const featureValidation = GherkinFeatureSchema.safeParse(feature);
+        if (!featureValidation.success) {
+            return R.err({
+                file: filePath,
+                error: {
+                    message: `Feature validation failed: ${featureValidation.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ')}`,
+                    line: feature.line,
+                },
+            });
+        }
+        // Validate background if present
+        if (background) {
+            const backgroundValidation = GherkinBackgroundSchema.safeParse(background);
+            if (!backgroundValidation.success) {
+                return R.err({
+                    file: filePath,
+                    error: {
+                        message: `Background validation failed: ${backgroundValidation.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ')}`,
+                        line: background.line,
+                    },
+                });
+            }
+        }
+        // Validate scenarios
+        for (const scenario of scenarios) {
+            const scenarioValidation = GherkinScenarioSchema.safeParse(scenario);
+            if (!scenarioValidation.success) {
+                return R.err({
+                    file: filePath,
+                    error: {
+                        message: `Scenario "${scenario.name}" validation failed: ${scenarioValidation.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ')}`,
+                        line: scenario.line,
+                    },
+                });
+            }
+        }
+        // Validate rules
+        for (const rule of rules) {
+            const ruleValidation = GherkinRuleSchema.safeParse(rule);
+            if (!ruleValidation.success) {
+                return R.err({
+                    file: filePath,
+                    error: {
+                        message: `Rule "${rule.name}" validation failed: ${ruleValidation.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join(', ')}`,
+                        line: rule.line,
+                    },
+                });
+            }
+        }
+        return R.ok({
+            feature: featureValidation.data,
+            ...(background && { background }),
+            ...(rules.length > 0 && { rules }),
+            scenarios,
+        });
+    }
+    catch (error) {
+        // Handle Gherkin parse errors
+        if (error !== null && typeof error === 'object' && 'errors' in error) {
+            const gherkinError = error;
+            const firstError = gherkinError.errors[0];
+            const errorObj = {
+                file: filePath,
+                error: {
+                    message: firstError?.message ?? 'Unknown Gherkin parse error',
+                    ...(firstError?.location?.line !== undefined && { line: firstError.location.line }),
+                    ...(firstError?.location?.column !== undefined && { column: firstError.location.column }),
+                },
+            };
+            return R.err(errorObj);
+        }
+        // Handle other errors
+        return R.err({
+            file: filePath,
+            error: {
+                message: error instanceof Error ? error.message : String(error),
+            },
+        });
+    }
+}
+/**
+ * Extract pattern-related tags from feature tags
+ *
+ * Maps Gherkin tags like @pattern:Name, @phase:15, @status:roadmap
+ * to pattern metadata.
+ *
+ * @param tags - Array of tag strings (without @ prefix)
+ * @returns Object with pattern metadata
+ *
+ * @example
+ * ```typescript
+ * const tags = ["pattern:MyPattern", "phase:15", "status:roadmap", "depends-on:OtherPattern"];
+ * const metadata = extractPatternTags(tags);
+ * // {
+ * //   pattern: "MyPattern",
+ * //   phase: 15,
+ * //   status: "roadmap",
+ * //   dependsOn: ["OtherPattern"]
+ * // }
+ * ```
+ */
+export function extractPatternTags(tags) {
+    const metadata = {};
+    for (const tag of tags) {
+        const normalized = normalizeTag(tag);
+        const colonIdx = normalized.indexOf(':');
+        if (colonIdx === -1) {
+            // Check if this is a registered flag-type tag (e.g., 'core')
+            const flagDef = TAG_LOOKUP.get(normalized);
+            if (flagDef?.format === 'flag') {
+                metadata[kebabToCamel(normalized)] = true;
+                continue;
+            }
+            // No colon: category tag (e.g., @ddd, @event-sourcing)
+            // Skip known non-category tags
+            if (normalized !== 'acceptance-criteria' &&
+                !normalized.startsWith('happy-path') &&
+                normalized !== 'architect') {
+                const existing = metadata['categories'];
+                metadata['categories'] = [...(existing ?? []), normalized];
+            }
+            continue;
+        }
+        const tagName = normalized.substring(0, colonIdx);
+        const rawValue = normalized.substring(colonIdx + 1);
+        const def = TAG_LOOKUP.get(tagName);
+        if (def === undefined)
+            continue;
+        const key = def.metadataKey ?? kebabToCamel(tagName);
+        switch (def.format) {
+            case 'number': {
+                const num = parseInt(rawValue, 10);
+                if (!isNaN(num)) {
+                    metadata[key] = num;
+                }
+                break;
+            }
+            case 'enum': {
+                if (def.values?.includes(rawValue) === true) {
+                    metadata[key] = rawValue;
+                }
+                break;
+            }
+            case 'csv': {
+                const values = rawValue
+                    .split(',')
+                    .map((s) => s.trim())
+                    .filter((s) => s.length > 0);
+                const validated = def.values !== undefined
+                    ? values.filter((v) => def.values?.includes(v) === true)
+                    : values;
+                const transformed = def.transform !== undefined ? validated.map(def.transform) : validated;
+                const existing = metadata[key];
+                metadata[key] = [...(existing ?? []), ...transformed];
+                break;
+            }
+            case 'flag': {
+                metadata[key] = true;
+                break;
+            }
+            case 'quoted-value':
+            case 'value':
+            default: {
+                const value = def.transform !== undefined ? def.transform(rawValue) : rawValue;
+                if (def.repeatable === true) {
+                    const existing = metadata[key];
+                    metadata[key] = [...(existing ?? []), value];
+                }
+                else {
+                    metadata[key] = value;
+                }
+                break;
+            }
+        }
+    }
+    return metadata;
+}
+//# sourceMappingURL=gherkin-ast-parser.js.map

package/dist/scanner/gherkin-ast-parser.js.map

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

package/dist/scanner/gherkin-scanner.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @architect
+ * @architect-scanner
+ * @architect-pattern GherkinScanner
+ * @architect-status completed
+ * @architect-implements GherkinRulesSupport
+ * @architect-uses GherkinASTParser, GherkinTypes
+ * @architect-used-by DualSourceExtractor, Orchestrator
+ * @architect-arch-role infrastructure
+ * @architect-arch-context scanner
+ * @architect-arch-layer infrastructure
+ *
+ * ## GherkinScanner - Multi-Source Pattern Extraction from Feature Files
+ *
+ * Scans .feature files for pattern metadata encoded in Gherkin tags.
+ * Enables roadmap patterns to be defined in acceptance criteria files
+ * before implementation, supporting specification-first development.
+ *
+ * ### When to Use
+ *
+ * - When defining roadmap patterns in .feature files
+ * - When extracting pattern metadata from acceptance criteria
+ * - When building multi-source documentation (TypeScript + Gherkin)
+ *
+ * ### Key Concepts
+ *
+ * - **Feature Tags**: @pattern:Name, @phase:N, @status:roadmap map to pattern metadata
+ * - **Multi-Source**: Patterns can be defined in TypeScript stubs OR Gherkin features
+ * - **Conflict Detection**: Same pattern name in both sources triggers error
+ */
+import type { Result } from '../types/index.js';
+import type { GherkinScanResults } from '../validation-schemas/feature.js';
+/**
+ * Configuration for Gherkin scanner
+ */
+export interface GherkinScannerConfig {
+    /** Glob pattern(s) for .feature files */
+    readonly patterns: string | readonly string[];
+    /** Base directory for resolving patterns (default: cwd) */
+    readonly baseDir?: string;
+    /** Additional glob patterns to exclude */
+    readonly exclude?: readonly string[];
+}
+/**
+ * Find all .feature files matching the scanner configuration
+ *
+ * @param config - Scanner configuration
+ * @returns Array of absolute file paths to .feature files
+ *
+ * @example
+ * ```typescript
+ * const files = await findFeatureFiles({
+ *   patterns: 'tests/features/**\/*.feature',
+ *   baseDir: '/path/to/project'
+ * });
+ * console.log(files); // ['/path/to/project/tests/features/my-pattern.feature', ...]
+ * ```
+ */
+export declare function findFeatureFiles(config: GherkinScannerConfig): Promise<readonly string[]>;
+/**
+ * Scan Gherkin feature files and extract pattern metadata
+ *
+ * Parses .feature files and extracts:
+ * - Feature name, description, tags
+ * - Scenario names, tags, steps
+ * - Pattern metadata from tags (@pattern:Name, @phase:N, etc.)
+ *
+ * **Result Pattern**: Returns Result<GherkinScanResults, never> where:
+ * - Success contains both successful files AND individual file errors
+ * - Never fails completely (errors are collected in results)
+ *
+ * @param config - Scanner configuration
+ * @returns Result containing scan results with success and error collections
+ *
+ * @example
+ * ```typescript
+ * const result = await scanGherkinFiles({
+ *   patterns: 'tests/features/roadmap/**\/*.feature',
+ *   baseDir: '/path/to/project'
+ * });
+ *
+ * if (result.ok) {
+ *   const { files, errors } = result.value;
+ *   console.log(`Scanned ${files.length} features successfully`);
+ *   console.log(`Failed to parse ${errors.length} features`);
+ *
+ *   for (const file of files) {
+ *     console.log(`Feature: ${file.feature.name}`);
+ *     console.log(`  Tags: ${file.feature.tags.join(', ')}`);
+ *     console.log(`  Scenarios: ${file.scenarios.length}`);
+ *   }
+ *
+ *   // Handle errors
+ *   for (const { file, error } of errors) {
+ *     console.error(`Failed to parse ${file}: ${error.message}`);
+ *     if (error.line) {
+ *       console.error(`  at line ${error.line}${error.column ? `, column ${error.column}` : ''}`);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare function scanGherkinFiles(config: GherkinScannerConfig): Promise<Result<GherkinScanResults, never>>;
+export { parseFeatureFile, extractPatternTags } from './gherkin-ast-parser.js';
+export type { ScannedGherkinFile, GherkinFileError, GherkinScanResults, GherkinBackground, GherkinRule, GherkinStep, GherkinDataTable, GherkinDataTableRow, } from '../validation-schemas/feature.js';
+//# sourceMappingURL=gherkin-scanner.d.ts.map

package/dist/scanner/gherkin-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gherkin-scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/gherkin-scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,kCAAkC,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC;IAC9C,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAc/F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC,CAgD5C;AAED,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC/E,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kCAAkC,CAAC"}