@elaraai/e3-ui 1.0.84 → 1.0.86

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

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

package/dist/src/query/library.js

@@ -0,0 +1,114 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `<Query.Library>` (#1063) — every saved query, and where new queries start,
+ * set out as Studio's page library is.
+ *
+ * The query library is a component of its own, apart from the builder: an
+ * interface — the saved queries record bound with its patch, the data sources
+ * a query may read, the builder it opens queries in, and who to tell — which
+ * the `QueryLibrary` renderer draws, headerless with one toolbar: the search,
+ * Sort, Grid · List and the primary "+ New query on <data source>"; beside it
+ * the data sources with their counts of saved queries, and this viewer's
+ * recent runs; under it the saved queries, each card a wireframe of its steps.
+ * It reads no dataset: a card draws a query, never its data.
+ *
+ * "Open in builder →" opens a query in the builder: it writes the builder's
+ * open query ({@link queryKeys}) and tells the host.
+ *
+ * @packageDocumentation
+ */
+import { ArrayType, FunctionType, NullType, 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";
+// ============================================================================
+// Types
+// ============================================================================
+/**
+ * The `QueryLibrary` renderer's payload — the query library's interface.
+ *
+ * @property queries - The saved queries record, bound with its patch — what it reads
+ * @property datasets - The data sources a query may read, by the names it reads them
+ * @property id - Names the builder whose open query it writes; `none` for the one builder
+ * @property onOpen - Told a query's name when it opens one in the builder — the host shows the builder
+ */
+export const QueryLibraryPayloadType = StructType({
+    queries: QueriesHandleType,
+    datasets: ArrayType(DataSourceType),
+    id: OptionType(StringType),
+    onOpen: OptionType(FunctionType([StringType], NullType)),
+});
+// ============================================================================
+// The renderer's carrier
+// ============================================================================
+/**
+ * Internal {@link EastUI.component} carrier. The React renderer registers
+ * against this in `@elaraai/e3-ui-components` via `implementUIComponent`.
+ */
+export const QueryLibraryComponent = EastUI.component("QueryLibrary", QueryLibraryPayloadType, { optional: true });
+/**
+ * Every saved query, and where new queries start.
+ *
+ * @remarks
+ * - **The toolbar**, one row: the search "Search N queries…", over names,
+ *   descriptions and data sources; Sort · Recent or Name; Grid · List; and
+ *   "+ New query on <data source>" — the data source the pane shows, else the
+ *   first bound — which opens a new query on it in the builder.
+ * - **The pane**: All queries, then each bound data source with its count of
+ *   the saved queries that start from it, the one shown in the brand; and, at
+ *   its foot, Recent — this viewer's runs.
+ * - **The gallery**: three across, or a row each, every card a wireframe of
+ *   the query — its source and a bar per step — with its name, its
+ *   description (the author's, else the sentence generated from its steps),
+ *   what it starts from and gives, and "Open in builder →". A card drags onto
+ *   the builder that shares `id`. A query whose data sources aren't bound
+ *   here says why, and doesn't open.
+ *
+ * The data source shown, the search, the order and the layout are the query
+ * library's own; the query it opens is the builder's, shared by `id` with a
+ * `<Query.Builder>`. The query library reads no dataset, and draws no border
+ * around itself. Its data sources are the surface's bindings, which the host
+ * loads with the surface as it loads any: bind a large one with
+ * `Data.bindPaged`, which is declared and never loaded whole.
+ *
+ * @param options - The bound record, the data sources, the builder's name and who to tell ({@link QueryLibraryOptions})
+ * @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 query library: every saved query, and where new queries start — over the builder's data sources.
+ * export const library = ui("query_library", [], 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.Library queries={saved} datasets={{ orders, customers }} />;
+ *     }}</Reactive>
+ * )));
+ * ```
+ */
+function createLibrary(options) {
+    return QueryLibraryComponent.Root({
+        queries: { read: options.queries.read, history: options.queries.history, commit: { patch: options.queries.commit.patch } },
+        datasets: dataSources("Query.Library", options.datasets),
+        id: options.id === undefined ? none : some(options.id),
+        onOpen: options.onOpen === undefined ? none : some(options.onOpen),
+    });
+}
+// ============================================================================
+// Tag
+// ============================================================================
+/**
+ * `<Query.Library>` — every saved query, and where new queries start. See
+ * {@link createLibrary}.
+ */
+export const QueryLibrary = optionsTag(createLibrary);
+//# sourceMappingURL=library.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"library.js","sourceRoot":"","sources":["../../../src/query/library.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACH,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,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,QAAQ;AACR,+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,EAAE,EAAE,UAAU,CAAC,UAAU,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,CAAC;CAC3D,CAAC,CAAC;AAKH,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,uBAAuB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;AA8BnH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;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,EAAE,EAAE,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;KACrE,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"}