@lzear/forge 0.0.1

package/dist/bin.js

@@ -0,0 +1,239 @@
+#!/usr/bin/env node
+
+// src/bin.ts
+import { spawnSync } from "child_process";
+import { writeFile, mkdir } from "fs/promises";
+import { createRequire } from "module";
+import { homedir } from "os";
+import path from "path";
+import * as clack from "@clack/prompts";
+import { checkLocal, checkRepo } from "@lzear/repo-lint";
+import { Command } from "commander";
+import pc from "picocolors";
+var require2 = createRequire(import.meta.url);
+var { version } = require2("../package.json");
+var isTTY = process.stdout.isTTY ?? false;
+var isDebug = process.env.DEBUG?.includes("forge") ?? false;
+var debug = (...args) => {
+  if (isDebug) console.error(pc.dim(`[debug] ${args.join(" ")}`));
+};
+var log2 = {
+  intro: (msg) => isTTY ? clack.intro(msg) : console.log(msg),
+  outro: (msg) => isTTY ? clack.outro(msg) : console.log(msg),
+  success: (msg) => isTTY ? clack.log.success(msg) : console.log(`\u2713 ${msg}`),
+  error: (msg) => isTTY ? clack.log.error(msg) : console.error(`\u2717 ${msg}`),
+  warn: (msg) => isTTY ? clack.log.warn(msg) : console.warn(`! ${msg}`),
+  spinner: () => isTTY ? clack.spinner() : {
+    start: (msg) => {
+      debug(msg);
+    },
+    stop: (msg) => {
+      debug(msg);
+    }
+  }
+};
+var program = new Command();
+program.name("forge").description("lzear repo tooling").version(version, "-v, --version").helpOption("-h, --help", "show help");
+var DEFAULT_DIR = path.join(homedir(), ".cache", "forge");
+var printResults = (report, json) => {
+  const anyFail = report.results.some((r) => !r.pass);
+  if (json) {
+    console.log(
+      JSON.stringify(
+        { repo: report.repo, results: report.results, pass: !anyFail },
+        null,
+        2
+      )
+    );
+    return anyFail;
+  }
+  const pass = report.results.filter((r) => r.pass).length;
+  const total = report.results.length;
+  for (const r of report.results) {
+    process.stdout.write(
+      `  ${r.pass ? pc.green("\u2713") : pc.red("\u2717")}  ${r.desc}
+`
+    );
+    if (!r.pass && r.detail)
+      for (const line of r.detail.split("\n"))
+        process.stdout.write(`       ${pc.dim(line)}
+`);
+  }
+  const score = pass === total ? pc.green(`${pass}/${total}`) : pc.yellow(`${pass}/${total}`);
+  process.stdout.write(`
+  ${score} checks passed
+`);
+  return anyFail;
+};
+var runCheck = async (repos, opts) => {
+  if (!opts.json) process.stdout.write(`
+  ${pc.bold("forge check")}
+
+`);
+  if (!repos) {
+    debug("checkLocal", process.cwd());
+    const result = await checkLocal({ skipRemote: opts.skipRemote });
+    process.exit(printResults(result, opts.json) ? 1 : 0);
+  }
+  const repoList = repos.split(",").map((r) => r.trim());
+  let anyFail = false;
+  for (const repo of repoList) {
+    if (!opts.json)
+      process.stdout.write(`  ${pc.dim("checking " + repo + "\u2026")}
+`);
+    debug("checkRepo", repo);
+    try {
+      const result = await checkRepo(repo, {
+        baseDir: opts.dir,
+        skipRemote: opts.skipRemote
+      });
+      if (printResults(result, opts.json)) anyFail = true;
+    } catch (error) {
+      debug(String(error));
+      process.stderr.write(`  ${pc.red("\u2717 " + repo + " \u2014 could not clone")}
+`);
+      anyFail = true;
+    }
+  }
+  process.exit(anyFail ? 1 : 0);
+};
+program.command("check").description("audit repo(s) against forge standards").option(
+  "--repos <repos>",
+  "comma-separated list of repos (default: current repo)"
+).option("--skip-remote", "skip secret checks", false).option("--dir <dir>", "cache dir for cloned repos", DEFAULT_DIR).option("--json", "output results as JSON", false).action(
+  (opts) => runCheck(opts.repos, opts)
+);
+var promptAndSet = async (s, repo) => {
+  if (!isTTY) {
+    log2.error(
+      `${s.name}: non-interactive shell \u2014 run in a TTY or: gh secret set ${s.name} --repo ${repo}`
+    );
+    return;
+  }
+  const value = await clack.password({
+    message: `${s.name}: ${pc.dim(s.desc)}`
+  });
+  if (clack.isCancel(value) || !String(value).trim()) {
+    log2.warn(`${s.name} skipped.`);
+    return;
+  }
+  spawnSync(
+    "gh",
+    ["secret", "set", s.name, "--repo", repo, "--body", String(value).trim()],
+    { stdio: "ignore" }
+  );
+  log2.success(`${s.name} set.`);
+};
+var REQUIRED_SECRETS = (repo) => [
+  { name: "NPM_TOKEN", desc: "npm publish token (same for all repos)" },
+  {
+    name: "CODACY_PROJECT_TOKEN",
+    desc: `Codacy project token \u2014 find at app.codacy.com/gh/${repo}/settings/coverage`
+  }
+];
+var detectRepo = () => {
+  const result = spawnSync("git", ["remote", "get-url", "origin"], {
+    encoding: "utf8"
+  });
+  if (result.status !== 0) return void 0;
+  const url = result.stdout.trim();
+  const match = /github\.com[:/]([^/]+\/[^/.]+)(?:\.git)?$/.exec(url);
+  return match?.[1];
+};
+program.command("setup").description("check and set required GitHub secrets for a repo").option("--repo <repo>", "repo to set up (e.g. lzear/my-repo)").option("--dry", "check only, do not prompt for values", false).option("--json", "output results as JSON", false).action(async (opts) => {
+  const repo = opts.repo ?? detectRepo();
+  if (!repo) {
+    log2.error("Could not detect repo. Pass --repo <owner/repo>.");
+    process.exit(1);
+  }
+  const { dry, json } = opts;
+  if (!json) log2.intro(pc.bold(`forge setup \xB7 ${pc.cyan(repo)}`));
+  if (spawnSync("gh", ["--version"], { stdio: "ignore" }).status !== 0) {
+    log2.error("gh CLI not found \u2014 install at https://cli.github.com");
+    process.exit(1);
+  }
+  let existing;
+  try {
+    debug("gh secret list --repo", repo);
+    const result = spawnSync(
+      "gh",
+      ["secret", "list", "--repo", repo, "--json", "name"],
+      { encoding: "utf8" }
+    );
+    if (result.status !== 0) throw new Error(result.stderr);
+    existing = JSON.parse(result.stdout).map(
+      (s) => s.name
+    );
+  } catch {
+    log2.error("Failed to list secrets. Run: gh auth login");
+    process.exit(1);
+  }
+  const secrets = REQUIRED_SECRETS(repo);
+  const present = secrets.filter((s) => existing.includes(s.name));
+  const missing = secrets.filter((s) => !existing.includes(s.name));
+  if (json) {
+    console.log(
+      JSON.stringify(
+        {
+          repo,
+          present: present.map((s) => s.name),
+          missing: missing.map((s) => s.name)
+        },
+        null,
+        2
+      )
+    );
+    process.exit(missing.length > 0 ? 1 : 0);
+  }
+  for (const s of present) log2.success(s.name);
+  for (const s of missing) log2.error(`${s.name} \u2014 missing`);
+  if (missing.length === 0) {
+    log2.outro(pc.green("All secrets present."));
+    return;
+  }
+  if (dry) {
+    log2.outro(pc.yellow("Dry run \u2014 skipping."));
+    return;
+  }
+  for (const s of missing) {
+    await promptAndSet(s, repo);
+  }
+  log2.outro(pc.green("Done."));
+});
+var SYNC_FILES = [
+  { src: "template/.editorconfig", dest: ".editorconfig" },
+  { src: "template/.codacy.yml", dest: ".codacy.yml" }
+];
+var RAW_BASE = "https://raw.githubusercontent.com/lzear/forge/main";
+program.command("sync").description("sync template files from forge into this repo").option("--dry", "print what would change, do not write", false).action(async (opts) => {
+  log2.intro(pc.bold("forge sync"));
+  let anyFail = false;
+  for (const { src, dest } of SYNC_FILES) {
+    const url = `${RAW_BASE}/${src}`;
+    const destPath = path.join(process.cwd(), dest);
+    try {
+      const res = await fetch(url);
+      if (!res.ok) throw new Error(`HTTP ${res.status}`);
+      const content = await res.text();
+      if (opts.dry) {
+        log2.success(`${dest} ${pc.dim("(dry)")}`);
+      } else {
+        await mkdir(path.dirname(destPath), { recursive: true });
+        await writeFile(destPath, content, "utf8");
+        log2.success(dest);
+      }
+    } catch (error) {
+      log2.error(`${dest} \u2014 ${String(error)}`);
+      anyFail = true;
+    }
+  }
+  log2.outro(anyFail ? pc.red("Done with errors.") : pc.green("Done."));
+  if (anyFail) process.exit(1);
+});
+var handleSignal = () => {
+  if (isTTY) clack.cancel("Cancelled.");
+  process.exit(130);
+};
+process.on("SIGINT", handleSignal);
+process.on("SIGTERM", handleSignal);
+program.parse();

