@libar-dev/architect 1.0.0-pre.3 → 1.0.0-pre.5

package/dist/lint/process-guard/derive-state.d.ts

@@ -1,96 +0,0 @@
-/**
- * @architect
- * @architect-lint
- * @architect-pattern DeriveProcessState
- * @architect-status active
- * @architect-implements ProcessGuardLinter
- * @architect-uses GherkinScanner, FSMValidator
- * @architect-depends-on:GherkinScanner,FSMValidator
- *
- * ## DeriveProcessState - Extract Process State from File Annotations
- *
- * Derives process state from @architect-* annotations in files.
- * State is computed on-demand, not stored separately.
- *
- * ### Design Principles
- *
- * - **Derived, Not Stored**: State comes from file annotations
- * - **Reuses Scanner**: Builds on existing gherkin-scanner infrastructure
- * - **Pure Functions**: No side effects, testable
- *
- * ### When to Use
- *
- * - When validating changes against process rules
- * - When computing protection levels for files
- * - When determining session scope
- */
-import type { Result } from '../../types/index.js';
-import { type ProtectionLevel } from '../../validation/fsm/index.js';
-import type { ProcessState, FileState } from './types.js';
-/**
- * Configuration for deriving process state.
- */
-export interface DeriveStateConfig {
-    /** Base directory for file resolution */
-    readonly baseDir: string;
-    /** Glob patterns for spec files */
-    readonly specPatterns?: readonly string[];
-    /** Path to sessions directory */
-    readonly sessionsDir?: string;
-}
-/** Default spec patterns - generic defaults that work for package-level usage */
-export declare const DEFAULT_PROCESS_GUARD_SPEC_PATTERNS: readonly ["architect/**/*.feature", "specs/**/*.feature"];
-/**
- * Derive complete process state from file annotations.
- *
- * Scans spec files and extracts:
- * - Status from @architect-status tags
- * - Deliverables from Background tables
- * - Session state from active session files
- *
- * @param config - Configuration for state derivation
- * @returns Result containing ProcessState or error
- *
- * @example
- * ```typescript
- * const result = await deriveProcessState({
- *   baseDir: '/path/to/project',
- * });
- * if (result.ok) {
- *   const state = result.value;
- *   console.log(`Found ${state.files.size} spec files`);
- * }
- * ```
- */
-export declare function deriveProcessState(config: DeriveStateConfig): Promise<Result<ProcessState>>;
-/**
- * Get file state from process state.
- */
-export declare function getFileState(state: ProcessState, relativePath: string): FileState | undefined;
-/**
- * Get all files with a specific protection level.
- */
-export declare function getFilesByProtection(state: ProcessState, protection: ProtectionLevel): readonly FileState[];
-/**
- * Check if a file is in the active session scope.
- *
- * Uses smart matching based on spec format:
- * - If spec contains path separator: Use path-aware matching
- *   - `specs/auth.feature` matches exactly `specs/auth.feature`
- *   - `specs/auth/` matches `specs/auth/login.feature`
- * - If spec is just a name: Use substring matching
- *   - `auth` matches `specs/auth.feature` or `tests/auth/test.ts`
- */
-export declare function isInSessionScope(state: ProcessState, relativePath: string): boolean;
-/**
- * Check if a file is explicitly excluded from session.
- *
- * Uses smart matching based on spec format:
- * - If spec contains path separator: Use path-aware matching
- *   - `specs/legacy.feature` matches exactly `specs/legacy.feature`
- *   - `specs/legacy/` matches `specs/legacy/old.feature`
- * - If spec is just a name: Use substring matching
- *   - `legacy` matches `specs/phase-legacy.feature`
- */
-export declare function isSessionExcluded(state: ProcessState, relativePath: string): boolean;
-//# sourceMappingURL=derive-state.d.ts.map

package/dist/lint/process-guard/derive-state.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"derive-state.d.ts","sourceRoot":"","sources":["../../../src/lint/process-guard/derive-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAOzF,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAA+B,MAAM,YAAY,CAAC;AAMvF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mCAAmC;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,iCAAiC;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,iFAAiF;AACjF,eAAO,MAAM,mCAAmC,2DAGtC,CAAC;AAMX;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CA0BjG;AAkPD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE7F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,YAAY,EACnB,UAAU,EAAE,eAAe,GAC1B,SAAS,SAAS,EAAE,CAQtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAanF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAapF"}

package/dist/lint/process-guard/derive-state.js

