cc-agentic-framework 1.14.1

package/dist/lib/backlog/jira-file-generators.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Jira File Generators Module
+ *
+ * Generate sprint and milestone files with enhanced YAML metadata.
+ *
+ * Creates markdown files with YAML frontmatter containing Jira IDs,
+ * local IDs, and metadata for newly created sprints and milestones.
+ *
+ * @module jira-file-generators
+ */
+/**
+ * Options for generating a sprint file
+ */
+export interface GenerateSprintFileOptions {
+    /** Local sprint ID (e.g., "2026-W1") */
+    sprintId: string;
+    /** Sprint name from CSV (e.g., "APM-APP-2026-W1") */
+    sprintName?: string;
+    /** Numeric Jira sprint ID (e.g., "16786") */
+    jiraSprintId?: string;
+    /** Associated milestone (e.g., "Jan2026") */
+    milestone?: string;
+    /** Number of committed tickets */
+    committed?: number;
+    /** Total ticket count */
+    ticketCount?: number;
+    /** Path to backlog directory */
+    backlogDir: string;
+}
+/**
+ * Options for generating a milestone file
+ */
+export interface GenerateMilestoneFileOptions {
+    /** Local milestone ID (e.g., "Jan2026") */
+    milestoneId: string;
+    /** Milestone name from CSV (e.g., "January 2026 (W51, W1, W3)") */
+    milestoneName?: string;
+    /** Jira milestone ID (e.g., "Jan2026") */
+    jiraMilestoneId?: string;
+    /** Number of committed tickets */
+    committed?: number;
+    /** Total ticket count */
+    ticketCount?: number;
+    /** Path to backlog directory */
+    backlogDir: string;
+}
+/**
+ * Options for updating sprint file metadata
+ */
+export interface UpdateSprintMetadataOptions {
+    /** New sprint name */
+    sprintName?: string;
+    /** New Jira sprint ID */
+    jiraSprintId?: string;
+    /** New milestone assignment */
+    milestone?: string;
+    /** New committed count */
+    committed?: number;
+    /** New ticket count */
+    ticketCount?: number;
+}
+/**
+ * Options for updating milestone file metadata
+ */
+export interface UpdateMilestoneMetadataOptions {
+    /** New milestone name */
+    milestoneName?: string;
+    /** New Jira milestone ID */
+    jiraMilestoneId?: string;
+    /** New committed count */
+    committed?: number;
+    /** New ticket count */
+    ticketCount?: number;
+}
+/**
+ * Create or update sprint metadata file.
+ *
+ * Creates backlog/sprints/{sprint_id}.md with enhanced YAML frontmatter.
+ *
+ * @param options - Sprint generation options
+ * @returns Path to created/updated sprint file
+ * @throws {Error} If sprint_id is empty
+ *
+ * @example
+ * ```typescript
+ * const sprintFile = await generateSprintFile({
+ *   sprintId: "2026-W1",
+ *   sprintName: "APM-APP-2026-W1",
+ *   jiraSprintId: "16786",
+ *   milestone: "Jan2026",
+ *   backlogDir: "backlog"
+ * });
+ * ```
+ */
+export declare function generateSprintFile(options: GenerateSprintFileOptions): Promise<string>;
+/**
+ * Create or update milestone metadata file.
+ *
+ * Creates backlog/milestones/{milestone_id}.md with enhanced YAML frontmatter.
+ *
+ * @param options - Milestone generation options
+ * @returns Path to created/updated milestone file
+ * @throws {Error} If milestone_id is empty
+ *
+ * @example
+ * ```typescript
+ * const milestoneFile = await generateMilestoneFile({
+ *   milestoneId: "Jan2026",
+ *   milestoneName: "January 2026 (W51, W1, W3)",
+ *   jiraMilestoneId: "Jan2026",
+ *   backlogDir: "backlog"
+ * });
+ * ```
+ */
+export declare function generateMilestoneFile(options: GenerateMilestoneFileOptions): Promise<string>;
+/**
+ * Update existing sprint file YAML metadata.
+ *
+ * Preserves existing content while updating specified YAML fields.
+ *
+ * @param sprintFile - Path to sprint markdown file
+ * @param updates - Fields to update
+ * @throws {Error} If sprint file doesn't exist
+ * @throws {Error} If sprint file has invalid format
+ *
+ * @example
+ * ```typescript
+ * await updateSprintFileMetadata('backlog/sprints/2026-W1.md', {
+ *   committed: 5,
+ *   ticketCount: 10
+ * });
+ * ```
+ */
+export declare function updateSprintFileMetadata(sprintFile: string, updates: UpdateSprintMetadataOptions): Promise<void>;
+/**
+ * Update existing milestone file YAML metadata.
+ *
+ * Preserves existing content while updating specified YAML fields.
+ *
+ * @param milestoneFile - Path to milestone markdown file
+ * @param updates - Fields to update
+ * @throws {Error} If milestone file doesn't exist
+ * @throws {Error} If milestone file has invalid format
+ *
+ * @example
+ * ```typescript
+ * await updateMilestoneFileMetadata('backlog/milestones/Jan2026.md', {
+ *   committed: 15,
+ *   ticketCount: 25
+ * });
+ * ```
+ */
+export declare function updateMilestoneFileMetadata(milestoneFile: string, updates: UpdateMilestoneMetadataOptions): Promise<void>;
+//# sourceMappingURL=jira-file-generators.d.ts.map

