typebulb 0.12.0 → 0.13.0

package/dist/dts/negativeCacheHelper.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Exponential-backoff negative caching helper.
+ *
+ * Storage-agnostic: takes a NegativeCacheStore interface that consumers
+ * implement against Dexie (web), the filesystem (CLI), or in-memory (tests).
+ */
+/** Record shape stored per negative-cached key. */
+export interface NegativeRecord {
+    until: number;
+    attempts: number;
+}
+/** Minimal key/value storage interface used by NegativeCacheHelper. */
+export interface NegativeCacheStore {
+    get(key: string): Promise<NegativeRecord | undefined>;
+    set(key: string, record: NegativeRecord): Promise<void>;
+    delete(key: string): Promise<void>;
+}
+/**
+ * Tracks "this thing doesn't exist" outcomes with progressive retry delays:
+ * 15m base, doubling per attempt, capped at 24h.
+ */
+export declare class NegativeCacheHelper {
+    private store;
+    constructor(store: NegativeCacheStore);
+    isNegative(key: string): Promise<boolean>;
+    recordNegative(key: string): Promise<void>;
+    clearNegative(key: string): Promise<void>;
+}
+//# sourceMappingURL=negativeCacheHelper.d.ts.map

package/dist/dts/negativeCacheHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negativeCacheHelper.d.ts","sourceRoot":"","sources":["../../dts/src/negativeCacheHelper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,mDAAmD;AACnD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAA;IACrD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACnC;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAClB,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,kBAAkB;IAEvC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKzC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1C,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhD"}

package/dist/dts/negativeCacheHelper.js

