dispersa 0.1.3 → 0.2.0

package/dist/cli/cli.d.ts

@@ -0,0 +1,11 @@
+type CliIO = {
+    stdout: (message: string) => void;
+    stderr: (message: string) => void;
+};
+type RunOptions = {
+    cwd?: string;
+    io?: CliIO;
+};
+declare function runCli(args: string[], options?: RunOptions): Promise<number>;
+
+export { runCli };

package/dist/cli/cli.js

@@ -0,0 +1,201 @@
+import { access } from 'fs/promises';
+import { createRequire } from 'module';
+import { dirname, resolve, isAbsolute } from 'path';
+import process from 'process';
+import { Dispersa } from 'dispersa';
+import { createJiti } from 'jiti';
+
+// src/cli/cli.ts
+var defaultConfigNames = [
+  "dispersa.config.ts",
+  "dispersa.config.js",
+  "dispersa.config.mts",
+  "dispersa.config.mjs",
+  "dispersa.config.cts",
+  "dispersa.config.cjs"
+];
+async function runCli(args, options = {}) {
+  const cwd = options.cwd ?? process.cwd();
+  const io = options.io ?? {
+    stdout: (message) => process.stdout.write(`${message}
+`),
+    stderr: (message) => process.stderr.write(`${message}
+`)
+  };
+  const command = args[0] ?? "build";
+  if (command === "--help" || command === "-h" || command === "help") {
+    printHelp(io);
+    return 0;
+  }
+  if (command !== "build") {
+    io.stderr(`Unknown command: ${command}`);
+    printHelp(io);
+    return 1;
+  }
+  const configPath = getArgValue(args, "--config");
+  const verbose = hasFlag(args, "--verbose") || hasFlag(args, "-v");
+  const resolvedPath = await resolveConfigPath(configPath, cwd);
+  if (resolvedPath === void 0) {
+    io.stderr(
+      `No config found. Expected one of: ${defaultConfigNames.join(", ")} or pass --config <path>.`
+    );
+    return 1;
+  }
+  if (verbose) {
+    io.stdout(`Config: ${resolvedPath}`);
+  }
+  let config;
+  try {
+    config = await loadConfig(resolvedPath, cwd);
+  } catch (error) {
+    io.stderr(`Failed to load config: ${resolvedPath}`);
+    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`);
+    return 1;
+  }
+  const configDir = dirname(resolvedPath);
+  const normalizedConfig = normalizeConfigPaths(config, configDir);
+  const { validation, resolver, buildPath, ...buildConfig } = normalizedConfig;
+  if (verbose) {
+    const outputCount = buildConfig.outputs?.length ?? 0;
+    io.stdout(`Outputs: ${outputCount} configured`);
+    if (buildPath) {
+      io.stdout(`Build path: ${buildPath}`);
+    }
+  }
+  const startTime = Date.now();
+  const dispersa = new Dispersa({ resolver, buildPath, validation });
+  const result = await dispersa.build(buildConfig);
+  const elapsed = Date.now() - startTime;
+  if (!result.success) {
+    io.stderr("Build failed.");
+    for (const error of result.errors ?? []) {
+      io.stderr(`- [${error.code}] ${error.message}`);
+      if (verbose && error.tokenPath) {
+        io.stderr(`  Token: ${error.tokenPath}`);
+      }
+      if (verbose && error.path) {
+        io.stderr(`  File: ${error.path}`);
+      }
+      if (verbose && error.suggestions && error.suggestions.length > 0) {
+        io.stderr(`  Suggestions: ${error.suggestions.join(", ")}`);
+      }
+    }
+    if (verbose) {
+      io.stderr(`Duration: ${elapsed}ms`);
+    }
+    return 1;
+  }
+  io.stdout("Build succeeded.");
+  for (const output of result.outputs) {
+    const location = output.path ?? "(in-memory)";
+    io.stdout(`- ${output.name}: ${location}`);
+  }
+  if (verbose) {
+    io.stdout(`Duration: ${elapsed}ms`);
+  }
+  return 0;
+}
+function getArgValue(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1 || index === args.length - 1) {
+    return void 0;
+  }
+  const value = args[index + 1];
+  if (value == null || value.startsWith("-")) {
+    return void 0;
+  }
+  return value;
+}
+function hasFlag(args, flag) {
+  return args.includes(flag);
+}
+async function resolveConfigPath(configPath, cwd) {
+  if (configPath) {
+    const fullPath = resolve(cwd, configPath);
+    if (!await fileExists(fullPath)) {
+      return void 0;
+    }
+    return fullPath;
+  }
+  for (const name of defaultConfigNames) {
+    const fullPath = resolve(cwd, name);
+    if (await fileExists(fullPath)) {
+      return fullPath;
+    }
+  }
+  return void 0;
+}
+async function loadConfig(configPath, cwd) {
+  const alias = await buildAliasMap(cwd);
+  const loader = createJiti(cwd, {
+    interopDefault: true,
+    alias
+  });
+  const loaded = await loader(configPath);
+  const config = loaded.default ?? loaded;
+  if (config == null || typeof config !== "object") {
+    throw new Error(`Invalid config: ${configPath} did not export an object`);
+  }
+  return config;
+}
+function normalizeConfigPaths(config, configDir) {
+  const resolver = typeof config.resolver === "string" ? resolveIfRelative(config.resolver, configDir) : config.resolver;
+  const buildPath = resolveIfRelative(config.buildPath, configDir);
+  const outputs = config.outputs ?? [];
+  return {
+    ...config,
+    resolver,
+    buildPath,
+    outputs
+  };
+}
+function resolveIfRelative(value, baseDir) {
+  if (!value) {
+    return value;
+  }
+  return isAbsolute(value) ? value : resolve(baseDir, value);
+}
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function buildAliasMap(cwd) {
+  const alias = {};
+  const coreSourcePath = resolve(cwd, "packages/core/src/index.ts");
+  if (await fileExists(coreSourcePath)) {
+    alias["dispersa"] = coreSourcePath;
+    return alias;
+  }
+  if (!isPackageResolvable("dispersa", cwd)) {
+    const require2 = createRequire(import.meta.url);
+    try {
+      alias["dispersa"] = require2.resolve("dispersa");
+    } catch {
+    }
+  }
+  return alias;
+}
+function isPackageResolvable(name, cwd) {
+  const require2 = createRequire(import.meta.url);
+  try {
+    require2.resolve(name, { paths: [cwd] });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function printHelp(io) {
+  io.stdout("dispersa build [options]");
+  io.stdout("");
+  io.stdout("Options:");
+  io.stdout("  --config <path>   Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)");
+  io.stdout("  --verbose, -v     Show detailed build output (timing, error context)");
+}
+
+export { runCli };
+//# sourceMappingURL=cli.js.map
+//# sourceMappingURL=cli.js.map

package/dist/cli/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/cli.ts"],"names":["require"],"mappings":"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","file":"cli.js","sourcesContent":["import { access } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { dirname, isAbsolute, resolve } from 'node:path'\nimport process from 'node:process'\n\nimport { Dispersa, type BuildConfig } from 'dispersa'\nimport { createJiti } from 'jiti'\n\nimport type { CliConfig } from './config'\n\ntype CliIO = {\n  stdout: (message: string) => void\n  stderr: (message: string) => void\n}\n\ntype RunOptions = {\n  cwd?: string\n  io?: CliIO\n}\n\nconst defaultConfigNames = [\n  'dispersa.config.ts',\n  'dispersa.config.js',\n  'dispersa.config.mts',\n  'dispersa.config.mjs',\n  'dispersa.config.cts',\n  'dispersa.config.cjs',\n]\n\nexport async function runCli(args: string[], options: RunOptions = {}): Promise<number> {\n  const cwd = options.cwd ?? process.cwd()\n  const io: CliIO = options.io ?? {\n    stdout: (message) => process.stdout.write(`${message}\\n`),\n    stderr: (message) => process.stderr.write(`${message}\\n`),\n  }\n\n  const command = args[0] ?? 'build'\n  if (command === '--help' || command === '-h' || command === 'help') {\n    printHelp(io)\n    return 0\n  }\n\n  if (command !== 'build') {\n    io.stderr(`Unknown command: ${command}`)\n    printHelp(io)\n    return 1\n  }\n\n  const configPath = getArgValue(args, '--config')\n  const verbose = hasFlag(args, '--verbose') || hasFlag(args, '-v')\n  const resolvedPath = await resolveConfigPath(configPath, cwd)\n  if (resolvedPath === undefined) {\n    io.stderr(\n      `No config found. Expected one of: ${defaultConfigNames.join(', ')} ` +\n        'or pass --config <path>.',\n    )\n    return 1\n  }\n\n  if (verbose) {\n    io.stdout(`Config: ${resolvedPath}`)\n  }\n\n  let config: CliConfig\n  try {\n    config = await loadConfig(resolvedPath, cwd)\n  } catch (error) {\n    io.stderr(`Failed to load config: ${resolvedPath}`)\n    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`)\n    return 1\n  }\n\n  const configDir = dirname(resolvedPath)\n  const normalizedConfig = normalizeConfigPaths(config, configDir)\n  const { validation, resolver, buildPath, ...buildConfig } = normalizedConfig\n\n  if (verbose) {\n    const outputCount = buildConfig.outputs?.length ?? 0\n    io.stdout(`Outputs: ${outputCount} configured`)\n    if (buildPath) {\n      io.stdout(`Build path: ${buildPath}`)\n    }\n  }\n\n  const startTime = Date.now()\n  const dispersa = new Dispersa({ resolver, buildPath, validation })\n  const result = await dispersa.build(buildConfig as BuildConfig)\n  const elapsed = Date.now() - startTime\n\n  if (!result.success) {\n    io.stderr('Build failed.')\n    for (const error of result.errors ?? []) {\n      io.stderr(`- [${error.code}] ${error.message}`)\n      if (verbose && error.tokenPath) {\n        io.stderr(`  Token: ${error.tokenPath}`)\n      }\n      if (verbose && error.path) {\n        io.stderr(`  File: ${error.path}`)\n      }\n      if (verbose && error.suggestions && error.suggestions.length > 0) {\n        io.stderr(`  Suggestions: ${error.suggestions.join(', ')}`)\n      }\n    }\n    if (verbose) {\n      io.stderr(`Duration: ${elapsed}ms`)\n    }\n    return 1\n  }\n\n  io.stdout('Build succeeded.')\n  for (const output of result.outputs) {\n    const location = output.path ?? '(in-memory)'\n    io.stdout(`- ${output.name}: ${location}`)\n  }\n\n  if (verbose) {\n    io.stdout(`Duration: ${elapsed}ms`)\n  }\n\n  return 0\n}\n\nfunction getArgValue(args: string[], flag: string): string | undefined {\n  const index = args.indexOf(flag)\n  if (index === -1 || index === args.length - 1) {\n    return undefined\n  }\n  const value = args[index + 1]\n  if (value == null || value.startsWith('-')) {\n    return undefined\n  }\n  return value\n}\n\nfunction hasFlag(args: string[], flag: string): boolean {\n  return args.includes(flag)\n}\n\nasync function resolveConfigPath(\n  configPath: string | undefined,\n  cwd: string,\n): Promise<string | undefined> {\n  if (configPath) {\n    const fullPath = resolve(cwd, configPath)\n    if (!(await fileExists(fullPath))) {\n      return undefined\n    }\n    return fullPath\n  }\n\n  for (const name of defaultConfigNames) {\n    const fullPath = resolve(cwd, name)\n    if (await fileExists(fullPath)) {\n      return fullPath\n    }\n  }\n\n  return undefined\n}\n\nasync function loadConfig(configPath: string, cwd: string): Promise<CliConfig> {\n  const alias = await buildAliasMap(cwd)\n  const loader = createJiti(cwd, {\n    interopDefault: true,\n    alias,\n  })\n  const loaded = await loader(configPath)\n  const config = (loaded as { default?: CliConfig }).default ?? (loaded as CliConfig)\n\n  if (config == null || typeof config !== 'object') {\n    throw new Error(`Invalid config: ${configPath} did not export an object`)\n  }\n\n  return config\n}\n\nfunction normalizeConfigPaths(config: CliConfig, configDir: string): CliConfig {\n  const resolver =\n    typeof config.resolver === 'string'\n      ? resolveIfRelative(config.resolver, configDir)\n      : config.resolver\n  const buildPath = resolveIfRelative(config.buildPath, configDir)\n  const outputs = config.outputs ?? []\n\n  return {\n    ...config,\n    resolver,\n    buildPath,\n    outputs,\n  }\n}\n\nfunction resolveIfRelative(value: string | undefined, baseDir: string): string | undefined {\n  if (!value) {\n    return value\n  }\n  return isAbsolute(value) ? value : resolve(baseDir, value)\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function buildAliasMap(cwd: string): Promise<Record<string, string>> {\n  const alias: Record<string, string> = {}\n\n  // Dev monorepo: point to source files for hot-reload\n  const coreSourcePath = resolve(cwd, 'packages/core/src/index.ts')\n  if (await fileExists(coreSourcePath)) {\n    alias['dispersa'] = coreSourcePath\n    return alias\n  }\n\n  // Not resolvable from cwd — try from the CLI module's own location\n  // (handles workspace symlinks and global installs)\n  if (!isPackageResolvable('dispersa', cwd)) {\n    const require = createRequire(import.meta.url)\n    try {\n      alias['dispersa'] = require.resolve('dispersa')\n    } catch {\n      // Not resolvable at all; config loading will fail with a clear error\n    }\n  }\n\n  return alias\n}\n\nfunction isPackageResolvable(name: string, cwd: string): boolean {\n  const require = createRequire(import.meta.url)\n  try {\n    require.resolve(name, { paths: [cwd] })\n    return true\n  } catch {\n    return false\n  }\n}\n\nfunction printHelp(io: CliIO): void {\n  io.stdout('dispersa build [options]')\n  io.stdout('')\n  io.stdout('Options:')\n  io.stdout('  --config <path>   Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)')\n  io.stdout('  --verbose, -v     Show detailed build output (timing, error context)')\n}\n"]}

package/dist/cli/config.d.ts

@@ -0,0 +1,8 @@
+import { BuildConfig, ValidationOptions } from 'dispersa';
+
+type CliConfig = BuildConfig & {
+    validation?: ValidationOptions;
+};
+declare function defineConfig(config: CliConfig): CliConfig;
+
+export { type CliConfig, defineConfig };

package/dist/cli/config.js

@@ -0,0 +1,8 @@
+// src/cli/config.ts
+function defineConfig(config) {
+  return config;
+}
+
+export { defineConfig };
+//# sourceMappingURL=config.js.map
+//# sourceMappingURL=config.js.map

package/dist/cli/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/config.ts"],"names":[],"mappings":";AAMO,SAAS,aAAa,MAAA,EAA8B;AACzD,EAAA,OAAO,MAAA;AACT","file":"config.js","sourcesContent":["import type { BuildConfig, ValidationOptions } from 'dispersa'\n\nexport type CliConfig = BuildConfig & {\n  validation?: ValidationOptions\n}\n\nexport function defineConfig(config: CliConfig): CliConfig {\n  return config\n}\n"]}

package/dist/cli/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/index.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+import { access } from 'fs/promises';
+import { createRequire } from 'module';
+import { dirname, resolve, isAbsolute } from 'path';
+import process2 from 'process';
+import { Dispersa } from 'dispersa';
+import { createJiti } from 'jiti';
+
+var defaultConfigNames = [
+  "dispersa.config.ts",
+  "dispersa.config.js",
+  "dispersa.config.mts",
+  "dispersa.config.mjs",
+  "dispersa.config.cts",
+  "dispersa.config.cjs"
+];
+async function runCli(args, options = {}) {
+  const cwd = options.cwd ?? process2.cwd();
+  const io = options.io ?? {
+    stdout: (message) => process2.stdout.write(`${message}
+`),
+    stderr: (message) => process2.stderr.write(`${message}
+`)
+  };
+  const command = args[0] ?? "build";
+  if (command === "--help" || command === "-h" || command === "help") {
+    printHelp(io);
+    return 0;
+  }
+  if (command !== "build") {
+    io.stderr(`Unknown command: ${command}`);
+    printHelp(io);
+    return 1;
+  }
+  const configPath = getArgValue(args, "--config");
+  const verbose = hasFlag(args, "--verbose") || hasFlag(args, "-v");
+  const resolvedPath = await resolveConfigPath(configPath, cwd);
+  if (resolvedPath === void 0) {
+    io.stderr(
+      `No config found. Expected one of: ${defaultConfigNames.join(", ")} or pass --config <path>.`
+    );
+    return 1;
+  }
+  if (verbose) {
+    io.stdout(`Config: ${resolvedPath}`);
+  }
+  let config;
+  try {
+    config = await loadConfig(resolvedPath, cwd);
+  } catch (error) {
+    io.stderr(`Failed to load config: ${resolvedPath}`);
+    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`);
+    return 1;
+  }
+  const configDir = dirname(resolvedPath);
+  const normalizedConfig = normalizeConfigPaths(config, configDir);
+  const { validation, resolver, buildPath, ...buildConfig } = normalizedConfig;
+  if (verbose) {
+    const outputCount = buildConfig.outputs?.length ?? 0;
+    io.stdout(`Outputs: ${outputCount} configured`);
+    if (buildPath) {
+      io.stdout(`Build path: ${buildPath}`);
+    }
+  }
+  const startTime = Date.now();
+  const dispersa = new Dispersa({ resolver, buildPath, validation });
+  const result = await dispersa.build(buildConfig);
+  const elapsed = Date.now() - startTime;
+  if (!result.success) {
+    io.stderr("Build failed.");
+    for (const error of result.errors ?? []) {
+      io.stderr(`- [${error.code}] ${error.message}`);
+      if (verbose && error.tokenPath) {
+        io.stderr(`  Token: ${error.tokenPath}`);
+      }
+      if (verbose && error.path) {
+        io.stderr(`  File: ${error.path}`);
+      }
+      if (verbose && error.suggestions && error.suggestions.length > 0) {
+        io.stderr(`  Suggestions: ${error.suggestions.join(", ")}`);
+      }
+    }
+    if (verbose) {
+      io.stderr(`Duration: ${elapsed}ms`);
+    }
+    return 1;
+  }
+  io.stdout("Build succeeded.");
+  for (const output of result.outputs) {
+    const location = output.path ?? "(in-memory)";
+    io.stdout(`- ${output.name}: ${location}`);
+  }
+  if (verbose) {
+    io.stdout(`Duration: ${elapsed}ms`);
+  }
+  return 0;
+}
+function getArgValue(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1 || index === args.length - 1) {
+    return void 0;
+  }
+  const value = args[index + 1];
+  if (value == null || value.startsWith("-")) {
+    return void 0;
+  }
+  return value;
+}
+function hasFlag(args, flag) {
+  return args.includes(flag);
+}
+async function resolveConfigPath(configPath, cwd) {
+  if (configPath) {
+    const fullPath = resolve(cwd, configPath);
+    if (!await fileExists(fullPath)) {
+      return void 0;
+    }
+    return fullPath;
+  }
+  for (const name of defaultConfigNames) {
+    const fullPath = resolve(cwd, name);
+    if (await fileExists(fullPath)) {
+      return fullPath;
+    }
+  }
+  return void 0;
+}
+async function loadConfig(configPath, cwd) {
+  const alias = await buildAliasMap(cwd);
+  const loader = createJiti(cwd, {
+    interopDefault: true,
+    alias
+  });
+  const loaded = await loader(configPath);
+  const config = loaded.default ?? loaded;
+  if (config == null || typeof config !== "object") {
+    throw new Error(`Invalid config: ${configPath} did not export an object`);
+  }
+  return config;
+}
+function normalizeConfigPaths(config, configDir) {
+  const resolver = typeof config.resolver === "string" ? resolveIfRelative(config.resolver, configDir) : config.resolver;
+  const buildPath = resolveIfRelative(config.buildPath, configDir);
+  const outputs = config.outputs ?? [];
+  return {
+    ...config,
+    resolver,
+    buildPath,
+    outputs
+  };
+}
+function resolveIfRelative(value, baseDir) {
+  if (!value) {
+    return value;
+  }
+  return isAbsolute(value) ? value : resolve(baseDir, value);
+}
+async function fileExists(path) {
+  try {
+    await access(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function buildAliasMap(cwd) {
+  const alias = {};
+  const coreSourcePath = resolve(cwd, "packages/core/src/index.ts");
+  if (await fileExists(coreSourcePath)) {
+    alias["dispersa"] = coreSourcePath;
+    return alias;
+  }
+  if (!isPackageResolvable("dispersa", cwd)) {
+    const require2 = createRequire(import.meta.url);
+    try {
+      alias["dispersa"] = require2.resolve("dispersa");
+    } catch {
+    }
+  }
+  return alias;
+}
+function isPackageResolvable(name, cwd) {
+  const require2 = createRequire(import.meta.url);
+  try {
+    require2.resolve(name, { paths: [cwd] });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function printHelp(io) {
+  io.stdout("dispersa build [options]");
+  io.stdout("");
+  io.stdout("Options:");
+  io.stdout("  --config <path>   Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)");
+  io.stdout("  --verbose, -v     Show detailed build output (timing, error context)");
+}
+
+// src/cli/index.ts
+var exitCode = await runCli(process.argv.slice(2));
+process.exitCode = exitCode;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/cli.ts","../../src/cli/index.ts"],"names":["process","require"],"mappings":"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","file":"index.js","sourcesContent":["import { access } from 'node:fs/promises'\nimport { createRequire } from 'node:module'\nimport { dirname, isAbsolute, resolve } from 'node:path'\nimport process from 'node:process'\n\nimport { Dispersa, type BuildConfig } from 'dispersa'\nimport { createJiti } from 'jiti'\n\nimport type { CliConfig } from './config'\n\ntype CliIO = {\n  stdout: (message: string) => void\n  stderr: (message: string) => void\n}\n\ntype RunOptions = {\n  cwd?: string\n  io?: CliIO\n}\n\nconst defaultConfigNames = [\n  'dispersa.config.ts',\n  'dispersa.config.js',\n  'dispersa.config.mts',\n  'dispersa.config.mjs',\n  'dispersa.config.cts',\n  'dispersa.config.cjs',\n]\n\nexport async function runCli(args: string[], options: RunOptions = {}): Promise<number> {\n  const cwd = options.cwd ?? process.cwd()\n  const io: CliIO = options.io ?? {\n    stdout: (message) => process.stdout.write(`${message}\\n`),\n    stderr: (message) => process.stderr.write(`${message}\\n`),\n  }\n\n  const command = args[0] ?? 'build'\n  if (command === '--help' || command === '-h' || command === 'help') {\n    printHelp(io)\n    return 0\n  }\n\n  if (command !== 'build') {\n    io.stderr(`Unknown command: ${command}`)\n    printHelp(io)\n    return 1\n  }\n\n  const configPath = getArgValue(args, '--config')\n  const verbose = hasFlag(args, '--verbose') || hasFlag(args, '-v')\n  const resolvedPath = await resolveConfigPath(configPath, cwd)\n  if (resolvedPath === undefined) {\n    io.stderr(\n      `No config found. Expected one of: ${defaultConfigNames.join(', ')} ` +\n        'or pass --config <path>.',\n    )\n    return 1\n  }\n\n  if (verbose) {\n    io.stdout(`Config: ${resolvedPath}`)\n  }\n\n  let config: CliConfig\n  try {\n    config = await loadConfig(resolvedPath, cwd)\n  } catch (error) {\n    io.stderr(`Failed to load config: ${resolvedPath}`)\n    io.stderr(`- ${error instanceof Error ? error.message : String(error)}`)\n    return 1\n  }\n\n  const configDir = dirname(resolvedPath)\n  const normalizedConfig = normalizeConfigPaths(config, configDir)\n  const { validation, resolver, buildPath, ...buildConfig } = normalizedConfig\n\n  if (verbose) {\n    const outputCount = buildConfig.outputs?.length ?? 0\n    io.stdout(`Outputs: ${outputCount} configured`)\n    if (buildPath) {\n      io.stdout(`Build path: ${buildPath}`)\n    }\n  }\n\n  const startTime = Date.now()\n  const dispersa = new Dispersa({ resolver, buildPath, validation })\n  const result = await dispersa.build(buildConfig as BuildConfig)\n  const elapsed = Date.now() - startTime\n\n  if (!result.success) {\n    io.stderr('Build failed.')\n    for (const error of result.errors ?? []) {\n      io.stderr(`- [${error.code}] ${error.message}`)\n      if (verbose && error.tokenPath) {\n        io.stderr(`  Token: ${error.tokenPath}`)\n      }\n      if (verbose && error.path) {\n        io.stderr(`  File: ${error.path}`)\n      }\n      if (verbose && error.suggestions && error.suggestions.length > 0) {\n        io.stderr(`  Suggestions: ${error.suggestions.join(', ')}`)\n      }\n    }\n    if (verbose) {\n      io.stderr(`Duration: ${elapsed}ms`)\n    }\n    return 1\n  }\n\n  io.stdout('Build succeeded.')\n  for (const output of result.outputs) {\n    const location = output.path ?? '(in-memory)'\n    io.stdout(`- ${output.name}: ${location}`)\n  }\n\n  if (verbose) {\n    io.stdout(`Duration: ${elapsed}ms`)\n  }\n\n  return 0\n}\n\nfunction getArgValue(args: string[], flag: string): string | undefined {\n  const index = args.indexOf(flag)\n  if (index === -1 || index === args.length - 1) {\n    return undefined\n  }\n  const value = args[index + 1]\n  if (value == null || value.startsWith('-')) {\n    return undefined\n  }\n  return value\n}\n\nfunction hasFlag(args: string[], flag: string): boolean {\n  return args.includes(flag)\n}\n\nasync function resolveConfigPath(\n  configPath: string | undefined,\n  cwd: string,\n): Promise<string | undefined> {\n  if (configPath) {\n    const fullPath = resolve(cwd, configPath)\n    if (!(await fileExists(fullPath))) {\n      return undefined\n    }\n    return fullPath\n  }\n\n  for (const name of defaultConfigNames) {\n    const fullPath = resolve(cwd, name)\n    if (await fileExists(fullPath)) {\n      return fullPath\n    }\n  }\n\n  return undefined\n}\n\nasync function loadConfig(configPath: string, cwd: string): Promise<CliConfig> {\n  const alias = await buildAliasMap(cwd)\n  const loader = createJiti(cwd, {\n    interopDefault: true,\n    alias,\n  })\n  const loaded = await loader(configPath)\n  const config = (loaded as { default?: CliConfig }).default ?? (loaded as CliConfig)\n\n  if (config == null || typeof config !== 'object') {\n    throw new Error(`Invalid config: ${configPath} did not export an object`)\n  }\n\n  return config\n}\n\nfunction normalizeConfigPaths(config: CliConfig, configDir: string): CliConfig {\n  const resolver =\n    typeof config.resolver === 'string'\n      ? resolveIfRelative(config.resolver, configDir)\n      : config.resolver\n  const buildPath = resolveIfRelative(config.buildPath, configDir)\n  const outputs = config.outputs ?? []\n\n  return {\n    ...config,\n    resolver,\n    buildPath,\n    outputs,\n  }\n}\n\nfunction resolveIfRelative(value: string | undefined, baseDir: string): string | undefined {\n  if (!value) {\n    return value\n  }\n  return isAbsolute(value) ? value : resolve(baseDir, value)\n}\n\nasync function fileExists(path: string): Promise<boolean> {\n  try {\n    await access(path)\n    return true\n  } catch {\n    return false\n  }\n}\n\nasync function buildAliasMap(cwd: string): Promise<Record<string, string>> {\n  const alias: Record<string, string> = {}\n\n  // Dev monorepo: point to source files for hot-reload\n  const coreSourcePath = resolve(cwd, 'packages/core/src/index.ts')\n  if (await fileExists(coreSourcePath)) {\n    alias['dispersa'] = coreSourcePath\n    return alias\n  }\n\n  // Not resolvable from cwd — try from the CLI module's own location\n  // (handles workspace symlinks and global installs)\n  if (!isPackageResolvable('dispersa', cwd)) {\n    const require = createRequire(import.meta.url)\n    try {\n      alias['dispersa'] = require.resolve('dispersa')\n    } catch {\n      // Not resolvable at all; config loading will fail with a clear error\n    }\n  }\n\n  return alias\n}\n\nfunction isPackageResolvable(name: string, cwd: string): boolean {\n  const require = createRequire(import.meta.url)\n  try {\n    require.resolve(name, { paths: [cwd] })\n    return true\n  } catch {\n    return false\n  }\n}\n\nfunction printHelp(io: CliIO): void {\n  io.stdout('dispersa build [options]')\n  io.stdout('')\n  io.stdout('Options:')\n  io.stdout('  --config <path>   Path to dispersa.config.(ts|js|mts|mjs|cts|cjs)')\n  io.stdout('  --verbose, -v     Show detailed build output (timing, error context)')\n}\n","#!/usr/bin/env node\nimport { runCli } from './cli.js'\n\nconst exitCode = await runCli(process.argv.slice(2))\nprocess.exitCode = exitCode\n"]}

package/dist/filters.cjs

@@ -150,7 +150,7 @@ var ValidationHandler = class {
   }
 };
 
-// src/lib/resolution/alias-resolver.ts
+// src/resolution/alias-resolver.ts
 var AliasResolver = class _AliasResolver {
   options;
   resolving;
@@ -406,19 +406,20 @@ var AliasResolver = class _AliasResolver {
   }
 };
 
-// src/lib/processing/processors/filters/built-in.ts
+// src/processing/processors/filters/built-in.ts
 function byType(type) {
   return {
     filter: (token) => token.$type === type
   };
 }
 function byPath(pattern) {
-  const regex = typeof pattern === "string" ? new RegExp(`^${pattern}`) : pattern;
+  if (typeof pattern === "string") {
+    return {
+      filter: (token) => token.path.join(".").startsWith(pattern)
+    };
+  }
   return {
-    filter: (token) => {
-      const fullPath = token.path.join(".");
-      return regex.test(fullPath);
-    }
+    filter: (token) => pattern.test(token.path.join("."))
   };
 }
 function isAlias() {