@nshiab/setup-data-project 1.0.7

package/esm/helpers/packageOptions.js

@@ -0,0 +1,5 @@
+import { SUPPORTED_PACKAGES } from "./packageRegistry.js";
+export const PACKAGE_OPTIONS = SUPPORTED_PACKAGES.map((pkg) => ({
+    value: pkg.value,
+    label: pkg.label,
+}));

package/esm/helpers/packageRegistry.d.ts

@@ -0,0 +1,7 @@
+export interface PackageConfig {
+    value: string;
+    label: string;
+    type: "sda" | "journalism" | "other";
+}
+export declare const SUPPORTED_PACKAGES: PackageConfig[];
+//# sourceMappingURL=packageRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packageRegistry.d.ts","sourceRoot":"","sources":["../../src/helpers/packageRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,OAAO,CAAC;CACtC;AAED,eAAO,MAAM,kBAAkB,EAAE,aAAa,EA6D7C,CAAC"}

package/esm/helpers/packageRegistry.js

@@ -0,0 +1,62 @@
+export const SUPPORTED_PACKAGES = [
+    {
+        value: "@nshiab/simple-data-analysis",
+        label: "simple-data-analysis",
+        type: "sda",
+    },
+    {
+        value: "@nshiab/journalism-ai",
+        label: "journalism-ai",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-climate",
+        label: "journalism-climate",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-dataviz",
+        label: "journalism-dataviz",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-finance",
+        label: "journalism-finance",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-format",
+        label: "journalism-format",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-geo",
+        label: "journalism-geo",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-google",
+        label: "journalism-google",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-statistics",
+        label: "journalism-statistics",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-web",
+        label: "journalism-web",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-web-scraping",
+        label: "journalism-web-scraping",
+        type: "journalism",
+    },
+    {
+        value: "@nshiab/journalism-extras",
+        label: "journalism-extras",
+        type: "journalism",
+    },
+];

package/esm/helpers/updateProjectConfig.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"updateProjectConfig.d.ts","sourceRoot":"","sources":["../../src/helpers/updateProjectConfig.ts"],"names":[],"mappings":"AAGA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QAkChE"}

package/esm/helpers/updateProjectConfig.js

@@ -0,0 +1,36 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { getRuntime } from "./getRuntime.js";
+export function updateProjectConfig(tasks) {
+    const runtime = getRuntime();
+    let configFile = "package.json";
+    let key = "scripts";
+    if (existsSync("deno.json")) {
+        configFile = "deno.json";
+        key = "tasks";
+    }
+    else if (!existsSync("package.json") && runtime === "deno") {
+        configFile = "deno.json";
+        key = "tasks";
+        writeFileSync(configFile, JSON.stringify({ [key]: {} }, null, 2));
+    }
+    else if (!existsSync("package.json")) {
+        return;
+    }
+    try {
+        const content = readFileSync(configFile, "utf-8");
+        const config = JSON.parse(content);
+        config[key] = { ...(config[key] || {}), ...tasks };
+        writeFileSync(configFile, JSON.stringify(config, null, 2), "utf-8");
+    }
+    catch (e) {
+        if (e instanceof SyntaxError) {
+            console.error(`❌ Error: Failed to parse ${configFile} as JSON. Please check its validity.`);
+        }
+        else if (e instanceof Error) {
+            console.error(`❌ Error: Could not update ${configFile}: ${e.message}`);
+        }
+        else {
+            console.error(`❌ Error: An unexpected error occurred while updating ${configFile}.`);
+        }
+    }
+}

