@outfitter/tooling 0.2.2 → 0.2.4

package/dist/shared/@outfitter/tooling-t17gnh9b.js

@@ -0,0 +1,78 @@
+// @bun
+// packages/tooling/src/cli/check-bunup-registry.ts
+import { resolve } from "path";
+function extractBunupFilterName(script) {
+  const match = script.match(/bunup\s+--filter\s+(\S+)/);
+  return match?.[1] ?? null;
+}
+function findUnregisteredPackages(packagesWithFilter, registeredNames) {
+  const registered = new Set(registeredNames);
+  const missing = packagesWithFilter.filter((name) => !registered.has(name)).sort();
+  return {
+    ok: missing.length === 0,
+    missing
+  };
+}
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  dim: "\x1B[2m"
+};
+async function runCheckBunupRegistry() {
+  const cwd = process.cwd();
+  const configPath = resolve(cwd, "bunup.config.ts");
+  let registeredNames;
+  try {
+    const configModule = await import(configPath);
+    const rawConfig = configModule.default;
+    if (!Array.isArray(rawConfig)) {
+      process.stderr.write(`bunup.config.ts must export a workspace array
+`);
+      process.exit(1);
+    }
+    registeredNames = rawConfig.map((entry) => entry.name);
+  } catch {
+    process.stderr.write(`Could not load bunup.config.ts from ${cwd}
+`);
+    process.exit(1);
+  }
+  const packagesWithFilter = [];
+  const glob = new Bun.Glob("{packages,apps}/*/package.json");
+  for (const match of glob.scanSync({ cwd })) {
+    const pkgPath = resolve(cwd, match);
+    try {
+      const pkg = await Bun.file(pkgPath).json();
+      const buildScript = pkg.scripts?.["build"];
+      if (!buildScript)
+        continue;
+      const filterName = extractBunupFilterName(buildScript);
+      if (filterName) {
+        packagesWithFilter.push(filterName);
+      }
+    } catch {}
+  }
+  const result = findUnregisteredPackages(packagesWithFilter, registeredNames);
+  if (result.ok) {
+    process.stdout.write(`${COLORS.green}All ${packagesWithFilter.length} packages with bunup --filter are registered in bunup.config.ts.${COLORS.reset}
+`);
+    process.exit(0);
+  }
+  process.stderr.write(`${COLORS.red}${result.missing.length} package(s) have bunup --filter build scripts but are not registered in bunup.config.ts:${COLORS.reset}
+
+`);
+  for (const name of result.missing) {
+    process.stderr.write(`  ${COLORS.yellow}${name}${COLORS.reset}  ${COLORS.dim}(missing from workspace array)${COLORS.reset}
+`);
+  }
+  process.stderr.write(`
+Add the missing entries to ${COLORS.blue}bunup.config.ts${COLORS.reset} defineWorkspace array.
+`);
+  process.stderr.write(`Without registration, ${COLORS.dim}bunup --filter <name>${COLORS.reset} silently exits with no output.
+`);
+  process.exit(1);
+}
+
+export { extractBunupFilterName, findUnregisteredPackages, runCheckBunupRegistry };

package/dist/shared/@outfitter/tooling-wesswf21.d.ts

@@ -0,0 +1,59 @@
+/** A package.json map: keys are subpaths, values are conditions or strings */
+type ExportMap = Record<string, unknown>;
+/** Describes drift between expected and actual exports for a single package */
+interface ExportDrift {
+	readonly package: string;
+	readonly path: string;
+	readonly added: string[];
+	readonly removed: string[];
+	readonly changed: Array<{
+		readonly key: string;
+		readonly expected: unknown;
+		readonly actual: unknown;
+	}>;
+}
+/** Per-package comparison result */
+interface PackageResult {
+	readonly name: string;
+	readonly status: "ok" | "drift";
+	readonly drift?: ExportDrift;
+}
+/** Aggregated result across all checked packages */
+interface CheckResult {
+	readonly ok: boolean;
+	readonly packages: PackageResult[];
+}
+/** Input for comparing a single package's exports */
+interface CompareInput {
+	readonly name: string;
+	readonly actual: ExportMap;
+	readonly expected: ExportMap;
+	readonly path?: string;
+}
+/**
+* Convert a source entry file path to its subpath.
+*
+* @example
+* entryToSubpath("src/index.ts")       // "."
+* entryToSubpath("src/branded.ts")     // "./branded"
+* entryToSubpath("src/cli/index.ts")   // "./cli"
+* entryToSubpath("src/cli/check.ts")   // "./cli/check"
+*/
+declare function entryToSubpath(entry: string): string;
+/**
+* Compare actual vs expected exports for a single package.
+*
+* Returns a PackageResult with status "ok" or "drift" and detailed diff.
+*/
+declare function compareExports(input: CompareInput): PackageResult;
+interface CheckExportsOptions {
+	readonly json?: boolean;
+}
+declare function resolveJsonMode(options?: CheckExportsOptions): boolean;
+/**
+* Run check-exports across all workspace packages.
+*
+* Reads the bunup workspace config to discover packages and their * settings, then compares expected vs actual exports in each package.json.
+*/
+declare function runCheckExports(options?: CheckExportsOptions): Promise<void>;
+export { ExportMap, ExportDrift, PackageResult, CheckResult, CompareInput, entryToSubpath, compareExports, CheckExportsOptions, resolveJsonMode, runCheckExports };

