@tlockney/cdp-kernel 0.10.0 → 0.12.0

package/dist/browser/mod.d.ts

@@ -4,6 +4,17 @@ import { type Channel, type JupyterMessage, type MessageListener } from "./chann
 import { type BrowserTargetOptions } from "./target.ts";
 export type { Channel, JupyterMessage, MessageListener } from "./channels.ts";
 export { BrowserTarget, type BrowserTargetOptions, type HostHandler, type HostRequest, type WorkerLike } from "./target.ts";
+/**
+ * The packages `jupyter.chart` imports, as it writes them: map them in
+ * `modules` to copies the page serves, and charts draw offline. The page
+ * serves ES modules that export what the packages do. Same as
+ * runtime/chart.mjs's VEGA, VEGA_LITE and LINKEDOM.
+ */
+export declare const CHART_MODULES: {
+    readonly vega: "npm:vega@6";
+    readonly vegaLite: "npm:vega-lite@6";
+    readonly linkedom: "npm:linkedom@0.18";
+};
 export interface BrowserKernelOptions extends BrowserTargetOptions {
     /** What strips cells' types; sucrase by default, since esbuild's native binary can't run in a page. */
     typeStrip?: TypeStripperName | TypeStripper;

package/dist/browser/mod.js

@@ -15,6 +15,17 @@ import { VERSION } from "../package.js";
 import { PageChannels } from "./channels.js";
 import { BrowserTarget } from "./target.js";
 export { BrowserTarget } from "./target.js";
+/**
+ * The packages `jupyter.chart` imports, as it writes them: map them in
+ * `modules` to copies the page serves, and charts draw offline. The page
+ * serves ES modules that export what the packages do. Same as
+ * runtime/chart.mjs's VEGA, VEGA_LITE and LINKEDOM.
+ */
+export const CHART_MODULES = {
+    vega: "npm:vega@6",
+    vegaLite: "npm:vega-lite@6",
+    linkedom: "npm:linkedom@0.18",
+};
 export function startBrowserKernel(options) {
     const channels = new PageChannels();
     const log = options.log ?? ((text) => console.debug(`[cdp-kernel] ${text}`));

package/dist/browser/target.d.ts

@@ -22,6 +22,16 @@ export interface BrowserTargetOptions {
     base?: string;
     /** Where npm:, jsr: and bare imports load from; esm.sh by default. */
     cdn?: string;
+    /**
+     * Specifiers, as written, mapped to URLs the page serves (resolved
+     * against `base`), which win over `cdn`: a cell's imports and the
+     * libraries `jupyter.chart` and `jupyter.sql` import load from there.
+     * Mapping `CHART_MODULES` makes charts draw offline; `jupyter.sql` still
+     * loads DuckDB's worker and .wasm from jsDelivr.
+     */
+    modules?: {
+        readonly [specifier: string]: string;
+    };
     /**
      * Modules the Worker imports before the first cell, each time it starts,
      * resolved against `base`. A module's default export, if a function, is

package/dist/browser/target.js

@@ -49,7 +49,7 @@ export class BrowserTarget {
         const base = options.base ?? globalThis.location?.href ?? "file:///";
         try {
             const params = options.params === undefined ? undefined : JSON.stringify(options.params);
-            const { userAgent } = await target.#request("info", { base, cdn: options.cdn, preload: options.preload ?? [], params });
+            const { userAgent } = await target.#request("info", { base, cdn: options.cdn, modules: options.modules, preload: options.preload ?? [], params });
             if (typeof userAgent === "string")
                 target.versions.runtime = browserName(userAgent);
             target.versions.engine = engineName(typeof userAgent === "string" ? userAgent : "");