@pracht/cli 1.1.5 → 1.2.0

package/{lib/manifest.js → src/manifest.ts}

@@ -1,4 +1,4 @@
-export function ensureCoreNamedImport(source, name) {
+export function ensureCoreNamedImport(source: string, name: string): string {
   const match = source.match(/import\s*\{([^}]+)\}\s*from\s*["']@pracht\/core["'];?/);
   if (!match) {
     return `import { ${name} } from "@pracht/core";\n${source}`;
@@ -15,7 +15,7 @@ export function ensureCoreNamedImport(source, name) {
   return source.replace(match[0], `import { ${names.join(", ")} } from "@pracht/core";`);
 }
 
-export function upsertObjectEntry(source, key, entry) {
+export function upsertObjectEntry(source: string, key: string, entry: string): string {
   const property = findNamedBlock(source, key, "{", "}");
   if (!property) {
     const routesMatch = source.match(/^(\s*)routes\s*:/m);
@@ -31,7 +31,7 @@ export function upsertObjectEntry(source, key, entry) {
   return insertBlockEntry(source, property, entry);
 }
 
-export function insertArrayItem(source, key, item) {
+export function insertArrayItem(source: string, key: string, item: string): string {
   const property = findNamedBlock(source, key, "[", "]");
   if (!property) {
     throw new Error(`Could not find "${key}" in the app manifest.`);
@@ -40,7 +40,7 @@ export function insertArrayItem(source, key, item) {
   return insertBlockEntry(source, property, item);
 }
 
-export function toManifestModulePath(manifestPath, targetFilePath) {
+export function toManifestModulePath(manifestPath: string, targetFilePath: string): string {
   const relativePath = targetFilePath
     .replaceAll("\\", "/")
     .replace(manifestPath.replaceAll("\\", "/").replace(/\/[^/]+$/, ""), "")
@@ -49,11 +49,14 @@ export function toManifestModulePath(manifestPath, targetFilePath) {
   return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
 }
 
-export function extractRegistryEntries(source, key) {
+export function extractRegistryEntries(
+  source: string,
+  key: string,
+): { name: string; path: string }[] {
   const block = findNamedBlock(source, key, "{", "}");
   if (!block) return [];
   const inner = source.slice(block.openIndex + 1, block.closeIndex);
-  const entries = [];
+  const entries: { name: string; path: string }[] = [];
   const pattern =
     /([A-Za-z0-9_-]+)\s*:\s*(?:(["'`])([^"'`]+)\2|\(\)\s*=>\s*import\(\s*(["'`])([^"'`]+)\4\s*\))/g;
 
@@ -64,15 +67,21 @@ export function extractRegistryEntries(source, key) {
   return entries;
 }
 
-export function extractRelativeModulePaths(source) {
-  const results = new Set();
+export function extractRelativeModulePaths(source: string): Set<string> {
+  const results = new Set<string>();
   for (const match of source.matchAll(/["'`]((?:\.\.\/|\.\/)[^"'`]+)["'`]/g)) {
     results.add(match[1]);
   }
   return results;
 }
 
-function insertBlockEntry(source, block, entry) {
+interface BlockLocation {
+  closeIndex: number;
+  indent: string;
+  openIndex: number;
+}
+
+function insertBlockEntry(source: string, block: BlockLocation, entry: string): string {
   const inner = source.slice(block.openIndex + 1, block.closeIndex);
   const closingIndent = block.indent;
   const childIndent = `${closingIndent}  `;
@@ -87,7 +96,12 @@ function insertBlockEntry(source, block, entry) {
   return `${source.slice(0, block.closeIndex)}${insertPrefix}\n${indentMultiline(entry, childIndent)}\n${closingIndent}${source.slice(block.closeIndex)}`;
 }
 
-function findNamedBlock(source, key, openChar, closeChar) {
+function findNamedBlock(
+  source: string,
+  key: string,
+  openChar: string,
+  closeChar: string,
+): BlockLocation | null {
   const pattern = new RegExp(`^([ \\t]*)${key}\\s*:\\s*\\${openChar}`, "m");
   const match = source.match(pattern);
   if (!match || match.index == null) {
@@ -103,9 +117,14 @@ function findNamedBlock(source, key, openChar, closeChar) {
   };
 }
 
-function findMatchingDelimiter(source, openIndex, openChar, closeChar) {
+function findMatchingDelimiter(
+  source: string,
+  openIndex: number,
+  openChar: string,
+  closeChar: string,
+): number {
   let depth = 0;
-  let quoteChar = null;
+  let quoteChar: string | null = null;
   let escaping = false;
 
   for (let index = openIndex; index < source.length; index += 1) {
@@ -139,7 +158,7 @@ function findMatchingDelimiter(source, openIndex, openChar, closeChar) {
   throw new Error(`Could not find matching ${closeChar} for ${openChar}.`);
 }
 
-function indentMultiline(value, indent) {
+function indentMultiline(value: string, indent: string): string {
   return value
     .split("\n")
     .map((line) => `${indent}${line}`)

package/{lib/project.js → src/project.ts}

@@ -1,16 +1,33 @@
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { basename, dirname, relative, resolve } from "node:path";
 
-import { ensureTrailingNewline } from "./cli.js";
+import { ensureTrailingNewline } from "./utils.js";
 import { PROJECT_DEFAULTS } from "./constants.js";
 
-export function readProjectConfig(root) {
+export interface ProjectConfig {
+  apiDir: string;
+  appFile: string;
+  configFile: string | null;
+  hasPrachtPlugin: boolean;
+  middlewareDir: string;
+  mode: "manifest" | "pages";
+  pagesDefaultRender: string;
+  pagesDir: string;
+  rawConfig: string;
+  root: string;
+  routesDir: string;
+  serverDir: string;
+  shellsDir: string;
+}
+
+export function readProjectConfig(root: string): ProjectConfig {
   const configFile = findConfigFile(root);
   const rawConfig = configFile ? readFileSync(configFile, "utf-8") : "";
-  const config = {
+  const config: Record<string, unknown> = {
     ...PROJECT_DEFAULTS,
     configFile,
     hasPrachtPlugin: /\bpracht\s*\(/.test(rawConfig),
+    mode: "manifest" as const,
     rawConfig,
     root,
   };
@@ -23,18 +40,22 @@ export function readProjectConfig(root) {
   }
 
   config.mode = config.pagesDir ? "pages" : "manifest";
-  return config;
+  return config as unknown as ProjectConfig;
 }
 
-export function resolveProjectPath(root, configPath) {
+export function resolveProjectPath(root: string, configPath: string): string {
   return resolve(root, `.${configPath}`);
 }
 
-export function resolveScopedFile(root, configDir, fileName) {
+export function resolveScopedFile(root: string, configDir: string, fileName: string): string {
   return resolve(resolveProjectPath(root, configDir), fileName);
 }
 
-export function resolveRouteModulePath(project, routePath, extension) {
+export function resolveRouteModulePath(
+  project: ProjectConfig,
+  routePath: string,
+  extension: string,
+): { absolutePath: string; relativePath: string } {
   const segments = segmentsFromRoutePath(routePath);
   const relativePath =
     segments.length === 0 ? `index${extension}` : `${segments.join("/")}${extension}`;
@@ -42,7 +63,11 @@ export function resolveRouteModulePath(project, routePath, extension) {
   return { absolutePath, relativePath };
 }
 
-export function resolvePagesRouteModulePath(project, routePath, extension) {
+export function resolvePagesRouteModulePath(
+  project: ProjectConfig,
+  routePath: string,
+  extension: string,
+): { absolutePath: string; relativePath: string } {
   const segments = segmentsFromRoutePath(routePath);
   const relativePath =
     segments.length === 0 ? `index${extension}` : `${segments.join("/")}${extension}`;
@@ -50,18 +75,21 @@ export function resolvePagesRouteModulePath(project, routePath, extension) {
   return { absolutePath, relativePath };
 }
 
-export function resolveApiModulePath(project, endpointPath) {
+export function resolveApiModulePath(
+  project: ProjectConfig,
+  endpointPath: string,
+): { absolutePath: string; relativePath: string } {
   const segments = segmentsFromApiPath(endpointPath);
   const relativePath = segments.length === 0 ? "index.ts" : `${segments.join("/")}.ts`;
   const absolutePath = resolve(resolveProjectPath(project.root, project.apiDir), relativePath);
   return { absolutePath, relativePath };
 }
 
-export function displayPath(root, filePath) {
+export function displayPath(root: string, filePath: string): string {
   return relative(root, filePath) || ".";
 }
 
-export function writeGeneratedFile(filePath, source) {
+export function writeGeneratedFile(filePath: string, source: string): void {
   if (existsSync(filePath)) {
     throw new Error(`Refusing to overwrite existing file ${filePath}.`);
   }
@@ -70,14 +98,14 @@ export function writeGeneratedFile(filePath, source) {
   writeFileSync(filePath, ensureTrailingNewline(source), "utf-8");
 }
 
-export function assertFileExists(filePath, message) {
+export function assertFileExists(filePath: string, message: string): void {
   if (!existsSync(filePath)) {
     throw new Error(message);
   }
 }
 
-export function listFilesRecursively(dir) {
-  const files = [];
+export function listFilesRecursively(dir: string): string[] {
+  const files: string[] = [];
   for (const entry of readdirSync(dir, { withFileTypes: true })) {
     const fullPath = resolve(dir, entry.name);
     if (entry.isDirectory()) {
@@ -89,11 +117,11 @@ export function listFilesRecursively(dir) {
   return files;
 }
 
-export function hasPagesAppShell(filePath) {
+export function hasPagesAppShell(filePath: string): boolean {
   return /^_app\.(ts|tsx|js|jsx)$/.test(basename(filePath));
 }
 
-function findConfigFile(root) {
+function findConfigFile(root: string): string | null {
   for (const name of [
     "vite.config.ts",
     "vite.config.mts",
@@ -108,19 +136,19 @@ function findConfigFile(root) {
   return null;
 }
 
-function readQuotedConfigValue(source, key) {
+function readQuotedConfigValue(source: string, key: string): string | null {
   if (!source) return null;
   const pattern = new RegExp(`${key}\\s*:\\s*(["'\\\`])([^"'\\\`]+)\\1`);
   const match = source.match(pattern);
   return match ? match[2] : null;
 }
 
-function normalizeConfigPath(value) {
+function normalizeConfigPath(value: string): string {
   if (!value) return value;
   return value.startsWith("/") ? value : `/${value}`;
 }
 
-function segmentsFromRoutePath(routePath) {
+function segmentsFromRoutePath(routePath: string): string[] {
   return routePath
     .split("/")
     .filter(Boolean)
@@ -131,7 +159,7 @@ function segmentsFromRoutePath(routePath) {
     });
 }
 
-function segmentsFromApiPath(endpointPath) {
+function segmentsFromApiPath(endpointPath: string): string[] {
   return endpointPath
     .split("/")
     .filter(Boolean)

package/src/utils.ts

@@ -0,0 +1,72 @@
+import { HTTP_METHODS, type HttpMethod } from "./constants.js";
+
+export function quote(value: string): string {
+  return JSON.stringify(value);
+}
+
+export function ensureTrailingNewline(value: string): string {
+  return value.endsWith("\n") ? value : `${value}\n`;
+}
+
+export function parseCommaList(value: string | string[] | boolean | undefined): string[] {
+  if (!value || typeof value === "boolean") return [];
+  const values = Array.isArray(value) ? value : [value];
+  return values
+    .flatMap((entry) => String(entry).split(","))
+    .map((entry) => entry.trim())
+    .filter(Boolean);
+}
+
+export function parseApiMethods(value: string | string[] | boolean | undefined): HttpMethod[] {
+  const methods = parseCommaList(value);
+  const normalized =
+    methods.length === 0
+      ? (["GET"] as HttpMethod[])
+      : methods.map((entry) => entry.toUpperCase() as HttpMethod);
+
+  for (const method of normalized) {
+    if (!HTTP_METHODS.has(method)) {
+      throw new Error(`Unsupported HTTP method "${method}".`);
+    }
+  }
+
+  return [...new Set(normalized)];
+}
+
+export function requireEnum(
+  value: string | undefined,
+  key: string,
+  allowed: string[],
+  fallback: string,
+): string {
+  const val = value ?? fallback;
+  if (!allowed.includes(val)) {
+    throw new Error(`Invalid value for --${key}. Expected one of ${allowed.join(", ")}.`);
+  }
+  return val;
+}
+
+export function requirePositiveInteger(
+  value: string | undefined,
+  key: string,
+  fallback: number,
+): number {
+  const parsed = value == null ? fallback : Number.parseInt(value, 10);
+  if (!Number.isInteger(parsed) || parsed <= 0) {
+    throw new Error(`--${key} must be a positive integer.`);
+  }
+  return parsed;
+}
+
+export function handleCliError(error: unknown, { json }: { json: boolean }): never {
+  const message = error instanceof Error ? error.message : String(error);
+  if (json) {
+    console.error(JSON.stringify({ ok: false, error: message }, null, 2));
+  } else {
+    console.error(message);
+    if (error instanceof Error && error.stack && process.env.DEBUG) {
+      console.error(error.stack);
+    }
+  }
+  process.exit(1);
+}

package/{lib/verification.js → src/verification.ts}

@@ -9,6 +9,7 @@ import {
   listFilesRecursively,
   readProjectConfig,
   resolveProjectPath,
+  type ProjectConfig,
 } from "./project.js";
 
 const CONFIG_FILE_NAMES = new Set([
@@ -23,7 +24,30 @@ const CONFIG_FILE_NAMES = new Set([
 const MODULE_SOURCE_RE = /\.(ts|tsx|js|jsx)$/;
 const PAGE_SOURCE_RE = /\.(ts|tsx|js|jsx|md|mdx)$/;
 
-export function runDoctor(root) {
+export interface Check {
+  message: string;
+  status: "ok" | "warning" | "error";
+}
+
+export interface DoctorReport {
+  checks: Check[];
+  configFile: string | null;
+  mode: "manifest" | "pages";
+  ok: boolean;
+}
+
+export interface VerificationReport {
+  changedFiles: string[];
+  checks: Check[];
+  configFile: string | null;
+  frameworkFiles: string[];
+  mode: "manifest" | "pages";
+  ok: boolean;
+  requestedScope: string;
+  scope: string;
+}
+
+export function runDoctor(root: string): DoctorReport {
   const report = runVerification(root);
 
   return {
@@ -34,9 +58,12 @@ export function runDoctor(root) {
   };
 }
 
-export function runVerification(root, options = {}) {
+export function runVerification(
+  root: string,
+  options: { changed?: boolean } = {},
+): VerificationReport {
   const project = readProjectConfig(root);
-  const checks = [];
+  const checks: Check[] = [];
   const packageJsonPath = resolve(project.root, "package.json");
   const configDisplayPath = project.configFile
     ? displayPath(root, project.configFile)
@@ -45,7 +72,7 @@ export function runVerification(root, options = {}) {
 
   collectConfigChecks(project, checks, configDisplayPath);
 
-  let changedInfo = {
+  let changedInfo: { files: string[]; warning: string | null } = {
     files: [],
     warning: null,
   };
@@ -92,7 +119,11 @@ export function runVerification(root, options = {}) {
   };
 }
 
-function collectConfigChecks(project, checks, configDisplayPath) {
+function collectConfigChecks(
+  project: ProjectConfig,
+  checks: Check[],
+  configDisplayPath: string,
+): void {
   if (!project.configFile) {
     checks.push(createCheck("error", "Missing vite config."));
   } else {
@@ -106,7 +137,11 @@ function collectConfigChecks(project, checks, configDisplayPath) {
   }
 }
 
-function collectManifestVerification(project, checks, { changedFiles, scope }) {
+function collectManifestVerification(
+  project: ProjectConfig,
+  checks: Check[],
+  { changedFiles, scope }: { changedFiles: string[]; scope: string },
+): void {
   const manifestPath = resolveProjectPath(project.root, project.appFile);
   if (!existsSync(manifestPath)) {
     checks.push(createCheck("error", `App manifest is missing at ${project.appFile}.`));
@@ -187,12 +222,12 @@ function collectManifestVerification(project, checks, { changedFiles, scope }) {
 }
 
 function collectChangedManifestModuleChecks(
-  project,
-  checks,
-  manifestPath,
-  relativeModules,
-  changedFiles,
-) {
+  project: ProjectConfig,
+  checks: Check[],
+  manifestPath: string,
+  relativeModules: string[],
+  changedFiles: string[],
+): void {
   const manifestDir = dirname(manifestPath);
   const referencedModules = new Set(relativeModules.map(normalizePath));
   const moduleDirectories = [
@@ -241,7 +276,11 @@ function collectChangedManifestModuleChecks(
   }
 }
 
-function collectPagesVerification(project, checks, { changedFiles, scope }) {
+function collectPagesVerification(
+  project: ProjectConfig,
+  checks: Check[],
+  { changedFiles, scope }: { changedFiles: string[]; scope: string },
+): void {
   const pagesDir = resolveProjectPath(project.root, project.pagesDir);
   if (!existsSync(pagesDir)) {
     checks.push(createCheck("error", `Pages directory is missing at ${project.pagesDir}.`));
@@ -250,7 +289,7 @@ function collectPagesVerification(project, checks, { changedFiles, scope }) {
 
   const pages = scanPagesDirectory(pagesDir);
   const routes = pages.filter((page) => page.kind === "route");
-  const duplicates = collectDuplicateRoutePaths(routes).map((entry) => ({
+  const duplicates = collectDuplicateRoutePaths(routes as PagesRoute[]).map((entry) => ({
     ...entry,
     files: entry.files.map((file) => displayPath(project.root, file)),
   }));
@@ -298,7 +337,12 @@ function collectPagesVerification(project, checks, { changedFiles, scope }) {
   }
 }
 
-function collectChangedPagesChecks(project, checks, pagesDir, changedFiles) {
+function collectChangedPagesChecks(
+  project: ProjectConfig,
+  checks: Check[],
+  pagesDir: string,
+  changedFiles: string[],
+): void {
   for (const file of changedFiles) {
     if (!isWithinDirectory(file, pagesDir)) continue;
     if (!PAGE_SOURCE_RE.test(file)) continue;
@@ -344,7 +388,11 @@ function collectChangedPagesChecks(project, checks, pagesDir, changedFiles) {
   }
 }
 
-function collectApiVerification(project, checks, { changedFiles, scope }) {
+function collectApiVerification(
+  project: ProjectConfig,
+  checks: Check[],
+  { changedFiles, scope }: { changedFiles: string[]; scope: string },
+): void {
   const apiDir = resolveProjectPath(project.root, project.apiDir);
   const changedApiFiles = changedFiles.filter((file) => isWithinDirectory(file, apiDir));
   if (scope === "changed" && changedApiFiles.length === 0) {
@@ -364,7 +412,7 @@ function collectApiVerification(project, checks, { changedFiles, scope }) {
   }
 
   const apiFiles = listFilesRecursively(apiDir).filter((file) => MODULE_SOURCE_RE.test(file));
-  const routeMap = new Map();
+  const routeMap = new Map<string, string[]>();
 
   for (const file of apiFiles) {
     const routePath = resolveApiRoutePath(apiDir, file);
@@ -422,14 +470,18 @@ function collectApiVerification(project, checks, { changedFiles, scope }) {
   }
 }
 
-function collectPackageChecks(project, checks, packageJsonPath) {
+function collectPackageChecks(
+  project: ProjectConfig,
+  checks: Check[],
+  packageJsonPath: string,
+): void {
   if (!existsSync(packageJsonPath)) {
     checks.push(createCheck("warning", "No package.json found in the current app root."));
     return;
   }
 
   const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-  const deps = {
+  const deps: Record<string, string> = {
     ...packageJson.dependencies,
     ...packageJson.devDependencies,
   };
@@ -455,7 +507,7 @@ function collectPackageChecks(project, checks, packageJsonPath) {
   }
 }
 
-function collectChangedFiles(root) {
+function collectChangedFiles(root: string): { files: string[]; warning: string | null } {
   try {
     const repoRoot = execFileSync("git", ["rev-parse", "--show-toplevel"], {
       cwd: root,
@@ -469,7 +521,7 @@ function collectChangedFiles(root) {
       cwd: repoRoot,
       encoding: "utf-8",
     });
-    const files = new Set();
+    const files = new Set<string>();
 
     for (const line of output.split(/\r?\n/).filter(Boolean)) {
       const record = line.slice(3);
@@ -496,7 +548,12 @@ function collectChangedFiles(root) {
   }
 }
 
-function addChangedFile(files, repoRoot, prefix, repoRelativePath) {
+function addChangedFile(
+  files: Set<string>,
+  repoRoot: string,
+  prefix: string,
+  repoRelativePath: string,
+): void {
   if (prefix && !repoRelativePath.startsWith(prefix)) {
     return;
   }
@@ -509,7 +566,11 @@ function addChangedFile(files, repoRoot, prefix, repoRelativePath) {
   files.add(resolve(repoRoot, projectRelativePath));
 }
 
-function filterFrameworkFiles(project, files, packageJsonPath) {
+function filterFrameworkFiles(
+  project: ProjectConfig,
+  files: string[],
+  packageJsonPath: string,
+): string[] {
   const appFile = resolveProjectPath(project.root, project.appFile);
   const routesDir = resolveProjectPath(project.root, project.routesDir);
   const shellsDir = resolveProjectPath(project.root, project.shellsDir);
@@ -532,7 +593,7 @@ function filterFrameworkFiles(project, files, packageJsonPath) {
   });
 }
 
-function requiresFullVerification(project, changedFiles) {
+function requiresFullVerification(project: ProjectConfig, changedFiles: string[]): boolean {
   const packageJsonPath = resolve(project.root, "package.json");
   const appFile = resolveProjectPath(project.root, project.appFile);
 
@@ -545,13 +606,21 @@ function requiresFullVerification(project, changedFiles) {
   });
 }
 
-function scanPagesDirectory(pagesDir) {
+type PagesFile = { file: string; kind: "shell" } | { file: string; kind: "ignored" } | PagesRoute;
+
+interface PagesRoute {
+  file: string;
+  kind: "route";
+  routePath: string;
+}
+
+function scanPagesDirectory(pagesDir: string): PagesFile[] {
   return listFilesRecursively(pagesDir)
     .filter((file) => PAGE_SOURCE_RE.test(file))
     .map((file) => describePagesFile(pagesDir, file));
 }
 
-function describePagesFile(pagesDir, file) {
+function describePagesFile(pagesDir: string, file: string): PagesFile {
   const relativePath = relative(pagesDir, file).replace(/\\/g, "/");
   const routePath = relativePath.replace(/\.(tsx?|jsx?|mdx?)$/, "");
   const name = basename(routePath);
@@ -580,8 +649,8 @@ function describePagesFile(pagesDir, file) {
   };
 }
 
-function collectDuplicateRoutePaths(routes) {
-  const routeMap = new Map();
+function collectDuplicateRoutePaths(routes: PagesRoute[]): { files: string[]; path: string }[] {
+  const routeMap = new Map<string, string[]>();
 
   for (const route of routes) {
     const files = routeMap.get(route.routePath) ?? [];
@@ -594,7 +663,7 @@ function collectDuplicateRoutePaths(routes) {
     .map(([path, files]) => ({ files, path }));
 }
 
-function resolveApiRoutePath(apiDir, file) {
+function resolveApiRoutePath(apiDir: string, file: string): string {
   let relativePath = relative(apiDir, file).replace(/\\/g, "/");
   relativePath = relativePath.replace(/\.(ts|tsx|js|jsx)$/, "");
 
@@ -609,7 +678,7 @@ function resolveApiRoutePath(apiDir, file) {
   return normalizeRoutePath(relativePath ? `/api/${relativePath}` : "/api");
 }
 
-function toModuleSpecifier(fromDir, filePath) {
+function toModuleSpecifier(fromDir: string, filePath: string): string {
   const relativePath = relative(fromDir, filePath).replace(/\\/g, "/");
   if (relativePath.startsWith(".")) {
     return relativePath;
@@ -617,7 +686,7 @@ function toModuleSpecifier(fromDir, filePath) {
   return `./${relativePath}`;
 }
 
-function normalizeRoutePath(path) {
+function normalizeRoutePath(path: string): string {
   if (!path || path === "/") {
     return "/";
   }
@@ -627,15 +696,15 @@ function normalizeRoutePath(path) {
   return collapsed.length > 1 && collapsed.endsWith("/") ? collapsed.slice(0, -1) : collapsed;
 }
 
-function isWithinDirectory(filePath, directoryPath) {
+function isWithinDirectory(filePath: string, directoryPath: string): boolean {
   const relativePath = relative(directoryPath, filePath);
   return relativePath === "" || (!relativePath.startsWith("..") && !relativePath.startsWith("../"));
 }
 
-function normalizePath(value) {
+function normalizePath(value: string): string {
   return value.replace(/\\/g, "/");
 }
 
-function createCheck(status, message) {
+function createCheck(status: Check["status"], message: string): Check {
   return { message, status };
 }

package/tsdown.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+  clean: true,
+  entry: ["src/index.ts"],
+  format: "esm",
+  external: [/^@pracht\//, /^node:/, "vite", "citty"],
+});