@anvailabs/proximadb-client 0.3.0 → 0.5.0

package/dist/esm/index.js

@@ -1,86 +0,0 @@
-/**
- * ProximaDB TypeScript SDK
- *
- * A modern, async-first TypeScript client for ProximaDB vector database.
- *
- * @example
- * ```typescript
- * import { connect, FilterBuilder } from "@proximadb/client";
- *
- * // Connect to ProximaDB
- * const client = connect("http://localhost:5678");
- *
- * // Create a collection
- * await client.createCollection("embeddings")
- *   .dimension(768)
- *   .engine(StorageEngine.Sst)
- *   .execute();
- *
- * // Insert vectors
- * await client.collection("embeddings")
- *   .insert()
- *   .id("vec_1")
- *   .vector([0.1, 0.2, ...])
- *   .meta("category", "tech")
- *   .execute();
- *
- * // Search with filters
- * const results = await client.collection("embeddings")
- *   .search()
- *   .vector(queryVector)
- *   .topK(10)
- *   .filterEq("category", "tech")
- *   .execute();
- *
- * // Graph operations
- * await client.createGraph("knowledge").execute();
- * await client.graph("knowledge")
- *   .addNode()
- *   .id("person_1")
- *   .label("Person")
- *   .property("name", "Alice")
- *   .execute();
- * ```
- *
- * Copyright 2025 ProximaDB Contributors
- * Licensed under the Apache License, Version 2.0
- */
-// ============================================================================
-// VERSION
-// ============================================================================
-export const VERSION = "1.0.0";
-// ============================================================================
-// TYPES
-// ============================================================================
-// Enums (runtime values)
-export { DistanceMetric, StorageEngine, IndexType, FilterOp, LogicalOp, SearchMode, TraversalDirection, ErrorCode, ProximaDBError, } from "./types";
-// ============================================================================
-// CLIENT
-// ============================================================================
-export { ProximaDBClient, ClientBuilder, connect, connectRest, } from "./client";
-// ============================================================================
-// COLLECTION
-// ============================================================================
-export { CollectionHandle, CollectionBuilder, InsertBuilder, BatchInsertBuilder, UpdateBuilder, } from "./collection";
-// ============================================================================
-// SEARCH
-// ============================================================================
-export { SearchBuilder, createSearchBuilder, } from "./search";
-// ============================================================================
-// FILTER
-// ============================================================================
-export { FilterBuilder, 
-// Convenience functions
-eq, ne, gt, lt, inList, range, andFilters, orFilters, filterToExpression, } from "./filter";
-// ============================================================================
-// GRAPH
-// ============================================================================
-export { GraphHandle, GraphBuilder, NodeBuilder, EdgeBuilder, TraversalBuilder, 
-// Convenience functions
-createNode, node, createEdge, edge, } from "./graph";
-// ============================================================================
-// DEFAULT EXPORT
-// ============================================================================
-import { ProximaDBClient } from "./client";
-export default ProximaDBClient;
-//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAEH,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC;AAE/B,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,yBAAyB;AACzB,OAAO,EACL,cAAc,EACd,aAAa,EACb,SAAS,EACT,QAAQ,EACR,SAAS,EACT,UAAU,EACV,kBAAkB,EAClB,SAAS,EACT,cAAc,GACf,MAAM,SAAS,CAAC;AA0CjB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,eAAe,EACf,aAAa,EACb,OAAO,EACP,WAAW,GACZ,MAAM,UAAU,CAAC;AAElB,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,aAAa,EACb,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAElB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,OAAO,EACL,aAAa;AACb,wBAAwB;AACxB,EAAE,EACF,EAAE,EACF,EAAE,EACF,EAAE,EACF,MAAM,EACN,KAAK,EACL,UAAU,EACV,SAAS,EACT,kBAAkB,GACnB,MAAM,UAAU,CAAC;AAElB,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,gBAAgB;AAChB,wBAAwB;AACxB,UAAU,EACV,IAAI,EACJ,UAAU,EACV,IAAI,GACL,MAAM,SAAS,CAAC;AAEjB,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,eAAe,eAAe,CAAC"}

package/dist/esm/search.js

