@elaraai/e3-ui 1.0.84 → 1.0.85

package/dist/src/query/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/query/builder.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAgF,CAAC;AAMnH;;;;;;;GAOG;AACH,MAAM,WAAW,mBAAmB;IAChC,wGAAwG;IACxG,OAAO,EAAE,aAAa,CAAC;IACvB;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAChD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACvC,yIAAyI;IACzI,EAAE,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,QAAQ,CAAC,eAAe,CAAC,CAO9E;AAMD;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,OAAO,aAAa,CAAC,CAA6B,CAAC"}

package/dist/src/query/builder.js

@@ -0,0 +1,126 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Query.Builder>` (#935) — the query builder as one component: the open
+ * query's steps, or its jq, in a pane beside its results, under one toolbar.
+ *
+ * The builder is an interface — the saved queries record bound with its
+ * patch, the data sources it may read, and its name — which the
+ * `QueryBuilder` renderer draws. Its only data sources are the bindings it is
+ * handed: a query over the page reads exactly those, by the page's names.
+ * `<Query.Library>` opens queries in it, shared by `id`.
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, OptionType, StringType, StructType, none, some, } from "@elaraai/east";
+import { EastUI, optionsTag, } from "@elaraai/east-ui/internal";
+import { DataSourceType, dataSources } from "../bind/sources.js";
+import { QueriesHandleType } from "./queries.js";
+// ============================================================================
+// The builder's shared keys
+// ============================================================================
+/**
+ * The names a query builder shares, by its `id`: the UI store key of the
+ * query open in it — which the query library writes when it opens a query —
+ * the key of this viewer's recent runs, and the drag-source id of the query
+ * library's cards.
+ *
+ * @remarks
+ * A builder and a query library with the same `id` open one query together,
+ * as Studio's builder and page library open one page (`builderKeys`).
+ *
+ * @param id - The builder's name, when a surface holds more than one; omitted, the one builder
+ * @returns The keys and the id
+ */
+export function queryKeys(id) {
+    const suffix = id === undefined ? "" : `.${id}`;
+    return {
+        query: `query.builder${suffix}.query`,
+        recent: `query.builder${suffix}.recent`,
+        library: `query.library${suffix}`,
+    };
+}
+// ============================================================================
+// The renderer's payload
+// ============================================================================
+/**
+ * The `QueryBuilder` renderer's payload — the builder's interface.
+ *
+ * @property queries - The saved queries record, bound with its patch — what the builder reads, and saves through
+ * @property datasets - The data sources a query may read, by the names it reads them
+ * @property query - The saved query the builder opens first, by name; none, a new query on the first data source
+ * @property id - Names the builder, when a surface holds two — and the query library that opens queries in it
+ */
+export const QueryBuilderPayloadType = StructType({
+    queries: QueriesHandleType,
+    datasets: ArrayType(DataSourceType),
+    query: OptionType(StringType),
+    id: OptionType(StringType),
+});
+/**
+ * Internal {@link EastUI.component} carrier. The React renderer registers
+ * against this in `@elaraai/e3-ui-components` via `implementUIComponent`.
+ */
+export const QueryBuilderComponent = EastUI.component("QueryBuilder", QueryBuilderPayloadType, { optional: true });
+/**
+ * The query builder: the open query's steps in plain words, or its jq, checked
+ * as they are edited, and run to read the result.
+ *
+ * @remarks
+ * - **The data sources** are the bindings it is handed, by their names: a
+ *   query over `datasets={{ orders, customers }}` reads `.orders` and
+ *   `.customers`, and nothing else. They are in the surface's manifest
+ *   already, so the builder declares nothing of its own. A large dataset bound
+ *   with `Data.bindPaged` is never downloaded whole: a query runs on e3.
+ * - **The pane**, before the results, has the tabs Query — the steps or the
+ *   jq — Datasets and Library.
+ * - **Every edit is a draft** of the shared editing session, one per open
+ *   query, which the history item in the one toolbar undoes, redoes and
+ *   discards; Apply saves the open query as one patch commit on the record. A
+ *   query saves only once it checks.
+ *
+ * The builder fills its parent's height and draws no border around itself.
+ * It opens `query`, a saved query, when one is named, else a new query on the
+ * first data source. The query open in it is shared by `id` with a
+ * `<Query.Library>`, which opens queries in it.
+ *
+ * @param options - The bound record, the data sources, the query it opens first and the builder's name ({@link QueryBuilderOptions})
+ * @returns An East expression of type `UIComponentType`
+ * @throws {Error} When `datasets` is empty, or a name is not a jq identifier
+ *
+ * @example
+ * ```tsx
+ * import { East } from "@elaraai/east";
+ * import { Reactive, UIComponentType } from "@elaraai/east-ui";
+ * import { Data, Query, Record, ui } from "@elaraai/e3-ui";
+ *
+ * // The builder, for operators: it queries the data sources it is handed, and saves through the record.
+ * export const builder = ui("query_builder", [], East.function([], UIComponentType, _$ => (
+ *     <Reactive>{$ => {
+ *         const orders    = $.let(Data.bindPaged(d.orders));
+ *         const customers = $.let(Data.bind(d.customers));
+ *         const saved     = $.let(Record.bind(d.queries, [d.queriesPatch]));
+ *         return <Query.Builder queries={saved} datasets={{ orders, customers }} query="Top shipped orders, 2026" />;
+ *     }}</Reactive>
+ * )));
+ * ```
+ */
+function createBuilder(options) {
+    return QueryBuilderComponent.Root({
+        queries: { read: options.queries.read, history: options.queries.history, commit: { patch: options.queries.commit.patch } },
+        datasets: dataSources("Query.Builder", options.datasets),
+        query: options.query === undefined ? none : some(options.query),
+        id: options.id === undefined ? none : some(options.id),
+    });
+}
+// ============================================================================
+// Tag
+// ============================================================================
+/**
+ * `<Query.Builder>` — the query builder: the open query's steps or its jq,
+ * checked as they are edited, beside its results. See {@link createBuilder}.
+ */
+export const QueryBuilder = optionsTag(createBuilder);
+//# sourceMappingURL=builder.js.map

package/dist/src/query/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/query/builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AAEH,OAAO,EACH,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,IAAI,EACJ,IAAI,GAGP,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,MAAM,EACN,UAAU,GAIb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAoB,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAsB,MAAM,cAAc,CAAC;AAErE,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,SAAS,CAAC,EAAsB;IAQ5C,MAAM,MAAM,GAAG,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAChD,OAAO;QACH,KAAK,EAAE,gBAAgB,MAAM,QAAQ;QACrC,MAAM,EAAE,gBAAgB,MAAM,SAAS;QACvC,OAAO,EAAE,gBAAgB,MAAM,EAAE;KACpC,CAAC;AACN,CAAC;AAED,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC;IAC9C,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,SAAS,CAAC,cAAc,CAAC;IACnC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC;IAC7B,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;CAC7B,CAAC,CAAC;AAKH;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,uBAAuB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AAkCnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,SAAS,aAAa,CAAC,OAA4B;IAC/C,OAAO,qBAAqB,CAAC,IAAI,CAAC;QAC9B,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE;QAC1H,QAAQ,EAAE,WAAW,CAAC,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC;QACxD,KAAK,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QAC/D,EAAE,EAAE,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;KACzD,CAAC,CAAC;AACP,CAAC;AAED,+EAA+E;AAC/E,MAAM;AACN,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAA+C,UAAU,CAAC,aAAa,CAAC,CAAC"}

package/dist/src/query/index.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The query builder (#875) — typed jq queries over the datasets a page binds,
+ * built as steps in plain words or written as jq, and saved as one record.
+ *
+ * @packageDocumentation
+ */
+import { DataSourceType } from "../bind/sources.js";
+import { nameWriteRefusal } from "../studio/library.js";
+import { QueryBuilder, QueryBuilderComponent, QueryBuilderPayloadType } from "./builder.js";
+import { QueryLibrary, QueryLibraryComponent, QueryLibraryPayloadType } from "./library.js";
+import { QueriesHandleType, QueryRootBoundType, rootBound, saveQuery } from "./queries.js";
+import { savedQueriesValue } from "./saved.js";
+import { QueryAggregateType, QueryComparisonType, QueryConditionType, QueryMatchType, QueryStepInputType, QueryStepType, QueryStepValueType, QueryStepsType } from "./steps.js";
+import { QueryInputType, QueryResultType, QueryRootEntryType, SavedQueriesType, SavedQueryType } from "./types.js";
+export { QueryAggregateFunctionType, QueryAggregateType, QueryComparisonType, QueryConditionType, QueryDatePartType, QueryGroupByType, QueryMatchType, QueryPickFieldType, QuerySortDirectionType, QueryStepInputType, QueryStepType, QueryStepValueType, QueryStepsType, } from "./steps.js";
+export { QueryInputType, QueryResultType, QueryRootEntryType, SavedQueriesType, SavedQueryType, } from "./types.js";
+export { QueriesHandleType, QueryRootBoundType, SavedQueriesPatchType, rootBound, saveQuery, type QueriesHandle, } from "./queries.js";
+export { savedQueriesValue, type SavedQueryInput } from "./saved.js";
+export { QueryBuilder, QueryBuilderComponent, QueryBuilderPayloadType, queryKeys, type QueryBuilderOptions, } from "./builder.js";
+export { QueryLibrary, QueryLibraryComponent, QueryLibraryPayloadType, type QueryLibraryOptions, } from "./library.js";
+/** The query builder's East types — what a solution declares its saved queries record with. */
+export interface QueryTypes {
+    /** The saved queries record's type — every saved query, by name ({@link SavedQueriesType}). */
+    Saved: typeof SavedQueriesType;
+    /** A saved query ({@link SavedQueryType}). */
+    SavedQuery: typeof SavedQueryType;
+    /** A data source a query may read, as the builder is handed it ({@link DataSourceType}). */
+    DataSource: typeof DataSourceType;
+    /** A data source of a query's root: its name and its dataset's path ({@link QueryRootEntryType}). */
+    RootEntry: typeof QueryRootEntryType;
+    /** A dataset a run read, pinned at its hash ({@link QueryInputType}). */
+    Input: typeof QueryInputType;
+    /** What a run of a query answered ({@link QueryResultType}). */
+    Result: typeof QueryResultType;
+    /** A query as steps: its data source and its steps ({@link QueryStepsType}). */
+    Steps: typeof QueryStepsType;
+    /** One step of a query ({@link QueryStepType}). */
+    Step: typeof QueryStepType;
+    /** A condition of a Keep rows where step ({@link QueryConditionType}). */
+    Condition: typeof QueryConditionType;
+    /** How a condition compares a field ({@link QueryComparisonType}). */
+    Comparison: typeof QueryComparisonType;
+    /** How conditions combine ({@link QueryMatchType}). */
+    Match: typeof QueryMatchType;
+    /** One total of a Group and total step ({@link QueryAggregateType}). */
+    Aggregate: typeof QueryAggregateType;
+    /** A value a step compares with or fills in ({@link QueryStepValueType}). */
+    StepValue: typeof QueryStepValueType;
+    /** A count or a bound a step takes ({@link QueryStepInputType}). */
+    StepInput: typeof QueryStepInputType;
+}
+/** The type of the {@link Query} namespace — what a solution mounts and declares. */
+export interface QueryNamespace {
+    /** `<Query.Builder>` — the query builder: the open query's steps or its jq, beside its results. */
+    Builder: typeof QueryBuilder;
+    /** `<Query.Library>` — every saved query, as a gallery of wireframes, and where new queries start. */
+    Library: typeof QueryLibrary;
+    /** The saved queries record's value: the queries a solution ships in it, by name, each checked against the data sources it may read ({@link savedQueriesValue}). */
+    value: typeof savedQueriesValue;
+    /** The query builder's East types. */
+    Types: QueryTypes;
+}
+/**
+ * The query builder and the query library — the components a solution mounts
+ * (`<Query.Builder>`, `<Query.Library>`), and the East types it declares its
+ * saved queries record with (`Query.Types`), and its value, the queries it
+ * ships in it (`Query.value`).
+ */
+export declare const Query: QueryNamespace;
+/**
+ * The type of the internal query namespace — the public one, the East behind
+ * the builder's reads and writes, and the carriers.
+ */
+export interface QueryInternalNamespace extends Omit<QueryNamespace, "Types"> {
+    /** Saves a query — the patch of the entries it writes ({@link saveQuery}). */
+    save: typeof saveQuery;
+    /** What refused a write under a new name — a save of a query never saved, or under another name. */
+    nameWriteRefusal: typeof nameWriteRefusal;
+    /** Whether a saved query's data sources are bound where it would open, and if not, why not ({@link rootBound}). */
+    rootBound: typeof rootBound;
+    /** The `QueryBuilder` carrier ({@link QueryBuilderComponent}). */
+    BuilderComponent: typeof QueryBuilderComponent;
+    /** The `QueryLibrary` carrier ({@link QueryLibraryComponent}). */
+    LibraryComponent: typeof QueryLibraryComponent;
+    /** The query builder's East types, and those of the bound record, the builder's and the library's payloads and a root's binding. */
+    Types: QueryTypes & {
+        /** The saved queries record, bound with its patch ({@link QueriesHandleType}). */
+        Handle: typeof QueriesHandleType;
+        /** The `QueryBuilder` renderer's payload ({@link QueryBuilderPayloadType}). */
+        BuilderPayload: typeof QueryBuilderPayloadType;
+        /** The `QueryLibrary` renderer's payload ({@link QueryLibraryPayloadType}). */
+        LibraryPayload: typeof QueryLibraryPayloadType;
+        /** Whether a saved query's data sources are bound ({@link QueryRootBoundType}). */
+        RootBound: typeof QueryRootBoundType;
+    };
+}
+/**
+ * The internal query namespace — `@elaraai/e3-ui/internal`'s `Query`: the
+ * public namespace, and the East the renderers and the tests call.
+ *
+ * @internal
+ */
+export declare const QueryInternal: QueryInternalNamespace;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/query/index.d.ts.map

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

package/dist/src/query/index.js

@@ -0,0 +1,76 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The query builder (#875) — typed jq queries over the datasets a page binds,
+ * built as steps in plain words or written as jq, and saved as one record.
+ *
+ * @packageDocumentation
+ */
+import { DataSourceType } from "../bind/sources.js";
+import { nameWriteRefusal } from "../studio/library.js";
+import { QueryBuilder, QueryBuilderComponent, QueryBuilderPayloadType } from "./builder.js";
+import { QueryLibrary, QueryLibraryComponent, QueryLibraryPayloadType } from "./library.js";
+import { QueriesHandleType, QueryRootBoundType, rootBound, saveQuery } from "./queries.js";
+import { savedQueriesValue } from "./saved.js";
+import { QueryAggregateType, QueryComparisonType, QueryConditionType, QueryMatchType, QueryStepInputType, QueryStepType, QueryStepValueType, QueryStepsType, } from "./steps.js";
+import { QueryInputType, QueryResultType, QueryRootEntryType, SavedQueriesType, SavedQueryType } from "./types.js";
+export { QueryAggregateFunctionType, QueryAggregateType, QueryComparisonType, QueryConditionType, QueryDatePartType, QueryGroupByType, QueryMatchType, QueryPickFieldType, QuerySortDirectionType, QueryStepInputType, QueryStepType, QueryStepValueType, QueryStepsType, } from "./steps.js";
+export { QueryInputType, QueryResultType, QueryRootEntryType, SavedQueriesType, SavedQueryType, } from "./types.js";
+export { QueriesHandleType, QueryRootBoundType, SavedQueriesPatchType, rootBound, saveQuery, } from "./queries.js";
+export { savedQueriesValue } from "./saved.js";
+export { QueryBuilder, QueryBuilderComponent, QueryBuilderPayloadType, queryKeys, } from "./builder.js";
+export { QueryLibrary, QueryLibraryComponent, QueryLibraryPayloadType, } from "./library.js";
+const types = {
+    Saved: SavedQueriesType,
+    SavedQuery: SavedQueryType,
+    DataSource: DataSourceType,
+    RootEntry: QueryRootEntryType,
+    Input: QueryInputType,
+    Result: QueryResultType,
+    Steps: QueryStepsType,
+    Step: QueryStepType,
+    Condition: QueryConditionType,
+    Comparison: QueryComparisonType,
+    Match: QueryMatchType,
+    Aggregate: QueryAggregateType,
+    StepValue: QueryStepValueType,
+    StepInput: QueryStepInputType,
+};
+/**
+ * The query builder and the query library — the components a solution mounts
+ * (`<Query.Builder>`, `<Query.Library>`), and the East types it declares its
+ * saved queries record with (`Query.Types`), and its value, the queries it
+ * ships in it (`Query.value`).
+ */
+export const Query = {
+    Builder: QueryBuilder,
+    Library: QueryLibrary,
+    value: savedQueriesValue,
+    Types: types,
+};
+/**
+ * The internal query namespace — `@elaraai/e3-ui/internal`'s `Query`: the
+ * public namespace, and the East the renderers and the tests call.
+ *
+ * @internal
+ */
+export const QueryInternal = {
+    Builder: QueryBuilder,
+    Library: QueryLibrary,
+    value: savedQueriesValue,
+    save: saveQuery,
+    nameWriteRefusal,
+    rootBound,
+    BuilderComponent: QueryBuilderComponent,
+    LibraryComponent: QueryLibraryComponent,
+    Types: {
+        ...types,
+        Handle: QueriesHandleType,
+        BuilderPayload: QueryBuilderPayloadType,
+        LibraryPayload: QueryLibraryPayloadType,
+        RootBound: QueryRootBoundType,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/query/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/query/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACH,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,cAAc,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEnH,OAAO,EACH,0BAA0B,EAC1B,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,cAAc,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,SAAS,EACT,SAAS,GAEZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAwB,MAAM,YAAY,CAAC;AACrE,OAAO,EACH,YAAY,EACZ,qBAAqB,EACrB,uBAAuB,EACvB,SAAS,GAEZ,MAAM,cAAc,CAAC;AACtB,OAAO,EACH,YAAY,EACZ,qBAAqB,EACrB,uBAAuB,GAE1B,MAAM,cAAc,CAAC;AA8CtB,MAAM,KAAK,GAAe;IACtB,KAAK,EAAE,gBAAgB;IACvB,UAAU,EAAE,cAAc;IAC1B,UAAU,EAAE,cAAc;IAC1B,SAAS,EAAE,kBAAkB;IAC7B,KAAK,EAAE,cAAc;IACrB,MAAM,EAAE,eAAe;IACvB,KAAK,EAAE,cAAc;IACrB,IAAI,EAAE,aAAa;IACnB,SAAS,EAAE,kBAAkB;IAC7B,UAAU,EAAE,mBAAmB;IAC/B,KAAK,EAAE,cAAc;IACrB,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,kBAAkB;IAC7B,SAAS,EAAE,kBAAkB;CAChC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,KAAK,GAAmB;IACjC,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,iBAAiB;IACxB,KAAK,EAAE,KAAK;CACf,CAAC;AA8BF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACjD,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,iBAAiB;IACxB,IAAI,EAAE,SAAS;IACf,gBAAgB;IAChB,SAAS;IACT,gBAAgB,EAAE,qBAAqB;IACvC,gBAAgB,EAAE,qBAAqB;IACvC,KAAK,EAAE;QACH,GAAG,KAAK;QACR,MAAM,EAAE,iBAAiB;QACzB,cAAc,EAAE,uBAAuB;QACvC,cAAc,EAAE,uBAAuB;QACvC,SAAS,EAAE,kBAAkB;KAChC;CACJ,CAAC"}