package/esm/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/esm/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/esm/main.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+import { cancel, intro, isCancel, multiselect, outro, select, spinner, } from "@clack/prompts";
+import process from "node:process";
+import { getRuntime } from "./helpers/getRuntime.js";
+import { getInstalledPackages } from "./helpers/getInstalledPackages.js";
+import { PACKAGE_OPTIONS } from "./helpers/packageOptions.js";
+import { updateProjectConfig } from "./helpers/updateProjectConfig.js";
+import { ensureGitignore } from "./helpers/ensureGitignore.js";
+import { ensureReadme } from "./helpers/ensureReadme.js";
+import { installPackagesAndFetchDocs } from "./helpers/installPackagesAndFetchDocs.js";
+import { getProjectTasks } from "./helpers/getProjectTasks.js";
+import { createFolderStructure } from "./helpers/createFolderStructure.js";
+import { ensureEnvFile } from "./helpers/ensureEnvFile.js";
+import { ensureAgents } from "./helpers/ensureAgents.js";
+async function main() {
+    const runtime = getRuntime();
+    console.log();
+    intro(`Hi! 👋 (Running on ${runtime})`);
+    const installedPackages = getInstalledPackages();
+    const options = PACKAGE_OPTIONS.map((opt) => ({
+        ...opt,
+        label: installedPackages.includes(opt.value)
+            ? `${opt.label} \x1b[2m(installed)\x1b[22m`
+            : opt.label,
+    }));
+    const selectedPackages = (await multiselect({
+        message: "Which libraries would you like to install?\n\x1b[2m(space to select, arrows to navigate, enter to confirm)\x1b[22m\n",
+        options,
+        required: false,
+    }));
+    if (isCancel(selectedPackages)) {
+        cancel("Installation cancelled.");
+        process.exit(0);
+    }
+    const alreadyInstalled = selectedPackages.filter((pkg) => installedPackages.includes(pkg));
+    const packagesToInstall = [];
+    for (const pkg of selectedPackages) {
+        if (alreadyInstalled.includes(pkg)) {
+            const action = await select({
+                message: `${pkg} is already installed. What would you like to do?`,
+                options: [
+                    { value: "skip", label: "Keep existing version" },
+                    { value: "update", label: "Update to latest" },
+                ],
+            });
+            if (isCancel(action)) {
+                cancel("Installation cancelled.");
+                process.exit(0);
+            }
+            if (action === "update") {
+                packagesToInstall.push(pkg);
+            }
+        }
+        else {
+            packagesToInstall.push(pkg);
+        }
+    }
+    const docsMapping = {};
+    const sInstall = spinner();
+    sInstall.start("Installing packages and fetching documentation...");
+    for (const pkg of packagesToInstall) {
+        try {
+            const doc = await installPackagesAndFetchDocs([pkg]);
+            if (typeof doc === "string") {
+                docsMapping[pkg] = doc;
+            }
+        }
+        catch (error) {
+            sInstall.stop(`❌ Failed to install ${pkg}.`);
+            console.error(error);
+            process.exit(1);
+        }
+    }
+    sInstall.stop("✅ Packages installed and documentation fetched.");
+    const s = spinner();
+    s.start("Creating folder structure...");
+    try {
+        const sdaFolder = await createFolderStructure(packagesToInstall);
+        ensureGitignore();
+        await ensureEnvFile();
+        updateProjectConfig(getProjectTasks());
+        await ensureReadme(runtime);
+        await ensureAgents(docsMapping, runtime);
+        s.stop(`✅ Folder structure created in ${sdaFolder}/`);
+    }
+    catch (error) {
+        s.stop("❌ Failed to create folder structure.");
+        console.error(error);
+        process.exit(1);
+    }
+    outro("You are all set! 🙌");
+}
+main().catch(console.error);

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/npm/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nael Shiab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/npm/README.md