@@ -1,317 +0,0 @@
-/**
- * ProximaDB TypeScript SDK - Search Builder
- *
- * Provides a fluent API for building and executing vector similarity searches.
- *
- * Copyright 2025 ProximaDB Contributors
- * Licensed under the Apache License, Version 2.0
- */
-import { SearchMode } from "./types";
-import { FilterBuilder, filterToExpression } from "./filter";
-/**
- * Builder for search queries with fluent API
- */
-export class SearchBuilder {
-    client;
-    collectionName;
-    queryVector = null;
-    k = 10;
-    filterExpr = null;
-    filterBuilder = null;
-    searchMode = SearchMode.Exact;
-    nprobeValue = null;
-    adaptiveThreshold = null;
-    includeVectorsFlag = false;
-    minScoreValue = null;
-    timeoutMsValue = null;
-    constructor(client, collection) {
-        this.client = client;
-        this.collectionName = collection;
-    }
-    /**
-     * Set the query vector
-     */
-    vector(vec) {
-        this.queryVector = vec;
-        return this;
-    }
-    /**
-     * Set the number of results to return
-     */
-    topK(k) {
-        this.k = k;
-        return this;
-    }
-    /**
-     * Alias for topK
-     */
-    limit(k) {
-        return this.topK(k);
-    }
-    /**
-     * Set a filter expression string
-     */
-    filter(filterStr) {
-        this.filterExpr = filterStr;
-        return this;
-    }
-    /**
-     * Apply a pre-built filter
-     */
-    withFilter(filterObj) {
-        this.filterExpr = filterToExpression(filterObj);
-        return this;
-    }
-    /**
-     * Set the search mode
-     */
-    mode(searchMode) {
-        this.searchMode = searchMode;
-        return this;
-    }
-    /**
-     * Use exact search (100% recall)
-     */
-    exact() {
-        this.searchMode = SearchMode.Exact;
-        return this;
-    }
-    /**
-     * Use approximate search for faster results
-     */
-    approximate() {
-        this.searchMode = SearchMode.Approximate;
-        return this;
-    }
-    /**
-     * Use approximate search with specific nprobe value
-     */
-    approximateWithNprobe(nprobe) {
-        this.searchMode = SearchMode.Approximate;
-        this.nprobeValue = nprobe;
-        return this;
-    }
-    /**
-     * Use adaptive search mode
-     */
-    adaptive(threshold) {
-        this.searchMode = SearchMode.Adaptive;
-        this.adaptiveThreshold = threshold;
-        return this;
-    }
-    /**
-     * Include vectors in results
-     */
-    includeVectors(include = true) {
-        this.includeVectorsFlag = include;
-        return this;
-    }
-    /**
-     * Include metadata in results
-     */
-    includeMetadata(_include = true) {
-        return this;
-    }
-    /**
-     * Set minimum score threshold
-     */
-    minScore(score) {
-        this.minScoreValue = score;
-        return this;
-    }
-    /**
-     * Set request timeout in milliseconds
-     */
-    timeoutMs(timeout) {
-        this.timeoutMsValue = timeout;
-        return this;
-    }
-    /**
-     * Set timeout in seconds (convenience method)
-     */
-    timeoutSecs(secs) {
-        this.timeoutMsValue = secs * 1000;
-        return this;
-    }
-    // =========================================================================
-    // Inline filter methods for convenience
-    // =========================================================================
-    /**
-     * Add an equality filter condition
-     */
-    filterEq(field, value) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.eq(field, value);
-        return this;
-    }
-    /**
-     * Add a not-equal filter condition
-     */
-    filterNe(field, value) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.ne(field, value);
-        return this;
-    }
-    /**
-     * Add a greater-than filter condition
-     */
-    filterGt(field, value) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.gt(field, value);
-        return this;
-    }
-    /**
-     * Add a greater-than-or-equal filter condition
-     */
-    filterGte(field, value) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.gte(field, value);
-        return this;
-    }
-    /**
-     * Add a less-than filter condition
-     */
-    filterLt(field, value) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.lt(field, value);
-        return this;
-    }
-    /**
-     * Add a less-than-or-equal filter condition
-     */
-    filterLte(field, value) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.lte(field, value);
-        return this;
-    }
-    /**
-     * Add a range filter condition (inclusive)
-     */
-    filterRange(field, min, max) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.range(field, min, max);
-        return this;
-    }
-    /**
-     * Add an IN filter condition
-     */
-    filterIn(field, values) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.inList(field, values);
-        return this;
-    }
-    /**
-     * Add a contains filter condition
-     */
-    filterContains(field, value) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.contains(field, value);
-        return this;
-    }
-    /**
-     * Add an exists filter condition
-     */
-    filterExists(field) {
-        this.ensureFilterBuilder();
-        this.filterBuilder = this.filterBuilder.exists(field);
-        return this;
-    }
-    ensureFilterBuilder() {
-        if (this.filterBuilder === null) {
-            this.filterBuilder = FilterBuilder.new();
-        }
-    }
-    buildFilter() {
-        if (this.filterBuilder !== null) {
-            return this.filterBuilder.toExpression();
-        }
-        return this.filterExpr ?? undefined;
-    }
-    buildSearchModeString() {
-        switch (this.searchMode) {
-            case SearchMode.Exact:
-                return "exact";
-            case SearchMode.Approximate:
-                if (this.nprobeValue !== null) {
-                    return "approximate:" + this.nprobeValue;
-                }
-                return "approximate";
-            case SearchMode.Adaptive:
-                if (this.adaptiveThreshold !== null) {
-                    return "adaptive:" + this.adaptiveThreshold;
-                }
-                return "adaptive:10000";
-            default:
-                return "exact";
-        }
-    }
-    /**
-     * Execute the search query
-     */
-    async execute() {
-        if (this.queryVector === null) {
-            throw new Error("Query vector is required");
-        }
-        if (this.k <= 0 || this.k > 10000) {
-            throw new Error("topK must be between 1 and 10000");
-        }
-        const request = {
-            vector: this.queryVector,
-            top_k: this.k,
-            filter: this.buildFilter(),
-            searchMode: this.buildSearchModeString(),
-            include_vector: this.includeVectorsFlag,
-            include_text: false,
-            timeoutMs: this.timeoutMsValue ?? undefined,
-        };
-        const response = (await this.client.searchRecordsRequest(this.collectionName, request));
-        let results = response.results;
-        // Apply min_score filter if set
-        if (this.minScoreValue !== null) {
-            results = results.filter((r) => r.score >= this.minScoreValue);
-        }
-        return results;
-    }
-    /**
-     * Execute the search and return a streaming iterator
-     */
-    async *stream() {
-        const results = await this.execute();
-        for (const result of results) {
-            yield result;
-        }
-    }
-    /**
-     * Create an async iterator for streaming results
-     */
-    async iterate() {
-        const results = await this.execute();
-        let index = 0;
-        const total = results.length;
-        const iterator = {
-            [Symbol.asyncIterator]() {
-                return iterator;
-            },
-            async next() {
-                if (index < results.length) {
-                    return { value: results[index++], done: false };
-                }
-                return { value: undefined, done: true };
-            },
-            getTotal() {
-                return total;
-            },
-            isComplete() {
-                return index >= results.length;
-            },
-        };
-        return iterator;
-    }
-}
-/**
- * Create a new search builder
- */
-export function createSearchBuilder(client, collection) {
-    return new SearchBuilder(client, collection);
-}
-//# sourceMappingURL=search.js.map

