specweave 0.17.0 → 0.17.1

package/dist/src/core/repo-structure/prompt-consolidator.js

@@ -0,0 +1,180 @@
+/**
+ * Prompt Consolidator
+ *
+ * Consolidates multi-repo architecture prompts into clear, jargon-free questions.
+ * Removes duplicated "polyrepo" terminology and provides visual examples.
+ *
+ * @module prompt-consolidator
+ */
+/**
+ * Get consolidated architecture prompt
+ *
+ * Replaces separate questions about "single vs multi" and "polyrepo vs parent"
+ * with a single clear question.
+ *
+ * @returns Architecture options for user selection
+ */
+export function getArchitecturePrompt() {
+    return {
+        question: 'What is your repository architecture?',
+        options: [
+            {
+                value: 'single',
+                label: 'Single repository',
+                description: 'All code in one repository',
+                example: `
+my-project/
+├── .specweave/
+├── frontend/
+├── backend/
+└── shared/
+        `.trim()
+            },
+            {
+                value: 'multi-with-parent',
+                label: 'Multiple separate repositories WITH parent repository',
+                description: '1 parent repo (specs, docs) + N implementation repos (recommended for teams)',
+                example: `
+my-project-parent/         ← Parent repo (specs, docs, increments)
+├── .specweave/
+my-project-frontend/       ← Separate GitHub repo
+my-project-backend/        ← Separate GitHub repo
+        `.trim()
+            },
+            {
+                value: 'multi-without-parent',
+                label: 'Multiple separate repositories WITHOUT parent repository',
+                description: 'Each repo has its own .specweave/ (NOT RECOMMENDED - leads to fragmentation)',
+                example: `
+my-project-frontend/
+├── .specweave/            ← Duplicated
+my-project-backend/
+├── .specweave/            ← Duplicated (causes conflicts)
+        `.trim()
+            },
+            {
+                value: 'monorepo',
+                label: 'Monorepo (single repo, multiple projects)',
+                description: 'All code in one repo, organized by project (best for tightly coupled services)',
+                example: `
+my-monorepo/
+├── .specweave/
+├── packages/
+│   ├── frontend/
+│   ├── backend/
+│   └── shared/
+        `.trim()
+            }
+        ]
+    };
+}
+/**
+ * Get parent repository benefits explanation
+ *
+ * @returns Detailed benefits with examples
+ */
+export function getParentRepoBenefits() {
+    return `
+**Why use a parent repository?**
+
+✅ **Central .specweave/ for all specs/docs**
+   - One source of truth for entire system
+   - No duplication or fragmentation
+   - Easy to search and navigate
+
+✅ **Cross-cutting features naturally supported**
+   - Authentication spans frontend + backend + mobile
+   - All specs in one place, not scattered
+
+✅ **System-wide architecture decisions**
+   - ADRs apply to entire system
+   - Technology stack decisions documented centrally
+
+✅ **Simplified onboarding**
+   - New developers read one set of docs
+   - Complete system overview in one repo
+
+✅ **Compliance & auditing**
+   - Complete audit trail in one place
+   - Regulatory requirements easier to satisfy
+
+**Example Structure:**
+
+my-project-parent/         ← Contains .specweave/ (cloned locally)
+├── .specweave/
+│   ├── increments/
+│   ├── docs/
+│   └── logs/
+├── .env                   ← GitHub config
+└── .gitignore
+
+frontend/                  ← Cloned from GitHub (root-level!)
+backend/                   ← Cloned from GitHub (root-level!)
+shared/                    ← Cloned from GitHub (root-level!)
+
+**Note:** Implementation repos are cloned at root level for clean folder structure.
+  `.trim();
+}
+/**
+ * Get repository count clarification
+ *
+ * @param parentCount - Number of parent repos
+ * @param implCount - Number of implementation repos
+ * @returns Clarification message
+ */
+export function getRepoCountClarification(parentCount, implCount) {
+    const total = parentCount + implCount;
+    if (parentCount === 1) {
+        return `**Total repositories to create**: ${total}
+  • 1 parent repository (specs, docs, increments)
+  • ${implCount} implementation ${implCount === 1 ? 'repository' : 'repositories'}
+
+This means **${total} GitHub repositories** will be created.`;
+    }
+    return `**Total repositories to create**: ${total}`;
+}
+/**
+ * Get visibility prompt
+ *
+ * @param repoName - Repository name
+ * @returns Visibility question and options
+ */
+export function getVisibilityPrompt(repoName) {
+    return {
+        question: `Repository visibility for "${repoName}"?`,
+        options: [
+            {
+                value: 'private',
+                label: 'Private (Recommended)',
+                description: 'Only you and collaborators can see this repository'
+            },
+            {
+                value: 'public',
+                label: 'Public',
+                description: 'Anyone can see this repository'
+            }
+        ],
+        default: 'private'
+    };
+}
+/**
+ * Format architecture choice for display
+ *
+ * @param choice - Architecture choice
+ * @returns Human-readable format
+ */
+export function formatArchitectureChoice(choice) {
+    switch (choice) {
+        case 'single':
+            return 'Single repository';
+        case 'multi-with-parent':
+            return 'Multiple repositories with parent';
+        case 'multi-without-parent':
+            return 'Multiple repositories without parent';
+        case 'monorepo':
+            return 'Monorepo';
+        default:
+            return choice;
+    }
+}
+//# sourceMappingURL=prompt-consolidator.js.map