@@ -0,0 +1,25 @@
+# setup-data-project
+
+A CLI tool to quickly set up a data project with essential folders,
+configurations, and documentation.
+
+```sh
+# Deno
+deno run -A jsr:@nshiab/setup-data-project
+
+npx @nshiab/setup-data-project
+
+bunx @nshiab/setup-data-project
+```
+
+- Creates a standardized folder structure.
+- Ensures necessary files like `.env`, `.gitignore`, and `README.md` exist.
+- Installs
+  [simple-data-analysis](https://github.com/nshiab/simple-data-analysis/) and
+  [journalism](https://github.com/nshiab/journalism) libraries and fetches their
+  documentation for LLM use.
+- Updates project configuration (e.g., `deno.json` or `package.json`) with
+  relevant tasks.
+
+The library is maintained by [Nael Shiab](http://naelshiab.com/), computational
+journalist and senior data producer for [CBC News](https://www.cbc.ca/news).

package/npm/esm/_dnt.shims.d.ts

@@ -0,0 +1,8 @@
+import * as dntShim from "./_dnt_2.shims.js";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof dntShim.Deno;
+}, "Deno"> & {
+    Deno: typeof dntShim.Deno;
+};
+//# sourceMappingURL=_dnt.shims.d.ts.map

package/npm/esm/_dnt.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt.shims.d.ts","sourceRoot":"","sources":["../src/_dnt.shims.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;;;CAAsD,CAAC"}

package/npm/esm/_dnt.shims.js

@@ -0,0 +1,62 @@
+import * as dntShim from "./_dnt_2.shims.js";
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+const dntGlobals = {
+    Deno,
+};
+export const dntGlobalThis = createMergeProxy(dntShim.dntGlobalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/npm/esm/_dnt_2.shims.d.ts

@@ -0,0 +1,6 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+export declare const dntGlobalThis: Omit<typeof globalThis, "Deno"> & {
+    Deno: typeof Deno;
+};
+//# sourceMappingURL=_dnt_2.shims.d.ts.map

package/npm/esm/_dnt_2.shims.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_dnt_2.shims.d.ts","sourceRoot":"","sources":["../src/_dnt_2.shims.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}

package/npm/esm/_dnt_2.shims.js

@@ -0,0 +1,61 @@
+import { Deno } from "@deno/shim-deno";
+export { Deno } from "@deno/shim-deno";
+const dntGlobals = {
+    Deno,
+};
+export const dntGlobalThis = createMergeProxy(globalThis, dntGlobals);
+function createMergeProxy(baseObj, extObj) {
+    return new Proxy(baseObj, {
+        get(_target, prop, _receiver) {
+            if (prop in extObj) {
+                return extObj[prop];
+            }
+            else {
+                return baseObj[prop];
+            }
+        },
+        set(_target, prop, value) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            baseObj[prop] = value;
+            return true;
+        },
+        deleteProperty(_target, prop) {
+            let success = false;
+            if (prop in extObj) {
+                delete extObj[prop];
+                success = true;
+            }
+            if (prop in baseObj) {
+                delete baseObj[prop];
+                success = true;
+            }
+            return success;
+        },
+        ownKeys(_target) {
+            const baseKeys = Reflect.ownKeys(baseObj);
+            const extKeys = Reflect.ownKeys(extObj);
+            const extKeysSet = new Set(extKeys);
+            return [...baseKeys.filter((k) => !extKeysSet.has(k)), ...extKeys];
+        },
+        defineProperty(_target, prop, desc) {
+            if (prop in extObj) {
+                delete extObj[prop];
+            }
+            Reflect.defineProperty(baseObj, prop, desc);
+            return true;
+        },
+        getOwnPropertyDescriptor(_target, prop) {
+            if (prop in extObj) {
+                return Reflect.getOwnPropertyDescriptor(extObj, prop);
+            }
+            else {
+                return Reflect.getOwnPropertyDescriptor(baseObj, prop);
+            }
+        },
+        has(_target, prop) {
+            return prop in extObj || prop in baseObj;
+        },
+    });
+}

package/npm/esm/helpers/createFolderStructure.d.ts

@@ -0,0 +1,2 @@
+export declare function createFolderStructure(selectedPackages: string[]): Promise<string>;
+//# sourceMappingURL=createFolderStructure.d.ts.map

package/npm/esm/helpers/createFolderStructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFolderStructure.d.ts","sourceRoot":"","sources":["../../src/helpers/createFolderStructure.ts"],"names":[],"mappings":"AAKA,wBAAsB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,mBA+CrE"}

package/npm/esm/helpers/createFolderStructure.js

@@ -0,0 +1,49 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { log } from "@clack/prompts";
+import { handleFileConflict } from "./handleFileConflict.js";
+export async function createFolderStructure(selectedPackages) {
+    const sdaFolder = "sda";
+    const folders = ["data", "helpers", "output"];
+    if (!existsSync(sdaFolder)) {
+        mkdirSync(sdaFolder, { recursive: true });
+        log.info(`Created folder ${sdaFolder}/`);
+    }
+    else {
+        log.warn(`Folder ${sdaFolder}/ already exists. Skipping creation.`);
+    }
+    for (const folder of folders) {
+        const path = join(sdaFolder, folder);
+        if (!existsSync(path)) {
+            mkdirSync(path, { recursive: true });
+            log.info(`Created folder ${path}/`);
+        }
+        else {
+            log.warn(`Folder ${path}/ already exists. Skipping creation.`);
+        }
+    }
+    const mainTsPath = join(sdaFolder, "main.ts");
+    let mainTsContent = 'console.log("Hello simple-data-analysis!");\n';
+    if (selectedPackages.includes("@nshiab/simple-data-analysis")) {
+        mainTsContent = `import { SimpleDB } from "@nshiab/simple-data-analysis";
+
+const sdb = new SimpleDB();
+const table = await sdb.newTable();
+
+// Do your magic here!
+
+await sdb.done();
+`;
+    }
+    const status = await handleFileConflict(mainTsPath, mainTsContent);
+    if (status === "created") {
+        log.info(`Created ${mainTsPath}`);
+    }
+    else if (status === "updated") {
+        log.info(`Updated ${mainTsPath}`);
+    }
+    else {
+        log.warn(`${mainTsPath} skipping creation.`);
+    }
+    return sdaFolder;
+}

package/npm/esm/helpers/ensureAgents.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureAgents(docsMapping: Record<string, string>, runtime: string): Promise<void>;
+//# sourceMappingURL=ensureAgents.d.ts.map

package/npm/esm/helpers/ensureAgents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureAgents.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureAgents.ts"],"names":[],"mappings":"AAIA,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACnC,OAAO,EAAE,MAAM,iBA+FhB"}

package/npm/esm/helpers/ensureAgents.js

@@ -0,0 +1,92 @@
+import { log } from "@clack/prompts";
+import { handleFileConflict } from "./handleFileConflict.js";
+import { SUPPORTED_PACKAGES } from "./packageRegistry.js";
+export async function ensureAgents(docsMapping, runtime) {
+    let journalismFunctions = "";
+    let sdaClassesAndMethods = "";
+    for (const [pkg, doc] of Object.entries(docsMapping)) {
+        const pkgConfig = SUPPORTED_PACKAGES.find((p) => p.value === pkg);
+        const pkgType = pkgConfig?.type || "other";
+        if (pkgType === "journalism") {
+            const repoName = pkg.split("/")[1];
+            journalismFunctions += `\n### ${repoName}\n\n`;
+            journalismFunctions += doc
+                .split("\n")
+                .filter((line) => line.trim().startsWith("#"))
+                .filter((line) => {
+                const depth = line.match(/^#+/)?.[0].length || 0;
+                return depth >= 2; // Match ##, ###, #### etc.
+            })
+                .map((line) => line.replace(/^#+\s+/, "").trim())
+                .join("\n") + "\n";
+        }
+        else if (pkgType === "sda") {
+            sdaClassesAndMethods = doc
+                .split("\n")
+                .filter((line) => line.trim().startsWith("#"))
+                .filter((line) => {
+                const depth = line.match(/^#+/)?.[0].length || 0;
+                return depth === 2 || depth === 4;
+            })
+                .map((line) => {
+                const depth = line.match(/^#+/)?.[0].length || 0;
+                if (depth === 2) {
+                    return "\n" + line.replace(/^#+\s+/, "").trim();
+                }
+                else {
+                    return line.replace(/^#+\s+Parameters/, "  - ")
+                        .replace(/^#+\s+/, "  - ")
+                        .replaceAll("`", "");
+                }
+            })
+                .join("\n");
+        }
+    }
+    const configFile = runtime === "deno" ? "deno.json" : "package.json";
+    const runSda = runtime === "deno" ? "deno task sda" : "npm run sda";
+    const runClean = runtime === "deno" ? "deno task clean" : "npm run clean";
+    let content = `Always verify if there is a ${configFile} file in the root of the project and familiarize yourself with the scripts available in it and the libraries already installed in the project.
+
+Always use "sda" task when available (e.g. \`${runSda}\`).
+
+${runtime === "deno"
+        ? "If it's a Deno project, you can also run `deno run -A --node-modules-dir=auto --env-file --check sda/main.ts` to test your code. Before handing off your work, run `deno lint` and `deno fmt` as well. Fix any errors or warnings triggered along the way."
+        : "If it's a Node.js project, you can also run `node --env-file=.env --experimental-strip-types --no-warnings sda/main.ts` to test your code. Before handing off your work, always fix any errors or warnings triggered along the way."}
+
+Use the \`clean\` task (e.g. \`${runClean}\`) to remove the cache and other temporary files.
+
+Always use "sda/main.ts" as the entry point.
+
+If you need to create other TypeScript files, create them in the "sda/helpers" folder. Prioritize the use of helper functions to keep the code well organized and maintainable, with one helper function per file, with the file named after the function. Prioritize default exports for helper functions.
+
+If you need to download data, always put the files in the "sda/data" folder, which is gitignored. 
+
+If you need to output data to a file, always put the file in the "sda/output" folder.
+
+Always prioritize the use of the "journalism" and "simple-data-analysis" libraries when they are installed. These libraries can be used directly like this:
+\`\`\`typescript
+import { formatDate } from "@nshiab/journalism-format";
+import { SimpleDB } from "@nshiab/simple-data-analysis";
+\`\`\`
+`;
+    if (journalismFunctions !== "") {
+        content += `
+Here are the functions available in the "journalism" libraries. If one of the function might be relevant, read the complete documentation in the "./docs/" folder to properly use it.
+${journalismFunctions}`;
+    }
+    if (sdaClassesAndMethods !== "") {
+        content += `
+Here are the classes and their methods available in the "simple-data-analysis" library. If one of the classes or methods might be relevant, read the complete documentation at "./docs/simple-data-analysis.md" to properly use it. Remember that almost all methods are asynchronous, so you need to use \`await\` when calling them.
+${sdaClassesAndMethods}`;
+    }
+    const status = await handleFileConflict("AGENTS.md", content);
+    if (status === "created") {
+        log.info("Created AGENTS.md");
+    }
+    else if (status === "updated") {
+        log.info("Updated AGENTS.md");
+    }
+    else {
+        log.warn("AGENTS.md skipping creation.");
+    }
+}

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

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

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

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

package/npm/esm/helpers/ensureEnvFile.js

@@ -0,0 +1,14 @@
+import { log } from "@clack/prompts";
+import { handleFileConflict } from "./handleFileConflict.js";
+export async function ensureEnvFile() {
+    const status = await handleFileConflict(".env", "");
+    if (status === "created") {
+        log.info("Created .env");
+    }
+    else if (status === "updated") {
+        log.info("Updated .env");
+    }
+    else {
+        log.warn(".env skipping creation.");
+    }
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensureGitignore.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureGitignore.ts"],"names":[],"mappings":"AAIA,wBAAgB,eAAe,SAyB9B"}

package/npm/esm/helpers/ensureGitignore.js

@@ -0,0 +1,29 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { log } from "@clack/prompts";
+import { GITIGNORE_ENTRIES } from "./gitignoreEntries.js";
+export function ensureGitignore() {
+    const path = ".gitignore";
+    let content = "";
+    let exists = false;
+    if (existsSync(path)) {
+        content = readFileSync(path, "utf-8");
+        exists = true;
+    }
+    const lines = content.split("\n").map((l) => l.trim());
+    const toAdd = GITIGNORE_ENTRIES.filter((e) => !lines.includes(e));
+    if (toAdd.length > 0) {
+        const prefix = content.endsWith("\n") || content === "" ? "" : "\n";
+        const header = "\n# Added by setup-data-project\n";
+        const newContent = prefix + header + toAdd.join("\n") + "\n";
+        writeFileSync(path, content + newContent);
+        if (exists) {
+            log.info(`Updated ${path}`);
+        }
+        else {
+            log.info(`Created ${path}`);
+        }
+    }
+    else if (exists) {
+        log.warn(`${path} already up to date. Skipping.`);
+    }
+}

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

@@ -0,0 +1,2 @@
+export declare function ensureReadme(runtime: string): Promise<void>;
+//# sourceMappingURL=ensureReadme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensureReadme.d.ts","sourceRoot":"","sources":["../../src/helpers/ensureReadme.ts"],"names":[],"mappings":"AAGA,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,iBAoCjD"}