typebulb 0.11.9 → 0.13.0

package/dist/dts/typescriptProvider.js

@@ -0,0 +1,140 @@
+import { resolve as resolveExports } from 'resolve.exports';
+import { PackageRef } from 'typebulb/resolver';
+import { TypeProvider } from './typeProvider.js';
+import { DECLARATION_EXTENSIONS, DTS_REGEX, makeDeclarationCandidates } from './dtsConfig.js';
+import { fetchWithRetry } from './httpFetch.js';
+export class TypescriptProvider extends TypeProvider {
+    constructor(fetchDts, cdnClient) {
+        super(fetchDts);
+        this.cdnClient = cdnClient;
+    }
+    async loadPackageAtVersionedRoot(root, version) {
+        const url = this.cdnClient.packageJson(new PackageRef({ name: root, version }));
+        const resp = await fetchWithRetry(url);
+        if (!resp?.ok)
+            return undefined;
+        let pkg;
+        try {
+            pkg = await resp.json();
+        }
+        catch {
+            return undefined;
+        }
+        if (!pkg)
+            return undefined;
+        return {
+            pkg,
+            baseDir: this.cdnClient.baseDir(new PackageRef({ name: root, version: version ?? pkg.version })),
+            version,
+        };
+    }
+    extractPathFromResult(result) {
+        if (typeof result === 'string')
+            return result;
+        if (Array.isArray(result))
+            return result.find(x => typeof x === 'string');
+        return undefined;
+    }
+    async tryUntilSuccess(items, fn) {
+        for (const item of items) {
+            const res = await fn(item);
+            if (res)
+                return res;
+        }
+    }
+    async resolveFromSelected(sel, fetchCandidate) {
+        if (sel.kind === 'types') {
+            const clean = this.cdnClient.normalizeRelative(sel.path);
+            if (!clean || clean === '/' || clean === '.') {
+                return this.tryUntilSuccess([...DECLARATION_EXTENSIONS], fetchCandidate);
+            }
+            if (!DTS_REGEX.test(clean)) {
+                const res = await this.tryUntilSuccess(this.declarationCandidatesFor(clean), fetchCandidate);
+                if (res)
+                    return res;
+            }
+            return fetchCandidate(clean);
+        }
+        const others = this.declarationCandidatesFor(sel.path);
+        return this.tryUntilSuccess([...DECLARATION_EXTENSIONS, ...others], fetchCandidate);
+    }
+    toResolutionResult(path) {
+        return { kind: DTS_REGEX.test(path) ? 'types' : 'probe', path };
+    }
+    resolveExportsPath(pkg, subpath) {
+        const key = subpath || '.';
+        const pkgRecord = pkg;
+        try {
+            const typesPath = this.extractPathFromResult(resolveExports(pkgRecord, key, { conditions: ['types'] }));
+            if (typesPath)
+                return typesPath;
+        }
+        catch { }
+        try {
+            return this.extractPathFromResult(resolveExports(pkgRecord, key, {
+                browser: true,
+                conditions: ['import', 'default', 'module', 'browser', 'node'],
+            }));
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async resolve(packageRef) {
+        try {
+            const parsed = PackageRef.parse(packageRef);
+            const { pkg, baseDir } = await this.loadPackageAtVersionedRoot(parsed.name, parsed.version) || {};
+            if (!pkg || !baseDir)
+                return undefined;
+            const resolvedBase = { name: parsed.name, version: parsed.version };
+            const resolvedRootPkg = new PackageRef(resolvedBase).format();
+            const resolvedFullPkg = new PackageRef({ ...resolvedBase, subpath: parsed.subpath }).format();
+            const fetcher = (rel) => this.fetchCandidateFrom(baseDir, parsed.name, rel);
+            if (parsed.subpath) {
+                const key = this.cdnClient.ensureLeadingDotSlash(parsed.subpath);
+                const expPath = this.resolveExportsPath(pkg, key);
+                if (expPath) {
+                    const res = await this.resolveFromSelected(this.toResolutionResult(expPath), fetcher);
+                    if (res)
+                        return { ...res, resolvedPkg: resolvedFullPkg };
+                }
+                const res = await this.tryUntilSuccess(this.declarationCandidatesFor(key), fetcher);
+                if (res)
+                    return { ...res, resolvedPkg: resolvedFullPkg };
+            }
+            const declared = pkg.types ?? pkg.typings;
+            if (declared) {
+                const res = await this.resolveFromSelected({ kind: 'types', path: declared }, fetcher);
+                if (res)
+                    return { ...res, resolvedPkg: resolvedRootPkg };
+            }
+            const rootExport = this.resolveExportsPath(pkg, '.');
+            if (rootExport) {
+                const res = await this.resolveFromSelected(this.toResolutionResult(rootExport), fetcher);
+                if (res)
+                    return { ...res, resolvedPkg: resolvedRootPkg };
+            }
+            return undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    async fetchCandidateFrom(baseDir, root, rel) {
+        const relNorm = this.cdnClient.normalizeRelative(rel);
+        const url = new URL(relNorm, baseDir).toString();
+        const out = await this.fetchDtsText(url);
+        return out ? { dts: out.dts, url: out.url, resolvedPkg: root } : undefined;
+    }
+    declarationCandidatesFor(runtimePath) {
+        if (!runtimePath || runtimePath === './' || runtimePath === '/') {
+            return [...DECLARATION_EXTENSIONS];
+        }
+        const base = runtimePath.replace(/\.(mjs|cjs|js|mts|cts|ts)$/i, '');
+        const candidates = makeDeclarationCandidates(base);
+        const trailingBase = base.endsWith('/') ? base : `${base}/`;
+        candidates.push(...makeDeclarationCandidates(`${trailingBase}index`));
+        return candidates;
+    }
+}
+//# sourceMappingURL=typescriptProvider.js.map

package/dist/dts/typescriptProvider.js.map

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

package/dist/dts/virtualFs.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Virtual filesystem layout for DTS resolution. Each entry lives under
+ * `file:///node_modules/__tsepoch_N/<pkg>/...`. The CLI's emit step strips
+ * the epoch and writes real files; the web client's TypeChecker treats
+ * these paths as virtual.
+ *
+ * Epoch is bumpable so reactive consumers (web client) can invalidate the
+ * world when package ranges change. CLI never bumps within a single emit.
+ */
+export declare class VirtualFs {
+    private epoch;
+    private listeners;
+    getEpoch(): number;
+    bumpEpoch(): number;
+    onEpochChange(cb: (n: number) => void): () => void;
+    epochDir(): string;
+    pathForMain(pkg: string): string;
+    pathFor(pkg: string, rel: string): string;
+}
+//# sourceMappingURL=virtualFs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"virtualFs.d.ts","sourceRoot":"","sources":["../../dts/src/virtualFs.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,SAAS,CAAiC;IAElD,QAAQ,IAAI,MAAM;IAIlB,SAAS,IAAI,MAAM;IAQnB,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI;IAKlD,QAAQ,IAAI,MAAM;IAIlB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIhC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;CAI1C"}

package/dist/dts/virtualFs.js

@@ -0,0 +1,48 @@
+const NODE_MODULES_PREFIX = 'file:///node_modules';
+/**
+ * Virtual filesystem layout for DTS resolution. Each entry lives under
+ * `file:///node_modules/__tsepoch_N/<pkg>/...`. The CLI's emit step strips
+ * the epoch and writes real files; the web client's TypeChecker treats
+ * these paths as virtual.
+ *
+ * Epoch is bumpable so reactive consumers (web client) can invalidate the
+ * world when package ranges change. CLI never bumps within a single emit.
+ */
+export class VirtualFs {
+    constructor() {
+        this.epoch = 0;
+        this.listeners = new Set();
+    }
+    getEpoch() {
+        return this.epoch;
+    }
+    bumpEpoch() {
+        this.epoch += 1;
+        for (const l of this.listeners) {
+            try {
+                l(this.epoch);
+            }
+            catch { }
+        }
+        return this.epoch;
+    }
+    onEpochChange(cb) {
+        this.listeners.add(cb);
+        return () => { this.listeners.delete(cb); };
+    }
+    epochDir() {
+        return `__tsepoch_${this.epoch}`;
+    }
+    pathForMain(pkg) {
+        return `${NODE_MODULES_PREFIX}/${this.epochDir()}/${pkg}/index.d.ts`;
+    }
+    pathFor(pkg, rel) {
+        const clean = normalizeRelative(rel);
+        return `${NODE_MODULES_PREFIX}/${this.epochDir()}/${pkg}/${clean}`;
+    }
+}
+function normalizeRelative(rel) {
+    const s = rel || '';
+    return s.startsWith('./') ? s.slice(2) : s.replace(/^\/+/, '');
+}
+//# sourceMappingURL=virtualFs.js.map

package/dist/dts/virtualFs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualFs.js","sourceRoot":"","sources":["../../dts/src/virtualFs.ts"],"names":[],"mappings":"AAAA,MAAM,mBAAmB,GAAG,sBAAsB,CAAA;AAElD;;;;;;;;GAQG;AACH,MAAM,OAAO,SAAS;IAAtB;QACU,UAAK,GAAG,CAAC,CAAA;QACT,cAAS,GAAG,IAAI,GAAG,EAAuB,CAAA;IA+BpD,CAAC;IA7BC,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,SAAS;QACP,IAAI,CAAC,KAAK,IAAI,CAAC,CAAA;QACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,IAAI,CAAC;gBAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QAChC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,aAAa,CAAC,EAAuB;QACnC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACtB,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA,CAAC,CAAC,CAAA;IAC5C,CAAC;IAED,QAAQ;QACN,OAAO,aAAa,IAAI,CAAC,KAAK,EAAE,CAAA;IAClC,CAAC;IAED,WAAW,CAAC,GAAW;QACrB,OAAO,GAAG,mBAAmB,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,aAAa,CAAA;IACtE,CAAC;IAED,OAAO,CAAC,GAAW,EAAE,GAAW;QAC9B,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAA;QACpC,OAAO,GAAG,mBAAmB,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,KAAK,EAAE,CAAA;IACpE,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,CAAC,GAAG,GAAG,IAAI,EAAE,CAAA;IACnB,OAAO,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AAChE,CAAC"}

package/dist/format/chunks.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Split the `data.txt` block into chunks. The single source of truth, shared by the CLI and
+ * typebulb.com.
+ *
+ * Rules:
+ * - A valid structural format (JSON/XML/YAML) → a single chunk (preserves internal blank lines).
+ * - Otherwise → split on 2+ blank lines.
+ */
+/** Separator for rejoining chunks (2 blank lines = 3 newlines). */
+export declare const CHUNK_SEPARATOR = "\n\n\n";
+export type ChunkWithBoundaries = {
+    text: string;
+    startLine: number;
+    endLine: number;
+};
+/** Split raw data into chunks with their 1-based line boundaries. */
+export declare function splitIntoChunksWithBoundaries(raw: string): ChunkWithBoundaries[];
+/** Convenience: just the chunk texts. */
+export declare function splitIntoChunks(raw: string): string[];
+//# sourceMappingURL=chunks.d.ts.map

package/dist/format/chunks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks.d.ts","sourceRoot":"","sources":["../../format/src/chunks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,mEAAmE;AACnE,eAAO,MAAM,eAAe,WAAW,CAAA;AAEvC,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtF,qEAAqE;AACrE,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAiChF;AAED,yCAAyC;AACzC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAErD"}

package/dist/format/chunks.js

@@ -0,0 +1,51 @@
+/**
+ * Split the `data.txt` block into chunks. The single source of truth, shared by the CLI and
+ * typebulb.com.
+ *
+ * Rules:
+ * - A valid structural format (JSON/XML/YAML) → a single chunk (preserves internal blank lines).
+ * - Otherwise → split on 2+ blank lines.
+ */
+import { isStructuralData } from './detection.js';
+/** Separator for rejoining chunks (2 blank lines = 3 newlines). */
+export const CHUNK_SEPARATOR = '\n\n\n';
+/** Split raw data into chunks with their 1-based line boundaries. */
+export function splitIntoChunksWithBoundaries(raw) {
+    if (!raw?.trim())
+        return [];
+    const normalized = raw.replace(/\r\n/g, '\n');
+    const trimmed = normalized.trim();
+    if (isStructuralData(trimmed)) {
+        return [{ text: trimmed, startLine: 1, endLine: normalized.split('\n').length }];
+    }
+    const lines = normalized.split('\n');
+    const chunks = [];
+    let start = 0, lastContent = -1, blankRun = 0;
+    const flush = () => {
+        if (lastContent >= start) {
+            const text = lines.slice(start, lastContent + 1).join('\n').trim();
+            if (text)
+                chunks.push({ text, startLine: start + 1, endLine: lastContent + 1 });
+        }
+    };
+    for (let i = 0; i < lines.length; i++) {
+        if (!lines[i].trim()) {
+            blankRun++;
+        }
+        else {
+            if (blankRun >= 2 && lastContent >= start) {
+                flush();
+                start = i;
+            }
+            blankRun = 0;
+            lastContent = i;
+        }
+    }
+    flush();
+    return chunks;
+}
+/** Convenience: just the chunk texts. */
+export function splitIntoChunks(raw) {
+    return splitIntoChunksWithBoundaries(raw).map(c => c.text);
+}
+//# sourceMappingURL=chunks.js.map

package/dist/format/chunks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunks.js","sourceRoot":"","sources":["../../format/src/chunks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAEjD,mEAAmE;AACnE,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAA;AAIvC,qEAAqE;AACrE,MAAM,UAAU,6BAA6B,CAAC,GAAW;IACvD,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,CAAA;IAE3B,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAA;IAEjC,IAAI,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAA;IAClF,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpC,MAAM,MAAM,GAA0B,EAAE,CAAA;IACxC,IAAI,KAAK,GAAG,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,CAAC,CAAA;IAE7C,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,WAAW,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAA;YAClE,IAAI,IAAI;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,CAAC,EAAE,CAAC,CAAA;QACjF,CAAC;IACH,CAAC,CAAA;IAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACrB,QAAQ,EAAE,CAAA;QACZ,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,IAAI,CAAC,IAAI,WAAW,IAAI,KAAK,EAAE,CAAC;gBAAC,KAAK,EAAE,CAAC;gBAAC,KAAK,GAAG,CAAC,CAAA;YAAC,CAAC;YACjE,QAAQ,GAAG,CAAC,CAAA;YACZ,WAAW,GAAG,CAAC,CAAA;QACjB,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAA;IAEP,OAAO,MAAM,CAAA;AACf,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,6BAA6B,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC"}

package/dist/format/config.d.ts

@@ -0,0 +1,17 @@
+/** The `config.json` block shape — dependencies, description, and inference-modal settings. */
+export interface InferenceConfig {
+    title?: string;
+    dataTitle?: string;
+    submitTitle?: string;
+}
+export interface BulbConfig {
+    dependencies?: Record<string, string>;
+    description?: string;
+    inference?: InferenceConfig;
+    ts?: {
+        jsxImportSource?: string;
+    };
+}
+/** Parse the `config.json` block, returning {} for empty or malformed JSON. */
+export declare function parseConfig(config: string): BulbConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/format/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../format/src/config.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAE/F,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,eAAe,CAAA;IAC3B,EAAE,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAClC;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAOtD"}

package/dist/format/config.js

@@ -0,0 +1,13 @@
+/** The `config.json` block shape — dependencies, description, and inference-modal settings. */
+/** Parse the `config.json` block, returning {} for empty or malformed JSON. */
+export function parseConfig(config) {
+    if (!config.trim())
+        return {};
+    try {
+        return JSON.parse(config);
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/format/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../format/src/config.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAe/F,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAA;IAC7B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAA;IACX,CAAC;AACH,CAAC"}

package/dist/format/detection.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Structural data-format detection for the `data.txt` block. The single source of truth for "is this
+ * chunk JSON / XML / YAML", shared by the data-chunk splitter (here) and typebulb.com's summarizer
+ * selection (its JSON/XML/YAML summarizers' `canHandle` delegate to these).
+ */
+export declare function isJsonData(content: string): boolean;
+export declare function isXmlData(content: string): boolean;
+export declare function isYamlData(content: string): boolean;
+/** True if content is a structural format (JSON/XML/YAML) — kept as a single data chunk. */
+export declare function isStructuralData(content: string): boolean;
+//# sourceMappingURL=detection.d.ts.map

package/dist/format/detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.d.ts","sourceRoot":"","sources":["../../format/src/detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAKlD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQnD;AAED,4FAA4F;AAC5F,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEzD"}

package/dist/format/detection.js

@@ -0,0 +1,43 @@
+/**
+ * Structural data-format detection for the `data.txt` block. The single source of truth for "is this
+ * chunk JSON / XML / YAML", shared by the data-chunk splitter (here) and typebulb.com's summarizer
+ * selection (its JSON/XML/YAML summarizers' `canHandle` delegate to these).
+ */
+import { findTagByName } from 'xml-utils';
+import * as yaml from 'yaml';
+const XML_TAG_RE = /<([a-zA-Z_][\w.-]*)/;
+export function isJsonData(content) {
+    try {
+        JSON.parse(content.trim());
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function isXmlData(content) {
+    const t = content.trim();
+    if (!t.startsWith('<'))
+        return false;
+    const m = t.match(XML_TAG_RE);
+    return m ? findTagByName(t, m[1]) !== null : false;
+}
+export function isYamlData(content) {
+    const trimmed = content.trim();
+    if (!trimmed.match(/^(---|#|\w+:|-)/))
+        return false;
+    if ('[{<'.includes(trimmed[0]))
+        return false;
+    try {
+        const parsed = yaml.parse(trimmed);
+        return parsed !== null && typeof parsed === 'object';
+    }
+    catch {
+        return false;
+    }
+}
+/** True if content is a structural format (JSON/XML/YAML) — kept as a single data chunk. */
+export function isStructuralData(content) {
+    return isJsonData(content) || isXmlData(content) || isYamlData(content);
+}
+//# sourceMappingURL=detection.js.map

package/dist/format/detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detection.js","sourceRoot":"","sources":["../../format/src/detection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAE5B,MAAM,UAAU,GAAG,qBAAqB,CAAA;AAExC,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,IAAI,CAAC;QAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,IAAI,CAAA;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAA;IAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IACxB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACpC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAA;IAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,CAAC;QAAE,OAAO,KAAK,CAAA;IACnD,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAA;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QAClC,OAAO,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAA;IACtD,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAA;IAAC,CAAC;AAC1B,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,UAAU,CAAC,OAAO,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAA;AACzE,CAAC"}

package/dist/format/index.d.ts

@@ -0,0 +1,8 @@
+export * from './registry.js';
+export * from './parse.js';
+export * from './serialize.js';
+export * from './config.js';
+export * from './detection.js';
+export * from './chunks.js';
+export { escapeYamlString, unescapeYamlString } from './yaml.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/format/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/index.js

@@ -0,0 +1,8 @@
+export * from './registry.js';
+export * from './parse.js';
+export * from './serialize.js';
+export * from './config.js';
+export * from './detection.js';
+export * from './chunks.js';
+export { escapeYamlString, unescapeYamlString } from './yaml.js';
+//# sourceMappingURL=index.js.map

package/dist/format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../format/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAA"}

package/dist/format/parse.d.ts

@@ -0,0 +1,20 @@
+/** Parse a `.bulb.md` file: strict Markdown bundle with YAML frontmatter and `**filename**` blocks. */
+import { type SubscriptKind } from './registry.js';
+export interface BulbFrontmatter {
+    format: string;
+    name: string;
+}
+export interface ParsedBulb {
+    frontmatter: BulbFrontmatter;
+    /** Block contents keyed by filename (e.g. `code.tsx`). */
+    files: Map<string, string>;
+}
+/** Structured per-block content, keyed by kind. */
+export type BulbData = {
+    name: string;
+} & Record<SubscriptKind, string>;
+/** Parse a `.bulb.md` file into frontmatter and file contents, or null if malformed. */
+export declare function parseBulb(content: string): ParsedBulb | null;
+/** Convert a parsed bulb to a structured per-kind object (missing blocks become ''). */
+export declare function toBulbData(parsed: ParsedBulb): BulbData;
+//# sourceMappingURL=parse.d.ts.map

package/dist/format/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../format/src/parse.ts"],"names":[],"mappings":"AAAA,uGAAuG;AAEvG,OAAO,EAAE,KAAK,aAAa,EAAsC,MAAM,eAAe,CAAA;AAGtF,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,eAAe,CAAA;IAC5B,0DAA0D;IAC1D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC3B;AAED,mDAAmD;AACnD,MAAM,MAAM,QAAQ,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;AAEvE,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA2D5D;AAsBD,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAKvD"}

package/dist/format/parse.js

@@ -0,0 +1,88 @@
+/** Parse a `.bulb.md` file: strict Markdown bundle with YAML frontmatter and `**filename**` blocks. */
+import { blocks, orderedKinds, isBulbFormat } from './registry.js';
+import { unescapeYamlString } from './yaml.js';
+/** Parse a `.bulb.md` file into frontmatter and file contents, or null if malformed. */
+export function parseBulb(content) {
+    try {
+        const lines = content.split('\n');
+        let i = 0;
+        // Parse frontmatter
+        if (lines[i]?.trim() !== '---')
+            return null;
+        i++;
+        const frontmatterLines = [];
+        while (i < lines.length && lines[i]?.trim() !== '---') {
+            frontmatterLines.push(lines[i]);
+            i++;
+        }
+        if (lines[i]?.trim() !== '---')
+            return null;
+        i++;
+        const frontmatter = parseFrontmatter(frontmatterLines);
+        if (!frontmatter)
+            return null;
+        // Parse file sections
+        const files = new Map();
+        while (i < lines.length) {
+            const line = lines[i]?.trim();
+            // Look for **filename** (bold markdown, tolerant of whitespace)
+            const fileMatch = line?.match(/^\*\*(.+)\*\*$/);
+            if (fileMatch) {
+                const filename = fileMatch[1].trim();
+                i++;
+                // Skip empty lines until fence
+                while (i < lines.length && lines[i]?.trim() === '')
+                    i++;
+                // Parse fenced code block (tolerant of trailing whitespace)
+                const fenceMatch = lines[i]?.match(/^(`{3,})(\w*)\s*$/);
+                if (!fenceMatch) {
+                    i++;
+                    continue;
+                }
+                const fence = fenceMatch[1];
+                i++;
+                const contentLines = [];
+                while (i < lines.length && !lines[i]?.match(new RegExp(`^${fence}\\s*$`))) {
+                    contentLines.push(lines[i]);
+                    i++;
+                }
+                i++; // Skip closing fence
+                files.set(filename, contentLines.join('\n'));
+            }
+            else {
+                i++;
+            }
+        }
+        return { frontmatter, files };
+    }
+    catch {
+        return null;
+    }
+}
+function parseFrontmatter(lines) {
+    const fm = {};
+    for (const line of lines) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = line.slice(0, colonIdx).trim();
+        const value = line.slice(colonIdx + 1).trim();
+        switch (key) {
+            case 'format':
+                fm.format = value;
+                break;
+            case 'name':
+                fm.name = unescapeYamlString(value);
+                break;
+        }
+    }
+    if (!isBulbFormat(fm.format) || !fm.name)
+        return null;
+    return fm;
+}
+/** Convert a parsed bulb to a structured per-kind object (missing blocks become ''). */
+export function toBulbData(parsed) {
+    const kinds = Object.fromEntries(orderedKinds.map(kind => [kind, parsed.files.get(blocks[kind].path) || '']));
+    return { name: parsed.frontmatter.name, ...kinds };
+}
+//# sourceMappingURL=parse.js.map

package/dist/format/parse.js.map

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

package/dist/format/registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The canonical bulb block registry — the single source of truth for what blocks a bulb has,
+ * their filenames, and their languages. Both the typebulb CLI and the typebulb.com editor derive
+ * their block handling from this; the editor extends each entry with its own presentation fields.
+ *
+ * `server.ts` is intentionally not here: it is a CLI-only block (local Node code), owned by the CLI.
+ */
+export type SubscriptKind = 'code' | 'css' | 'html' | 'config' | 'notes' | 'data' | 'infer' | 'insight';
+export type SubscriptPath = 'code.tsx' | 'index.html' | 'styles.css' | 'config.json' | 'notes.md' | 'data.txt' | 'infer.md' | 'insight.json';
+export interface BlockSpec {
+    path: SubscriptPath;
+    language: string;
+}
+export declare const blocks: Record<SubscriptKind, BlockSpec>;
+/** Block order as serialized in a `.bulb.md` file. */
+export declare const orderedKinds: SubscriptKind[];
+/** Look up the kind that owns a given filename (e.g. `code.tsx` → `code`). */
+export declare function kindFromPath(path: string): SubscriptKind | undefined;
+/** Bulb file format identifier (YAML frontmatter `format:`) and file extension. */
+export declare const BULB_FORMAT = "typebulb/v1";
+export declare const BULB_EXT = ".bulb.md";
+/** A bulb's frontmatter `format:` value is recognised iff it starts with `typebulb`. */
+export declare function isBulbFormat(format: string | undefined): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/dist/format/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../format/src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;AAEvG,MAAM,MAAM,aAAa,GACrB,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,GACxD,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,CAAA;AAEzD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,eAAO,MAAM,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,SAAS,CASnD,CAAA;AAED,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,aAAa,EAA2E,CAAA;AAEnH,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEpE;AAED,mFAAmF;AACnF,eAAO,MAAM,WAAW,gBAAgB,CAAA;AACxC,eAAO,MAAM,QAAQ,aAAa,CAAA;AAElC,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhE"}

package/dist/format/registry.js

@@ -0,0 +1,31 @@
+/**
+ * The canonical bulb block registry — the single source of truth for what blocks a bulb has,
+ * their filenames, and their languages. Both the typebulb CLI and the typebulb.com editor derive
+ * their block handling from this; the editor extends each entry with its own presentation fields.
+ *
+ * `server.ts` is intentionally not here: it is a CLI-only block (local Node code), owned by the CLI.
+ */
+export const blocks = {
+    code: { path: 'code.tsx', language: 'typescript' },
+    css: { path: 'styles.css', language: 'css' },
+    html: { path: 'index.html', language: 'html' },
+    config: { path: 'config.json', language: 'json' },
+    notes: { path: 'notes.md', language: 'markdown' },
+    data: { path: 'data.txt', language: 'text' },
+    infer: { path: 'infer.md', language: 'markdown' },
+    insight: { path: 'insight.json', language: 'json' },
+};
+/** Block order as serialized in a `.bulb.md` file. */
+export const orderedKinds = ['code', 'css', 'html', 'data', 'infer', 'insight', 'config', 'notes'];
+/** Look up the kind that owns a given filename (e.g. `code.tsx` → `code`). */
+export function kindFromPath(path) {
+    return orderedKinds.find(kind => blocks[kind].path === path);
+}
+/** Bulb file format identifier (YAML frontmatter `format:`) and file extension. */
+export const BULB_FORMAT = 'typebulb/v1';
+export const BULB_EXT = '.bulb.md';
+/** A bulb's frontmatter `format:` value is recognised iff it starts with `typebulb`. */
+export function isBulbFormat(format) {
+    return !!format?.startsWith('typebulb');
+}
+//# sourceMappingURL=registry.js.map

package/dist/format/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../format/src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,CAAC,MAAM,MAAM,GAAqC;IACtD,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,YAAY,EAAE;IAClD,GAAG,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE;IAC5C,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE;IAC9C,MAAM,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,EAAE;IACjD,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACjD,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE;IAC5C,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE;IACjD,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE;CACpD,CAAA;AAED,sDAAsD;AACtD,MAAM,CAAC,MAAM,YAAY,GAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;AAEnH,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC9D,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAA;AACxC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,CAAA;AAElC,wFAAwF;AACxF,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,OAAO,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;AACzC,CAAC"}