@@ -0,0 +1,44 @@
+/**
+ * Exponential-backoff negative caching helper.
+ *
+ * Storage-agnostic: takes a NegativeCacheStore interface that consumers
+ * implement against Dexie (web), the filesystem (CLI), or in-memory (tests).
+ */
+/**
+ * Tracks "this thing doesn't exist" outcomes with progressive retry delays:
+ * 15m base, doubling per attempt, capped at 24h.
+ */
+export class NegativeCacheHelper {
+    constructor(store) {
+        this.store = store;
+    }
+    async isNegative(key) {
+        const rec = await safe(() => this.store.get(key));
+        return !!rec && rec.until > Date.now();
+    }
+    async recordNegative(key) {
+        const existing = await safe(() => this.store.get(key));
+        const attempts = (existing?.attempts || 0) + 1;
+        await safe(() => this.store.set(key, {
+            until: Date.now() + computeNextTtlMs(attempts),
+            attempts,
+        }));
+    }
+    async clearNegative(key) {
+        await safe(() => this.store.delete(key));
+    }
+}
+function computeNextTtlMs(attempts) {
+    const base = 15 * 60 * 1000;
+    const max = 24 * 60 * 60 * 1000;
+    return Math.min(base * Math.pow(2, Math.max(0, attempts - 1)), max);
+}
+async function safe(fn) {
+    try {
+        return await fn();
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=negativeCacheHelper.js.map

package/dist/dts/negativeCacheHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"negativeCacheHelper.js","sourceRoot":"","sources":["../../dts/src/negativeCacheHelper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IAC9B,YAAoB,KAAyB;QAAzB,UAAK,GAAL,KAAK,CAAoB;IAAG,CAAC;IAEjD,KAAK,CAAC,UAAU,CAAC,GAAW;QAC1B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACjD,OAAO,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IACxC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,GAAW;QAC9B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QACtD,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAA;QAC9C,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE;YACnC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC;YAC9C,QAAQ;SACT,CAAC,CAAC,CAAA;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,GAAW;QAC7B,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC1C,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAC3B,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AACrE,CAAC;AAED,KAAK,UAAU,IAAI,CAAI,EAAoB;IACzC,IAAI,CAAC;QAAC,OAAO,MAAM,EAAE,EAAE,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAA;IAAC,CAAC;AACtD,CAAC"}

package/dist/dts/tarballFetcher.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Fetches an npm tarball from registry.npmjs.org and extracts .d.ts / .d.mts
+ * files in-memory. Uses fflate (isomorphic). No deps to inject — usable
+ * from both web client and CLI.
+ */
+export declare class TarballFetcher {
+    fetchAndExtract(packageName: string, version: string): Promise<Map<string, string>>;
+    private getTarballUrl;
+    private normalizeTarPath;
+    private extractDtsFiles;
+}
+export declare const tarballFetcher: TarballFetcher;
+//# sourceMappingURL=tarballFetcher.d.ts.map

package/dist/dts/tarballFetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tarballFetcher.d.ts","sourceRoot":"","sources":["../../dts/src/tarballFetcher.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,qBAAa,cAAc;IACnB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUzF,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,eAAe;CAkCxB;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAA"}

package/dist/dts/tarballFetcher.js

@@ -0,0 +1,58 @@
+import { gunzipSync } from 'fflate';
+import { fetchWithRetry } from './httpFetch.js';
+/**
+ * Fetches an npm tarball from registry.npmjs.org and extracts .d.ts / .d.mts
+ * files in-memory. Uses fflate (isomorphic). No deps to inject — usable
+ * from both web client and CLI.
+ */
+export class TarballFetcher {
+    async fetchAndExtract(packageName, version) {
+        const tarballUrl = this.getTarballUrl(packageName, version);
+        // Tarballs are large; give them double the default timeout for slow networks.
+        const response = await fetchWithRetry(tarballUrl, { timeoutMs: 30000 });
+        if (!response?.ok)
+            return new Map();
+        const gzipped = new Uint8Array(await response.arrayBuffer());
+        return this.extractDtsFiles(gzipped);
+    }
+    getTarballUrl(packageName, version) {
+        const encodedName = packageName.replace('/', '%2F');
+        return `https://registry.npmjs.org/${encodedName}/-/${packageName.split('/').pop()}-${version}.tgz`;
+    }
+    normalizeTarPath(tarPath) {
+        let p = tarPath.replace(/^package\//, '');
+        const firstSlash = p.indexOf('/');
+        return firstSlash > 0 ? p.substring(firstSlash + 1) : p;
+    }
+    extractDtsFiles(gzipped) {
+        const files = new Map();
+        try {
+            const tarData = gunzipSync(gzipped);
+            const decoder = new TextDecoder('utf-8');
+            let offset = 0;
+            while (offset < tarData.length - 512) {
+                const header = tarData.slice(offset, offset + 512);
+                if (header[0] === 0)
+                    break;
+                const filenameBytes = header.slice(0, 100);
+                const nullIndex = filenameBytes.indexOf(0);
+                const filename = decoder.decode(filenameBytes.slice(0, nullIndex > 0 ? nullIndex : 100)).trim();
+                const sizeBytes = header.slice(124, 136);
+                const sizeStr = decoder.decode(sizeBytes).trim().replace(/\0/g, '');
+                const fileSize = parseInt(sizeStr, 8) || 0;
+                const fileType = String.fromCharCode(header[156]);
+                offset += 512;
+                if ((fileType === '0' || fileType === '\0') &&
+                    (filename.endsWith('.d.ts') || filename.endsWith('.d.mts'))) {
+                    const fileData = tarData.slice(offset, offset + fileSize);
+                    files.set(this.normalizeTarPath(filename), decoder.decode(fileData));
+                }
+                offset += Math.ceil(fileSize / 512) * 512;
+            }
+        }
+        catch { }
+        return files;
+    }
+}
+export const tarballFetcher = new TarballFetcher();
+//# sourceMappingURL=tarballFetcher.js.map

package/dist/dts/tarballFetcher.js.map

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

package/dist/dts/tbTypings.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `tb` global typings for Typebulb bulbs.
+ *
+ * Two flavors:
+ * - `clientTbTypings` — full surface available in browser-side code (code.tsx)
+ * - `serverTbTypings` — Node-flavored subset available in server-side code (server.ts)
+ *
+ * Single source of truth for Monaco IntelliSense (web client), the standalone
+ * TypeChecker, and the CLI's emitted typecheck dirs.
+ */
+/** Typebulb globals available in browser-side code (code.tsx). */
+export declare const clientTbTypings = "\n/**\n * Typebulb utilities namespace.\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Async value inspector for tensor-like objects.\n   *\n   * Materializes lazy values (like GPU tensors) and logs them with metadata.\n   * Handles objects with `.js()`, `.data()`, `.array()`, `.arraySync()`, etc.\n   *\n   * @remarks\n   * - Always use `await` - materialization may be async (GPU\u2192CPU readback)\n   * - Large values are truncated (max 1000 elements)\n   * - Promises are logged as `[Promise]` (not awaited - could hang)\n   */\n  dump(...args: any[]): Promise<void>;\n  /**\n   * Trigger inference to generate new insight data.\n   *\n   * Opens a confirmation modal showing the data to be analyzed, then streams\n   * the inference result. On success, updates the insight so subsequent\n   * `tb.insight()` calls return the new value.\n   *\n   * @param opts - Options for inference\n   * @param opts.data - Data to pre-populate in the modal (string or array of strings). If omitted, modal opens with empty textarea for user to paste.\n   * @returns Promise that resolves with the parsed insight JSON\n   * @throws If inference is already in progress, or on network/parse/rate limit errors\n   */\n  infer<T = unknown>(opts?: { data?: string | string[] }): Promise<T>;\n  /**\n   * Get the current inference state.\n   *\n   * @returns 'idle' | 'running' | 'complete' | 'error'\n   */\n  inferenceState(): 'idle' | 'running' | 'complete' | 'error';\n  /**\n   * Set a data chunk for the next inference call.\n   *\n   * Use this to programmatically set data that will be sent when `tb.infer()` is called\n   * without the `data` option.\n   *\n   * @param index - The chunk index (0-based)\n   * @param content - The content for this chunk\n   */\n  setData(index: number, content: string): void;\n  /**\n   * Proxy a CDN URL through the sandbox origin for Web Worker/WASM same-origin loading.\n   *\n   * In the sandbox, prepends `/proxy/` so the URL is served from the same origin.\n   * Outside the sandbox (exported HTML, CLI), returns the URL unchanged.\n   *\n   * @param url - Full HTTPS URL to an allowlisted CDN (esm.sh, unpkg.com, cdn.jsdelivr.net, cdnjs.cloudflare.com)\n   * @returns The proxied URL (sandbox) or the original URL (standalone/CLI)\n   */\n  proxy(url: string): string;\n  /**\n   * Copy text to clipboard.\n   * Must be called synchronously within a user gesture (click/keydown).\n   * @returns true if successful, false otherwise\n   */\n  copy(text: string): Promise<boolean>;\n  /**\n   * Get the canonical URL of this bulb.\n   *\n   * Returns the parent typebulb.com URL (including path, query, and `#tb=` fragment),\n   * resolving correctly from inside the cross-origin sandbox iframe.\n   * Use this instead of `location.href` or `document.referrer`.\n   *\n   * @returns The full canonical URL\n   */\n  url(): Promise<string>;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * Server-side function proxy.\n   *\n   * In the CLI, calls exported functions from the `**server.ts**` section.\n   * `tb.server.log(...)` is a built-in that prints to CLI stdout (falls back to console.log on web).\n   * User exports override built-ins of the same name.\n   */\n  server: Record<string, (...args: any[]) => Promise<any>>;\n  /**\n   * General-purpose AI call.\n   *\n   * @param options - Messages, system prompt, optional provider/model override\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning depth hint (0=min, 1=low, 2=med, 3=max). Mapped to provider-specific parameters (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Default: 0. */\n    reasoning?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n  }): Promise<{ text: string }>;\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Paths are resolved relative to the directory containing the bulb file.\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * The bulb's theme override (`<html data-theme>`).\n   *\n   * - Get: the current override \u2014 `'dark'` | `'light'`, or `undefined` when\n   *   following the OS preference.\n   * - Set `'dark'`/`'light'` to force and persist it (per-bulb); set\n   *   `undefined` to clear the override and follow the OS again.\n   *\n   * Drives `<html data-theme>`, so render off `html[data-theme=\"\u2026\"]` selectors\n   * (or observe the attribute) rather than reading `tb.theme`.\n   */\n  theme: 'light' | 'dark' | undefined;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
+/** Typebulb globals available in Node-side code (server.ts). */
+export declare const serverTbTypings = "\n/**\n * Typebulb utilities namespace (server-side).\n * Type `tb.` to discover available helpers.\n */\ndeclare const tb: {\n  /**\n   * Get raw data chunk from the Data tab.\n   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.\n   */\n  data(index: number): string;\n  /**\n   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).\n   * @param index - Chunk index (0-based)\n   * @throws If chunk is not valid JSON/JSON-ish\n   */\n  json<T = unknown>(index: number): T;\n  /**\n   * Get the insight data produced by the inference layer.\n   *\n   * Returns the parsed JSON from insight.json, populated by the inference LLM.\n   * Use a type parameter to get typed access to the insight data.\n   *\n   * @returns The parsed insight JSON, or undefined if no insight is available\n   */\n  insight<T = unknown>(): T | undefined;\n  /**\n   * General-purpose AI call.\n   *\n   * @param options - Messages, system prompt, optional provider/model override\n   * @returns Promise resolving to { text: string }\n   * @throws On rate limit, network error, or provider error\n   */\n  ai(options: {\n    messages: Array<{ role: \"user\" | \"assistant\"; content: string }>;\n    system?: string;\n    /** Reasoning depth hint (0=min, 1=low, 2=med, 3=max). Mapped to provider-specific parameters (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Default: 0. */\n    reasoning?: 0 | 1 | 2 | 3;\n    provider?: string;\n    model?: string;\n    /** Enable/disable web search. Default: on for BYOK, always off for free model. */\n    webSearch?: boolean;\n  }): Promise<{ text: string }>;\n  /**\n   * Local filesystem access (CLI only).\n   *\n   * Paths are resolved relative to the directory containing the bulb file.\n   * Throws in editor/published mode.\n   */\n  fs: {\n    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 \u2014 use readBytes for binary. */\n    read(path: string): Promise<string>;\n    /** Read a file as raw bytes. */\n    readBytes(path: string): Promise<Uint8Array>;\n    /** Write text or raw bytes to a file. Creates parent directories if needed. */\n    write(path: string, content: string | Uint8Array): Promise<boolean>;\n  };\n  /**\n   * Server-side function proxy. The built-in `log` prints to CLI stdout\n   * (falls back to console.log on web). On the server side, this object only\n   * exposes `log` \u2014 server-to-server calls are not supported.\n   */\n  server: {\n    log(...args: any[]): Promise<void>;\n  };\n  /**\n   * Returns AI models available to the current user.\n   * Models are filtered by the user's configured API keys.\n   * If no keys are configured, returns only the courtesy model.\n   */\n  models(): Promise<Array<{\n    /** Provider protocol: \"anthropic\", \"openai\", \"gemini\", \"openrouter\" */\n    provider: string;\n    /** Model identifier, e.g. \"claude-sonnet-4-6\" */\n    name: string;\n    /** Human-readable display name, e.g. \"Sonnet 4.6\" */\n    friendlyName: string;\n    /** Provider display name, e.g. \"Anthropic\" */\n    providerName: string;\n  }>>;\n  /**\n   * The mode this bulb is running in.\n   *\n   * - `'local'` \u2014 Running via the typebulb CLI\n   * - `'editor'` \u2014 Running in the typebulb.com editor\n   * - `'published'` \u2014 Running as a published/standalone bulb on typebulb.com\n   * - `'embedded'` \u2014 Running as a bulb embedded inside another bulb (sandboxed,\n   *   client-only: AI, filesystem, and server RPC are unavailable)\n   */\n  mode: 'local' | 'editor' | 'published' | 'embedded';\n};\n";
+//# sourceMappingURL=tbTypings.d.ts.map

package/dist/dts/tbTypings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tbTypings.d.ts","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiMH,kEAAkE;AAClE,eAAO,MAAM,eAAe,ozNAO3B,CAAA;AAED,gEAAgE;AAChE,eAAO,MAAM,eAAe,wgHAO3B,CAAA"}

package/dist/dts/tbTypings.js

@@ -0,0 +1,210 @@
+/**
+ * `tb` global typings for Typebulb bulbs.
+ *
+ * Two flavors:
+ * - `clientTbTypings` — full surface available in browser-side code (code.tsx)
+ * - `serverTbTypings` — Node-flavored subset available in server-side code (server.ts)
+ *
+ * Single source of truth for Monaco IntelliSense (web client), the standalone
+ * TypeChecker, and the CLI's emitted typecheck dirs.
+ */
+const dataAndJson = `
+  /**
+   * Get raw data chunk from the Data tab.
+   * @param index - Chunk index (0-based). Separate chunks with 2 blank lines.
+   */
+  data(index: number): string;
+  /**
+   * Get data chunk parsed as JSON (handles JSON-ish with unquoted keys).
+   * @param index - Chunk index (0-based)
+   * @throws If chunk is not valid JSON/JSON-ish
+   */
+  json<T = unknown>(index: number): T;`;
+const insight = `
+  /**
+   * Get the insight data produced by the inference layer.
+   *
+   * Returns the parsed JSON from insight.json, populated by the inference LLM.
+   * Use a type parameter to get typed access to the insight data.
+   *
+   * @returns The parsed insight JSON, or undefined if no insight is available
+   */
+  insight<T = unknown>(): T | undefined;`;
+const ai = `
+  /**
+   * General-purpose AI call.
+   *
+   * @param options - Messages, system prompt, optional provider/model override
+   * @returns Promise resolving to { text: string }
+   * @throws On rate limit, network error, or provider error
+   */
+  ai(options: {
+    messages: Array<{ role: "user" | "assistant"; content: string }>;
+    system?: string;
+    /** Reasoning depth hint (0=min, 1=low, 2=med, 3=max). Mapped to provider-specific parameters (e.g. Anthropic adaptive thinking, OpenAI reasoning effort). Default: 0. */
+    reasoning?: 0 | 1 | 2 | 3;
+    provider?: string;
+    model?: string;
+    /** Enable/disable web search. Default: on for BYOK, always off for free model. */
+    webSearch?: boolean;
+  }): Promise<{ text: string }>;`;
+const models = `
+  /**
+   * Returns AI models available to the current user.
+   * Models are filtered by the user's configured API keys.
+   * If no keys are configured, returns only the courtesy model.
+   */
+  models(): Promise<Array<{
+    /** Provider protocol: "anthropic", "openai", "gemini", "openrouter" */
+    provider: string;
+    /** Model identifier, e.g. "claude-sonnet-4-6" */
+    name: string;
+    /** Human-readable display name, e.g. "Sonnet 4.6" */
+    friendlyName: string;
+    /** Provider display name, e.g. "Anthropic" */
+    providerName: string;
+  }>>;`;
+const theme = `
+  /**
+   * The bulb's theme override (\`<html data-theme>\`).
+   *
+   * - Get: the current override — \`'dark'\` | \`'light'\`, or \`undefined\` when
+   *   following the OS preference.
+   * - Set \`'dark'\`/\`'light'\` to force and persist it (per-bulb); set
+   *   \`undefined\` to clear the override and follow the OS again.
+   *
+   * Drives \`<html data-theme>\`, so render off \`html[data-theme="…"]\` selectors
+   * (or observe the attribute) rather than reading \`tb.theme\`.
+   */
+  theme: 'light' | 'dark' | undefined;`;
+const mode = `
+  /**
+   * The mode this bulb is running in.
+   *
+   * - \`'local'\` — Running via the typebulb CLI
+   * - \`'editor'\` — Running in the typebulb.com editor
+   * - \`'published'\` — Running as a published/standalone bulb on typebulb.com
+   * - \`'embedded'\` — Running as a bulb embedded inside another bulb (sandboxed,
+   *   client-only: AI, filesystem, and server RPC are unavailable)
+   */
+  mode: 'local' | 'editor' | 'published' | 'embedded';`;
+const fs = `
+  /**
+   * Local filesystem access (CLI only).
+   *
+   * Paths are resolved relative to the directory containing the bulb file.
+   * Throws in editor/published mode.
+   */
+  fs: {
+    /** Read a file as UTF-8 text. Throws if the file is not valid UTF-8 — use readBytes for binary. */
+    read(path: string): Promise<string>;
+    /** Read a file as raw bytes. */
+    readBytes(path: string): Promise<Uint8Array>;
+    /** Write text or raw bytes to a file. Creates parent directories if needed. */
+    write(path: string, content: string | Uint8Array): Promise<boolean>;
+  };`;
+const serverLogOnly = `
+  /**
+   * Server-side function proxy. The built-in \`log\` prints to CLI stdout
+   * (falls back to console.log on web). On the server side, this object only
+   * exposes \`log\` — server-to-server calls are not supported.
+   */
+  server: {
+    log(...args: any[]): Promise<void>;
+  };`;
+const clientOnlyMembers = `
+  /**
+   * Async value inspector for tensor-like objects.
+   *
+   * Materializes lazy values (like GPU tensors) and logs them with metadata.
+   * Handles objects with \`.js()\`, \`.data()\`, \`.array()\`, \`.arraySync()\`, etc.
+   *
+   * @remarks
+   * - Always use \`await\` - materialization may be async (GPU→CPU readback)
+   * - Large values are truncated (max 1000 elements)
+   * - Promises are logged as \`[Promise]\` (not awaited - could hang)
+   */
+  dump(...args: any[]): Promise<void>;
+  /**
+   * Trigger inference to generate new insight data.
+   *
+   * Opens a confirmation modal showing the data to be analyzed, then streams
+   * the inference result. On success, updates the insight so subsequent
+   * \`tb.insight()\` calls return the new value.
+   *
+   * @param opts - Options for inference
+   * @param opts.data - Data to pre-populate in the modal (string or array of strings). If omitted, modal opens with empty textarea for user to paste.
+   * @returns Promise that resolves with the parsed insight JSON
+   * @throws If inference is already in progress, or on network/parse/rate limit errors
+   */
+  infer<T = unknown>(opts?: { data?: string | string[] }): Promise<T>;
+  /**
+   * Get the current inference state.
+   *
+   * @returns 'idle' | 'running' | 'complete' | 'error'
+   */
+  inferenceState(): 'idle' | 'running' | 'complete' | 'error';
+  /**
+   * Set a data chunk for the next inference call.
+   *
+   * Use this to programmatically set data that will be sent when \`tb.infer()\` is called
+   * without the \`data\` option.
+   *
+   * @param index - The chunk index (0-based)
+   * @param content - The content for this chunk
+   */
+  setData(index: number, content: string): void;
+  /**
+   * Proxy a CDN URL through the sandbox origin for Web Worker/WASM same-origin loading.
+   *
+   * In the sandbox, prepends \`/proxy/\` so the URL is served from the same origin.
+   * Outside the sandbox (exported HTML, CLI), returns the URL unchanged.
+   *
+   * @param url - Full HTTPS URL to an allowlisted CDN (esm.sh, unpkg.com, cdn.jsdelivr.net, cdnjs.cloudflare.com)
+   * @returns The proxied URL (sandbox) or the original URL (standalone/CLI)
+   */
+  proxy(url: string): string;
+  /**
+   * Copy text to clipboard.
+   * Must be called synchronously within a user gesture (click/keydown).
+   * @returns true if successful, false otherwise
+   */
+  copy(text: string): Promise<boolean>;
+  /**
+   * Get the canonical URL of this bulb.
+   *
+   * Returns the parent typebulb.com URL (including path, query, and \`#tb=\` fragment),
+   * resolving correctly from inside the cross-origin sandbox iframe.
+   * Use this instead of \`location.href\` or \`document.referrer\`.
+   *
+   * @returns The full canonical URL
+   */
+  url(): Promise<string>;`;
+const clientServerProxy = `
+  /**
+   * Server-side function proxy.
+   *
+   * In the CLI, calls exported functions from the \`**server.ts**\` section.
+   * \`tb.server.log(...)\` is a built-in that prints to CLI stdout (falls back to console.log on web).
+   * User exports override built-ins of the same name.
+   */
+  server: Record<string, (...args: any[]) => Promise<any>>;`;
+/** Typebulb globals available in browser-side code (code.tsx). */
+export const clientTbTypings = `
+/**
+ * Typebulb utilities namespace.
+ * Type \`tb.\` to discover available helpers.
+ */
+declare const tb: {${dataAndJson}${clientOnlyMembers}${insight}${clientServerProxy}${ai}${fs}${models}${theme}${mode}
+};
+`;
+/** Typebulb globals available in Node-side code (server.ts). */
+export const serverTbTypings = `
+/**
+ * Typebulb utilities namespace (server-side).
+ * Type \`tb.\` to discover available helpers.
+ */
+declare const tb: {${dataAndJson}${insight}${ai}${fs}${serverLogOnly}${models}${mode}
+};
+`;
+//# sourceMappingURL=tbTypings.js.map

package/dist/dts/tbTypings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tbTypings.js","sourceRoot":"","sources":["../../dts/src/tbTypings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,GAAG;;;;;;;;;;;uCAWmB,CAAA;AAEvC,MAAM,OAAO,GAAG;;;;;;;;;yCASyB,CAAA;AAEzC,MAAM,EAAE,GAAG;;;;;;;;;;;;;;;;;iCAiBsB,CAAA;AAEjC,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;OAeR,CAAA;AAEP,MAAM,KAAK,GAAG;;;;;;;;;;;;uCAYyB,CAAA;AAEvC,MAAM,IAAI,GAAG;;;;;;;;;;uDAU0C,CAAA;AAEvD,MAAM,EAAE,GAAG;;;;;;;;;;;;;;KAcN,CAAA;AAEL,MAAM,aAAa,GAAG;;;;;;;;KAQjB,CAAA;AAEL,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAmEA,CAAA;AAE1B,MAAM,iBAAiB,GAAG;;;;;;;;4DAQkC,CAAA;AAE5D,kEAAkE;AAClE,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;qBAKV,WAAW,GAAG,iBAAiB,GAAG,OAAO,GAAG,iBAAiB,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI;;CAEnH,CAAA;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;qBAKV,WAAW,GAAG,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,aAAa,GAAG,MAAM,GAAG,IAAI;;CAEnF,CAAA"}

package/dist/dts/typeProvider.d.ts

@@ -0,0 +1,37 @@
+import type { FetchDtsWithCache } from './fetchDts.js';
+export type TypeFetchResult = {
+    dts: string;
+    url: string;
+    resolvedPkg?: string;
+};
+export type ModuleShim = {
+    module: string;
+    path: string;
+};
+export interface ResolvedTypeFile {
+    path: string;
+    content: string;
+    ambient?: boolean;
+}
+export interface ResolvedTypeDef {
+    pkg: string;
+    mainPath: string;
+    files: ResolvedTypeFile[];
+    shims: ModuleShim[];
+    ambient?: boolean;
+}
+export declare abstract class TypeProvider {
+    protected fetchDts: FetchDtsWithCache;
+    constructor(fetchDts: FetchDtsWithCache);
+    protected fetchDtsText(url: string): Promise<{
+        dts: string;
+        url: string;
+    } | undefined>;
+    protected tryUrls(urls: string[]): Promise<{
+        dts: string;
+        url: string;
+    } | undefined>;
+    private looksLikeDts;
+    abstract resolve(pkg: string): Promise<TypeFetchResult | undefined>;
+}
+//# sourceMappingURL=typeProvider.d.ts.map

package/dist/dts/typeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeProvider.d.ts","sourceRoot":"","sources":["../../dts/src/typeProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,MAAM,MAAM,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAChF,MAAM,MAAM,UAAU,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAKzD,MAAM,WAAW,gBAAgB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE;AACtF,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,gBAAgB,EAAE,CAAA;IACzB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,8BAAsB,YAAY;IACpB,SAAS,CAAC,QAAQ,EAAE,iBAAiB;gBAA3B,QAAQ,EAAE,iBAAiB;IAEjD,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM;;;;cAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE;;;;IAYtC,OAAO,CAAC,YAAY;IAOpB,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;CACpE"}

package/dist/dts/typeProvider.js

@@ -0,0 +1,30 @@
+export class TypeProvider {
+    constructor(fetchDts) {
+        this.fetchDts = fetchDts;
+    }
+    fetchDtsText(url) {
+        return this.tryUrls([url]);
+    }
+    async tryUrls(urls) {
+        for (const url of urls) {
+            const out = await this.fetchDts(url);
+            if (!out)
+                continue;
+            if (this.looksLikeDts(out.dts))
+                return out;
+            if (/\.(d\.ts|d\.mts)(?:[?#].*)?$/i.test(out.url))
+                return out;
+            if (/[?&]dts(?:[&#]|$)/i.test(out.url))
+                return out;
+        }
+        return undefined;
+    }
+    looksLikeDts(text) {
+        if (/^\s*export\s*\{\s*\}\s*;?\s*$/m.test(text))
+            return true;
+        return /declare\s+(module|namespace|class|interface|function|const|var|let)/.test(text)
+            || /interface\s+\w+/.test(text)
+            || /type\s+\w+\s*=/.test(text);
+    }
+}
+//# sourceMappingURL=typeProvider.js.map

package/dist/dts/typeProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeProvider.js","sourceRoot":"","sources":["../../dts/src/typeProvider.ts"],"names":[],"mappings":"AAiBA,MAAM,OAAgB,YAAY;IAChC,YAAsB,QAA2B;QAA3B,aAAQ,GAAR,QAAQ,CAAmB;IAAG,CAAC;IAE3C,YAAY,CAAC,GAAW;QAChC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;IAC5B,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,IAAc;QACpC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;YACpC,IAAI,CAAC,GAAG;gBAAE,SAAQ;YAElB,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAA;YAC1C,IAAI,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAA;YAC7D,IAAI,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO,GAAG,CAAA;QACpD,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,IAAI,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAA;QAC5D,OAAO,qEAAqE,CAAC,IAAI,CAAC,IAAI,CAAC;eAClF,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;eAC5B,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClC,CAAC;CAGF"}

package/dist/dts/typeRefScanner.d.ts

@@ -0,0 +1,8 @@
+export declare class TypeRefScanner {
+    collectRelativeTypeRefs(text: string): string[];
+    collectBareModuleRefs(text: string): string[];
+    private collectRefs;
+    private matchAll;
+    private isBare;
+}
+//# sourceMappingURL=typeRefScanner.d.ts.map

package/dist/dts/typeRefScanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeRefScanner.d.ts","sourceRoot":"","sources":["../../dts/src/typeRefScanner.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAc;IACzB,uBAAuB,CAAC,IAAI,EAAE,MAAM;IAIpC,qBAAqB,CAAC,IAAI,EAAE,MAAM;IAIlC,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,MAAM;CAGf"}

package/dist/dts/typeRefScanner.js

@@ -0,0 +1,33 @@
+export class TypeRefScanner {
+    collectRelativeTypeRefs(text) {
+        return this.collectRefs(text).filter(s => s.startsWith('./') || s.startsWith('../'));
+    }
+    collectBareModuleRefs(text) {
+        return this.collectRefs(text).filter(s => this.isBare(s));
+    }
+    collectRefs(text) {
+        const refs = new Set();
+        const add = (m, idx) => { refs.add(m[idx]); return null; };
+        this.matchAll(text, /(import|export)\s+[^'"\n]*from\s*['"]([^'"\n]+)['"]/, m => add(m, 2));
+        this.matchAll(text, /export\s*\*\s*from\s*['"]([^'"\n]+)['"]/, m => add(m, 1));
+        return Array.from(refs);
+    }
+    matchAll(text, regex, mapper) {
+        const results = [];
+        try {
+            const re = new RegExp(regex.source, 'g');
+            let m;
+            while ((m = re.exec(text))) {
+                const r = mapper(m);
+                if (r !== null)
+                    results.push(r);
+            }
+        }
+        catch { }
+        return results;
+    }
+    isBare(s) {
+        return !(s.startsWith('./') || s.startsWith('../') || s.startsWith('file:') || s.startsWith('http://') || s.startsWith('https://'));
+    }
+}
+//# sourceMappingURL=typeRefScanner.js.map

package/dist/dts/typeRefScanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeRefScanner.js","sourceRoot":"","sources":["../../dts/src/typeRefScanner.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,cAAc;IACzB,uBAAuB,CAAC,IAAY;QAClC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAA;IACtF,CAAC;IAED,qBAAqB,CAAC,IAAY;QAChC,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;IAC3D,CAAC;IAEO,WAAW,CAAC,IAAY;QAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;QAC9B,MAAM,GAAG,GAAG,CAAC,CAAkB,EAAE,GAAW,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC,CAAA;QAClF,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,qDAAqD,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC1F,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,yCAAyC,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC9E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAEO,QAAQ,CAAI,IAAY,EAAE,KAAa,EAAE,MAA4C;QAC3F,MAAM,OAAO,GAAQ,EAAE,CAAA;QACvB,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YACxC,IAAI,CAAyB,CAAA;YAC7B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;gBACnB,IAAI,CAAC,KAAK,IAAI;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,MAAM,CAAC,CAAS;QACtB,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA;IACrI,CAAC;CACF"}

package/dist/dts/typescriptProvider.d.ts

@@ -0,0 +1,21 @@
+import { type CdnClient } from 'typebulb/resolver';
+import { TypeProvider } from './typeProvider.js';
+import type { FetchDtsWithCache } from './fetchDts.js';
+export declare class TypescriptProvider extends TypeProvider {
+    private cdnClient;
+    constructor(fetchDts: FetchDtsWithCache, cdnClient: CdnClient);
+    private loadPackageAtVersionedRoot;
+    private extractPathFromResult;
+    private tryUntilSuccess;
+    private resolveFromSelected;
+    private toResolutionResult;
+    private resolveExportsPath;
+    resolve(packageRef: string): Promise<{
+        resolvedPkg: string;
+        dts: string;
+        url: string;
+    } | undefined>;
+    private fetchCandidateFrom;
+    declarationCandidatesFor(runtimePath: string): string[];
+}
+//# sourceMappingURL=typescriptProvider.d.ts.map

package/dist/dts/typescriptProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescriptProvider.d.ts","sourceRoot":"","sources":["../../dts/src/typescriptProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAwB,MAAM,mBAAmB,CAAA;AAGtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAatD,qBAAa,kBAAmB,SAAQ,YAAY;IACT,OAAO,CAAC,SAAS;gBAA9C,QAAQ,EAAE,iBAAiB,EAAU,SAAS,EAAE,SAAS;YAIvD,0BAA0B;IAcxC,OAAO,CAAC,qBAAqB;YAMf,eAAe;YAOf,mBAAmB;IAmBjC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,kBAAkB;IAqBpB,OAAO,CAAC,UAAU,EAAE,MAAM;;;;;YA2ClB,kBAAkB;IAOhC,wBAAwB,CAAC,WAAW,EAAE,MAAM;CAU7C"}