package/dist/lib/backlog/jira-file-generators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-file-generators.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/jira-file-generators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,sBAAsB;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4BAA4B;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,MAAM,CAAC,CAwEjB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CAmEjB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA+Cf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/lib/backlog/jira-file-generators.js

@@ -0,0 +1,265 @@
+/**
+ * Jira File Generators Module
+ *
+ * Generate sprint and milestone files with enhanced YAML metadata.
+ *
+ * Creates markdown files with YAML frontmatter containing Jira IDs,
+ * local IDs, and metadata for newly created sprints and milestones.
+ *
+ * @module jira-file-generators
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import * as YAML from 'yaml';
+/**
+ * Create or update sprint metadata file.
+ *
+ * Creates backlog/sprints/{sprint_id}.md with enhanced YAML frontmatter.
+ *
+ * @param options - Sprint generation options
+ * @returns Path to created/updated sprint file
+ * @throws {Error} If sprint_id is empty
+ *
+ * @example
+ * ```typescript
+ * const sprintFile = await generateSprintFile({
+ *   sprintId: "2026-W1",
+ *   sprintName: "APM-APP-2026-W1",
+ *   jiraSprintId: "16786",
+ *   milestone: "Jan2026",
+ *   backlogDir: "backlog"
+ * });
+ * ```
+ */
+export async function generateSprintFile(options) {
+    const { sprintId, sprintName, jiraSprintId, milestone, committed = 0, ticketCount = 0, backlogDir, } = options;
+    if (!sprintId) {
+        throw new Error('sprint_id is required');
+    }
+    const sprintsDir = path.join(backlogDir, 'sprints');
+    await fs.ensureDir(sprintsDir);
+    const sprintFile = path.join(sprintsDir, `${sprintId}.md`);
+    // Build YAML frontmatter with specific field order
+    // Only include fields that have values (not undefined)
+    const yamlDict = {};
+    if (jiraSprintId !== undefined) {
+        yamlDict.jiraSprintId = jiraSprintId;
+    }
+    if (sprintName !== undefined) {
+        yamlDict.sprintName = sprintName;
+    }
+    yamlDict.sprintId = sprintId;
+    if (milestone !== undefined) {
+        yamlDict.milestone = milestone;
+    }
+    yamlDict.committed = committed;
+    yamlDict.ticketCount = ticketCount;
+    // Generate YAML with custom dumper to preserve field order
+    const yamlContent = YAML.stringify(yamlDict);
+    // Generate content
+    const content = `---
+${yamlContent}---
+
+## Sprint: ${sprintName || sprintId}
+
+**Sprint ID:** ${sprintId}
+**Jira Sprint ID:** ${jiraSprintId || 'TBD'}
+**Milestone:** ${milestone || 'Unassigned'}
+
+**Metrics:**
+- Committed: ${committed}
+- Tickets: ${ticketCount}
+
+---
+
+### Tickets
+
+*Tickets for this sprint will be added during import.*
+`;
+    await fs.writeFile(sprintFile, content, 'utf-8');
+    if (!(await fs.pathExists(sprintFile))) {
+        throw new Error(`Failed to create sprint file: ${sprintFile}`);
+    }
+    console.error(`✅ Sprint file created: ${sprintFile}`);
+    return sprintFile;
+}
+/**
+ * Create or update milestone metadata file.
+ *
+ * Creates backlog/milestones/{milestone_id}.md with enhanced YAML frontmatter.
+ *
+ * @param options - Milestone generation options
+ * @returns Path to created/updated milestone file
+ * @throws {Error} If milestone_id is empty
+ *
+ * @example
+ * ```typescript
+ * const milestoneFile = await generateMilestoneFile({
+ *   milestoneId: "Jan2026",
+ *   milestoneName: "January 2026 (W51, W1, W3)",
+ *   jiraMilestoneId: "Jan2026",
+ *   backlogDir: "backlog"
+ * });
+ * ```
+ */
+export async function generateMilestoneFile(options) {
+    const { milestoneId, milestoneName, jiraMilestoneId, committed = 0, ticketCount = 0, backlogDir, } = options;
+    if (!milestoneId) {
+        throw new Error('milestone_id is required');
+    }
+    const milestonesDir = path.join(backlogDir, 'milestones');
+    await fs.ensureDir(milestonesDir);
+    const milestoneFile = path.join(milestonesDir, `${milestoneId}.md`);
+    // Build YAML frontmatter with specific field order
+    // Only include fields that have values (not undefined)
+    const yamlDict = {};
+    if (jiraMilestoneId !== undefined) {
+        yamlDict.jiraMilestoneId = jiraMilestoneId;
+    }
+    if (milestoneName !== undefined) {
+        yamlDict.milestoneName = milestoneName;
+    }
+    yamlDict.milestone = milestoneId;
+    yamlDict.title = `Milestone ${milestoneId}`;
+    yamlDict.committed = committed;
+    yamlDict.ticketCount = ticketCount;
+    // Generate YAML with custom dumper to preserve field order
+    const yamlContent = YAML.stringify(yamlDict);
+    // Generate content
+    const content = `---
+${yamlContent}---
+
+## Milestone: ${milestoneName || milestoneId}
+
+**Milestone ID:** ${milestoneId}
+**Jira Milestone ID:** ${jiraMilestoneId || milestoneId}
+
+**Metrics:**
+- Committed: ${committed}
+- Tickets: ${ticketCount}
+
+---
+
+### Tickets
+
+*Tickets for this milestone will be added during import.*
+`;
+    await fs.writeFile(milestoneFile, content, 'utf-8');
+    if (!(await fs.pathExists(milestoneFile))) {
+        throw new Error(`Failed to create milestone file: ${milestoneFile}`);
+    }
+    console.error(`✅ Milestone file created: ${milestoneFile}`);
+    return milestoneFile;
+}
+/**
+ * Update existing sprint file YAML metadata.
+ *
+ * Preserves existing content while updating specified YAML fields.
+ *
+ * @param sprintFile - Path to sprint markdown file
+ * @param updates - Fields to update
+ * @throws {Error} If sprint file doesn't exist
+ * @throws {Error} If sprint file has invalid format
+ *
+ * @example
+ * ```typescript
+ * await updateSprintFileMetadata('backlog/sprints/2026-W1.md', {
+ *   committed: 5,
+ *   ticketCount: 10
+ * });
+ * ```
+ */
+export async function updateSprintFileMetadata(sprintFile, updates) {
+    if (!(await fs.pathExists(sprintFile))) {
+        throw new Error(`Sprint file not found: ${sprintFile}`);
+    }
+    const content = await fs.readFile(sprintFile, 'utf-8');
+    // Extract YAML frontmatter
+    if (!content.startsWith('---')) {
+        throw new Error(`Invalid sprint file format: ${sprintFile}`);
+    }
+    const endIdx = content.indexOf('\n---\n', 3);
+    if (endIdx === -1) {
+        throw new Error(`Malformed YAML frontmatter: ${sprintFile}`);
+    }
+    const yamlContent = content.substring(3, endIdx);
+    const body = content.substring(endIdx + 4);
+    // Parse and update YAML
+    const yamlDict = YAML.parse(yamlContent) || {};
+    if (updates.sprintName !== undefined) {
+        yamlDict.sprintName = updates.sprintName;
+    }
+    if (updates.jiraSprintId !== undefined) {
+        yamlDict.jiraSprintId = updates.jiraSprintId;
+    }
+    if (updates.milestone !== undefined) {
+        yamlDict.milestone = updates.milestone;
+    }
+    if (updates.committed !== undefined) {
+        yamlDict.committed = updates.committed;
+    }
+    if (updates.ticketCount !== undefined) {
+        yamlDict.ticketCount = updates.ticketCount;
+    }
+    // Rebuild content
+    const newYamlContent = YAML.stringify(yamlDict);
+    const newContent = `---
+${newYamlContent}---${body}`;
+    await fs.writeFile(sprintFile, newContent, 'utf-8');
+    console.error(`✅ Sprint file updated: ${sprintFile}`);
+}
+/**
+ * Update existing milestone file YAML metadata.
+ *
+ * Preserves existing content while updating specified YAML fields.
+ *
+ * @param milestoneFile - Path to milestone markdown file
+ * @param updates - Fields to update
+ * @throws {Error} If milestone file doesn't exist
+ * @throws {Error} If milestone file has invalid format
+ *
+ * @example
+ * ```typescript
+ * await updateMilestoneFileMetadata('backlog/milestones/Jan2026.md', {
+ *   committed: 15,
+ *   ticketCount: 25
+ * });
+ * ```
+ */
+export async function updateMilestoneFileMetadata(milestoneFile, updates) {
+    if (!(await fs.pathExists(milestoneFile))) {
+        throw new Error(`Milestone file not found: ${milestoneFile}`);
+    }
+    const content = await fs.readFile(milestoneFile, 'utf-8');
+    // Extract YAML frontmatter
+    if (!content.startsWith('---')) {
+        throw new Error(`Invalid milestone file format: ${milestoneFile}`);
+    }
+    const endIdx = content.indexOf('\n---\n', 3);
+    if (endIdx === -1) {
+        throw new Error(`Malformed YAML frontmatter: ${milestoneFile}`);
+    }
+    const yamlContent = content.substring(3, endIdx);
+    const body = content.substring(endIdx + 4);
+    // Parse and update YAML
+    const yamlDict = YAML.parse(yamlContent) || {};
+    if (updates.milestoneName !== undefined) {
+        yamlDict.milestoneName = updates.milestoneName;
+    }
+    if (updates.jiraMilestoneId !== undefined) {
+        yamlDict.jiraMilestoneId = updates.jiraMilestoneId;
+    }
+    if (updates.committed !== undefined) {
+        yamlDict.committed = updates.committed;
+    }
+    if (updates.ticketCount !== undefined) {
+        yamlDict.ticketCount = updates.ticketCount;
+    }
+    // Rebuild content
+    const newYamlContent = YAML.stringify(yamlDict);
+    const newContent = `---
+${newYamlContent}---${body}`;
+    await fs.writeFile(milestoneFile, newContent, 'utf-8');
+    console.error(`✅ Milestone file updated: ${milestoneFile}`);
+}
+//# sourceMappingURL=jira-file-generators.js.map

