queria 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 flo8s
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
+# queria
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Query and visualize [Queria](https://queria.io/) open data in the browser. SQL runs in DuckDB WASM, charts are drawn with Vega-Lite, and the sources and licenses of the datasets are shown under each chart.
+
+This package is in 0.x. Breaking changes can happen in any release until 1.0.
+
+## Datasets
+
+Declare every dataset the SQL reads by its fully qualified name (`handle/name`). In SQL, refer to it by the last part of the name, as in `e_stat.<schema>.<table>`. To read two datasets with the same name, give them aliases: `{ a: "alice/e_stat", b: "bob/e_stat" }`.
+
+## HTML
+
+```html
+<script type="module">import "queria/elements/define";</script>
+
+<queria-chart
+  datasets="queria/e_stat"
+  spec='{"mark": "line", "encoding": {"x": {"field": "year"}, "y": {"field": "population", "type": "quantitative"}}}'
+  sql="SELECT year, any_value(value) AS population FROM e_stat.ssds.a_municipal_population
+       WHERE area = '13224' AND cat01 = 'A1101' GROUP BY year ORDER BY year"></queria-chart>
+```
+
+## React
+
+```tsx
+import { Chart, QueriaProvider } from "queria/react";
+
+<QueriaProvider datasets={["queria/e_stat"]}>
+  <Chart sql={sql} spec={spec} />
+</QueriaProvider>;
+```
+
+## JavaScript
+
+```ts
+import { connect, renderChart } from "queria";
+
+const q = connect({ datasets: ["queria/e_stat"] });
+await renderChart(el, spec, await q.sql(sql));
+```
+
+SQL that calls `ST_*` functions loads the DuckDB spatial extension on first use.
+
+To read datasets that are not public, pass a data token (`qd_...`) or a function that returns one: `connect({ datasets, token })`. The token is sent to the Queria API and to the hosts of the declared datasets. DuckDB is shared by the page, so use one token per page.
+
+## Maps
+
+```html
+<queria-map datasets="queria/e_stat" sql="SELECT area AS lg_code, value AS population FROM ..."
+  layer='{"area": "city", "code": "lg_code", "color": "population", "label": "lg_code"}'></queria-map>
+```
+
+`layer` puts rows on the map by area code (`area` is `prefecture`, `city` or `small_area`, `code` is the column) or by position (`lng` and `lat` columns). `color` colors by a column: numbers from light to dark, other values one color each. `label` names a row on hover. In React, use `<DataMap sql={sql} layer={layer} />`; in JavaScript, `renderMap(el, layer, rows)`. Include maplibre-gl's CSS in the page. The map height is the CSS variable `--queria-map-height` (400px by default).
+
+Charts need `vega`, `vega-lite`, `vega-embed` and `vega-interpreter`; maps need `maplibre-gl`. Install them only when you use them.
+
+## License
+
+MIT

package/dist/boot.d.ts

@@ -0,0 +1,24 @@
+import type { AsyncDuckDB, DuckDBBundles } from "@duckdb/duckdb-wasm";
+/**
+ * Source put before the DuckDB worker script. It adds a Bearer token to the worker's XHRs, and only to
+ * the origins it was given. DuckDB WASM sends no headers of its own (neither CREATE SECRET nor
+ * EXTRA_HTTP_HEADERS reach the request in the browser), and keeping the token in a JS variable of the
+ * worker keeps it out of reach of SQL. It takes only { queriaAuth: { token, origins } } messages and
+ * does not pass them on to DuckDB.
+ */
+export declare const authPatch = "(() => {\n  let token = null;\n  let origins = [];\n  self.addEventListener(\"message\", (event) => {\n    const auth = event.data && typeof event.data === \"object\" ? event.data.queriaAuth : undefined;\n    if (auth === undefined) return;\n    event.stopImmediatePropagation();\n    token = auth && typeof auth.token === \"string\" ? auth.token : null;\n    origins = auth && Array.isArray(auth.origins) ? auth.origins.map((o) => String(o) + \"/\") : [];\n  });\n  const open = XMLHttpRequest.prototype.open;\n  XMLHttpRequest.prototype.open = function (method, url, ...rest) {\n    open.call(this, method, url, ...rest);\n    if (token !== null && origins.some((o) => String(url).startsWith(o))) {\n      this.setRequestHeader(\"Authorization\", \"Bearer \" + token);\n    }\n  };\n})();\n";
+export declare const bundlesAt: (base: string) => DuckDBBundles;
+/**
+ * Send the token to these origins from now on, as well as to the origins given before: queries run
+ * concurrently, and one that is still reading must keep its origins. A null token sends none.
+ */
+export declare const setAuth: (db: AsyncDuckDB, token: string | null, origins: readonly string[]) => void;
+/** Start DuckDB from the given WASM URL, and from jsDelivr when that fails. */
+export declare const boot: (wasm: string) => Promise<AsyncDuckDB>;
+/** Whether the SQL calls an ST_* function outside string literals and comments. */
+export declare const needsSpatial: (sql: string) => boolean;
+/** Whether the error comes from the spatial extension not being loaded. */
+export declare const isSpatialMissing: (message: string) => boolean;
+export declare const loadSpatial: (db: AsyncDuckDB) => Promise<void>;
+/** Run fn, loading spatial first when the SQL needs it, and once more after a missing-spatial error. */
+export declare const withSpatial: <T>(db: AsyncDuckDB, sql: string, fn: () => Promise<T>) => Promise<T>;

package/dist/boot.js

@@ -0,0 +1,137 @@
+import { stripLiterals } from "./sql.js";
+/**
+ * Source put before the DuckDB worker script. It adds a Bearer token to the worker's XHRs, and only to
+ * the origins it was given. DuckDB WASM sends no headers of its own (neither CREATE SECRET nor
+ * EXTRA_HTTP_HEADERS reach the request in the browser), and keeping the token in a JS variable of the
+ * worker keeps it out of reach of SQL. It takes only { queriaAuth: { token, origins } } messages and
+ * does not pass them on to DuckDB.
+ */
+export const authPatch = `(() => {
+  let token = null;
+  let origins = [];
+  self.addEventListener("message", (event) => {
+    const auth = event.data && typeof event.data === "object" ? event.data.queriaAuth : undefined;
+    if (auth === undefined) return;
+    event.stopImmediatePropagation();
+    token = auth && typeof auth.token === "string" ? auth.token : null;
+    origins = auth && Array.isArray(auth.origins) ? auth.origins.map((o) => String(o) + "/") : [];
+  });
+  const open = XMLHttpRequest.prototype.open;
+  XMLHttpRequest.prototype.open = function (method, url, ...rest) {
+    open.call(this, method, url, ...rest);
+    if (token !== null && origins.some((o) => String(url).startsWith(o))) {
+      this.setRequestHeader("Authorization", "Bearer " + token);
+    }
+  };
+})();
+`;
+export const bundlesAt = (base) => ({
+    mvp: { mainModule: `${base}/duckdb-mvp.wasm`, mainWorker: `${base}/duckdb-browser-mvp.worker.js` },
+    eh: { mainModule: `${base}/duckdb-eh.wasm`, mainWorker: `${base}/duckdb-browser-eh.worker.js` },
+});
+const workers = new WeakMap();
+const authOrigins = new WeakMap();
+/**
+ * Send the token to these origins from now on, as well as to the origins given before: queries run
+ * concurrently, and one that is still reading must keep its origins. A null token sends none.
+ */
+export const setAuth = (db, token, origins) => {
+    const all = token === null ? new Set() : new Set([...(authOrigins.get(db) ?? []), ...origins]);
+    authOrigins.set(db, all);
+    workers.get(db)?.postMessage({ queriaAuth: { token, origins: [...all] } });
+};
+const instantiate = async (bundles) => {
+    const duckdb = await import("@duckdb/duckdb-wasm");
+    const bundle = await duckdb.selectBundle(bundles);
+    if (!bundle.mainWorker)
+        throw new Error("The DuckDB bundle has no worker script");
+    // The worker lives on another origin, and a page with a strict-dynamic CSP blocks importScripts,
+    // so fetch the script and start it from a blob URL.
+    const res = await fetch(bundle.mainWorker);
+    if (!res.ok)
+        throw new Error(`${bundle.mainWorker}: ${res.status}`);
+    const url = URL.createObjectURL(new Blob([authPatch, await res.text()], { type: "text/javascript" }));
+    try {
+        // A CSP without blob: in worker-src throws here, so this is inside the try that revokes the URL.
+        const worker = new Worker(url);
+        const db = new duckdb.AsyncDuckDB(new duckdb.VoidLogger(), worker);
+        try {
+            // Pages without cross-origin isolation cannot start threads.
+            await (bundle.pthreadWorker
+                ? db.instantiate(bundle.mainModule, bundle.pthreadWorker).catch(() => db.instantiate(bundle.mainModule))
+                : db.instantiate(bundle.mainModule));
+        }
+        catch (e) {
+            await db.terminate().catch(() => undefined);
+            throw e;
+        }
+        workers.set(db, worker);
+        return db;
+    }
+    finally {
+        URL.revokeObjectURL(url);
+    }
+};
+/** Start DuckDB from the given WASM URL, and from jsDelivr when that fails. */
+export const boot = async (wasm) => {
+    const db = await instantiate(bundlesAt(wasm)).catch(async (e) => {
+        const { getJsDelivrBundles } = await import("@duckdb/duckdb-wasm");
+        return instantiate(getJsDelivrBundles()).catch((e2) => {
+            throw new AggregateError([e, e2], "DuckDB WASM could not be started");
+        });
+    });
+    try {
+        // Read Parquet by range instead of downloading whole files. Arrow returns DECIMAL as an unscaled
+        // integer, so let DuckDB convert it to DOUBLE.
+        await db.open({ path: ":memory:", filesystem: { forceFullHTTPReads: false }, query: { castDecimalToDouble: true } });
+        const conn = await db.connect();
+        await conn.query("INSTALL ducklake; LOAD ducklake").finally(() => conn.close());
+    }
+    catch (e) {
+        await db.terminate().catch(() => undefined);
+        throw e;
+    }
+    return db;
+};
+// The spatial extension is large, so it is loaded only for SQL that needs it, and on the error
+// DuckDB gives for a missing spatial function.
+/** Whether the SQL calls an ST_* function outside string literals and comments. */
+export const needsSpatial = (sql) => /\bST_\w+\s*\(/i.test(stripLiterals(sql));
+/** Whether the error comes from the spatial extension not being loaded. */
+export const isSpatialMissing = (message) => /exists in the spatial extension/i.test(message) || /\b(function|type) with name (st_\w+|geometry)\b.*does not exist/i.test(message);
+const spatial = new WeakMap();
+const spatialLoaded = new WeakSet();
+export const loadSpatial = (db) => {
+    const found = spatial.get(db);
+    if (found)
+        return found;
+    const p = db
+        .connect()
+        .then((conn) => conn.query("INSTALL spatial; LOAD spatial").finally(() => conn.close()))
+        .then(() => {
+        spatialLoaded.add(db);
+    })
+        .catch((e) => {
+        spatial.delete(db);
+        throw e;
+    });
+    spatial.set(db, p);
+    return p;
+};
+/** Run fn, loading spatial first when the SQL needs it, and once more after a missing-spatial error. */
+export const withSpatial = async (db, sql, fn) => {
+    if (needsSpatial(sql))
+        await loadSpatial(db);
+    // Once spatial is loaded, running the SQL again gives the same error.
+    const loaded = spatialLoaded.has(db);
+    try {
+        return await fn();
+    }
+    catch (e) {
+        if (loaded || !isSpatialMissing(String(e)))
+            throw e;
+        await loadSpatial(db);
+        return fn();
+    }
+};
+//# sourceMappingURL=boot.js.map

package/dist/boot.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,56 @@
+/** A license of a dataset, as returned by the Queria API. */
+export type License = {
+    id?: string;
+    title?: string;
+    url?: string;
+};
+/** The part of a dataset row from the Queria API that the package uses. */
+export type Dataset = {
+    qualified_name: string;
+    title?: string;
+    page_url?: string;
+    licenses?: License[];
+    catalog_url: string;
+    versioned_catalog_url?: string;
+};
+/** Datasets to read, by fully qualified name. An array uses each name's last part as the SQL alias. */
+export type Declared = readonly string[] | Readonly<Record<string, string>>;
+export type ConnectOptions = {
+    datasets: Declared;
+    /** Base URL of the Queria API. */
+    apiUrl?: string;
+    /** Base URL of the DuckDB WASM bundles. jsDelivr is used when they cannot be loaded. */
+    wasmUrl?: string;
+    /**
+     * A data token (qd_...) for datasets that are not public, or a function that returns one. A function is
+     * called before each request, so it can return a fresh token. The token is sent to the API and to the
+     * hosts of the declared datasets. DuckDB is shared by the page, so use one token per page.
+     */
+    token?: string | (() => string | Promise<string>);
+};
+export type Connection = {
+    /** Run SQL and return rows as plain objects. Datasets the SQL references are attached on first use. */
+    sql: <T = Record<string, unknown>>(sql: string) => Promise<T[]>;
+    /**
+     * The declared datasets the SQL references, for showing their sources and licenses.
+     * Without SQL (rows computed elsewhere), every declared dataset.
+     */
+    sources: (sql?: string) => Promise<Dataset[]>;
+};
+/** Map each SQL alias to a fully qualified name, rejecting names the package cannot use. */
+export declare const aliases: (declared: Declared) => Map<string, string>;
+/** Look up a dataset row. The API returns the catalog URL; the package never builds it. */
+export declare const lookup: (api: string, qualified: string, token?: string | null) => Promise<Dataset>;
+/** Parquet files sit next to the catalog: .../ducklake.duckdb → .../ducklake.duckdb.files/ */
+export declare const dataPath: (catalogUrl: string) => string;
+/** Convert Arrow values to plain JS: lists to arrays, structs to objects, BIGINT and HUGEINT to number. */
+export declare const plain: (v: unknown) => unknown;
+/** Stop every DuckDB the package started. A later query starts it again. */
+export declare const closeAll: () => Promise<void>;
+/**
+ * Connect to Queria datasets. Declare every dataset the SQL reads by its fully qualified name;
+ * the SQL refers to it by alias, such as e_stat.census.population. Short names are never resolved.
+ */
+export declare const connect: ({ datasets, apiUrl, wasmUrl, token }: ConnectOptions) => Connection;
+/** Read a list of datasets from an HTML attribute: "queria/e_stat queria/jma" or "a=alice/x b=bob/x". */
+export declare const parseDatasets: (attr: string) => Declared;

package/dist/client.js

@@ -0,0 +1,194 @@
+import { boot, setAuth, withSpatial } from "./boot.js";
+import { datasetsIn, lit } from "./sql.js";
+const API = "https://api.queria.io";
+// Must match the @duckdb/duckdb-wasm version in package.json "dependencies".
+const WASM = "https://assets.queria.io/duckdb-wasm/1.33.1-dev57.0";
+const ALIAS = /^[a-z_][a-z0-9_]*$/;
+const QUALIFIED = /^[a-z0-9_-]+\/[a-z_][a-z0-9_]*$/i;
+/** Map each SQL alias to a fully qualified name, rejecting names the package cannot use. */
+export const aliases = (declared) => {
+    const pairs = Array.isArray(declared)
+        ? declared.map((q) => [q.split("/")[1] ?? "", q])
+        : Object.entries(declared);
+    pairs.forEach(([alias, q]) => {
+        if (!QUALIFIED.test(q))
+            throw new Error(`"${q}" is not a fully qualified dataset name such as "queria/e_stat"`);
+        if (!ALIAS.test(alias))
+            throw new Error(`"${alias}" cannot be used as an SQL alias`);
+    });
+    const map = new Map(pairs);
+    if (map.size !== pairs.length)
+        throw new Error("Two datasets share an alias. Declare them as { alias: name }");
+    return map;
+};
+/** Look up a dataset row. The API returns the catalog URL; the package never builds it. */
+export const lookup = async (api, qualified, token = null) => {
+    const res = await fetch(`${api}/v1/datasets/${qualified}`, bearer(token));
+    if (res.status === 404)
+        throw new Error(`Dataset ${qualified} was not found`);
+    if (!res.ok)
+        throw new Error(`${api}/v1/datasets/${qualified}: ${res.status}`);
+    const d = (await res.json());
+    if (typeof d?.catalog_url !== "string" || typeof d.qualified_name !== "string")
+        throw new Error(`${api}/v1/datasets/${qualified}: the response has no catalog_url or qualified_name`);
+    return d;
+};
+const bearer = (token) => token === null ? undefined : { headers: { Authorization: `Bearer ${token}` } };
+/** Parquet files sit next to the catalog: .../ducklake.duckdb → .../ducklake.duckdb.files/ */
+export const dataPath = (catalogUrl) => `${catalogUrl.split("?")[0]}.files/`;
+/**
+ * Attach one dataset. The catalog is fetched in a single GET: letting DuckDB read it by range
+ * costs hundreds of 16 KiB round trips for large catalogs. Data files are still read by range.
+ */
+const attach = async (db, alias, d, token) => {
+    const url = d.versioned_catalog_url ?? d.catalog_url;
+    const res = await fetch(url, bearer(token));
+    if (!res.ok)
+        throw new Error(`${url}: ${res.status}`);
+    // One file per alias: an alias is attached once per DuckDB, while one dataset can be attached
+    // under two aliases, and DuckDB refuses to attach one path twice.
+    const file = `${alias}.duckdb`;
+    await db.registerFileBuffer(file, new Uint8Array(await res.arrayBuffer()));
+    const conn = await db.connect();
+    try {
+        await conn.query(`ATTACH ${lit(`ducklake:${file}`)} AS ${alias} (READ_ONLY, DATA_PATH ${lit(dataPath(d.catalog_url))}, OVERRIDE_DATA_PATH true)`);
+    }
+    finally {
+        await conn.close();
+    }
+};
+/** Convert Arrow values to plain JS: lists to arrays, structs to objects, BIGINT and HUGEINT to number. */
+export const plain = (v) => {
+    if (typeof v === "bigint")
+        return Number(v);
+    if (v === null || typeof v !== "object")
+        return v;
+    if (Array.isArray(v))
+        return v.map(plain);
+    // 128-bit integers come as Arrow big numbers (typed arrays); BLOBs stay Uint8Array.
+    if (ArrayBuffer.isView(v))
+        return Symbol.for("isArrowBigNum") in v ? Number(String(v)) : v;
+    if ("toJSON" in v && typeof v.toJSON === "function")
+        return plain(v.toJSON());
+    return Object.fromEntries(Object.entries(v).map(([k, x]) => [k, plain(x)]));
+};
+const engines = new Map();
+const engine = (wasm) => {
+    const found = engines.get(wasm);
+    if (found)
+        return found;
+    let db = null;
+    const e = {
+        db: async () => {
+            const p = (db ??= boot(wasm).catch((err) => {
+                if (db === p) {
+                    db = null;
+                    e.attached.clear();
+                }
+                throw err;
+            }));
+            const d = await p;
+            // stop() ran while DuckDB was starting; it terminates this one.
+            if (db !== p)
+                throw new Error("DuckDB was stopped");
+            return d;
+        },
+        stop: async () => {
+            const started = db;
+            db = null;
+            e.attached.clear();
+            // A failed start was already reported to the query that started it.
+            await started?.then((d) => d.terminate(), () => undefined);
+        },
+        attached: new Map(),
+    };
+    engines.set(wasm, e);
+    return e;
+};
+/** Stop every DuckDB the package started. A later query starts it again. */
+export const closeAll = async () => {
+    const all = [...engines.values()];
+    engines.clear();
+    await Promise.all(all.map((e) => e.stop()));
+};
+/**
+ * Connect to Queria datasets. Declare every dataset the SQL reads by its fully qualified name;
+ * the SQL refers to it by alias, such as e_stat.census.population. Short names are never resolved.
+ */
+export const connect = ({ datasets, apiUrl = API, wasmUrl = WASM, token }) => {
+    const declared = aliases(datasets);
+    const auth = async () => (token === undefined ? null : typeof token === "string" ? token : await token());
+    const rows = new Map();
+    /** The dataset row, looked up once. Pass the token when the caller has already asked for it. */
+    const row = (qualified, token) => {
+        const p = rows.get(qualified) ??
+            (token ?? auth())
+                .then((t) => lookup(apiUrl, qualified, t))
+                .catch((e) => {
+                rows.delete(qualified);
+                throw e;
+            });
+        rows.set(qualified, p);
+        return p;
+    };
+    /** Declared aliases the SQL references. Other three-part names are left to DuckDB (alias.column.field). */
+    const used = (sql) => datasetsIn(sql).filter((a) => declared.has(a));
+    const ensure = async (e, db, alias, t) => {
+        const qualified = declared.get(alias) ?? "";
+        const prev = e.attached.get(alias);
+        if (prev && prev.qualified !== qualified)
+            throw new Error(`Alias ${alias} is already used for ${prev.qualified} on this page. Declare ${qualified} with another alias`);
+        const done = prev?.done ??
+            row(qualified, Promise.resolve(t))
+                .then((d) => attach(db, alias, d, t))
+                .catch((err) => {
+                e.attached.delete(alias);
+                throw err;
+            });
+        e.attached.set(alias, { qualified, done });
+        await done;
+    };
+    const sql = async (query) => {
+        const eng = engine(wasmUrl);
+        const aliasesUsed = used(query);
+        // Look up the datasets while DuckDB starts. The token function is called once per query.
+        const token = auth();
+        const [db, t, ds] = await Promise.all([eng.db(), token, Promise.all(aliasesUsed.map((a) => row(declared.get(a) ?? "", token)))]);
+        // Data files are read by the DuckDB worker, so hand it the token and the hosts it may go to.
+        if (t !== null)
+            setAuth(db, t, [...new Set(ds.map((d) => new URL(d.catalog_url).origin))]);
+        await Promise.all(aliasesUsed.map((a) => ensure(eng, db, a, t)));
+        const run = async () => {
+            const conn = await db.connect();
+            try {
+                return (await conn.query(query)).toArray().map((r) => plain(r));
+            }
+            finally {
+                await conn.close();
+            }
+        };
+        try {
+            return await withSpatial(db, query, run);
+        }
+        catch (e) {
+            const undeclared = datasetsIn(query).filter((a) => !declared.has(a));
+            if (undeclared.length === 0)
+                throw e;
+            throw new Error(`${String(e)}\nIf ${undeclared.join(", ")} is a dataset, declare it in connect({ datasets })`, { cause: e });
+        }
+    };
+    const sources = (query) => Promise.all((query === undefined ? [...declared.keys()] : used(query)).map((a) => row(declared.get(a) ?? "")));
+    return { sql, sources };
+};
+/** Read a list of datasets from an HTML attribute: "queria/e_stat queria/jma" or "a=alice/x b=bob/x". */
+export const parseDatasets = (attr) => {
+    const pairs = attr
+        .split(/[\s,]+/)
+        .filter(Boolean)
+        .map((w) => (w.includes("=") ? w.split("=", 2) : [w.split("/")[1] ?? "", w]));
+    // Object.fromEntries would keep only the last of two datasets with one alias.
+    if (new Set(pairs.map(([alias]) => alias)).size !== pairs.length)
+        throw new Error("Two datasets share an alias. Declare them as alias=name");
+    return Object.fromEntries(pairs);
+};
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/elements/define.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/elements/define.js

@@ -0,0 +1,4 @@
+// Importing this module registers the custom elements.
+import { defineElements } from "./index.js";
+defineElements();
+//# sourceMappingURL=define.js.map

package/dist/elements/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/elements/define.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,cAAc,EAAE,CAAC"}

package/dist/elements/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * <queria-chart datasets="queria/e_stat" sql="..." spec='{"mark": "line", ...}'>
+ * Runs the SQL and draws the rows with the Vega-Lite spec, followed by the sources of the datasets.
+ * Instead of sql, `rows` takes the rows as JSON, for pages that run the SQL at build time. Declare the datasets the
+ * rows came from in `datasets` so their sources are shown.
+ * `api-url` replaces the Queria API, for example with a staging host.
+ */
+export declare class QueriaChart extends HTMLElement {
+    #private;
+    static observedAttributes: string[];
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    disconnectedCallback(): void;
+}
+/**
+ * <queria-map datasets="queria/e_stat" sql="..." layer='{"area": "city", "code": "lg_code", "color": "population"}'>
+ * Runs the SQL and puts the rows on a map by area code or by lng/lat, followed by the sources of the datasets.
+ * `rows`, `api-url` work as on <queria-chart>. `theme` is light or dark; `map-style` takes another MapLibre style URL.
+ * Include maplibre-gl's CSS in the page. The map height is the CSS variable --queria-map-height (400px by default).
+ */
+export declare class QueriaMap extends HTMLElement {
+    #private;
+    static observedAttributes: string[];
+    connectedCallback(): void;
+    attributeChangedCallback(): void;
+    disconnectedCallback(): void;
+}
+/** <queria-powered-by> */
+export declare class QueriaPoweredBy extends HTMLElement {
+    connectedCallback(): void;
+}
+/** Register the custom elements. Safe to call more than once. */
+export declare const defineElements: () => void;
+declare global {
+    interface HTMLElementTagNameMap {
+        "queria-chart": QueriaChart;
+        "queria-map": QueriaMap;
+        "queria-powered-by": QueriaPoweredBy;
+    }
+}