@adonis-agora/filter-client 0.1.0

package/dist/filter-query-builder.js

@@ -0,0 +1,538 @@
+import { columnFiltersToQueryString, flatObjectToQueryString } from './to-query-string.js';
+import { validateAddOperator, validateOperatorValue } from './validate-operator-value.js';
+/**
+ * Client-side query builder for @agora/filter.
+ * Zero dependencies. Runs in browser + Node.
+ */
+export class FilterQueryBuilder {
+    conditions = [];
+    groups = [];
+    extra = {};
+    includes = [];
+    searchTerm;
+    sorts = [];
+    distinctFields = [];
+    pagination;
+    // ─── Reactivity (framework-agnostic store contract) ──────────────────────
+    // The builder doubles as an observable store so framework adapters
+    // (React's useSyncExternalStore, Vue refs, Svelte stores) can react to
+    // mutations. `version` increments on every mutation; `snapshot` caches the
+    // last `build()` so `getSnapshot()` returns a stable reference until the
+    // next mutation — required by useSyncExternalStore to avoid render loops.
+    version = 0;
+    snapshot = null;
+    listeners = new Set();
+    where(field, operatorOrValue, maybeValue) {
+        // Remove any existing filter(s) for this field
+        this.conditions = this.conditions.filter((c) => c.field !== field);
+        if (maybeValue !== undefined) {
+            // Three-arg form: where(field, operator, value)
+            const op = operatorOrValue;
+            validateOperatorValue(op, maybeValue);
+            this.conditions.push({
+                field,
+                operator: op,
+                value: maybeValue,
+            });
+        }
+        else if (Array.isArray(operatorOrValue)) {
+            // Array value → auto in
+            this.conditions.push({
+                field,
+                operator: 'in',
+                value: operatorOrValue,
+            });
+        }
+        else if (typeof operatorOrValue === 'string' &&
+            ['isNull', 'isNotNull', 'isEmpty', 'isNotEmpty', 'exists', 'notExists'].includes(operatorOrValue)) {
+            // Two-arg form with unary operator: where(field, 'isNull')
+            validateOperatorValue(operatorOrValue, undefined);
+            this.conditions.push({
+                field,
+                operator: operatorOrValue,
+                value: undefined,
+            });
+        }
+        else {
+            // Simple value → equals
+            this.conditions.push({
+                field,
+                operator: 'equals',
+                value: operatorOrValue,
+            });
+        }
+        this.notify();
+        return this;
+    }
+    add(field, operator, value) {
+        validateAddOperator(operator);
+        validateOperatorValue(operator, value);
+        this.conditions.push({ field, operator, value });
+        this.notify();
+        return this;
+    }
+    /**
+     * Removes ALL filters for a given field (both from `where()` and `add()`).
+     *
+     * @example
+     * filterQuery()
+     *   .equals('status', 'COMPLETED')
+     *   .contains('name', 'fleet')
+     *   .remove('status')
+     *   .build();
+     * // → { where: [{ field: 'name', operator: 'contains', value: 'fleet' }] }
+     */
+    remove(field) {
+        this.conditions = this.conditions.filter((c) => c.field !== field);
+        this.notify();
+        return this;
+    }
+    /**
+     * Removes all filters and extra keys, resetting the builder to its initial state.
+     */
+    clear() {
+        this.conditions = [];
+        this.groups.length = 0;
+        this.extra = {};
+        this.includes = [];
+        this.searchTerm = undefined;
+        this.sorts = [];
+        this.distinctFields = [];
+        this.pagination = undefined;
+        this.notify();
+        return this;
+    }
+    /**
+     * Adds an OR group. Conditions inside the callback are OR-ed together.
+     *
+     * @example
+     * filterQuery()
+     *   .where('status', 'active')
+     *   .or(q => q
+     *     .where('name', 'contains', 'sync')
+     *     .where('email', 'contains', 'sync')
+     *   )
+     */
+    or(fn) {
+        const sub = new FilterQueryBuilder();
+        fn(sub);
+        this.groups.push({ type: 'OR', conditions: sub.conditions });
+        this.notify();
+        return this;
+    }
+    /**
+     * Adds an AND group. Conditions inside the callback are AND-ed together.
+     *
+     * @example
+     * filterQuery()
+     *   .and(q => q
+     *     .where('age', 'gte', 18)
+     *     .where('age', 'lte', 65)
+     *   )
+     */
+    and(fn) {
+        const sub = new FilterQueryBuilder();
+        fn(sub);
+        this.groups.push({ type: 'AND', conditions: sub.conditions });
+        this.notify();
+        return this;
+    }
+    // ─── Convenience methods ─────────────────────────────────────────────────
+    equals(field, value) {
+        return this.where(field, 'equals', value);
+    }
+    notEquals(field, value) {
+        return this.where(field, 'notEquals', value);
+    }
+    contains(field, value) {
+        return this.where(field, 'contains', value);
+    }
+    in(field, values) {
+        return this.where(field, 'in', values);
+    }
+    notIn(field, values) {
+        return this.where(field, 'notIn', values);
+    }
+    between(field, low, high) {
+        return this.where(field, 'between', [low, high]);
+    }
+    gt(field, value) {
+        return this.where(field, 'gt', value);
+    }
+    gte(field, value) {
+        return this.where(field, 'gte', value);
+    }
+    lt(field, value) {
+        return this.where(field, 'lt', value);
+    }
+    lte(field, value) {
+        return this.where(field, 'lte', value);
+    }
+    isNull(field) {
+        return this.where(field, 'isNull');
+    }
+    isNotNull(field) {
+        return this.where(field, 'isNotNull');
+    }
+    isEmpty(field) {
+        return this.where(field, 'isEmpty');
+    }
+    isNotEmpty(field) {
+        return this.where(field, 'isNotEmpty');
+    }
+    startsWith(field, value) {
+        return this.where(field, 'startsWith', value);
+    }
+    endsWith(field, value) {
+        return this.where(field, 'endsWith', value);
+    }
+    // ─── Range helpers (use add — accumulate) ───────────────────────────────
+    /**
+     * Adds a `gte` filter using `add()` (accumulating).
+     * Useful for range queries where you also need an `lte` on the same field.
+     */
+    addGte(field, value) {
+        return this.add(field, 'gte', value);
+    }
+    /**
+     * Adds a `lte` filter using `add()` (accumulating).
+     * Useful for range queries where you also need a `gte` on the same field.
+     */
+    addLte(field, value) {
+        return this.add(field, 'lte', value);
+    }
+    /**
+     * Adds a `gt` filter using `add()` (accumulating).
+     */
+    addGt(field, value) {
+        return this.add(field, 'gt', value);
+    }
+    /**
+     * Adds a `lt` filter using `add()` (accumulating).
+     */
+    addLt(field, value) {
+        return this.add(field, 'lt', value);
+    }
+    // ─── Extra keys ─────────────────────────────────────────────────────────
+    /**
+     * Adds an extra key/value pair to the query result (e.g. page, size).
+     *
+     * @example
+     * filterQuery()
+     *   .where('status', 'active')
+     *   .set('page', 1)
+     *   .set('size', 25)
+     *   .build();
+     * // → { where: [...], page: 1, size: 25 }
+     */
+    set(key, value) {
+        this.extra[key] = value;
+        this.notify();
+        return this;
+    }
+    // ─── Include & Search ────────────────────────────────────────────────────
+    /**
+     * Adds relation paths to eagerly load.
+     *
+     * @example
+     * filterQuery().include('role', 'posts').build()
+     * // → { filter: { where: [] }, include: ['role', 'posts'] }
+     */
+    include(...relations) {
+        for (const rel of relations) {
+            if (typeof rel !== 'string')
+                continue;
+            if (!this.includes.includes(rel)) {
+                this.includes.push(rel);
+            }
+        }
+        this.notify();
+        return this;
+    }
+    /**
+     * Sets the global search term.
+     *
+     * @example
+     * filterQuery().search('fleet').build()
+     * // → { filter: { where: [] }, search: 'fleet' }
+     */
+    search(term) {
+        if (typeof term !== 'string')
+            return this;
+        this.searchTerm = term;
+        this.notify();
+        return this;
+    }
+    /**
+     * Selects DISTINCT values of the given field(s) — the active where/search/
+     * sort/pagination still apply. Useful for populating a filter dropdown with
+     * the distinct values of a column. Repeated fields are deduplicated.
+     *
+     * @example
+     * filterQuery().where('baseId', 'b1').distinct('afsc').page(0, 20).build()
+     * // → { filter: { where: [...] }, distinct: ['afsc'], paginate: { page: 0, size: 20 } }
+     */
+    distinct(...fields) {
+        for (const field of fields) {
+            if (typeof field !== 'string')
+                continue;
+            if (!this.distinctFields.includes(field)) {
+                this.distinctFields.push(field);
+            }
+        }
+        this.notify();
+        return this;
+    }
+    // ─── Sort & Pagination ──────────────────────────────────────────────────
+    /**
+     * Adds or replaces a sort directive for the given field.
+     * If a sort for the same field already exists, it is replaced.
+     *
+     * @example
+     * filterQuery().sort('createdAt', 'desc').sort('name').build()
+     * // → { ..., sort: [{ field: 'createdAt', direction: 'desc' }, { field: 'name', direction: 'asc' }] }
+     */
+    sort(field, direction = 'asc') {
+        this.sorts = this.sorts.filter((s) => s.field !== field);
+        this.sorts.push({ field, direction });
+        this.notify();
+        return this;
+    }
+    /**
+     * Shorthand for `sort(field, 'desc')`.
+     */
+    sortDesc(field) {
+        return this.sort(field, 'desc');
+    }
+    /**
+     * Shorthand for `sort(field, 'asc')`.
+     */
+    sortAsc(field) {
+        return this.sort(field, 'asc');
+    }
+    /**
+     * Sets offset-based pagination.
+     *
+     * @param page - Zero-based page number.
+     * @param size - Number of records per page (default 25).
+     *
+     * @example
+     * filterQuery().page(0, 25).build()
+     * // → { ..., paginate: { page: 0, size: 25 } }
+     */
+    page(page, size = 25) {
+        this.pagination = { page, size };
+        this.notify();
+        return this;
+    }
+    // ─── Reactivity ───────────────────────────────────────────────────────────
+    /**
+     * Bumps the version, invalidates the cached snapshot, and notifies every
+     * subscriber. Called internally by every mutating method. Convenience
+     * methods (`equals`, `sortAsc`, `addGte`, …) delegate to a primitive
+     * mutator, so they notify transitively — never call `notify()` from them.
+     */
+    notify() {
+        this.version++;
+        this.snapshot = null;
+        for (const listener of this.listeners) {
+            listener();
+        }
+    }
+    /**
+     * Subscribes to mutations. Returns an unsubscribe function.
+     *
+     * Bound so it can be passed directly to `useSyncExternalStore` /
+     * Svelte's store contract without wrapping in an arrow.
+     *
+     * @example
+     * const unsubscribe = qb.subscribe(() => rerender());
+     */
+    subscribe = (listener) => {
+        this.listeners.add(listener);
+        return () => {
+            this.listeners.delete(listener);
+        };
+    };
+    /**
+     * Returns the current built result, cached until the next mutation.
+     *
+     * The reference is stable across calls while the builder is unchanged, which
+     * is what `useSyncExternalStore` requires to avoid infinite render loops.
+     *
+     * Bound for the same reason as `subscribe`.
+     */
+    getSnapshot = () => {
+        if (this.snapshot === null) {
+            this.snapshot = this.build();
+        }
+        return this.snapshot;
+    };
+    /**
+     * Monotonic mutation counter. Useful as a cheap dependency/key for adapters
+     * that prefer an integer over reference comparison.
+     */
+    getVersion() {
+        return this.version;
+    }
+    // ─── Build ──────────────────────────────────────────────────────────────
+    /**
+     * Builds the query as a `FilterQueryResult` object.
+     *
+     * Returns the structured format: `{ filter: { where: [...] }, include: [...], search: '...' }`
+     */
+    build() {
+        const filters = [];
+        for (const cond of this.conditions) {
+            filters.push({
+                field: cond.field,
+                operator: cond.operator,
+                value: cond.value,
+            });
+        }
+        for (const group of this.groups) {
+            const groupFilters = group.conditions.map((c) => ({
+                field: c.field,
+                operator: c.operator,
+                value: c.value,
+            }));
+            if (group.type === 'OR') {
+                filters.push({
+                    field: '',
+                    operator: 'equals',
+                    value: undefined,
+                    OR: groupFilters,
+                });
+            }
+            else {
+                filters.push({
+                    field: '',
+                    operator: 'equals',
+                    value: undefined,
+                    AND: groupFilters,
+                });
+            }
+        }
+        const result = {
+            ...this.extra,
+            filter: { where: filters },
+        };
+        if (this.includes.length > 0) {
+            result.include = [...this.includes];
+        }
+        if (this.searchTerm !== undefined) {
+            result.search = this.searchTerm;
+        }
+        if (this.sorts.length > 0) {
+            result.sort = [...this.sorts];
+        }
+        if (this.distinctFields.length > 0) {
+            result.distinct = [...this.distinctFields];
+        }
+        if (this.pagination !== undefined) {
+            result.paginate = { ...this.pagination };
+        }
+        return result;
+    }
+    /**
+     * Serializes to a query string suitable for GET requests.
+     *
+     * Uses the structured format:
+     * - Simple conditions → `filter[field]=value&filter[field][op]=value`
+     * - OR/AND groups → `filter[where][i][field]=...`
+     * - Includes → `include=role,posts`
+     * - Search → `search=term`
+     */
+    toQueryString() {
+        const parts = [];
+        // Build filter portion
+        let filterQs;
+        if (this.groups.length === 0) {
+            const flat = this.toFlatObject();
+            filterQs = flatObjectToQueryString(Object.fromEntries(Object.entries(flat).map(([k, v]) => [`filter[${k}]`, v])));
+        }
+        else {
+            filterQs = columnFiltersToQueryString(this.build().filter.where);
+        }
+        if (filterQs)
+            parts.push(filterQs);
+        // Build include
+        if (this.includes.length > 0) {
+            parts.push(`include=${encodeURIComponent(this.includes.join(','))}`);
+        }
+        // Build search
+        if (this.searchTerm !== undefined) {
+            parts.push(`search=${encodeURIComponent(this.searchTerm)}`);
+        }
+        // Build sort
+        if (this.sorts.length > 0) {
+            const sortStr = this.sorts
+                .map((s) => (s.direction === 'desc' ? `-${s.field}` : s.field))
+                .join(',');
+            parts.push(`sort=${encodeURIComponent(sortStr)}`);
+        }
+        // Build distinct
+        if (this.distinctFields.length > 0) {
+            parts.push(`distinct=${encodeURIComponent(this.distinctFields.join(','))}`);
+        }
+        // Build pagination
+        if (this.pagination !== undefined) {
+            parts.push(`page=${encodeURIComponent(String(this.pagination.page))}`);
+            parts.push(`size=${encodeURIComponent(String(this.pagination.size))}`);
+        }
+        // Build extra keys
+        const extraQs = flatObjectToQueryString(this.extra);
+        if (extraQs)
+            parts.push(extraQs);
+        return parts.join('&');
+    }
+    /**
+     * Converts to a flat object suitable for auto-fields.
+     *
+     * Simple equals → `{ field: value }`
+     * Array (in) → `{ field: [values] }`
+     * Other operators → `{ field: { operator: value } }`
+     * Multiple operators on same field → merged into one object.
+     *
+     * Note: OR/AND groups are NOT representable as flat objects.
+     * Use `build()` for complex queries.
+     */
+    toFlatObject() {
+        const result = {};
+        for (const cond of this.conditions) {
+            if (cond.operator === 'equals') {
+                result[cond.field] = cond.value;
+            }
+            else if (cond.operator === 'in') {
+                result[cond.field] = cond.value;
+            }
+            else {
+                // Operator → bracket notation object
+                const existing = result[cond.field];
+                if (existing != null && typeof existing === 'object' && !Array.isArray(existing)) {
+                    // Merge operators on same field
+                    existing[cond.operator] = cond.value;
+                }
+                else {
+                    result[cond.field] = { [cond.operator]: cond.value };
+                }
+            }
+        }
+        return result;
+    }
+}
+/**
+ * Creates a new FilterQueryBuilder instance.
+ *
+ * @example
+ * import { filterQuery } from '@adonis-agora/filter-client';
+ *
+ * const q = filterQuery()
+ *   .where('name', 'contains', 'fleet')
+ *   .where('status', ['COMPLETED', 'FAILED'])
+ *   .build();
+ */
+export function filterQuery() {
+    return new FilterQueryBuilder();
+}
+//# sourceMappingURL=filter-query-builder.js.map

