create-orioro 0.0.1

package/README.md

@@ -0,0 +1,10 @@
+# @orioro/jest-util
+
+```
+npm install @orioro/jest-util
+yarn add @orioro/jest-util
+```
+
+Set of utility methods for generating tests using `jest`.
+
+# API Docs

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.mjs

@@ -0,0 +1,304 @@
+#!/usr/bin/env node
+import { join, basename, resolve } from 'node:path';
+import { Command } from 'commander';
+import * as prompts from '@clack/prompts';
+import { statSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import degit from 'degit';
+
+function __awaiter(thisArg, _arguments, P, generator) {
+  function adopt(value) {
+    return value instanceof P ? value : new P(function (resolve) {
+      resolve(value);
+    });
+  }
+  return new (P || (P = Promise))(function (resolve, reject) {
+    function fulfilled(value) {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    }
+    function rejected(value) {
+      try {
+        step(generator["throw"](value));
+      } catch (e) {
+        reject(e);
+      }
+    }
+    function step(result) {
+      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
+    }
+    step((generator = generator.apply(thisArg, _arguments || [])).next());
+  });
+}
+function __generator(thisArg, body) {
+  var _ = {
+      label: 0,
+      sent: function sent() {
+        if (t[0] & 1) throw t[1];
+        return t[1];
+      },
+      trys: [],
+      ops: []
+    },
+    f,
+    y,
+    t,
+    g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+  return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function () {
+    return this;
+  }), g;
+  function verb(n) {
+    return function (v) {
+      return step([n, v]);
+    };
+  }
+  function step(op) {
+    if (f) throw new TypeError("Generator is already executing.");
+    while (g && (g = 0, op[0] && (_ = 0)), _) try {
+      if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+      if (y = 0, t) op = [op[0] & 2, t.value];
+      switch (op[0]) {
+        case 0:
+        case 1:
+          t = op;
+          break;
+        case 4:
+          _.label++;
+          return {
+            value: op[1],
+            done: false
+          };
+        case 5:
+          _.label++;
+          y = op[1];
+          op = [0];
+          continue;
+        case 7:
+          op = _.ops.pop();
+          _.trys.pop();
+          continue;
+        default:
+          if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+            _ = 0;
+            continue;
+          }
+          if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+            _.label = op[1];
+            break;
+          }
+          if (op[0] === 6 && _.label < t[1]) {
+            _.label = t[1];
+            t = op;
+            break;
+          }
+          if (t && _.label < t[2]) {
+            _.label = t[2];
+            _.ops.push(op);
+            break;
+          }
+          if (t[2]) _.ops.pop();
+          _.trys.pop();
+          continue;
+      }
+      op = body.call(thisArg, _);
+    } catch (e) {
+      op = [6, e];
+      y = 0;
+    } finally {
+      f = t = 0;
+    }
+    if (op[0] & 5) throw op[1];
+    return {
+      value: op[0] ? op[1] : void 0,
+      done: true
+    };
+  }
+}
+function __spreadArray(to, from, pack) {
+  if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+    if (ar || !(i in from)) {
+      if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+      ar[i] = from[i];
+    }
+  }
+  return to.concat(ar || Array.prototype.slice.call(from));
+}
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+  var e = new Error(message);
+  return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+function scaffold(projectDir, templateUrl) {
+  return __awaiter(this, void 0, void 0, function () {
+    var stat, emitter, pkgPath, pkg;
+    return __generator(this, function (_a) {
+      switch (_a.label) {
+        case 0:
+          try {
+            stat = statSync(projectDir);
+          } catch (_b) {
+            // path does not exist — fine to proceed
+          }
+          if (stat) {
+            if (stat.isFile()) {
+              throw new Error("\"".concat(projectDir, "\" already exists as a file"));
+            }
+            if (stat.isDirectory() && readdirSync(projectDir).length > 0) {
+              throw new Error("Directory \"".concat(projectDir, "\" already exists and is not empty"));
+            }
+          }
+          emitter = degit(templateUrl, {
+            cache: false,
+            force: false
+          });
+          return [4 /*yield*/, emitter.clone(projectDir)];
+        case 1:
+          _a.sent();
+          pkgPath = join(projectDir, 'package.json');
+          try {
+            statSync(pkgPath);
+            pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+            pkg.name = basename(projectDir);
+            writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+          } catch (_c) {
+            // no package.json — skip
+          }
+          return [2 /*return*/];
+      }
+    });
+  });
+}
+
+// Branch where templates live — update once merged to main
+var TEMPLATE_BRANCH = 'main';
+var GITHUB_REPO = 'orioro/node-devtools';
+// degit requires short-form paths (user/repo/subdir) for subdirectory cloning;
+// full https URLs do not support the subdir syntax
+var TEMPLATES = {
+  ts: {
+    label: 'TypeScript library (ts)',
+    src: "".concat(GITHUB_REPO, "/packages/template-ts#").concat(TEMPLATE_BRANCH)
+    // url: `https://github.com/${GITHUB_REPO}/tree/${TEMPLATE_BRANCH}/packages/template-ts`,
+  },
+  react: {
+    label: 'React component library (react)',
+    src: "".concat(GITHUB_REPO, "/packages/template-react#").concat(TEMPLATE_BRANCH)
+    // url: `https://github.com/${GITHUB_REPO}/tree/${TEMPLATE_BRANCH}/packages/template-react`,
+  },
+  workspaces: {
+    label: 'Monorepo workspaces (workspaces)',
+    src: "".concat(GITHUB_REPO, "/packages/template-workspaces#").concat(TEMPLATE_BRANCH)
+    // url: `https://github.com/${GITHUB_REPO}/tree/${TEMPLATE_BRANCH}/packages/template-workspaces`,
+  }
+};
+function resolveTemplateSrc(template) {
+  var _a, _b;
+  return (_b = (_a = TEMPLATES[template]) === null || _a === void 0 ? void 0 : _a.src) !== null && _b !== void 0 ? _b : template;
+}
+var program = new Command();
+program.name('create-orioro').description('Scaffold a new project from an orioro template').argument('[project-dir]', 'Directory to scaffold the project into').option('-t, --template <template>', 'Template to use: ts, react, workspaces, or a custom degit path').action(function (projectDirArg, options) {
+  return __awaiter(void 0, void 0, void 0, function () {
+    var projectDir, _a, templateUrl, spinner, absProjectDir, err_1;
+    return __generator(this, function (_b) {
+      switch (_b.label) {
+        case 0:
+          prompts.intro('create-orioro');
+          _a = projectDirArg;
+          if (_a) return [3 /*break*/, 2];
+          return [4 /*yield*/, prompts.text({
+            message: 'Project directory',
+            placeholder: 'my-project',
+            validate: function validate(v) {
+              return !v ? 'Please enter a directory name' : undefined;
+            }
+          })];
+        case 1:
+          _a = _b.sent();
+          _b.label = 2;
+        case 2:
+          projectDir = _a;
+          if (prompts.isCancel(projectDir)) {
+            prompts.cancel('Cancelled');
+            process.exit(0);
+          }
+          return [4 /*yield*/, function () {
+            return __awaiter(void 0, void 0, void 0, function () {
+              var selected, custom;
+              return __generator(this, function (_a) {
+                switch (_a.label) {
+                  case 0:
+                    if (options.template) {
+                      return [2 /*return*/, resolveTemplateSrc(options.template)];
+                    }
+                    return [4 /*yield*/, prompts.select({
+                      message: 'Select a template',
+                      options: __spreadArray(__spreadArray([], Object.entries(TEMPLATES).map(function (_a) {
+                        var id = _a[0],
+                          _b = _a[1],
+                          label = _b.label;
+                          _b.url;
+                        return {
+                          value: id,
+                          label: "".concat(label)
+                        };
+                      }), true), [{
+                        value: 'other',
+                        label: 'Other (custom degit path / git URL)'
+                      }], false)
+                    })];
+                  case 1:
+                    selected = _a.sent();
+                    if (prompts.isCancel(selected)) {
+                      prompts.cancel('Cancelled');
+                      process.exit(0);
+                    }
+                    if (selected !== 'other') {
+                      return [2 /*return*/, resolveTemplateSrc(selected)];
+                    }
+                    return [4 /*yield*/, prompts.text({
+                      message: 'Enter a degit path or git URL',
+                      placeholder: 'user/repo  or  user/repo/subdir  or  https://...',
+                      validate: function validate(v) {
+                        return !v ? 'Please enter a path or URL' : undefined;
+                      }
+                    })];
+                  case 2:
+                    custom = _a.sent();
+                    if (prompts.isCancel(custom)) {
+                      prompts.cancel('Cancelled');
+                      process.exit(0);
+                    }
+                    return [2 /*return*/, custom];
+                }
+              });
+            });
+          }()];
+        case 3:
+          templateUrl = _b.sent();
+          spinner = prompts.spinner();
+          spinner.start("Cloning ".concat(templateUrl, " \u2192 ").concat(projectDir));
+          absProjectDir = resolve(projectDir);
+          _b.label = 4;
+        case 4:
+          _b.trys.push([4, 6,, 7]);
+          return [4 /*yield*/, scaffold(absProjectDir, templateUrl)];
+        case 5:
+          _b.sent();
+          spinner.stop('Done!');
+          prompts.outro("Project ready at ".concat(absProjectDir));
+          return [3 /*break*/, 7];
+        case 6:
+          err_1 = _b.sent();
+          spinner.stop('Failed');
+          prompts.cancel(err_1 instanceof Error ? err_1.message : String(err_1));
+          process.exit(1);
+          return [3 /*break*/, 7];
+        case 7:
+          return [2 /*return*/];
+      }
+    });
+  });
+});
+program.parse();

