@nshiab/setup-data-project 1.0.7

package/script/_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,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC,eAAO,MAAM,aAAa;;CAA2C,CAAC"}

package/script/_dnt.shims.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dntGlobalThis = exports.Deno = void 0;
+const shim_deno_1 = require("@deno/shim-deno");
+var shim_deno_2 = require("@deno/shim-deno");
+Object.defineProperty(exports, "Deno", { enumerable: true, get: function () { return shim_deno_2.Deno; } });
+const dntGlobals = {
+    Deno: shim_deno_1.Deno,
+};
+exports.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/script/helpers/createFolderStructure.d.ts

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

package/script/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/script/helpers/createFolderStructure.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createFolderStructure = createFolderStructure;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const prompts_1 = require("@clack/prompts");
+const handleFileConflict_js_1 = require("./handleFileConflict.js");
+async function createFolderStructure(selectedPackages) {
+    const sdaFolder = "sda";
+    const folders = ["data", "helpers", "output"];
+    if (!(0, node_fs_1.existsSync)(sdaFolder)) {
+        (0, node_fs_1.mkdirSync)(sdaFolder, { recursive: true });
+        prompts_1.log.info(`Created folder ${sdaFolder}/`);
+    }
+    else {
+        prompts_1.log.warn(`Folder ${sdaFolder}/ already exists. Skipping creation.`);
+    }
+    for (const folder of folders) {
+        const path = (0, node_path_1.join)(sdaFolder, folder);
+        if (!(0, node_fs_1.existsSync)(path)) {
+            (0, node_fs_1.mkdirSync)(path, { recursive: true });
+            prompts_1.log.info(`Created folder ${path}/`);
+        }
+        else {
+            prompts_1.log.warn(`Folder ${path}/ already exists. Skipping creation.`);
+        }
+    }
+    const mainTsPath = (0, node_path_1.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 (0, handleFileConflict_js_1.handleFileConflict)(mainTsPath, mainTsContent);
+    if (status === "created") {
+        prompts_1.log.info(`Created ${mainTsPath}`);
+    }
+    else if (status === "updated") {
+        prompts_1.log.info(`Updated ${mainTsPath}`);
+    }
+    else {
+        prompts_1.log.warn(`${mainTsPath} skipping creation.`);
+    }
+    return sdaFolder;
+}

package/script/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/script/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/script/helpers/ensureAgents.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureAgents = ensureAgents;
+const prompts_1 = require("@clack/prompts");
+const handleFileConflict_js_1 = require("./handleFileConflict.js");
+const packageRegistry_js_1 = require("./packageRegistry.js");
+async function ensureAgents(docsMapping, runtime) {
+    let journalismFunctions = "";
+    let sdaClassesAndMethods = "";
+    for (const [pkg, doc] of Object.entries(docsMapping)) {
+        const pkgConfig = packageRegistry_js_1.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 (0, handleFileConflict_js_1.handleFileConflict)("AGENTS.md", content);
+    if (status === "created") {
+        prompts_1.log.info("Created AGENTS.md");
+    }
+    else if (status === "updated") {
+        prompts_1.log.info("Updated AGENTS.md");
+    }
+    else {
+        prompts_1.log.warn("AGENTS.md skipping creation.");
+    }
+}

package/script/helpers/ensureEnvFile.d.ts

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

package/script/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/script/helpers/ensureEnvFile.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureEnvFile = ensureEnvFile;
+const prompts_1 = require("@clack/prompts");
+const handleFileConflict_js_1 = require("./handleFileConflict.js");
+async function ensureEnvFile() {
+    const status = await (0, handleFileConflict_js_1.handleFileConflict)(".env", "");
+    if (status === "created") {
+        prompts_1.log.info("Created .env");
+    }
+    else if (status === "updated") {
+        prompts_1.log.info("Updated .env");
+    }
+    else {
+        prompts_1.log.warn(".env skipping creation.");
+    }
+}

package/script/helpers/ensureGitignore.d.ts

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

package/script/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/script/helpers/ensureGitignore.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureGitignore = ensureGitignore;
+const node_fs_1 = require("node:fs");
+const prompts_1 = require("@clack/prompts");
+const gitignoreEntries_js_1 = require("./gitignoreEntries.js");
+function ensureGitignore() {
+    const path = ".gitignore";
+    let content = "";
+    let exists = false;
+    if ((0, node_fs_1.existsSync)(path)) {
+        content = (0, node_fs_1.readFileSync)(path, "utf-8");
+        exists = true;
+    }
+    const lines = content.split("\n").map((l) => l.trim());
+    const toAdd = gitignoreEntries_js_1.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";
+        (0, node_fs_1.writeFileSync)(path, content + newContent);
+        if (exists) {
+            prompts_1.log.info(`Updated ${path}`);
+        }
+        else {
+            prompts_1.log.info(`Created ${path}`);
+        }
+    }
+    else if (exists) {
+        prompts_1.log.warn(`${path} already up to date. Skipping.`);
+    }
+}

package/script/helpers/ensureReadme.d.ts

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

package/script/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"}

package/script/helpers/ensureReadme.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureReadme = ensureReadme;
+const prompts_1 = require("@clack/prompts");
+const handleFileConflict_js_1 = require("./handleFileConflict.js");
+async function ensureReadme(runtime) {
+    const readmeContent = `This repository has been created with
+[setup-data-project](https://github.com/nshiab/setup-data-project/).
+
+It's installing
+[simple-data-analysis](https://github.com/nshiab/simple-data-analysis) and
+[journalism](https://github.com/nshiab/journalism) libraries, with up-to-date
+documentation and AI agent instructions.
+
+Here's the recommended workflow:
+
+- Put your raw data in the \`sda/data\` folder. Note that this folder is
+  gitignored.
+- Use the \`sda/main.ts\` file to clean and process your raw data. Write the
+  results to the \`sda/output\` folder.
+
+When working on your project, use the following command:
+
+- \`${runtime === "deno" ? "deno task" : "npm run"} sda\` will watch your \`sda/main.ts\` and its dependencies. Everytime
+  you'll save some changes, the data will be reprocessed.
+- \`${runtime === "deno" ? "deno task" : "npm run"} clean\` will remove \`.sda-cache/\`, \`.journalism-cache/\` and \`.tmp/\`,
+  if present.
+
+Have fun!`;
+    const status = await (0, handleFileConflict_js_1.handleFileConflict)("README.md", readmeContent);
+    if (status === "created") {
+        prompts_1.log.info("Created README.md");
+    }
+    else if (status === "updated") {
+        prompts_1.log.info("Updated README.md");
+    }
+    else {
+        prompts_1.log.warn("README.md skipping creation.");
+    }
+}

package/script/helpers/getInstalledPackages.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"getInstalledPackages.d.ts","sourceRoot":"","sources":["../../src/helpers/getInstalledPackages.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CA4B/C"}

package/script/helpers/getInstalledPackages.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInstalledPackages = getInstalledPackages;
+const node_fs_1 = require("node:fs");
+function getInstalledPackages() {
+    let configFile = "";
+    let depKeys = [];
+    if ((0, node_fs_1.existsSync)("deno.json")) {
+        configFile = "deno.json";
+        depKeys = ["imports"];
+    }
+    else if ((0, node_fs_1.existsSync)("package.json")) {
+        configFile = "package.json";
+        depKeys = ["dependencies", "devDependencies"];
+    }
+    if (configFile === "")
+        return [];
+    try {
+        const content = (0, node_fs_1.readFileSync)(configFile, "utf-8");
+        const config = JSON.parse(content);
+        const installed = [];
+        for (const key of depKeys) {
+            if (config[key]) {
+                installed.push(...Object.keys(config[key]));
+            }
+        }
+        return installed;
+    }
+    catch (_e) {
+        return [];
+    }
+}

package/script/helpers/getProjectTasks.d.ts

@@ -0,0 +1,5 @@
+export declare function getProjectTasks(): {
+    sda: string;
+    clean: string;
+};
+//# sourceMappingURL=getProjectTasks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getProjectTasks.d.ts","sourceRoot":"","sources":["../../src/helpers/getProjectTasks.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe;;;EAW9B"}

package/script/helpers/getProjectTasks.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProjectTasks = getProjectTasks;
+const getRuntime_js_1 = require("./getRuntime.js");
+function getProjectTasks() {
+    const runtime = (0, getRuntime_js_1.getRuntime)();
+    return {
+        sda: runtime === "deno"
+            ? "deno run -A --env --watch sda/main.ts"
+            : runtime === "bun"
+                ? "bun run --watch sda/main.ts"
+                : "node --env-file=.env --watch sda/main.ts",
+        clean: "rm -rf .sda-cache .journalism-cache .tmp",
+    };
+}

package/script/helpers/getRuntime.d.ts

@@ -0,0 +1,5 @@
+export declare const runtimeConfig: {
+    getRuntime: () => "deno" | "bun" | "node";
+};
+export declare function getRuntime(): "deno" | "bun" | "node";
+//# sourceMappingURL=getRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getRuntime.d.ts","sourceRoot":"","sources":["../../src/helpers/getRuntime.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,aAAa;;CASzB,CAAC;AAEF,wBAAgB,UAAU,4BAEzB"}

package/script/helpers/getRuntime.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeConfig = void 0;
+exports.getRuntime = getRuntime;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const node_process_1 = __importDefault(require("node:process"));
+exports.runtimeConfig = {
+    getRuntime: () => {
+        if ("Deno" in dntShim.dntGlobalThis)
+            return "deno";
+        if ("Bun" in dntShim.dntGlobalThis)
+            return "bun";
+        if (typeof node_process_1.default !== "undefined" && node_process_1.default?.versions?.node) {
+            return "node";
+        }
+        return "node";
+    },
+};
+function getRuntime() {
+    return exports.runtimeConfig.getRuntime();
+}

package/script/helpers/gitignoreEntries.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"gitignoreEntries.d.ts","sourceRoot":"","sources":["../../src/helpers/gitignoreEntries.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,UAQ7B,CAAC"}

package/script/helpers/gitignoreEntries.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITIGNORE_ENTRIES = void 0;
+exports.GITIGNORE_ENTRIES = [
+    "node_modules",
+    ".tmp",
+    ".sda-cache",
+    ".journalism-cache",
+    "sda/data",
+    ".env",
+    ".DS_Store",
+];

package/script/helpers/handleFileConflict.d.ts

@@ -0,0 +1,5 @@
+export declare const PROMPT_OVERRIDE: {
+    select: (config: unknown) => Promise<string | symbol>;
+};
+export declare function handleFileConflict(path: string, newContent: string): Promise<"created" | "updated" | "skipped">;
+//# sourceMappingURL=handleFileConflict.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handleFileConflict.d.ts","sourceRoot":"","sources":["../../src/helpers/handleFileConflict.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,eAAe,EAAE;IAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAGvD,CAAC;AAEF,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC,CAoD5C"}

package/script/helpers/handleFileConflict.js

@@ -0,0 +1,91 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROMPT_OVERRIDE = void 0;
+exports.handleFileConflict = handleFileConflict;
+const dntShim = __importStar(require("../_dnt.shims.js"));
+const node_fs_1 = require("node:fs");
+const prompts_1 = require("@clack/prompts");
+const node_process_1 = __importDefault(require("node:process"));
+exports.PROMPT_OVERRIDE = {
+    select: prompts_1.select,
+};
+async function handleFileConflict(path, newContent) {
+    if (!(0, node_fs_1.existsSync)(path)) {
+        (0, node_fs_1.writeFileSync)(path, newContent);
+        return "created";
+    }
+    // Skip prompt in Deno tests if no override
+    // @ts-ignore: Deno is not defined in type but present in runtime
+    if (dntShim.dntGlobalThis.Deno?.args.includes("--internal-test-mode") &&
+        exports.PROMPT_OVERRIDE.select === prompts_1.select) {
+        return "skipped";
+    }
+    const action = (await exports.PROMPT_OVERRIDE.select({
+        message: `${path} already exists. What would you like to do?`,
+        options: [
+            { value: "skip", label: "Skip", hint: "Keep existing file" },
+            {
+                value: "overwrite",
+                label: "Overwrite",
+                hint: "Replace with new content",
+            },
+            { value: "append", label: "Append", hint: "Add to the end of the file" },
+        ],
+    }));
+    if ((0, prompts_1.isCancel)(action)) {
+        console.log("Operation cancelled.");
+        node_process_1.default.exit(0);
+    }
+    if (action === "skip") {
+        return "skipped";
+    }
+    if (action === "overwrite") {
+        (0, node_fs_1.writeFileSync)(path, newContent);
+        return "updated";
+    }
+    if (action === "append") {
+        const existingContent = (0, node_fs_1.readFileSync)(path, "utf-8");
+        const prefix = existingContent.endsWith("\n") || existingContent === ""
+            ? ""
+            : "\n";
+        (0, node_fs_1.writeFileSync)(path, existingContent + prefix + newContent);
+        return "updated";
+    }
+    return "skipped";
+}

package/script/helpers/installPackagesAndFetchDocs.d.ts

@@ -0,0 +1,8 @@
+import * as childProcess from "node:child_process";
+export declare const commandRunner: {
+    execSync: typeof childProcess.execSync;
+};
+export declare function installPackagesAndFetchDocs(selectedPackages: string[], options?: {
+    silent?: boolean;
+}): Promise<string | void>;
+//# sourceMappingURL=installPackagesAndFetchDocs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installPackagesAndFetchDocs.d.ts","sourceRoot":"","sources":["../../src/helpers/installPackagesAndFetchDocs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,YAAY,MAAM,oBAAoB,CAAC;AAKnD,eAAO,MAAM,aAAa;;CAEzB,CAAC;AAEF,wBAAsB,2BAA2B,CAC/C,gBAAgB,EAAE,MAAM,EAAE,EAC1B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2DxB"}