package/dist/esm/search.js.map

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

package/dist/esm/transport.js

@@ -1,33 +0,0 @@
-/**
- * ProximaDB TypeScript SDK - Generated REST transport seam (TD-126 Phase 4)
- *
- * This is the thin, hand-written ergonomic facade over the GENERATED REST
- * transport. The wire contract — path templates, path/query parameter
- * encoding, request/response JSON shapes — is generated from
- * `docs/openapi/proximadb-openapi.yaml` into `src/generated/schema.ts`
- * (openapi-typescript, pinned in package.json; regenerate with
- * `npm run gen-sdk`). `openapi-fetch` turns those generated `paths` types into
- * a typed runtime client.
- *
- * Generators don't do ergonomics; this layer is the value-add: it injects the
- * facade's own `fetch` (which owns bearer auth, retries, and error mapping —
- * see `client.ts`) into the typed client, so the generated wire plumbing and
- * the hand-written transport policy compose without either reimplementing the
- * other. This mirrors the merged Go pilot (TD-126 Phase 2), where the generated
- * `genrest.Client` is driven through `RequestEditorFn`s + a custom `http.Client`.
- *
- * Copyright 2025 ProximaDB Contributors
- * Licensed under the Apache License, Version 2.0
- */
-import createClient from "openapi-fetch";
-/**
- * Construct the generated typed REST client, routing every request the
- * generated client issues through the facade's transport `fetch`.
- */
-export function createTransport(baseUrl, fetchImpl) {
-    return createClient({
-        baseUrl,
-        fetch: fetchImpl,
-    });
-}
-//# sourceMappingURL=transport.js.map

