elrh-cosca 0.1.5 → 0.2.1

package/dist/types/_private/deep-merge-object.d.ts

@@ -0,0 +1 @@
+export declare function deepMergeObject(magicast: any, object: any): void;

package/dist/types/functions/update-config-file.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Update the single object-literal config found in a file.
+ *
+ * The function:
+ * - Reads and edits the file as code (no execution).
+ * - Uses `defu(newConfig, existingConfig)` so `newConfig` takes precedence.
+ * - Applies the merged result back onto the AST to preserve TS/ESM structure.
+ *
+ * @param {string} pathToFile - Path to file, relative to project root (process.cwd()).
+ * @param {object} newConfig - Config to merge in (takes precedence).
+ * @returns {Promise<void>}
+ */
+export declare function updateConfigFile(pathToFile: string, newConfig: Record<string | number | symbol, any>, force?: boolean): Promise<void>;

package/dist/types/functions/update-json-file.d.ts

@@ -0,0 +1 @@
+export declare function updateJsonFile(pathToFile: string, jsonKey: string, newValues: Record<string | number | symbol, any>, force?: boolean): Promise<void>;

package/dist/types/main.d.ts

@@ -1,5 +1,8 @@
-import { createFileFromTemplate } from './lib/create-file-from-template';
-import { promptUser } from './lib/prompt-user';
-import { updateJsonFile } from './lib/update-json-file';
-import { updateTextFile } from './lib/update-text-file';
-export { createFileFromTemplate, promptUser, updateJsonFile, updateTextFile, };
+import { createFileFromTemplate } from './functions/create-file-from-template';
+import { updateConfigFile } from './functions/update-config-file';
+import { updateJsonFile } from './functions/update-json-file';
+import { updateTextFile } from './functions/update-text-file';
+import { promptUser } from './terminal/prompt-user';
+import { parseQualifiedPath } from './utils/parse-qualified-path';
+import { resolvePackagePath } from './utils/resolve-package-path';
+export { createFileFromTemplate, updateConfigFile, updateJsonFile, updateTextFile, promptUser, parseQualifiedPath, resolvePackagePath, };

package/dist/types/utils/parse-qualified-path.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Expects path to file in `"package:relative/path/to/file"` format and splits it into `{ pkg, file }`.
+ * The package name can be scoped (e.g. `@scope/package`). Throws error on invalid input.
+ */
+export declare function parseQualifiedPath(path: string): {
+    pkg: string;
+    file: string;
+};

