@signalium/query 0.0.0 → 0.0.2

package/dist/cjs/QueryStore.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * QueryStore - Minimal interface for query persistence
+ *
+ * Provides a clean abstraction over document storage, reference counting,
+ * and LRU cache management. Supports both synchronous (in-memory) and
+ * asynchronous (writer-backed) implementations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SyncQueryStore = exports.queueKeyFor = exports.updatedAtKeyFor = exports.refIdsKeyFor = exports.refCountKeyFor = exports.valueKeyFor = exports.MemoryPersistentStore = void 0;
+const DEFAULT_MAX_COUNT = 50;
+const DEFAULT_GC_TIME = 1000 * 60 * 60 * 24; // 24 hours
+class MemoryPersistentStore {
+    kv = Object.create(null);
+    has(key) {
+        return key in this.kv;
+    }
+    getString(key) {
+        return this.kv[key];
+    }
+    setString(key, value) {
+        this.kv[key] = value;
+    }
+    getNumber(key) {
+        return this.kv[key];
+    }
+    setNumber(key, value) {
+        this.kv[key] = value;
+    }
+    getBuffer(key) {
+        return this.kv[key];
+    }
+    setBuffer(key, value) {
+        this.kv[key] = value;
+    }
+    delete(key) {
+        delete this.kv[key];
+    }
+}
+exports.MemoryPersistentStore = MemoryPersistentStore;
+// Query Instance keys
+const valueKeyFor = (id) => `sq:doc:value:${id}`;
+exports.valueKeyFor = valueKeyFor;
+const refCountKeyFor = (id) => `sq:doc:refCount:${id}`;
+exports.refCountKeyFor = refCountKeyFor;
+const refIdsKeyFor = (id) => `sq:doc:refIds:${id}`;
+exports.refIdsKeyFor = refIdsKeyFor;
+const updatedAtKeyFor = (id) => `sq:doc:updatedAt:${id}`;
+exports.updatedAtKeyFor = updatedAtKeyFor;
+// Query Type keys
+const queueKeyFor = (queryDefId) => `sq:doc:queue:${queryDefId}`;
+exports.queueKeyFor = queueKeyFor;
+class SyncQueryStore {
+    kv;
+    queues = new Map();
+    constructor(kv) {
+        this.kv = kv;
+    }
+    loadQuery(queryDef, queryKey, entityMap) {
+        const updatedAt = this.kv.getNumber((0, exports.updatedAtKeyFor)(queryKey));
+        if (updatedAt === undefined || updatedAt < Date.now() - (queryDef.cache?.gcTime ?? DEFAULT_GC_TIME)) {
+            return;
+        }
+        const valueStr = this.kv.getString((0, exports.valueKeyFor)(queryKey));
+        if (valueStr === undefined) {
+            return;
+        }
+        const entityIds = this.kv.getBuffer((0, exports.refIdsKeyFor)(queryKey));
+        if (entityIds !== undefined) {
+            this.preloadEntities(entityIds, entityMap);
+        }
+        this.activateQuery(queryDef, queryKey);
+        return {
+            value: JSON.parse(valueStr),
+            updatedAt,
+        };
+    }
+    preloadEntities(entityIds, entityMap) {
+        for (const entityId of entityIds) {
+            const entityValue = this.kv.getString((0, exports.valueKeyFor)(entityId));
+            if (entityValue === undefined) {
+                continue;
+            }
+            const entity = JSON.parse(entityValue);
+            entityMap.setPreloadedEntity(entityId, entity);
+            const childIds = this.kv.getBuffer((0, exports.refIdsKeyFor)(entityId));
+            if (childIds === undefined) {
+                continue;
+            }
+            this.preloadEntities(childIds, entityMap);
+        }
+    }
+    saveQuery(queryDef, queryKey, value, refIds) {
+        this.setValue(queryKey, value, refIds);
+        this.kv.setNumber((0, exports.updatedAtKeyFor)(queryKey), Date.now());
+        this.activateQuery(queryDef, queryKey);
+    }
+    saveEntity(entityKey, value, refIds) {
+        this.setValue(entityKey, value, refIds);
+    }
+    activateQuery(queryDef, queryKey) {
+        if (!this.kv.has((0, exports.valueKeyFor)(queryKey))) {
+            // Query not in store, nothing to do. This can happen if the query has
+            // been evicted from the cache, but is still active in memory.
+            return;
+        }
+        let queue = this.queues.get(queryDef.id);
+        if (queue === undefined) {
+            const maxCount = queryDef.cache?.maxCount ?? DEFAULT_MAX_COUNT;
+            queue = this.kv.getBuffer((0, exports.queueKeyFor)(queryDef.id));
+            if (queue === undefined) {
+                queue = new Uint32Array(maxCount);
+                this.kv.setBuffer((0, exports.queueKeyFor)(queryDef.id), queue);
+            }
+            else if (queue.length !== maxCount) {
+                const newQueue = new Uint32Array(maxCount);
+                newQueue.set(queue);
+                queue = newQueue;
+                this.kv.setBuffer((0, exports.queueKeyFor)(queryDef.id), queue);
+            }
+            this.queues.set(queryDef.id, queue);
+        }
+        const indexOfKey = queue.indexOf(queryKey);
+        // Item already in queue, move to front
+        if (indexOfKey >= 0) {
+            if (indexOfKey === 0) {
+                // Already at front, nothing to do
+                return;
+            }
+            // Shift items right to make space at front
+            queue.copyWithin(1, 0, indexOfKey);
+            queue[0] = queryKey;
+            return;
+        }
+        // Item not in queue, add to front and evict tail
+        const evicted = queue[queue.length - 1];
+        queue.copyWithin(1, 0, queue.length - 1);
+        queue[0] = queryKey;
+        if (evicted !== 0) {
+            this.deleteValue(evicted);
+            this.kv.delete((0, exports.updatedAtKeyFor)(evicted));
+        }
+    }
+    setValue(id, value, refIds) {
+        const kv = this.kv;
+        kv.setString((0, exports.valueKeyFor)(id), JSON.stringify(value));
+        const refIdsKey = (0, exports.refIdsKeyFor)(id);
+        const prevRefIds = kv.getBuffer(refIdsKey);
+        if (refIds === undefined || refIds.size === 0) {
+            kv.delete(refIdsKey);
+            // Decrement all previous refs
+            if (prevRefIds !== undefined) {
+                for (let i = 0; i < prevRefIds.length; i++) {
+                    const refId = prevRefIds[i];
+                    this.decrementRefCount(refId);
+                }
+            }
+        }
+        else {
+            // Convert the set to a Uint32Array and capture all the refIds before we
+            // delete previous ones from the set
+            const newRefIds = new Uint32Array(refIds);
+            if (prevRefIds !== undefined) {
+                // Process new refs: increment if not in old
+                for (let i = 0; i < prevRefIds.length; i++) {
+                    const refId = prevRefIds[i];
+                    if (refIds.has(refId)) {
+                        refIds.delete(refId);
+                    }
+                    else {
+                        this.decrementRefCount(refId);
+                    }
+                }
+            }
+            // No previous refs, increment all unique new refs
+            for (const refId of refIds) {
+                this.incrementRefCount(refId);
+            }
+            kv.setBuffer(refIdsKey, newRefIds);
+        }
+    }
+    deleteValue(id) {
+        const kv = this.kv;
+        kv.delete((0, exports.valueKeyFor)(id));
+        kv.delete((0, exports.refCountKeyFor)(id));
+        const refIds = kv.getBuffer((0, exports.refIdsKeyFor)(id));
+        kv.delete((0, exports.refIdsKeyFor)(id)); // Clean up the refIds key
+        if (refIds === undefined) {
+            return;
+        }
+        // Decrement ref counts for all referenced entities
+        for (const refId of refIds) {
+            if (refId !== 0) {
+                this.decrementRefCount(refId);
+            }
+        }
+    }
+    incrementRefCount(refId) {
+        const refCountKey = (0, exports.refCountKeyFor)(refId);
+        const currentCount = this.kv.getNumber(refCountKey) ?? 0;
+        const newCount = currentCount + 1;
+        this.kv.setNumber(refCountKey, newCount);
+    }
+    decrementRefCount(refId) {
+        const refCountKey = (0, exports.refCountKeyFor)(refId);
+        const currentCount = this.kv.getNumber(refCountKey);
+        if (currentCount === undefined) {
+            // Already deleted or never existed
+            return;
+        }
+        const newCount = currentCount - 1;
+        if (newCount === 0) {
+            // Entity exists, cascade delete it
+            this.deleteValue(refId);
+        }
+        else {
+            this.kv.setNumber(refCountKey, newCount);
+        }
+    }
+}
+exports.SyncQueryStore = SyncQueryStore;
+//# sourceMappingURL=QueryStore.js.map

