@proseql/core 0.1.0

package/dist/operations/query/filter.js

@@ -0,0 +1,267 @@
+import { matchesFilter } from "../../types/operators.js";
+import { tokenize } from "./search.js";
+// Type guard to check if where clause is a valid object
+export function isValidWhereClause(where) {
+    return where !== null && typeof where === "object" && !Array.isArray(where);
+}
+// Helper function to filter data based on where clause
+export function filterData(data, where, allData, relationships, collectionName, config) {
+    if (!where || !isValidWhereClause(where))
+        return data;
+    return data.filter((item) => {
+        let shouldInclude = true;
+        for (const [key, value] of Object.entries(where)) {
+            // Handle conditional logic operators
+            if (key === "$or") {
+                if (!Array.isArray(value)) {
+                    shouldInclude = false;
+                    break;
+                }
+                // OR: at least one condition must be true
+                // Empty array means no conditions to match, so it's false
+                if (value.length === 0) {
+                    shouldInclude = false;
+                    break;
+                }
+                const orResults = value.map((condition) => {
+                    if (!isValidWhereClause(condition))
+                        return false;
+                    const filtered = filterData([item], condition, allData, relationships, collectionName, config);
+                    return filtered.length > 0;
+                });
+                if (!orResults.some((result) => result === true)) {
+                    shouldInclude = false;
+                    break;
+                }
+            }
+            else if (key === "$and") {
+                if (!Array.isArray(value)) {
+                    shouldInclude = false;
+                    break;
+                }
+                // AND: all conditions must be true
+                // Empty array means all conditions are true (vacuous truth)
+                if (value.length === 0) {
+                    continue;
+                }
+                const andResults = value.map((condition) => {
+                    if (!isValidWhereClause(condition))
+                        return false;
+                    const filtered = filterData([item], condition, allData, relationships, collectionName, config);
+                    return filtered.length > 0;
+                });
+                if (!andResults.every((result) => result === true)) {
+                    shouldInclude = false;
+                    break;
+                }
+            }
+            else if (key === "$not") {
+                if (!isValidWhereClause(value)) {
+                    shouldInclude = false;
+                    break;
+                }
+                // NOT: condition must be false
+                const filtered = filterData([item], value, allData, relationships, collectionName, config);
+                if (filtered.length > 0) {
+                    shouldInclude = false;
+                    break;
+                }
+            }
+            else if (key === "$search") {
+                // Top-level multi-field search: check if entity matches across specified fields
+                // If $search is present, extract the query and fields from SearchConfig
+                if (value === null || typeof value !== "object") {
+                    // Invalid search config
+                    shouldInclude = false;
+                    break;
+                }
+                const searchConfig = value;
+                const query = searchConfig.query;
+                // Empty query matches everything
+                if (!query || query.trim() === "") {
+                    continue;
+                }
+                const queryTokens = tokenize(query);
+                if (queryTokens.length === 0) {
+                    // After tokenization, no tokens means match all
+                    continue;
+                }
+                // Determine target fields: explicit or all string fields on the entity
+                let targetFields;
+                if (searchConfig.fields && searchConfig.fields.length > 0) {
+                    targetFields = searchConfig.fields;
+                }
+                else {
+                    // Find all string fields on the entity
+                    targetFields = Object.keys(item).filter((k) => typeof item[k] === "string");
+                }
+                // Check if all query tokens are found across the target fields
+                // Each query token must match in at least one field (exact or prefix)
+                const allTokensMatch = queryTokens.every((qt) => {
+                    // Check if this query token matches in any of the target fields
+                    return targetFields.some((field) => {
+                        const fieldValue = item[field];
+                        if (typeof fieldValue !== "string") {
+                            return false;
+                        }
+                        const fieldTokens = tokenize(fieldValue);
+                        // Check if any field token matches (exact or prefix)
+                        return fieldTokens.some((ft) => ft === qt || ft.startsWith(qt));
+                    });
+                });
+                if (!allTokensMatch) {
+                    shouldInclude = false;
+                    break;
+                }
+            }
+            else if (relationships?.[key] && allData && collectionName && config) {
+                // Handle relationship filtering
+                const relationship = relationships[key];
+                const targetData = allData[relationship.target];
+                if (relationship.type === "ref") {
+                    // For ref relationships, find the related item
+                    const foreignKeyField = relationship.foreignKey || `${key}Id`;
+                    const relatedItem = targetData?.find((target) => {
+                        if (!isValidWhereClause(target))
+                            return false;
+                        return target.id === item[foreignKeyField];
+                    });
+                    if (!relatedItem) {
+                        // If no related item and we have a filter, it doesn't match
+                        if (value &&
+                            typeof value === "object" &&
+                            Object.keys(value).length > 0) {
+                            shouldInclude = false;
+                            break;
+                        }
+                        continue;
+                    }
+                    // Recursively filter the related item
+                    const targetConfig = config[relationship.target];
+                    if (targetConfig && isValidWhereClause(relatedItem)) {
+                        const filtered = filterData([relatedItem], value, allData, targetConfig.relationships, relationship.target, config);
+                        if (filtered.length === 0) {
+                            shouldInclude = false;
+                            break;
+                        }
+                    }
+                }
+                else if (relationship.type === "inverse") {
+                    // For inverse relationships, find all related items
+                    // Find multiple related items where they reference this item
+                    // The foreign key is based on the collection name (e.g., 'userId' for 'users' collection)
+                    const foreignKeyField = relationship.foreignKey ||
+                        (collectionName ? `${collectionName.replace(/s$/, "")}Id` : "id");
+                    const relatedItems = targetData?.filter((target) => {
+                        if (!isValidWhereClause(target))
+                            return false;
+                        return target[foreignKeyField] === item.id;
+                    }) || [];
+                    // Handle array operators
+                    if (value && typeof value === "object") {
+                        const operators = value;
+                        const targetConfig = config[relationship.target];
+                        if ("$some" in operators && targetConfig) {
+                            // At least one related item must match
+                            const someMatch = relatedItems.some((relItem) => {
+                                if (!isValidWhereClause(relItem))
+                                    return false;
+                                const filtered = filterData([relItem], operators.$some, allData, targetConfig.relationships, relationship.target, config);
+                                return filtered.length > 0;
+                            });
+                            if (!someMatch) {
+                                shouldInclude = false;
+                                break;
+                            }
+                        }
+                        if ("$every" in operators && targetConfig) {
+                            // All related items must match (or no related items)
+                            if (relatedItems.length === 0)
+                                continue;
+                            const everyMatch = relatedItems.every((relItem) => {
+                                if (!isValidWhereClause(relItem))
+                                    return false;
+                                const filtered = filterData([relItem], operators.$every, allData, targetConfig.relationships, relationship.target, config);
+                                return filtered.length > 0;
+                            });
+                            if (!everyMatch) {
+                                shouldInclude = false;
+                                break;
+                            }
+                        }
+                        if ("$none" in operators && targetConfig) {
+                            // No related items should match
+                            const noneMatch = relatedItems.some((relItem) => {
+                                if (!isValidWhereClause(relItem))
+                                    return false;
+                                const filtered = filterData([relItem], operators.$none, allData, targetConfig.relationships, relationship.target, config);
+                                return filtered.length > 0;
+                            });
+                            if (noneMatch) {
+                                shouldInclude = false;
+                                break;
+                            }
+                        }
+                    }
+                }
+            }
+            else if (key in item) {
+                // Handle regular field filtering
+                if (!matchesFilter(item[key], value)) {
+                    shouldInclude = false;
+                    break;
+                }
+            }
+            else {
+                // If the field doesn't exist in the item
+                if (isValidWhereClause(value)) {
+                    const ops = value;
+                    if ("$eq" in ops && ops.$eq === undefined) {
+                        // Looking for items where field equals undefined (doesn't exist)
+                        continue;
+                    }
+                    else if ("$ne" in ops && ops.$ne === undefined) {
+                        // Looking for items where field doesn't equal undefined (doesn't exist)
+                        shouldInclude = false;
+                        break;
+                    }
+                    // For operator-based filters on non-existent fields, it doesn't match
+                    const operatorKeys = [
+                        "$eq",
+                        "$ne",
+                        "$in",
+                        "$nin",
+                        "$gt",
+                        "$gte",
+                        "$lt",
+                        "$lte",
+                        "$startsWith",
+                        "$endsWith",
+                        "$contains",
+                        "$all",
+                        "$size",
+                        "$search",
+                    ];
+                    const logicalOperatorKeys = ["$or", "$and", "$not"];
+                    const hasOperators = Object.keys(ops).some((key) => operatorKeys.includes(key));
+                    const hasLogicalOperators = Object.keys(ops).some((key) => logicalOperatorKeys.includes(key));
+                    if (hasOperators || hasLogicalOperators) {
+                        shouldInclude = false;
+                        break;
+                    }
+                }
+                // For direct equality on a non-existent field:
+                // If looking for undefined, it matches (field doesn't exist = undefined)
+                // Otherwise, it doesn't match
+                if (value !== undefined) {
+                    shouldInclude = false;
+                    break;
+                }
+            }
+            if (!shouldInclude)
+                break;
+        }
+        return shouldInclude;
+    });
+}
+//# sourceMappingURL=filter.js.map