package/dist/filter-query-builder.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { FilterQueryBuilder, filterQuery } from './filter-query-builder.js';
+export type { FilterQueryResult, SortItem, OffsetPagination } from './filter-query-builder.js';
+export { flatObjectToQueryString, columnFiltersToQueryString } from './to-query-string.js';
+export type { ColumnFilter, FilterOperator } from './types.js';
+export { FILTER_OPERATORS } from './types.js';
+export { validateOperatorValue, validateAddOperator, RANGE_OPERATORS, } from './validate-operator-value.js';
+export type { FieldTypeKind, FilterFieldTypes, ValueAt, Base, OperatorsFor, ValueForOp, StringFieldsOf, OrderableFieldsOf, } from './field-types.js';
+export type { TypedFilterQuery } from './typed-filter-query.js';
+export type { TypedFilterQueryBuilder } from './typed-filter-query-builder.js';
+export { filterQueryTyped } from './typed-filter-query-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAC3F,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,OAAO,EACP,IAAI,EACJ,YAAY,EACZ,UAAU,EACV,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { FilterQueryBuilder, filterQuery } from './filter-query-builder.js';
+export { flatObjectToQueryString, columnFiltersToQueryString } from './to-query-string.js';
+export { FILTER_OPERATORS } from './types.js';
+export { validateOperatorValue, validateAddOperator, RANGE_OPERATORS, } from './validate-operator-value.js';
+export { filterQueryTyped } from './typed-filter-query-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAE3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,GAChB,MAAM,8BAA8B,CAAC;AAatC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/tanstack.d.ts

