@nshiab/setup-data-project 2.0.3 → 3.0.0

package/esm/helpers/ensureAgents.js

@@ -1,186 +0,0 @@
-import { log } from "@clack/prompts";
-import { ensureManagedSection } from "./ensureManagedSection.js";
-import { getInstalledPackageConfigs, SUPPORTED_PACKAGES, } from "./packageRegistry.js";
-export function ensureAgents(docsMapping, runtime, installedPackages = Object.keys(docsMapping)) {
-    let journalismFunctions = "";
-    let sdaClassesAndMethods = "";
-    let sdaDocsPath = "";
-    let sdaReadmePath = "";
-    let sdaLibraryName = "";
-    const journalismFunctionsByPackage = new Map();
-    for (const [pkg, docs] of Object.entries(docsMapping)) {
-        const pkgConfig = SUPPORTED_PACKAGES.find((p) => p.value === pkg);
-        const pkgType = pkgConfig?.type || "other";
-        const doc = docs.llm;
-        if (doc === undefined)
-            continue;
-        if (pkgType === "journalism") {
-            const repoName = pkg.split("/")[1];
-            const functions = doc
-                .split("\n")
-                .filter((line) => line.trim().startsWith("#"))
-                .filter((line) => {
-                const depth = line.match(/^#+/)?.[0].length || 0;
-                return depth === 2;
-            })
-                .map((line) => line.replace(/^#+\s+/, "").trim());
-            journalismFunctionsByPackage.set(pkg, functions);
-            journalismFunctions += `\n### ${repoName}\n\n`;
-            journalismFunctions += functions.map((name) => `- ${name}`).join("\n") +
-                "\n";
-        }
-        else if (pkgType === "sda") {
-            const repoName = pkg.split("/")[1];
-            sdaDocsPath = `./docs/${repoName}/llm.md`;
-            sdaReadmePath = docs.readme === undefined
-                ? ""
-                : `./docs/${repoName}/README.md`;
-            sdaLibraryName = pkgConfig?.label || repoName;
-            sdaClassesAndMethods = doc
-                .split("\n")
-                .filter((line) => line.trim().startsWith("#"))
-                .filter((line) => {
-                const depth = line.match(/^#+/)?.[0].length || 0;
-                if (depth === 2)
-                    return true;
-                if (depth !== 4)
-                    return false;
-                const heading = line.replace(/^#+\s+/, "").replaceAll("`", "")
-                    .trim();
-                return heading !== "Parameters";
-            })
-                .map((line) => {
-                const depth = line.match(/^#+/)?.[0].length || 0;
-                if (depth === 2) {
-                    return "\n" + line.replace(/^#+\s+/, "").trim();
-                }
-                else {
-                    return line.replace(/^#+\s+/, "  - ")
-                        .replaceAll("`", "");
-                }
-            })
-                .join("\n");
-        }
-    }
-    const configFile = runtime === "deno" ? "deno.json" : "package.json";
-    const runSdaOnce = runtime === "deno"
-        ? "deno run -A --env --check sda/main.ts"
-        : runtime === "bun"
-            ? "bun run sda/main.ts"
-            : "node --env-file-if-exists=.env --experimental-strip-types sda/main.ts";
-    const runClean = runtime === "deno" ? "deno task clean" : "npm run clean";
-    const runAllTests = runtime === "deno"
-        ? "deno task all-tests"
-        : runtime === "bun"
-            ? "bun run all-tests"
-            : "npm run all-tests";
-    const installedPackageConfigs = getInstalledPackageConfigs(installedPackages);
-    const importExamples = installedPackageConfigs.flatMap((pkg) => {
-        if (pkg.type === "sda") {
-            return [`import { SimpleDB } from "${pkg.value}";`];
-        }
-        const functionName = journalismFunctionsByPackage.get(pkg.value)
-            ?.map((name) => name.replaceAll("`", ""))
-            .find((name) => /^[A-Za-z_$][\w$]*$/.test(name));
-        return functionName
-            ? [`import { ${functionName} } from "${pkg.value}";`]
-            : [];
-    });
-    let libraryGuidance = "";
-    if (installedPackageConfigs.length > 0) {
-        const libraryNames = installedPackageConfigs.map((pkg) => `"${pkg.value}"`)
-            .join(", ");
-        const libraryNoun = installedPackageConfigs.length === 1
-            ? "library"
-            : "libraries";
-        libraryGuidance = `
-Always prioritize the installed ${libraryNames} ${libraryNoun} when relevant.
-`;
-        const documentationGuidance = installedPackageConfigs.flatMap((pkg) => {
-            const docs = docsMapping[pkg.value];
-            if (!docs)
-                return [];
-            if (docs.plot) {
-                return [
-                    "- `@observablehq/plot`: use Observable Plot to create charts and maps " +
-                        "with `writeChart` and `writeMap`. Import with " +
-                        '`import { plot } from "@observablehq/plot";`. ' +
-                        "Documentation and examples at `./docs/observable-plot/llm.md`",
-                ];
-            }
-            const repoName = pkg.value.split("/")[1];
-            const availableDocs = [
-                docs.readme === undefined
-                    ? ""
-                    : `overview and practical examples at \`./docs/${repoName}/README.md\``,
-                docs.llm === undefined
-                    ? ""
-                    : `complete API documentation at \`./docs/${repoName}/llm.md\``,
-            ].filter(Boolean);
-            return availableDocs.length === 0
-                ? []
-                : [`- \`${pkg.value}\`: ${availableDocs.join("; ")}`];
-        });
-        if (documentationGuidance.length > 0) {
-            libraryGuidance += `
-The \`docs/\` folder contains long, exhaustive library references. Search for the relevant methods or topics, then read only the matching sections and any related definitions or examples you need.
-
-The following documentation was fetched for the exact installed library versions. Consult it when relevant:
-
-${documentationGuidance.join("\n")}
-`;
-        }
-        if (importExamples.length > 0) {
-            libraryGuidance += `APIs can be imported like this:
-\`\`\`typescript
-${importExamples.join("\n")}
-\`\`\`
-`;
-        }
-    }
-    let content = `Always verify if there is a ${configFile} file in the root of the project and familiarize yourself with the scripts available in it and the libraries already installed in the project.
-
-Run \`sda/main.ts\` with \`${runSdaOnce}\`. Do not use the \`sda\` task for agent-driven checks because it runs in watch mode and will keep waiting for file changes.
-
-Before handing off your work, always run \`${runAllTests}\`, even if no tests have been added yet. Fix any errors or warnings it reports.
-
-The \`clean\` task (e.g. \`${runClean}\`) removes caches and other temporary files. Do not run it routinely. Cached results can be especially valuable for computationally expensive operations or API calls. If you are unsure whether the caches should be removed, ask the user first.
-
-Always use "sda/main.ts" as the entry point.
-
-If you need to create other TypeScript files, create them in the "sda/helpers" folder. Prioritize the use of helper functions to keep the code well organized and maintainable, with one helper function per file, with the file named after the function. Prioritize default exports for helper functions.
-
-Put tests in the "sda/tests" folder. Write focused tests for reusable helpers and important data transformations when appropriate. When testing a helper from "sda/helpers/functionName.ts", name its test file "sda/tests/functionName.test.ts".
-
-If you need to download data, always put the files in the "sda/data" folder, which is ignored by Git.
-
-If you need to output data to a file, always put the file in the "sda/output" folder, which is also ignored by Git.
-${libraryGuidance}`;
-    if (journalismFunctions !== "") {
-        content += `
-Here are the functions available in the "journalism" libraries. If one of the functions might be relevant, search its complete API documentation in the corresponding \`./docs/<library-name>/llm.md\` file to properly use it.
-${journalismFunctions}`;
-    }
-    if (sdaClassesAndMethods !== "") {
-        const readmeGuidance = sdaReadmePath === ""
-            ? ""
-            : ` An overview and practical examples are available at "${sdaReadmePath}".`;
-        content += `
-Here are the classes and their methods available in the "${sdaLibraryName}" library.${readmeGuidance} If one of the classes or methods might be relevant, search the complete API documentation at "${sdaDocsPath}" to properly use it.
-
-Most data-loading and transformation methods are synchronous, chainable builders. Await the final asynchronous observer or export method, such as \`log()\`, \`getData()\`, or \`writeData()\`, to execute the queued operations. If a chain ends without an observer, call \`run()\`. Always call \`await sdb.close()\` when the database is no longer needed. Methods that return an answer or export to an external service can be asynchronous, so verify their documentation before calling them.
-${sdaClassesAndMethods}`;
-    }
-    const status = ensureManagedSection({
-        path: "AGENTS.md",
-        name: "agents",
-        content,
-        createContent: (managedSection) => managedSection,
-    });
-    if (status === "created") {
-        log.info("Created AGENTS.md");
-    }
-    else if (status === "updated") {
-        log.info("Updated AGENTS.md");
-    }
-}

package/esm/helpers/ensureEnvFile.d.ts

@@ -1,2 +0,0 @@
-export declare function ensureEnvFile(): void;
-//# sourceMappingURL=ensureEnvFile.d.ts.map

package/esm/helpers/ensureEnvFile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ensureEnvFile.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureEnvFile.ts"],"names":[],"mappings":"AAGA,wBAAgB,aAAa,SAK5B"}

package/esm/helpers/ensureEnvFile.js

@@ -1,8 +0,0 @@
-import { lstatSync, writeFileSync } from "node:fs";
-import { log } from "@clack/prompts";
-export function ensureEnvFile() {
-    if (lstatSync(".env", { throwIfNoEntry: false }) === undefined) {
-        writeFileSync(".env", "");
-        log.info("Created .env");
-    }
-}

package/esm/helpers/ensureGitignore.d.ts

@@ -1,3 +0,0 @@
-export declare const GITIGNORE_SENTINEL = "# Added by setup-data-project. Do not remove this line.";
-export declare function ensureGitignore(): void;
-//# sourceMappingURL=ensureGitignore.d.ts.map

package/esm/helpers/ensureGitignore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ensureGitignore.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureGitignore.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,4DAC4B,CAAC;AAE5D,wBAAgB,eAAe,SA0B9B"}

package/esm/helpers/ensureGitignore.js

@@ -1,24 +0,0 @@
-import { lstatSync, readFileSync, writeFileSync } from "node:fs";
-import { log } from "@clack/prompts";
-import { GITIGNORE_ENTRIES } from "./gitignoreEntries.js";
-export const GITIGNORE_SENTINEL = "# Added by setup-data-project. Do not remove this line.";
-export function ensureGitignore() {
-    const path = ".gitignore";
-    const stats = lstatSync(path, { throwIfNoEntry: false });
-    if (stats?.isSymbolicLink()) {
-        return;
-    }
-    const content = stats === undefined ? "" : readFileSync(path, "utf-8");
-    const hasSentinel = content.split("\n").some((line) => line.trim() === GITIGNORE_SENTINEL);
-    if (hasSentinel) {
-        return;
-    }
-    const separator = content === ""
-        ? ""
-        : content.endsWith("\n")
-            ? "\n"
-            : "\n\n";
-    const block = `${GITIGNORE_SENTINEL}\n${GITIGNORE_ENTRIES.join("\n")}\n`;
-    writeFileSync(path, content + separator + block);
-    log.info(`${stats === undefined ? "Created" : "Updated"} ${path}`);
-}

package/esm/helpers/ensureManagedSection.d.ts

@@ -1,9 +0,0 @@
-interface ManagedSectionOptions {
-    path: string;
-    name: string;
-    content: string;
-    createContent: (section: string) => string;
-}
-export declare function ensureManagedSection(options: ManagedSectionOptions): "created" | "updated" | "unchanged" | "missing-markers";
-export {};
-//# sourceMappingURL=ensureManagedSection.d.ts.map

package/esm/helpers/ensureManagedSection.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ensureManagedSection.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureManagedSection.ts"],"names":[],"mappings":"AAGA,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CAC5C;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,qBAAqB,GAC7B,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,iBAAiB,CAwCzD"}

package/esm/helpers/ensureManagedSection.js

@@ -1,33 +0,0 @@
-import { log } from "@clack/prompts";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-export function ensureManagedSection(options) {
-    const startMarker = `<!-- Do not remove / setup-data-project:${options.name}:start -->`;
-    const endMarker = `<!-- Do not remove / setup-data-project:${options.name}:end -->`;
-    const trimmedContent = options.content.trim();
-    const section = trimmedContent === ""
-        ? `${startMarker}\n${endMarker}`
-        : `${startMarker}\n${trimmedContent}\n${endMarker}`;
-    if (!existsSync(options.path)) {
-        writeFileSync(options.path, ensureFinalNewline(options.createContent(section)));
-        return "created";
-    }
-    const currentContent = readFileSync(options.path, "utf-8");
-    const start = currentContent.indexOf(startMarker);
-    const end = currentContent.indexOf(endMarker);
-    if (start === -1 || end === -1 || end < start) {
-        log.warn(`${options.path} was not updated because its setup-data-project markers ` +
-            `were not found. Add ${startMarker} and ${endMarker}, then rerun the ` +
-            "script.");
-        return "missing-markers";
-    }
-    const nextContent = currentContent.slice(0, start) + section +
-        currentContent.slice(end + endMarker.length);
-    if (nextContent === currentContent) {
-        return "unchanged";
-    }
-    writeFileSync(options.path, ensureFinalNewline(nextContent));
-    return "updated";
-}
-function ensureFinalNewline(content) {
-    return content.endsWith("\n") ? content : content + "\n";
-}

package/esm/helpers/ensureReadme.d.ts

@@ -1,2 +0,0 @@
-export declare function ensureReadme(runtime: string, installedPackages?: string[]): void;
-//# sourceMappingURL=ensureReadme.d.ts.map

package/esm/helpers/ensureReadme.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ensureReadme.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureReadme.ts"],"names":[],"mappings":"AAIA,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,iBAAiB,GAAE,MAAM,EAAO,QAsEjC"}

package/esm/helpers/ensureReadme.js

@@ -1,61 +0,0 @@
-import { log } from "@clack/prompts";
-import { ensureManagedSection } from "./ensureManagedSection.js";
-import { getInstalledPackageConfigs } from "./packageRegistry.js";
-export function ensureReadme(runtime, installedPackages = []) {
-    let runCommand = "npm run";
-    if (runtime === "deno") {
-        runCommand = "deno task";
-    }
-    else if (runtime === "bun") {
-        runCommand = "bun run";
-    }
-    const installedPackageConfigs = getInstalledPackageConfigs(installedPackages);
-    const hasSdaCore = installedPackageConfigs.some((pkg) => pkg.value === "@nshiab/simple-data-analysis-core");
-    const hasFullSda = installedPackageConfigs.some((pkg) => pkg.value === "@nshiab/simple-data-analysis");
-    const hasJournalism = installedPackageConfigs.some((pkg) => pkg.type === "journalism");
-    const libraryLinks = [
-        hasSdaCore
-            ? "[simple-data-analysis-core](https://github.com/nshiab/simple-data-analysis-core)"
-            : "",
-        hasFullSda
-            ? "[simple-data-analysis](https://github.com/nshiab/simple-data-analysis)"
-            : "",
-        hasJournalism ? "[journalism](https://github.com/nshiab/journalism)" : "",
-    ].filter(Boolean);
-    const librarySection = libraryLinks.length === 0
-        ? ""
-        : `It has installed ${libraryLinks.join(" and ")} ${libraryLinks.length === 1 ? "library" : "libraries"}, along with
-up-to-date documentation and AI agent instructions.`;
-    const status = ensureManagedSection({
-        path: "README.md",
-        name: "libraries",
-        content: librarySection,
-        createContent: (managedSection) => `This repository was created with
-[setup-data-project](https://github.com/nshiab/setup-data-project/).
-
-${managedSection}
-
-Here's the recommended workflow:
-
-- Put your raw data in the \`sda/data\` folder. Note that this folder is
-  ignored by Git.
-- Use the \`sda/main.ts\` file to process your raw data. Write the
-  results to the \`sda/output\` folder, which is also ignored by Git.
-- Put your tests in the \`sda/tests\` folder.
-
-When working on your project, use the following commands:
-
-- \`${runCommand} sda\` will watch your \`sda/main.ts\` and its dependencies.
-  Whenever you save changes, the data will be reprocessed.
-- \`${runCommand} all-tests\` will run the project's test command.
-- \`${runCommand} clean\` will remove cache and temporary files, if present.
-
-Have fun!`,
-    });
-    if (status === "created") {
-        log.info("Created README.md");
-    }
-    else if (status === "updated") {
-        log.info("Updated README.md");
-    }
-}

package/esm/helpers/fetchPackageDocs.d.ts

@@ -1,12 +0,0 @@
-export interface PackageDocs {
-    readme?: string;
-    llm?: string;
-    plot?: {
-        version: string;
-        pages: string[];
-    };
-}
-export declare function fetchPackageDocs(pkg: string, version: string, options?: {
-    silent?: boolean;
-}): Promise<PackageDocs>;
-//# sourceMappingURL=fetchPackageDocs.d.ts.map

package/esm/helpers/fetchPackageDocs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetchPackageDocs.d.ts","sourceRoot":"","sources":["../../src/helpers/fetchPackageDocs.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC7C;AAiBD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,WAAW,CAAC,CA4DtB"}

package/esm/helpers/fetchPackageDocs.js

@@ -1,75 +0,0 @@
-import { log, spinner } from "@clack/prompts";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-const PACKAGE_DOCUMENTS = [
-    {
-        remoteName: "README.md",
-        localName: "README.md",
-        key: "readme",
-        label: "README",
-    },
-    {
-        remoteName: "llm.md",
-        localName: "llm.md",
-        key: "llm",
-        label: "API documentation",
-    },
-];
-export async function fetchPackageDocs(pkg, version, options = {}) {
-    const repoName = pkg.split("/")[1];
-    const docsDirectory = join("docs", repoName);
-    mkdirSync(docsDirectory, { recursive: true });
-    const sFetch = spinner();
-    if (!options.silent) {
-        sFetch.start(`Fetching documentation for ${pkg}@${version}...`);
-    }
-    const fetchedDocuments = await Promise.all(PACKAGE_DOCUMENTS.map(async (document) => {
-        const localPath = join(docsDirectory, document.localName);
-        try {
-            const url = "https://raw.githubusercontent.com/nshiab/" + repoName +
-                `/refs/tags/v${version}/${document.remoteName}`;
-            const response = await fetch(url);
-            if (!response.ok) {
-                warnAboutFailedFetch(pkg, version, document.label, localPath);
-                return { key: document.key, content: undefined };
-            }
-            const content = await response.text();
-            writeFileSync(localPath, content);
-            return { key: document.key, content };
-        }
-        catch (error) {
-            warnAboutFailedFetch(pkg, version, document.label, localPath);
-            console.error(error);
-            return { key: document.key, content: undefined };
-        }
-    }));
-    const docs = {};
-    for (const document of fetchedDocuments) {
-        if (document.content !== undefined) {
-            docs[document.key] = document.content;
-        }
-    }
-    const savedCount = fetchedDocuments.filter((document) => document.content !== undefined)
-        .length;
-    if (!options.silent) {
-        if (savedCount === PACKAGE_DOCUMENTS.length) {
-            sFetch.stop(`✅ Documentation for ${pkg}@${version} saved!`);
-        }
-        else if (savedCount > 0) {
-            sFetch.stop(`⚠️  Some documentation for ${pkg}@${version} could not be fetched.`);
-        }
-        else {
-            sFetch.stop(`❌ Failed to fetch documentation for ${pkg}@${version}.`);
-        }
-    }
-    return docs;
-}
-function warnAboutFailedFetch(pkg, version, label, localPath) {
-    const existingFileGuidance = existsSync(localPath)
-        ? ` The existing file at ${localPath} was preserved, but it may not ` +
-            "match the installed version. Double-check it before relying on it, or " +
-            "remove it."
-        : "";
-    log.warn(`Could not fetch ${label} for ${pkg}@${version} from its GitHub tag.` +
-        existingFileGuidance);
-}

package/esm/helpers/fetchPlotDocs.d.ts

@@ -1,5 +0,0 @@
-import type { PackageDocs } from "./fetchPackageDocs.js";
-export declare function fetchPlotDocs(version: string, options?: {
-    preferStored?: boolean;
-}): Promise<PackageDocs>;
-//# sourceMappingURL=fetchPlotDocs.d.ts.map

package/esm/helpers/fetchPlotDocs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"fetchPlotDocs.d.ts","sourceRoot":"","sources":["../../src/helpers/fetchPlotDocs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAA;CAAO,GACvC,OAAO,CAAC,WAAW,CAAC,CAsCtB"}

package/esm/helpers/fetchPlotDocs.js

@@ -1,103 +0,0 @@
-import { log } from "@clack/prompts";
-import { mkdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { combinePlotDocs } from "./combinePlotDocs.js";
-import { PLOT_DOC_PAGES } from "./plotDocPages.js";
-// Publish one reference only after every tagged page has been fetched.
-export async function fetchPlotDocs(version, options = {}) {
-    const tag = `v${version}`;
-    const directory = join("docs", "observable-plot");
-    try {
-        let llm;
-        if (options.preferStored !== false) {
-            try {
-                const response = await fetch("https://raw.githubusercontent.com/nshiab/setup-data-project/" +
-                    `refs/heads/main/docs-cache/observable-plot/${version}/llm.md`);
-                if (response.ok) {
-                    const cached = await response.text();
-                    if (isStoredReference(cached, version))
-                        llm = cached;
-                }
-            }
-            catch {
-                // A cache is an optimization. An unavailable cache never blocks the tag.
-            }
-        }
-        if (llm === undefined)
-            llm = await generateReference(version);
-        mkdirSync(directory, { recursive: true });
-        const temporaryPath = join(directory, ".llm.md.tmp");
-        try {
-            writeFileSync(temporaryPath, llm);
-            renameSync(temporaryPath, join(directory, "llm.md"));
-        }
-        finally {
-            rmSync(temporaryPath, { force: true });
-        }
-        return { llm, plot: { version, pages: [...PLOT_DOC_PAGES] } };
-    }
-    catch (error) {
-        log.warn(`Could not fetch complete Observable Plot documentation for ${tag}. ` +
-            "Existing files were preserved, but may not match the installed " +
-            "version. Plot documentation will not be included in AGENTS.md. " +
-            String(error));
-        return {};
-    }
-}
-async function generateReference(version) {
-    const tag = `v${version}`;
-    const pages = PLOT_DOC_PAGES;
-    const documents = new Map();
-    const failed = [];
-    // Fetch in small batches to avoid overwhelming GitHub on the first run.
-    for (let offset = 0; offset < pages.length; offset += 8) {
-        await Promise.all(pages.slice(offset, offset + 8).map(async (page) => {
-            try {
-                const url = "https://raw.githubusercontent.com/observablehq/plot/" +
-                    `refs/tags/${tag}/docs/${page}`;
-                const response = await fetch(url);
-                if (!response.ok)
-                    throw new Error(`HTTP ${response.status}`);
-                const content = await response.text();
-                documents.set(page, content);
-            }
-            catch {
-                failed.push(page);
-            }
-        }));
-    }
-    if (failed.length > 0) {
-        throw new Error(`Could not fetch ${failed.length} Markdown pages`);
-    }
-    return combinePlotDocs(version, documents);
-}
-function isStoredReference(content, version) {
-    const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;
-    const metadata = content.split(/\n\s*\n/)[1]?.replace(/\s+/g, " ");
-    if (!content.startsWith(`# Observable Plot ${version}\n\n`) ||
-        metadata !==
-            `Package: \`@observablehq/plot@${version}\`. Source: [v${version}](${source}).` ||
-        !content.trimEnd().endsWith(`<!-- setup-data-project:observable-plot:${version}:complete -->`))
-        return false;
-    // Match actual page sections, not TOC entries. Require every selected page
-    // exactly once and some upstream heading/content after its source record.
-    const sections = [
-        ...content.matchAll(/<a id="(plot-[^"]+)"><\/a>\n\n# ([^\n]+\.md)\n\nSource:\s+([^\s]+)\n\n/g),
-    ];
-    if (sections.length !== PLOT_DOC_PAGES.length)
-        return false;
-    const found = new Set();
-    for (let index = 0; index < sections.length; index++) {
-        const section = sections[index];
-        const page = section[2];
-        const id = `plot-${page.replace(/\.md$/, "").replaceAll("/", "--")}`;
-        if (!PLOT_DOC_PAGES.includes(page) || found.has(page) || section[1] !== id ||
-            section[3] !== `${source}/${page}`)
-            return false;
-        const body = content.slice(section.index + section[0].length, sections[index + 1]?.index);
-        if (!/^#{1,6}\s+\S/m.test(body))
-            return false;
-        found.add(page);
-    }
-    return true;
-}

package/esm/helpers/getInstalledPackageVersions.d.ts

@@ -1,2 +0,0 @@
-export declare function getInstalledPackageVersions(packageSpecifiers: Record<string, string>): Record<string, string>;
-//# sourceMappingURL=getInstalledPackageVersions.d.ts.map

package/esm/helpers/getInstalledPackageVersions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getInstalledPackageVersions.d.ts","sourceRoot":"","sources":["../../src/helpers/getInstalledPackageVersions.ts"],"names":[],"mappings":"AAKA,wBAAgB,2BAA2B,CACzC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0BxB"}