@bensandee/tooling 0.14.0 → 0.14.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @bensandee/tooling
 
+## 0.14.1
+
+### Patch Changes
+
+- caeebd8: Add d.ts declaration file output and types export conditions
+- caeebd8: Bump tsdown from 0.21.0 to 0.21.2
+- Updated dependencies [caeebd8]
+- Updated dependencies [caeebd8]
+  - @bensandee/common@0.1.2
+
 ## 0.14.0
 
 ### Minor Changes

package/dist/bin.d.mts

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

package/dist/bin.mjs

@@ -595,8 +595,8 @@ function addReleaseDeps(deps, config) {
 function getAddedDevDepNames(config) {
 	const deps = { ...ROOT_DEV_DEPS };
 	if (config.structure !== "monorepo") Object.assign(deps, PER_PACKAGE_DEV_DEPS);
-	deps["@bensandee/config"] = "0.8.0";
-	deps["@bensandee/tooling"] = "0.14.0";
+	deps["@bensandee/config"] = "0.8.1";
+	deps["@bensandee/tooling"] = "0.14.1";
 	if (config.formatter === "oxfmt") deps["oxfmt"] = "0.35.0";
 	if (config.formatter === "prettier") deps["prettier"] = "3.8.1";
 	addReleaseDeps(deps, config);
@@ -616,9 +616,9 @@ async function generatePackageJson(ctx) {
 	if (ctx.config.releaseStrategy !== "none" && ctx.config.releaseStrategy !== "changesets") allScripts["trigger-release"] = "pnpm exec tooling release:trigger";
 	const devDeps = { ...ROOT_DEV_DEPS };
 	if (!isMonorepo) Object.assign(devDeps, PER_PACKAGE_DEV_DEPS);
-	devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.8.0";
-	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.14.0";
-	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.9.1";
+	devDeps["@bensandee/config"] = isWorkspacePackage(ctx, "@bensandee/config") ? "workspace:*" : "0.8.1";
+	devDeps["@bensandee/tooling"] = isWorkspacePackage(ctx, "@bensandee/tooling") ? "workspace:*" : "0.14.1";
+	if (ctx.config.useEslintPlugin) devDeps["@bensandee/eslint-plugin"] = isWorkspacePackage(ctx, "@bensandee/eslint-plugin") ? "workspace:*" : "0.9.2";
 	if (ctx.config.formatter === "oxfmt") devDeps["oxfmt"] = "0.35.0";
 	if (ctx.config.formatter === "prettier") devDeps["prettier"] = "3.8.1";
 	addReleaseDeps(devDeps, ctx.config);
@@ -3690,7 +3690,7 @@ const runChecksCommand = defineCommand({
 const main = defineCommand({
 	meta: {
 		name: "tooling",
-		version: "0.14.0",
+		version: "0.14.1",
 		description: "Bootstrap and maintain standardized TypeScript project tooling"
 	},
 	subCommands: {
@@ -3705,7 +3705,7 @@ const main = defineCommand({
 		"release:simple": releaseSimpleCommand
 	}
 });
-console.log(`@bensandee/tooling v0.14.0`);
+console.log(`@bensandee/tooling v0.14.1`);
 runMain(main);
 //#endregion
 export {};

package/dist/docker-verify/index.d.mts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+
+//#region src/release/types.d.ts
+/** Result of executing a shell command. */
+interface ExecResult {
+  stdout: string;
+  stderr: string;
+  exitCode: number;
+}
+/** Options for executing a shell command. */
+interface ExecOptions {
+  cwd?: string;
+  env?: Record<string, string>;
+}
+//#endregion
+//#region src/docker-verify/types.d.ts
+/** Abstraction over side effects for testability. */
+interface DockerVerifyExecutor {
+  /** Run a shell command and return the result (stdout/stderr captured). */
+  exec(command: string, options?: ExecOptions): ExecResult;
+  /** Run a shell command, streaming stdout/stderr to the console. */
+  execInherit(command: string, options?: ExecOptions): void;
+  /** Perform an HTTP request. */
+  fetch(url: string, init?: RequestInit): Promise<Response>;
+  /** Get current time in ms (mockable clock). */
+  now(): number;
+  /** Sleep for the given duration (mockable delay). */
+  sleep(ms: number): Promise<void>;
+  /** Register a process signal handler. Returns a dispose function. */
+  onSignal(signal: NodeJS.Signals, handler: () => void): () => void;
+  /** Log a message to the console. */
+  log(message: string): void;
+  /** Log an error to the console. */
+  logError(message: string): void;
+}
+/** A single HTTP health check definition. */
+interface HttpHealthCheck {
+  /** Human-readable name for logging (e.g. "API", "Frontend"). */
+  name: string;
+  /** URL to fetch. */
+  url: string;
+  /** Validate the response. Return true if healthy. */
+  validate: (response: Response) => Promise<boolean>;
+}
+/** Docker compose configuration. */
+interface ComposeConfig {
+  /** Working directory for docker compose commands. */
+  cwd: string;
+  /** Compose files to use (e.g. ["docker-compose.yaml", "docker-compose.verify.yaml"]). */
+  composeFiles: string[];
+  /** Optional env file for compose. */
+  envFile?: string;
+  /** Service names to monitor for container-level health. */
+  services: string[];
+}
+/** Full verification configuration. */
+interface VerifyConfig {
+  /** Docker compose settings. */
+  compose: ComposeConfig;
+  /** Optional build command to run before starting compose (e.g. "pnpm image:build"). */
+  buildCommand?: string;
+  /** Working directory for the build command (defaults to compose.cwd). */
+  buildCwd?: string;
+  /** HTTP health checks to poll. All must pass for success. */
+  healthChecks: HttpHealthCheck[];
+  /** Maximum time to wait for all checks to pass, in ms. Default: 120000. */
+  timeoutMs?: number;
+  /** Interval between polling attempts, in ms. Default: 5000. */
+  pollIntervalMs?: number;
+}
+/** Result of the verification run. */
+type VerifyResult = {
+  success: true;
+  elapsedMs: number;
+} | {
+  success: false;
+  reason: "timeout" | "unhealthy-container" | "error";
+  message: string;
+  elapsedMs: number;
+};
+//#endregion
+//#region src/docker-verify/executor.d.ts
+/** Create an executor that runs real commands, fetches, and manages process signals. */
+declare function createRealExecutor(): DockerVerifyExecutor;
+//#endregion
+//#region src/docker-verify/verify.d.ts
+/** Run the full Docker image verification lifecycle. */
+declare function runVerification(executor: DockerVerifyExecutor, config: VerifyConfig): Promise<VerifyResult>;
+//#endregion
+//#region src/docker-verify/compose.d.ts
+/** Zod schema for a single container entry from `docker compose ps --format json`. */
+declare const ContainerInfoSchema: z.ZodObject<{
+  Service: z.ZodString;
+  Health: z.ZodString;
+}, z.core.$strip>;
+type ContainerInfo = z.infer<typeof ContainerInfoSchema>;
+/** Build the `docker compose` base command string from config. */
+declare function composeCommand(config: ComposeConfig): string;
+/** Start the compose stack in detached mode. */
+declare function composeUp(executor: DockerVerifyExecutor, config: ComposeConfig): void;
+/** Tear down the compose stack, removing volumes and orphans. Swallows errors. */
+declare function composeDown(executor: DockerVerifyExecutor, config: ComposeConfig): void;
+/** Show logs for a specific service (or all services if not specified). Swallows errors. */
+declare function composeLogs(executor: DockerVerifyExecutor, config: ComposeConfig, service?: string): void;
+/**
+ * Query container status via `docker compose ps --format json`.
+ * Handles both JSON array and newline-delimited JSON (varies by docker compose version).
+ */
+declare function composePs(executor: DockerVerifyExecutor, config: ComposeConfig): ContainerInfo[];
+//#endregion
+//#region src/docker-verify/health.d.ts
+/** Look up the health status of a specific service from container info. */
+declare function getContainerHealth(containers: ContainerInfo[], serviceName: string): string;
+/** Run a single HTTP health check, returning true if the validator passes. */
+declare function checkHttpHealth(executor: DockerVerifyExecutor, check: HttpHealthCheck): Promise<boolean>;
+//#endregion
+export { type ComposeConfig, type ContainerInfo, type DockerVerifyExecutor, type HttpHealthCheck, type VerifyConfig, type VerifyResult, checkHttpHealth, composeCommand, composeDown, composeLogs, composePs, composeUp, createRealExecutor, getContainerHealth, runVerification };

package/dist/index.d.mts

@@ -0,0 +1,104 @@
+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" | "simple" | "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/eslint-plugin oxlint plugin */
+  useEslintPlugin: 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" | "archived";
+  /** 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;
+  /** Remove a file from the target directory (no-op if not found) */
+  remove: (relativePath: 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;
+  hasSimpleReleaseConfig: 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bensandee/tooling",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "description": "CLI tool to bootstrap and maintain standardized TypeScript project tooling",
   "bin": {
     "tooling": "./dist/bin.mjs"
@@ -14,9 +14,15 @@
     "#src/*.ts": "./src/*.ts"
   },
   "exports": {
-    ".": "./dist/index.mjs",
+    ".": {
+      "types": "./dist/index.d.mts",
+      "default": "./dist/index.mjs"
+    },
     "./bin": "./dist/bin.mjs",
-    "./docker-verify": "./dist/docker-verify/index.mjs",
+    "./docker-verify": {
+      "types": "./dist/docker-verify/index.d.mts",
+      "default": "./dist/docker-verify/index.mjs"
+    },
     "./package.json": "./package.json"
   },
   "publishConfig": {
@@ -29,14 +35,14 @@
     "jsonc-parser": "^3.3.1",
     "yaml": "^2.8.2",
     "zod": "^4.3.6",
-    "@bensandee/common": "0.1.1"
+    "@bensandee/common": "0.1.2"
   },
   "devDependencies": {
     "@types/node": "24.12.0",
-    "tsdown": "0.21.0",
+    "tsdown": "0.21.2",
     "typescript": "5.9.3",
     "vitest": "4.0.18",
-    "@bensandee/config": "0.8.0"
+    "@bensandee/config": "0.8.1"
   },
   "optionalDependencies": {
     "@changesets/cli": "^2.29.4",