create-feli 0.1.10

package/README.md

@@ -0,0 +1,48 @@
+create-vag
+==========
+
+
+Presentation
+------------
+
+*create-vag* is the *initializer* used by *npm* for creating a new [vag](https://github.com/charlyoleg2/vag) repository. It contains the *command line interface* application called by `npm create vag@latest`.
+
+
+Links
+-----
+
+- [sources](https://github.com/charlyoleg2/create-vag)
+- [pkg](https://www.npmjs.com/package/create-vag)
+
+
+Requirements
+------------
+
+- [node](https://nodejs.org) > 20.10.0
+- [npm](https://docs.npmjs.com/cli) > 10.5.0
+
+
+Usage
+-----
+
+*create-vag* is not intended to be installed directly but rather used via one of the following commands:
+
+```bash
+npm create vag@latest
+npm create vag@latest projAbc
+npm init vag@latest projAbc
+npm exec create-vag@latest projAbc
+npx create-vag@latest projAbc
+```
+
+Dev
+---
+
+```bash
+git clone https://github.com/charlyoleg2/create-vag
+cd create-vag
+npm install
+npm run ci
+npm run run
+```
+

package/dist/create-feli-cli.js

@@ -0,0 +1,281 @@
+#!/usr/bin/env node
+
+// src/create-feli-cli.ts
+import * as prom from "@clack/prompts";
+import chalk from "chalk";
+
+// package.json
+var package_default = {
+  name: "create-feli",
+  version: "0.1.10",
+  description: "The npm-initializer for creating a new feli package",
+  private: false,
+  repository: {
+    type: "git",
+    url: "git+https://github.com/charlyoleg2/feli_mono.git"
+  },
+  homepage: "https://www.npmjs.com/package/create-feli",
+  author: "charlyoleg",
+  license: "ISC",
+  keywords: [
+    "front-end only",
+    "locally installed",
+    "web-UI deployment",
+    "feli"
+  ],
+  type: "module",
+  exports: {
+    ".": {
+      types: "./dist/create-feli-api.d.ts",
+      default: "./dist/create-feli-api.js"
+    }
+  },
+  bin: {
+    "create-feli": "dist/create-feli-cli.js"
+  },
+  files: [
+    "dist/create-feli-cli.js",
+    "dist/template/",
+    "!dist/**/*.map",
+    "!dist/**/*.spec.*"
+  ],
+  tsup: {
+    entry: [
+      "src/create-feli-api.ts",
+      "src/create-feli-ref.ts",
+      "src/create-feli-cli.ts"
+    ],
+    format: "esm",
+    splitting: false,
+    dts: false,
+    sourcemap: false,
+    clean: true
+  },
+  prettier: {
+    useTabs: true,
+    singleQuote: true,
+    trailingComma: "none",
+    printWidth: 100,
+    plugins: [],
+    overrides: []
+  },
+  scripts: {
+    dev: "tsup --watch",
+    build: "tsup",
+    check: "tsc --noEmit",
+    pretty: "prettier --check .",
+    format: "prettier --write .",
+    lint: "eslint .",
+    "test:unit": "vitest",
+    "test:unit:once": "vitest --run",
+    copy_template: "shx cp -r template dist/",
+    cleanCopy_template: "run-s clean:template copy_template",
+    ci: "run-s check build pretty lint test:unit:once cleanCopy_template",
+    run: "dist/create-feli-cli.js",
+    "run:ref": "dist/create-feli-ref.js tmp2",
+    "run:diff": "diff -rq tmp tmp2",
+    "run:check": "run-s run:ref run:diff",
+    cycle: "run-s clean ci run",
+    "clean:template": "shx rm -fr dist/template",
+    "clean:build": "shx rm -fr dist node_modules",
+    "clean:output": "shx rm -fr tmp tmp2",
+    clean: "run-s clean:build clean:output"
+  },
+  dependencies: {
+    "@clack/prompts": "^0.11.0",
+    chalk: "^5.3.0",
+    handlebars: "^4.7.8"
+  },
+  devDependencies: {
+    "@eslint/js": "^9.28.0",
+    "@types/eslint__js": "^8.42.3",
+    "@types/node": "^24.0.7",
+    eslint: "^9.28.0",
+    "eslint-config-prettier": "^10.1.5",
+    "npm-run-all": "^4.1.5",
+    prettier: "^3.5.3",
+    shx: "^0.4.0",
+    tsup: "^8.5.0",
+    typescript: "^5.8.3",
+    "typescript-eslint": "^8.33.1",
+    vitest: "^3.2.2"
+  }
+};
+
+// src/create-feli-cli.ts
+import { setTimeout as sleep2 } from "timers/promises";
+
+// src/create-feli-api.ts
+import { setTimeout as sleep } from "timers/promises";
+import { readFile, writeFile, access, mkdir } from "fs/promises";
+import { dirname, extname } from "path";
+import Handlebars from "handlebars";
+
+// src/create-feli-common.ts
+function firstLetterCapital(str) {
+  const rStr = str.charAt(0).toUpperCase() + str.slice(1);
+  return rStr;
+}
+function underline(str) {
+  const strLen = str.length;
+  const rStr = "=".repeat(strLen);
+  return rStr;
+}
+function prefixOutputPath() {
+  let rPreDir = ".";
+  const scriptDir = new URL("", import.meta.url).toString();
+  const regex = new RegExp("/node_modules/");
+  if (!regex.test(scriptDir)) {
+    rPreDir = "./tmp";
+  }
+  return rPreDir;
+}
+
+// src/create-feli-list.ts
+var template_file_list = [
+  ".editorconfig",
+  ".gitignore",
+  "package.json",
+  "README.md",
+  "{{projName}}_repos.yml"
+];
+
+// src/create-feli-api.ts
+async function createMissingDir(outPath) {
+  const outDir = dirname(outPath);
+  try {
+    await access(outDir);
+  } catch (err) {
+    if (err) {
+      await mkdir(outDir, { recursive: true });
+    }
+  }
+}
+function isFileBinary(fpath) {
+  const binaryExts = /* @__PURE__ */ new Set([".png"]);
+  const infileExt = extname(fpath.toString());
+  const rBool = binaryExts.has(infileExt);
+  return rBool;
+}
+async function oneFile(onePath, cfg2, preDir2) {
+  try {
+    const onePathIn = Handlebars.compile(onePath)({
+      projName: "projAbc",
+      repoName: "projAbc-uis"
+    });
+    const onePathOut = Handlebars.compile(onePath)(cfg2);
+    const fileIn1 = new URL(`./template/${onePathIn}.handlebars`, import.meta.url);
+    const fileIn2 = new URL(`./template/${onePathIn}`, import.meta.url);
+    let fileBin = false;
+    let fileStr2 = "";
+    const outPath = `${preDir2}/${cfg2.repoName}/${onePathOut}`;
+    try {
+      await access(fileIn1);
+      try {
+        const fileStr1 = await readFile(fileIn1, { encoding: "utf8" });
+        const templateStr = Handlebars.compile(fileStr1);
+        fileStr2 = templateStr(cfg2);
+      } catch (err) {
+        console.log(`err392: error while processing ${fileIn1.toString()}`);
+        console.log(err);
+      }
+    } catch (err) {
+      if (err) {
+        if (isFileBinary(fileIn2)) {
+          fileBin = true;
+          const fileBuffer2 = await readFile(fileIn2);
+          await createMissingDir(outPath);
+          await writeFile(outPath, fileBuffer2);
+        } else {
+          fileStr2 = await readFile(fileIn2, { encoding: "utf8" });
+        }
+      }
+    }
+    if (!fileBin) {
+      await createMissingDir(outPath);
+      await writeFile(outPath, fileStr2);
+    }
+  } catch (err) {
+    console.log(`err213: error while generating file ${onePath}`);
+    console.error(err);
+    throw `err214: error with path ${onePath}`;
+  }
+}
+async function generate_boirlerplate(cfg12, preDir2) {
+  console.log(`Boilerplate with:
+  project name     : ${cfg12.projName}
+  repository name  : ${cfg12.repoName}`);
+  const cfg2 = {
+    projName: cfg12.projName,
+    ProjName: firstLetterCapital(cfg12.projName),
+    ProjNameUnderline: underline(cfg12.projName),
+    repoName: cfg12.repoName,
+    RepoName: firstLetterCapital(cfg12.repoName),
+    RepoNameUnderline: underline(cfg12.repoName)
+  };
+  for (const fpath of template_file_list) {
+    await oneFile(fpath, cfg2, preDir2);
+  }
+  console.log(`generate ${template_file_list.length} files in ${preDir2}/${cfg12.repoName}/`);
+  await sleep(100);
+  const rResp = {
+    vim: `vim ${cfg12.projName}_repos.yml`
+  };
+  return rResp;
+}
+
+// src/create-feli-cli.ts
+var firstMsg = `Create a new ${chalk.italic("feli-top-repo")} with ${chalk.italic(package_default.name)} version ${chalk.italic(package_default.version)}`;
+console.log(firstMsg);
+var projName = process.argv[2] || "blabla";
+var argN = process.argv.length - 2;
+if (argN > 1) {
+  console.log(`warn376: ${argN} arguments provided but only one supported!`);
+}
+prom.intro(chalk.inverse(" Your new feli-top-repo "));
+var pCfg = await prom.group(
+  {
+    projName: () => prom.text({
+      message: "Name of the project?",
+      initialValue: `${projName}`
+      //placeholder: `${projName}`
+    }),
+    repoName: () => prom.text({
+      message: "Name of the top-repository?",
+      initialValue: `${projName}_uis`
+      //placeholder: `${projName}_uis`
+    })
+  },
+  {
+    onCancel: () => {
+      prom.cancel("Operation aborted!");
+      process.exit(0);
+    }
+  }
+);
+prom.outro("Your new feli-top-repository will be boilerplated!");
+var cfg1 = {
+  projName: pCfg.projName,
+  repoName: pCfg.repoName
+};
+var preDir = prefixOutputPath();
+var resp = await generate_boirlerplate(cfg1, preDir);
+await sleep2(100);
+function styl(str) {
+  const rStr = chalk.bold.cyan(str);
+  return rStr;
+}
+var lastMsg = `
+Next steps:
+  1: ${styl(`cd ${pCfg.repoName}`)}
+  2: ${styl(`npm install`)}
+  3: ${styl('git init && git add -A && git commit -m "Initial commit"')} (optional)
+  4: ${styl(`${resp.vim}`)} (optional)
+  5: ${styl(`npm run`)}
+  6: ${styl(`npm run vag-list`)}
+  7: ${styl(`npm run vag-clone`)}
+  8: ${styl(`npm run vag-pull`)}
+  9: ${styl(`npm run vag-status`)}
+ 10: ${styl(`npm run vag-diff`)}
+`;
+console.log(lastMsg);

package/dist/template/.editorconfig

@@ -0,0 +1,23 @@
+# .editorconfig of vag-root
+# EditorConfig is awesome: https://EditorConfig.org
+# don't forget the vim-plugin for it
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+indent_style = tab
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+# Tab indentation (no size specified)
+[Makefile]
+indent_style = tab
+
+# yaml indentation with spaces
+[*.{yml,yaml}]
+indent_style = space

package/dist/template/.gitignore.handlebars

@@ -0,0 +1,6 @@
+# .gitignore of vag-root
+node_modules
+build
+dist
+tmp
+/repos/

package/dist/template/README.md.handlebars

@@ -0,0 +1,30 @@
+{{ProjName}}\_vag
+{{{ProjNameUnderline}}}=====
+
+
+Presentation
+------------
+
+*{{projName}}\_vag* is the top-repo of the *{{ProjName}}* ecosystem. It just points to other repositories.
+
+Using [vag\_tools](https://www.npmjs.com/package/vag_tools), it clones the following repositories:
+
+- {{projName}}
+- create-{{projName}}
+- {{projName}}\_vag
+
+
+Getting started
+---------------
+
+```bash
+git clone https://github.com/MYNAME/{{projName}}_vag
+cd {{projName}}_vag
+npm i
+npm run
+npm run vag-clone
+npm run vag-pull
+ls -la repos
+npx vag --help
+```
+

package/dist/template/package.json.handlebars

@@ -0,0 +1,35 @@
+{
+	"name": "{{projName}}_vag",
+	"version": "0.0.1",
+	"description": "top-repo that points to the other {{projName}} repositories",
+	"private": true,
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/MYNAME/{{projName}}_vag.git"
+	},
+	"homepage": "https://github.com/MYNAME/{{projName}}_vag#readme",
+	"author": "MYNAME",
+	"license": "ISC",
+	"keywords": [
+		"{{projName}}",
+		"vag"
+	],
+	"type": "module",
+	"main": "index.js",
+	"scripts": {
+		"vag-list": "vag --importYaml={{projName}}_repos.yml list",
+		"vag-clone": "vag --importYaml={{projName}}_repos.yml clone",
+		"vag-status": "vag --importYaml={{projName}}_repos.yml --only_configured status",
+		"vag-diff": "vag --importYaml={{projName}}_repos.yml --only_configured diff",
+		"vag-branch": "vag branch",
+		"vag-remote": "vag remote",
+		"vag-pull": "vag pull",
+		"vag-push": "vag push",
+		"vag-verify": "vag verify --importYaml={{projName}}_repos.yml",
+		"vag-versions": "vag versions",
+		"test": "echo \"Error: no test specified\" && exit 1"
+	},
+	"devDependencies": {
+		"vag_tools": "^0.1.0"
+	}
+}

package/dist/template/projAbc_repos.yml.handlebars

@@ -0,0 +1,13 @@
+# {{projName}}_repos.yml
+
+repositories:
+  repos/{{projName}}:
+    type: git
+    url: git@github.com:MYNAME/{{projName}}.git
+    version: main
+  repos/create-{{projName}}:
+    url: git@github.com:MYNAME/create-{{projName}}.git
+    version: main
+  repos/{{projName}}_vag:
+    url: git@github.com:MYNAME/{{projName}}_vag.git
+    version: main

package/package.json

@@ -0,0 +1,96 @@
+{
+	"name": "create-feli",
+	"version": "0.1.10",
+	"description": "The npm-initializer for creating a new feli package",
+	"private": false,
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/charlyoleg2/feli_mono.git"
+	},
+	"homepage": "https://www.npmjs.com/package/create-feli",
+	"author": "charlyoleg",
+	"license": "ISC",
+	"keywords": [
+		"front-end only",
+		"locally installed",
+		"web-UI deployment",
+		"feli"
+	],
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/create-feli-api.d.ts",
+			"default": "./dist/create-feli-api.js"
+		}
+	},
+	"bin": {
+		"create-feli": "dist/create-feli-cli.js"
+	},
+	"files": [
+		"dist/create-feli-cli.js",
+		"dist/template/",
+		"!dist/**/*.map",
+		"!dist/**/*.spec.*"
+	],
+	"tsup": {
+		"entry": [
+			"src/create-feli-api.ts",
+			"src/create-feli-ref.ts",
+			"src/create-feli-cli.ts"
+		],
+		"format": "esm",
+		"splitting": false,
+		"dts": false,
+		"sourcemap": false,
+		"clean": true
+	},
+	"prettier": {
+		"useTabs": true,
+		"singleQuote": true,
+		"trailingComma": "none",
+		"printWidth": 100,
+		"plugins": [],
+		"overrides": []
+	},
+	"scripts": {
+		"dev": "tsup --watch",
+		"build": "tsup",
+		"check": "tsc --noEmit",
+		"pretty": "prettier --check .",
+		"format": "prettier --write .",
+		"lint": "eslint .",
+		"test:unit": "vitest",
+		"test:unit:once": "vitest --run",
+		"copy_template": "shx cp -r template dist/",
+		"cleanCopy_template": "run-s clean:template copy_template",
+		"ci": "run-s check build pretty lint test:unit:once cleanCopy_template",
+		"run": "dist/create-feli-cli.js",
+		"run:ref": "dist/create-feli-ref.js tmp2",
+		"run:diff": "diff -rq tmp tmp2",
+		"run:check": "run-s run:ref run:diff",
+		"cycle": "run-s clean ci run",
+		"clean:template": "shx rm -fr dist/template",
+		"clean:build": "shx rm -fr dist node_modules",
+		"clean:output": "shx rm -fr tmp tmp2",
+		"clean": "run-s clean:build clean:output"
+	},
+	"dependencies": {
+		"@clack/prompts": "^0.11.0",
+		"chalk": "^5.3.0",
+		"handlebars": "^4.7.8"
+	},
+	"devDependencies": {
+		"@eslint/js": "^9.28.0",
+		"@types/eslint__js": "^8.42.3",
+		"@types/node": "^24.0.7",
+		"eslint": "^9.28.0",
+		"eslint-config-prettier": "^10.1.5",
+		"npm-run-all": "^4.1.5",
+		"prettier": "^3.5.3",
+		"shx": "^0.4.0",
+		"tsup": "^8.5.0",
+		"typescript": "^5.8.3",
+		"typescript-eslint": "^8.33.1",
+		"vitest": "^3.2.2"
+	}
+}