@nshiab/setup-data-project 3.0.2 โ 3.0.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -2
- package/dist/main.mjs +78 -15
- package/dist/main.mjs.map +1 -1
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -57,10 +57,19 @@ and unmanaged documentation are preserved.
|
|
|
57
57
|
Generated projects run TypeScript directly with Node or Bun. Vite+ provides
|
|
58
58
|
formatting, linting, type checking, and Vitest tests. Use `npm run sda`,
|
|
59
59
|
`npm run all-tests`, and `npm run fix` (or `bun run` for Bun projects).
|
|
60
|
-
|
|
60
|
+
The generated `all-tests` command also succeeds when no tests exist.
|
|
61
61
|
New development tools are installed at their latest versions; existing dependencies
|
|
62
62
|
are preserved.
|
|
63
63
|
|
|
64
|
+
For test-driven development, run one test file and watch for changes (replace the
|
|
65
|
+
example path with your test file):
|
|
66
|
+
|
|
67
|
+
```sh
|
|
68
|
+
npx vp test sda/tests/example.test.ts --watch
|
|
69
|
+
# Bun
|
|
70
|
+
bun run --bun vp test sda/tests/example.test.ts --watch
|
|
71
|
+
```
|
|
72
|
+
|
|
64
73
|
VS Code configuration recommends the Vite+ extension pack and enables formatting,
|
|
65
74
|
lint fixes on save, and visual line wrapping. Existing `.vscode/extensions.json`
|
|
66
75
|
and `.vscode/settings.json` files are left unchanged.
|
|
@@ -68,7 +77,9 @@ and `.vscode/settings.json` files are left unchanged.
|
|
|
68
77
|
Documentation is downloaded automatically for the exact installed library
|
|
69
78
|
versions. Each library's release archive preserves its README, license,
|
|
70
79
|
`llms.txt` index, granular API pages, and media under `docs/<library>/`.
|
|
71
|
-
Observable Plot
|
|
80
|
+
Observable Plot downloads one version-matched cached reference (or falls back to
|
|
81
|
+
upstream sources), then splits it into feature, mark, and transform pages with
|
|
82
|
+
an index at `docs/observable-plot/llms.txt`.
|
|
72
83
|
The generated `docs/` folder is ignored by Git.
|
|
73
84
|
|
|
74
85
|
After cloning or changing dependencies, run `npm run docs` or `bun run docs`.
|
|
@@ -88,3 +99,14 @@ created them. Use `--help` for usage.
|
|
|
88
99
|
For development, use `npm ci` and `npm run all-tests`.
|
|
89
100
|
`npx vp pack` produces the npm executable. Releases use `npm run patch`,
|
|
90
101
|
`npm run minor`, or `npm run major` from main; GitHub Actions publishes to npm.
|
|
102
|
+
|
|
103
|
+
To cache documentation for the latest Observable Plot version, run:
|
|
104
|
+
|
|
105
|
+
```sh
|
|
106
|
+
npm run cache-plot-docs
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
This checks npm and skips generation if that version is already cached. To generate
|
|
110
|
+
or refresh a specific version, run `npm run cache-plot-docs -- 0.6.17`.
|
|
111
|
+
Review and commit `docs-cache/observable-plot/<version>/llm.md`; keep earlier
|
|
112
|
+
versions for pinned projects. The command fetches the tagged upstream pages and license.
|
package/dist/main.mjs
CHANGED
|
@@ -3,7 +3,7 @@ import { cancel, intro, isCancel, log, multiselect, outro, select, spinner } fro
|
|
|
3
3
|
import process$1 from "node:process";
|
|
4
4
|
import { execFile, execFileSync } from "node:child_process";
|
|
5
5
|
import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
|
|
6
|
-
import { join, posix } from "node:path";
|
|
6
|
+
import { dirname, join, posix } from "node:path";
|
|
7
7
|
import { x } from "tar";
|
|
8
8
|
//#region src/helpers/getRuntime.ts
|
|
9
9
|
function getRuntime(versions = process$1.versions) {
|
|
@@ -176,6 +176,7 @@ function ensureFinalNewline(content) {
|
|
|
176
176
|
//#region src/helpers/ensureReadme.ts
|
|
177
177
|
function ensureReadme(runtime, installedPackages = []) {
|
|
178
178
|
const run = runtime === "bun" ? "bun run" : "npm run";
|
|
179
|
+
const vp = runtime === "bun" ? "bun run --bun vp" : "npx vp";
|
|
179
180
|
const libraries = getInstalledPackageConfigs(installedPackages).map((pkg) => `\`${pkg.value}\``).join(", ");
|
|
180
181
|
ensureManagedSection({
|
|
181
182
|
path: "README.md",
|
|
@@ -184,12 +185,13 @@ function ensureReadme(runtime, installedPackages = []) {
|
|
|
184
185
|
content: `${libraries ? `Installed libraries: ${libraries}.\n\n` : ""}Use sda/main.ts to process source data from sda/data/ and write results to sda/output/. Both data folders are ignored by Git. Put reusable helpers in sda/helpers/ and tests in sda/tests/. Import test utilities from \`vite-plus/test\`.
|
|
185
186
|
|
|
186
187
|
- \`${run} sda\`: run the analysis and watch for changes.
|
|
187
|
-
- \`${run}
|
|
188
|
-
- \`${run} all-tests\`: check types, lint, formatting, and tests.
|
|
188
|
+
- \`${run} all-tests\`: check types, lint, formatting, and tests; succeeds when no tests exist.
|
|
189
189
|
- \`${run} fix\`: apply formatting and automatic fixes.
|
|
190
190
|
- \`${run} docs\`: refresh documentation for the installed library versions.
|
|
191
191
|
- \`${run} clean\`: delete cached results and temporary files in .sda-cache/, .journalism-cache/, and .tmp/.
|
|
192
192
|
|
|
193
|
+
For test-driven development, run one test file and watch for changes with \`${vp} test sda/tests/example.test.ts --watch\`. Replace the path with your test file.
|
|
194
|
+
|
|
193
195
|
In VS Code, install the recommended Vite+ extension pack for Oxc formatting and linting and the Vitest test runner. Generated .vscode/settings.json enables formatting and lint fixes on save, plus visual line wrapping. Existing VS Code configuration files are preserved.
|
|
194
196
|
|
|
195
197
|
The generated docs/ folder is ignored by Git. Refresh it after cloning or updating dependencies. See AGENTS.md for documentation pointers.`
|
|
@@ -291,15 +293,14 @@ function ensureVscode() {
|
|
|
291
293
|
}
|
|
292
294
|
//#endregion
|
|
293
295
|
//#region package.json
|
|
294
|
-
var version = "3.0.
|
|
296
|
+
var version = "3.0.4";
|
|
295
297
|
//#endregion
|
|
296
298
|
//#region src/helpers/getProjectTasks.ts
|
|
297
299
|
function getProjectTasks(runtime = getRuntime()) {
|
|
298
300
|
const vp = runtime === "bun" ? "bun run --bun vp" : "vp";
|
|
299
301
|
return {
|
|
300
302
|
sda: runtime === "bun" ? "bun run --watch sda/main.ts" : "node --env-file-if-exists=.env --watch sda/main.ts",
|
|
301
|
-
|
|
302
|
-
"all-tests": `${vp} check && ${runtime === "bun" ? "bun" : "npm"} run test`,
|
|
303
|
+
"all-tests": `${vp} check && ${vp} test --passWithNoTests`,
|
|
303
304
|
clean: "rm -rf .sda-cache .journalism-cache .tmp",
|
|
304
305
|
fix: `${vp} check --fix`,
|
|
305
306
|
docs: `${runtime === "bun" ? "bunx --bun" : "npx"} @nshiab/setup-data-project@${version} --docs`
|
|
@@ -358,7 +359,7 @@ The clean script removes cached results and temporary files. Run it only when th
|
|
|
358
359
|
Library documentation in docs/ is generated and ignored by Git. Run \`${run} docs\` when documentation is missing or after dependency changes; resolve refresh failures before using possibly stale references. Edit project source files rather than downloaded documentation.
|
|
359
360
|
|
|
360
361
|
${getInstalledPackageConfigs(installedPackages).map((pkg) => {
|
|
361
|
-
if (pkg.value === "@observablehq/plot") return `- Observable Plot charts and maps:
|
|
362
|
+
if (pkg.value === "@observablehq/plot") return `- Observable Plot charts and maps: start at \`docs/observable-plot/llms.txt\`, then read the relevant pages for use with writeChart and writeMap.`;
|
|
362
363
|
return `- \`${pkg.value}\`: start at \`docs/${pkg.value.slice(8)}/llms.txt\`, then read the relevant API pages and examples.`;
|
|
363
364
|
}).join("\n")}`
|
|
364
365
|
});
|
|
@@ -611,6 +612,46 @@ const PLOT_DOC_PAGES = [
|
|
|
611
612
|
"marks/waffle.md"
|
|
612
613
|
].sort();
|
|
613
614
|
//#endregion
|
|
615
|
+
//#region src/helpers/splitPlotDocs.ts
|
|
616
|
+
function splitPlotDocs(reference, version) {
|
|
617
|
+
const sections = [...reference.matchAll(/<a id="(plot-[^"]+)"><\/a>\n\n# ([^\n]+\.md)\n\nSource:\s+([^\s]+)\n\n/g)];
|
|
618
|
+
const files = /* @__PURE__ */ new Map();
|
|
619
|
+
const anchors = /* @__PURE__ */ new Map();
|
|
620
|
+
const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;
|
|
621
|
+
const completion = `<!-- setup-data-project:observable-plot:${version}:complete -->`;
|
|
622
|
+
if (!reference.trimEnd().endsWith(completion)) throw new Error("Incomplete Plot reference.");
|
|
623
|
+
const end = reference.lastIndexOf(completion);
|
|
624
|
+
const licenseStart = reference.lastIndexOf("\n## Upstream license\n", end);
|
|
625
|
+
for (let index = 0; index < sections.length; index++) {
|
|
626
|
+
const section = sections[index];
|
|
627
|
+
const page = section[2];
|
|
628
|
+
if (!PLOT_DOC_PAGES.includes(page) || files.has(page) || section[3] !== `${source}/${page}`) throw new Error(`Invalid Plot page: ${page}`);
|
|
629
|
+
const body = reference.slice(section.index, sections[index + 1]?.index ?? (licenseStart >= 0 ? licenseStart : end)).trimEnd().replace(/\n\n---$/, "");
|
|
630
|
+
files.set(page, body);
|
|
631
|
+
proseLines(body, (line) => {
|
|
632
|
+
for (const match of line.matchAll(/\bid=["']([^"']+)["']/g)) anchors.set(match[1], page);
|
|
633
|
+
return line;
|
|
634
|
+
});
|
|
635
|
+
}
|
|
636
|
+
if (files.size !== PLOT_DOC_PAGES.length) throw new Error("Incomplete Plot pages.");
|
|
637
|
+
for (const [page, body] of files) {
|
|
638
|
+
const link = (id) => {
|
|
639
|
+
const destination = anchors.get(id);
|
|
640
|
+
return destination && destination !== page ? `${posix.relative(posix.dirname(page), destination)}#${id}` : `#${id}`;
|
|
641
|
+
};
|
|
642
|
+
files.set(page, proseLines(body, (line) => line.split(/(`+[^`]*`+)/g).map((part, index) => index % 2 ? part : part.replace(/(\]\()#([^\s)]+)([^)]*\))/g, (_match, before, id, after) => `${before}${link(id)}${after}`).replace(/^( {0,3}\[[^\]]+\]:\s*)#(\S+)/, (_match, before, id) => `${before}${link(id)}`).replace(/(?<!:)\b(href|src)=(["'])#([^"']+)\2/g, (_match, attr, quote, id) => `${attr}=${quote}${link(id)}${quote}`)).join("")) + "\n");
|
|
643
|
+
}
|
|
644
|
+
const license = licenseStart >= 0 ? reference.slice(licenseStart + 21, end).trim() : void 0;
|
|
645
|
+
if (license) files.set("LICENSE", license + "\n");
|
|
646
|
+
const index = `# Observable Plot ${version}\n\n> Selected documentation for static charts and maps. Start here, then read the relevant pages.\n\n[Versioned upstream documentation](${source})${license ? " ยท [License](./LICENSE)" : ""}\n\n` + [
|
|
647
|
+
"features",
|
|
648
|
+
"marks",
|
|
649
|
+
"transforms"
|
|
650
|
+
].map((group) => `## ${group[0].toUpperCase() + group.slice(1)}\n\n` + PLOT_DOC_PAGES.filter((page) => page.startsWith(`${group}/`)).map((page) => `- [${page}](./${page})`).join("\n")).join("\n\n") + "\n";
|
|
651
|
+
files.set("llms.txt", index);
|
|
652
|
+
return files;
|
|
653
|
+
}
|
|
654
|
+
//#endregion
|
|
614
655
|
//#region src/helpers/fetchPlotDocs.ts
|
|
615
656
|
async function fetchPlotDocs(version, options = {}) {
|
|
616
657
|
const tag = `v${version}`;
|
|
@@ -624,17 +665,34 @@ async function fetchPlotDocs(version, options = {}) {
|
|
|
624
665
|
if (isStoredReference(cached, version)) llm = cached;
|
|
625
666
|
}
|
|
626
667
|
} catch {}
|
|
627
|
-
if (llm === void 0) llm = await
|
|
628
|
-
|
|
629
|
-
|
|
668
|
+
if (llm === void 0) llm = await generatePlotReference(version);
|
|
669
|
+
const files = splitPlotDocs(llm, version);
|
|
670
|
+
mkdirSync("docs", { recursive: true });
|
|
671
|
+
const staging = mkdtempSync(join("docs", ".plot-"));
|
|
672
|
+
const contents = join(staging, "contents");
|
|
673
|
+
const backup = join(staging, "previous");
|
|
630
674
|
try {
|
|
631
|
-
|
|
632
|
-
|
|
675
|
+
for (const [page, content] of files) {
|
|
676
|
+
const path = join(contents, page);
|
|
677
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
678
|
+
writeFileSync(path, content);
|
|
679
|
+
}
|
|
680
|
+
if (existsSync(directory)) renameSync(directory, backup);
|
|
681
|
+
try {
|
|
682
|
+
renameSync(contents, directory);
|
|
683
|
+
} catch (error) {
|
|
684
|
+
if (existsSync(backup)) renameSync(backup, directory);
|
|
685
|
+
throw error;
|
|
686
|
+
}
|
|
633
687
|
} finally {
|
|
634
|
-
rmSync(
|
|
688
|
+
rmSync(staging, {
|
|
689
|
+
recursive: true,
|
|
690
|
+
force: true
|
|
691
|
+
});
|
|
635
692
|
}
|
|
636
693
|
return {
|
|
637
694
|
llm,
|
|
695
|
+
index: files.get("llms.txt"),
|
|
638
696
|
plot: {
|
|
639
697
|
version,
|
|
640
698
|
pages: [...PLOT_DOC_PAGES]
|
|
@@ -645,7 +703,8 @@ async function fetchPlotDocs(version, options = {}) {
|
|
|
645
703
|
return {};
|
|
646
704
|
}
|
|
647
705
|
}
|
|
648
|
-
async function
|
|
706
|
+
async function generatePlotReference(version) {
|
|
707
|
+
if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(version)) throw new Error("An exact Plot version is required.");
|
|
649
708
|
const tag = `v${version}`;
|
|
650
709
|
const pages = PLOT_DOC_PAGES;
|
|
651
710
|
const documents = /* @__PURE__ */ new Map();
|
|
@@ -662,7 +721,11 @@ async function generateReference(version) {
|
|
|
662
721
|
}
|
|
663
722
|
}));
|
|
664
723
|
if (failed.length > 0) throw new Error(`Could not fetch ${failed.length} Markdown pages`);
|
|
665
|
-
|
|
724
|
+
const response = await fetch(`https://raw.githubusercontent.com/observablehq/plot/refs/tags/${tag}/LICENSE`);
|
|
725
|
+
if (!response.ok) throw new Error(`Could not fetch Plot's license: HTTP ${response.status}`);
|
|
726
|
+
const license = await response.text();
|
|
727
|
+
const completion = `<!-- setup-data-project:observable-plot:${version}:complete -->`;
|
|
728
|
+
return combinePlotDocs(version, documents).replace(completion, `## Upstream license\n\n${license.trim()}\n\n${completion}`);
|
|
666
729
|
}
|
|
667
730
|
function isStoredReference(content, version) {
|
|
668
731
|
const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;
|
package/dist/main.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"main.mjs","names":["process","metadata.version","process"],"sources":["../src/helpers/getRuntime.ts","../src/helpers/packageRegistry.ts","../src/helpers/packageOptions.ts","../src/helpers/gitignoreEntries.ts","../src/helpers/ensureGitignore.ts","../src/helpers/ensureManagedSection.ts","../src/helpers/ensureReadme.ts","../src/helpers/installPackages.ts","../src/helpers/ensureTooling.ts","../src/helpers/ensureVscode.ts","../package.json","../src/helpers/getProjectTasks.ts","../src/helpers/createFolderStructure.ts","../src/helpers/ensureEnvFile.ts","../src/helpers/ensureAgents.ts","../src/helpers/jsonObject.ts","../src/helpers/projectManifest.ts","../src/helpers/fetchPackageDocs.ts","../src/helpers/combinePlotDocs.ts","../src/helpers/plotDocPages.ts","../src/helpers/fetchPlotDocs.ts","../src/helpers/syncPackageDocs.ts","../src/helpers/getInstalledPackageVersions.ts","../src/helpers/parseArguments.ts","../src/main.ts"],"sourcesContent":["import process from \"node:process\";\nexport type Runtime = \"node\" | \"bun\";\nexport function getRuntime(versions: { bun?: string; node?: string } = process.versions): Runtime {\n return versions.bun ? \"bun\" : \"node\";\n}\n","export interface PackageConfig {\n value: string;\n label: string;\n type: \"sda\" | \"journalism\" | \"other\";\n hint?: string;\n}\n\nexport const SUPPORTED_PACKAGES: PackageConfig[] = [\n {\n value: \"@nshiab/simple-data-analysis\",\n label: \"simple-data-analysis\",\n type: \"sda\",\n hint: \"All the core functionality, plus methods for dataviz, AI, Google sheets, etc.\",\n },\n {\n value: \"@nshiab/simple-data-analysis-core\",\n label: \"simple-data-analysis-core\",\n type: \"sda\",\n hint: \"No fluff. Great for constrained environments, like a cheap server.\",\n },\n {\n value: \"@nshiab/journalism-ai\",\n label: \"journalism-ai\",\n type: \"journalism\",\n hint: \"Easily use AI local models with Ollama or remote models with Gemini/Vertex.\",\n },\n {\n value: \"@nshiab/journalism-google\",\n label: \"journalism-google\",\n type: \"journalism\",\n hint: \"Push and retrieve data from Google Sheets, Google Bucket, and more.\",\n },\n {\n value: \"@nshiab/journalism-web-scraping\",\n label: \"journalism-web-scraping\",\n type: \"journalism\",\n hint: \"Retrieve data from Statistics Canada tables, HTML table, download files...\",\n },\n {\n value: \"@nshiab/journalism-finance\",\n label: \"journalism-finance\",\n type: \"journalism\",\n hint: \"Retrieve financial data, calculate Canadian mortgage payments and taxes...\",\n },\n {\n value: \"@nshiab/journalism-format\",\n label: \"journalism-format\",\n type: \"journalism\",\n hint: \"Easily format dates, numbers, currencies...\",\n },\n {\n value: \"@nshiab/journalism-climate\",\n label: \"journalism-climate\",\n type: \"journalism\",\n hint: \"Retrieve data from Environment Canada APIs and more.\",\n },\n {\n value: \"@nshiab/journalism-dataviz\",\n label: \"journalism-dataviz\",\n type: \"journalism\",\n hint: \"Render charts/maps with Observable Plot or directly in the terminal.\",\n },\n {\n value: \"@nshiab/journalism-geo\",\n label: \"journalism-geo\",\n type: \"journalism\",\n hint: \"Calculate distances, transform 2D coordinates to 3D, wrangle GeoTIFF files...\",\n },\n {\n value: \"@nshiab/journalism-statistics\",\n label: \"journalism-statistics\",\n type: \"journalism\",\n hint: \"Functions for statistical tests, clustering, random path generation...\",\n },\n {\n value: \"@nshiab/journalism-web\",\n label: \"journalism-web\",\n type: \"journalism\",\n hint: \"Web related functions, including downloading data as CSV, extracting ZIP files to URLs...\",\n },\n {\n value: \"@nshiab/journalism-extras\",\n label: \"journalism-extras\",\n type: \"journalism\",\n hint: \"Functions to zip/unzip, sleep, reencode files, create nested directories...\",\n },\n];\n\n// Plot is installed alongside charting libraries, but is not a setup menu option.\nexport const DOCUMENTED_PACKAGES: PackageConfig[] = [\n ...SUPPORTED_PACKAGES,\n { value: \"@nshiab/journalism\", label: \"journalism\", type: \"journalism\" },\n { value: \"@observablehq/plot\", label: \"Observable Plot\", type: \"other\" },\n];\n\nexport function getInstalledPackageConfigs(installedPackages: string[]): PackageConfig[] {\n const installedSet = new Set(installedPackages);\n return DOCUMENTED_PACKAGES.filter((pkg) => installedSet.has(pkg.value));\n}\n","import { SUPPORTED_PACKAGES } from \"./packageRegistry.ts\";\n\nexport const PACKAGE_OPTIONS = SUPPORTED_PACKAGES.map((pkg) => ({\n value: pkg.value,\n label: pkg.label,\n hint: pkg.hint,\n}));\n","export const GITIGNORE_ENTRIES = [\n \"node_modules\",\n \"docs/\",\n \".tmp\",\n \".sda-cache\",\n \".journalism-cache\",\n \"sda/data\",\n \"sda/output\",\n \".env\",\n \".DS_Store\",\n];\n","import { lstatSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { GITIGNORE_ENTRIES } from \"./gitignoreEntries.ts\";\n\nexport const GITIGNORE_SENTINEL = \"# Added by setup-data-project. Do not remove this line.\";\n\nexport function ensureGitignore() {\n const path = \".gitignore\";\n const stats = lstatSync(path, { throwIfNoEntry: false });\n\n if (stats?.isSymbolicLink()) {\n return;\n }\n\n const content = stats === undefined ? \"\" : readFileSync(path, \"utf-8\");\n const hasSentinel = content.split(\"\\n\").some((line) => line.trim() === GITIGNORE_SENTINEL);\n\n if (hasSentinel) {\n const entries = new Set(content.split(\"\\n\").map((line) => line.trim()));\n const missing = GITIGNORE_ENTRIES.filter((entry) => !entries.has(entry));\n if (missing.length)\n writeFileSync(\n path,\n content + (content.endsWith(\"\\n\") ? \"\" : \"\\n\") + missing.join(\"\\n\") + \"\\n\",\n );\n return;\n }\n\n const separator = content === \"\" ? \"\" : content.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n const block = `${GITIGNORE_SENTINEL}\\n${GITIGNORE_ENTRIES.join(\"\\n\")}\\n`;\n writeFileSync(path, content + separator + block);\n}\n","import { log } from \"@clack/prompts\";\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\n\ninterface ManagedSectionOptions {\n path: string;\n name: string;\n content: string;\n createContent: (section: string) => string;\n}\n\nexport function ensureManagedSection(\n options: ManagedSectionOptions,\n): \"created\" | \"updated\" | \"unchanged\" | \"missing-markers\" {\n const startMarker = `<!-- Do not remove / setup-data-project:${options.name}:start -->`;\n const endMarker = `<!-- Do not remove / setup-data-project:${options.name}:end -->`;\n const trimmedContent = options.content.trim();\n const section =\n trimmedContent === \"\"\n ? `${startMarker}\\n${endMarker}`\n : `${startMarker}\\n\\n${trimmedContent}\\n\\n${endMarker}`;\n\n if (!existsSync(options.path)) {\n writeFileSync(options.path, ensureFinalNewline(options.createContent(section)));\n return \"created\";\n }\n\n const currentContent = readFileSync(options.path, \"utf-8\");\n const start = currentContent.indexOf(startMarker);\n const end = currentContent.indexOf(endMarker);\n\n if (start === -1 || end === -1 || end < start) {\n log.warn(\n `${options.path} was not updated because its setup-data-project markers ` +\n `were not found. Add ${startMarker} and ${endMarker}, then rerun the ` +\n \"script.\",\n );\n return \"missing-markers\";\n }\n\n const nextContent =\n currentContent.slice(0, start) + section + currentContent.slice(end + endMarker.length);\n\n if (nextContent === currentContent) {\n return \"unchanged\";\n }\n\n writeFileSync(options.path, ensureFinalNewline(nextContent));\n return \"updated\";\n}\n\nfunction ensureFinalNewline(content: string): string {\n return content.endsWith(\"\\n\") ? content : content + \"\\n\";\n}\n","import { ensureManagedSection } from \"./ensureManagedSection.ts\";\nimport { getInstalledPackageConfigs } from \"./packageRegistry.ts\";\nimport type { Runtime } from \"./getRuntime.ts\";\nexport function ensureReadme(runtime: Runtime, installedPackages: string[] = []) {\n const run = runtime === \"bun\" ? \"bun run\" : \"npm run\";\n const libraries = getInstalledPackageConfigs(installedPackages)\n .map((pkg) => `\\`${pkg.value}\\``)\n .join(\", \");\n ensureManagedSection({\n path: \"README.md\",\n name: \"libraries\",\n createContent: (section) =>\n `# Data project\\n\\nCreated with [setup-data-project](https://github.com/nshiab/setup-data-project).\\n\\n${section}`,\n content: `${libraries ? `Installed libraries: ${libraries}.\\n\\n` : \"\"}Use sda/main.ts to process source data from sda/data/ and write results to sda/output/. Both data folders are ignored by Git. Put reusable helpers in sda/helpers/ and tests in sda/tests/. Import test utilities from \\`vite-plus/test\\`.\n\n- \\`${run} sda\\`: run the analysis and watch for changes.\n- \\`${run} test\\`: run tests; the default command also succeeds when no tests exist.\n- \\`${run} all-tests\\`: check types, lint, formatting, and tests.\n- \\`${run} fix\\`: apply formatting and automatic fixes.\n- \\`${run} docs\\`: refresh documentation for the installed library versions.\n- \\`${run} clean\\`: delete cached results and temporary files in .sda-cache/, .journalism-cache/, and .tmp/.\n\nIn VS Code, install the recommended Vite+ extension pack for Oxc formatting and linting and the Vitest test runner. Generated .vscode/settings.json enables formatting and lint fixes on save, plus visual line wrapping. Existing VS Code configuration files are preserved.\n\nThe generated docs/ folder is ignored by Git. Refresh it after cloning or updating dependencies. See AGENTS.md for documentation pointers.`,\n });\n}\n","import { execFile } from \"node:child_process\";\nimport { getRuntime } from \"./getRuntime.ts\";\nexport function runPackageManager(args: string[]): Promise<void> {\n const command = getRuntime() === \"bun\" ? \"bun\" : process.platform === \"win32\" ? \"npm.cmd\" : \"npm\";\n return new Promise((resolve, reject) => {\n execFile(\n command,\n args,\n { maxBuffer: 10 * 1024 * 1024, shell: process.platform === \"win32\" },\n (error, stdout, stderr) => {\n if (error)\n reject(\n new Error(`${command} ${args.join(\" \")} failed.\\n${stderr || stdout}`, {\n cause: error,\n }),\n );\n else resolve();\n },\n );\n });\n}\nexport async function installPackages(\n packages: string[],\n options: { development?: boolean } = {},\n): Promise<void> {\n if (packages.length === 0) return;\n const bun = getRuntime() === \"bun\";\n await runPackageManager([\n bun ? \"add\" : \"install\",\n ...(options.development ? (bun ? [\"--dev\"] : [\"--save-dev\"]) : []),\n ...packages,\n ]);\n}\n","import { existsSync, writeFileSync } from \"node:fs\";\nimport { ProjectManifest } from \"./projectManifest.ts\";\nimport { getRuntime } from \"./getRuntime.ts\";\nimport { installPackages } from \"./installPackages.ts\";\nconst tools = [\"vite-plus\", \"typescript\", \"@types/node\"];\nexport async function ensureTooling(manifest: ProjectManifest): Promise<void> {\n const runtime = getRuntime();\n const runtimeTools = runtime === \"bun\" ? [...tools, \"@types/bun\"] : tools;\n const installed = manifest.getInstalledPackages();\n await installPackages(\n runtimeTools.filter((pkg) => !installed.includes(pkg)).map((pkg) => `${pkg}@latest`),\n { development: true },\n );\n if (\n ![\n \"vite.config.ts\",\n \"vite.config.js\",\n \"vite.config.mts\",\n \"vite.config.mjs\",\n \"vite.config.cts\",\n \"vite.config.cjs\",\n ].some((file) => existsSync(file))\n ) {\n writeFileSync(\n \"vite.config.ts\",\n `import { defineConfig, loadEnv } from \"vite-plus\";\n\nexport default defineConfig({\n test: { env: loadEnv(\"test\", process.cwd(), \"\") },\n lint: { options: { typeAware: true, typeCheck: true } },\n fmt: { ignorePatterns: [\"docs/**\", \"sda/data/**\", \"sda/output/**\"] },\n});\n`,\n );\n }\n if (!existsSync(\"tsconfig.json\"))\n writeFileSync(\n \"tsconfig.json\",\n `{\n \"compilerOptions\": {\n \"target\": \"ES2023\",\n \"module\": \"NodeNext\",\n \"strict\": true,\n \"noEmit\": true,\n \"allowImportingTsExtensions\": true,\n \"erasableSyntaxOnly\": ${runtime === \"node\"},\n \"types\": ${runtime === \"bun\" ? '[\"node\", \"bun\"]' : '[\"node\"]'},\n \"skipLibCheck\": true\n },\n \"include\": [\"sda/**/*.ts\", \"vite.config.*\"]\n}\n`,\n );\n}\n","import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\n\nexport function ensureVscode(): void {\n mkdirSync(\".vscode\", { recursive: true });\n const formatter = \"oxc.oxc-vscode\";\n const files = {\n \"extensions.json\": `{\n \"recommendations\": [\"VoidZero.vite-plus-extension-pack\"]\n}\n`,\n \"settings.json\": `${JSON.stringify(\n {\n \"editor.defaultFormatter\": formatter,\n \"[javascript]\": { \"editor.defaultFormatter\": formatter },\n \"[javascriptreact]\": { \"editor.defaultFormatter\": formatter },\n \"[typescript]\": { \"editor.defaultFormatter\": formatter },\n \"[typescriptreact]\": { \"editor.defaultFormatter\": formatter },\n \"oxc.disableNestedConfig\": true,\n \"oxc.fmt.disableNestedConfig\": true,\n \"editor.formatOnSave\": true,\n \"editor.formatOnSaveMode\": \"file\",\n \"editor.codeActionsOnSave\": { \"source.fixAll.oxc\": \"explicit\" },\n \"editor.wordWrap\": \"on\",\n },\n null,\n 2,\n )}\\n`,\n };\n for (const [name, config] of Object.entries(files)) {\n const path = `.vscode/${name}`;\n if (!existsSync(path)) writeFileSync(path, config);\n }\n}\n","","import { getRuntime, type Runtime } from \"./getRuntime.ts\";\nimport metadata from \"../../package.json\" with { type: \"json\" };\nexport function getProjectTasks(runtime: Runtime = getRuntime()) {\n const vp = runtime === \"bun\" ? \"bun run --bun vp\" : \"vp\";\n return {\n sda:\n runtime === \"bun\"\n ? \"bun run --watch sda/main.ts\"\n : \"node --env-file-if-exists=.env --watch sda/main.ts\",\n test: `${vp} test --passWithNoTests`,\n \"all-tests\": `${vp} check && ${runtime === \"bun\" ? \"bun\" : \"npm\"} run test`,\n clean: \"rm -rf .sda-cache .journalism-cache .tmp\",\n fix: `${vp} check --fix`,\n docs: `${runtime === \"bun\" ? \"bunx --bun\" : \"npx\"} @nshiab/setup-data-project@${metadata.version} --docs`,\n };\n}\n","import { existsSync, lstatSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport function createFolderStructure(selectedPackages: string[]) {\n const sdaFolder = \"sda\";\n const folders = [\"data\", \"helpers\", \"output\", \"tests\"];\n\n if (!existsSync(sdaFolder)) {\n mkdirSync(sdaFolder, { recursive: true });\n }\n\n for (const folder of folders) {\n const path = join(sdaFolder, folder);\n if (!existsSync(path)) {\n mkdirSync(path, { recursive: true });\n }\n }\n\n const mainTsPath = join(sdaFolder, \"main.ts\");\n\n let mainTsContent = 'console.log(\"Hello simple-data-analysis!\");\\n';\n\n if (\n selectedPackages.includes(\"@nshiab/simple-data-analysis\") ||\n selectedPackages.includes(\"@nshiab/simple-data-analysis-core\")\n ) {\n const pkg = selectedPackages.includes(\"@nshiab/simple-data-analysis\")\n ? \"@nshiab/simple-data-analysis\"\n : \"@nshiab/simple-data-analysis-core\";\n mainTsContent = `import { SimpleDB } from \"${pkg}\";\n\nconst sdb = new SimpleDB();\nconst table = sdb.newTable();\n\nawait table.loadArray([{ message: \"Hello simple-data-analysis!\" }]).log();\n\nawait sdb.close();\n`;\n }\n\n if (lstatSync(mainTsPath, { throwIfNoEntry: false }) === undefined) {\n writeFileSync(mainTsPath, mainTsContent);\n }\n\n return sdaFolder;\n}\n","import { lstatSync, writeFileSync } from \"node:fs\";\n\nexport function ensureEnvFile() {\n if (lstatSync(\".env\", { throwIfNoEntry: false }) === undefined) {\n writeFileSync(\".env\", \"\");\n }\n}\n","import type { PackageDocs } from \"./fetchPackageDocs.ts\";\nimport { ensureManagedSection } from \"./ensureManagedSection.ts\";\nimport { getInstalledPackageConfigs } from \"./packageRegistry.ts\";\nimport type { Runtime } from \"./getRuntime.ts\";\nexport function ensureAgents(\n docsMapping: Record<string, PackageDocs>,\n runtime: Runtime,\n installedPackages: string[] = Object.keys(docsMapping),\n) {\n const run = runtime === \"bun\" ? \"bun run\" : \"npm run\";\n const command =\n runtime === \"bun\" ? \"bun run sda/main.ts\" : \"node --env-file-if-exists=.env sda/main.ts\";\n const links = getInstalledPackageConfigs(installedPackages).map((pkg) => {\n if (pkg.value === \"@observablehq/plot\")\n return `- Observable Plot charts and maps: read \\`docs/observable-plot/llm.md\\` for use with writeChart and writeMap.`;\n return `- \\`${pkg.value}\\`: start at \\`docs/${pkg.value.slice(\"@nshiab/\".length)}/llms.txt\\`, then read the relevant API pages and examples.`;\n });\n ensureManagedSection({\n path: \"AGENTS.md\",\n name: \"agents\",\n createContent: (section) => section,\n content: `Read package.json for the installed libraries and scripts. Prefer the installed data libraries when they cover the task.\n\nUse sda/main.ts as the entry point and sda/helpers/ for reusable helpers. Put tests in sda/tests/, source data in sda/data/, and results in sda/output/. Import test utilities from \\`vite-plus/test\\`.\n\nFor a single execution, run \\`${command}\\`. The sda script watches for changes. Before handing off code changes, run \\`${run} all-tests\\` and resolve failures.\n\nThe clean script removes cached results and temporary files. Run it only when those cached results can be discarded.\n\nLibrary documentation in docs/ is generated and ignored by Git. Run \\`${run} docs\\` when documentation is missing or after dependency changes; resolve refresh failures before using possibly stale references. Edit project source files rather than downloaded documentation.\n\n${links.join(\"\\n\")}`,\n });\n}\n","export function isObject(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n","import { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { isObject } from \"./jsonObject.ts\";\nexport class ProjectManifest {\n #config: Record<string, unknown>;\n private constructor(config: Record<string, unknown>) {\n this.#config = config;\n }\n static open(): ProjectManifest {\n if (!existsSync(\"package.json\"))\n return new ProjectManifest({ name: \"data-project\", private: true, type: \"module\" });\n const config: unknown = JSON.parse(readFileSync(\"package.json\", \"utf8\"));\n if (!isObject(config)) throw new Error(\"package.json must contain a JSON object.\");\n return new ProjectManifest(config);\n }\n reload(): void {\n this.#config = ProjectManifest.open().#config;\n }\n getInstalledPackages(): string[] {\n return Object.keys(this.getInstalledPackageSpecifiers());\n }\n getInstalledPackageSpecifiers(): Record<string, string> {\n const packages: Record<string, string> = {};\n for (const key of [\"dependencies\", \"devDependencies\"]) {\n const dependencies = this.#config[key];\n if (isObject(dependencies))\n for (const [name, version] of Object.entries(dependencies)) {\n if (typeof version === \"string\") packages[name] = version;\n }\n }\n return packages;\n }\n updateTasks(tasks: Record<string, string>): void {\n if (this.#config.type === \"commonjs\") {\n throw new Error(\n 'Setup requires an ESM project. Set \"type\": \"module\" in package.json, or use --docs to refresh documentation only.',\n );\n }\n if (this.#config.type === undefined) this.#config.type = \"module\";\n const existing = this.#config.scripts;\n this.#config.scripts = { ...tasks, ...(isObject(existing) ? existing : {}) };\n writeFileSync(\"package.json\", JSON.stringify(this.#config, null, 2) + \"\\n\");\n }\n}\n","import { log } from \"@clack/prompts\";\nimport {\n existsSync,\n mkdirSync,\n mkdtempSync,\n readFileSync,\n renameSync,\n rmSync,\n writeFileSync,\n} from \"node:fs\";\nimport { join, posix } from \"node:path\";\nimport { x } from \"tar\";\nimport { DOCUMENTED_PACKAGES } from \"./packageRegistry.ts\";\nexport interface PackageDocs {\n readme?: string;\n index?: string;\n llm?: string;\n plot?: { version: string; pages: string[] };\n}\nexport async function fetchPackageDocs(pkg: string, version: string): Promise<PackageDocs> {\n const config = DOCUMENTED_PACKAGES.find(\n (item) => item.value === pkg && item.value.startsWith(\"@nshiab/\"),\n );\n if (!config || !/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(version))\n throw new Error(`Unsupported package or version: ${pkg}@${version}`);\n const repo = pkg.slice(\"@nshiab/\".length);\n mkdirSync(\"docs\", { recursive: true });\n const staging = mkdtempSync(join(\"docs\", \".download-\"));\n const contents = join(staging, \"contents\");\n const target = join(\"docs\", repo);\n const backup = join(staging, \"previous\");\n try {\n const url = `https://github.com/nshiab/${repo}/releases/download/v${version}/documentation.tar.gz`;\n const response = await fetch(url);\n if (!response.ok) throw new Error(`HTTP ${response.status} from ${url}`);\n const archive = join(staging, \"documentation.tar.gz\");\n writeFileSync(archive, Buffer.from(await response.arrayBuffer()));\n mkdirSync(contents);\n let unsafeEntry: string | undefined;\n await x({\n file: archive,\n cwd: contents,\n strict: true,\n preservePaths: false,\n filter(path, entry) {\n const normalized = posix.normalize(path);\n if (\n path.includes(\"\\\\\") ||\n path.startsWith(\"/\") ||\n normalized === \"..\" ||\n normalized.startsWith(\"../\") ||\n !(\"type\" in entry) ||\n ![\"File\", \"Directory\"].includes(entry.type)\n ) {\n unsafeEntry = path;\n return false;\n }\n return true;\n },\n });\n if (unsafeEntry !== undefined) throw new Error(`Unsafe archive entry: ${unsafeEntry}`);\n for (const path of [\"README.md\", \"LICENSE\", \"llms.txt\", \"docs\"]) {\n if (!existsSync(join(contents, path)))\n throw new Error(`Documentation archive is missing ${path}.`);\n }\n const readme = readFileSync(join(contents, \"README.md\"), \"utf8\");\n const index = readFileSync(join(contents, \"llms.txt\"), \"utf8\");\n if (existsSync(target)) renameSync(target, backup);\n try {\n renameSync(contents, target);\n } catch (error) {\n if (existsSync(backup)) renameSync(backup, target);\n throw error;\n }\n return { readme, index };\n } catch (error) {\n log.warn(\n `Could not refresh ${pkg}@${version}: ${String(error)} Existing documentation was preserved and may be stale. Run the docs script again after resolving the error.`,\n );\n return {};\n } finally {\n rmSync(staging, { recursive: true, force: true });\n }\n}\n","import { posix } from \"node:path\";\n\n// The Plot source uses ATX headings, explicit VitePress IDs, and Markdown fences.\n// Keep code verbatim; rewrite only prose links and anchors while joining pages.\nexport function combinePlotDocs(version: string, documents: Map<string, string>): string {\n const pages = [...documents.keys()].sort();\n const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;\n const anchors = new Map<string, Map<string, string>>();\n const sections = new Map<string, { line: number; title: string; id: string }[]>();\n const pageId = (page: string) => `plot-${page.replace(/\\.md$/, \"\").replaceAll(\"/\", \"--\")}`;\n\n for (const page of pages) {\n const ids = new Map<string, string>();\n const headings: { line: number; title: string; id: string }[] = [];\n const counts = new Map<string, number>();\n proseLines(documents.get(page) ?? \"\", (line, number) => {\n for (const match of line.matchAll(/\\bid=[\"']([^\"']+)[\"']/g)) {\n ids.set(match[1], `${pageId(page)}--${match[1]}`);\n }\n const heading = line.match(/^ {0,3}#{1,6}\\s+(.+?)\\s*#*\\s*$/);\n if (!heading) return line;\n const explicit = heading[1].match(/\\{#([^}]+)\\}/)?.[1];\n const title = heading[1].replace(/\\s*\\{#[^}]+\\}/g, \"\");\n const slug =\n explicit ??\n title\n .replace(/<[^>]*>/g, \"\")\n .toLowerCase()\n .replace(/[^\\p{L}\\p{N}_\\s-]/gu, \"\")\n .trim()\n .replace(/\\s+/g, \"-\");\n const count = counts.get(slug) ?? 0;\n counts.set(slug, count + 1);\n const localId = `${slug}${count ? `-${count}` : \"\"}`;\n const id = `${pageId(page)}--${localId}`;\n ids.set(localId, id);\n headings.push({ line: number, title, id });\n return line;\n });\n anchors.set(page, ids);\n sections.set(page, headings);\n }\n\n function link(target: string, page: string): string {\n if (/^(?:[a-z][a-z\\d+.-]*:|\\/\\/)/i.test(target)) return target;\n const [pathAndQuery, fragment] = target.split(\"#\", 2);\n const path = pathAndQuery.split(\"?\", 1)[0];\n const resolved =\n path === \"\"\n ? page\n : posix.normalize(\n path.startsWith(\"/\") ? path.slice(1) : posix.join(posix.dirname(page), path),\n );\n const markdown = [resolved, `${resolved}.md`, `${resolved}/index.md`].find((candidate) =>\n documents.has(candidate),\n );\n if (markdown) {\n const id = fragment\n ? anchors.get(markdown)?.get(decodeURIComponent(fragment))\n : pageId(markdown);\n if (id) return `#${id}`;\n // Preserve an upstream target when a fragment is not a known heading/ID.\n return `${source}/${markdown}${fragment ? `#${fragment}` : \"\"}`;\n }\n if (resolved.endsWith(\".md\")) {\n return `${source}/${resolved}${fragment ? `#${fragment}` : \"\"}`;\n }\n const base =\n \"https://raw.githubusercontent.com/observablehq/plot/\" + `refs/tags/v${version}/docs/`;\n return path.startsWith(\"/\")\n ? new URL(`public${target}`, base).href\n : new URL(target, `${base}${page}`).href;\n }\n\n const contents = pages\n .flatMap((page) => [\n `- [${page}](#${pageId(page)})`,\n ...(sections.get(page) ?? []).map(\n ({ title, id }) => ` - [${title.replace(/[[\\]]/g, \"\")}](#${id})`,\n ),\n ])\n .join(\"\\n\");\n const combined = pages\n .map((page) => {\n const headings = new Map(\n (sections.get(page) ?? []).map((heading) => [heading.line, heading]),\n );\n const body = proseLines(documents.get(page) ?? \"\", (line, number) => {\n const heading = headings.get(number);\n // Inline code also remains verbatim. Plot's prose links have simple destinations.\n line = line\n .split(/(`+[^`]*`+)/g)\n .map((part, index) => {\n if (index % 2) return part;\n return part\n .replace(\n /(\\]\\()([^\\s)]+)([^)]*\\))/g,\n (_match: string, before: string, target: string, after: string) =>\n `${before}${link(target, page)}${after}`,\n )\n .replace(\n /^( {0,3}\\[[^\\]]+\\]:\\s*)(\\S+)/,\n (_match: string, before: string, target: string) =>\n `${before}${link(target, page)}`,\n )\n .replace(\n /(?<!:)\\b(href|src)=([\"'])([^\"']+)\\2/g,\n (_match: string, attr: string, quote: string, target: string) =>\n `${attr}=${quote}${link(target, page)}${quote}`,\n )\n .replace(\n /\\bid=([\"'])([^\"']+)\\1/g,\n (_match: string, quote: string, id: string) =>\n `id=${quote}${anchors.get(page)?.get(id) ?? id}${quote}`,\n );\n })\n .join(\"\");\n return heading\n ? `<a id=\"${heading.id}\"></a>\\n\\n${line.replace(/\\s*\\{#[^}]+\\}/g, \"\")}`\n : line;\n });\n return `<a id=\"${pageId(page)}\"></a>\\n\\n# ${page}\\n\\nSource: ${source}/${page}\\n\\n${body}`;\n })\n .join(\"\\n\\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`;\n}\n\nfunction proseLines(content: string, transform: (line: string, number: number) => string): string {\n let fence: { character: string; length: number } | undefined;\n let script = false;\n return content\n .split(\"\\n\")\n .map((line, number) => {\n const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);\n if (fence) {\n if (\n marker?.[1][0] === fence.character &&\n marker[1].length >= fence.length &&\n /^ {0,3}(?:`+|~+)\\s*$/.test(line)\n )\n fence = undefined;\n return line;\n }\n if (marker) {\n fence = { character: marker[1][0], length: marker[1].length };\n return line;\n }\n if (/^\\s*<script\\b/.test(line)) script = true;\n if (script) {\n if (/<\\/script>/.test(line)) script = false;\n return line;\n }\n return transform(line, number);\n })\n .join(\"\\n\");\n}\n","// Static chart creation references. Keep this explicit so new upstream pages do\n// not silently expand the installed agent reference.\nexport const PLOT_DOC_PAGES: string[] = [\n \"features/plots.md\",\n \"features/marks.md\",\n \"features/scales.md\",\n \"features/projections.md\",\n \"features/legends.md\",\n \"features/facets.md\",\n \"features/formats.md\",\n \"features/curves.md\",\n \"transforms/bin.md\",\n \"transforms/group.md\",\n \"transforms/stack.md\",\n \"transforms/normalize.md\",\n \"transforms/centroid.md\",\n \"transforms/sort.md\",\n \"marks/area.md\",\n \"marks/arrow.md\",\n \"marks/axis.md\",\n \"marks/bar.md\",\n \"marks/bollinger.md\",\n \"marks/box.md\",\n \"marks/cell.md\",\n \"marks/contour.md\",\n \"marks/delaunay.md\",\n \"marks/density.md\",\n \"marks/difference.md\",\n \"marks/dot.md\",\n \"marks/frame.md\",\n \"marks/geo.md\",\n \"marks/grid.md\",\n \"marks/hexgrid.md\",\n \"marks/image.md\",\n \"marks/line.md\",\n \"marks/linear-regression.md\",\n \"marks/link.md\",\n \"marks/raster.md\",\n \"marks/rect.md\",\n \"marks/rule.md\",\n \"marks/text.md\",\n \"marks/tick.md\",\n \"marks/tree.md\",\n \"marks/vector.md\",\n \"marks/waffle.md\",\n].sort();\n","import { log } from \"@clack/prompts\";\nimport { mkdirSync, renameSync, rmSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { combinePlotDocs } from \"./combinePlotDocs.ts\";\nimport { PLOT_DOC_PAGES } from \"./plotDocPages.ts\";\nimport type { PackageDocs } from \"./fetchPackageDocs.ts\";\n\n// Publish one reference only after every tagged page has been fetched.\nexport async function fetchPlotDocs(\n version: string,\n options: { preferStored?: boolean } = {},\n): Promise<PackageDocs> {\n const tag = `v${version}`;\n const directory = join(\"docs\", \"observable-plot\");\n try {\n let llm: string | undefined;\n if (options.preferStored !== false) {\n try {\n const response = await fetch(\n \"https://raw.githubusercontent.com/nshiab/setup-data-project/\" +\n `refs/heads/main/docs-cache/observable-plot/${version}/llm.md`,\n );\n if (response.ok) {\n const cached = await response.text();\n if (isStoredReference(cached, version)) llm = cached;\n }\n } catch {\n // A cache is an optimization. An unavailable cache never blocks the tag.\n }\n }\n if (llm === undefined) llm = await generateReference(version);\n mkdirSync(directory, { recursive: true });\n const temporaryPath = join(directory, \".llm.md.tmp\");\n try {\n writeFileSync(temporaryPath, llm);\n renameSync(temporaryPath, join(directory, \"llm.md\"));\n } finally {\n rmSync(temporaryPath, { force: true });\n }\n return { llm, plot: { version, pages: [...PLOT_DOC_PAGES] } };\n } catch (error) {\n log.warn(\n `Could not fetch complete Observable Plot documentation for ${tag}. ` +\n \"Existing files were preserved, but may not match the installed \" +\n \"version. Resolve the refresh failure before using this reference. \" +\n String(error),\n );\n return {};\n }\n}\n\nasync function generateReference(version: string): Promise<string> {\n const tag = `v${version}`;\n const pages = PLOT_DOC_PAGES;\n const documents = new Map<string, string>();\n const failed: string[] = [];\n // Fetch in small batches to avoid overwhelming GitHub on the first run.\n for (let offset = 0; offset < pages.length; offset += 8) {\n await Promise.all(\n pages.slice(offset, offset + 8).map(async (page) => {\n try {\n const url =\n \"https://raw.githubusercontent.com/observablehq/plot/\" +\n `refs/tags/${tag}/docs/${page}`;\n const response = await fetch(url);\n if (!response.ok) throw new Error(`HTTP ${response.status}`);\n const content = await response.text();\n documents.set(page, content);\n } catch {\n failed.push(page);\n }\n }),\n );\n }\n\n if (failed.length > 0) {\n throw new Error(`Could not fetch ${failed.length} Markdown pages`);\n }\n return combinePlotDocs(version, documents);\n}\n\nfunction isStoredReference(content: string, version: string): boolean {\n const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;\n const metadata = content.split(/\\n\\s*\\n/)[1]?.replace(/\\s+/g, \" \");\n if (\n !content.startsWith(`# Observable Plot ${version}\\n\\n`) ||\n metadata !== `Package: \\`@observablehq/plot@${version}\\`. Source: [v${version}](${source}).` ||\n !content.trimEnd().endsWith(`<!-- setup-data-project:observable-plot:${version}:complete -->`)\n )\n return false;\n\n // Match actual page sections, not TOC entries. Require every selected page\n // exactly once and some upstream heading/content after its source record.\n const sections = [\n ...content.matchAll(/<a id=\"(plot-[^\"]+)\"><\\/a>\\n\\n# ([^\\n]+\\.md)\\n\\nSource:\\s+([^\\s]+)\\n\\n/g),\n ];\n if (sections.length !== PLOT_DOC_PAGES.length) return false;\n const found = new Set<string>();\n for (let index = 0; index < sections.length; index++) {\n const section = sections[index];\n const page = section[2];\n const id = `plot-${page.replace(/\\.md$/, \"\").replaceAll(\"/\", \"--\")}`;\n if (\n !PLOT_DOC_PAGES.includes(page) ||\n found.has(page) ||\n section[1] !== id ||\n section[3] !== `${source}/${page}`\n )\n return false;\n const body = content.slice(section.index + section[0].length, sections[index + 1]?.index);\n if (!/^#{1,6}\\s+\\S/m.test(body)) return false;\n found.add(page);\n }\n return true;\n}\n","import { log } from \"@clack/prompts\";\nimport { fetchPackageDocs, type PackageDocs } from \"./fetchPackageDocs.ts\";\nimport { fetchPlotDocs } from \"./fetchPlotDocs.ts\";\nimport { getInstalledPackageConfigs } from \"./packageRegistry.ts\";\nexport async function syncPackageDocs(\n installedPackages: string[],\n installedVersions: Record<string, string>,\n): Promise<Record<string, PackageDocs>> {\n const mapping: Record<string, PackageDocs> = {};\n for (const pkg of getInstalledPackageConfigs(installedPackages)) {\n const version = installedVersions[pkg.value];\n if (!version) {\n log.warn(\n `Could not determine the installed version of ${pkg.value}. Install the project dependencies, then run the docs script again. Existing documentation may be stale.`,\n );\n continue;\n }\n const docs =\n pkg.value === \"@observablehq/plot\"\n ? await fetchPlotDocs(version)\n : await fetchPackageDocs(pkg.value, version);\n if (docs.index !== undefined || docs.plot) mapping[pkg.value] = docs;\n }\n return mapping;\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { isObject } from \"./jsonObject.ts\";\nexport function getInstalledPackageVersions(\n packageSpecifiers: Record<string, string>,\n): Record<string, string> {\n const versions: Record<string, string> = {};\n for (const pkg of Object.keys(packageSpecifiers)) {\n const path = join(\"node_modules\", pkg, \"package.json\");\n if (!existsSync(path)) continue;\n const config: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n isObject(config) &&\n typeof config.version === \"string\" &&\n /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(config.version)\n )\n versions[pkg] = config.version;\n }\n return versions;\n}\n","import { SUPPORTED_PACKAGES } from \"./packageRegistry.ts\";\n\nexport interface CliOptions {\n help: boolean;\n docs: boolean;\n packages: string[];\n}\n\nconst packageFlags = new Map(\n SUPPORTED_PACKAGES.map((pkg) => [\n `--${pkg.label.replace(/^simple-data-analysis/, \"sda\").replace(/^journalism-/, \"\")}`,\n pkg.value,\n ]),\n);\n\nexport const CLI_HELP = `Usage: setup-data-project [library flags | --docs] [--help]\n\n${Array.from(packageFlags, ([flag, pkg]) => ` ${flag.padEnd(16)} Select ${pkg}.`).join(\"\\n\")}\n --docs Refresh documentation only for installed libraries.\n -h, --help Show this help and exit.\n\nWithout a package flag, choose packages interactively.\nCombine package flags to select libraries without prompting.\nPackage flags keep existing versions and still set up project files and docs.`;\n\nexport function parseArguments(args: string[]): CliOptions {\n const options: CliOptions = { help: false, docs: false, packages: [] };\n\n for (const arg of args) {\n const pkg = packageFlags.get(arg);\n if (arg === \"--help\" || arg === \"-h\") {\n options.help = true;\n } else if (arg === \"--docs\") {\n options.docs = true;\n } else if (pkg) {\n if (!options.packages.includes(pkg)) options.packages.push(pkg);\n } else {\n throw new Error(`Unknown argument: ${arg}. Use --help for usage.`);\n }\n }\n\n if (options.docs && options.packages.length > 0)\n throw new Error(\"--docs cannot be combined with package flags.\");\n return options;\n}\n","#!/usr/bin/env node\nimport { cancel, intro, isCancel, multiselect, outro, select, spinner } from \"@clack/prompts\";\nimport process from \"node:process\";\nimport { execFileSync } from \"node:child_process\";\n\nimport { getRuntime } from \"./helpers/getRuntime.ts\";\nimport { PACKAGE_OPTIONS } from \"./helpers/packageOptions.ts\";\nimport { ensureGitignore } from \"./helpers/ensureGitignore.ts\";\nimport { ensureReadme } from \"./helpers/ensureReadme.ts\";\nimport { ensureTooling } from \"./helpers/ensureTooling.ts\";\nimport { ensureVscode } from \"./helpers/ensureVscode.ts\";\nimport { runPackageManager, installPackages } from \"./helpers/installPackages.ts\";\nimport { getProjectTasks } from \"./helpers/getProjectTasks.ts\";\nimport { createFolderStructure } from \"./helpers/createFolderStructure.ts\";\nimport { ensureEnvFile } from \"./helpers/ensureEnvFile.ts\";\nimport { ensureAgents } from \"./helpers/ensureAgents.ts\";\nimport { getInstalledPackageConfigs } from \"./helpers/packageRegistry.ts\";\nimport { ProjectManifest } from \"./helpers/projectManifest.ts\";\nimport { syncPackageDocs } from \"./helpers/syncPackageDocs.ts\";\nimport { getInstalledPackageVersions } from \"./helpers/getInstalledPackageVersions.ts\";\nimport { CLI_HELP, parseArguments } from \"./helpers/parseArguments.ts\";\n\nasync function main() {\n const cliOptions = parseArguments(process.argv.slice(2));\n if (cliOptions.help) {\n console.log(CLI_HELP);\n return;\n }\n\n const runtime = getRuntime();\n const projectManifest = ProjectManifest.open();\n if (cliOptions.docs) {\n await refreshDocs(projectManifest);\n return;\n }\n console.log();\n intro(`Hi! ๐ (Running on ${runtime})`);\n\n const installedPackages = projectManifest.getInstalledPackages();\n const options = PACKAGE_OPTIONS.map((opt) => ({\n ...opt,\n label: installedPackages.includes(opt.value)\n ? `${opt.label} \\x1b[2m(installed)\\x1b[22m`\n : opt.label,\n }));\n\n const selectedPackages =\n cliOptions.packages.length > 0\n ? cliOptions.packages\n : await multiselect({\n message:\n \"Which libraries would you like to install?\\n\\x1b[2m(space to select, arrows to navigate, enter to confirm)\\x1b[22m\\n\",\n options,\n required: false,\n });\n\n if (isCancel(selectedPackages)) {\n cancel(\"Installation cancelled.\");\n process.exit(0);\n }\n\n const alreadyInstalled = selectedPackages.filter((pkg) => installedPackages.includes(pkg));\n\n const packagesToInstall: string[] = [];\n\n for (const pkg of selectedPackages) {\n if (alreadyInstalled.includes(pkg)) {\n if (cliOptions.packages.length > 0) continue;\n\n const action = await select({\n message: `${pkg} is already installed. What would you like to do?`,\n options: [\n { value: \"skip\", label: \"Keep existing version\" },\n { value: \"update\", label: \"Update to latest\" },\n ],\n });\n\n if (isCancel(action)) {\n cancel(\"Installation cancelled.\");\n process.exit(0);\n }\n\n if (action === \"update\") {\n packagesToInstall.push(pkg);\n }\n } else {\n packagesToInstall.push(pkg);\n }\n }\n\n projectManifest.updateTasks(getProjectTasks(runtime));\n\n const sInstall = spinner();\n sInstall.start(\"Installing packages...\");\n\n try {\n await installPackages(packagesToInstall);\n projectManifest.reload();\n const declared = projectManifest.getInstalledPackageSpecifiers();\n if (\n projectManifest\n .getInstalledPackages()\n .some((pkg) =>\n [\"@nshiab/simple-data-analysis\", \"@nshiab/journalism-dataviz\"].includes(pkg),\n ) &&\n !declared[\"@observablehq/plot\"]\n ) {\n await installPackages([\"@observablehq/plot\"]);\n projectManifest.reload();\n }\n await ensureTooling(projectManifest);\n // Reinstall declared dependencies when a project was cloned without node_modules.\n projectManifest.reload();\n const versions = getInstalledPackageVersions(projectManifest.getInstalledPackageSpecifiers());\n if (projectManifest.getInstalledPackages().some((pkg) => !versions[pkg]))\n await runPackageManager([\"install\"]);\n } catch (error) {\n sInstall.stop(\"Package installation failed.\");\n throw error;\n }\n sInstall.stop(\"Packages installed.\");\n\n projectManifest.reload();\n const finalInstalledPackages = getInstalledPackageConfigs(\n projectManifest.getInstalledPackages(),\n ).map((pkg) => pkg.value);\n const docsMapping = await refreshDocs(projectManifest);\n\n const sConfig = spinner();\n sConfig.start(\"Preparing project files and configuration...\");\n try {\n projectManifest.updateTasks(getProjectTasks());\n execFileSync(process.execPath, [\"node_modules/vite-plus/bin/vp\", \"fmt\", \"package.json\"], {\n stdio: \"pipe\",\n });\n\n createFolderStructure(finalInstalledPackages);\n ensureGitignore();\n ensureEnvFile();\n ensureVscode();\n ensureReadme(runtime, finalInstalledPackages);\n ensureAgents(docsMapping, runtime, finalInstalledPackages);\n } catch (error) {\n sConfig.stop(\"Project configuration failed.\");\n throw error;\n }\n sConfig.stop(\"Project files and configuration ready.\");\n\n outro(\n process.exitCode\n ? \"Project setup complete; documentation needs attention.\"\n : \"You are all set! ๐\",\n );\n}\n\nasync function refreshDocs(manifest: ProjectManifest) {\n const packages = getInstalledPackageConfigs(manifest.getInstalledPackages()).map(\n (pkg) => pkg.value,\n );\n const sDocs = spinner();\n sDocs.start(\"Downloading documentation...\");\n try {\n const mapping = await syncPackageDocs(\n packages,\n getInstalledPackageVersions(manifest.getInstalledPackageSpecifiers()),\n );\n if (Object.keys(mapping).length !== packages.length) {\n sDocs.stop(\"Documentation incomplete. See the warnings above.\");\n process.exitCode = 1;\n } else {\n sDocs.stop(\n packages.length > 0 ? \"Documentation downloaded.\" : \"No library documentation to download.\",\n );\n }\n return mapping;\n } catch (error) {\n sDocs.stop(\"Documentation download failed.\");\n throw error;\n }\n}\n\nmain().catch((error) => {\n const message = error instanceof Error ? error.message : String(error);\n console.error(`โ Error: ${message}`);\n process.exitCode = 1;\n});\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"main.mjs","names":["process","metadata.version","process"],"sources":["../src/helpers/getRuntime.ts","../src/helpers/packageRegistry.ts","../src/helpers/packageOptions.ts","../src/helpers/gitignoreEntries.ts","../src/helpers/ensureGitignore.ts","../src/helpers/ensureManagedSection.ts","../src/helpers/ensureReadme.ts","../src/helpers/installPackages.ts","../src/helpers/ensureTooling.ts","../src/helpers/ensureVscode.ts","../package.json","../src/helpers/getProjectTasks.ts","../src/helpers/createFolderStructure.ts","../src/helpers/ensureEnvFile.ts","../src/helpers/ensureAgents.ts","../src/helpers/jsonObject.ts","../src/helpers/projectManifest.ts","../src/helpers/fetchPackageDocs.ts","../src/helpers/combinePlotDocs.ts","../src/helpers/plotDocPages.ts","../src/helpers/splitPlotDocs.ts","../src/helpers/fetchPlotDocs.ts","../src/helpers/syncPackageDocs.ts","../src/helpers/getInstalledPackageVersions.ts","../src/helpers/parseArguments.ts","../src/main.ts"],"sourcesContent":["import process from \"node:process\";\nexport type Runtime = \"node\" | \"bun\";\nexport function getRuntime(versions: { bun?: string; node?: string } = process.versions): Runtime {\n return versions.bun ? \"bun\" : \"node\";\n}\n","export interface PackageConfig {\n value: string;\n label: string;\n type: \"sda\" | \"journalism\" | \"other\";\n hint?: string;\n}\n\nexport const SUPPORTED_PACKAGES: PackageConfig[] = [\n {\n value: \"@nshiab/simple-data-analysis\",\n label: \"simple-data-analysis\",\n type: \"sda\",\n hint: \"All the core functionality, plus methods for dataviz, AI, Google sheets, etc.\",\n },\n {\n value: \"@nshiab/simple-data-analysis-core\",\n label: \"simple-data-analysis-core\",\n type: \"sda\",\n hint: \"No fluff. Great for constrained environments, like a cheap server.\",\n },\n {\n value: \"@nshiab/journalism-ai\",\n label: \"journalism-ai\",\n type: \"journalism\",\n hint: \"Easily use AI local models with Ollama or remote models with Gemini/Vertex.\",\n },\n {\n value: \"@nshiab/journalism-google\",\n label: \"journalism-google\",\n type: \"journalism\",\n hint: \"Push and retrieve data from Google Sheets, Google Bucket, and more.\",\n },\n {\n value: \"@nshiab/journalism-web-scraping\",\n label: \"journalism-web-scraping\",\n type: \"journalism\",\n hint: \"Retrieve data from Statistics Canada tables, HTML table, download files...\",\n },\n {\n value: \"@nshiab/journalism-finance\",\n label: \"journalism-finance\",\n type: \"journalism\",\n hint: \"Retrieve financial data, calculate Canadian mortgage payments and taxes...\",\n },\n {\n value: \"@nshiab/journalism-format\",\n label: \"journalism-format\",\n type: \"journalism\",\n hint: \"Easily format dates, numbers, currencies...\",\n },\n {\n value: \"@nshiab/journalism-climate\",\n label: \"journalism-climate\",\n type: \"journalism\",\n hint: \"Retrieve data from Environment Canada APIs and more.\",\n },\n {\n value: \"@nshiab/journalism-dataviz\",\n label: \"journalism-dataviz\",\n type: \"journalism\",\n hint: \"Render charts/maps with Observable Plot or directly in the terminal.\",\n },\n {\n value: \"@nshiab/journalism-geo\",\n label: \"journalism-geo\",\n type: \"journalism\",\n hint: \"Calculate distances, transform 2D coordinates to 3D, wrangle GeoTIFF files...\",\n },\n {\n value: \"@nshiab/journalism-statistics\",\n label: \"journalism-statistics\",\n type: \"journalism\",\n hint: \"Functions for statistical tests, clustering, random path generation...\",\n },\n {\n value: \"@nshiab/journalism-web\",\n label: \"journalism-web\",\n type: \"journalism\",\n hint: \"Web related functions, including downloading data as CSV, extracting ZIP files to URLs...\",\n },\n {\n value: \"@nshiab/journalism-extras\",\n label: \"journalism-extras\",\n type: \"journalism\",\n hint: \"Functions to zip/unzip, sleep, reencode files, create nested directories...\",\n },\n];\n\n// Plot is installed alongside charting libraries, but is not a setup menu option.\nexport const DOCUMENTED_PACKAGES: PackageConfig[] = [\n ...SUPPORTED_PACKAGES,\n { value: \"@nshiab/journalism\", label: \"journalism\", type: \"journalism\" },\n { value: \"@observablehq/plot\", label: \"Observable Plot\", type: \"other\" },\n];\n\nexport function getInstalledPackageConfigs(installedPackages: string[]): PackageConfig[] {\n const installedSet = new Set(installedPackages);\n return DOCUMENTED_PACKAGES.filter((pkg) => installedSet.has(pkg.value));\n}\n","import { SUPPORTED_PACKAGES } from \"./packageRegistry.ts\";\n\nexport const PACKAGE_OPTIONS = SUPPORTED_PACKAGES.map((pkg) => ({\n value: pkg.value,\n label: pkg.label,\n hint: pkg.hint,\n}));\n","export const GITIGNORE_ENTRIES = [\n \"node_modules\",\n \"docs/\",\n \".tmp\",\n \".sda-cache\",\n \".journalism-cache\",\n \"sda/data\",\n \"sda/output\",\n \".env\",\n \".DS_Store\",\n];\n","import { lstatSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { GITIGNORE_ENTRIES } from \"./gitignoreEntries.ts\";\n\nexport const GITIGNORE_SENTINEL = \"# Added by setup-data-project. Do not remove this line.\";\n\nexport function ensureGitignore() {\n const path = \".gitignore\";\n const stats = lstatSync(path, { throwIfNoEntry: false });\n\n if (stats?.isSymbolicLink()) {\n return;\n }\n\n const content = stats === undefined ? \"\" : readFileSync(path, \"utf-8\");\n const hasSentinel = content.split(\"\\n\").some((line) => line.trim() === GITIGNORE_SENTINEL);\n\n if (hasSentinel) {\n const entries = new Set(content.split(\"\\n\").map((line) => line.trim()));\n const missing = GITIGNORE_ENTRIES.filter((entry) => !entries.has(entry));\n if (missing.length)\n writeFileSync(\n path,\n content + (content.endsWith(\"\\n\") ? \"\" : \"\\n\") + missing.join(\"\\n\") + \"\\n\",\n );\n return;\n }\n\n const separator = content === \"\" ? \"\" : content.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n const block = `${GITIGNORE_SENTINEL}\\n${GITIGNORE_ENTRIES.join(\"\\n\")}\\n`;\n writeFileSync(path, content + separator + block);\n}\n","import { log } from \"@clack/prompts\";\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\n\ninterface ManagedSectionOptions {\n path: string;\n name: string;\n content: string;\n createContent: (section: string) => string;\n}\n\nexport function ensureManagedSection(\n options: ManagedSectionOptions,\n): \"created\" | \"updated\" | \"unchanged\" | \"missing-markers\" {\n const startMarker = `<!-- Do not remove / setup-data-project:${options.name}:start -->`;\n const endMarker = `<!-- Do not remove / setup-data-project:${options.name}:end -->`;\n const trimmedContent = options.content.trim();\n const section =\n trimmedContent === \"\"\n ? `${startMarker}\\n${endMarker}`\n : `${startMarker}\\n\\n${trimmedContent}\\n\\n${endMarker}`;\n\n if (!existsSync(options.path)) {\n writeFileSync(options.path, ensureFinalNewline(options.createContent(section)));\n return \"created\";\n }\n\n const currentContent = readFileSync(options.path, \"utf-8\");\n const start = currentContent.indexOf(startMarker);\n const end = currentContent.indexOf(endMarker);\n\n if (start === -1 || end === -1 || end < start) {\n log.warn(\n `${options.path} was not updated because its setup-data-project markers ` +\n `were not found. Add ${startMarker} and ${endMarker}, then rerun the ` +\n \"script.\",\n );\n return \"missing-markers\";\n }\n\n const nextContent =\n currentContent.slice(0, start) + section + currentContent.slice(end + endMarker.length);\n\n if (nextContent === currentContent) {\n return \"unchanged\";\n }\n\n writeFileSync(options.path, ensureFinalNewline(nextContent));\n return \"updated\";\n}\n\nfunction ensureFinalNewline(content: string): string {\n return content.endsWith(\"\\n\") ? content : content + \"\\n\";\n}\n","import { ensureManagedSection } from \"./ensureManagedSection.ts\";\nimport { getInstalledPackageConfigs } from \"./packageRegistry.ts\";\nimport type { Runtime } from \"./getRuntime.ts\";\nexport function ensureReadme(runtime: Runtime, installedPackages: string[] = []) {\n const run = runtime === \"bun\" ? \"bun run\" : \"npm run\";\n const vp = runtime === \"bun\" ? \"bun run --bun vp\" : \"npx vp\";\n const libraries = getInstalledPackageConfigs(installedPackages)\n .map((pkg) => `\\`${pkg.value}\\``)\n .join(\", \");\n ensureManagedSection({\n path: \"README.md\",\n name: \"libraries\",\n createContent: (section) =>\n `# Data project\\n\\nCreated with [setup-data-project](https://github.com/nshiab/setup-data-project).\\n\\n${section}`,\n content: `${libraries ? `Installed libraries: ${libraries}.\\n\\n` : \"\"}Use sda/main.ts to process source data from sda/data/ and write results to sda/output/. Both data folders are ignored by Git. Put reusable helpers in sda/helpers/ and tests in sda/tests/. Import test utilities from \\`vite-plus/test\\`.\n\n- \\`${run} sda\\`: run the analysis and watch for changes.\n- \\`${run} all-tests\\`: check types, lint, formatting, and tests; succeeds when no tests exist.\n- \\`${run} fix\\`: apply formatting and automatic fixes.\n- \\`${run} docs\\`: refresh documentation for the installed library versions.\n- \\`${run} clean\\`: delete cached results and temporary files in .sda-cache/, .journalism-cache/, and .tmp/.\n\nFor test-driven development, run one test file and watch for changes with \\`${vp} test sda/tests/example.test.ts --watch\\`. Replace the path with your test file.\n\nIn VS Code, install the recommended Vite+ extension pack for Oxc formatting and linting and the Vitest test runner. Generated .vscode/settings.json enables formatting and lint fixes on save, plus visual line wrapping. Existing VS Code configuration files are preserved.\n\nThe generated docs/ folder is ignored by Git. Refresh it after cloning or updating dependencies. See AGENTS.md for documentation pointers.`,\n });\n}\n","import { execFile } from \"node:child_process\";\nimport { getRuntime } from \"./getRuntime.ts\";\nexport function runPackageManager(args: string[]): Promise<void> {\n const command = getRuntime() === \"bun\" ? \"bun\" : process.platform === \"win32\" ? \"npm.cmd\" : \"npm\";\n return new Promise((resolve, reject) => {\n execFile(\n command,\n args,\n { maxBuffer: 10 * 1024 * 1024, shell: process.platform === \"win32\" },\n (error, stdout, stderr) => {\n if (error)\n reject(\n new Error(`${command} ${args.join(\" \")} failed.\\n${stderr || stdout}`, {\n cause: error,\n }),\n );\n else resolve();\n },\n );\n });\n}\nexport async function installPackages(\n packages: string[],\n options: { development?: boolean } = {},\n): Promise<void> {\n if (packages.length === 0) return;\n const bun = getRuntime() === \"bun\";\n await runPackageManager([\n bun ? \"add\" : \"install\",\n ...(options.development ? (bun ? [\"--dev\"] : [\"--save-dev\"]) : []),\n ...packages,\n ]);\n}\n","import { existsSync, writeFileSync } from \"node:fs\";\nimport { ProjectManifest } from \"./projectManifest.ts\";\nimport { getRuntime } from \"./getRuntime.ts\";\nimport { installPackages } from \"./installPackages.ts\";\nconst tools = [\"vite-plus\", \"typescript\", \"@types/node\"];\nexport async function ensureTooling(manifest: ProjectManifest): Promise<void> {\n const runtime = getRuntime();\n const runtimeTools = runtime === \"bun\" ? [...tools, \"@types/bun\"] : tools;\n const installed = manifest.getInstalledPackages();\n await installPackages(\n runtimeTools.filter((pkg) => !installed.includes(pkg)).map((pkg) => `${pkg}@latest`),\n { development: true },\n );\n if (\n ![\n \"vite.config.ts\",\n \"vite.config.js\",\n \"vite.config.mts\",\n \"vite.config.mjs\",\n \"vite.config.cts\",\n \"vite.config.cjs\",\n ].some((file) => existsSync(file))\n ) {\n writeFileSync(\n \"vite.config.ts\",\n `import { defineConfig, loadEnv } from \"vite-plus\";\n\nexport default defineConfig({\n test: { env: loadEnv(\"test\", process.cwd(), \"\") },\n lint: { options: { typeAware: true, typeCheck: true } },\n fmt: { ignorePatterns: [\"docs/**\", \"sda/data/**\", \"sda/output/**\"] },\n});\n`,\n );\n }\n if (!existsSync(\"tsconfig.json\"))\n writeFileSync(\n \"tsconfig.json\",\n `{\n \"compilerOptions\": {\n \"target\": \"ES2023\",\n \"module\": \"NodeNext\",\n \"strict\": true,\n \"noEmit\": true,\n \"allowImportingTsExtensions\": true,\n \"erasableSyntaxOnly\": ${runtime === \"node\"},\n \"types\": ${runtime === \"bun\" ? '[\"node\", \"bun\"]' : '[\"node\"]'},\n \"skipLibCheck\": true\n },\n \"include\": [\"sda/**/*.ts\", \"vite.config.*\"]\n}\n`,\n );\n}\n","import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\n\nexport function ensureVscode(): void {\n mkdirSync(\".vscode\", { recursive: true });\n const formatter = \"oxc.oxc-vscode\";\n const files = {\n \"extensions.json\": `{\n \"recommendations\": [\"VoidZero.vite-plus-extension-pack\"]\n}\n`,\n \"settings.json\": `${JSON.stringify(\n {\n \"editor.defaultFormatter\": formatter,\n \"[javascript]\": { \"editor.defaultFormatter\": formatter },\n \"[javascriptreact]\": { \"editor.defaultFormatter\": formatter },\n \"[typescript]\": { \"editor.defaultFormatter\": formatter },\n \"[typescriptreact]\": { \"editor.defaultFormatter\": formatter },\n \"oxc.disableNestedConfig\": true,\n \"oxc.fmt.disableNestedConfig\": true,\n \"editor.formatOnSave\": true,\n \"editor.formatOnSaveMode\": \"file\",\n \"editor.codeActionsOnSave\": { \"source.fixAll.oxc\": \"explicit\" },\n \"editor.wordWrap\": \"on\",\n },\n null,\n 2,\n )}\\n`,\n };\n for (const [name, config] of Object.entries(files)) {\n const path = `.vscode/${name}`;\n if (!existsSync(path)) writeFileSync(path, config);\n }\n}\n","","import { getRuntime, type Runtime } from \"./getRuntime.ts\";\nimport metadata from \"../../package.json\" with { type: \"json\" };\nexport function getProjectTasks(runtime: Runtime = getRuntime()) {\n const vp = runtime === \"bun\" ? \"bun run --bun vp\" : \"vp\";\n return {\n sda:\n runtime === \"bun\"\n ? \"bun run --watch sda/main.ts\"\n : \"node --env-file-if-exists=.env --watch sda/main.ts\",\n \"all-tests\": `${vp} check && ${vp} test --passWithNoTests`,\n clean: \"rm -rf .sda-cache .journalism-cache .tmp\",\n fix: `${vp} check --fix`,\n docs: `${runtime === \"bun\" ? \"bunx --bun\" : \"npx\"} @nshiab/setup-data-project@${metadata.version} --docs`,\n };\n}\n","import { existsSync, lstatSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport function createFolderStructure(selectedPackages: string[]) {\n const sdaFolder = \"sda\";\n const folders = [\"data\", \"helpers\", \"output\", \"tests\"];\n\n if (!existsSync(sdaFolder)) {\n mkdirSync(sdaFolder, { recursive: true });\n }\n\n for (const folder of folders) {\n const path = join(sdaFolder, folder);\n if (!existsSync(path)) {\n mkdirSync(path, { recursive: true });\n }\n }\n\n const mainTsPath = join(sdaFolder, \"main.ts\");\n\n let mainTsContent = 'console.log(\"Hello simple-data-analysis!\");\\n';\n\n if (\n selectedPackages.includes(\"@nshiab/simple-data-analysis\") ||\n selectedPackages.includes(\"@nshiab/simple-data-analysis-core\")\n ) {\n const pkg = selectedPackages.includes(\"@nshiab/simple-data-analysis\")\n ? \"@nshiab/simple-data-analysis\"\n : \"@nshiab/simple-data-analysis-core\";\n mainTsContent = `import { SimpleDB } from \"${pkg}\";\n\nconst sdb = new SimpleDB();\nconst table = sdb.newTable();\n\nawait table.loadArray([{ message: \"Hello simple-data-analysis!\" }]).log();\n\nawait sdb.close();\n`;\n }\n\n if (lstatSync(mainTsPath, { throwIfNoEntry: false }) === undefined) {\n writeFileSync(mainTsPath, mainTsContent);\n }\n\n return sdaFolder;\n}\n","import { lstatSync, writeFileSync } from \"node:fs\";\n\nexport function ensureEnvFile() {\n if (lstatSync(\".env\", { throwIfNoEntry: false }) === undefined) {\n writeFileSync(\".env\", \"\");\n }\n}\n","import type { PackageDocs } from \"./fetchPackageDocs.ts\";\nimport { ensureManagedSection } from \"./ensureManagedSection.ts\";\nimport { getInstalledPackageConfigs } from \"./packageRegistry.ts\";\nimport type { Runtime } from \"./getRuntime.ts\";\nexport function ensureAgents(\n docsMapping: Record<string, PackageDocs>,\n runtime: Runtime,\n installedPackages: string[] = Object.keys(docsMapping),\n) {\n const run = runtime === \"bun\" ? \"bun run\" : \"npm run\";\n const command =\n runtime === \"bun\" ? \"bun run sda/main.ts\" : \"node --env-file-if-exists=.env sda/main.ts\";\n const links = getInstalledPackageConfigs(installedPackages).map((pkg) => {\n if (pkg.value === \"@observablehq/plot\")\n return `- Observable Plot charts and maps: start at \\`docs/observable-plot/llms.txt\\`, then read the relevant pages for use with writeChart and writeMap.`;\n return `- \\`${pkg.value}\\`: start at \\`docs/${pkg.value.slice(\"@nshiab/\".length)}/llms.txt\\`, then read the relevant API pages and examples.`;\n });\n ensureManagedSection({\n path: \"AGENTS.md\",\n name: \"agents\",\n createContent: (section) => section,\n content: `Read package.json for the installed libraries and scripts. Prefer the installed data libraries when they cover the task.\n\nUse sda/main.ts as the entry point and sda/helpers/ for reusable helpers. Put tests in sda/tests/, source data in sda/data/, and results in sda/output/. Import test utilities from \\`vite-plus/test\\`.\n\nFor a single execution, run \\`${command}\\`. The sda script watches for changes. Before handing off code changes, run \\`${run} all-tests\\` and resolve failures.\n\nThe clean script removes cached results and temporary files. Run it only when those cached results can be discarded.\n\nLibrary documentation in docs/ is generated and ignored by Git. Run \\`${run} docs\\` when documentation is missing or after dependency changes; resolve refresh failures before using possibly stale references. Edit project source files rather than downloaded documentation.\n\n${links.join(\"\\n\")}`,\n });\n}\n","export function isObject(value: unknown): value is Record<string, unknown> {\n return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n","import { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { isObject } from \"./jsonObject.ts\";\nexport class ProjectManifest {\n #config: Record<string, unknown>;\n private constructor(config: Record<string, unknown>) {\n this.#config = config;\n }\n static open(): ProjectManifest {\n if (!existsSync(\"package.json\"))\n return new ProjectManifest({ name: \"data-project\", private: true, type: \"module\" });\n const config: unknown = JSON.parse(readFileSync(\"package.json\", \"utf8\"));\n if (!isObject(config)) throw new Error(\"package.json must contain a JSON object.\");\n return new ProjectManifest(config);\n }\n reload(): void {\n this.#config = ProjectManifest.open().#config;\n }\n getInstalledPackages(): string[] {\n return Object.keys(this.getInstalledPackageSpecifiers());\n }\n getInstalledPackageSpecifiers(): Record<string, string> {\n const packages: Record<string, string> = {};\n for (const key of [\"dependencies\", \"devDependencies\"]) {\n const dependencies = this.#config[key];\n if (isObject(dependencies))\n for (const [name, version] of Object.entries(dependencies)) {\n if (typeof version === \"string\") packages[name] = version;\n }\n }\n return packages;\n }\n updateTasks(tasks: Record<string, string>): void {\n if (this.#config.type === \"commonjs\") {\n throw new Error(\n 'Setup requires an ESM project. Set \"type\": \"module\" in package.json, or use --docs to refresh documentation only.',\n );\n }\n if (this.#config.type === undefined) this.#config.type = \"module\";\n const existing = this.#config.scripts;\n this.#config.scripts = { ...tasks, ...(isObject(existing) ? existing : {}) };\n writeFileSync(\"package.json\", JSON.stringify(this.#config, null, 2) + \"\\n\");\n }\n}\n","import { log } from \"@clack/prompts\";\nimport {\n existsSync,\n mkdirSync,\n mkdtempSync,\n readFileSync,\n renameSync,\n rmSync,\n writeFileSync,\n} from \"node:fs\";\nimport { join, posix } from \"node:path\";\nimport { x } from \"tar\";\nimport { DOCUMENTED_PACKAGES } from \"./packageRegistry.ts\";\nexport interface PackageDocs {\n readme?: string;\n index?: string;\n llm?: string;\n plot?: { version: string; pages: string[] };\n}\nexport async function fetchPackageDocs(pkg: string, version: string): Promise<PackageDocs> {\n const config = DOCUMENTED_PACKAGES.find(\n (item) => item.value === pkg && item.value.startsWith(\"@nshiab/\"),\n );\n if (!config || !/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(version))\n throw new Error(`Unsupported package or version: ${pkg}@${version}`);\n const repo = pkg.slice(\"@nshiab/\".length);\n mkdirSync(\"docs\", { recursive: true });\n const staging = mkdtempSync(join(\"docs\", \".download-\"));\n const contents = join(staging, \"contents\");\n const target = join(\"docs\", repo);\n const backup = join(staging, \"previous\");\n try {\n const url = `https://github.com/nshiab/${repo}/releases/download/v${version}/documentation.tar.gz`;\n const response = await fetch(url);\n if (!response.ok) throw new Error(`HTTP ${response.status} from ${url}`);\n const archive = join(staging, \"documentation.tar.gz\");\n writeFileSync(archive, Buffer.from(await response.arrayBuffer()));\n mkdirSync(contents);\n let unsafeEntry: string | undefined;\n await x({\n file: archive,\n cwd: contents,\n strict: true,\n preservePaths: false,\n filter(path, entry) {\n const normalized = posix.normalize(path);\n if (\n path.includes(\"\\\\\") ||\n path.startsWith(\"/\") ||\n normalized === \"..\" ||\n normalized.startsWith(\"../\") ||\n !(\"type\" in entry) ||\n ![\"File\", \"Directory\"].includes(entry.type)\n ) {\n unsafeEntry = path;\n return false;\n }\n return true;\n },\n });\n if (unsafeEntry !== undefined) throw new Error(`Unsafe archive entry: ${unsafeEntry}`);\n for (const path of [\"README.md\", \"LICENSE\", \"llms.txt\", \"docs\"]) {\n if (!existsSync(join(contents, path)))\n throw new Error(`Documentation archive is missing ${path}.`);\n }\n const readme = readFileSync(join(contents, \"README.md\"), \"utf8\");\n const index = readFileSync(join(contents, \"llms.txt\"), \"utf8\");\n if (existsSync(target)) renameSync(target, backup);\n try {\n renameSync(contents, target);\n } catch (error) {\n if (existsSync(backup)) renameSync(backup, target);\n throw error;\n }\n return { readme, index };\n } catch (error) {\n log.warn(\n `Could not refresh ${pkg}@${version}: ${String(error)} Existing documentation was preserved and may be stale. Run the docs script again after resolving the error.`,\n );\n return {};\n } finally {\n rmSync(staging, { recursive: true, force: true });\n }\n}\n","import { posix } from \"node:path\";\n\n// The Plot source uses ATX headings, explicit VitePress IDs, and Markdown fences.\n// Keep code verbatim; rewrite only prose links and anchors while joining pages.\nexport function combinePlotDocs(version: string, documents: Map<string, string>): string {\n const pages = [...documents.keys()].sort();\n const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;\n const anchors = new Map<string, Map<string, string>>();\n const sections = new Map<string, { line: number; title: string; id: string }[]>();\n const pageId = (page: string) => `plot-${page.replace(/\\.md$/, \"\").replaceAll(\"/\", \"--\")}`;\n\n for (const page of pages) {\n const ids = new Map<string, string>();\n const headings: { line: number; title: string; id: string }[] = [];\n const counts = new Map<string, number>();\n proseLines(documents.get(page) ?? \"\", (line, number) => {\n for (const match of line.matchAll(/\\bid=[\"']([^\"']+)[\"']/g)) {\n ids.set(match[1], `${pageId(page)}--${match[1]}`);\n }\n const heading = line.match(/^ {0,3}#{1,6}\\s+(.+?)\\s*#*\\s*$/);\n if (!heading) return line;\n const explicit = heading[1].match(/\\{#([^}]+)\\}/)?.[1];\n const title = heading[1].replace(/\\s*\\{#[^}]+\\}/g, \"\");\n const slug =\n explicit ??\n title\n .replace(/<[^>]*>/g, \"\")\n .toLowerCase()\n .replace(/[^\\p{L}\\p{N}_\\s-]/gu, \"\")\n .trim()\n .replace(/\\s+/g, \"-\");\n const count = counts.get(slug) ?? 0;\n counts.set(slug, count + 1);\n const localId = `${slug}${count ? `-${count}` : \"\"}`;\n const id = `${pageId(page)}--${localId}`;\n ids.set(localId, id);\n headings.push({ line: number, title, id });\n return line;\n });\n anchors.set(page, ids);\n sections.set(page, headings);\n }\n\n function link(target: string, page: string): string {\n if (/^(?:[a-z][a-z\\d+.-]*:|\\/\\/)/i.test(target)) return target;\n const [pathAndQuery, fragment] = target.split(\"#\", 2);\n const path = pathAndQuery.split(\"?\", 1)[0];\n const resolved =\n path === \"\"\n ? page\n : posix.normalize(\n path.startsWith(\"/\") ? path.slice(1) : posix.join(posix.dirname(page), path),\n );\n const markdown = [resolved, `${resolved}.md`, `${resolved}/index.md`].find((candidate) =>\n documents.has(candidate),\n );\n if (markdown) {\n const id = fragment\n ? anchors.get(markdown)?.get(decodeURIComponent(fragment))\n : pageId(markdown);\n if (id) return `#${id}`;\n // Preserve an upstream target when a fragment is not a known heading/ID.\n return `${source}/${markdown}${fragment ? `#${fragment}` : \"\"}`;\n }\n if (resolved.endsWith(\".md\")) {\n return `${source}/${resolved}${fragment ? `#${fragment}` : \"\"}`;\n }\n const base =\n \"https://raw.githubusercontent.com/observablehq/plot/\" + `refs/tags/v${version}/docs/`;\n return path.startsWith(\"/\")\n ? new URL(`public${target}`, base).href\n : new URL(target, `${base}${page}`).href;\n }\n\n const contents = pages\n .flatMap((page) => [\n `- [${page}](#${pageId(page)})`,\n ...(sections.get(page) ?? []).map(\n ({ title, id }) => ` - [${title.replace(/[[\\]]/g, \"\")}](#${id})`,\n ),\n ])\n .join(\"\\n\");\n const combined = pages\n .map((page) => {\n const headings = new Map(\n (sections.get(page) ?? []).map((heading) => [heading.line, heading]),\n );\n const body = proseLines(documents.get(page) ?? \"\", (line, number) => {\n const heading = headings.get(number);\n // Inline code also remains verbatim. Plot's prose links have simple destinations.\n line = line\n .split(/(`+[^`]*`+)/g)\n .map((part, index) => {\n if (index % 2) return part;\n return part\n .replace(\n /(\\]\\()([^\\s)]+)([^)]*\\))/g,\n (_match: string, before: string, target: string, after: string) =>\n `${before}${link(target, page)}${after}`,\n )\n .replace(\n /^( {0,3}\\[[^\\]]+\\]:\\s*)(\\S+)/,\n (_match: string, before: string, target: string) =>\n `${before}${link(target, page)}`,\n )\n .replace(\n /(?<!:)\\b(href|src)=([\"'])([^\"']+)\\2/g,\n (_match: string, attr: string, quote: string, target: string) =>\n `${attr}=${quote}${link(target, page)}${quote}`,\n )\n .replace(\n /\\bid=([\"'])([^\"']+)\\1/g,\n (_match: string, quote: string, id: string) =>\n `id=${quote}${anchors.get(page)?.get(id) ?? id}${quote}`,\n );\n })\n .join(\"\");\n return heading\n ? `<a id=\"${heading.id}\"></a>\\n\\n${line.replace(/\\s*\\{#[^}]+\\}/g, \"\")}`\n : line;\n });\n return `<a id=\"${pageId(page)}\"></a>\\n\\n# ${page}\\n\\nSource: ${source}/${page}\\n\\n${body}`;\n })\n .join(\"\\n\\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`;\n}\n\nexport function proseLines(\n content: string,\n transform: (line: string, number: number) => string,\n): string {\n let fence: { character: string; length: number } | undefined;\n let script = false;\n return content\n .split(\"\\n\")\n .map((line, number) => {\n const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);\n if (fence) {\n if (\n marker?.[1][0] === fence.character &&\n marker[1].length >= fence.length &&\n /^ {0,3}(?:`+|~+)\\s*$/.test(line)\n )\n fence = undefined;\n return line;\n }\n if (marker) {\n fence = { character: marker[1][0], length: marker[1].length };\n return line;\n }\n if (/^\\s*<script\\b/.test(line)) script = true;\n if (script) {\n if (/<\\/script>/.test(line)) script = false;\n return line;\n }\n return transform(line, number);\n })\n .join(\"\\n\");\n}\n","// Static chart creation references. Keep this explicit so new upstream pages do\n// not silently expand the installed agent reference.\nexport const PLOT_DOC_PAGES: string[] = [\n \"features/plots.md\",\n \"features/marks.md\",\n \"features/scales.md\",\n \"features/projections.md\",\n \"features/legends.md\",\n \"features/facets.md\",\n \"features/formats.md\",\n \"features/curves.md\",\n \"transforms/bin.md\",\n \"transforms/group.md\",\n \"transforms/stack.md\",\n \"transforms/normalize.md\",\n \"transforms/centroid.md\",\n \"transforms/sort.md\",\n \"marks/area.md\",\n \"marks/arrow.md\",\n \"marks/axis.md\",\n \"marks/bar.md\",\n \"marks/bollinger.md\",\n \"marks/box.md\",\n \"marks/cell.md\",\n \"marks/contour.md\",\n \"marks/delaunay.md\",\n \"marks/density.md\",\n \"marks/difference.md\",\n \"marks/dot.md\",\n \"marks/frame.md\",\n \"marks/geo.md\",\n \"marks/grid.md\",\n \"marks/hexgrid.md\",\n \"marks/image.md\",\n \"marks/line.md\",\n \"marks/linear-regression.md\",\n \"marks/link.md\",\n \"marks/raster.md\",\n \"marks/rect.md\",\n \"marks/rule.md\",\n \"marks/text.md\",\n \"marks/tick.md\",\n \"marks/tree.md\",\n \"marks/vector.md\",\n \"marks/waffle.md\",\n].sort();\n","import { posix } from \"node:path\";\nimport { proseLines } from \"./combinePlotDocs.ts\";\nimport { PLOT_DOC_PAGES } from \"./plotDocPages.ts\";\n\n// Split the cached format without changing code examples or heading anchors.\nexport function splitPlotDocs(reference: string, version: string): Map<string, string> {\n const sections = [\n ...reference.matchAll(\n /<a id=\"(plot-[^\"]+)\"><\\/a>\\n\\n# ([^\\n]+\\.md)\\n\\nSource:\\s+([^\\s]+)\\n\\n/g,\n ),\n ];\n const files = new Map<string, string>();\n const anchors = new Map<string, string>();\n const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;\n const completion = `<!-- setup-data-project:observable-plot:${version}:complete -->`;\n if (!reference.trimEnd().endsWith(completion)) throw new Error(\"Incomplete Plot reference.\");\n const end = reference.lastIndexOf(completion);\n const licenseStart = reference.lastIndexOf(\"\\n## Upstream license\\n\", end);\n for (let index = 0; index < sections.length; index++) {\n const section = sections[index];\n const page = section[2];\n if (!PLOT_DOC_PAGES.includes(page) || files.has(page) || section[3] !== `${source}/${page}`)\n throw new Error(`Invalid Plot page: ${page}`);\n const body = reference\n .slice(section.index, sections[index + 1]?.index ?? (licenseStart >= 0 ? licenseStart : end))\n .trimEnd()\n .replace(/\\n\\n---$/, \"\");\n files.set(page, body);\n proseLines(body, (line) => {\n for (const match of line.matchAll(/\\bid=[\"']([^\"']+)[\"']/g)) anchors.set(match[1], page);\n return line;\n });\n }\n if (files.size !== PLOT_DOC_PAGES.length) throw new Error(\"Incomplete Plot pages.\");\n\n for (const [page, body] of files) {\n const link = (id: string) => {\n const destination = anchors.get(id);\n return destination && destination !== page\n ? `${posix.relative(posix.dirname(page), destination)}#${id}`\n : `#${id}`;\n };\n files.set(\n page,\n proseLines(body, (line) =>\n line\n .split(/(`+[^`]*`+)/g)\n .map((part, index) =>\n index % 2\n ? part\n : part\n .replace(\n /(\\]\\()#([^\\s)]+)([^)]*\\))/g,\n (_match: string, before: string, id: string, after: string) =>\n `${before}${link(id)}${after}`,\n )\n .replace(\n /^( {0,3}\\[[^\\]]+\\]:\\s*)#(\\S+)/,\n (_match: string, before: string, id: string) => `${before}${link(id)}`,\n )\n .replace(\n /(?<!:)\\b(href|src)=([\"'])#([^\"']+)\\2/g,\n (_match: string, attr: string, quote: string, id: string) =>\n `${attr}=${quote}${link(id)}${quote}`,\n ),\n )\n .join(\"\"),\n ) + \"\\n\",\n );\n }\n const license =\n licenseStart >= 0\n ? reference.slice(licenseStart + \"\\n## Upstream license\\n\".length, end).trim()\n : undefined;\n if (license) files.set(\"LICENSE\", license + \"\\n\");\n const index =\n `# Observable Plot ${version}\\n\\n> Selected documentation for static charts and maps. Start here, then read the relevant pages.\\n\\n[Versioned upstream documentation](${source})${license ? \" ยท [License](./LICENSE)\" : \"\"}\\n\\n` +\n [\"features\", \"marks\", \"transforms\"]\n .map(\n (group) =>\n `## ${group[0].toUpperCase() + group.slice(1)}\\n\\n` +\n PLOT_DOC_PAGES.filter((page) => page.startsWith(`${group}/`))\n .map((page) => `- [${page}](./${page})`)\n .join(\"\\n\"),\n )\n .join(\"\\n\\n\") +\n \"\\n\";\n files.set(\"llms.txt\", index);\n return files;\n}\n","import { log } from \"@clack/prompts\";\nimport { existsSync, mkdirSync, mkdtempSync, renameSync, rmSync, writeFileSync } from \"node:fs\";\nimport { dirname, join } from \"node:path\";\nimport { splitPlotDocs } from \"./splitPlotDocs.ts\";\nimport { combinePlotDocs } from \"./combinePlotDocs.ts\";\nimport { PLOT_DOC_PAGES } from \"./plotDocPages.ts\";\nimport type { PackageDocs } from \"./fetchPackageDocs.ts\";\n\n// Replace local documentation only after every page is ready.\nexport async function fetchPlotDocs(\n version: string,\n options: { preferStored?: boolean } = {},\n): Promise<PackageDocs> {\n const tag = `v${version}`;\n const directory = join(\"docs\", \"observable-plot\");\n try {\n let llm: string | undefined;\n if (options.preferStored !== false) {\n try {\n const response = await fetch(\n \"https://raw.githubusercontent.com/nshiab/setup-data-project/\" +\n `refs/heads/main/docs-cache/observable-plot/${version}/llm.md`,\n );\n if (response.ok) {\n const cached = await response.text();\n if (isStoredReference(cached, version)) llm = cached;\n }\n } catch {\n // A cache is an optimization. An unavailable cache never blocks the tag.\n }\n }\n if (llm === undefined) llm = await generatePlotReference(version);\n const files = splitPlotDocs(llm, version);\n mkdirSync(\"docs\", { recursive: true });\n const staging = mkdtempSync(join(\"docs\", \".plot-\"));\n const contents = join(staging, \"contents\");\n const backup = join(staging, \"previous\");\n try {\n for (const [page, content] of files) {\n const path = join(contents, page);\n mkdirSync(dirname(path), { recursive: true });\n writeFileSync(path, content);\n }\n if (existsSync(directory)) renameSync(directory, backup);\n try {\n renameSync(contents, directory);\n } catch (error) {\n if (existsSync(backup)) renameSync(backup, directory);\n throw error;\n }\n } finally {\n rmSync(staging, { recursive: true, force: true });\n }\n return { llm, index: files.get(\"llms.txt\"), plot: { version, pages: [...PLOT_DOC_PAGES] } };\n } catch (error) {\n log.warn(\n `Could not fetch complete Observable Plot documentation for ${tag}. ` +\n \"Existing files were preserved, but may not match the installed \" +\n \"version. Resolve the refresh failure before using this reference. \" +\n String(error),\n );\n return {};\n }\n}\n\nexport async function generatePlotReference(version: string): Promise<string> {\n if (!/^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?$/.test(version))\n throw new Error(\"An exact Plot version is required.\");\n const tag = `v${version}`;\n const pages = PLOT_DOC_PAGES;\n const documents = new Map<string, string>();\n const failed: string[] = [];\n // Fetch in small batches to avoid overwhelming GitHub on the first run.\n for (let offset = 0; offset < pages.length; offset += 8) {\n await Promise.all(\n pages.slice(offset, offset + 8).map(async (page) => {\n try {\n const url =\n \"https://raw.githubusercontent.com/observablehq/plot/\" +\n `refs/tags/${tag}/docs/${page}`;\n const response = await fetch(url);\n if (!response.ok) throw new Error(`HTTP ${response.status}`);\n const content = await response.text();\n documents.set(page, content);\n } catch {\n failed.push(page);\n }\n }),\n );\n }\n\n if (failed.length > 0) {\n throw new Error(`Could not fetch ${failed.length} Markdown pages`);\n }\n const response = await fetch(\n `https://raw.githubusercontent.com/observablehq/plot/refs/tags/${tag}/LICENSE`,\n );\n if (!response.ok) throw new Error(`Could not fetch Plot's license: HTTP ${response.status}`);\n const license = await response.text();\n const completion = `<!-- setup-data-project:observable-plot:${version}:complete -->`;\n return combinePlotDocs(version, documents).replace(\n completion,\n `## Upstream license\\n\\n${license.trim()}\\n\\n${completion}`,\n );\n}\n\nfunction isStoredReference(content: string, version: string): boolean {\n const source = `https://github.com/observablehq/plot/tree/v${version}/docs`;\n const metadata = content.split(/\\n\\s*\\n/)[1]?.replace(/\\s+/g, \" \");\n if (\n !content.startsWith(`# Observable Plot ${version}\\n\\n`) ||\n metadata !== `Package: \\`@observablehq/plot@${version}\\`. Source: [v${version}](${source}).` ||\n !content.trimEnd().endsWith(`<!-- setup-data-project:observable-plot:${version}:complete -->`)\n )\n return false;\n\n // Match actual page sections, not TOC entries. Require every selected page\n // exactly once and some upstream heading/content after its source record.\n const sections = [\n ...content.matchAll(/<a id=\"(plot-[^\"]+)\"><\\/a>\\n\\n# ([^\\n]+\\.md)\\n\\nSource:\\s+([^\\s]+)\\n\\n/g),\n ];\n if (sections.length !== PLOT_DOC_PAGES.length) return false;\n const found = new Set<string>();\n for (let index = 0; index < sections.length; index++) {\n const section = sections[index];\n const page = section[2];\n const id = `plot-${page.replace(/\\.md$/, \"\").replaceAll(\"/\", \"--\")}`;\n if (\n !PLOT_DOC_PAGES.includes(page) ||\n found.has(page) ||\n section[1] !== id ||\n section[3] !== `${source}/${page}`\n )\n return false;\n const body = content.slice(section.index + section[0].length, sections[index + 1]?.index);\n if (!/^#{1,6}\\s+\\S/m.test(body)) return false;\n found.add(page);\n }\n return true;\n}\n","import { log } from \"@clack/prompts\";\nimport { fetchPackageDocs, type PackageDocs } from \"./fetchPackageDocs.ts\";\nimport { fetchPlotDocs } from \"./fetchPlotDocs.ts\";\nimport { getInstalledPackageConfigs } from \"./packageRegistry.ts\";\nexport async function syncPackageDocs(\n installedPackages: string[],\n installedVersions: Record<string, string>,\n): Promise<Record<string, PackageDocs>> {\n const mapping: Record<string, PackageDocs> = {};\n for (const pkg of getInstalledPackageConfigs(installedPackages)) {\n const version = installedVersions[pkg.value];\n if (!version) {\n log.warn(\n `Could not determine the installed version of ${pkg.value}. Install the project dependencies, then run the docs script again. Existing documentation may be stale.`,\n );\n continue;\n }\n const docs =\n pkg.value === \"@observablehq/plot\"\n ? await fetchPlotDocs(version)\n : await fetchPackageDocs(pkg.value, version);\n if (docs.index !== undefined || docs.plot) mapping[pkg.value] = docs;\n }\n return mapping;\n}\n","import { existsSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { isObject } from \"./jsonObject.ts\";\nexport function getInstalledPackageVersions(\n packageSpecifiers: Record<string, string>,\n): Record<string, string> {\n const versions: Record<string, string> = {};\n for (const pkg of Object.keys(packageSpecifiers)) {\n const path = join(\"node_modules\", pkg, \"package.json\");\n if (!existsSync(path)) continue;\n const config: unknown = JSON.parse(readFileSync(path, \"utf8\"));\n if (\n isObject(config) &&\n typeof config.version === \"string\" &&\n /^\\d+\\.\\d+\\.\\d+(?:-[0-9A-Za-z.-]+)?(?:\\+[0-9A-Za-z.-]+)?$/.test(config.version)\n )\n versions[pkg] = config.version;\n }\n return versions;\n}\n","import { SUPPORTED_PACKAGES } from \"./packageRegistry.ts\";\n\nexport interface CliOptions {\n help: boolean;\n docs: boolean;\n packages: string[];\n}\n\nconst packageFlags = new Map(\n SUPPORTED_PACKAGES.map((pkg) => [\n `--${pkg.label.replace(/^simple-data-analysis/, \"sda\").replace(/^journalism-/, \"\")}`,\n pkg.value,\n ]),\n);\n\nexport const CLI_HELP = `Usage: setup-data-project [library flags | --docs] [--help]\n\n${Array.from(packageFlags, ([flag, pkg]) => ` ${flag.padEnd(16)} Select ${pkg}.`).join(\"\\n\")}\n --docs Refresh documentation only for installed libraries.\n -h, --help Show this help and exit.\n\nWithout a package flag, choose packages interactively.\nCombine package flags to select libraries without prompting.\nPackage flags keep existing versions and still set up project files and docs.`;\n\nexport function parseArguments(args: string[]): CliOptions {\n const options: CliOptions = { help: false, docs: false, packages: [] };\n\n for (const arg of args) {\n const pkg = packageFlags.get(arg);\n if (arg === \"--help\" || arg === \"-h\") {\n options.help = true;\n } else if (arg === \"--docs\") {\n options.docs = true;\n } else if (pkg) {\n if (!options.packages.includes(pkg)) options.packages.push(pkg);\n } else {\n throw new Error(`Unknown argument: ${arg}. Use --help for usage.`);\n }\n }\n\n if (options.docs && options.packages.length > 0)\n throw new Error(\"--docs cannot be combined with package flags.\");\n return options;\n}\n","#!/usr/bin/env node\nimport { cancel, intro, isCancel, multiselect, outro, select, spinner } from \"@clack/prompts\";\nimport process from \"node:process\";\nimport { execFileSync } from \"node:child_process\";\n\nimport { getRuntime } from \"./helpers/getRuntime.ts\";\nimport { PACKAGE_OPTIONS } from \"./helpers/packageOptions.ts\";\nimport { ensureGitignore } from \"./helpers/ensureGitignore.ts\";\nimport { ensureReadme } from \"./helpers/ensureReadme.ts\";\nimport { ensureTooling } from \"./helpers/ensureTooling.ts\";\nimport { ensureVscode } from \"./helpers/ensureVscode.ts\";\nimport { runPackageManager, installPackages } from \"./helpers/installPackages.ts\";\nimport { getProjectTasks } from \"./helpers/getProjectTasks.ts\";\nimport { createFolderStructure } from \"./helpers/createFolderStructure.ts\";\nimport { ensureEnvFile } from \"./helpers/ensureEnvFile.ts\";\nimport { ensureAgents } from \"./helpers/ensureAgents.ts\";\nimport { getInstalledPackageConfigs } from \"./helpers/packageRegistry.ts\";\nimport { ProjectManifest } from \"./helpers/projectManifest.ts\";\nimport { syncPackageDocs } from \"./helpers/syncPackageDocs.ts\";\nimport { getInstalledPackageVersions } from \"./helpers/getInstalledPackageVersions.ts\";\nimport { CLI_HELP, parseArguments } from \"./helpers/parseArguments.ts\";\n\nasync function main() {\n const cliOptions = parseArguments(process.argv.slice(2));\n if (cliOptions.help) {\n console.log(CLI_HELP);\n return;\n }\n\n const runtime = getRuntime();\n const projectManifest = ProjectManifest.open();\n if (cliOptions.docs) {\n await refreshDocs(projectManifest);\n return;\n }\n console.log();\n intro(`Hi! ๐ (Running on ${runtime})`);\n\n const installedPackages = projectManifest.getInstalledPackages();\n const options = PACKAGE_OPTIONS.map((opt) => ({\n ...opt,\n label: installedPackages.includes(opt.value)\n ? `${opt.label} \\x1b[2m(installed)\\x1b[22m`\n : opt.label,\n }));\n\n const selectedPackages =\n cliOptions.packages.length > 0\n ? cliOptions.packages\n : await multiselect({\n message:\n \"Which libraries would you like to install?\\n\\x1b[2m(space to select, arrows to navigate, enter to confirm)\\x1b[22m\\n\",\n options,\n required: false,\n });\n\n if (isCancel(selectedPackages)) {\n cancel(\"Installation cancelled.\");\n process.exit(0);\n }\n\n const alreadyInstalled = selectedPackages.filter((pkg) => installedPackages.includes(pkg));\n\n const packagesToInstall: string[] = [];\n\n for (const pkg of selectedPackages) {\n if (alreadyInstalled.includes(pkg)) {\n if (cliOptions.packages.length > 0) continue;\n\n const action = await select({\n message: `${pkg} is already installed. What would you like to do?`,\n options: [\n { value: \"skip\", label: \"Keep existing version\" },\n { value: \"update\", label: \"Update to latest\" },\n ],\n });\n\n if (isCancel(action)) {\n cancel(\"Installation cancelled.\");\n process.exit(0);\n }\n\n if (action === \"update\") {\n packagesToInstall.push(pkg);\n }\n } else {\n packagesToInstall.push(pkg);\n }\n }\n\n projectManifest.updateTasks(getProjectTasks(runtime));\n\n const sInstall = spinner();\n sInstall.start(\"Installing packages...\");\n\n try {\n await installPackages(packagesToInstall);\n projectManifest.reload();\n const declared = projectManifest.getInstalledPackageSpecifiers();\n if (\n projectManifest\n .getInstalledPackages()\n .some((pkg) =>\n [\"@nshiab/simple-data-analysis\", \"@nshiab/journalism-dataviz\"].includes(pkg),\n ) &&\n !declared[\"@observablehq/plot\"]\n ) {\n await installPackages([\"@observablehq/plot\"]);\n projectManifest.reload();\n }\n await ensureTooling(projectManifest);\n // Reinstall declared dependencies when a project was cloned without node_modules.\n projectManifest.reload();\n const versions = getInstalledPackageVersions(projectManifest.getInstalledPackageSpecifiers());\n if (projectManifest.getInstalledPackages().some((pkg) => !versions[pkg]))\n await runPackageManager([\"install\"]);\n } catch (error) {\n sInstall.stop(\"Package installation failed.\");\n throw error;\n }\n sInstall.stop(\"Packages installed.\");\n\n projectManifest.reload();\n const finalInstalledPackages = getInstalledPackageConfigs(\n projectManifest.getInstalledPackages(),\n ).map((pkg) => pkg.value);\n const docsMapping = await refreshDocs(projectManifest);\n\n const sConfig = spinner();\n sConfig.start(\"Preparing project files and configuration...\");\n try {\n projectManifest.updateTasks(getProjectTasks());\n execFileSync(process.execPath, [\"node_modules/vite-plus/bin/vp\", \"fmt\", \"package.json\"], {\n stdio: \"pipe\",\n });\n\n createFolderStructure(finalInstalledPackages);\n ensureGitignore();\n ensureEnvFile();\n ensureVscode();\n ensureReadme(runtime, finalInstalledPackages);\n ensureAgents(docsMapping, runtime, finalInstalledPackages);\n } catch (error) {\n sConfig.stop(\"Project configuration failed.\");\n throw error;\n }\n sConfig.stop(\"Project files and configuration ready.\");\n\n outro(\n process.exitCode\n ? \"Project setup complete; documentation needs attention.\"\n : \"You are all set! ๐\",\n );\n}\n\nasync function refreshDocs(manifest: ProjectManifest) {\n const packages = getInstalledPackageConfigs(manifest.getInstalledPackages()).map(\n (pkg) => pkg.value,\n );\n const sDocs = spinner();\n sDocs.start(\"Downloading documentation...\");\n try {\n const mapping = await syncPackageDocs(\n packages,\n getInstalledPackageVersions(manifest.getInstalledPackageSpecifiers()),\n );\n if (Object.keys(mapping).length !== packages.length) {\n sDocs.stop(\"Documentation incomplete. See the warnings above.\");\n process.exitCode = 1;\n } else {\n sDocs.stop(\n packages.length > 0 ? \"Documentation downloaded.\" : \"No library documentation to download.\",\n );\n }\n return mapping;\n } catch (error) {\n sDocs.stop(\"Documentation download failed.\");\n throw error;\n }\n}\n\nmain().catch((error) => {\n const message = error instanceof Error ? error.message : String(error);\n console.error(`โ Error: ${message}`);\n process.exitCode = 1;\n});\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nshiab/setup-data-project",
|
|
3
|
-
"version": "3.0.
|
|
3
|
+
"version": "3.0.4",
|
|
4
4
|
"description": "Quickly kick off a project using simple-data-analysis-core, simple-data-analysis, and journalism libraries.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": "https://github.com/nshiab/setup-data-project",
|
|
@@ -17,6 +17,7 @@
|
|
|
17
17
|
"access": "public"
|
|
18
18
|
},
|
|
19
19
|
"scripts": {
|
|
20
|
+
"cache-plot-docs": "node scripts/cachePlotDocs.ts",
|
|
20
21
|
"fix": "vp check --fix",
|
|
21
22
|
"all-tests": "vp check && vp test && vp pack",
|
|
22
23
|
"preversion": "node scripts/check-release-branch.ts && npm run all-tests",
|