package/dist/operations/query/filter.js.map

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

package/dist/operations/query/paginate-stream.d.ts

@@ -0,0 +1,11 @@
+import { Stream } from "effect";
+/**
+ * Apply pagination as a Stream combinator using Stream.drop for offset and Stream.take for limit.
+ * Returns a function that transforms Stream<T> → Stream<T>, skipping `offset` items
+ * and emitting at most `limit` items.
+ *
+ * Normalizes inputs: negative values are clamped to 0, fractional values are floored.
+ * A limit of 0 returns an empty stream. Undefined limit means no limit (all remaining items).
+ */
+export declare const applyPagination: (offset: number | undefined, limit: number | undefined) => <T, E, R>(stream: Stream.Stream<T, E, R>) => Stream.Stream<T, E, R>;
+//# sourceMappingURL=paginate-stream.d.ts.map

package/dist/operations/query/paginate-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate-stream.d.ts","sourceRoot":"","sources":["../../../src/operations/query/paginate-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,GAAG,SAAS,EAAE,OAAO,MAAM,GAAG,SAAS,MACrD,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAiB/D,CAAC"}

package/dist/operations/query/paginate-stream.js

@@ -0,0 +1,22 @@
+import { Stream } from "effect";
+/**
+ * Apply pagination as a Stream combinator using Stream.drop for offset and Stream.take for limit.
+ * Returns a function that transforms Stream<T> → Stream<T>, skipping `offset` items
+ * and emitting at most `limit` items.
+ *
+ * Normalizes inputs: negative values are clamped to 0, fractional values are floored.
+ * A limit of 0 returns an empty stream. Undefined limit means no limit (all remaining items).
+ */
+export const applyPagination = (offset, limit) => (stream) => {
+    const normalizedOffset = offset !== undefined ? Math.max(0, Math.floor(offset)) : 0;
+    const normalizedLimit = limit !== undefined ? Math.max(0, Math.floor(limit)) : undefined;
+    let result = stream;
+    if (normalizedOffset > 0) {
+        result = Stream.drop(result, normalizedOffset);
+    }
+    if (normalizedLimit !== undefined) {
+        result = Stream.take(result, normalizedLimit);
+    }
+    return result;
+};
+//# sourceMappingURL=paginate-stream.js.map