package/dist/src/core/repo-structure/prompt-consolidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-consolidator.js","sourceRoot":"","sources":["../../../../src/core/repo-structure/prompt-consolidator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB;IAInC,OAAO;QACL,QAAQ,EAAE,uCAAuC;QACjD,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,mBAAmB;gBAC1B,WAAW,EAAE,4BAA4B;gBACzC,OAAO,EAAE;;;;;;SAMR,CAAC,IAAI,EAAE;aACT;YACD;gBACE,KAAK,EAAE,mBAAmB;gBAC1B,KAAK,EAAE,uDAAuD;gBAC9D,WAAW,EAAE,8EAA8E;gBAC3F,OAAO,EAAE;;;;;SAKR,CAAC,IAAI,EAAE;aACT;YACD;gBACE,KAAK,EAAE,sBAAsB;gBAC7B,KAAK,EAAE,0DAA0D;gBACjE,WAAW,EAAE,8EAA8E;gBAC3F,OAAO,EAAE;;;;;SAKR,CAAC,IAAI,EAAE;aACT;YACD;gBACE,KAAK,EAAE,UAAU;gBACjB,KAAK,EAAE,2CAA2C;gBAClD,WAAW,EAAE,gFAAgF;gBAC7F,OAAO,EAAE;;;;;;;SAOR,CAAC,IAAI,EAAE;aACT;SACF;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCN,CAAC,IAAI,EAAE,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB,EAAE,SAAiB;IAC9E,MAAM,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;IAEtC,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,qCAAqC,KAAK;;MAE/C,SAAS,mBAAmB,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc;;eAElE,KAAK,yCAAyC,CAAC;IAC5D,CAAC;IAED,OAAO,qCAAqC,KAAK,EAAE,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAgB;IAKlD,OAAO;QACL,QAAQ,EAAE,8BAA8B,QAAQ,IAAI;QACpD,OAAO,EAAE;YACP;gBACE,KAAK,EAAE,SAAS;gBAChB,KAAK,EAAE,uBAAuB;gBAC9B,WAAW,EAAE,oDAAoD;aAClE;YACD;gBACE,KAAK,EAAE,QAAQ;gBACf,KAAK,EAAE,QAAQ;gBACf,WAAW,EAAE,gCAAgC;aAC9C;SACF;QACD,OAAO,EAAE,SAAS;KACnB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAA0B;IACjE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,mBAAmB,CAAC;QAC7B,KAAK,mBAAmB;YACtB,OAAO,mCAAmC,CAAC;QAC7C,KAAK,sBAAsB;YACzB,OAAO,sCAAsC,CAAC;QAChD,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/core/repo-structure/repo-id-generator.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Repository ID Generator
+ *
+ * Auto-generates clean, unique repository IDs from repository names.
+ * Strips common suffixes and takes last segment for readable IDs.
+ *
+ * Examples:
+ *   "my-saas-frontend-app" → "frontend"
+ *   "acme-api-gateway-service" → "gateway"
+ *   "backend-service" → "backend"
+ *
+ * @module repo-id-generator
+ */
+/**
+ * Validation result for repository IDs
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Result of ensuring unique ID
+ */
+export interface UniqueIdResult {
+    id: string;
+    wasModified: boolean;
+}
+/**
+ * Generate a clean repository ID from a repository name.
+ *
+ * Algorithm:
+ * 1. Convert to lowercase
+ * 2. Strip one common suffix from the end (if exists): -app, -service, etc.
+ * 3. Split by hyphens
+ * 4. Take the last segment
+ *
+ * @param repoName - Full repository name (e.g., "my-saas-frontend-app")
+ * @returns Clean repository ID (e.g., "frontend")
+ *
+ * @example
+ * generateRepoId("my-saas-frontend-app") // "frontend" (strips "-app", then takes "frontend")
+ * generateRepoId("acme-api-gateway-service") // "gateway" (strips "-service", then takes "gateway")
+ * generateRepoId("backend-service") // "backend" (strips "-service", then takes "backend")
+ * generateRepoId("acme-saas-mobile") // "mobile" (no suffix to strip, takes "mobile")
+ */
+export declare function generateRepoId(repoName: string): string;
+/**
+ * Ensure repository ID is unique by appending numeric suffix if needed.
+ *
+ * @param baseId - Base repository ID to make unique
+ * @param existingIds - Set of already-used IDs
+ * @returns Unique ID with modification flag
+ *
+ * @example
+ * ensureUniqueId("frontend", new Set()) // { id: "frontend", wasModified: false }
+ * ensureUniqueId("frontend", new Set(["frontend"])) // { id: "frontend-2", wasModified: true }
+ * ensureUniqueId("frontend", new Set(["frontend", "frontend-2"])) // { id: "frontend-3", wasModified: true }
+ */
+export declare function ensureUniqueId(baseId: string, existingIds: Set<string>): UniqueIdResult;
+/**
+ * Validate a repository ID against naming rules.
+ *
+ * Rules:
+ * - No commas (prevents "parent,fe,be" input error)
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must start with a letter
+ * - Length 1-50 characters
+ * - No spaces or special characters
+ *
+ * @param id - Repository ID to validate
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * validateRepoId("frontend-app") // { valid: true }
+ * validateRepoId("parent,fe,be") // { valid: false, error: "..." }
+ * validateRepoId("MyRepo") // { valid: false, error: "..." }
+ */
+export declare function validateRepoId(id: string): ValidationResult;
+//# sourceMappingURL=repo-id-generator.d.ts.map

