@intentsolutions/blueprint 2.2.0 → 2.4.0

package/dist/integrations/github/action.js

@@ -0,0 +1,151 @@
+/**
+ * GitHub Action Generator
+ * Generates GitHub Action workflows for Blueprint integration
+ */
+/**
+ * Generate GitHub Action workflow for doc generation
+ */
+export function generateDocGenAction(config) {
+    const triggers = [];
+    if (config.onPush) {
+        triggers.push(`  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/blueprint-*.yml'`);
+    }
+    if (config.onPR) {
+        triggers.push(`  pull_request:
+    branches: [main]`);
+    }
+    if (config.onSchedule) {
+        triggers.push(`  schedule:
+    - cron: '${config.onSchedule}'`);
+    }
+    triggers.push(`  workflow_dispatch:
+    inputs:
+      scope:
+        description: 'Documentation scope'
+        required: false
+        default: '${config.scope}'
+        type: choice
+        options:
+          - mvp
+          - standard
+          - comprehensive`);
+    return `# Intent Blueprint Documentation Generator
+# Automatically generates and updates project documentation
+
+name: Blueprint Docs
+
+on:
+${triggers.join('\n')}
+
+jobs:
+  generate-docs:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      issues: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Generate Documentation
+        run: |
+          npx @intentsolutions/blueprint generate \\
+            --name "${config.projectName}" \\
+            --description "Auto-generated documentation" \\
+            --scope \${{ inputs.scope || '${config.scope}' }} \\
+            --audience "${config.audience}" \\
+            --output "${config.outputDir || 'docs'}"
+
+      - name: Commit Changes
+        uses: stefanzweifel/git-auto-commit-action@v5
+        with:
+          commit_message: "docs: update Blueprint documentation"
+          file_pattern: "${config.outputDir || 'docs'}/**"
+${config.createIssues ? `
+      - name: Export to Issues
+        if: github.event_name == 'workflow_dispatch'
+        env:
+          GITHUB_TOKEN: \${{ secrets.GITHUB_TOKEN }}
+        run: |
+          npx @intentsolutions/blueprint export github \\
+            --project "${config.projectName}" \\
+            --token "\$GITHUB_TOKEN" \\
+            --owner "\${{ github.repository_owner }}" \\
+            --repo "\${{ github.event.repository.name }}"
+` : ''}`;
+}
+/**
+ * Generate GitHub Action for doc sync on PR
+ */
+export function generatePRSyncAction(config) {
+    return `# Intent Blueprint PR Documentation Check
+# Validates documentation is up-to-date on PRs
+
+name: Blueprint PR Check
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  check-docs:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Check Documentation
+        run: |
+          # Generate docs to temp directory
+          npx @intentsolutions/blueprint generate \\
+            --name "${config.projectName}" \\
+            --description "Documentation check" \\
+            --scope "${config.scope}" \\
+            --output ".blueprint-check"
+
+          # Compare with existing docs
+          if [ -d "${config.outputDir || 'docs'}" ]; then
+            diff -r "${config.outputDir || 'docs'}" ".blueprint-check" || echo "Documentation may need updating"
+          fi
+
+          rm -rf .blueprint-check
+
+      - name: Comment on PR
+        uses: actions/github-script@v7
+        if: failure()
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: '📄 **Intent Blueprint**: Documentation may be out of date. Consider regenerating with \`npx @intentsolutions/blueprint generate\`'
+            })
+`;
+}
+/**
+ * Generate all Blueprint GitHub Actions
+ */
+export function generateAllActions(config) {
+    return {
+        'blueprint-generate.yml': generateDocGenAction(config),
+        'blueprint-pr-check.yml': generatePRSyncAction(config),
+    };
+}
+//# sourceMappingURL=action.js.map

package/dist/integrations/github/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/integrations/github/action.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC;;;;4CAI0B,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC;qBACG,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC;eACH,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,IAAI,CAAC;;;;;oBAKI,MAAM,CAAC,KAAK;;;;;0BAKN,CAAC,CAAC;IAE1B,OAAO;;;;;;EAMP,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;sBAqBC,MAAM,CAAC,WAAW;;4CAEI,MAAM,CAAC,KAAK;0BAC9B,MAAM,CAAC,QAAQ;wBACjB,MAAM,CAAC,SAAS,IAAI,MAAM;;;;;;2BAMvB,MAAM,CAAC,SAAS,IAAI,MAAM;EACnD,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;;;;;;;yBAOC,MAAM,CAAC,WAAW;;;;CAI1C,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AACT,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;sBA0Ba,MAAM,CAAC,WAAW;;uBAEjB,MAAM,CAAC,KAAK;;;;qBAId,MAAM,CAAC,SAAS,IAAI,MAAM;uBACxB,MAAM,CAAC,SAAS,IAAI,MAAM;;;;;;;;;;;;;;;;CAgBhD,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO;QACL,wBAAwB,EAAE,oBAAoB,CAAC,MAAM,CAAC;QACtD,wBAAwB,EAAE,oBAAoB,CAAC,MAAM,CAAC;KACvD,CAAC;AACJ,CAAC"}