package/dist/esm/transport.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,YAAY,MAAM,eAAe,CAAC;AAiBzC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,SAAyB;IAEzB,OAAO,YAAY,CAAQ;QACzB,OAAO;QACP,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/types.js

@@ -1,181 +0,0 @@
-/**
- * ProximaDB TypeScript SDK - Type Definitions
- *
- * Copyright 2025 ProximaDB Contributors
- * Licensed under the Apache License, Version 2.0
- */
-// ============================================================================
-// ENUMS
-// ============================================================================
-/**
- * Distance metrics for vector similarity search
- */
-export var DistanceMetric;
-(function (DistanceMetric) {
-    /** Cosine similarity (normalized dot product) */
-    DistanceMetric["Cosine"] = "cosine";
-    /** Euclidean (L2) distance */
-    DistanceMetric["Euclidean"] = "euclidean";
-    /** Dot product similarity */
-    DistanceMetric["DotProduct"] = "dot_product";
-    /** Manhattan (L1) distance */
-    DistanceMetric["Manhattan"] = "manhattan";
-    /** Hamming distance for binary vectors */
-    DistanceMetric["Hamming"] = "hamming";
-    /** Jaccard similarity for set-like vectors */
-    DistanceMetric["Jaccard"] = "jaccard";
-})(DistanceMetric || (DistanceMetric = {}));
-/**
- * Storage engines available in ProximaDB
- */
-export var StorageEngine;
-(function (StorageEngine) {
-    /** Write-optimized, real-time workloads */
-    StorageEngine["Sst"] = "sst";
-    /** Locality-optimized with Hilbert curves */
-    StorageEngine["Helix"] = "helix";
-    /** Columnar Parquet for analytics */
-    StorageEngine["Viper"] = "viper";
-    /** Ultra-low latency for small datasets */
-    StorageEngine["Swift"] = "swift";
-    /** Progressive columnar for mixed workloads */
-    StorageEngine["Nova"] = "nova";
-    /** Adaptive row-group for dynamic workloads */
-    StorageEngine["Raptor"] = "raptor";
-})(StorageEngine || (StorageEngine = {}));
-/**
- * Index types for vector search
- */
-export var IndexType;
-(function (IndexType) {
-    /** Hierarchical Navigable Small World */
-    IndexType["Hnsw"] = "hnsw";
-    /** Inverted File Index */
-    IndexType["Ivf"] = "ivf";
-    /** Locality Sensitive Hashing */
-    IndexType["Lsh"] = "lsh";
-    /** Brute force (no index) */
-    IndexType["Flat"] = "flat";
-    /** Product Quantization */
-    IndexType["Pq"] = "pq";
-    /** Approximate Nearest Neighbors Oh Yeah */
-    IndexType["Annoy"] = "annoy";
-})(IndexType || (IndexType = {}));
-/**
- * Filter operations for metadata filtering
- */
-export var FilterOp;
-(function (FilterOp) {
-    /** Equal to */
-    FilterOp["Eq"] = "equals";
-    /** Not equal to */
-    FilterOp["Ne"] = "not_equals";
-    /** Greater than */
-    FilterOp["Gt"] = "gt";
-    /** Greater than or equal */
-    FilterOp["Gte"] = "gte";
-    /** Less than */
-    FilterOp["Lt"] = "lt";
-    /** Less than or equal */
-    FilterOp["Lte"] = "lte";
-    /** In list of values */
-    FilterOp["In"] = "in";
-    /** Not in list of values */
-    FilterOp["NotIn"] = "not_in";
-    /** Contains (for strings/arrays) */
-    FilterOp["Contains"] = "contains";
-    /** Starts with (for strings) */
-    FilterOp["StartsWith"] = "starts_with";
-    /** Ends with (for strings) */
-    FilterOp["EndsWith"] = "ends_with";
-    /** Field exists */
-    FilterOp["Exists"] = "exists";
-    /** Field is null */
-    FilterOp["IsNull"] = "is_null";
-})(FilterOp || (FilterOp = {}));
-/**
- * Logical operators for combining filter conditions
- */
-export var LogicalOp;
-(function (LogicalOp) {
-    /** All conditions must match */
-    LogicalOp["And"] = "and";
-    /** Any condition must match */
-    LogicalOp["Or"] = "or";
-})(LogicalOp || (LogicalOp = {}));
-/**
- * Search mode for controlling recall vs performance tradeoff
- */
-export var SearchMode;
-(function (SearchMode) {
-    /** Exact search - 100% recall, searches all partitions */
-    SearchMode["Exact"] = "exact";
-    /** Approximate search - faster with ~95% recall */
-    SearchMode["Approximate"] = "approximate";
-    /** Adaptive search - auto-selects based on dataset size */
-    SearchMode["Adaptive"] = "adaptive";
-})(SearchMode || (SearchMode = {}));
-/**
- * Traversal direction for graph queries
- */
-export var TraversalDirection;
-(function (TraversalDirection) {
-    /** Traverse outgoing edges */
-    TraversalDirection["Outgoing"] = "outgoing";
-    /** Traverse incoming edges */
-    TraversalDirection["Incoming"] = "incoming";
-    /** Traverse both directions */
-    TraversalDirection["Both"] = "both";
-})(TraversalDirection || (TraversalDirection = {}));
-// ============================================================================
-// ERROR TYPES
-// ============================================================================
-/**
- * ProximaDB error codes
- */
-export var ErrorCode;
-(function (ErrorCode) {
-    /** Unknown error */
-    ErrorCode["Unknown"] = "UNKNOWN";
-    /** Network error */
-    ErrorCode["Network"] = "NETWORK_ERROR";
-    /** Authentication failed */
-    ErrorCode["AuthenticationFailed"] = "AUTHENTICATION_FAILED";
-    /** Authorization denied */
-    ErrorCode["AuthorizationDenied"] = "AUTHORIZATION_DENIED";
-    /** Rate limited */
-    ErrorCode["RateLimited"] = "RATE_LIMITED";
-    /** Collection not found */
-    ErrorCode["CollectionNotFound"] = "COLLECTION_NOT_FOUND";
-    /** Collection already exists */
-    ErrorCode["CollectionExists"] = "COLLECTION_EXISTS";
-    /** Vector not found */
-    ErrorCode["VectorNotFound"] = "VECTOR_NOT_FOUND";
-    /** Invalid vector dimension */
-    ErrorCode["InvalidDimension"] = "INVALID_DIMENSION";
-    /** Invalid configuration */
-    ErrorCode["InvalidConfig"] = "INVALID_CONFIG";
-    /** Invalid filter */
-    ErrorCode["InvalidFilter"] = "INVALID_FILTER";
-    /** Timeout */
-    ErrorCode["Timeout"] = "TIMEOUT";
-    /** Server error */
-    ErrorCode["ServerError"] = "SERVER_ERROR";
-})(ErrorCode || (ErrorCode = {}));
-/**
- * ProximaDB error
- */
-export class ProximaDBError extends Error {
-    code;
-    statusCode;
-    details;
-    constructor(message, code = ErrorCode.Unknown, statusCode, details) {
-        super(message);
-        this.code = code;
-        this.statusCode = statusCode;
-        this.details = details;
-        this.name = "ProximaDBError";
-        Object.setPrototypeOf(this, ProximaDBError.prototype);
-    }
-}
-//# sourceMappingURL=types.js.map