package/dist/lib/backlog/jira-file-generators.js.map

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

package/dist/lib/backlog/jira-import-workflows.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Smart lookup and resolution workflows for Jira imports.
+ *
+ * Integrates validators, lookup, and prompts to provide smart sprint/milestone
+ * resolution with user prompting support and rename detection.
+ *
+ * @module jira-import-workflows
+ */
+import type { CsvExtraction } from './jira-validators.js';
+/**
+ * Result of sprint metadata resolution
+ */
+export interface SprintResolution {
+    /** Local ID (e.g., "2025-W45") */
+    sprintId: string;
+    /** Sprint name from CSV (e.g., "APM-APP-2025W45") */
+    sprintName: string;
+    /** Numeric Jira ID (e.g., "16786") or null */
+    jiraSprintId: string | null;
+}
+/**
+ * Result of milestone metadata resolution
+ */
+export interface MilestoneResolution {
+    /** Local ID (e.g., "Jan2026") */
+    milestoneId: string;
+    /** Milestone name from CSV */
+    milestoneName: string;
+    /** Jira milestone ID (usually same as ID) */
+    jiraMilestoneId: string;
+}
+/**
+ * Arguments for workflow resolution
+ */
+export interface WorkflowArgs {
+    sprintName?: string;
+    milestoneName?: string;
+    jiraSprintId?: string;
+    jiraMilestoneId?: string;
+    dryRun?: boolean;
+    [key: string]: string | boolean | undefined;
+}
+/**
+ * Resolve sprint metadata through smart lookup workflow.
+ *
+ * Workflow:
+ * 1. Extract sprint name from CSV Sprint column
+ * 2. Search existing sprint files by name
+ * 3. If found with jiraSprintId -> use it, no prompt
+ * 4. If not found -> prompt user for Jira sprint ID (or use from args)
+ * 5. If user provides ID -> search by ID
+ * 6. If found by ID -> check if renamed, update name
+ * 7. If not found -> create new sprint
+ *
+ * @param args - Parsed command-line arguments
+ * @param csvData - Extracted CSV data (CSVExtraction)
+ * @param backlogDir - Path to backlog directory
+ * @param verbose - Show detailed output
+ * @returns Sprint resolution with sprint_id, sprint_name, jira_sprint_id
+ * @throws Error if critical validation fails
+ */
+export declare function resolveSprintMetadata(args: WorkflowArgs, csvData: CsvExtraction, backlogDir: string, verbose?: boolean): Promise<SprintResolution>;
+/**
+ * Resolve milestone metadata through smart lookup workflow.
+ *
+ * Workflow:
+ * 1. Extract milestone name from CSV Fix Versions
+ * 2. Search existing milestone files by name
+ * 3. If found -> use existing ID
+ * 4. If not found -> prompt user for milestone ID (suggest from name)
+ * 5. If user provides ID -> search by ID
+ * 6. If found by ID -> check if renamed, update name
+ * 7. If not found -> create new milestone
+ *
+ * @param args - Parsed command-line arguments
+ * @param csvData - Extracted CSV data (CSVExtraction)
+ * @param backlogDir - Path to backlog directory
+ * @param verbose - Show detailed output
+ * @returns Milestone resolution with milestone_id, milestone_name, jira_milestone_id
+ * @throws Error if critical validation fails
+ */
+export declare function resolveMilestoneMetadata(args: WorkflowArgs, csvData: CsvExtraction, backlogDir: string, verbose?: boolean): Promise<MilestoneResolution>;
+/**
+ * Extract local sprint ID from sprint name.
+ *
+ * Looks for patterns like "APM-APP-2025W45" or "APM-2025W45" and converts
+ * to "2025-W45" format.
+ *
+ * @param sprintName - Sprint name from CSV (e.g., "APM-APP-2025W45")
+ * @returns Sprint ID (e.g., "2025-W45") or null if cannot parse
+ */
+export declare function extractSprintIdFromName(sprintName: string): string | null;
+/**
+ * Generate a new sprint ID based on current date.
+ *
+ * @returns Sprint ID (e.g., "2025-W50")
+ */
+export declare function generateSprintId(): string;
+/**
+ * Suggest milestone ID from milestone name.
+ *
+ * Extracts month abbreviation and year from milestone name.
+ * Examples:
+ *   "January 2026" -> "Jan2026"
+ *   "November 2025" -> "Nov2025"
+ *   "January 2026 (W51, W1, W3)" -> "Jan2026"
+ *
+ * @param milestoneName - Milestone name from CSV (e.g., "January 2026 (W51, W1, W3)")
+ * @returns Suggested milestone ID (e.g., "Jan2026") or null if cannot parse
+ */
+export declare function suggestMilestoneIdFromName(milestoneName: string): string | null;
+//# sourceMappingURL=jira-import-workflows.d.ts.map

package/dist/lib/backlog/jira-import-workflows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira-import-workflows.d.ts","sourceRoot":"","sources":["../../../src/lib/backlog/jira-import-workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAsG3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,aAAa,EACtB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAgH9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBzE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAyBzC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiD/E"}