package/dist/integrations/github/client.d.ts

@@ -0,0 +1,78 @@
+/**
+ * GitHub API Client
+ * Handles all GitHub API interactions using Octokit
+ */
+import type { GitHubConfig, GitHubLabel, GitHubMilestone, GitHubIssue, TaskBreakdown, ReleasePhase } from './types.js';
+export declare class GitHubClient {
+    private octokit;
+    private owner;
+    private repo;
+    constructor(config: GitHubConfig);
+    /**
+     * Verify connection and permissions
+     */
+    verify(): Promise<{
+        valid: boolean;
+        error?: string;
+    }>;
+    /**
+     * Create or update labels
+     */
+    ensureLabels(labels: GitHubLabel[]): Promise<{
+        created: number;
+        updated: number;
+    }>;
+    /**
+     * Create a milestone
+     */
+    createMilestone(milestone: GitHubMilestone): Promise<number | null>;
+    /**
+     * Find milestone by title
+     */
+    findMilestone(title: string): Promise<number | null>;
+    /**
+     * Create an issue
+     */
+    createIssue(issue: GitHubIssue): Promise<{
+        number: number;
+        url: string;
+    } | null>;
+    /**
+     * Create multiple issues from task breakdown
+     */
+    createIssuesFromTasks(tasks: TaskBreakdown[], options?: {
+        milestoneId?: number;
+        labelPrefix?: string;
+    }): Promise<Array<{
+        number: number;
+        url: string;
+        title: string;
+    }>>;
+    /**
+     * Format task body for GitHub issue
+     */
+    private formatTaskBody;
+    /**
+     * Create milestones from release phases
+     */
+    createMilestonesFromPhases(phases: ReleasePhase[]): Promise<Array<{
+        number: number;
+        title: string;
+    }>>;
+    /**
+     * Create PR templates
+     */
+    createPRTemplates(templates: Array<{
+        name: string;
+        content: string;
+    }>): Promise<number>;
+    /**
+     * Get repository info
+     */
+    getRepoInfo(): Promise<{
+        name: string;
+        url: string;
+        defaultBranch: string;
+    } | null>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/integrations/github/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/integrations/github/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EAGX,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAOpB,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;gBAET,MAAM,EAAE,YAAY;IAShC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAoB3D;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAoCxF;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBzE;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAe1D;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAiBtF;;OAEG;IACG,qBAAqB,CACzB,KAAK,EAAE,aAAa,EAAE,EACtB,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3D,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAsCjE;;OAEG;IACH,OAAO,CAAC,cAAc;IAkCtB;;OAEG;IACG,0BAA0B,CAC9B,MAAM,EAAE,YAAY,EAAE,GACrB,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAkBpD;;OAEG;IACG,iBAAiB,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IA0C7F;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAgB1F"}

package/dist/integrations/github/client.js

@@ -0,0 +1,279 @@
+/**
+ * GitHub API Client
+ * Handles all GitHub API interactions using Octokit
+ */
+import { Octokit } from '@octokit/rest';
+import { CATEGORY_LABELS, PRIORITY_LABELS, } from './types.js';
+export class GitHubClient {
+    octokit;
+    owner;
+    repo;
+    constructor(config) {
+        this.octokit = new Octokit({
+            auth: config.token,
+            baseUrl: config.baseUrl,
+        });
+        this.owner = config.owner;
+        this.repo = config.repo;
+    }
+    /**
+     * Verify connection and permissions
+     */
+    async verify() {
+        try {
+            const { data } = await this.octokit.repos.get({
+                owner: this.owner,
+                repo: this.repo,
+            });
+            if (!data.permissions?.push) {
+                return { valid: false, error: 'No push access to repository' };
+            }
+            return { valid: true };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+            };
+        }
+    }
+    /**
+     * Create or update labels
+     */
+    async ensureLabels(labels) {
+        let created = 0;
+        let updated = 0;
+        for (const label of labels) {
+            try {
+                await this.octokit.issues.createLabel({
+                    owner: this.owner,
+                    repo: this.repo,
+                    name: label.name,
+                    color: label.color,
+                    description: label.description,
+                });
+                created++;
+            }
+            catch (error) {
+                // Label might already exist, try to update
+                if (error.status === 422) {
+                    try {
+                        await this.octokit.issues.updateLabel({
+                            owner: this.owner,
+                            repo: this.repo,
+                            name: label.name,
+                            color: label.color,
+                            description: label.description,
+                        });
+                        updated++;
+                    }
+                    catch {
+                        // Ignore update errors
+                    }
+                }
+            }
+        }
+        return { created, updated };
+    }
+    /**
+     * Create a milestone
+     */
+    async createMilestone(milestone) {
+        try {
+            const { data } = await this.octokit.issues.createMilestone({
+                owner: this.owner,
+                repo: this.repo,
+                title: milestone.title,
+                description: milestone.description,
+                due_on: milestone.dueOn,
+                state: milestone.state || 'open',
+            });
+            return data.number;
+        }
+        catch (error) {
+            // Milestone might already exist
+            if (error.status === 422) {
+                const existing = await this.findMilestone(milestone.title);
+                return existing;
+            }
+            return null;
+        }
+    }
+    /**
+     * Find milestone by title
+     */
+    async findMilestone(title) {
+        try {
+            const { data } = await this.octokit.issues.listMilestones({
+                owner: this.owner,
+                repo: this.repo,
+                state: 'all',
+            });
+            const milestone = data.find((m) => m.title === title);
+            return milestone?.number || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Create an issue
+     */
+    async createIssue(issue) {
+        try {
+            const { data } = await this.octokit.issues.create({
+                owner: this.owner,
+                repo: this.repo,
+                title: issue.title,
+                body: issue.body,
+                labels: issue.labels,
+                milestone: issue.milestone,
+                assignees: issue.assignees,
+            });
+            return { number: data.number, url: data.html_url };
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Create multiple issues from task breakdown
+     */
+    async createIssuesFromTasks(tasks, options = {}) {
+        const results = [];
+        for (const task of tasks) {
+            const labels = ['blueprint', 'task'];
+            // Add priority label
+            if (task.priority && PRIORITY_LABELS[task.priority]) {
+                labels.push(PRIORITY_LABELS[task.priority].name);
+            }
+            // Add category label
+            if (task.category && CATEGORY_LABELS[task.category]) {
+                labels.push(CATEGORY_LABELS[task.category].name);
+            }
+            // Add prefix if specified
+            if (options.labelPrefix) {
+                labels.push(`${options.labelPrefix}:task`);
+            }
+            const body = this.formatTaskBody(task);
+            const result = await this.createIssue({
+                title: task.title,
+                body,
+                labels,
+                milestone: options.milestoneId,
+            });
+            if (result) {
+                results.push({ ...result, title: task.title });
+            }
+        }
+        return results;
+    }
+    /**
+     * Format task body for GitHub issue
+     */
+    formatTaskBody(task) {
+        const lines = [];
+        lines.push('## Description');
+        lines.push(task.description);
+        lines.push('');
+        if (task.estimatedHours) {
+            lines.push(`**Estimated Time:** ${task.estimatedHours} hours`);
+            lines.push('');
+        }
+        if (task.dependencies && task.dependencies.length > 0) {
+            lines.push('## Dependencies');
+            for (const dep of task.dependencies) {
+                lines.push(`- [ ] ${dep}`);
+            }
+            lines.push('');
+        }
+        if (task.acceptanceCriteria && task.acceptanceCriteria.length > 0) {
+            lines.push('## Acceptance Criteria');
+            for (const ac of task.acceptanceCriteria) {
+                lines.push(`- [ ] ${ac}`);
+            }
+            lines.push('');
+        }
+        lines.push('---');
+        lines.push('*Generated by [Intent Blueprint](https://github.com/intent-solutions-io/intent-blueprint-docs)*');
+        return lines.join('\n');
+    }
+    /**
+     * Create milestones from release phases
+     */
+    async createMilestonesFromPhases(phases) {
+        const results = [];
+        for (const phase of phases) {
+            const milestoneId = await this.createMilestone({
+                title: phase.name,
+                description: phase.description,
+                dueOn: phase.endDate,
+            });
+            if (milestoneId) {
+                results.push({ number: milestoneId, title: phase.name });
+            }
+        }
+        return results;
+    }
+    /**
+     * Create PR templates
+     */
+    async createPRTemplates(templates) {
+        let created = 0;
+        for (const template of templates) {
+            try {
+                const path = template.name === 'default'
+                    ? '.github/PULL_REQUEST_TEMPLATE.md'
+                    : `.github/PULL_REQUEST_TEMPLATE/${template.name}.md`;
+                // Check if file exists
+                let sha;
+                try {
+                    const { data } = await this.octokit.repos.getContent({
+                        owner: this.owner,
+                        repo: this.repo,
+                        path,
+                    });
+                    if ('sha' in data) {
+                        sha = data.sha;
+                    }
+                }
+                catch {
+                    // File doesn't exist, that's fine
+                }
+                await this.octokit.repos.createOrUpdateFileContents({
+                    owner: this.owner,
+                    repo: this.repo,
+                    path,
+                    message: `docs: add ${template.name} PR template (Intent Blueprint)`,
+                    content: Buffer.from(template.content).toString('base64'),
+                    sha,
+                });
+                created++;
+            }
+            catch {
+                // Ignore errors for individual templates
+            }
+        }
+        return created;
+    }
+    /**
+     * Get repository info
+     */
+    async getRepoInfo() {
+        try {
+            const { data } = await this.octokit.repos.get({
+                owner: this.owner,
+                repo: this.repo,
+            });
+            return {
+                name: data.full_name,
+                url: data.html_url,
+                defaultBranch: data.default_branch,
+            };
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/integrations/github/client.js.map

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

package/dist/integrations/github/exporter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * GitHub Exporter
+ * Converts Blueprint documents to GitHub artifacts (issues, milestones, templates)
+ */
+import type { GitHubConfig, ExportResult, ExportOptions, TaskBreakdown, ReleasePhase, GitHubLabel } from './types.js';
+import type { GeneratedDocument, TemplateContext } from '../../core/index.js';
+export declare class GitHubExporter {
+    private client;
+    private options;
+    constructor(config: GitHubConfig, options?: ExportOptions);
+    /**
+     * Export generated documents to GitHub
+     */
+    export(documents: GeneratedDocument[], context: TemplateContext): Promise<ExportResult>;
+    /**
+     * Get all labels to create
+     */
+    private getAllLabels;
+    /**
+     * Extract tasks from generated documents
+     */
+    private extractTasks;
+    /**
+     * Parse tasks from markdown content
+     */
+    private parseTasksFromMarkdown;
+    /**
+     * Extract release phases from documents
+     */
+    private extractPhases;
+    /**
+     * Parse release phases from markdown
+     */
+    private parsePhasesFromMarkdown;
+    /**
+     * Generate PR templates based on project context
+     */
+    private generatePRTemplates;
+    /**
+     * Preview what would be exported (dry run)
+     */
+    preview(documents: GeneratedDocument[], context: TemplateContext): Promise<{
+        labels: GitHubLabel[];
+        tasks: TaskBreakdown[];
+        phases: ReleasePhase[];
+        prTemplates: string[];
+    }>;
+}
+/**
+ * Quick export function
+ */
+export declare function exportToGitHub(config: GitHubConfig, documents: GeneratedDocument[], context: TemplateContext, options?: ExportOptions): Promise<ExportResult>;
+//# sourceMappingURL=exporter.d.ts.map

package/dist/integrations/github/exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../src/integrations/github/exporter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAMpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE9E,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAgB;gBAEnB,MAAM,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB;IAY7D;;OAEG;IACG,MAAM,CACV,SAAS,EAAE,iBAAiB,EAAE,EAC9B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,YAAY,CAAC;IAyExB;;OAEG;IACH,OAAO,CAAC,YAAY;IAyBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuF9B;;OAEG;IACH,OAAO,CAAC,aAAa;IAarB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsD/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkG3B;;OAEG;IACG,OAAO,CACX,SAAS,EAAE,iBAAiB,EAAE,EAC9B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC;QACT,MAAM,EAAE,WAAW,EAAE,CAAC;QACtB,KAAK,EAAE,aAAa,EAAE,CAAC;QACvB,MAAM,EAAE,YAAY,EAAE,CAAC;QACvB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;CAQH;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,iBAAiB,EAAE,EAC9B,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAGvB"}