package/dist/operations/query/paginate-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginate-stream.js","sourceRoot":"","sources":["../../../src/operations/query/paginate-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,eAAe,GAC3B,CAAC,MAA0B,EAAE,KAAyB,EAAE,EAAE,CAC1D,CAAU,MAA8B,EAA0B,EAAE;IACnE,MAAM,gBAAgB,GACrB,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,eAAe,GACpB,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElE,IAAI,MAAM,GAAG,MAAM,CAAC;IAEpB,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QACnC,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,MAAM,CAAC;AACf,CAAC,CAAC"}

package/dist/operations/query/query-helpers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Helper functions for working with query results
+ */
+/**
+ * Collect all results from an AsyncIterable into an array
+ */
+export declare function toArray<T>(iterable: AsyncIterable<T>): Promise<T[]>;
+/**
+ * Add toArray method to an AsyncIterable
+ */
+export declare function withToArray<T>(iterable: AsyncIterable<T>): AsyncIterable<T> & {
+    toArray: () => Promise<T[]>;
+};
+//# sourceMappingURL=query-helpers.d.ts.map

package/dist/operations/query/query-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-helpers.d.ts","sourceRoot":"","sources":["../../../src/operations/query/query-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAsB,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAMzE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACxB,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;CAAE,CAIpD"}

