@libar-dev/architect 1.0.0-pre.3

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

@@ -0,0 +1,96 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,368 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,109 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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"}