package/dist/shared/chunk-3s189drz.js

@@ -0,0 +1,4 @@
+import { createRequire } from "node:module";
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+export { __require };

package/dist/shared/chunk-7tdgbqb0.js

@@ -0,0 +1,197 @@
+import"./chunk-3s189drz.js";
+
+// src/cli/check-readme-imports.ts
+import { resolve } from "node:path";
+function parseSpecifier(specifier) {
+  if (!specifier.startsWith("@outfitter/")) {
+    return null;
+  }
+  const parts = specifier.split("/");
+  if (parts.length < 2) {
+    return null;
+  }
+  const packageName = `${parts[0]}/${parts[1]}`;
+  const rest = parts.slice(2);
+  if (rest.length === 0) {
+    return { packageName, subpath: "." };
+  }
+  return { packageName, subpath: `./${rest.join("/")}` };
+}
+function extractImports(content, file) {
+  const lines = content.split(`
+`);
+  const results = [];
+  const seen = new Set;
+  const CODE_FENCE_OPEN = /^```(?:typescript|ts|javascript|js)\s*$/;
+  const CODE_FENCE_CLOSE = /^```\s*$/;
+  const IMPORT_RE = /from\s+["'](@outfitter\/[^"']+)["']/;
+  const NON_CONTRACTUAL = /<!--\s*non-contractual\s*-->/;
+  let inCodeBlock = false;
+  let skipBlock = false;
+  for (let i = 0;i < lines.length; i++) {
+    const line = lines[i];
+    if (!inCodeBlock) {
+      if (CODE_FENCE_OPEN.test(line)) {
+        inCodeBlock = true;
+        skipBlock = false;
+        for (let j = i - 1;j >= 0; j--) {
+          const prev = lines[j].trim();
+          if (prev === "")
+            continue;
+          if (NON_CONTRACTUAL.test(prev)) {
+            skipBlock = true;
+          }
+          break;
+        }
+      }
+      continue;
+    }
+    if (CODE_FENCE_CLOSE.test(line) && !CODE_FENCE_OPEN.test(line)) {
+      inCodeBlock = false;
+      skipBlock = false;
+      continue;
+    }
+    if (skipBlock)
+      continue;
+    const match = IMPORT_RE.exec(line);
+    if (!match?.[1])
+      continue;
+    const fullSpecifier = match[1];
+    if (seen.has(fullSpecifier))
+      continue;
+    seen.add(fullSpecifier);
+    const parsed = parseSpecifier(fullSpecifier);
+    if (!parsed)
+      continue;
+    results.push({
+      packageName: parsed.packageName,
+      subpath: parsed.subpath,
+      fullSpecifier,
+      file,
+      line: i + 1
+    });
+  }
+  return results;
+}
+function isExportedSubpath(subpath, exports) {
+  return subpath in exports;
+}
+var COLORS = {
+  reset: "\x1B[0m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  dim: "\x1B[2m"
+};
+function resolveJsonMode(options = {}) {
+  return options.json ?? process.env["OUTFITTER_JSON"] === "1";
+}
+async function runCheckReadmeImports(options = {}) {
+  const cwd = process.cwd();
+  const readmeGlob = new Bun.Glob("**/README.md");
+  const readmeDirs = ["packages", "docs/packages"];
+  const readmePaths = [];
+  for (const dir of readmeDirs) {
+    const fullDir = resolve(cwd, dir);
+    try {
+      for (const match of readmeGlob.scanSync({ cwd: fullDir, dot: false })) {
+        const segments = match.split("/");
+        if (segments.length === 2 && segments[1] === "README.md") {
+          readmePaths.push(resolve(fullDir, match));
+        }
+      }
+    } catch {}
+  }
+  if (readmePaths.length === 0) {
+    process.stdout.write(`No README.md files found.
+`);
+    return;
+  }
+  const exportsCache = new Map;
+  async function getExportsForPackage(packageName) {
+    if (exportsCache.has(packageName)) {
+      return exportsCache.get(packageName) ?? null;
+    }
+    const shortName = packageName.replace("@outfitter/", "");
+    const pkgPath = resolve(cwd, "packages", shortName, "package.json");
+    try {
+      const pkg = await Bun.file(pkgPath).json();
+      const exports = typeof pkg.exports === "object" && pkg.exports !== null ? pkg.exports : {};
+      exportsCache.set(packageName, exports);
+      return exports;
+    } catch {
+      return null;
+    }
+  }
+  const results = [];
+  let hasInvalid = false;
+  for (const readmePath of readmePaths.sort()) {
+    const content = await Bun.file(readmePath).text();
+    const relativePath = readmePath.replace(`${cwd}/`, "");
+    const imports = extractImports(content, relativePath);
+    if (imports.length === 0)
+      continue;
+    const valid = [];
+    const invalid = [];
+    for (const imp of imports) {
+      const exports = await getExportsForPackage(imp.packageName);
+      if (exports === null) {
+        invalid.push(imp);
+        continue;
+      }
+      if (isExportedSubpath(imp.subpath, exports)) {
+        valid.push(imp);
+      } else {
+        invalid.push(imp);
+      }
+    }
+    if (valid.length > 0 || invalid.length > 0) {
+      results.push({ file: relativePath, valid, invalid });
+    }
+    if (invalid.length > 0) {
+      hasInvalid = true;
+    }
+  }
+  if (resolveJsonMode(options)) {
+    const output = {
+      ok: !hasInvalid,
+      files: results
+    };
+    process.stdout.write(`${JSON.stringify(output, null, 2)}
+`);
+  } else {
+    const totalValid = results.reduce((n, r) => n + r.valid.length, 0);
+    const totalInvalid = results.reduce((n, r) => n + r.invalid.length, 0);
+    if (!hasInvalid) {
+      process.stdout.write(`${COLORS.green}All ${totalValid} README import examples match package exports.${COLORS.reset}
+`);
+    } else {
+      process.stderr.write(`${COLORS.red}Invalid README import examples found:${COLORS.reset}
+
+`);
+      for (const result of results) {
+        if (result.invalid.length === 0)
+          continue;
+        process.stderr.write(`  ${COLORS.yellow}${result.file}${COLORS.reset}
+`);
+        for (const imp of result.invalid) {
+          process.stderr.write(`    ${COLORS.red}line ${imp.line}:${COLORS.reset} ${imp.fullSpecifier}  ${COLORS.dim}(subpath ${imp.subpath} not in ${imp.packageName} exports)${COLORS.reset}
+`);
+        }
+        process.stderr.write(`
+`);
+      }
+      process.stderr.write(`${totalInvalid} invalid, ${totalValid} valid across ${results.length} file(s).
+`);
+    }
+  }
+  process.exit(hasInvalid ? 1 : 0);
+}
+export {
+  runCheckReadmeImports,
+  resolveJsonMode,
+  parseSpecifier,
+  isExportedSubpath,
+  extractImports
+};

package/dist/shared/chunk-8aenrm6f.js

@@ -0,0 +1,18 @@
+// src/version.ts
+import { readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+var DEFAULT_VERSION = "0.0.0";
+function readPackageVersion() {
+  try {
+    const require2 = createRequire(import.meta.url);
+    const pkgPath = require2.resolve("@outfitter/tooling/package.json");
+    const packageJson = JSON.parse(readFileSync(pkgPath, "utf8"));
+    if (typeof packageJson.version === "string" && packageJson.version.length > 0) {
+      return packageJson.version;
+    }
+  } catch {}
+  return DEFAULT_VERSION;
+}
+var VERSION = readPackageVersion();
+
+export { VERSION };

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+import { VERSION } from "./shared/@outfitter/tooling-9vs606gq";
+export { VERSION };

package/dist/version.js

@@ -0,0 +1,8 @@
+// @bun
+import {
+  VERSION
+} from "./shared/@outfitter/tooling-ctmgnap5.js";
+import"./shared/@outfitter/tooling-dvwh9qve.js";
+export {
+  VERSION
+};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@outfitter/tooling",
 	"description": "Dev tooling configuration presets for Outfitter projects (biome, typescript, lefthook, markdownlint)",
-	"version": "0.2.2",
+	"version": "0.2.4",
 	"type": "module",
 	"files": [
 		"dist",
@@ -21,16 +21,14 @@
 				"default": "./dist/index.js"
 			}
 		},
-		"./registry": {
-			"import": {
-				"types": "./dist/index.d.ts",
-				"default": "./dist/index.js"
-			}
-		},
-		"./cli/init": {
+		"./.markdownlint-cli2": "./.markdownlint-cli2.jsonc",
+		"./.markdownlint-cli2.jsonc": "./.markdownlint-cli2.jsonc",
+		"./biome": "./biome.json",
+		"./biome.json": "./biome.json",
+		"./cli/check": {
 			"import": {
-				"types": "./dist/cli/init.d.ts",
-				"default": "./dist/cli/init.js"
+				"types": "./dist/cli/check.d.ts",
+				"default": "./dist/cli/check.js"
 			}
 		},
 		"./cli/fix": {
@@ -39,23 +37,25 @@
 				"default": "./dist/cli/fix.js"
 			}
 		},
-		"./cli/check": {
+		"./cli/init": {
 			"import": {
-				"types": "./dist/cli/check.d.ts",
-				"default": "./dist/cli/check.js"
+				"types": "./dist/cli/init.d.ts",
+				"default": "./dist/cli/init.js"
 			}
 		},
+		"./lefthook": "./lefthook.yml",
+		"./lefthook.yml": "./lefthook.yml",
 		"./package.json": "./package.json",
-		"./biome": "./biome.json",
-		"./biome.json": "./biome.json",
+		"./registry": {
+			"import": {
+				"types": "./dist/registry/index.d.ts",
+				"default": "./dist/registry/index.js"
+			}
+		},
 		"./tsconfig": "./tsconfig.preset.json",
-		"./tsconfig.preset.json": "./tsconfig.preset.json",
 		"./tsconfig-bun": "./tsconfig.preset.bun.json",
 		"./tsconfig.preset.bun.json": "./tsconfig.preset.bun.json",
-		"./lefthook": "./lefthook.yml",
-		"./lefthook.yml": "./lefthook.yml",
-		"./.markdownlint-cli2": "./.markdownlint-cli2.jsonc",
-		"./.markdownlint-cli2.jsonc": "./.markdownlint-cli2.jsonc"
+		"./tsconfig.preset.json": "./tsconfig.preset.json"
 	},
 	"bin": {
 		"tooling": "./dist/cli/index.js"
@@ -64,16 +64,19 @@
 	"scripts": {
 		"build:registry": "bun run src/registry/build.ts",
 		"sync:exports": "bun run scripts/sync-exports.ts",
-		"prebuild": "bun run build:registry && bun run sync:exports",
+		"sync:exports:check": "bun run scripts/sync-exports.ts --check",
+		"prebuild": "bun run build:registry && bun run sync:exports:check",
 		"build": "bunup --filter @outfitter/tooling",
 		"prepack": "bun run sync:exports",
 		"lint": "biome lint ./src",
 		"lint:fix": "biome lint --write ./src",
 		"test": "bun test",
 		"typecheck": "tsc --noEmit",
-		"clean": "rm -rf dist registry"
+		"clean": "rm -rf dist registry",
+		"prepublishOnly": "bun ../../scripts/check-publish-manifest.ts"
 	},
 	"dependencies": {
+		"@outfitter/cli": "0.5.1",
 		"commander": "^14.0.2",
 		"zod": "^3.25.17"
 	},

package/registry/registry.json

@@ -7,7 +7,7 @@
 			"files": [
 				{
 					"path": ".claude/settings.json",
-					"content": "{\n  \"hooks\": {\n    \"SessionStart\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/scripts/bootstrap.sh\\\"\",\n            \"timeout\": 120\n          }\n        ]\n      }\n    ],\n    \"Stop\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/.claude/hooks/format-code-on-stop.sh\\\"\",\n            \"timeout\": 60\n          }\n        ]\n      }\n    ]\n  },\n  \"enabledPlugins\": {\n    \"outfitter@outfitter\": true,\n    \"team@outfitter\": true,\n    \"kit@outfitter\": true\n  },\n  \"extraKnownMarketplaces\": {\n    \"outfitter\": {\n      \"source\": {\n        \"source\": \"github\",\n        \"repo\": \"outfitter/outfitter\"\n      }\n    }\n  }\n}\n"
+					"content": "{\n  \"hooks\": {\n    \"SessionStart\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/scripts/bootstrap.sh\\\"\",\n            \"timeout\": 120\n          }\n        ]\n      }\n    ],\n    \"Stop\": [\n      {\n        \"matcher\": \"*\",\n        \"hooks\": [\n          {\n            \"type\": \"command\",\n            \"command\": \"bash \\\"$CLAUDE_PROJECT_DIR/.claude/hooks/format-code-on-stop.sh\\\"\",\n            \"timeout\": 60\n          }\n        ]\n      }\n    ]\n  },\n  \"enabledPlugins\": {},\n  \"extraKnownMarketplaces\": {}\n}\n"
 				},
 				{
 					"path": ".claude/hooks/format-code-on-stop.sh",