package/dist/operations/query/query-helpers.js

@@ -0,0 +1,22 @@
+/**
+ * Helper functions for working with query results
+ */
+/**
+ * Collect all results from an AsyncIterable into an array
+ */
+export async function toArray(iterable) {
+    const results = [];
+    for await (const item of iterable) {
+        results.push(item);
+    }
+    return results;
+}
+/**
+ * Add toArray method to an AsyncIterable
+ */
+export function withToArray(iterable) {
+    return Object.assign(iterable, {
+        toArray: () => toArray(iterable),
+    });
+}
+//# sourceMappingURL=query-helpers.js.map

package/dist/operations/query/query-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-helpers.js","sourceRoot":"","sources":["../../../src/operations/query/query-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAI,QAA0B;IAC1D,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAC1B,QAA0B;IAE1B,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;QAC9B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;KAChC,CAAC,CAAC;AACJ,CAAC"}

package/dist/operations/query/resolve-computed.d.ts

@@ -0,0 +1,142 @@
+import { Stream } from "effect";
+import type { ComputedFieldsConfig, WithComputed } from "../../types/computed-types.js";
+/**
+ * Resolve computed fields for a single entity.
+ *
+ * Iterates over the computed config, calling each derivation function with the entity,
+ * and returns a new object with the original entity fields plus computed field values.
+ *
+ * @template T - The entity type (stored fields, possibly with populated relationships)
+ * @template C - The computed fields config type
+ *
+ * @param entity - The entity to resolve computed fields for
+ * @param config - The computed fields configuration (field name → derivation function)
+ * @returns A new object with entity fields plus computed fields attached
+ *
+ * @example
+ * ```ts
+ * const book = { id: "1", title: "Dune", year: 1965 }
+ * const config = {
+ *   displayName: (b) => `${b.title} (${b.year})`,
+ *   isClassic: (b) => b.year < 1980,
+ * }
+ * const result = resolveComputedFields(book, config)
+ * // { id: "1", title: "Dune", year: 1965, displayName: "Dune (1965)", isClassic: true }
+ * ```
+ */
+export declare const resolveComputedFields: <T extends Record<string, unknown>, C extends ComputedFieldsConfig<T>>(entity: T, config: C) => WithComputed<T, C>;
+/**
+ * Apply computed field resolution as a Stream combinator.
+ * Returns a function that transforms Stream<T> → Stream<WithComputed<T, C>>,
+ * mapping the resolution function over each entity.
+ *
+ * When the config is undefined or has no keys, returns the stream unchanged
+ * (no resolution overhead).
+ *
+ * @template T - The entity type (stored fields, possibly with populated relationships)
+ * @template C - The computed fields config type
+ *
+ * @param config - The computed fields configuration (field name → derivation function), or undefined
+ * @returns A stream combinator function
+ *
+ * @example
+ * ```ts
+ * const config = {
+ *   displayName: (b) => `${b.title} (${b.year})`,
+ *   isClassic: (b) => b.year < 1980,
+ * }
+ * const enrichedStream = stream.pipe(resolveComputedStream(config))
+ * // Each entity in the resulting stream has displayName and isClassic attached
+ * ```
+ */
+export declare const resolveComputedStream: <T extends Record<string, unknown>, C extends ComputedFieldsConfig<T>>(config: C | undefined) => <E, R>(stream: Stream.Stream<T, E, R>) => Stream.Stream<WithComputed<T, C>, E, R>;
+/**
+ * Strip computed field keys from an entity object.
+ * Used as a safety net before persistence to ensure computed fields
+ * are never written to storage.
+ *
+ * @template T - The original entity type (stored fields only)
+ * @template C - The computed fields config type
+ *
+ * @param entity - The entity (possibly with computed fields attached)
+ * @param config - The computed fields configuration that defines which keys to strip
+ * @returns A new object with only stored fields (computed fields removed)
+ *
+ * @example
+ * ```ts
+ * const entityWithComputed = {
+ *   id: "1",
+ *   title: "Dune",
+ *   year: 1965,
+ *   displayName: "Dune (1965)",  // computed
+ *   isClassic: true,              // computed
+ * }
+ * const config = {
+ *   displayName: (b) => `${b.title} (${b.year})`,
+ *   isClassic: (b) => b.year < 1980,
+ * }
+ * const stored = stripComputedFields(entityWithComputed, config)
+ * // { id: "1", title: "Dune", year: 1965 }
+ * ```
+ */
+export declare const stripComputedFields: <T extends Record<string, unknown>, C extends ComputedFieldsConfig<T>>(entity: Record<string, unknown>, config: C | undefined) => T;
+/**
+ * Check if any computed fields are selected based on the select configuration.
+ *
+ * @param computedConfig - The computed fields configuration
+ * @param select - The select configuration (object with true values for selected fields)
+ * @returns true if any computed field is selected (or select is undefined meaning all fields)
+ *
+ * @example
+ * ```ts
+ * const computedConfig = {
+ *   displayName: (b) => `${b.title} (${b.year})`,
+ *   isClassic: (b) => b.year < 1980,
+ * }
+ *
+ * // No select = all fields including computed
+ * hasSelectedComputedFields(computedConfig, undefined) // true
+ *
+ * // Select includes computed field
+ * hasSelectedComputedFields(computedConfig, { title: true, displayName: true }) // true
+ *
+ * // Select excludes all computed fields
+ * hasSelectedComputedFields(computedConfig, { title: true, year: true }) // false
+ * ```
+ */
+export declare const hasSelectedComputedFields: (computedConfig: ComputedFieldsConfig<Record<string, unknown>> | undefined, select: Record<string, unknown> | undefined) => boolean;
+/**
+ * Apply computed field resolution with lazy skip optimization.
+ *
+ * When `select` is provided and has no intersection with computed field keys,
+ * bypasses resolution entirely by returning the stream unchanged. This avoids
+ * unnecessary computation when only stored fields are needed.
+ *
+ * @template T - The entity type (stored fields, possibly with populated relationships)
+ * @template C - The computed fields config type
+ *
+ * @param config - The computed fields configuration (field name → derivation function), or undefined
+ * @param select - The select configuration (object with true values for selected fields), or undefined
+ * @returns A stream combinator function
+ *
+ * @example
+ * ```ts
+ * const config = {
+ *   displayName: (b) => `${b.title} (${b.year})`,
+ *   isClassic: (b) => b.year < 1980,
+ * }
+ *
+ * // When select includes computed fields, resolution is applied
+ * const enrichedStream = stream.pipe(
+ *   resolveComputedStreamWithLazySkip(config, { title: true, displayName: true })
+ * )
+ *
+ * // When select excludes all computed fields, resolution is skipped
+ * const storedOnlyStream = stream.pipe(
+ *   resolveComputedStreamWithLazySkip(config, { title: true, year: true })
+ * )
+ * // → stream returned unchanged, no resolution overhead
+ * ```
+ */
+export declare const resolveComputedStreamWithLazySkip: <T extends Record<string, unknown>, C extends ComputedFieldsConfig<T>>(config: C | undefined, select: Record<string, unknown> | undefined) => <E, R>(stream: Stream.Stream<T, E, R>) => Stream.Stream<WithComputed<T, C>, E, R>;
+//# sourceMappingURL=resolve-computed.d.ts.map

package/dist/operations/query/resolve-computed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-computed.d.ts","sourceRoot":"","sources":["../../../src/operations/query/resolve-computed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EACX,oBAAoB,EACpB,YAAY,EACZ,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,qBAAqB,GACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAEjC,QAAQ,CAAC,EACT,QAAQ,CAAC,KACP,YAAY,CAAC,CAAC,EAAE,CAAC,CAWnB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,qBAAqB,GAChC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,EACpE,QAAQ,CAAC,GAAG,SAAS,MAErB,CAAC,EAAE,CAAC,EACJ,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC5B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CASxC,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,mBAAmB,GAC/B,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,EAEjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,CAAC,GAAG,SAAS,KACnB,CAgBF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,yBAAyB,GACrC,gBAAgB,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACzE,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KACzC,OAyBF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,iCAAiC,GAC5C,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,oBAAoB,CAAC,CAAC,CAAC,EACpE,QAAQ,CAAC,GAAG,SAAS,EACrB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,MAE3C,CAAC,EAAE,CAAC,EACJ,QAAQ,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAC5B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAmBxC,CAAC"}