@@ -0,0 +1,58 @@
+import type { ColumnFiltersState, PaginationState, SortingState } from '@tanstack/table-core';
+import { FilterQueryBuilder } from './filter-query-builder.js';
+import type { FilterQueryResult } from './filter-query-builder.js';
+import type { FilterOperator } from './types.js';
+/**
+ * Resolves the @agora/filter operator for a vanilla TanStack column filter.
+ *
+ * Vanilla TanStack column filters are `{ id, value }` with **no operator** —
+ * the operator lives in the column's `filterFn`. @agora/filter needs one, so
+ * this is the seam: supply your own to read `column.meta`, map a symbol
+ * vocabulary, etc.
+ */
+export type ResolveOperator = (columnId: string, value: unknown) => FilterOperator;
+export interface TanstackTableStateOptions {
+    /** Vanilla TanStack `ColumnFiltersState` — `{ id, value }[]`. */
+    columnFilters?: ColumnFiltersState;
+    /** Vanilla TanStack `SortingState` — `{ id, desc }[]`. */
+    sorting?: SortingState;
+    /** Vanilla TanStack `PaginationState` — `{ pageIndex (0-based), pageSize }`. */
+    pagination?: PaginationState;
+    /**
+     * Maps each column filter to an operator. Defaults to: array → `in`,
+     * string → `iContains` (mirrors TanStack's `auto` substring filtering),
+     * everything else → `equals`.
+     */
+    resolveOperator?: ResolveOperator;
+    /** Optional allowlist; filters/sorts whose column id isn't here are dropped. */
+    fields?: Iterable<string>;
+}
+/**
+ * Applies vanilla TanStack Table state (column filters, sorting, pagination)
+ * onto an existing `FilterQueryBuilder`, then returns the same builder so you
+ * can chain `include`/`search`/extra `where` calls before `build()`.
+ *
+ * Framework-agnostic — works with any TanStack Table adapter (React, Vue,
+ * Svelte, Solid). `@tanstack/table-core` is a types-only peer.
+ *
+ * @example
+ * import { filterQuery } from '@adonis-agora/filter-client';
+ * import { applyTanstackTableState } from '@adonis-agora/filter-client/tanstack';
+ *
+ * const body = applyTanstackTableState(filterQuery(), {
+ *   columnFilters: table.getState().columnFilters,
+ *   sorting: table.getState().sorting,
+ *   pagination: table.getState().pagination,
+ *   resolveOperator: (id) => (id === 'createdAt' ? 'gte' : 'iContains'),
+ * })
+ *   .include('author')
+ *   .build();
+ */
+export declare function applyTanstackTableState(builder: FilterQueryBuilder, options?: TanstackTableStateOptions): FilterQueryBuilder;
+/**
+ * One-shot convenience: builds a `FilterQueryResult` straight from vanilla
+ * TanStack Table state. Equivalent to
+ * `applyTanstackTableState(filterQuery(), options).build()`.
+ */
+export declare function tanstackTableToFilterQuery(options?: TanstackTableStateOptions): FilterQueryResult;
+//# sourceMappingURL=tanstack.d.ts.map

package/dist/tanstack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.d.ts","sourceRoot":"","sources":["../src/tanstack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAC9F,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,cAAc,CAAC;AAEnF,MAAM,WAAW,yBAAyB;IACxC,iEAAiE;IACjE,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,gFAAgF;IAChF,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gFAAgF;IAChF,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC3B;AAQD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,GAAE,yBAA8B,GACtC,kBAAkB,CA0BpB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,yBAA8B,GACtC,iBAAiB,CAEnB"}