package/dist/cjs/QueryStore.js.map

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

package/dist/cjs/errors.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeToString = typeToString;
+exports.typeError = typeError;
+const types_js_1 = require("./types.js");
+function typeToString(type) {
+    // Handle Set-based constants/enums
+    if (type instanceof Set) {
+        const values = Array.from(type).map(v => (typeof v === 'string' ? `"${v}"` : String(v)));
+        return values.join(' | ');
+    }
+    // Handle constants
+    if (typeof type === 'string') {
+        return `"${type}"`;
+    }
+    if (typeof type === 'boolean') {
+        return String(type);
+    }
+    // Handle primitive masks
+    if (typeof type === 'number') {
+        const types = [];
+        if (type & 1 /* Mask.UNDEFINED */)
+            types.push('undefined');
+        if (type & 2 /* Mask.NULL */)
+            types.push('null');
+        if (type & 4 /* Mask.NUMBER */)
+            types.push('number');
+        if (type & 8 /* Mask.STRING */)
+            types.push('string');
+        if (type & 16 /* Mask.BOOLEAN */)
+            types.push('boolean');
+        if (type & 32 /* Mask.OBJECT */)
+            types.push('object');
+        if (type & 64 /* Mask.ARRAY */)
+            types.push('array');
+        if (types.length === 0) {
+            return 'unknown';
+        }
+        return types.length === 1 ? types[0] : types.join(' | ');
+    }
+    // Handle complex types - CHECK UNION FIRST since it contains other types
+    const mask = type.mask;
+    if (mask & 512 /* Mask.UNION */) {
+        const unionType = type;
+        const parts = [];
+        // Add primitive types from the mask
+        if (mask & 1 /* Mask.UNDEFINED */)
+            parts.push('undefined');
+        if (mask & 2 /* Mask.NULL */)
+            parts.push('null');
+        if (mask & 4 /* Mask.NUMBER */)
+            parts.push('number');
+        if (mask & 8 /* Mask.STRING */)
+            parts.push('string');
+        if (mask & 16 /* Mask.BOOLEAN */)
+            parts.push('boolean');
+        // Add const/enum values from the values Set
+        if (unionType.values !== undefined && unionType.values.size > 0) {
+            for (const val of unionType.values) {
+                const valStr = typeof val === 'string' ? `"${val}"` : String(val);
+                parts.push(valStr);
+            }
+        }
+        // Add complex types from the shape object
+        if (unionType.shape !== undefined) {
+            if (unionType.shape[types_js_1.ARRAY_KEY] !== undefined) {
+                parts.push(`Array<${typeToString(unionType.shape[types_js_1.ARRAY_KEY])}>`);
+            }
+            if (unionType.shape[types_js_1.RECORD_KEY] !== undefined) {
+                parts.push(`Record<string, ${typeToString(unionType.shape[types_js_1.RECORD_KEY])}>`);
+            }
+            // Add entity/object types by typename
+            for (const [key, value] of Object.entries(unionType.shape)) {
+                if (key !== types_js_1.ARRAY_KEY && key !== types_js_1.RECORD_KEY) {
+                    // key is the typename value (e.g., "User", "Post")
+                    parts.push(key);
+                }
+            }
+        }
+        if (parts.length === 0) {
+            return 'union';
+        }
+        return parts.join(' | ');
+    }
+    if (mask & 1024 /* Mask.ENTITY */) {
+        return `Entity<${type.typenameValue}>`;
+    }
+    if (mask & 64 /* Mask.ARRAY */) {
+        const shape = type.shape;
+        return `Array<${typeToString(shape)}>`;
+    }
+    if (mask & 256 /* Mask.RECORD */) {
+        const shape = type.shape;
+        return `Record<string, ${typeToString(shape)}>`;
+    }
+    if (mask & 32 /* Mask.OBJECT */) {
+        const typename = type.typenameValue;
+        return typename ? `Object<${typename}>` : 'object';
+    }
+    return 'unknown';
+}
+function typeError(path, expectedType, value) {
+    return new TypeError(`Validation error at ${path}: expected ${typeToString(expectedType)}, got ${typeof value === 'object' ? (value === null ? 'null' : Array.isArray(value) ? 'array' : 'object') : typeof value}`);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

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

package/dist/cjs/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.query = exports.QueryResult = exports.QueryClient = void 0;
+__exportStar(require("./types.js"), exports);
+var QueryClient_js_1 = require("./QueryClient.js");
+Object.defineProperty(exports, "QueryClient", { enumerable: true, get: function () { return QueryClient_js_1.QueryClient; } });
+Object.defineProperty(exports, "QueryResult", { enumerable: true, get: function () { return QueryClient_js_1.QueryResultImpl; } });
+var query_js_1 = require("./query.js");
+Object.defineProperty(exports, "query", { enumerable: true, get: function () { return query_js_1.query; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,6CAA2B;AAE3B,mDAA+E;AAAtE,6GAAA,WAAW,OAAA;AAAE,6GAAA,eAAe,OAAe;AAGpD,uCAAmC;AAA1B,iGAAA,KAAK,OAAA"}

package/dist/cjs/parseEntities.js

@@ -0,0 +1,127 @@
+"use strict";
+// -----------------------------------------------------------------------------
+// Entity System
+// -----------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseUnionEntities = parseUnionEntities;
+exports.parseArrayEntities = parseArrayEntities;
+exports.parseRecordEntities = parseRecordEntities;
+exports.parseObjectEntities = parseObjectEntities;
+exports.parseEntities = parseEntities;
+const utils_1 = require("signalium/utils");
+const types_js_1 = require("./types.js");
+const utils_js_1 = require("./utils.js");
+const entries = Object.entries;
+function parseUnionEntities(valueType, value, unionDef, queryClient, entityRefs) {
+    if (valueType === 64 /* Mask.ARRAY */) {
+        const shape = unionDef.shape[types_js_1.ARRAY_KEY];
+        if (shape === undefined || typeof shape === 'number') {
+            return value;
+        }
+        return parseArrayEntities(value, { mask: 64 /* Mask.ARRAY */, shape, values: undefined }, queryClient, entityRefs);
+    }
+    else {
+        // Use the cached typename field from the union definition
+        const typenameField = unionDef.typenameField;
+        const typename = typenameField ? value[typenameField] : undefined;
+        if (typename === undefined || typeof typename !== 'string') {
+            const recordShape = unionDef.shape[types_js_1.RECORD_KEY];
+            if (recordShape === undefined || typeof recordShape === 'number') {
+                return value;
+            }
+            return parseRecordEntities(value, recordShape, queryClient, entityRefs);
+        }
+        const matchingDef = unionDef.shape[typename];
+        if (matchingDef === undefined || typeof matchingDef === 'number') {
+            return value;
+        }
+        return parseObjectEntities(value, matchingDef, queryClient, entityRefs);
+    }
+}
+function parseArrayEntities(array, arrayShape, queryClient, entityRefs) {
+    for (let i = 0; i < array.length; i++) {
+        array[i] = parseEntities(array[i], arrayShape, queryClient, entityRefs);
+    }
+    return array;
+}
+function parseRecordEntities(record, recordShape, queryClient, entityRefs) {
+    if (typeof recordShape === 'number') {
+        return record;
+    }
+    for (const [key, value] of entries(record)) {
+        record[key] = parseEntities(value, recordShape, queryClient, entityRefs);
+    }
+    return record;
+}
+function parseObjectEntities(obj, objectShape, queryClient, entityRefs) {
+    const entityRefId = obj.__entityRef;
+    // Check if this is an entity reference (from cache)
+    if (typeof entityRefId === 'number') {
+        return queryClient.hydrateEntity(entityRefId, objectShape).proxy;
+    }
+    // Process sub-entity paths (only these paths can contain entities)
+    const { mask } = objectShape;
+    const childRefs = mask & 1024 /* Mask.ENTITY */ ? new Set() : entityRefs;
+    // Extract shape first to resolve lazy definitions and set subEntityPaths
+    const shape = (0, utils_js_1.extractShape)(objectShape);
+    const subEntityPaths = objectShape.subEntityPaths;
+    if (subEntityPaths !== undefined) {
+        if (typeof subEntityPaths === 'string') {
+            // Single path - avoid array allocation
+            const propDef = shape[subEntityPaths];
+            obj[subEntityPaths] = parseEntities(obj[subEntityPaths], propDef, queryClient, childRefs);
+        }
+        else {
+            // Multiple paths - iterate directly
+            for (const path of subEntityPaths) {
+                const propDef = shape[path];
+                obj[path] = parseEntities(obj[path], propDef, queryClient, childRefs);
+            }
+        }
+    }
+    // Handle entity replacement (entities get cached and replaced with proxies)
+    if (mask & 1024 /* Mask.ENTITY */) {
+        const entityDef = objectShape;
+        const typename = entityDef.typenameValue;
+        const id = obj[entityDef.idField];
+        const desc = `${typename}:${id}`;
+        const key = (0, utils_1.hashValue)(desc);
+        // Add this entity's key to the parent's entityRefs (if provided)
+        if (entityRefs !== undefined) {
+            entityRefs.add(key);
+        }
+        return queryClient.saveEntity(key, obj, entityDef, childRefs).proxy;
+    }
+    // Return the processed object (even if not an entity)
+    return obj;
+}
+function parseEntities(value, def, queryClient, entityRefs) {
+    const valueType = (0, utils_js_1.typeMaskOf)(value);
+    const defType = def.mask;
+    // Skip primitives and incompatible types - they can't contain entities
+    // Note: We silently return incompatible values rather than erroring
+    if (valueType < 32 /* Mask.OBJECT */ || (defType & valueType) === 0) {
+        return value;
+    }
+    // Handle unions first - they can contain multiple types, and all of the union
+    // logic is handled above, so we return early here if it's a union
+    if ((defType & 512 /* Mask.UNION */) !== 0) {
+        return parseUnionEntities(valueType, value, def, queryClient, entityRefs);
+    }
+    // If it's not a union, AND the value IS an array, then the definition must
+    // be an ArrayDef, so we can cast safely here
+    if (valueType === 64 /* Mask.ARRAY */) {
+        return parseArrayEntities(value, def.shape, queryClient, entityRefs);
+    }
+    // Now we know the value is an object, so def must be a RecordDef, ObjectDef
+    // or EntityDef. We first check to see if it's a RecordDef, and if so, we can
+    // cast it here and return early.
+    if ((defType & 256 /* Mask.RECORD */) !== 0) {
+        return parseRecordEntities(value, def.shape, queryClient, entityRefs);
+    }
+    // Now we know the def is an ObjectDef or EntityDef. These are both handled
+    // the same way _mostly_, with Entities just returning a proxy instead of the
+    // object itself
+    return parseObjectEntities(value, def, queryClient, entityRefs);
+}
+//# sourceMappingURL=parseEntities.js.map

package/dist/cjs/parseEntities.js.map

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

package/dist/cjs/pathInterpolator.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Path interpolation utilities for URL templates with parameter substitution.
+ *
+ * Converts path templates like "/users/{userId}/posts/{postId}" into functions
+ * that efficiently interpolate parameter values.
+ *
+ * The implementation pre-parses the path template once into segments and parameter
+ * keys, then uses simple string concatenation at runtime for optimal performance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPathInterpolator = createPathInterpolator;
+/**
+ * Creates an optimized path interpolation function from a URL template.
+ *
+ * The template uses curly braces for parameters (e.g., "/items/{id}").
+ * Parameter values are URL-encoded when interpolated. Any parameters not
+ * found in the path template are appended as query string parameters.
+ *
+ * @param pathTemplate - URL template with {paramName} placeholders
+ * @returns Function that interpolates parameters into the path with search params
+ *
+ * @example
+ * ```ts
+ * const interpolate = createPathInterpolator('/users/{userId}/posts/{postId}');
+ * const url = interpolate({ userId: '123', postId: '456', page: 2, limit: 10 });
+ * // Returns: "/users/123/posts/456?page=2&limit=10"
+ * ```
+ */
+function createPathInterpolator(pathTemplate) {
+    // Pre-parse path into segments and param keys (parse once, concatenate many times)
+    const segments = [];
+    const paramKeys = [];
+    const paramKeysSet = new Set();
+    let lastIndex = 0;
+    const paramRegex = /\[([^\]]+)\]/g;
+    let match;
+    while ((match = paramRegex.exec(pathTemplate)) !== null) {
+        segments.push(pathTemplate.slice(lastIndex, match.index));
+        paramKeys.push(match[1]);
+        paramKeysSet.add(match[1]);
+        lastIndex = paramRegex.lastIndex;
+    }
+    segments.push(pathTemplate.slice(lastIndex));
+    // Return optimized interpolation function with pre-parsed segments
+    return (params) => {
+        // Build the path with interpolated path parameters
+        let result = segments[0];
+        for (let i = 0; i < paramKeys.length; i++) {
+            result += encodeURIComponent(String(params[paramKeys[i]])) + segments[i + 1];
+        }
+        // Collect remaining parameters as search params
+        let searchParams = null;
+        for (const key in params) {
+            if (!paramKeysSet.has(key) && params[key] !== undefined) {
+                if (searchParams === null) {
+                    searchParams = new URLSearchParams();
+                }
+                searchParams.append(key, String(params[key]));
+            }
+        }
+        // Append search params if any exist
+        if (searchParams !== null) {
+            result += '?' + searchParams.toString();
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=pathInterpolator.js.map

package/dist/cjs/pathInterpolator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathInterpolator.js","sourceRoot":"","sources":["../../src/pathInterpolator.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;AAqBH,wDA4CC;AA7DD;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,sBAAsB,CAAC,YAAoB;IACzD,mFAAmF;IACnF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,MAAM,UAAU,GAAG,eAAe,CAAC;IACnC,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC;IACnC,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7C,mEAAmE;IACnE,OAAO,CAAC,MAA2B,EAAU,EAAE;QAC7C,mDAAmD;QACnD,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/E,CAAC;QAED,gDAAgD;QAChD,IAAI,YAAY,GAA2B,IAAI,CAAC;QAChD,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBACxD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;oBAC1B,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;gBACvC,CAAC;gBAED,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,oCAAoC;QACpC,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC1C,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}