package/dist/esm/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAN,IAAY,cAaX;AAbD,WAAY,cAAc;IACxB,iDAAiD;IACjD,mCAAiB,CAAA;IACjB,8BAA8B;IAC9B,yCAAuB,CAAA;IACvB,6BAA6B;IAC7B,4CAA0B,CAAA;IAC1B,8BAA8B;IAC9B,yCAAuB,CAAA;IACvB,0CAA0C;IAC1C,qCAAmB,CAAA;IACnB,8CAA8C;IAC9C,qCAAmB,CAAA;AACrB,CAAC,EAbW,cAAc,KAAd,cAAc,QAazB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,aAaX;AAbD,WAAY,aAAa;IACvB,2CAA2C;IAC3C,4BAAW,CAAA;IACX,6CAA6C;IAC7C,gCAAe,CAAA;IACf,qCAAqC;IACrC,gCAAe,CAAA;IACf,2CAA2C;IAC3C,gCAAe,CAAA;IACf,+CAA+C;IAC/C,8BAAa,CAAA;IACb,+CAA+C;IAC/C,kCAAiB,CAAA;AACnB,CAAC,EAbW,aAAa,KAAb,aAAa,QAaxB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,SAaX;AAbD,WAAY,SAAS;IACnB,yCAAyC;IACzC,0BAAa,CAAA;IACb,0BAA0B;IAC1B,wBAAW,CAAA;IACX,iCAAiC;IACjC,wBAAW,CAAA;IACX,6BAA6B;IAC7B,0BAAa,CAAA;IACb,2BAA2B;IAC3B,sBAAS,CAAA;IACT,4CAA4C;IAC5C,4BAAe,CAAA;AACjB,CAAC,EAbW,SAAS,KAAT,SAAS,QAapB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QA2BX;AA3BD,WAAY,QAAQ;IAClB,eAAe;IACf,yBAAa,CAAA;IACb,mBAAmB;IACnB,6BAAiB,CAAA;IACjB,mBAAmB;IACnB,qBAAS,CAAA;IACT,4BAA4B;IAC5B,uBAAW,CAAA;IACX,gBAAgB;IAChB,qBAAS,CAAA;IACT,yBAAyB;IACzB,uBAAW,CAAA;IACX,wBAAwB;IACxB,qBAAS,CAAA;IACT,4BAA4B;IAC5B,4BAAgB,CAAA;IAChB,oCAAoC;IACpC,iCAAqB,CAAA;IACrB,gCAAgC;IAChC,sCAA0B,CAAA;IAC1B,8BAA8B;IAC9B,kCAAsB,CAAA;IACtB,mBAAmB;IACnB,6BAAiB,CAAA;IACjB,oBAAoB;IACpB,8BAAkB,CAAA;AACpB,CAAC,EA3BW,QAAQ,KAAR,QAAQ,QA2BnB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,gCAAgC;IAChC,wBAAW,CAAA;IACX,+BAA+B;IAC/B,sBAAS,CAAA;AACX,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,0DAA0D;IAC1D,6BAAe,CAAA;IACf,mDAAmD;IACnD,yCAA2B,CAAA;IAC3B,2DAA2D;IAC3D,mCAAqB,CAAA;AACvB,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,kBAOX;AAPD,WAAY,kBAAkB;IAC5B,8BAA8B;IAC9B,2CAAqB,CAAA;IACrB,8BAA8B;IAC9B,2CAAqB,CAAA;IACrB,+BAA+B;IAC/B,mCAAa,CAAA;AACf,CAAC,EAPW,kBAAkB,KAAlB,kBAAkB,QAO7B;AAsgBD,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAN,IAAY,SA2BX;AA3BD,WAAY,SAAS;IACnB,oBAAoB;IACpB,gCAAmB,CAAA;IACnB,oBAAoB;IACpB,sCAAyB,CAAA;IACzB,4BAA4B;IAC5B,2DAA8C,CAAA;IAC9C,2BAA2B;IAC3B,yDAA4C,CAAA;IAC5C,mBAAmB;IACnB,yCAA4B,CAAA;IAC5B,2BAA2B;IAC3B,wDAA2C,CAAA;IAC3C,gCAAgC;IAChC,mDAAsC,CAAA;IACtC,uBAAuB;IACvB,gDAAmC,CAAA;IACnC,+BAA+B;IAC/B,mDAAsC,CAAA;IACtC,4BAA4B;IAC5B,6CAAgC,CAAA;IAChC,qBAAqB;IACrB,6CAAgC,CAAA;IAChC,cAAc;IACd,gCAAmB,CAAA;IACnB,mBAAmB;IACnB,yCAA4B,CAAA;AAC9B,CAAC,EA3BW,SAAS,KAAT,SAAS,QA2BpB;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IACA;IAJlB,YACE,OAAe,EACC,OAAkB,SAAS,CAAC,OAAO,EACnC,UAAmB,EACnB,OAAiC;QAEjD,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAA+B;QACnC,eAAU,GAAV,UAAU,CAAS;QACnB,YAAO,GAAP,OAAO,CAA0B;QAGjD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;CACF"}