linkgress-orm 0.0.2 → 0.1.0

package/dist/query/subquery.js

@@ -19,16 +19,22 @@ const conditions_1 = require("./conditions");
  * TMode: 'scalar' | 'array' | 'table' - determines how the subquery can be used
  */
 class Subquery {
-    constructor(sqlBuilder, mode = 'table', selectionMetadata) {
+    constructor(sqlBuilder, mode = 'table', selectionMetadata, outerFieldRefs) {
+        /**
+         * Field refs from outer queries used inside this subquery's WHERE condition.
+         * These need to be propagated to the outer query so it can add necessary JOINs.
+         */
+        this.outerFieldRefs = [];
         this.sqlBuilder = sqlBuilder;
         this.__mode = mode;
         this.selectionMetadata = selectionMetadata;
+        this.outerFieldRefs = outerFieldRefs || [];
     }
     /**
      * Set an alias for this subquery (used when subquery is a table source)
      */
     as(alias) {
-        const clone = new Subquery(this.sqlBuilder, this.__mode, this.selectionMetadata);
+        const clone = new Subquery(this.sqlBuilder, this.__mode, this.selectionMetadata, this.outerFieldRefs);
         clone.alias = alias;
         return clone;
     }
@@ -50,6 +56,13 @@ class Subquery {
     getSelectionMetadata() {
         return this.selectionMetadata;
     }
+    /**
+     * Get field refs from outer queries used inside this subquery.
+     * These need to be propagated to the outer query for JOIN detection.
+     */
+    getOuterFieldRefs() {
+        return this.outerFieldRefs;
+    }
     /**
      * Check if this is a scalar subquery
      */
@@ -84,6 +97,13 @@ class ExistsCondition extends conditions_1.WhereConditionBase {
         super();
         this.subquery = subquery;
     }
+    /**
+     * Get field refs from outer queries used inside this subquery.
+     * These are propagated to enable JOIN detection in the outer query.
+     */
+    getFieldRefs() {
+        return this.subquery.getOuterFieldRefs();
+    }
     buildSql(context) {
         const subquerySql = this.subquery.buildSql(context);
         return `EXISTS (${subquerySql})`;
@@ -98,6 +118,13 @@ class NotExistsCondition extends conditions_1.WhereConditionBase {
         super();
         this.subquery = subquery;
     }
+    /**
+     * Get field refs from outer queries used inside this subquery.
+     * These are propagated to enable JOIN detection in the outer query.
+     */
+    getFieldRefs() {
+        return this.subquery.getOuterFieldRefs();
+    }
     buildSql(context) {
         const subquerySql = this.subquery.buildSql(context);
         return `NOT EXISTS (${subquerySql})`;
@@ -114,6 +141,9 @@ class InSubqueryCondition extends conditions_1.WhereConditionBase {
         this.field = field;
         this.subquery = subquery;
     }
+    getFieldRefs() {
+        return [this.field];
+    }
     buildSql(context) {
         const fieldName = this.getDbColumnName(this.field);
         const subquerySql = this.subquery.buildSql(context);
@@ -130,6 +160,9 @@ class NotInSubqueryCondition extends conditions_1.WhereConditionBase {
         this.field = field;
         this.subquery = subquery;
     }
+    getFieldRefs() {
+        return [this.field];
+    }
     buildSql(context) {
         const fieldName = this.getDbColumnName(this.field);
         const subquerySql = this.subquery.buildSql(context);
@@ -148,6 +181,9 @@ class ScalarSubqueryComparison extends conditions_1.WhereConditionBase {
         this.operator = operator;
         this.subquery = subquery;
     }
+    getFieldRefs() {
+        return [this.field];
+    }
     buildSql(context) {
         const fieldName = this.getDbColumnName(this.field);
         const subquerySql = this.subquery.buildSql(context);

package/dist/query/subquery.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkgress-orm",
-  "version": "0.0.2",
+  "version": "0.1.0",
   "description": "A lightweight, type-safe ORM for PostgreSQL with LINQ-style queries and automatic type inference",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/dist/query/strategies/jsonb-collection-strategy.d.ts

@@ -1,51 +0,0 @@
-import { ICollectionStrategy, CollectionStrategyType, CollectionAggregationConfig, CollectionAggregationResult } from '../collection-strategy.interface';
-import { QueryContext } from '../query-builder';
-/**
- * JSONB-based collection strategy using CTEs
- *
- * This is the current/default strategy that uses PostgreSQL CTEs with jsonb_agg
- * to aggregate related records into JSONB arrays.
- *
- * Benefits:
- * - Single query execution
- * - No temp table management
- * - Works well for moderate data sizes
- *
- * SQL Pattern:
- * ```sql
- * WITH "cte_0" AS (
- *   SELECT
- *     "user_id" as parent_id,
- *     jsonb_agg(
- *       jsonb_build_object('id', "id", 'title', "title")
- *       ORDER BY "views" DESC
- *     ) as data
- *   FROM (
- *     SELECT "user_id", "id", "title", "views"
- *     FROM "posts"
- *     WHERE "views" > $1
- *     ORDER BY "views" DESC
- *   ) sub
- *   GROUP BY "user_id"
- * )
- * SELECT ... COALESCE("cte_0".data, '[]'::jsonb) as "posts" ...
- * ```
- */
-export declare class JsonbCollectionStrategy implements ICollectionStrategy {
-    getType(): CollectionStrategyType;
-    requiresParentIds(): boolean;
-    buildAggregation(config: CollectionAggregationConfig, context: QueryContext): CollectionAggregationResult;
-    /**
-     * Build JSONB aggregation CTE
-     */
-    private buildJsonbAggregation;
-    /**
-     * Build array aggregation CTE (for toNumberList/toStringList)
-     */
-    private buildArrayAggregation;
-    /**
-     * Build scalar aggregation CTE (COUNT, MIN, MAX, SUM)
-     */
-    private buildScalarAggregation;
-}
-//# sourceMappingURL=jsonb-collection-strategy.d.ts.map

package/dist/query/strategies/jsonb-collection-strategy.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonb-collection-strategy.d.ts","sourceRoot":"","sources":["../../../src/query/strategies/jsonb-collection-strategy.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,2BAA2B,EAC3B,2BAA2B,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IACjE,OAAO,IAAI,sBAAsB;IAIjC,iBAAiB,IAAI,OAAO;IAK5B,gBAAgB,CACd,MAAM,EAAE,2BAA2B,EACnC,OAAO,EAAE,YAAY,GACpB,2BAA2B;IA0C9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgE7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAsD7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;CAuC/B"}

package/dist/query/strategies/jsonb-collection-strategy.js

@@ -1,210 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.JsonbCollectionStrategy = void 0;
-/**
- * JSONB-based collection strategy using CTEs
- *
- * This is the current/default strategy that uses PostgreSQL CTEs with jsonb_agg
- * to aggregate related records into JSONB arrays.
- *
- * Benefits:
- * - Single query execution
- * - No temp table management
- * - Works well for moderate data sizes
- *
- * SQL Pattern:
- * ```sql
- * WITH "cte_0" AS (
- *   SELECT
- *     "user_id" as parent_id,
- *     jsonb_agg(
- *       jsonb_build_object('id', "id", 'title', "title")
- *       ORDER BY "views" DESC
- *     ) as data
- *   FROM (
- *     SELECT "user_id", "id", "title", "views"
- *     FROM "posts"
- *     WHERE "views" > $1
- *     ORDER BY "views" DESC
- *   ) sub
- *   GROUP BY "user_id"
- * )
- * SELECT ... COALESCE("cte_0".data, '[]'::jsonb) as "posts" ...
- * ```
- */
-class JsonbCollectionStrategy {
-    getType() {
-        return 'jsonb';
-    }
-    requiresParentIds() {
-        // JSONB strategy doesn't need parent IDs upfront - it aggregates for all parents
-        return false;
-    }
-    buildAggregation(config, context) {
-        const cteName = `cte_${config.counter}`;
-        let cteSQL;
-        let selectExpression;
-        switch (config.aggregationType) {
-            case 'jsonb':
-                cteSQL = this.buildJsonbAggregation(config, cteName, context);
-                selectExpression = `COALESCE("${cteName}".data, ${config.defaultValue})`;
-                break;
-            case 'array':
-                cteSQL = this.buildArrayAggregation(config, cteName, context);
-                selectExpression = `COALESCE("${cteName}".data, ${config.defaultValue})`;
-                break;
-            case 'count':
-            case 'min':
-            case 'max':
-            case 'sum':
-                cteSQL = this.buildScalarAggregation(config, cteName, context);
-                selectExpression = `COALESCE("${cteName}".data, ${config.defaultValue})`;
-                break;
-            default:
-                throw new Error(`Unknown aggregation type: ${config.aggregationType}`);
-        }
-        // Store CTE in context
-        context.ctes.set(cteName, { sql: cteSQL, params: [] });
-        return {
-            sql: cteSQL,
-            params: context.allParams,
-            tableName: cteName,
-            joinClause: `LEFT JOIN "${cteName}" ON "${config.sourceTable}"."id" = "${cteName}".parent_id`,
-            selectExpression,
-            isCTE: true,
-        };
-    }
-    /**
-     * Build JSONB aggregation CTE
-     */
-    buildJsonbAggregation(config, cteName, context) {
-        const { selectedFields, targetTable, foreignKey, whereClause, orderByClause, limitValue, offsetValue, isDistinct } = config;
-        // Build the subquery SELECT fields
-        const allSelectFields = [
-            `"${foreignKey}" as "__fk_${foreignKey}"`,
-            ...selectedFields.map(f => {
-                // Always add alias if expression doesn't already match the quoted alias
-                if (f.expression !== `"${f.alias}"`) {
-                    return `${f.expression} as "${f.alias}"`;
-                }
-                return f.expression;
-            }),
-        ];
-        // Build the JSONB fields for jsonb_build_object using the aliases from the subquery
-        const jsonbFields = selectedFields
-            .map(f => `'${f.alias}', "${f.alias}"`)
-            .join(', ');
-        // Build WHERE clause
-        const whereSQL = whereClause ? `WHERE ${whereClause}` : '';
-        // Build ORDER BY clause
-        const orderBySQL = orderByClause ? `ORDER BY ${orderByClause}` : '';
-        // Build LIMIT/OFFSET
-        let limitOffsetClause = '';
-        if (limitValue !== undefined) {
-            limitOffsetClause = `LIMIT ${limitValue}`;
-        }
-        if (offsetValue !== undefined) {
-            limitOffsetClause += ` OFFSET ${offsetValue}`;
-        }
-        // Build DISTINCT clause
-        const distinctClause = isDistinct ? 'DISTINCT ' : '';
-        // Build the jsonb_agg ORDER BY clause
-        const jsonbAggOrderBy = orderByClause ? ` ORDER BY ${orderByClause}` : '';
-        const cteSQL = `
-SELECT
-  "__fk_${foreignKey}" as parent_id,
-  jsonb_agg(
-    jsonb_build_object(${jsonbFields})${jsonbAggOrderBy}
-  ) as data
-FROM (
-  SELECT ${distinctClause}${allSelectFields.join(', ')}
-  FROM "${targetTable}"
-  ${whereSQL}
-  ${orderBySQL}
-  ${limitOffsetClause}
-) sub
-GROUP BY "__fk_${foreignKey}"
-    `.trim();
-        return cteSQL;
-    }
-    /**
-     * Build array aggregation CTE (for toNumberList/toStringList)
-     */
-    buildArrayAggregation(config, cteName, context) {
-        const { arrayField, targetTable, foreignKey, whereClause, orderByClause, limitValue, offsetValue, isDistinct } = config;
-        if (!arrayField) {
-            throw new Error('arrayField is required for array aggregation');
-        }
-        // Build WHERE clause
-        const whereSQL = whereClause ? `WHERE ${whereClause}` : '';
-        // Build ORDER BY clause
-        const orderBySQL = orderByClause ? `ORDER BY ${orderByClause}` : '';
-        // Build LIMIT/OFFSET
-        let limitOffsetClause = '';
-        if (limitValue !== undefined) {
-            limitOffsetClause = `LIMIT ${limitValue}`;
-        }
-        if (offsetValue !== undefined) {
-            limitOffsetClause += ` OFFSET ${offsetValue}`;
-        }
-        // Build DISTINCT clause
-        const distinctClause = isDistinct ? 'DISTINCT ' : '';
-        // Build the array_agg ORDER BY clause
-        const arrayAggOrderBy = orderByClause ? ` ORDER BY ${orderByClause}` : '';
-        const cteSQL = `
-SELECT
-  "__fk_${foreignKey}" as parent_id,
-  array_agg(
-    "${arrayField}"${arrayAggOrderBy}
-  ) as data
-FROM (
-  SELECT ${distinctClause}"__fk_${foreignKey}", "${arrayField}"
-  FROM (
-    SELECT "${foreignKey}" as "__fk_${foreignKey}", "${arrayField}"
-    FROM "${targetTable}"
-    ${whereSQL}
-    ${orderBySQL}
-    ${limitOffsetClause}
-  ) inner_sub
-) sub
-GROUP BY "__fk_${foreignKey}"
-    `.trim();
-        return cteSQL;
-    }
-    /**
-     * Build scalar aggregation CTE (COUNT, MIN, MAX, SUM)
-     */
-    buildScalarAggregation(config, cteName, context) {
-        const { aggregationType, aggregateField, targetTable, foreignKey, whereClause } = config;
-        // Build WHERE clause
-        const whereSQL = whereClause ? `WHERE ${whereClause}` : '';
-        // Build aggregation expression
-        let aggregateExpression;
-        switch (aggregationType) {
-            case 'count':
-                aggregateExpression = 'COUNT(*)';
-                break;
-            case 'min':
-            case 'max':
-            case 'sum':
-                if (!aggregateField) {
-                    throw new Error(`${aggregationType.toUpperCase()} requires an aggregate field`);
-                }
-                aggregateExpression = `${aggregationType.toUpperCase()}("${aggregateField}")`;
-                break;
-            default:
-                throw new Error(`Unknown aggregation type: ${aggregationType}`);
-        }
-        const cteSQL = `
-SELECT
-  "${foreignKey}" as parent_id,
-  ${aggregateExpression} as data
-FROM "${targetTable}"
-${whereSQL}
-GROUP BY "${foreignKey}"
-    `.trim();
-        return cteSQL;
-    }
-}
-exports.JsonbCollectionStrategy = JsonbCollectionStrategy;
-//# sourceMappingURL=jsonb-collection-strategy.js.map

package/dist/query/strategies/jsonb-collection-strategy.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"jsonb-collection-strategy.js","sourceRoot":"","sources":["../../../src/query/strategies/jsonb-collection-strategy.ts"],"names":[],"mappings":";;;AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAa,uBAAuB;IAClC,OAAO;QACL,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,iBAAiB;QACf,iFAAiF;QACjF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,gBAAgB,CACd,MAAmC,EACnC,OAAqB;QAErB,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;QAExC,IAAI,MAAc,CAAC;QACnB,IAAI,gBAAwB,CAAC;QAE7B,QAAQ,MAAM,CAAC,eAAe,EAAE,CAAC;YAC/B,KAAK,OAAO;gBACV,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9D,gBAAgB,GAAG,aAAa,OAAO,WAAW,MAAM,CAAC,YAAY,GAAG,CAAC;gBACzE,MAAM;YAER,KAAK,OAAO;gBACV,MAAM,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC9D,gBAAgB,GAAG,aAAa,OAAO,WAAW,MAAM,CAAC,YAAY,GAAG,CAAC;gBACzE,MAAM;YAER,KAAK,OAAO,CAAC;YACb,KAAK,KAAK,CAAC;YACX,KAAK,KAAK,CAAC;YACX,KAAK,KAAK;gBACR,MAAM,GAAG,IAAI,CAAC,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC/D,gBAAgB,GAAG,aAAa,OAAO,WAAW,MAAM,CAAC,YAAY,GAAG,CAAC;gBACzE,MAAM;YAER;gBACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,uBAAuB;QACvB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAEvD,OAAO;YACL,GAAG,EAAE,MAAM;YACX,MAAM,EAAE,OAAO,CAAC,SAAS;YACzB,SAAS,EAAE,OAAO;YAClB,UAAU,EAAE,cAAc,OAAO,SAAS,MAAM,CAAC,WAAW,aAAa,OAAO,aAAa;YAC7F,gBAAgB;YAChB,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,qBAAqB,CAC3B,MAAmC,EACnC,OAAe,EACf,OAAqB;QAErB,MAAM,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAE5H,mCAAmC;QACnC,MAAM,eAAe,GAAG;YACtB,IAAI,UAAU,cAAc,UAAU,GAAG;YACzC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;gBACxB,wEAAwE;gBACxE,IAAI,CAAC,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;oBACpC,OAAO,GAAG,CAAC,CAAC,UAAU,QAAQ,CAAC,CAAC,KAAK,GAAG,CAAC;gBAC3C,CAAC;gBACD,OAAO,CAAC,CAAC,UAAU,CAAC;YACtB,CAAC,CAAC;SACH,CAAC;QAEF,oFAAoF;QACpF,MAAM,WAAW,GAAG,cAAc;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC;aACtC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,qBAAqB;QACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3D,wBAAwB;QACxB,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,YAAY,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpE,qBAAqB;QACrB,IAAI,iBAAiB,GAAG,EAAE,CAAC;QAC3B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,iBAAiB,GAAG,SAAS,UAAU,EAAE,CAAC;QAC5C,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,iBAAiB,IAAI,WAAW,WAAW,EAAE,CAAC;QAChD,CAAC;QAED,wBAAwB;QACxB,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAErD,sCAAsC;QACtC,MAAM,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1E,MAAM,MAAM,GAAG;;UAET,UAAU;;yBAEK,WAAW,IAAI,eAAe;;;WAG5C,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;UAC5C,WAAW;IACjB,QAAQ;IACR,UAAU;IACV,iBAAiB;;iBAEJ,UAAU;KACtB,CAAC,IAAI,EAAE,CAAC;QAET,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,qBAAqB,CAC3B,MAAmC,EACnC,OAAe,EACf,OAAqB;QAErB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,CAAC;QAExH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,qBAAqB;QACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3D,wBAAwB;QACxB,MAAM,UAAU,GAAG,aAAa,CAAC,CAAC,CAAC,YAAY,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpE,qBAAqB;QACrB,IAAI,iBAAiB,GAAG,EAAE,CAAC;QAC3B,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,iBAAiB,GAAG,SAAS,UAAU,EAAE,CAAC;QAC5C,CAAC;QACD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,iBAAiB,IAAI,WAAW,WAAW,EAAE,CAAC;QAChD,CAAC;QAED,wBAAwB;QACxB,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;QAErD,sCAAsC;QACtC,MAAM,eAAe,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1E,MAAM,MAAM,GAAG;;UAET,UAAU;;OAEb,UAAU,IAAI,eAAe;;;WAGzB,cAAc,SAAS,UAAU,OAAO,UAAU;;cAE/C,UAAU,cAAc,UAAU,OAAO,UAAU;YACrD,WAAW;MACjB,QAAQ;MACR,UAAU;MACV,iBAAiB;;;iBAGN,UAAU;KACtB,CAAC,IAAI,EAAE,CAAC;QAET,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,sBAAsB,CAC5B,MAAmC,EACnC,OAAe,EACf,OAAqB;QAErB,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAEzF,qBAAqB;QACrB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE3D,+BAA+B;QAC/B,IAAI,mBAA2B,CAAC;QAChC,QAAQ,eAAe,EAAE,CAAC;YACxB,KAAK,OAAO;gBACV,mBAAmB,GAAG,UAAU,CAAC;gBACjC,MAAM;YACR,KAAK,KAAK,CAAC;YACX,KAAK,KAAK,CAAC;YACX,KAAK,KAAK;gBACR,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,MAAM,IAAI,KAAK,CAAC,GAAG,eAAe,CAAC,WAAW,EAAE,8BAA8B,CAAC,CAAC;gBAClF,CAAC;gBACD,mBAAmB,GAAG,GAAG,eAAe,CAAC,WAAW,EAAE,KAAK,cAAc,IAAI,CAAC;gBAC9E,MAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,6BAA6B,eAAe,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,MAAM,GAAG;;KAEd,UAAU;IACX,mBAAmB;QACf,WAAW;EACjB,QAAQ;YACE,UAAU;KACjB,CAAC,IAAI,EAAE,CAAC;QAET,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AA7ND,0DA6NC"}