ddlforge 0.2.1 → 0.5.0

package/dist/src/rules/index.js

@@ -9,6 +9,9 @@ export { foreignKeyNotValidRule } from './foreignKeyNotValid.js';
 export { prismaRenameDropAddRule } from './prismaRenameDropAdd.js';
 export { setNotNullFullScanRule } from './setNotNullFullScan.js';
 export { unbatchedBackfillRule } from './unbatchedBackfill.js';
+export { checkConstraintNotValidRule } from './checkConstraintNotValid.js';
+export { uniqueConstraintUsingIndexRule } from './uniqueConstraintUsingIndex.js';
+export { sessionAdvisoryLockRule } from './sessionAdvisoryLock.js';
 import { indexConcurrentlyRule } from './indexConcurrently.js';
 import { transactionTrapRule } from './transactionTrap.js';
 import { addColumnNotNullRule } from './addColumnNotNull.js';
@@ -16,6 +19,9 @@ import { foreignKeyNotValidRule } from './foreignKeyNotValid.js';
 import { prismaRenameDropAddRule } from './prismaRenameDropAdd.js';
 import { setNotNullFullScanRule } from './setNotNullFullScan.js';
 import { unbatchedBackfillRule } from './unbatchedBackfill.js';
+import { checkConstraintNotValidRule } from './checkConstraintNotValid.js';
+import { uniqueConstraintUsingIndexRule } from './uniqueConstraintUsingIndex.js';
+import { sessionAdvisoryLockRule } from './sessionAdvisoryLock.js';
 export const ALL_RULES = [
     indexConcurrentlyRule,
     transactionTrapRule,
@@ -24,5 +30,8 @@ export const ALL_RULES = [
     prismaRenameDropAddRule,
     setNotNullFullScanRule,
     unbatchedBackfillRule,
+    checkConstraintNotValidRule,
+    uniqueConstraintUsingIndexRule,
+    sessionAdvisoryLockRule,
 ];
 //# sourceMappingURL=index.js.map

package/dist/src/rules/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE/D,MAAM,CAAC,MAAM,SAAS,GAAW;IAC/B,qBAAqB;IACrB,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;IACtB,qBAAqB;CACtB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/rules/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,8BAA8B,EAAE,MAAM,iCAAiC,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,CAAC,MAAM,SAAS,GAAW;IAC/B,qBAAqB;IACrB,mBAAmB;IACnB,oBAAoB;IACpB,sBAAsB;IACtB,uBAAuB;IACvB,sBAAsB;IACtB,qBAAqB;IACrB,2BAA2B;IAC3B,8BAA8B;IAC9B,uBAAuB;CACxB,CAAC"}

package/dist/src/rules/sessionAdvisoryLock.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ddlforge Rule: Session-level advisory lock
+ *
+ * Severity: WARNING
+ * Lock: NONE
+ */
+import { Rule } from './types.js';
+export declare const sessionAdvisoryLockRule: Rule;
+//# sourceMappingURL=sessionAdvisoryLock.d.ts.map

package/dist/src/rules/sessionAdvisoryLock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionAdvisoryLock.d.ts","sourceRoot":"","sources":["../../../src/rules/sessionAdvisoryLock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAwB,MAAM,YAAY,CAAC;AAGxD,eAAO,MAAM,uBAAuB,EAAE,IA8CrC,CAAC"}

package/dist/src/rules/sessionAdvisoryLock.js

@@ -0,0 +1,47 @@
+/**
+ * ddlforge Rule: Session-level advisory lock
+ *
+ * Severity: WARNING
+ * Lock: NONE
+ */
+import { PostgresLockLevel } from '../engine/locks.js';
+export const sessionAdvisoryLockRule = {
+    id: 'session-advisory-lock',
+    name: 'Session-level advisory lock',
+    description: 'Session-level advisory locks (pg_advisory_lock / pg_try_advisory_lock) are tied to the database connection, not the transaction. In connection-pooled environments, these locks leak across connections.',
+    defaultSeverity: 'WARNING',
+    lockLevel: PostgresLockLevel.NONE,
+    check(context) {
+        const findings = [];
+        for (const stmt of context.statements) {
+            if (stmt.hasIgnore(this.id))
+                continue;
+            for (const token of stmt.tokens) {
+                const raw = token.raw;
+                // Match pg_advisory_lock or pg_try_advisory_lock (case-insensitive)
+                // but NOT pg_advisory_xact_lock or pg_try_advisory_xact_lock
+                if (/^pg_(try_)?advisory_lock$/i.test(raw) &&
+                    !/^pg_(try_)?advisory_xact_lock$/i.test(raw)) {
+                    findings.push({
+                        ruleId: this.id,
+                        ruleName: this.name,
+                        severity: this.defaultSeverity,
+                        lockLevel: this.lockLevel,
+                        message: `Session-level advisory lock "${raw}(...)" detected.`,
+                        detail: `Session-level advisory locks (pg_advisory_lock / pg_try_advisory_lock) are tied to the database connection, not the transaction. ` +
+                            `In connection-pooled environments (PgBouncer transaction mode), these locks leak across connections, leading to stranded locks and potential migration deadlocks.`,
+                        suggestion: `Replace with transaction-scoped variants that auto-release on COMMIT or ROLLBACK:\n` +
+                            `   pg_advisory_xact_lock(key)     -- blocks until acquired\n` +
+                            `   pg_try_advisory_xact_lock(key) -- returns false if not immediately available`,
+                        file: context.filePath,
+                        line: stmt.startLine,
+                        column: stmt.startColumn,
+                        codeSnippet: stmt.raw,
+                    });
+                }
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=sessionAdvisoryLock.js.map

package/dist/src/rules/sessionAdvisoryLock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionAdvisoryLock.js","sourceRoot":"","sources":["../../../src/rules/sessionAdvisoryLock.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,CAAC,MAAM,uBAAuB,GAAS;IAC3C,EAAE,EAAE,uBAAuB;IAC3B,IAAI,EAAE,6BAA6B;IACnC,WAAW,EAAE,0MAA0M;IACvN,eAAe,EAAE,SAAS;IAC1B,SAAS,EAAE,iBAAiB,CAAC,IAAI;IAEjC,KAAK,CAAC,OAAoB;QACxB,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACtC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YAEtC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;gBAEtB,oEAAoE;gBACpE,6DAA6D;gBAC7D,IACE,4BAA4B,CAAC,IAAI,CAAC,GAAG,CAAC;oBACtC,CAAC,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,EAC5C,CAAC;oBACD,QAAQ,CAAC,IAAI,CAAC;wBACZ,MAAM,EAAE,IAAI,CAAC,EAAE;wBACf,QAAQ,EAAE,IAAI,CAAC,IAAI;wBACnB,QAAQ,EAAE,IAAI,CAAC,eAAe;wBAC9B,SAAS,EAAE,IAAI,CAAC,SAAS;wBACzB,OAAO,EAAE,gCAAgC,GAAG,kBAAkB;wBAC9D,MAAM,EACJ,mIAAmI;4BACnI,mKAAmK;wBACrK,UAAU,EACR,qFAAqF;4BACrF,8DAA8D;4BAC9D,iFAAiF;wBACnF,IAAI,EAAE,OAAO,CAAC,QAAQ;wBACtB,IAAI,EAAE,IAAI,CAAC,SAAS;wBACpB,MAAM,EAAE,IAAI,CAAC,WAAW;wBACxB,WAAW,EAAE,IAAI,CAAC,GAAG;qBACtB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF,CAAC"}

package/dist/src/rules/uniqueConstraintUsingIndex.d.ts

@@ -0,0 +1,9 @@
+/**
+ * ddlforge Rule: ADD CONSTRAINT UNIQUE without pre-built index
+ *
+ * Severity: BLOCKER
+ * Lock: SHARE
+ */
+import { Rule } from './types.js';
+export declare const uniqueConstraintUsingIndexRule: Rule;
+//# sourceMappingURL=uniqueConstraintUsingIndex.d.ts.map

package/dist/src/rules/uniqueConstraintUsingIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uniqueConstraintUsingIndex.d.ts","sourceRoot":"","sources":["../../../src/rules/uniqueConstraintUsingIndex.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAwB,MAAM,YAAY,CAAC;AA0GxD,eAAO,MAAM,8BAA8B,EAAE,IAyD5C,CAAC"}

package/dist/src/rules/uniqueConstraintUsingIndex.js

@@ -0,0 +1,145 @@
+/**
+ * ddlforge Rule: ADD CONSTRAINT UNIQUE without pre-built index
+ *
+ * Severity: BLOCKER
+ * Lock: SHARE
+ */
+import { PostgresLockLevel } from '../engine/locks.js';
+function extractUniqueConstraintClauses(tokens) {
+    const clauses = [];
+    let parenDepth = 0;
+    let i = 0;
+    while (i < tokens.length) {
+        if (tokens[i].value === '(') {
+            parenDepth++;
+            i++;
+            continue;
+        }
+        if (tokens[i].value === ')') {
+            parenDepth--;
+            i++;
+            continue;
+        }
+        if (parenDepth === 0 && tokens[i].value === 'ADD') {
+            let currentIdx = i + 1;
+            let constraintName;
+            if (tokens[currentIdx]?.value === 'CONSTRAINT') {
+                currentIdx++;
+                constraintName = tokens[currentIdx]?.raw;
+                currentIdx++;
+            }
+            // Check if this clause is a UNIQUE constraint
+            if (tokens[currentIdx]?.value === 'UNIQUE') {
+                currentIdx++;
+                // If next significant token is USING, it's the safe USING INDEX form
+                const isUsingIndex = tokens[currentIdx]?.value === 'USING' &&
+                    tokens[currentIdx + 1]?.value === 'INDEX';
+                // Collect column list from the (...) after UNIQUE, if present
+                let columns = '<columns>';
+                if (!isUsingIndex && tokens[currentIdx]?.value === '(') {
+                    // Collect raw tokens inside the parens
+                    const colTokens = [];
+                    let subParen = 1;
+                    currentIdx++; // move past '('
+                    while (currentIdx < tokens.length && subParen > 0) {
+                        const t = tokens[currentIdx];
+                        if (t.value === '(')
+                            subParen++;
+                        else if (t.value === ')') {
+                            subParen--;
+                            if (subParen === 0)
+                                break;
+                        }
+                        colTokens.push(t.raw);
+                        currentIdx++;
+                    }
+                    columns = colTokens.join(', ');
+                }
+                // Collect all tokens for this constraint until top-level comma or end
+                const clauseTokens = [];
+                let subParen = 0;
+                // Reset to position right after UNIQUE keyword (already advanced above)
+                // Re-scan from after UNIQUE to gather full clause tokens
+                let scanIdx = i + 1;
+                // Skip past CONSTRAINT <name> and UNIQUE
+                if (tokens[scanIdx]?.value === 'CONSTRAINT')
+                    scanIdx += 2;
+                scanIdx++; // skip UNIQUE
+                while (scanIdx < tokens.length) {
+                    const t = tokens[scanIdx];
+                    if (t.value === '(')
+                        subParen++;
+                    if (t.value === ')')
+                        subParen--;
+                    if (subParen === 0 && t.value === ',')
+                        break;
+                    clauseTokens.push(t);
+                    scanIdx++;
+                }
+                clauses.push({
+                    constraintName,
+                    columns,
+                    isUsingIndex,
+                    tokens: clauseTokens,
+                });
+                i = scanIdx;
+                continue;
+            }
+        }
+        i++;
+    }
+    return clauses;
+}
+export const uniqueConstraintUsingIndexRule = {
+    id: 'unique-constraint-using-index',
+    name: 'ADD CONSTRAINT UNIQUE without pre-built index',
+    description: 'Adding a UNIQUE constraint directly takes a SHARE lock and performs a full-table scan, blocking all concurrent writes (INSERT, UPDATE, DELETE) for the entire duration.',
+    defaultSeverity: 'BLOCKER',
+    lockLevel: PostgresLockLevel.SHARE,
+    check(context) {
+        const findings = [];
+        for (const stmt of context.statements) {
+            if (stmt.hasIgnore(this.id))
+                continue;
+            const tokens = stmt.tokens;
+            if (tokens.length < 6)
+                continue;
+            if (tokens[0].value !== 'ALTER' || tokens[1].value !== 'TABLE')
+                continue;
+            // Extract table name
+            let idx = 2;
+            if (tokens[idx]?.value === 'ONLY')
+                idx++;
+            if (tokens[idx]?.value === 'IF' && tokens[idx + 1]?.value === 'EXISTS')
+                idx += 2;
+            const tableName = tokens[idx]?.raw ?? 'table';
+            idx++;
+            const clauses = extractUniqueConstraintClauses(tokens.slice(idx));
+            for (const clause of clauses) {
+                if (!clause.isUsingIndex) {
+                    const cName = clause.constraintName ?? 'uq_name';
+                    const cNameDisplay = clause.constraintName ? ` "${clause.constraintName}"` : '';
+                    const idxName = clause.constraintName ? `${clause.constraintName}_idx` : 'uq_idx_name';
+                    findings.push({
+                        ruleId: this.id,
+                        ruleName: this.name,
+                        severity: this.defaultSeverity,
+                        lockLevel: this.lockLevel,
+                        message: `UNIQUE constraint${cNameDisplay} on table "${tableName}" added without a pre-built index.`,
+                        detail: `Adding a UNIQUE constraint directly takes a SHARE lock and performs a full-table scan, blocking all concurrent writes (INSERT, UPDATE, DELETE) for the entire duration.`,
+                        suggestion: `1. Build the unique index concurrently first (no table lock):\n` +
+                            `   CREATE UNIQUE INDEX CONCURRENTLY ${idxName} ON ${tableName} (${clause.columns});\n` +
+                            `2. Attach it as a constraint without a table scan:\n` +
+                            `   ALTER TABLE ${tableName} ADD CONSTRAINT ${cName} UNIQUE USING INDEX ${idxName};`,
+                        file: context.filePath,
+                        line: stmt.startLine,
+                        column: stmt.startColumn,
+                        codeSnippet: stmt.raw,
+                    });
+                }
+            }
+        }
+        return findings;
+    },
+};
+//# sourceMappingURL=uniqueConstraintUsingIndex.js.map

package/dist/src/rules/uniqueConstraintUsingIndex.js.map

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

package/dist/src/wrapper/orchestrator.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ddlforge - ORM Migration Supervisor (Wrap orchestrator)
+ *
+ * Intercepts pending migration files (Prisma / Drizzle / custom),
+ * runs pre-flight safety analysis, and delegates execution to the
+ * underlying migration command.
+ */
+import { AnalysisResult } from '../engine/analyzer.js';
+export interface DiscoveredMigration {
+    name: string;
+    filePath: string;
+    projectType: 'prisma' | 'drizzle' | 'generic';
+}
+export interface WrapOptions {
+    dir?: string;
+    allowBlockers?: boolean;
+    databaseUrl?: string;
+    command: string[];
+    help?: boolean;
+    cwd?: string;
+}
+export interface WrapResult {
+    success: boolean;
+    exitCode: number;
+    blockersCount: number;
+    warningsCount: number;
+    migrationsCount: number;
+    executedCommand: boolean;
+}
+/**
+ * Parses arguments for the `wrap` subcommand.
+ * argv should be the args after the "wrap" token.
+ * E.g. `['--dir=./drizzle', '--', 'npx', 'drizzle-kit', 'migrate']`
+ */
+export declare function parseWrapArgs(argv: string[]): WrapOptions;
+/**
+ * Scans directories to detect migration files for Prisma, Drizzle, or generic layouts.
+ */
+export declare function detectMigrations(dir?: string, cwd?: string): DiscoveredMigration[];
+/**
+ * Connects to PostgreSQL and queries applied migration tables (_prisma_migrations or __drizzle_migrations).
+ * Returns the filtered set of pending (unapplied) migrations.
+ */
+export declare function filterPendingMigrations(migrations: DiscoveredMigration[], databaseUrl?: string): Promise<DiscoveredMigration[]>;
+/**
+ * Runs ddlforge rules against candidate migration files.
+ */
+export declare function runPreflightCheck(migrations: DiscoveredMigration[]): AnalysisResult[];
+/**
+ * Spawns the user migration command as a child process with inherited stdio.
+ */
+export declare function spawnCommand(command: string[], cwd?: string): Promise<number>;
+/**
+ * Main orchestrator workflow for `ddlforge wrap`.
+ */
+export declare function orchestrateWrap(options: WrapOptions): Promise<WrapResult>;
+export declare function printWrapHelp(): void;
+/**
+ * CLI entry point for the `wrap` subcommand.
+ */
+export declare function runWrap(argv: string[], cwd?: string): Promise<number>;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/src/wrapper/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/wrapper/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,EAAqB,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG1E,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAC/C;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAwEzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,mBAAmB,EAAE,CA6IjG;AAqBD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,mBAAmB,EAAE,EACjC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAsEhC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,mBAAmB,EAAE,GAAG,cAAc,EAAE,CAqBrF;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC5F;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAoE/E;AAED,wBAAgB,aAAa,IAAI,IAAI,CAqBpC;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB1F"}