@nshiab/setup-data-project 2.0.1 → 2.0.3

package/script/helpers/combinePlotDocs.d.ts

@@ -0,0 +1,2 @@
+export declare function combinePlotDocs(version: string, documents: Map<string, string>): string;
+//# sourceMappingURL=combinePlotDocs.d.ts.map

package/script/helpers/combinePlotDocs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinePlotDocs.d.ts","sourceRoot":"","sources":["../../src/helpers/combinePlotDocs.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,MAAM,CA4GR"}

package/script/helpers/combinePlotDocs.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.combinePlotDocs = combinePlotDocs;
+const node_path_1 = require("node:path");
+// The Plot source uses ATX headings, explicit VitePress IDs, and Markdown fences.
+// Keep code verbatim; rewrite only prose links and anchors while joining pages.
+function combinePlotDocs(version, documents) {
+    const pages = [...documents.keys()].sort();
+    const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;
+    const anchors = new Map();
+    const sections = new Map();
+    const pageId = (page) => `plot-${page.replace(/\.md$/, "").replaceAll("/", "--")}`;
+    for (const page of pages) {
+        const ids = new Map();
+        const headings = [];
+        const counts = new Map();
+        proseLines(documents.get(page), (line, number) => {
+            for (const match of line.matchAll(/\bid=["']([^"']+)["']/g)) {
+                ids.set(match[1], `${pageId(page)}--${match[1]}`);
+            }
+            const heading = line.match(/^ {0,3}#{1,6}\s+(.+?)\s*#*\s*$/);
+            if (!heading)
+                return line;
+            const explicit = heading[1].match(/\{#([^}]+)\}/)?.[1];
+            const title = heading[1].replace(/\s*\{#[^}]+\}/g, "");
+            const slug = explicit ?? title.replace(/<[^>]*>/g, "")
+                .toLowerCase().replace(/[^\p{L}\p{N}_\s-]/gu, "")
+                .trim().replace(/\s+/g, "-");
+            const count = counts.get(slug) ?? 0;
+            counts.set(slug, count + 1);
+            const localId = `${slug}${count ? `-${count}` : ""}`;
+            const id = `${pageId(page)}--${localId}`;
+            ids.set(localId, id);
+            headings.push({ line: number, title, id });
+            return line;
+        });
+        anchors.set(page, ids);
+        sections.set(page, headings);
+    }
+    function link(target, page) {
+        if (/^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(target))
+            return target;
+        const [pathAndQuery, fragment] = target.split("#", 2);
+        const path = pathAndQuery.split("?", 1)[0];
+        const resolved = path === "" ? page : node_path_1.posix.normalize(path.startsWith("/")
+            ? path.slice(1)
+            : node_path_1.posix.join(node_path_1.posix.dirname(page), path));
+        const markdown = [resolved, `${resolved}.md`, `${resolved}/index.md`]
+            .find((candidate) => documents.has(candidate));
+        if (markdown) {
+            const id = fragment
+                ? anchors.get(markdown)?.get(decodeURIComponent(fragment))
+                : pageId(markdown);
+            if (id)
+                return `#${id}`;
+            // Preserve an upstream target when a fragment is not a known heading/ID.
+            return `${source}/${markdown}${fragment ? `#${fragment}` : ""}`;
+        }
+        if (resolved.endsWith(".md")) {
+            return `${source}/${resolved}${fragment ? `#${fragment}` : ""}`;
+        }
+        const base = "https://raw.githubusercontent.com/observablehq/plot/" +
+            `refs/tags/v${version}/docs/`;
+        return path.startsWith("/")
+            ? new URL(`public${target}`, base).href
+            : new URL(target, `${base}${page}`).href;
+    }
+    const contents = pages.flatMap((page) => [
+        `- [${page}](#${pageId(page)})`,
+        ...(sections.get(page) ?? []).map(({ title, id }) => `  - [${title.replace(/[\[\]]/g, "")}](#${id})`),
+    ]).join("\n");
+    const combined = pages.map((page) => {
+        const headings = new Map(sections.get(page).map((heading) => [heading.line, heading]));
+        const body = proseLines(documents.get(page), (line, number) => {
+            const heading = headings.get(number);
+            // Inline code also remains verbatim. Plot's prose links have simple destinations.
+            line = line.split(/(`+[^`]*`+)/g).map((part, index) => {
+                if (index % 2)
+                    return part;
+                return part.replace(/(\]\()([^\s)]+)([^)]*\))/g, (_, before, target, after) => `${before}${link(target, page)}${after}`).replace(/^( {0,3}\[[^\]]+\]:\s*)(\S+)/, (_, before, target) => `${before}${link(target, page)}`).replace(/(?<!:)\b(href|src)=(["'])([^"']+)\2/g, (_, attr, quote, target) => `${attr}=${quote}${link(target, page)}${quote}`).replace(/\bid=(["'])([^"']+)\1/g, (_, quote, id) => `id=${quote}${anchors.get(page)?.get(id) ?? id}${quote}`);
+            }).join("");
+            return heading
+                ? `<a id="${heading.id}"></a>\n\n${line.replace(/\s*\{#[^}]+\}/g, "")}`
+                : line;
+        });
+        return `<a id="${pageId(page)}"></a>\n\n# ${page}\n\nSource: ${source}/${page}\n\n${body}`;
+    }).join("\n\n---\n\n");
+    return `# Observable Plot ${version}\n\nPackage: \`@observablehq/plot@${version}\`. Source: [v${version}](${source}).\n\nThis reference combines selected upstream documentation for static charts and maps. Introductory and site pages, interaction helpers, and the Auto and Tip marks are omitted. Vue components and plot fences are retained as source examples. Use the table of contents to find API signatures and examples; links to omitted pages lead to the tagged upstream documentation.\n\n## Table of contents\n\n${contents}\n\n---\n\n${combined}\n\n<!-- setup-data-project:observable-plot:${version}:complete -->\n`;
+}
+function proseLines(content, transform) {
+    let fence;
+    let script = false;
+    return content.split("\n").map((line, number) => {
+        const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);
+        if (fence) {
+            if (marker?.[1][0] === fence.character &&
+                marker[1].length >= fence.length && /^ {0,3}(?:`+|~+)\s*$/.test(line))
+                fence = undefined;
+            return line;
+        }
+        if (marker) {
+            fence = { character: marker[1][0], length: marker[1].length };
+            return line;
+        }
+        if (/^\s*<script\b/.test(line))
+            script = true;
+        if (script) {
+            if (/<\/script>/.test(line))
+                script = false;
+            return line;
+        }
+        return transform(line, number);
+    }).join("\n");
+}

package/script/helpers/ensureAgents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ensureAgents.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureAgents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOzD,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,OAAO,EAAE,MAAM,EACf,iBAAiB,GAAE,MAAM,EAA6B,QAqLvD"}
+{"version":3,"file":"ensureAgents.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureAgents.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOzD,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,OAAO,EAAE,MAAM,EACf,iBAAiB,GAAE,MAAM,EAA6B,QA+LvD"}

package/script/helpers/ensureAgents.js

@@ -103,6 +103,14 @@ Always prioritize the installed ${libraryNames} ${libraryNoun} when relevant.
             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
@@ -118,13 +126,15 @@ Always prioritize the installed ${libraryNames} ${libraryNoun} when relevant.
         });
         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 with named imports like this:
+            libraryGuidance += `APIs can be imported like this:
 \`\`\`typescript
 ${importExamples.join("\n")}
 \`\`\`

package/script/helpers/fetchPackageDocs.d.ts

@@ -1,6 +1,10 @@
 export interface PackageDocs {
     readme?: string;
     llm?: string;
+    plot?: {
+        version: string;
+        pages: string[];
+    };
 }
 export declare function fetchPackageDocs(pkg: string, version: string, options?: {
     silent?: boolean;

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

@@ -1 +1 @@
-{"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;CACd;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"}
+{"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/script/helpers/fetchPlotDocs.d.ts

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

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

@@ -0,0 +1 @@
+{"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/script/helpers/fetchPlotDocs.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fetchPlotDocs = fetchPlotDocs;
+const prompts_1 = require("@clack/prompts");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const combinePlotDocs_js_1 = require("./combinePlotDocs.js");
+const plotDocPages_js_1 = require("./plotDocPages.js");
+// Publish one reference only after every tagged page has been fetched.
+async function fetchPlotDocs(version, options = {}) {
+    const tag = `v${version}`;
+    const directory = (0, node_path_1.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);
+        (0, node_fs_1.mkdirSync)(directory, { recursive: true });
+        const temporaryPath = (0, node_path_1.join)(directory, ".llm.md.tmp");
+        try {
+            (0, node_fs_1.writeFileSync)(temporaryPath, llm);
+            (0, node_fs_1.renameSync)(temporaryPath, (0, node_path_1.join)(directory, "llm.md"));
+        }
+        finally {
+            (0, node_fs_1.rmSync)(temporaryPath, { force: true });
+        }
+        return { llm, plot: { version, pages: [...plotDocPages_js_1.PLOT_DOC_PAGES] } };
+    }
+    catch (error) {
+        prompts_1.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 = plotDocPages_js_1.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 (0, combinePlotDocs_js_1.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 !== plotDocPages_js_1.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 (!plotDocPages_js_1.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/script/helpers/getInstalledPackageVersions.d.ts.map

@@ -1 +1 @@
-{"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,CAuBxB"}
+{"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"}

package/script/helpers/getInstalledPackageVersions.js

@@ -11,10 +11,12 @@ function getInstalledPackageVersions(packageSpecifiers) {
         : undefined;
     const versions = {};
     for (const [pkg, specifier] of Object.entries(packageSpecifiers)) {
+        const denoVersion = specifier.startsWith("jsr:") || specifier.startsWith("npm:")
+            ? getDenoLockVersion(pkg, specifier, denoLock)
+            : undefined;
         const version = specifier.startsWith("jsr:")
-            ? getDenoLockVersion(pkg, specifier, denoLock) ??
-                getExactVersion(specifier)
-            : getNodeModulesVersion(pkg) ??
+            ? denoVersion ?? getExactVersion(specifier)
+            : denoVersion ?? getNodeModulesVersion(pkg) ??
                 getPackageLockVersion(pkg, packageLock) ??
                 getBunLockVersion(pkg, bunLock) ??
                 getExactVersion(specifier);
@@ -31,7 +33,7 @@ function getNodeModulesVersion(pkg) {
         : undefined;
 }
 function getDenoLockVersion(pkg, specifier, lock) {
-    if (!lock || !specifier.startsWith("jsr:"))
+    if (!lock)
         return undefined;
     const specifiers = asObject(lock.specifiers);
     if (!specifiers)
@@ -39,7 +41,8 @@ function getDenoLockVersion(pkg, specifier, lock) {
     const directVersion = specifiers[specifier];
     if (typeof directVersion === "string")
         return getExactVersion(directVersion);
-    const prefix = `jsr:${pkg}@`;
+    const protocol = specifier.startsWith("npm:") ? "npm" : "jsr";
+    const prefix = `${protocol}:${pkg}@`;
     const matchingVersions = Object.entries(specifiers)
         .filter(([key, value]) => key.startsWith(prefix) && typeof value === "string")
         .flatMap(([, value]) => {

package/script/helpers/installPackages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installPackages.d.ts","sourceRoot":"","sources":["../../src/helpers/installPackages.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa;;CAEzB,CAAC;AASF,wBAAsB,eAAe,CACnC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CAmDf"}
+{"version":3,"file":"installPackages.d.ts","sourceRoot":"","sources":["../../src/helpers/installPackages.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa;;CAEzB,CAAC;AAEF,wBAAsB,eAAe,CACnC,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,IAAI,CAAC,CA8Cf"}

package/script/helpers/installPackages.js

@@ -41,12 +41,6 @@ const getRuntime_js_1 = require("./getRuntime.js");
 exports.commandRunner = {
     exec: childProcess.exec,
 };
-// Temporary: remove this bypass after the 2.0 release window.
-// https://github.com/nshiab/setup-data-project/issues/15
-const PACKAGES_WITH_FRESH_DENO_RELEASES = new Set([
-    "@nshiab/simple-data-analysis-core",
-    "@nshiab/simple-data-analysis",
-]);
 async function installPackages(selectedPackages, options = {}) {
     const runtime = (0, getRuntime_js_1.getRuntime)();
     for (const selectedPackage of selectedPackages) {
@@ -58,12 +52,8 @@ async function installPackages(selectedPackages, options = {}) {
         for (const pkg of packagesToInstall) {
             const s = (0, prompts_1.spinner)();
             const isObservablePlot = pkg === "@observablehq/plot";
-            const minimumDependencyAgeOption = PACKAGES_WITH_FRESH_DENO_RELEASES.has(pkg) ? " --min-dep-age=0" : "";
             const installCmd = runtime === "deno"
-                ? (isObservablePlot
-                    ? "deno add npm:" + pkg
-                    : "deno add" + minimumDependencyAgeOption + " jsr:" +
-                        pkg)
+                ? (isObservablePlot ? "deno add npm:" + pkg : "deno add jsr:" + pkg)
                 : runtime === "bun"
                     ? "bun add " + pkg
                     : "npm install " + pkg;

package/script/helpers/packageRegistry.d.ts

@@ -5,5 +5,6 @@ export interface PackageConfig {
     hint?: string;
 }
 export declare const SUPPORTED_PACKAGES: PackageConfig[];
+export declare const DOCUMENTED_PACKAGES: PackageConfig[];
 export declare function getInstalledPackageConfigs(installedPackages: string[]): PackageConfig[];
 //# sourceMappingURL=packageRegistry.d.ts.map

package/script/helpers/packageRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packageRegistry.d.ts","sourceRoot":"","sources":["../../src/helpers/packageRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAwF7C,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,MAAM,EAAE,GAC1B,aAAa,EAAE,CAGjB"}
+{"version":3,"file":"packageRegistry.d.ts","sourceRoot":"","sources":["../../src/helpers/packageRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,OAAO,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,kBAAkB,EAAE,aAAa,EAwF7C,CAAC;AAGF,eAAO,MAAM,mBAAmB,EAAE,aAAa,EAG9C,CAAC;AAEF,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,MAAM,EAAE,GAC1B,aAAa,EAAE,CAGjB"}

package/script/helpers/packageRegistry.js

@@ -1,20 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_PACKAGES = void 0;
+exports.DOCUMENTED_PACKAGES = exports.SUPPORTED_PACKAGES = void 0;
 exports.getInstalledPackageConfigs = getInstalledPackageConfigs;
 exports.SUPPORTED_PACKAGES = [
-    {
-        value: "@nshiab/simple-data-analysis-core",
-        label: "simple-data-analysis-core",
-        type: "sda",
-        hint: "No fluff. Great for constrained environments, like a cheap server.",
-    },
     {
         value: "@nshiab/simple-data-analysis",
         label: "simple-data-analysis",
         type: "sda",
         hint: "All the core functionality, plus methods for dataviz, AI, Google sheets, etc.",
     },
+    {
+        value: "@nshiab/simple-data-analysis-core",
+        label: "simple-data-analysis-core",
+        type: "sda",
+        hint: "No fluff. Great for constrained environments, like a cheap server.",
+    },
     {
         value: "@nshiab/journalism-ai",
         label: "journalism-ai",
@@ -82,7 +82,12 @@ exports.SUPPORTED_PACKAGES = [
         hint: "Functions to zip/unzip, sleep, reencode files, create nested directories...",
     },
 ];
+// Plot is installed alongside charting libraries, but is not a setup menu option.
+exports.DOCUMENTED_PACKAGES = [
+    ...exports.SUPPORTED_PACKAGES,
+    { value: "@observablehq/plot", label: "Observable Plot", type: "other" },
+];
 function getInstalledPackageConfigs(installedPackages) {
     const installedSet = new Set(installedPackages);
-    return exports.SUPPORTED_PACKAGES.filter((pkg) => installedSet.has(pkg.value));
+    return exports.DOCUMENTED_PACKAGES.filter((pkg) => installedSet.has(pkg.value));
 }

package/script/helpers/parseArguments.d.ts

@@ -0,0 +1,7 @@
+export interface CliOptions {
+    help: boolean;
+    package?: string;
+}
+export declare const CLI_HELP = "Usage: setup-data-project [--sda | --sda-core] [--help]\n\n  --sda       Select simple-data-analysis without prompting.\n  --sda-core  Select simple-data-analysis-core without prompting.\n  -h, --help  Show this help and exit.\n\nWithout a package flag, choose packages interactively.\nPackage flags keep existing versions and still set up project files and docs.\n--sda and --sda-core cannot be combined.";
+export declare function parseArguments(args: string[]): CliOptions;
+//# sourceMappingURL=parseArguments.d.ts.map

package/script/helpers/parseArguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArguments.d.ts","sourceRoot":"","sources":["../../src/helpers/parseArguments.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,QAAQ,0ZAQoB,CAAC;AAE1C,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAoBzD"}

package/script/helpers/parseArguments.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CLI_HELP = void 0;
+exports.parseArguments = parseArguments;
+exports.CLI_HELP = `Usage: setup-data-project [--sda | --sda-core] [--help]
+
+  --sda       Select simple-data-analysis without prompting.
+  --sda-core  Select simple-data-analysis-core without prompting.
+  -h, --help  Show this help and exit.
+
+Without a package flag, choose packages interactively.
+Package flags keep existing versions and still set up project files and docs.
+--sda and --sda-core cannot be combined.`;
+function parseArguments(args) {
+    const options = { help: false };
+    for (const arg of args) {
+        if (arg === "--help" || arg === "-h") {
+            options.help = true;
+        }
+        else if (arg === "--sda" || arg === "--sda-core") {
+            const pkg = arg === "--sda"
+                ? "@nshiab/simple-data-analysis"
+                : "@nshiab/simple-data-analysis-core";
+            if (options.package && options.package !== pkg) {
+                throw new Error("--sda and --sda-core cannot be combined.");
+            }
+            options.package = pkg;
+        }
+        else {
+            throw new Error(`Unknown argument: ${arg}. Use --help for usage.`);
+        }
+    }
+    return options;
+}

package/script/helpers/plotDocPages.d.ts

@@ -0,0 +1,2 @@
+export declare const PLOT_DOC_PAGES: string[];
+//# sourceMappingURL=plotDocPages.d.ts.map

package/script/helpers/plotDocPages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plotDocPages.d.ts","sourceRoot":"","sources":["../../src/helpers/plotDocPages.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,EAAE,MAAM,EA2C3B,CAAC"}

package/script/helpers/plotDocPages.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLOT_DOC_PAGES = void 0;
+// Static chart creation references. Keep this explicit so new upstream pages do
+// not silently expand the installed agent reference.
+exports.PLOT_DOC_PAGES = [
+    "features/plots.md",
+    "features/marks.md",
+    "features/scales.md",
+    "features/projections.md",
+    "features/legends.md",
+    "features/facets.md",
+    "features/formats.md",
+    "features/curves.md",
+    "transforms/bin.md",
+    "transforms/group.md",
+    "transforms/stack.md",
+    "transforms/normalize.md",
+    "transforms/centroid.md",
+    "transforms/sort.md",
+    "marks/area.md",
+    "marks/arrow.md",
+    "marks/axis.md",
+    "marks/bar.md",
+    "marks/bollinger.md",
+    "marks/box.md",
+    "marks/cell.md",
+    "marks/contour.md",
+    "marks/delaunay.md",
+    "marks/density.md",
+    "marks/difference.md",
+    "marks/dot.md",
+    "marks/frame.md",
+    "marks/geo.md",
+    "marks/grid.md",
+    "marks/hexgrid.md",
+    "marks/image.md",
+    "marks/line.md",
+    "marks/linear-regression.md",
+    "marks/link.md",
+    "marks/raster.md",
+    "marks/rect.md",
+    "marks/rule.md",
+    "marks/text.md",
+    "marks/tick.md",
+    "marks/tree.md",
+    "marks/vector.md",
+    "marks/waffle.md",
+].sort();

package/script/helpers/syncPackageDocs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"syncPackageDocs.d.ts","sourceRoot":"","sources":["../../src/helpers/syncPackageDocs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAG3E,wBAAsB,eAAe,CACnC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CA+CtC"}
+{"version":3,"file":"syncPackageDocs.d.ts","sourceRoot":"","sources":["../../src/helpers/syncPackageDocs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAI3E,wBAAsB,eAAe,CACnC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACxC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAkDtC"}

package/script/helpers/syncPackageDocs.js

@@ -5,12 +5,14 @@ const prompts_1 = require("@clack/prompts");
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const fetchPackageDocs_js_1 = require("./fetchPackageDocs.js");
+const fetchPlotDocs_js_1 = require("./fetchPlotDocs.js");
 const packageRegistry_js_1 = require("./packageRegistry.js");
 async function syncPackageDocs(installedPackages, installedVersions) {
     const installedSet = new Set(installedPackages);
     const docsMapping = {};
-    for (const pkg of packageRegistry_js_1.SUPPORTED_PACKAGES) {
-        const repoName = pkg.value.split("/")[1];
+    for (const pkg of packageRegistry_js_1.DOCUMENTED_PACKAGES) {
+        const isPlot = pkg.value === "@observablehq/plot";
+        const repoName = isPlot ? "observable-plot" : pkg.value.split("/")[1];
         const docsDirectory = (0, node_path_1.join)("docs", repoName);
         const llmDocsPath = (0, node_path_1.join)(docsDirectory, "llm.md");
         const legacyDocsPath = (0, node_path_1.join)("docs", repoName + ".md");
@@ -40,8 +42,10 @@ async function syncPackageDocs(installedPackages, installedVersions) {
                 "included in AGENTS.md.");
             continue;
         }
-        const docs = await (0, fetchPackageDocs_js_1.fetchPackageDocs)(pkg.value, version, { silent: true });
-        if (docs.readme !== undefined || docs.llm !== undefined) {
+        const docs = isPlot
+            ? await (0, fetchPlotDocs_js_1.fetchPlotDocs)(version)
+            : await (0, fetchPackageDocs_js_1.fetchPackageDocs)(pkg.value, version, { silent: true });
+        if (docs.readme !== undefined || docs.llm !== undefined || docs.plot) {
             docsMapping[pkg.value] = docs;
         }
     }

package/script/main.js

@@ -19,7 +19,13 @@ const packageRegistry_js_1 = require("./helpers/packageRegistry.js");
 const projectManifest_js_1 = require("./helpers/projectManifest.js");
 const syncPackageDocs_js_1 = require("./helpers/syncPackageDocs.js");
 const getInstalledPackageVersions_js_1 = require("./helpers/getInstalledPackageVersions.js");
+const parseArguments_js_1 = require("./helpers/parseArguments.js");
 async function main() {
+    const cliOptions = (0, parseArguments_js_1.parseArguments)(node_process_1.default.argv.slice(2));
+    if (cliOptions.help) {
+        console.log(parseArguments_js_1.CLI_HELP);
+        return;
+    }
     const runtime = (0, getRuntime_js_1.getRuntime)();
     console.log();
     (0, prompts_1.intro)(`Hi! 👋 (Running on ${runtime})`);
@@ -32,11 +38,13 @@ async function main() {
             ? `${opt.label} \x1b[2m(installed)\x1b[22m`
             : opt.label,
     }));
-    const selectedPackages = (await (0, prompts_1.multiselect)({
-        message: "Which libraries would you like to install?\n\x1b[2m(space to select, arrows to navigate, enter to confirm)\x1b[22m\n",
-        options,
-        required: false,
-    }));
+    const selectedPackages = cliOptions.package
+        ? [cliOptions.package]
+        : (await (0, prompts_1.multiselect)({
+            message: "Which libraries would you like to install?\n\x1b[2m(space to select, arrows to navigate, enter to confirm)\x1b[22m\n",
+            options,
+            required: false,
+        }));
     if ((0, prompts_1.isCancel)(selectedPackages)) {
         (0, prompts_1.cancel)("Installation cancelled.");
         node_process_1.default.exit(0);
@@ -45,6 +53,8 @@ async function main() {
     const packagesToInstall = [];
     for (const pkg of selectedPackages) {
         if (alreadyInstalled.includes(pkg)) {
+            if (cliOptions.package)
+                continue;
             const action = await (0, prompts_1.select)({
                 message: `${pkg} is already installed. What would you like to do?`,
                 options: [