@bensandee/tooling 0.2.0

package/dist/index.d.mts

@@ -0,0 +1,102 @@
+import { z } from "zod";
+
+//#region src/utils/json.d.ts
+declare const PackageJsonSchema: z.ZodObject<{
+  name: z.ZodOptional<z.ZodString>;
+  version: z.ZodOptional<z.ZodString>;
+  private: z.ZodOptional<z.ZodBoolean>;
+  type: z.ZodOptional<z.ZodString>;
+  scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+  bin: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>>;
+  exports: z.ZodOptional<z.ZodUnknown>;
+  main: z.ZodOptional<z.ZodString>;
+  types: z.ZodOptional<z.ZodString>;
+  typings: z.ZodOptional<z.ZodString>;
+  engines: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$loose>;
+type PackageJson = z.infer<typeof PackageJsonSchema>;
+//#endregion
+//#region src/types.d.ts
+type CiPlatform = "github" | "forgejo" | "none";
+type ReleaseStrategy = "release-it" | "commit-and-tag-version" | "changesets" | "none";
+/** User's answers from the interactive prompt or CLI flags. */
+interface ProjectConfig {
+  /** Project name (from package.json name or user input) */
+  name: string;
+  /** Whether this is a new project or existing */
+  isNew: boolean;
+  /** Project structure */
+  structure: "single" | "monorepo";
+  /** Include @bensandee/lint-rules oxlint plugin */
+  useLintRules: boolean;
+  /** Formatter choice */
+  formatter: "oxfmt" | "prettier";
+  /** Set up vitest with a starter test */
+  setupVitest: boolean;
+  /** CI platform choice */
+  ci: CiPlatform;
+  /** Set up Renovate for automated dependency updates */
+  setupRenovate: boolean;
+  /** Release management strategy */
+  releaseStrategy: ReleaseStrategy;
+  /** Project type determines tsconfig base configuration */
+  projectType: "default" | "node" | "react" | "library";
+  /** Auto-detect and configure tsconfig bases for monorepo packages */
+  detectPackageTypes: boolean;
+  /** Target directory (default: cwd) */
+  targetDir: string;
+}
+/** Result from a single generator: what file was written and how. */
+interface GeneratorResult {
+  filePath: string;
+  action: "created" | "updated" | "skipped";
+  /** Human-readable description of what changed */
+  description: string;
+}
+/** Context passed to each generator function. */
+interface GeneratorContext {
+  config: ProjectConfig;
+  /** Absolute path to target directory */
+  targetDir: string;
+  /** Pre-parsed package.json from the target directory, or undefined if missing/invalid */
+  packageJson: PackageJson | undefined;
+  /** Check whether a file exists in the target directory */
+  exists: (relativePath: string) => boolean;
+  /** Read an existing file from the target directory, returns undefined if not found */
+  read: (relativePath: string) => string | undefined;
+  /** Write a file to the target directory (creating directories as needed) */
+  write: (relativePath: string, content: string) => void;
+  /** Prompt user for conflict resolution on non-mergeable files */
+  confirmOverwrite: (relativePath: string) => Promise<"overwrite" | "skip">;
+}
+/** Generator function signature. */
+type Generator = (ctx: GeneratorContext) => Promise<GeneratorResult>;
+/** State detected from an existing project directory. */
+interface DetectedProjectState {
+  hasPackageJson: boolean;
+  hasTsconfig: boolean;
+  hasOxlintConfig: boolean;
+  /** Legacy .oxlintrc.json found (should be migrated to oxlint.config.ts) */
+  hasLegacyOxlintJson: boolean;
+  hasGitignore: boolean;
+  hasVitestConfig: boolean;
+  hasTsdownConfig: boolean;
+  hasPnpmWorkspace: boolean;
+  hasKnipConfig: boolean;
+  hasRenovateConfig: boolean;
+  hasReleaseItConfig: boolean;
+  hasCommitAndTagVersionConfig: boolean;
+  hasChangesetsConfig: boolean;
+  /** Legacy tooling configs found */
+  legacyConfigs: LegacyConfig[];
+}
+declare const LEGACY_TOOLS: readonly ["eslint", "prettier", "jest", "webpack", "rollup"];
+type LegacyTool = (typeof LEGACY_TOOLS)[number];
+interface LegacyConfig {
+  tool: LegacyTool;
+  files: string[];
+}
+//#endregion
+export { type DetectedProjectState, type Generator, type GeneratorContext, type GeneratorResult, type LegacyConfig, type ProjectConfig };

package/dist/index.mjs

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@bensandee/tooling",
+  "version": "0.2.0",
+  "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
+  "bin": {
+    "tooling": "./dist/bin.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "imports": {
+    "#src/*": "./src/*.ts"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "citty": "^0.2.1",
+    "jsonc-parser": "^3.3.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.11",
+    "tsdown": "0.20.3",
+    "typescript": "5.9.3",
+    "vitest": "4.0.18",
+    "@bensandee/config": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}