@@ -1,368 +0,0 @@
-/**
- * @architect
- * @architect-lint
- * @architect-pattern DeriveProcessState
- * @architect-status active
- * @architect-implements ProcessGuardLinter
- * @architect-uses GherkinScanner, FSMValidator
- * @architect-depends-on:GherkinScanner,FSMValidator
- *
- * ## DeriveProcessState - Extract Process State from File Annotations
- *
- * Derives process state from @architect-* annotations in files.
- * State is computed on-demand, not stored separately.
- *
- * ### Design Principles
- *
- * - **Derived, Not Stored**: State comes from file annotations
- * - **Reuses Scanner**: Builds on existing gherkin-scanner infrastructure
- * - **Pure Functions**: No side effects, testable
- *
- * ### When to Use
- *
- * - When validating changes against process rules
- * - When computing protection levels for files
- * - When determining session scope
- */
-import * as fs from 'fs/promises';
-import * as path from 'path';
-import { glob } from 'glob';
-import { Result as R } from '../../types/index.js';
-import { scanGherkinFiles } from '../../scanner/gherkin-scanner.js';
-import { extractDeliverables } from '../../extractor/dual-source-extractor.js';
-import { getProtectionLevel } from '../../validation/fsm/index.js';
-import { DEFAULT_STATUS, PROCESS_STATUS_VALUES, normalizeStatus, } from '../../taxonomy/index.js';
-/** Default spec patterns - generic defaults that work for package-level usage */
-export const DEFAULT_PROCESS_GUARD_SPEC_PATTERNS = [
-    'architect/**/*.feature',
-    'specs/**/*.feature', // For consumers
-];
-// =============================================================================
-// Core Functions
-// =============================================================================
-/**
- * Derive complete process state from file annotations.
- *
- * Scans spec files and extracts:
- * - Status from @architect-status tags
- * - Deliverables from Background tables
- * - Session state from active session files
- *
- * @param config - Configuration for state derivation
- * @returns Result containing ProcessState or error
- *
- * @example
- * ```typescript
- * const result = await deriveProcessState({
- *   baseDir: '/path/to/project',
- * });
- * if (result.ok) {
- *   const state = result.value;
- *   console.log(`Found ${state.files.size} spec files`);
- * }
- * ```
- */
-export async function deriveProcessState(config) {
-    const specPatterns = config.specPatterns ?? DEFAULT_PROCESS_GUARD_SPEC_PATTERNS;
-    const sessionsDir = config.sessionsDir ?? path.join(config.baseDir, 'sessions');
-    // Derive file states
-    const filesResult = await deriveFileStates(config.baseDir, specPatterns);
-    if (!filesResult.ok) {
-        return filesResult;
-    }
-    // Find active session
-    const sessionResult = await findActiveSession(sessionsDir, config.baseDir);
-    const activeSession = sessionResult.ok ? sessionResult.value : undefined;
-    // Build ProcessState (handle exactOptionalPropertyTypes)
-    const processState = {
-        files: filesResult.value,
-        derivedAt: new Date().toISOString(),
-    };
-    // Only add activeSession if it exists
-    if (activeSession !== undefined) {
-        processState.activeSession = activeSession;
-    }
-    return R.ok(processState);
-}
-/**
- * Derive FileState for all spec files.
- */
-async function deriveFileStates(baseDir, patterns) {
-    // Scan feature files
-    const scanResult = await scanGherkinFiles({
-        patterns: patterns,
-        baseDir,
-    });
-    if (!scanResult.ok) {
-        return R.err(new Error(`Failed to scan files: ${String(scanResult.error)}`));
-    }
-    const { files } = scanResult.value;
-    const fileStates = new Map();
-    for (const file of files) {
-        const relativePath = path.relative(baseDir, file.filePath);
-        // Extract status from feature tags
-        const status = extractStatusFromTags(file.feature.tags);
-        const normalizedStatusValue = normalizeStatus(status);
-        const protection = getProtectionLevel(status);
-        // Extract deliverables from background (canonical extractor with case-insensitive headers)
-        const deliverables = extractDeliverables(file).map((d) => d.name);
-        // Check for unlock reason
-        const unlockInfo = extractUnlockReason(file.feature.tags);
-        // Build file state (handle exactOptionalPropertyTypes)
-        const fileState = {
-            path: file.filePath,
-            relativePath,
-            status,
-            normalizedStatus: normalizedStatusValue,
-            protection,
-            deliverables,
-            hasUnlockReason: unlockInfo.hasUnlockReason,
-        };
-        // Only add unlockReason if it exists (exactOptionalPropertyTypes compliance)
-        if (unlockInfo.unlockReason !== undefined) {
-            fileState.unlockReason = unlockInfo.unlockReason;
-        }
-        fileStates.set(relativePath, fileState);
-    }
-    return R.ok(fileStates);
-}
-/**
- * Extract status value from feature tags.
- */
-function extractStatusFromTags(tags) {
-    for (const tag of tags) {
-        // Handle @architect-status:value format
-        if (tag.includes('status:')) {
-            const match = /status:(\w+)/.exec(tag);
-            if (match?.[1]) {
-                const status = match[1].toLowerCase();
-                if (PROCESS_STATUS_VALUES.includes(status)) {
-                    return status;
-                }
-            }
-        }
-    }
-    // Default to roadmap if no status found
-    return DEFAULT_STATUS;
-}
-/**
- * Extract unlock reason from tags.
- *
- * Validates that unlock reasons are meaningful:
- * - Minimum 10 characters
- * - Not a placeholder value (test, xxx, bypass, temp, todo, fixme)
- *
- * If the tag exists but the reason is invalid, hasUnlockReason is false
- * so the completed-protection rule will catch it.
- */
-function extractUnlockReason(tags) {
-    const PLACEHOLDER_VALUES = /^(test|xxx|bypass|temp|todo|fixme)$/i;
-    const MIN_LENGTH = 10;
-    for (const tag of tags) {
-        if (tag.includes('unlock-reason:')) {
-            const match = /unlock-reason:["']?([^"']+)["']?/.exec(tag);
-            const value = match?.[1]?.trim();
-            // Require meaningful reason (10+ chars, not a placeholder)
-            if (value && value.length >= MIN_LENGTH && !PLACEHOLDER_VALUES.test(value)) {
-                return { hasUnlockReason: true, unlockReason: value };
-            }
-            // Tag exists but reason is invalid - treat as no unlock reason
-            // This allows the completed-protection rule to catch it
-        }
-    }
-    return { hasUnlockReason: false, unlockReason: undefined };
-}
-/**
- * Find active session from sessions directory.
- */
-async function findActiveSession(sessionsDir, baseDir) {
-    try {
-        // Check if sessions directory exists
-        try {
-            await fs.access(sessionsDir);
-        }
-        catch {
-            // No sessions directory, that's fine
-            return R.ok(undefined);
-        }
-        // Find session files
-        const sessionFiles = await glob('*.feature', {
-            cwd: sessionsDir,
-            absolute: true,
-        });
-        for (const sessionFile of sessionFiles) {
-            const session = await parseSessionFile(sessionFile, baseDir);
-            if (session?.status === 'active') {
-                return R.ok(session);
-            }
-        }
-        return R.ok(undefined);
-    }
-    catch (error) {
-        return R.err(error instanceof Error ? error : new Error(String(error)));
-    }
-}
-/**
- * Parse a session definition file.
- */
-async function parseSessionFile(filePath, baseDir) {
-    const scanResult = await scanGherkinFiles({
-        patterns: [filePath],
-        baseDir,
-    });
-    if (!scanResult.ok || scanResult.value.files.length === 0) {
-        return undefined;
-    }
-    const file = scanResult.value.files[0];
-    if (!file)
-        return undefined;
-    const tags = file.feature.tags;
-    // Extract session ID
-    const sessionId = extractTagValue(tags, 'session-id');
-    if (!sessionId)
-        return undefined;
-    // Extract session status
-    const sessionStatusRaw = extractTagValue(tags, 'session-status');
-    const sessionStatus = sessionStatusRaw === 'active' || sessionStatusRaw === 'closed' ? sessionStatusRaw : 'draft';
-    // Extract scoped specs (from background table or tags)
-    const scopedSpecs = extractScopedSpecs(file.background);
-    const excludedSpecs = extractExcludedSpecs(file.background);
-    return {
-        id: sessionId,
-        status: sessionStatus,
-        scopedSpecs,
-        excludedSpecs,
-        sessionFile: filePath,
-    };
-}
-/**
- * Extract a tag value by key.
- */
-function extractTagValue(tags, key) {
-    for (const tag of tags) {
-        const pattern = new RegExp(`${key}:["']?([^"'\\s]+)["']?`);
-        const match = tag.match(pattern);
-        if (match?.[1]) {
-            return match[1];
-        }
-    }
-    return undefined;
-}
-/**
- * Extract scoped specs from session background.
- * Uses unknown type to handle exactOptionalPropertyTypes compatibility.
- */
-function extractScopedSpecs(background) {
-    if (background === null || background === undefined || typeof background !== 'object')
-        return [];
-    const bg = background;
-    if (bg.steps === undefined)
-        return [];
-    const specs = [];
-    for (const step of bg.steps) {
-        const rows = step.dataTable?.rows;
-        if (rows) {
-            for (const row of rows) {
-                const spec = row['spec'] ?? row['Spec'];
-                if (spec) {
-                    specs.push(spec);
-                }
-            }
-        }
-    }
-    return specs;
-}
-/**
- * Extract excluded specs from session background.
- */
-function extractExcludedSpecs(_background) {
-    // For now, return empty - can be extended to parse exclusion tables
-    return [];
-}
-// =============================================================================
-// Utility Functions
-// =============================================================================
-/**
- * Get file state from process state.
- */
-export function getFileState(state, relativePath) {
-    return state.files.get(relativePath);
-}
-/**
- * Get all files with a specific protection level.
- */
-export function getFilesByProtection(state, protection) {
-    const files = [];
-    for (const file of state.files.values()) {
-        if (file.protection === protection) {
-            files.push(file);
-        }
-    }
-    return files;
-}
-/**
- * Check if a file is in the active session scope.
- *
- * Uses smart matching based on spec format:
- * - If spec contains path separator: Use path-aware matching
- *   - `specs/auth.feature` matches exactly `specs/auth.feature`
- *   - `specs/auth/` matches `specs/auth/login.feature`
- * - If spec is just a name: Use substring matching
- *   - `auth` matches `specs/auth.feature` or `tests/auth/test.ts`
- */
-export function isInSessionScope(state, relativePath) {
-    if (!state.activeSession) {
-        return true; // No session means all files are in scope
-    }
-    const normalizedPath = path.normalize(relativePath);
-    for (const spec of state.activeSession.scopedSpecs) {
-        if (matchesSpec(normalizedPath, spec)) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Check if a file is explicitly excluded from session.
- *
- * Uses smart matching based on spec format:
- * - If spec contains path separator: Use path-aware matching
- *   - `specs/legacy.feature` matches exactly `specs/legacy.feature`
- *   - `specs/legacy/` matches `specs/legacy/old.feature`
- * - If spec is just a name: Use substring matching
- *   - `legacy` matches `specs/phase-legacy.feature`
- */
-export function isSessionExcluded(state, relativePath) {
-    if (!state.activeSession) {
-        return false;
-    }
-    const normalizedPath = path.normalize(relativePath);
-    for (const spec of state.activeSession.excludedSpecs) {
-        if (matchesSpec(normalizedPath, spec)) {
-            return true;
-        }
-    }
-    return false;
-}
-/**
- * Match a file path against a spec pattern.
- *
- * Two matching modes:
- * 1. Path-aware: If spec contains path separator, use strict path matching
- *    - Exact match or directory prefix match
- * 2. Substring: If spec is just a name, match anywhere in the path
- *
- * @param normalizedPath - The normalized file path to check
- * @param spec - The spec pattern to match against
- * @returns true if the path matches the spec
- */
-function matchesSpec(normalizedPath, spec) {
-    const normalizedSpec = path.normalize(spec);
-    // If spec contains a path separator, use path-aware matching
-    if (spec.includes('/') || spec.includes(path.sep)) {
-        return (normalizedPath === normalizedSpec || normalizedPath.startsWith(normalizedSpec + path.sep));
-    }
-    // Otherwise, use substring matching for simple names
-    return normalizedPath.includes(spec);
-}
-//# sourceMappingURL=derive-state.js.map

package/dist/lint/process-guard/derive-state.js.map

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

package/dist/lint/process-guard/detect-changes.d.ts

@@ -1,109 +0,0 @@
-/**
- * @architect
- * @architect-lint
- * @architect-pattern DetectChanges
- * @architect-status active
- * @architect-implements ProcessGuardLinter
- * @architect-uses DeriveProcessState
- *
- * ## DetectChanges - Git Diff Change Detection
- *
- * Detects changes from git diff including:
- * - Modified, added, deleted files
- * - Status transitions (@architect-status changes)
- * - Deliverable changes in Background tables
- *
- * ### Design Principles
- *
- * - **Parse Git Output**: Uses `git diff --name-status` and `git diff`
- * - **Status Detection**: Regex patterns for @architect-status changes
- * - **Deliverable Detection**: Parses DataTable changes
- *
- * Note: Taxonomy modification detection was removed when taxonomy
- * moved from JSON to TypeScript (src/taxonomy/). TypeScript changes
- * require recompilation, making runtime detection unnecessary.
- *
- * ### When to Use
- *
- * - When validating staged changes (pre-commit)
- * - When validating all changes against main branch
- * - When detecting scope creep (new deliverables)
- */
-import type { Result } from '../../types/index.js';
-import type { ChangeDetection, StatusTransition, DeliverableChange } from './types.js';
-import type { WithTagRegistry } from '../../validation/types.js';
-/**
- * Options for change detection functions.
- *
- * Includes registry and optional feature globs so diff parsing can be
- * scoped to the same workflow-authoritative files used for state derivation.
- */
-export type ChangeDetectionOptions = WithTagRegistry & {
-    readonly featurePatterns?: readonly string[];
-};
-/**
- * Detect changes from git staged files.
- *
- * @param baseDir - Repository base directory
- * @param options - Optional change detection options with registry
- * @returns Result containing change detection or error
- *
- * @example
- * ```typescript
- * const result = await detectStagedChanges('/path/to/repo');
- * if (result.ok) {
- *   console.log(`${result.value.modifiedFiles.length} files changed`);
- * }
- * ```
- */
-export declare function detectStagedChanges(baseDir: string, options?: ChangeDetectionOptions): Result<ChangeDetection>;
-/**
- * Detect all changes compared to a base branch.
- *
- * @param baseDir - Repository base directory
- * @param baseBranch - Branch to compare against (default: main)
- * @param options - Optional change detection options with registry
- * @returns Result containing change detection or error
- */
-export declare function detectBranchChanges(baseDir: string, baseBranch?: string, options?: ChangeDetectionOptions): Result<ChangeDetection>;
-/**
- * Detect changes for specific files.
- *
- * @param baseDir - Repository base directory
- * @param files - Files to analyze
- * @param options - Optional change detection options with registry
- * @returns Result containing change detection or error
- */
-export declare function detectFileChanges(baseDir: string, files: readonly string[], options?: ChangeDetectionOptions): Result<ChangeDetection>;
-/**
- * Detect deliverable changes from diff content.
- *
- * Only matches table rows that appear within a deliverable table context,
- * identified by a preceding header row containing both "Deliverable" and "Status".
- * This prevents false positives from Examples tables, DocString-embedded tables,
- * and other non-deliverable table content.
- *
- * @internal Exported for testing purposes only.
- */
-export declare function detectDeliverableChanges(diff: string, files: readonly string[]): Array<[string, DeliverableChange]>;
-/**
- * Check if any files were modified.
- */
-export declare function hasChanges(detection: ChangeDetection): boolean;
-/**
- * Get all changed files (modified + added + deleted).
- */
-export declare function getAllChangedFiles(detection: ChangeDetection): readonly string[];
-/**
- * Check if a specific file was modified.
- */
-export declare function fileWasModified(detection: ChangeDetection, relativePath: string): boolean;
-/**
- * Get status transition for a file.
- */
-export declare function getStatusTransition(detection: ChangeDetection, relativePath: string): StatusTransition | undefined;
-/**
- * Get deliverable changes for a file.
- */
-export declare function getDeliverableChanges(detection: ChangeDetection, relativePath: string): DeliverableChange | undefined;
-//# sourceMappingURL=detect-changes.d.ts.map

package/dist/lint/process-guard/detect-changes.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"detect-changes.d.ts","sourceRoot":"","sources":["../../../src/lint/process-guard/detect-changes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAInD,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAGpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG;IACrD,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C,CAAC;AAMF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAAC,eAAe,CAAC,CA4BzB;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,UAAU,SAAS,EACnB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAAC,eAAe,CAAC,CAkCzB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,MAAM,CAAC,eAAe,CAAC,CA0CzB;AA2OD;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,KAAK,CAAC,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CA0GpC;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAM9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,eAAe,GAAG,SAAS,MAAM,EAAE,CAEhF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAIzF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,eAAe,EAC1B,YAAY,EAAE,MAAM,GACnB,gBAAgB,GAAG,SAAS,CAE9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,eAAe,EAC1B,YAAY,EAAE,MAAM,GACnB,iBAAiB,GAAG,SAAS,CAE/B"}