package/dist/index.d.ts

@@ -0,0 +1 @@
+export declare function scaffold(projectDir: string, templateUrl: string): Promise<void>;

package/dist/index.js

@@ -0,0 +1,164 @@
+'use strict';
+
+var node_fs = require('node:fs');
+var node_path = require('node:path');
+var degit = require('degit');
+
+function __awaiter(thisArg, _arguments, P, generator) {
+  function adopt(value) {
+    return value instanceof P ? value : new P(function (resolve) {
+      resolve(value);
+    });
+  }
+  return new (P || (P = Promise))(function (resolve, reject) {
+    function fulfilled(value) {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    }
+    function rejected(value) {
+      try {
+        step(generator["throw"](value));
+      } catch (e) {
+        reject(e);
+      }
+    }
+    function step(result) {
+      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
+    }
+    step((generator = generator.apply(thisArg, _arguments || [])).next());
+  });
+}
+function __generator(thisArg, body) {
+  var _ = {
+      label: 0,
+      sent: function sent() {
+        if (t[0] & 1) throw t[1];
+        return t[1];
+      },
+      trys: [],
+      ops: []
+    },
+    f,
+    y,
+    t,
+    g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+  return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function () {
+    return this;
+  }), g;
+  function verb(n) {
+    return function (v) {
+      return step([n, v]);
+    };
+  }
+  function step(op) {
+    if (f) throw new TypeError("Generator is already executing.");
+    while (g && (g = 0, op[0] && (_ = 0)), _) try {
+      if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+      if (y = 0, t) op = [op[0] & 2, t.value];
+      switch (op[0]) {
+        case 0:
+        case 1:
+          t = op;
+          break;
+        case 4:
+          _.label++;
+          return {
+            value: op[1],
+            done: false
+          };
+        case 5:
+          _.label++;
+          y = op[1];
+          op = [0];
+          continue;
+        case 7:
+          op = _.ops.pop();
+          _.trys.pop();
+          continue;
+        default:
+          if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+            _ = 0;
+            continue;
+          }
+          if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+            _.label = op[1];
+            break;
+          }
+          if (op[0] === 6 && _.label < t[1]) {
+            _.label = t[1];
+            t = op;
+            break;
+          }
+          if (t && _.label < t[2]) {
+            _.label = t[2];
+            _.ops.push(op);
+            break;
+          }
+          if (t[2]) _.ops.pop();
+          _.trys.pop();
+          continue;
+      }
+      op = body.call(thisArg, _);
+    } catch (e) {
+      op = [6, e];
+      y = 0;
+    } finally {
+      f = t = 0;
+    }
+    if (op[0] & 5) throw op[1];
+    return {
+      value: op[0] ? op[1] : void 0,
+      done: true
+    };
+  }
+}
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+  var e = new Error(message);
+  return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+function scaffold(projectDir, templateUrl) {
+  return __awaiter(this, void 0, void 0, function () {
+    var stat, emitter, pkgPath, pkg;
+    return __generator(this, function (_a) {
+      switch (_a.label) {
+        case 0:
+          try {
+            stat = node_fs.statSync(projectDir);
+          } catch (_b) {
+            // path does not exist — fine to proceed
+          }
+          if (stat) {
+            if (stat.isFile()) {
+              throw new Error("\"".concat(projectDir, "\" already exists as a file"));
+            }
+            if (stat.isDirectory() && node_fs.readdirSync(projectDir).length > 0) {
+              throw new Error("Directory \"".concat(projectDir, "\" already exists and is not empty"));
+            }
+          }
+          emitter = degit(templateUrl, {
+            cache: false,
+            force: false
+          });
+          return [4 /*yield*/, emitter.clone(projectDir)];
+        case 1:
+          _a.sent();
+          pkgPath = node_path.join(projectDir, 'package.json');
+          try {
+            node_fs.statSync(pkgPath);
+            pkg = JSON.parse(node_fs.readFileSync(pkgPath, 'utf8'));
+            pkg.name = node_path.basename(projectDir);
+            node_fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+          } catch (_c) {
+            // no package.json — skip
+          }
+          return [2 /*return*/];
+      }
+    });
+  });
+}
+
+exports.scaffold = scaffold;