package/dist/eslint.d.ts

@@ -0,0 +1,6 @@
+export { default } from '@lzear/eslint-config';
+import '@lzear/configs/vitest';
+import '@lzear/configs/vitest/react';
+import '@lzear/configs/tsup';
+import '@lzear/configs/vite';
+import '@lzear/repo-lint';

package/dist/eslint.js

@@ -0,0 +1,5 @@
+// src/eslint.ts
+import { default as default2 } from "@lzear/eslint-config";
+export {
+  default2 as default
+};

package/dist/repo-lint.d.ts

@@ -0,0 +1 @@
+export { Check, CheckLocalOptions, CheckRepoOptions, CheckResult, LocalCheck, RemoteCheck, RepoReport, checkLocal, checkRepo } from '@lzear/repo-lint';

package/dist/repo-lint.js

@@ -0,0 +1,6 @@
+// src/repo-lint.ts
+import { checkLocal, checkRepo } from "@lzear/repo-lint";
+export {
+  checkLocal,
+  checkRepo
+};

package/dist/tsup.d.ts

@@ -0,0 +1 @@
+export { defineBinConfig, defineLibConfig } from '@lzear/configs/tsup';

package/dist/tsup.js

@@ -0,0 +1,6 @@
+// src/tsup.ts
+import { defineBinConfig, defineLibConfig } from "@lzear/configs/tsup";
+export {
+  defineBinConfig,
+  defineLibConfig
+};