package/dist/src/core/repo-structure/repo-id-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-id-generator.d.ts","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-id-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAuBvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,cAAc,CAYvF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAqC3D"}

package/dist/src/core/repo-structure/repo-id-generator.js

@@ -0,0 +1,135 @@
+/**
+ * Repository ID Generator
+ *
+ * Auto-generates clean, unique repository IDs from repository names.
+ * Strips common suffixes and takes last segment for readable IDs.
+ *
+ * Examples:
+ *   "my-saas-frontend-app" → "frontend"
+ *   "acme-api-gateway-service" → "gateway"
+ *   "backend-service" → "backend"
+ *
+ * @module repo-id-generator
+ */
+/**
+ * Common repository name suffixes to strip
+ */
+const REPO_SUFFIXES = [
+    '-app',
+    '-service',
+    '-api',
+    '-frontend',
+    '-backend',
+    '-web',
+    '-mobile'
+];
+/**
+ * Generate a clean repository ID from a repository name.
+ *
+ * Algorithm:
+ * 1. Convert to lowercase
+ * 2. Strip one common suffix from the end (if exists): -app, -service, etc.
+ * 3. Split by hyphens
+ * 4. Take the last segment
+ *
+ * @param repoName - Full repository name (e.g., "my-saas-frontend-app")
+ * @returns Clean repository ID (e.g., "frontend")
+ *
+ * @example
+ * generateRepoId("my-saas-frontend-app") // "frontend" (strips "-app", then takes "frontend")
+ * generateRepoId("acme-api-gateway-service") // "gateway" (strips "-service", then takes "gateway")
+ * generateRepoId("backend-service") // "backend" (strips "-service", then takes "backend")
+ * generateRepoId("acme-saas-mobile") // "mobile" (no suffix to strip, takes "mobile")
+ */
+export function generateRepoId(repoName) {
+    if (!repoName) {
+        return '';
+    }
+    let cleaned = repoName.toLowerCase();
+    // Strip one suffix from the end (if exists)
+    for (const suffix of REPO_SUFFIXES) {
+        if (cleaned.endsWith(suffix)) {
+            cleaned = cleaned.slice(0, -suffix.length);
+            break; // Only strip one suffix
+        }
+    }
+    // Split by hyphen and take last segment
+    const segments = cleaned.split('-').filter(seg => seg.length > 0);
+    if (segments.length === 0) {
+        return '';
+    }
+    return segments[segments.length - 1];
+}
+/**
+ * Ensure repository ID is unique by appending numeric suffix if needed.
+ *
+ * @param baseId - Base repository ID to make unique
+ * @param existingIds - Set of already-used IDs
+ * @returns Unique ID with modification flag
+ *
+ * @example
+ * ensureUniqueId("frontend", new Set()) // { id: "frontend", wasModified: false }
+ * ensureUniqueId("frontend", new Set(["frontend"])) // { id: "frontend-2", wasModified: true }
+ * ensureUniqueId("frontend", new Set(["frontend", "frontend-2"])) // { id: "frontend-3", wasModified: true }
+ */
+export function ensureUniqueId(baseId, existingIds) {
+    if (!existingIds.has(baseId)) {
+        return { id: baseId, wasModified: false };
+    }
+    // Find first available suffix
+    let counter = 2;
+    while (existingIds.has(`${baseId}-${counter}`)) {
+        counter++;
+    }
+    return { id: `${baseId}-${counter}`, wasModified: true };
+}
+/**
+ * Validate a repository ID against naming rules.
+ *
+ * Rules:
+ * - No commas (prevents "parent,fe,be" input error)
+ * - Lowercase letters, numbers, and hyphens only
+ * - Must start with a letter
+ * - Length 1-50 characters
+ * - No spaces or special characters
+ *
+ * @param id - Repository ID to validate
+ * @returns Validation result with error message if invalid
+ *
+ * @example
+ * validateRepoId("frontend-app") // { valid: true }
+ * validateRepoId("parent,fe,be") // { valid: false, error: "..." }
+ * validateRepoId("MyRepo") // { valid: false, error: "..." }
+ */
+export function validateRepoId(id) {
+    // Check empty
+    if (!id || id.trim().length === 0) {
+        return { valid: false, error: 'Repository ID cannot be empty' };
+    }
+    // Check length
+    if (id.length > 50) {
+        return { valid: false, error: 'Repository ID exceeds maximum length (50 characters)' };
+    }
+    // Check for commas (prevents "parent,fe,be" error)
+    if (id.includes(',')) {
+        return { valid: false, error: 'Repository ID cannot contain commas' };
+    }
+    // Check for spaces
+    if (id.includes(' ')) {
+        return { valid: false, error: 'Repository ID cannot contain spaces' };
+    }
+    // Check for uppercase letters
+    if (id !== id.toLowerCase()) {
+        return { valid: false, error: 'Repository ID must be lowercase' };
+    }
+    // Check starts with letter
+    if (!/^[a-z]/.test(id)) {
+        return { valid: false, error: 'Repository ID must start with a letter' };
+    }
+    // Check alphanumeric + hyphens only
+    if (!/^[a-z][a-z0-9-]*$/.test(id)) {
+        return { valid: false, error: 'Repository ID must contain only lowercase letters, numbers, and hyphens (alphanumeric)' };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=repo-id-generator.js.map

package/dist/src/core/repo-structure/repo-id-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-id-generator.js","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-id-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/core/repo-structure/repo-structure-manager.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Repository Structure Manager
+ *
+ * Handles various repository architectures for SpecWeave projects:
+ * - Single repository
+ * - Multi-repository (polyrepo/microservices)
+ * - Monorepo (single repo with multiple projects)
+ * - Parent repository approach (parent folder with .specweave + nested implementation repos)
+ *
+ * Provides capabilities to:
+ * - Create GitHub repositories via API
+ * - Initialize git repositories locally
+ * - Configure proper folder structure
+ * - Organize specs per project/team
+ * - Split tasks between repositories
+ */
+export type RepoArchitecture = 'single' | 'multi-repo' | 'monorepo' | 'parent';
+export interface RepoStructureConfig {
+    architecture: RepoArchitecture;
+    parentRepo?: {
+        name: string;
+        owner: string;
+        description: string;
+        visibility: 'private' | 'public';
+        createOnGitHub: boolean;
+    };
+    repositories: Array<{
+        id: string;
+        name: string;
+        owner: string;
+        description: string;
+        path: string;
+        visibility: 'private' | 'public';
+        createOnGitHub: boolean;
+        isNested: boolean;
+    }>;
+    monorepoProjects?: string[];
+}
+export declare class RepoStructureManager {
+    private projectPath;
+    private githubToken?;
+    private stateManager;
+    constructor(projectPath: string, githubToken?: string);
+    /**
+     * Prompt user for repository structure decisions
+     */
+    promptStructure(): Promise<RepoStructureConfig>;
+    /**
+     * Map ArchitectureChoice to internal RepoArchitecture
+     */
+    private mapArchitectureChoice;
+    /**
+     * Resume setup from saved state
+     */
+    private resumeSetup;
+    /**
+     * Configure single repository
+     */
+    private configureSingleRepo;
+    /**
+     * Configure multi-repository architecture
+     */
+    private configureMultiRepo;
+    /**
+     * Save setup state for Ctrl+C recovery
+     */
+    private saveSetupState;
+    /**
+     * Configure monorepo
+     */
+    private configureMonorepo;
+    /**
+     * Create repositories on GitHub via API
+     */
+    createGitHubRepositories(config: RepoStructureConfig): Promise<void>;
+    /**
+     * Generate .env file with GitHub configuration
+     */
+    private generateEnvFile;
+    /**
+     * Show setup completion summary
+     */
+    private showSetupSummary;
+    /**
+     * Create a single GitHub repository via API
+     */
+    private createGitHubRepo;
+    /**
+     * Check if a GitHub account is an organization
+     */
+    private isGitHubOrganization;
+    /**
+     * Initialize local git repositories
+     */
+    initializeLocalRepos(config: RepoStructureConfig): Promise<void>;
+    /**
+     * Create basic structure for a repository/project
+     */
+    private createBasicRepoStructure;
+    /**
+     * Create SpecWeave project structure
+     */
+    createSpecWeaveStructure(config: RepoStructureConfig): Promise<void>;
+}
+//# sourceMappingURL=repo-structure-manager.d.ts.map

package/dist/src/core/repo-structure/repo-structure-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-structure-manager.d.ts","sourceRoot":"","sources":["../../../../src/core/repo-structure/repo-structure-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAsBH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,gBAAgB,CAAC;IAC/B,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;QACjC,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,YAAY,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,SAAS,GAAG,QAAQ,CAAC;QACjC,cAAc,EAAE,OAAO,CAAC;QACxB,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAoB;gBAE5B,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IAMrD;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAwDrD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,mBAAmB;IA2GjC;;OAEG;YACW,kBAAkB;IA6PhC;;OAEG;YACW,cAAc;IAQ5B;;OAEG;YACW,iBAAiB;IA4E/B;;OAEG;IACG,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiF1E;;OAEG;YACW,eAAe;IA8C7B;;OAEG;YACW,gBAAgB;IAgC9B;;OAEG;YACW,gBAAgB;IAmC9B;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiFtE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAyBhC;;OAEG;IACG,wBAAwB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAgD3E"}