package/dist/index.mjs

@@ -0,0 +1,162 @@
+import { statSync, readFileSync, writeFileSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import degit from 'degit';
+
+function __awaiter(thisArg, _arguments, P, generator) {
+  function adopt(value) {
+    return value instanceof P ? value : new P(function (resolve) {
+      resolve(value);
+    });
+  }
+  return new (P || (P = Promise))(function (resolve, reject) {
+    function fulfilled(value) {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    }
+    function rejected(value) {
+      try {
+        step(generator["throw"](value));
+      } catch (e) {
+        reject(e);
+      }
+    }
+    function step(result) {
+      result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected);
+    }
+    step((generator = generator.apply(thisArg, _arguments || [])).next());
+  });
+}
+function __generator(thisArg, body) {
+  var _ = {
+      label: 0,
+      sent: function sent() {
+        if (t[0] & 1) throw t[1];
+        return t[1];
+      },
+      trys: [],
+      ops: []
+    },
+    f,
+    y,
+    t,
+    g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+  return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function () {
+    return this;
+  }), g;
+  function verb(n) {
+    return function (v) {
+      return step([n, v]);
+    };
+  }
+  function step(op) {
+    if (f) throw new TypeError("Generator is already executing.");
+    while (g && (g = 0, op[0] && (_ = 0)), _) try {
+      if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+      if (y = 0, t) op = [op[0] & 2, t.value];
+      switch (op[0]) {
+        case 0:
+        case 1:
+          t = op;
+          break;
+        case 4:
+          _.label++;
+          return {
+            value: op[1],
+            done: false
+          };
+        case 5:
+          _.label++;
+          y = op[1];
+          op = [0];
+          continue;
+        case 7:
+          op = _.ops.pop();
+          _.trys.pop();
+          continue;
+        default:
+          if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) {
+            _ = 0;
+            continue;
+          }
+          if (op[0] === 3 && (!t || op[1] > t[0] && op[1] < t[3])) {
+            _.label = op[1];
+            break;
+          }
+          if (op[0] === 6 && _.label < t[1]) {
+            _.label = t[1];
+            t = op;
+            break;
+          }
+          if (t && _.label < t[2]) {
+            _.label = t[2];
+            _.ops.push(op);
+            break;
+          }
+          if (t[2]) _.ops.pop();
+          _.trys.pop();
+          continue;
+      }
+      op = body.call(thisArg, _);
+    } catch (e) {
+      op = [6, e];
+      y = 0;
+    } finally {
+      f = t = 0;
+    }
+    if (op[0] & 5) throw op[1];
+    return {
+      value: op[0] ? op[1] : void 0,
+      done: true
+    };
+  }
+}
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+  var e = new Error(message);
+  return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+function scaffold(projectDir, templateUrl) {
+  return __awaiter(this, void 0, void 0, function () {
+    var stat, emitter, pkgPath, pkg;
+    return __generator(this, function (_a) {
+      switch (_a.label) {
+        case 0:
+          try {
+            stat = statSync(projectDir);
+          } catch (_b) {
+            // path does not exist — fine to proceed
+          }
+          if (stat) {
+            if (stat.isFile()) {
+              throw new Error("\"".concat(projectDir, "\" already exists as a file"));
+            }
+            if (stat.isDirectory() && readdirSync(projectDir).length > 0) {
+              throw new Error("Directory \"".concat(projectDir, "\" already exists and is not empty"));
+            }
+          }
+          emitter = degit(templateUrl, {
+            cache: false,
+            force: false
+          });
+          return [4 /*yield*/, emitter.clone(projectDir)];
+        case 1:
+          _a.sent();
+          pkgPath = join(projectDir, 'package.json');
+          try {
+            statSync(pkgPath);
+            pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+            pkg.name = basename(projectDir);
+            writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+          } catch (_c) {
+            // no package.json — skip
+          }
+          return [2 /*return*/];
+      }
+    });
+  });
+}
+
+export { scaffold };

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "create-orioro",
+  "version": "0.0.1",
+  "packageManager": "yarn@4.0.2",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "create-orioro": "dist/cli.mjs"
+  },
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./*": "./dist/*"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "ISC",
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "rm -rf dist && rollup --config ./rollup.config.mjs && chmod +x dist/cli.mjs",
+    "test": "jest",
+    "readme": "readme",
+    "dev:run": "yarn build && node dist/cli.mjs"
+  },
+  "devDependencies": {
+    "@orioro/dev": "workspace:^",
+    "@orioro/readme": "^1.0.1",
+    "@types/jest": "^29.5.12",
+    "babel-jest": "^30.3.0",
+    "jest": "^29.7.0",
+    "rollup": "^4.13.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.2.0",
+    "@types/degit": "^2.8.6",
+    "commander": "^14.0.3",
+    "degit": "^2.8.4"
+  }
+}