package/dist/vite.d.ts

@@ -0,0 +1 @@
+export { defineReactConfig } from '@lzear/configs/vite';

package/dist/vite.js

@@ -0,0 +1,5 @@
+// src/vite.ts
+import { defineReactConfig } from "@lzear/configs/vite";
+export {
+  defineReactConfig
+};

package/dist/vitest.d.ts

@@ -0,0 +1 @@
+export { default } from '@lzear/configs/vitest';

package/dist/vitest.js

@@ -0,0 +1,5 @@
+// src/vitest.ts
+import { default as default2 } from "@lzear/configs/vitest";
+export {
+  default2 as default
+};

package/dist/vitest.react.d.ts

@@ -0,0 +1 @@
+export { default } from '@lzear/configs/vitest/react';

package/dist/vitest.react.js

@@ -0,0 +1,5 @@
+// src/vitest.react.ts
+import { default as default2 } from "@lzear/configs/vitest/react";
+export {
+  default2 as default
+};

package/package.json

@@ -0,0 +1,105 @@
+{
+  "name": "@lzear/forge",
+  "version": "0.0.1",
+  "description": "Umbrella package for all lzear dev tooling",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lzear/forge.git",
+    "directory": "packages/forge"
+  },
+  "author": "lzear",
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    "./eslint": {
+      "types": "./dist/eslint.d.ts",
+      "default": "./dist/eslint.js"
+    },
+    "./repo-lint": {
+      "types": "./dist/repo-lint.d.ts",
+      "default": "./dist/repo-lint.js"
+    },
+    "./tsconfig/app": "./tsconfig/app.json",
+    "./tsconfig/lib": "./tsconfig/lib.json",
+    "./tsconfig/react": "./tsconfig/react.json",
+    "./tsup": {
+      "types": "./dist/tsup.d.ts",
+      "default": "./dist/tsup.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
+    },
+    "./vitest": {
+      "types": "./dist/vitest.d.ts",
+      "default": "./dist/vitest.js"
+    },
+    "./vitest/react": {
+      "types": "./dist/vitest.react.d.ts",
+      "default": "./dist/vitest.react.js"
+    }
+  },
+  "bin": "./dist/bin.js",
+  "files": [
+    "dist",
+    "tsconfig"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1",
+    "@lzear/configs": "workspace:*",
+    "@lzear/eslint-config": "workspace:*",
+    "@lzear/repo-lint": "workspace:*",
+    "commander": "^14",
+    "picocolors": "^1"
+  },
+  "devDependencies": {
+    "@types/node": "^25",
+    "@vitejs/plugin-react": "^6",
+    "eslint": "^9",
+    "jsdom": "^29",
+    "tsup": "^8",
+    "typescript": "^6",
+    "vite": "^8",
+    "vitest": "^4"
+  },
+  "peerDependencies": {
+    "@vitejs/plugin-react": "^6",
+    "eslint": "^9",
+    "jsdom": "^29",
+    "tsup": "^8",
+    "vite": "^8",
+    "vitest": "^4"
+  },
+  "peerDependenciesMeta": {
+    "@vitejs/plugin-react": {
+      "optional": true
+    },
+    "eslint": {
+      "optional": true
+    },
+    "jsdom": {
+      "optional": true
+    },
+    "tsup": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    },
+    "vitest": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/tsconfig/app.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@lzear/configs/tsconfig/app"
+}

package/tsconfig/lib.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@lzear/configs/tsconfig/lib"
+}

package/tsconfig/react.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "https://json.schemastore.org/tsconfig",
+  "extends": "@lzear/configs/tsconfig/react"
+}