package/dist/types/utils/resolve-package-path.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolve a package's installed root directory *from the target app*.
+ * Package name can be scoped (e.g. `@scope/package`).
+ * Works with npm/yarn/pnpm, hoisting or not.
+ */
+export declare function resolvePackagePath(packageName: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elrh-cosca",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "type": "module",
   "files": [
     "dist"
@@ -12,15 +12,14 @@
     ".": {
       "types": "./dist/types/index.d.ts",
       "import": "./dist/elrh-cosca.mjs",
-      "require": "./dist/elrh-cosca.cjs",
       "default": "./dist/elrh-cosca.mjs"
     }
   },
-  "main": "./dist/elrh-cosca.cjs",
   "module": "./dist/elrh-cosca.mjs",
   "types": "./dist/types/index.d.ts",
   "devDependencies": {
     "@types/node": "^24.3.0",
+    "magicast": "^0.3.5",
     "typescript": "^5.9.2",
     "vite": "^7.1.3",
     "vite-plugin-dts": "^4.5.4",

package/test/cosca-test.js

@@ -2,7 +2,9 @@
 
 // manual test script for COSCA functions
 
-import { createFileFromTemplate, promptUser, updateJsonFile, updateTextFile } from '../dist/elrh-cosca.mjs'
+import { 
+  createFileFromTemplate, promptUser, updateConfigFile, updateJsonFile, updateTextFile 
+} from '../dist/elrh-cosca.mjs'
 
 async function main() {
   console.log('Test promptUser')
@@ -10,14 +12,17 @@ async function main() {
   console.log('User input:', input)
 
   console.log('\nTest createFileFromTemplate')
-  await createFileFromTemplate('vite:README.md', 'test.file1')
-  await createFileFromTemplate('elrh-cosca:README.md', 'test.file2')
+  await createFileFromTemplate('vitest:README.md', 'test/snapshots/test.file1')
+  await createFileFromTemplate('elrh-cosca:test/fixtures/text-file.txt', 'test/snapshots/test.file2')
+
+  console.log('\nTest updateConfigFile')
+  await updateConfigFile('test/fixtures/config-file-default.ts', { compatibilityDate: '2025-08-26', extends: ['nuxt-iignis'], cosca: { exists: true, data: ['some', 'other'], raw: 'war' } })
 
   console.log('\nTest updateJsonFile')
-  await updateJsonFile('package.json', 'scripts', { 'cosca' : 'cosca' })
+  await updateJsonFile('test/fixtures/json-file.json', 'scripts', { 'cosca' : 'cosca' })
 
   console.log('\nTest updateTextFile')
-  await updateTextFile('.gitignore', ['# COSCA'])
+  await updateTextFile('test/fixtures/text-file.txt', ['# COSCA'])
 }
 
 main().catch((err) => {

package/dist/elrh-cosca.cjs

@@ -1,4 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("node:path"),r=require("node:fs"),w=require("node:readline"),g=e=>e&&e.__esModule?e:{default:e},y=g(w);async function u(e){const t=y.default.createInterface({input:process.stdin,output:process.stdout});return new Promise(o=>{t.question(e+" (y/N): ",s=>{t.close(),o(/^y(es)?$/i.test(s.trim()))})})}function h(e){const t=e.indexOf(":");if(t<=0||t===e.length-1)throw new Error(`Invalid input "${e}". Expected format is "package:relative/path/to/file".`);const o=e.slice(0,t).trim(),s=e.slice(t+1).replace(/^[/\\]+/,"");if(!o||o.endsWith("/")||o.includes(" "))throw new Error(`Invalid package name in templatePath: "${o}"`);return{pkg:o,file:s}}function $(e){const t=process.cwd();try{const o=a.join(t,"package.json"),s=r.readFileSync(o,"utf8");if(JSON.parse(s)?.name===e)return t}catch(o){console.error(o)}try{const o=a.join(t,"node_modules",...e.split("/")),s=a.join(o,"package.json");return console.log(s),r.access(s,r.constants.R_OK,i=>{if(i)throw new Error(`Cannot access "${s}"`)}),o}catch(o){console.error(o)}throw new Error(`Cannot find package "${e}" from ${process.cwd()}. Make sure it's installed or linked in this project.`)}async function m(e,t,o=!1){if(o||await u(`This will create '${t}' file. Continue?`)){const{pkg:i,file:d}=h(e),l=$(i),n=a.resolve(l,d),c=a.resolve(process.cwd(),t);r.existsSync(n)||(console.error(`Template file not found at ${n}`),process.exit(1)),r.existsSync(c)&&(o||await u(`File '${t}' already exists. Overwrite?`)||(console.log("Aborted."),process.exit(0))),r.copyFileSync(n,c),console.log(`New file '${t}' successfully created.`)}else console.log(`Creation of '${t}' skipped.`)}async function k(e,t,o,s=!1){if(s||await u(`This will update '${e}' file. Continue?`)){const d=a.resolve(process.cwd(),e);if(!r.existsSync(d)){console.warn(`No '${e}' found in project root — skipping updates.`);return}const l=r.readFileSync(d,"utf8");let n;try{n=JSON.parse(l)}catch{console.error(`Could not parse '${e}' — skipping updates.`);return}n[t]=n[t]||{};let c=!1;for(const[p,f]of Object.entries(o))n[t][p]!==f&&(n[t][p]=f,c=!0);c?(r.writeFileSync(d,JSON.stringify(n,null,2)+`
-`,"utf8"),console.log(`'${e}' file updated.`)):console.log(`'${e}' file already up to date.`)}else console.log(`Updating '${e}' skipped.`)}async function x(e,t,o=!1){if(o||await u(`This will update '${e}' file. Continue?`)){const i=a.resolve(process.cwd(),e);if(!r.existsSync(i)){console.warn(`No '${e}' found in project root — skipping updates.`);return}const l=r.readFileSync(i,"utf8").split(/\r?\n/);let n=!1;for(const c of t)l.includes(c)||(l.push(c),n=!0);n?(r.writeFileSync(i,l.join(`
-`)+`
-`,"utf8"),console.log(`'${e}' file updated.`)):console.log(`'${e}' file already up to date.`)}else console.log(`Updating '${e}' skipped.`)}exports.createFileFromTemplate=m;exports.promptUser=u;exports.updateJsonFile=k;exports.updateTextFile=x;

package/dist/types/lib/update-json-file.d.ts

@@ -1 +0,0 @@
-export declare function updateJsonFile(pathToFile: string, jsonKey: string, newValues: Record<string, string>, force?: boolean): Promise<void>;

package/dist/types/utils/resolve-package.d.ts

@@ -1,14 +0,0 @@
-/**
- * Expects path to file template in `"package:relative/path/to/file"` format and splits it into `{ pkg, file }`.
- * Throws error on invalid input.
- */
-export declare function parseTemplatePath(input: string): {
-    pkg: string;
-    file: string;
-};
-/**
- * Resolve a package's installed root directory *from the target app*.
- * Package name can be scoped.
- * Works with npm/yarn/pnpm, hoisting or not.
- */
-export declare function resolvePackagePath(packageName: string): string;

package/dist/types/utils/resolve-path.d.ts

@@ -1,12 +0,0 @@
-/**
- * Normalized __filename that works in both ESM (.mjs) and CJS (.cjs).
- * In CJS, __filename is available as a global variable.
- * In MJS, import.meta.url is available instead.
- */
-export declare const module_file: string;
-/**
- * Normalized __dirname that works in both ESM (.mjs) and CJS (.cjs).
- * In CJS, __filename is available as a global variable.
- * In MJS, import.meta.url is available instead.
- */
-export declare const module_dir: string;