vantris 0.1.0

package/dist/chunk-PSXNP5S5.js

@@ -0,0 +1,308 @@
+import { pathToFileURL } from 'url';
+import { stat, readFile, mkdir } from 'fs/promises';
+import { isAbsolute, resolve, relative } from 'path';
+
+// src/shared/constants.ts
+var APP_NAME = "vantris";
+var VERSION = "0.1.0";
+var HTML_ENTRY_FILENAME = "index.html";
+var DEFAULTS = {
+  root: ".",
+  rootDir: "./src",
+  publicDir: "./public",
+  outDir: "./dist"
+};
+var CONFIG_FILENAMES = [
+  "vantris.config.ts",
+  "vantris.config.js",
+  "vantris.config.mjs"
+];
+
+// src/shared/errors.ts
+var VantrisError = class extends Error {
+  name = "VantrisError";
+  constructor(message, options) {
+    super(message, options);
+  }
+};
+var ConfigError = class extends VantrisError {
+  name = "ConfigError";
+};
+var HtmlEntryError = class extends VantrisError {
+  name = "HtmlEntryError";
+};
+var NotImplementedError = class extends VantrisError {
+  name = "NotImplementedError";
+};
+function isVantrisError(error) {
+  return error instanceof VantrisError;
+}
+async function isFile(path) {
+  try {
+    return (await stat(path)).isFile();
+  } catch {
+    return false;
+  }
+}
+function readTextFile(path) {
+  return readFile(path, "utf8");
+}
+async function ensureDir(path) {
+  await mkdir(path, { recursive: true });
+}
+function resolveFrom(base, target) {
+  return isAbsolute(target) ? target : resolve(base, target);
+}
+
+// src/config/load.ts
+async function loadConfig(options) {
+  const { cwd, logger } = options;
+  const file = options.configFile ? resolveFrom(cwd, options.configFile) : await findConfigFile(cwd);
+  if (!file) {
+    logger.debug("No config file found; using defaults.");
+    return { config: {}, file: null };
+  }
+  logger.debug(`Loading config from ${file}`);
+  const config = await importConfig(file);
+  return { config, file };
+}
+async function findConfigFile(cwd) {
+  for (const name of CONFIG_FILENAMES) {
+    const candidate = resolveFrom(cwd, name);
+    if (await isFile(candidate)) return candidate;
+  }
+  return null;
+}
+async function importConfig(file) {
+  let mod;
+  try {
+    const url = `${pathToFileURL(file).href}?t=${Date.now()}`;
+    mod = await import(url);
+  } catch (cause) {
+    throw new ConfigError(`Failed to load config file: ${file}`, { cause });
+  }
+  const exported = mod.default;
+  if (exported === void 0) {
+    throw new ConfigError(
+      `Config file "${file}" has no default export. Export your config with \`export default defineConfig({ ... })\`.`
+    );
+  }
+  return normalise(exported, file);
+}
+async function normalise(input, file) {
+  const value = typeof input === "function" ? await input() : input;
+  if (value === null || typeof value !== "object") {
+    throw new ConfigError(
+      `Config file "${file}" must export an object (or a function returning one).`
+    );
+  }
+  return value;
+}
+
+// src/config/resolve.ts
+function resolveConfig(raw, cwd, configFile = null) {
+  const root = resolveFrom(cwd, raw.root ?? DEFAULTS.root);
+  const paths = {
+    root,
+    rootDir: resolveFrom(root, raw.rootDir ?? DEFAULTS.rootDir),
+    publicDir: resolveFrom(root, raw.publicDir ?? DEFAULTS.publicDir),
+    outDir: resolveFrom(root, raw.outDir ?? DEFAULTS.outDir)
+  };
+  return { raw, paths, configFile };
+}
+
+// src/html/parse.ts
+function parseHtml(file, html) {
+  return { file, html };
+}
+
+// src/html/detect.ts
+async function detectHtmlEntry(root) {
+  const file = resolveFrom(root, HTML_ENTRY_FILENAME);
+  if (!await isFile(file)) return null;
+  const html = await readTextFile(file);
+  return parseHtml(file, html);
+}
+
+// src/shared/logger.ts
+var prefix = `[${APP_NAME}]`;
+function createLogger(options = {}) {
+  const { verbose = false, sink = console } = options;
+  return {
+    info(message) {
+      sink.log(`${prefix} ${message}`);
+    },
+    warn(message) {
+      sink.warn(`${prefix} ${message}`);
+    },
+    error(message) {
+      sink.error(`${prefix} ${message}`);
+    },
+    debug(message) {
+      if (verbose) sink.log(`${prefix} ${message}`);
+    }
+  };
+}
+
+// src/shared/context.ts
+async function createContext(options) {
+  const { cwd, logger } = options;
+  const loaded = await loadConfig({
+    cwd,
+    logger,
+    ...options.configFile !== void 0 ? { configFile: options.configFile } : {}
+  });
+  const config = resolveConfig(loaded.config, cwd, loaded.file);
+  return { cwd, config, logger };
+}
+
+// src/server/index.ts
+async function startDevServer(options) {
+  const { ctx } = options;
+  ctx.logger.info(
+    "dev server is not implemented in v0.1.0 (planned: H3 + HMR)."
+  );
+}
+function rel(ctx, target) {
+  return relative(ctx.config.paths.root, target) || ".";
+}
+async function inspectProject(ctx) {
+  const { paths, configFile } = ctx.config;
+  ctx.logger.info(
+    `config: ${configFile ? rel(ctx, configFile) : "defaults (no config file)"}`
+  );
+  ctx.logger.info(`rootDir:   ${rel(ctx, paths.rootDir)}`);
+  ctx.logger.info(`publicDir: ${rel(ctx, paths.publicDir)}`);
+  ctx.logger.info(`outDir:    ${rel(ctx, paths.outDir)}`);
+  const entry = await detectHtmlEntry(paths.root);
+  if (entry) {
+    ctx.logger.info(`html entry: ${rel(ctx, entry.file)}`);
+  } else {
+    ctx.logger.warn(
+      "no index.html found at the project root; nothing to serve yet."
+    );
+  }
+  return entry;
+}
+async function prepareDirectories(ctx, dirs) {
+  for (const dir of dirs) {
+    await ensureDir(dir);
+    ctx.logger.debug(`prepared directory: ${dir}`);
+  }
+}
+
+// src/commands/dev.ts
+var dev = {
+  name: "dev",
+  description: "Start the development server",
+  async run(ctx) {
+    const { rootDir, publicDir } = ctx.config.paths;
+    await prepareDirectories(ctx, [rootDir, publicDir]);
+    await inspectProject(ctx);
+    await startDevServer({ ctx});
+  }
+};
+
+// src/build/index.ts
+async function runBuild(options) {
+  const { ctx } = options;
+  ctx.logger.info(
+    "build is not implemented in v0.1.0 (planned: Rolldown + esbuild)."
+  );
+}
+
+// src/commands/build.ts
+var build = {
+  name: "build",
+  description: "Build the project for production",
+  async run(ctx) {
+    const { rootDir, publicDir, outDir } = ctx.config.paths;
+    await prepareDirectories(ctx, [rootDir, publicDir, outDir]);
+    await inspectProject(ctx);
+    await runBuild({ ctx});
+  }
+};
+
+// src/preview/index.ts
+async function runPreview(options) {
+  const { ctx } = options;
+  ctx.logger.info(
+    "preview is not implemented in v0.1.0 (planned: static server over outDir)."
+  );
+}
+
+// src/commands/preview.ts
+var preview = {
+  name: "preview",
+  description: "Locally preview a production build",
+  async run(ctx) {
+    await prepareDirectories(ctx, [ctx.config.paths.outDir]);
+    await inspectProject(ctx);
+    await runPreview({ ctx });
+  }
+};
+
+// src/commands/index.ts
+var commands = {
+  [dev.name]: dev,
+  [build.name]: build,
+  [preview.name]: preview
+};
+
+// src/cli/help.ts
+function helpText() {
+  const lines = [
+    `${APP_NAME} v${VERSION} \u2014 a modern bundler for JavaScript/TypeScript`,
+    "",
+    "Usage:",
+    `  ${APP_NAME} <command> [options]`,
+    "",
+    "Commands:"
+  ];
+  const width = Math.max(...Object.keys(commands).map((n) => n.length));
+  for (const command of Object.values(commands)) {
+    lines.push(`  ${command.name.padEnd(width)}  ${command.description}`);
+  }
+  lines.push(
+    "",
+    "Options:",
+    "  -h, --help     Show this help",
+    "  -v, --version  Show the version number"
+  );
+  return lines.join("\n");
+}
+function versionText() {
+  return `${APP_NAME} v${VERSION}`;
+}
+
+// src/cli/run.ts
+async function run(argv, options = {}) {
+  const verbose = argv.includes("--verbose") || argv.includes("--debug");
+  const logger = options.logger ?? createLogger({ verbose });
+  const cwd = options.cwd ?? process.cwd();
+  const [first, ...rest] = argv.filter((arg) => !isGlobalFlag(arg));
+  if (!first || first === "--help" || first === "-h" || first === "help") {
+    logger.info(helpText());
+    return 0 /* Ok */;
+  }
+  if (first === "--version" || first === "-v") {
+    logger.info(versionText());
+    return 0 /* Ok */;
+  }
+  const command = commands[first];
+  if (!command) {
+    logger.error(`Unknown command: "${first}"`);
+    logger.info(helpText());
+    return 1 /* Error */;
+  }
+  const ctx = await createContext({ cwd, logger });
+  await command.run(ctx, rest);
+  return 0 /* Ok */;
+}
+function isGlobalFlag(arg) {
+  return arg === "--verbose" || arg === "--debug";
+}
+
+export { ConfigError, HtmlEntryError, NotImplementedError, VERSION, VantrisError, commands, createContext, createLogger, detectHtmlEntry, isVantrisError, loadConfig, parseHtml, resolveConfig, run };
+//# sourceMappingURL=chunk-PSXNP5S5.js.map
+//# sourceMappingURL=chunk-PSXNP5S5.js.map

package/dist/chunk-PSXNP5S5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/constants.ts","../src/shared/errors.ts","../src/utils/fs.ts","../src/utils/paths.ts","../src/config/load.ts","../src/config/resolve.ts","../src/html/parse.ts","../src/html/detect.ts","../src/shared/logger.ts","../src/shared/context.ts","../src/server/index.ts","../src/commands/support.ts","../src/commands/dev.ts","../src/build/index.ts","../src/commands/build.ts","../src/preview/index.ts","../src/commands/preview.ts","../src/commands/index.ts","../src/cli/help.ts","../src/cli/run.ts"],"names":[],"mappings":";;;;;AACO,IAAM,QAAA,GAAW,SAAA;AAGjB,IAAM,OAAA,GAAU;AAGhB,IAAM,mBAAA,GAAsB,YAAA;AAG5B,IAAM,QAAA,GAAW;AAAA,EACtB,IAAA,EAAM,GAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,SAAA,EAAW,UAAA;AAAA,EACX,MAAA,EAAQ;AACV,CAAA;AAGO,IAAM,gBAAA,GAAmB;AAAA,EAC9B,mBAAA;AAAA,EACA,mBAAA;AAAA,EACA;AACF,CAAA;;;ACjBO,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EACpB,IAAA,GAAe,cAAA;AAAA,EAEjC,WAAA,CAAY,SAAiB,OAAA,EAAwB;AACnD,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AAAA,EACxB;AACF;AAGO,IAAM,WAAA,GAAN,cAA0B,YAAA,CAAa;AAAA,EAC1B,IAAA,GAAO,aAAA;AAC3B;AAGO,IAAM,cAAA,GAAN,cAA6B,YAAA,CAAa;AAAA,EAC7B,IAAA,GAAO,gBAAA;AAC3B;AAGO,IAAM,mBAAA,GAAN,cAAkC,YAAA,CAAa;AAAA,EAClC,IAAA,GAAO,qBAAA;AAC3B;AAGO,SAAS,eAAe,KAAA,EAAuC;AACpE,EAAA,OAAO,KAAA,YAAiB,YAAA;AAC1B;AC5BA,eAAsB,OAAO,IAAA,EAAgC;AAC3D,EAAA,IAAI;AACF,IAAA,OAAA,CAAQ,MAAM,IAAA,CAAK,IAAI,CAAA,EAAG,MAAA,EAAO;AAAA,EACnC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,KAAA;AAAA,EACT;AACF;AAGO,SAAS,aAAa,IAAA,EAA+B;AAC1D,EAAA,OAAO,QAAA,CAAS,MAAM,MAAM,CAAA;AAC9B;AAGA,eAAsB,UAAU,IAAA,EAA6B;AAC3D,EAAA,MAAM,KAAA,CAAM,IAAA,EAAM,EAAE,SAAA,EAAW,MAAM,CAAA;AACvC;ACbO,SAAS,WAAA,CAAY,MAAc,MAAA,EAAwB;AAChE,EAAA,OAAO,WAAW,MAAM,CAAA,GAAI,MAAA,GAAS,OAAA,CAAQ,MAAM,MAAM,CAAA;AAC3D;;;ACwBA,eAAsB,WACpB,OAAA,EACuB;AACvB,EAAA,MAAM,EAAE,GAAA,EAAK,MAAA,EAAO,GAAI,OAAA;AAExB,EAAA,MAAM,IAAA,GAAO,OAAA,CAAQ,UAAA,GACjB,WAAA,CAAY,GAAA,EAAK,QAAQ,UAAU,CAAA,GACnC,MAAM,cAAA,CAAe,GAAG,CAAA;AAE5B,EAAA,IAAI,CAAC,IAAA,EAAM;AACT,IAAA,MAAA,CAAO,MAAM,uCAAuC,CAAA;AACpD,IAAA,OAAO,EAAE,MAAA,EAAQ,EAAC,EAAG,MAAM,IAAA,EAAK;AAAA,EAClC;AAEA,EAAA,MAAA,CAAO,KAAA,CAAM,CAAA,oBAAA,EAAuB,IAAI,CAAA,CAAE,CAAA;AAC1C,EAAA,MAAM,MAAA,GAAS,MAAM,YAAA,CAAa,IAAI,CAAA;AACtC,EAAA,OAAO,EAAE,QAAQ,IAAA,EAAK;AACxB;AAGA,eAAe,eAAe,GAAA,EAAqC;AACjE,EAAA,KAAA,MAAW,QAAQ,gBAAA,EAAkB;AACnC,IAAA,MAAM,SAAA,GAAY,WAAA,CAAY,GAAA,EAAK,IAAI,CAAA;AACvC,IAAA,IAAI,MAAM,MAAA,CAAO,SAAS,CAAA,EAAG,OAAO,SAAA;AAAA,EACtC;AACA,EAAA,OAAO,IAAA;AACT;AAMA,eAAe,aAAa,IAAA,EAA+B;AACzD,EAAA,IAAI,GAAA;AACJ,EAAA,IAAI;AAEF,IAAA,MAAM,GAAA,GAAM,GAAG,aAAA,CAAc,IAAI,EAAE,IAAI,CAAA,GAAA,EAAM,IAAA,CAAK,GAAA,EAAK,CAAA,CAAA;AACvD,IAAA,GAAA,GAAO,MAAM,OAAO,GAAA,CAAA;AAAA,EACtB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,IAAI,WAAA,CAAY,CAAA,4BAAA,EAA+B,IAAI,CAAA,CAAA,EAAI,EAAE,OAAO,CAAA;AAAA,EACxE;AAEA,EAAA,MAAM,WAAW,GAAA,CAAI,OAAA;AACrB,EAAA,IAAI,aAAa,MAAA,EAAW;AAC1B,IAAA,MAAM,IAAI,WAAA;AAAA,MACR,gBAAgB,IAAI,CAAA,0FAAA;AAAA,KAEtB;AAAA,EACF;AAEA,EAAA,OAAO,SAAA,CAAU,UAAyB,IAAI,CAAA;AAChD;AAGA,eAAe,SAAA,CACb,OACA,IAAA,EACiB;AACjB,EAAA,MAAM,QAAQ,OAAO,KAAA,KAAU,UAAA,GAAa,MAAM,OAAM,GAAI,KAAA;AAE5D,EAAA,IAAI,KAAA,KAAU,IAAA,IAAQ,OAAO,KAAA,KAAU,QAAA,EAAU;AAC/C,IAAA,MAAM,IAAI,WAAA;AAAA,MACR,gBAAgB,IAAI,CAAA,sDAAA;AAAA,KACtB;AAAA,EACF;AAEA,EAAA,OAAO,KAAA;AACT;;;ACpFO,SAAS,aAAA,CACd,GAAA,EACA,GAAA,EACA,UAAA,GAA4B,IAAA,EACZ;AAChB,EAAA,MAAM,OAAO,WAAA,CAAY,GAAA,EAAK,GAAA,CAAI,IAAA,IAAQ,SAAS,IAAI,CAAA;AAEvD,EAAA,MAAM,KAAA,GAAuB;AAAA,IAC3B,IAAA;AAAA,IACA,SAAS,WAAA,CAAY,IAAA,EAAM,GAAA,CAAI,OAAA,IAAW,SAAS,OAAO,CAAA;AAAA,IAC1D,WAAW,WAAA,CAAY,IAAA,EAAM,GAAA,CAAI,SAAA,IAAa,SAAS,SAAS,CAAA;AAAA,IAChE,QAAQ,WAAA,CAAY,IAAA,EAAM,GAAA,CAAI,MAAA,IAAU,SAAS,MAAM;AAAA,GACzD;AAEA,EAAA,OAAO,EAAE,GAAA,EAAK,KAAA,EAAO,UAAA,EAAW;AAClC;;;ACnBO,SAAS,SAAA,CAAU,MAAc,IAAA,EAAyB;AAC/D,EAAA,OAAO,EAAE,MAAM,IAAA,EAAK;AACtB;;;ACFA,eAAsB,gBAAgB,IAAA,EAAyC;AAC7E,EAAA,MAAM,IAAA,GAAO,WAAA,CAAY,IAAA,EAAM,mBAAmB,CAAA;AAClD,EAAA,IAAI,CAAE,MAAM,MAAA,CAAO,IAAI,GAAI,OAAO,IAAA;AAElC,EAAA,MAAM,IAAA,GAAO,MAAM,YAAA,CAAa,IAAI,CAAA;AACpC,EAAA,OAAO,SAAA,CAAU,MAAM,IAAI,CAAA;AAC7B;;;ACPA,IAAM,MAAA,GAAS,IAAI,QAAQ,CAAA,CAAA,CAAA;AAQpB,SAAS,YAAA,CAAa,OAAA,GAAyB,EAAC,EAAW;AAChE,EAAA,MAAM,EAAE,OAAA,GAAU,KAAA,EAAO,IAAA,GAAO,SAAQ,GAAI,OAAA;AAE5C,EAAA,OAAO;AAAA,IACL,KAAK,OAAA,EAAS;AACZ,MAAA,IAAA,CAAK,GAAA,CAAI,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IACjC,CAAA;AAAA,IACA,KAAK,OAAA,EAAS;AACZ,MAAA,IAAA,CAAK,IAAA,CAAK,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IAClC,CAAA;AAAA,IACA,MAAM,OAAA,EAAS;AACb,MAAA,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IACnC,CAAA;AAAA,IACA,MAAM,OAAA,EAAS;AACb,MAAA,IAAI,SAAS,IAAA,CAAK,GAAA,CAAI,GAAG,MAAM,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA;AAAA,IAC9C;AAAA,GACF;AACF;;;ACdA,eAAsB,cACpB,OAAA,EACkB;AAClB,EAAA,MAAM,EAAE,GAAA,EAAK,MAAA,EAAO,GAAI,OAAA;AAExB,EAAA,MAAM,MAAA,GAAS,MAAM,UAAA,CAAW;AAAA,IAC9B,GAAA;AAAA,IACA,MAAA;AAAA,IACA,GAAI,QAAQ,UAAA,KAAe,MAAA,GACvB,EAAE,UAAA,EAAY,OAAA,CAAQ,UAAA,EAAW,GACjC;AAAC,GACN,CAAA;AAED,EAAA,MAAM,SAAS,aAAA,CAAc,MAAA,CAAO,MAAA,EAAQ,GAAA,EAAK,OAAO,IAAI,CAAA;AAE5D,EAAA,OAAO,EAAE,GAAA,EAAK,MAAA,EAAQ,MAAA,EAAO;AAC/B;;;ACjBA,eAAsB,eAAe,OAAA,EAA0C;AAC7E,EAAA,MAAM,EAAE,KAAI,GAAI,OAAA;AAChB,EAAA,GAAA,CAAI,MAAA,CAAO,IAAA;AAAA,IACT;AAAA,GACF;AACF;AClBA,SAAS,GAAA,CAAI,KAAc,MAAA,EAAwB;AACjD,EAAA,OAAO,SAAS,GAAA,CAAI,MAAA,CAAO,KAAA,CAAM,IAAA,EAAM,MAAM,CAAA,IAAK,GAAA;AACpD;AAQA,eAAsB,eAAe,GAAA,EAAyC;AAC5E,EAAA,MAAM,EAAE,KAAA,EAAO,UAAA,EAAW,GAAI,GAAA,CAAI,MAAA;AAElC,EAAA,GAAA,CAAI,MAAA,CAAO,IAAA;AAAA,IACT,WAAW,UAAA,GAAa,GAAA,CAAI,GAAA,EAAK,UAAU,IAAI,2BAA2B,CAAA;AAAA,GAC5E;AACA,EAAA,GAAA,CAAI,MAAA,CAAO,KAAK,CAAA,WAAA,EAAc,GAAA,CAAI,KAAK,KAAA,CAAM,OAAO,CAAC,CAAA,CAAE,CAAA;AACvD,EAAA,GAAA,CAAI,MAAA,CAAO,KAAK,CAAA,WAAA,EAAc,GAAA,CAAI,KAAK,KAAA,CAAM,SAAS,CAAC,CAAA,CAAE,CAAA;AACzD,EAAA,GAAA,CAAI,MAAA,CAAO,KAAK,CAAA,WAAA,EAAc,GAAA,CAAI,KAAK,KAAA,CAAM,MAAM,CAAC,CAAA,CAAE,CAAA;AAEtD,EAAA,MAAM,KAAA,GAAQ,MAAM,eAAA,CAAgB,KAAA,CAAM,IAAI,CAAA;AAC9C,EAAA,IAAI,KAAA,EAAO;AACT,IAAA,GAAA,CAAI,MAAA,CAAO,KAAK,CAAA,YAAA,EAAe,GAAA,CAAI,KAAK,KAAA,CAAM,IAAI,CAAC,CAAA,CAAE,CAAA;AAAA,EACvD,CAAA,MAAO;AACL,IAAA,GAAA,CAAI,MAAA,CAAO,IAAA;AAAA,MACT;AAAA,KACF;AAAA,EACF;AAEA,EAAA,OAAO,KAAA;AACT;AAGA,eAAsB,kBAAA,CACpB,KACA,IAAA,EACe;AACf,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,MAAM,UAAU,GAAG,CAAA;AACnB,IAAA,GAAA,CAAI,MAAA,CAAO,KAAA,CAAM,CAAA,oBAAA,EAAuB,GAAG,CAAA,CAAE,CAAA;AAAA,EAC/C;AACF;;;AC3CO,IAAM,GAAA,GAAe;AAAA,EAC1B,IAAA,EAAM,KAAA;AAAA,EACN,WAAA,EAAa,8BAAA;AAAA,EACb,MAAM,IAAI,GAAA,EAAK;AACb,IAAA,MAAM,EAAE,OAAA,EAAS,SAAA,EAAU,GAAI,IAAI,MAAA,CAAO,KAAA;AAC1C,IAAA,MAAM,kBAAA,CAAmB,GAAA,EAAK,CAAC,OAAA,EAAS,SAAS,CAAC,CAAA;AAElD,IAAc,MAAM,cAAA,CAAe,GAAG;AACtC,IAAA,MAAM,cAAA,CAAe,EAAE,GAAW,CAAC,CAAA;AAAA,EACrC;AACF,CAAA;;;ACEA,eAAsB,SAAS,OAAA,EAAsC;AACnE,EAAA,MAAM,EAAE,KAAI,GAAI,OAAA;AAChB,EAAA,GAAA,CAAI,MAAA,CAAO,IAAA;AAAA,IACT;AAAA,GACF;AACF;;;ACjBO,IAAM,KAAA,GAAiB;AAAA,EAC5B,IAAA,EAAM,OAAA;AAAA,EACN,WAAA,EAAa,kCAAA;AAAA,EACb,MAAM,IAAI,GAAA,EAAK;AACb,IAAA,MAAM,EAAE,OAAA,EAAS,SAAA,EAAW,MAAA,EAAO,GAAI,IAAI,MAAA,CAAO,KAAA;AAClD,IAAA,MAAM,mBAAmB,GAAA,EAAK,CAAC,OAAA,EAAS,SAAA,EAAW,MAAM,CAAC,CAAA;AAE1D,IAAc,MAAM,cAAA,CAAe,GAAG;AACtC,IAAA,MAAM,QAAA,CAAS,EAAE,GAAW,CAAC,CAAA;AAAA,EAC/B;AACF,CAAA;;;ACDA,eAAsB,WAAW,OAAA,EAAwC;AACvE,EAAA,MAAM,EAAE,KAAI,GAAI,OAAA;AAChB,EAAA,GAAA,CAAI,MAAA,CAAO,IAAA;AAAA,IACT;AAAA,GACF;AACF;;;ACdO,IAAM,OAAA,GAAmB;AAAA,EAC9B,IAAA,EAAM,SAAA;AAAA,EACN,WAAA,EAAa,oCAAA;AAAA,EACb,MAAM,IAAI,GAAA,EAAK;AACb,IAAA,MAAM,mBAAmB,GAAA,EAAK,CAAC,IAAI,MAAA,CAAO,KAAA,CAAM,MAAM,CAAC,CAAA;AAEvD,IAAA,MAAM,eAAe,GAAG,CAAA;AACxB,IAAA,MAAM,UAAA,CAAW,EAAE,GAAA,EAAK,CAAA;AAAA,EAC1B;AACF,CAAA;;;ACLO,IAAM,QAAA,GAA8C;AAAA,EACzD,CAAC,GAAA,CAAI,IAAI,GAAG,GAAA;AAAA,EACZ,CAAC,KAAA,CAAM,IAAI,GAAG,KAAA;AAAA,EACd,CAAC,OAAA,CAAQ,IAAI,GAAG;AAClB;;;ACTO,SAAS,QAAA,GAAmB;AACjC,EAAA,MAAM,KAAA,GAAQ;AAAA,IACZ,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,OAAO,CAAA,kDAAA,CAAA;AAAA,IACvB,EAAA;AAAA,IACA,QAAA;AAAA,IACA,KAAK,QAAQ,CAAA,oBAAA,CAAA;AAAA,IACb,EAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,GAAA,CAAI,GAAG,MAAA,CAAO,IAAA,CAAK,QAAQ,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,KAAM,CAAA,CAAE,MAAM,CAAC,CAAA;AACpE,EAAA,KAAA,MAAW,OAAA,IAAW,MAAA,CAAO,MAAA,CAAO,QAAQ,CAAA,EAAG;AAC7C,IAAA,KAAA,CAAM,IAAA,CAAK,CAAA,EAAA,EAAK,OAAA,CAAQ,IAAA,CAAK,MAAA,CAAO,KAAK,CAAC,CAAA,EAAA,EAAK,OAAA,CAAQ,WAAW,CAAA,CAAE,CAAA;AAAA,EACtE;AAEA,EAAA,KAAA,CAAM,IAAA;AAAA,IACJ,EAAA;AAAA,IACA,UAAA;AAAA,IACA,iCAAA;AAAA,IACA;AAAA,GACF;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB;AAGO,SAAS,WAAA,GAAsB;AACpC,EAAA,OAAO,CAAA,EAAG,QAAQ,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA;AAChC;;;ACNA,eAAsB,GAAA,CACpB,IAAA,EACA,OAAA,GAAsB,EAAC,EACJ;AACnB,EAAA,MAAM,UAAU,IAAA,CAAK,QAAA,CAAS,WAAW,CAAA,IAAK,IAAA,CAAK,SAAS,SAAS,CAAA;AACrE,EAAA,MAAM,SAAS,OAAA,CAAQ,MAAA,IAAU,YAAA,CAAa,EAAE,SAAS,CAAA;AACzD,EAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,GAAA,IAAO,OAAA,CAAQ,GAAA,EAAI;AAEvC,EAAA,MAAM,CAAC,KAAA,EAAO,GAAG,IAAI,CAAA,GAAI,IAAA,CAAK,MAAA,CAAO,CAAC,GAAA,KAAQ,CAAC,YAAA,CAAa,GAAG,CAAC,CAAA;AAEhE,EAAA,IAAI,CAAC,KAAA,IAAS,KAAA,KAAU,YAAY,KAAA,KAAU,IAAA,IAAQ,UAAU,MAAA,EAAQ;AACtE,IAAA,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AACtB,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,IAAI,KAAA,KAAU,WAAA,IAAe,KAAA,KAAU,IAAA,EAAM;AAC3C,IAAA,MAAA,CAAO,IAAA,CAAK,aAAa,CAAA;AACzB,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,MAAM,OAAA,GAAU,SAAS,KAAK,CAAA;AAC9B,EAAA,IAAI,CAAC,OAAA,EAAS;AACZ,IAAA,MAAA,CAAO,KAAA,CAAM,CAAA,kBAAA,EAAqB,KAAK,CAAA,CAAA,CAAG,CAAA;AAC1C,IAAA,MAAA,CAAO,IAAA,CAAK,UAAU,CAAA;AACtB,IAAA,OAAO,CAAA;AAAA,EACT;AAEA,EAAA,MAAM,MAAM,MAAM,aAAA,CAAc,EAAE,GAAA,EAAK,QAAQ,CAAA;AAC/C,EAAA,MAAM,OAAA,CAAQ,GAAA,CAAI,GAAA,EAAK,IAAI,CAAA;AAC3B,EAAA,OAAO,CAAA;AACT;AAGA,SAAS,aAAa,GAAA,EAAsB;AAC1C,EAAA,OAAO,GAAA,KAAQ,eAAe,GAAA,KAAQ,SAAA;AACxC","file":"chunk-PSXNP5S5.js","sourcesContent":["/** Product name, used in CLI banners and logs. */\nexport const APP_NAME = \"vantris\";\n\n/** Current Vantris version. Kept in sync with package.json at release time. */\nexport const VERSION = \"0.1.0\";\n\n/** The HTML entry filename Vantris looks for at the project root. */\nexport const HTML_ENTRY_FILENAME = \"index.html\";\n\n/** Default directory values, relative to the project root. */\nexport const DEFAULTS = {\n  root: \".\",\n  rootDir: \"./src\",\n  publicDir: \"./public\",\n  outDir: \"./dist\",\n} as const;\n\n/** Config filenames Vantris will look for, in priority order. */\nexport const CONFIG_FILENAMES = [\n  \"vantris.config.ts\",\n  \"vantris.config.js\",\n  \"vantris.config.mjs\",\n] as const;\n","/**\n * Base class for all errors thrown intentionally by Vantris. The CLI layer can\n * recognise these and render them cleanly (without a stack trace), while\n * unexpected errors keep their full trace.\n */\nexport class VantrisError extends Error {\n  override readonly name: string = \"VantrisError\";\n\n  constructor(message: string, options?: ErrorOptions) {\n    super(message, options);\n  }\n}\n\n/** Thrown when configuration is missing, malformed, or fails to load. */\nexport class ConfigError extends VantrisError {\n  override readonly name = \"ConfigError\";\n}\n\n/** Thrown when the project's HTML entry cannot be found. */\nexport class HtmlEntryError extends VantrisError {\n  override readonly name = \"HtmlEntryError\";\n}\n\n/** Thrown for functionality declared but not yet implemented in this version. */\nexport class NotImplementedError extends VantrisError {\n  override readonly name = \"NotImplementedError\";\n}\n\n/** Narrowing helper. */\nexport function isVantrisError(error: unknown): error is VantrisError {\n  return error instanceof VantrisError;\n}\n","import { mkdir, readFile, stat } from \"node:fs/promises\";\n\n/** Returns `true` if `path` exists and is a regular file. */\nexport async function isFile(path: string): Promise<boolean> {\n  try {\n    return (await stat(path)).isFile();\n  } catch {\n    return false;\n  }\n}\n\n/** Reads a UTF-8 text file. */\nexport function readTextFile(path: string): Promise<string> {\n  return readFile(path, \"utf8\");\n}\n\n/** Creates a directory (and any missing parents) if it does not exist. */\nexport async function ensureDir(path: string): Promise<void> {\n  await mkdir(path, { recursive: true });\n}\n","import { isAbsolute, resolve } from \"node:path\";\n\n/**\n * Resolves `target` against `base`, returning an absolute path.\n * Absolute targets are returned untouched.\n */\nexport function resolveFrom(base: string, target: string): string {\n  return isAbsolute(target) ? target : resolve(base, target);\n}\n","import { pathToFileURL } from \"node:url\";\nimport type { Config, ConfigInput } from \"../types/config.js\";\nimport type { Logger } from \"../types/logger.js\";\nimport { CONFIG_FILENAMES } from \"../shared/constants.js\";\nimport { ConfigError } from \"../shared/errors.js\";\nimport { isFile } from \"../utils/fs.js\";\nimport { resolveFrom } from \"../utils/paths.js\";\n\nexport interface LoadConfigOptions {\n  /** Directory to search for a config file. */\n  cwd: string;\n  /** Logger for diagnostics. */\n  logger: Logger;\n  /** Explicit config file path; bypasses filename discovery. */\n  configFile?: string;\n}\n\nexport interface LoadedConfig {\n  /** Parsed configuration. Empty object when no config file is present. */\n  config: Config;\n  /** Absolute path of the file that was loaded, or `null` when none. */\n  file: string | null;\n}\n\n/**\n * Locates and loads a `vantris.config.*` file from `cwd`.\n *\n * The actual module evaluation is isolated here so the loading strategy\n * (native TS stripping today; a bundled loader such as esbuild/jiti later)\n * can change without affecting any caller. A missing config is not an error —\n * defaults take over downstream.\n */\nexport async function loadConfig(\n  options: LoadConfigOptions,\n): Promise<LoadedConfig> {\n  const { cwd, logger } = options;\n\n  const file = options.configFile\n    ? resolveFrom(cwd, options.configFile)\n    : await findConfigFile(cwd);\n\n  if (!file) {\n    logger.debug(\"No config file found; using defaults.\");\n    return { config: {}, file: null };\n  }\n\n  logger.debug(`Loading config from ${file}`);\n  const config = await importConfig(file);\n  return { config, file };\n}\n\n/** Returns the first existing config file in {@link CONFIG_FILENAMES}. */\nasync function findConfigFile(cwd: string): Promise<string | null> {\n  for (const name of CONFIG_FILENAMES) {\n    const candidate = resolveFrom(cwd, name);\n    if (await isFile(candidate)) return candidate;\n  }\n  return null;\n}\n\n/**\n * Imports a config module and normalises its export to a {@link Config}.\n * Relies on the Node runtime's native TypeScript support for `.ts` files.\n */\nasync function importConfig(file: string): Promise<Config> {\n  let mod: { default?: unknown };\n  try {\n    // Cache-bust so repeated loads (e.g. a future config-watch mode) re-read.\n    const url = `${pathToFileURL(file).href}?t=${Date.now()}`;\n    mod = (await import(url)) as { default?: unknown };\n  } catch (cause) {\n    throw new ConfigError(`Failed to load config file: ${file}`, { cause });\n  }\n\n  const exported = mod.default;\n  if (exported === undefined) {\n    throw new ConfigError(\n      `Config file \"${file}\" has no default export. ` +\n        `Export your config with \\`export default defineConfig({ ... })\\`.`,\n    );\n  }\n\n  return normalise(exported as ConfigInput, file);\n}\n\n/** Resolves a {@link ConfigInput} (object or factory) into a {@link Config}. */\nasync function normalise(\n  input: ConfigInput,\n  file: string,\n): Promise<Config> {\n  const value = typeof input === \"function\" ? await input() : input;\n\n  if (value === null || typeof value !== \"object\") {\n    throw new ConfigError(\n      `Config file \"${file}\" must export an object (or a function returning one).`,\n    );\n  }\n\n  return value;\n}\n","import type { Config } from \"../types/config.js\";\nimport type { ResolvedConfig } from \"../types/config-resolved.js\";\nimport type { ResolvedPaths } from \"../types/paths.js\";\nimport { DEFAULTS } from \"../shared/constants.js\";\nimport { resolveFrom } from \"../utils/paths.js\";\n\n/**\n * Applies defaults to a raw {@link Config} and resolves every directory to an\n * absolute path. This is the single source of truth for default values and\n * path resolution — no other module should re-derive these.\n *\n * @param raw        User configuration (after loading; may be empty).\n * @param cwd        Working directory the invocation started from.\n * @param configFile Absolute path of the loaded config file, or `null`.\n */\nexport function resolveConfig(\n  raw: Config,\n  cwd: string,\n  configFile: string | null = null,\n): ResolvedConfig {\n  const root = resolveFrom(cwd, raw.root ?? DEFAULTS.root);\n\n  const paths: ResolvedPaths = {\n    root,\n    rootDir: resolveFrom(root, raw.rootDir ?? DEFAULTS.rootDir),\n    publicDir: resolveFrom(root, raw.publicDir ?? DEFAULTS.publicDir),\n    outDir: resolveFrom(root, raw.outDir ?? DEFAULTS.outDir),\n  };\n\n  return { raw, paths, configFile };\n}\n","import type { HtmlEntry } from \"../types/html.js\";\n\n/**\n * Parses raw HTML into an {@link HtmlEntry}.\n *\n * v0.1.0 keeps this intentionally minimal: it only wraps the file path and\n * contents. The function exists as the single, isolated home for HTML\n * analysis so later versions can grow it (extracting `<script type=\"module\">`\n * entries, asset references, injection points for HMR) without scattering\n * parsing logic across the codebase.\n */\nexport function parseHtml(file: string, html: string): HtmlEntry {\n  return { file, html };\n}\n","import type { HtmlEntry } from \"../types/html.js\";\nimport { HTML_ENTRY_FILENAME } from \"../shared/constants.js\";\nimport { isFile, readTextFile } from \"../utils/fs.js\";\nimport { resolveFrom } from \"../utils/paths.js\";\nimport { parseHtml } from \"./parse.js\";\n\n/**\n * Locates the project's `index.html` entry at `root`.\n *\n * @returns The parsed {@link HtmlEntry}, or `null` if no entry exists.\n */\nexport async function detectHtmlEntry(root: string): Promise<HtmlEntry | null> {\n  const file = resolveFrom(root, HTML_ENTRY_FILENAME);\n  if (!(await isFile(file))) return null;\n\n  const html = await readTextFile(file);\n  return parseHtml(file, html);\n}\n","import type { Logger } from \"../types/logger.js\";\nimport { APP_NAME } from \"./constants.js\";\n\nexport interface LoggerOptions {\n  /** When `false`, `debug` calls are dropped. @default false */\n  verbose?: boolean;\n  /** Sink for output. Defaults to the console; overridable for tests. */\n  sink?: Pick<Console, \"log\" | \"warn\" | \"error\">;\n}\n\nconst prefix = `[${APP_NAME}]`;\n\n/**\n * Creates the default console-backed {@link Logger}.\n *\n * The sink is injectable so tests can capture output, and verbosity is a\n * construction-time concern rather than a global flag.\n */\nexport function createLogger(options: LoggerOptions = {}): Logger {\n  const { verbose = false, sink = console } = options;\n\n  return {\n    info(message) {\n      sink.log(`${prefix} ${message}`);\n    },\n    warn(message) {\n      sink.warn(`${prefix} ${message}`);\n    },\n    error(message) {\n      sink.error(`${prefix} ${message}`);\n    },\n    debug(message) {\n      if (verbose) sink.log(`${prefix} ${message}`);\n    },\n  };\n}\n","import type { Context } from \"../types/context.js\";\nimport type { Logger } from \"../types/logger.js\";\nimport { loadConfig } from \"../config/load.js\";\nimport { resolveConfig } from \"../config/resolve.js\";\n\nexport interface CreateContextOptions {\n  /** Working directory the command was invoked from. */\n  cwd: string;\n  /** Injected logger. */\n  logger: Logger;\n  /** Optional explicit config file path. */\n  configFile?: string;\n}\n\n/**\n * Builds the {@link Context} shared by every command: it loads the user config,\n * applies defaults, resolves paths, and bundles the injected services.\n *\n * Centralising construction here means commands never reach for global state —\n * everything they need arrives through the returned context.\n */\nexport async function createContext(\n  options: CreateContextOptions,\n): Promise<Context> {\n  const { cwd, logger } = options;\n\n  const loaded = await loadConfig({\n    cwd,\n    logger,\n    ...(options.configFile !== undefined\n      ? { configFile: options.configFile }\n      : {}),\n  });\n\n  const config = resolveConfig(loaded.config, cwd, loaded.file);\n\n  return { cwd, config, logger };\n}\n","import type { Context } from \"../types/context.js\";\nimport type { HtmlEntry } from \"../types/html.js\";\n\n/**\n * Options handed to the dev server. Kept here so the contract is stable before\n * the implementation lands.\n */\nexport interface DevServerOptions {\n  ctx: Context;\n  /** The detected HTML entry, when present. */\n  entry: HtmlEntry | null;\n}\n\n/**\n * Starts the development server.\n *\n * Reserved for a future version (planned: an H3-based server with HMR). The\n * seam exists now so `commands/dev` can already delegate here; only this file\n * changes when the engine is implemented.\n */\nexport async function startDevServer(options: DevServerOptions): Promise<void> {\n  const { ctx } = options;\n  ctx.logger.info(\n    \"dev server is not implemented in v0.1.0 (planned: H3 + HMR).\",\n  );\n}\n","import { relative } from \"node:path\";\nimport type { Context } from \"../types/context.js\";\nimport type { HtmlEntry } from \"../types/html.js\";\nimport { detectHtmlEntry } from \"../html/index.js\";\nimport { ensureDir } from \"../utils/fs.js\";\n\n/** Renders a path relative to the project root for tidy log output. */\nfunction rel(ctx: Context, target: string): string {\n  return relative(ctx.config.paths.root, target) || \".\";\n}\n\n/**\n * Logs the resolved configuration and detects the HTML entry — the shared\n * preamble every command runs before delegating to its (future) engine.\n *\n * @returns The detected HTML entry, or `null` when none exists.\n */\nexport async function inspectProject(ctx: Context): Promise<HtmlEntry | null> {\n  const { paths, configFile } = ctx.config;\n\n  ctx.logger.info(\n    `config: ${configFile ? rel(ctx, configFile) : \"defaults (no config file)\"}`,\n  );\n  ctx.logger.info(`rootDir:   ${rel(ctx, paths.rootDir)}`);\n  ctx.logger.info(`publicDir: ${rel(ctx, paths.publicDir)}`);\n  ctx.logger.info(`outDir:    ${rel(ctx, paths.outDir)}`);\n\n  const entry = await detectHtmlEntry(paths.root);\n  if (entry) {\n    ctx.logger.info(`html entry: ${rel(ctx, entry.file)}`);\n  } else {\n    ctx.logger.warn(\n      \"no index.html found at the project root; nothing to serve yet.\",\n    );\n  }\n\n  return entry;\n}\n\n/** Ensures the given directories exist, creating them as needed. */\nexport async function prepareDirectories(\n  ctx: Context,\n  dirs: readonly string[],\n): Promise<void> {\n  for (const dir of dirs) {\n    await ensureDir(dir);\n    ctx.logger.debug(`prepared directory: ${dir}`);\n  }\n}\n","import type { Command } from \"../types/command.js\";\nimport { startDevServer } from \"../server/index.js\";\nimport { inspectProject, prepareDirectories } from \"./support.js\";\n\n/** `vantris dev` — start the development server. */\nexport const dev: Command = {\n  name: \"dev\",\n  description: \"Start the development server\",\n  async run(ctx) {\n    const { rootDir, publicDir } = ctx.config.paths;\n    await prepareDirectories(ctx, [rootDir, publicDir]);\n\n    const entry = await inspectProject(ctx);\n    await startDevServer({ ctx, entry });\n  },\n};\n","import type { Context } from \"../types/context.js\";\nimport type { HtmlEntry } from \"../types/html.js\";\n\n/** Options handed to the build pipeline. */\nexport interface BuildOptions {\n  ctx: Context;\n  /** The detected HTML entry, when present. */\n  entry: HtmlEntry | null;\n}\n\n/**\n * Produces a production build into `outDir`.\n *\n * Reserved for a future version (planned: Rolldown for bundling, esbuild for\n * transforms). The seam exists now so `commands/build` can already delegate\n * here; only this file changes when the engine is implemented.\n */\nexport async function runBuild(options: BuildOptions): Promise<void> {\n  const { ctx } = options;\n  ctx.logger.info(\n    \"build is not implemented in v0.1.0 (planned: Rolldown + esbuild).\",\n  );\n}\n","import type { Command } from \"../types/command.js\";\nimport { runBuild } from \"../build/index.js\";\nimport { inspectProject, prepareDirectories } from \"./support.js\";\n\n/** `vantris build` — produce a production build. */\nexport const build: Command = {\n  name: \"build\",\n  description: \"Build the project for production\",\n  async run(ctx) {\n    const { rootDir, publicDir, outDir } = ctx.config.paths;\n    await prepareDirectories(ctx, [rootDir, publicDir, outDir]);\n\n    const entry = await inspectProject(ctx);\n    await runBuild({ ctx, entry });\n  },\n};\n","import type { Context } from \"../types/context.js\";\n\n/** Options handed to the preview server. */\nexport interface PreviewOptions {\n  ctx: Context;\n}\n\n/**\n * Serves a previously produced production build from `outDir`.\n *\n * Reserved for a future version (planned: a static server over the build\n * output). The seam exists now so `commands/preview` can already delegate\n * here; only this file changes when the engine is implemented.\n */\nexport async function runPreview(options: PreviewOptions): Promise<void> {\n  const { ctx } = options;\n  ctx.logger.info(\n    \"preview is not implemented in v0.1.0 (planned: static server over outDir).\",\n  );\n}\n","import type { Command } from \"../types/command.js\";\nimport { runPreview } from \"../preview/index.js\";\nimport { inspectProject, prepareDirectories } from \"./support.js\";\n\n/** `vantris preview` — serve a production build locally. */\nexport const preview: Command = {\n  name: \"preview\",\n  description: \"Locally preview a production build\",\n  async run(ctx) {\n    await prepareDirectories(ctx, [ctx.config.paths.outDir]);\n\n    await inspectProject(ctx);\n    await runPreview({ ctx });\n  },\n};\n","import type { Command } from \"../types/command.js\";\nimport { dev } from \"./dev.js\";\nimport { build } from \"./build.js\";\nimport { preview } from \"./preview.js\";\n\n/**\n * The command registry. The CLI routes purely against this map, so adding a\n * command is a one-line registration here plus its module — no CLI changes.\n */\nexport const commands: Readonly<Record<string, Command>> = {\n  [dev.name]: dev,\n  [build.name]: build,\n  [preview.name]: preview,\n};\n\nexport type CommandName = keyof typeof commands;\n\nexport { dev, build, preview };\n","import { commands } from \"../commands/index.js\";\nimport { APP_NAME, VERSION } from \"../shared/constants.js\";\n\n/** Builds the help text listing every registered command. */\nexport function helpText(): string {\n  const lines = [\n    `${APP_NAME} v${VERSION} — a modern bundler for JavaScript/TypeScript`,\n    \"\",\n    \"Usage:\",\n    `  ${APP_NAME} <command> [options]`,\n    \"\",\n    \"Commands:\",\n  ];\n\n  const width = Math.max(...Object.keys(commands).map((n) => n.length));\n  for (const command of Object.values(commands)) {\n    lines.push(`  ${command.name.padEnd(width)}  ${command.description}`);\n  }\n\n  lines.push(\n    \"\",\n    \"Options:\",\n    \"  -h, --help     Show this help\",\n    \"  -v, --version  Show the version number\",\n  );\n\n  return lines.join(\"\\n\");\n}\n\n/** Builds the version line. */\nexport function versionText(): string {\n  return `${APP_NAME} v${VERSION}`;\n}\n","import type { Logger } from \"../types/logger.js\";\nimport { commands } from \"../commands/index.js\";\nimport { createContext } from \"../shared/context.js\";\nimport { createLogger } from \"../shared/logger.js\";\nimport { helpText, versionText } from \"./help.js\";\n\nexport interface RunOptions {\n  /** Working directory; defaults to `process.cwd()`. */\n  cwd?: string;\n  /** Logger override, primarily for tests. */\n  logger?: Logger;\n}\n\n/** Process exit codes used by the CLI. */\nexport const enum ExitCode {\n  Ok = 0,\n  Error = 1,\n}\n\n/**\n * Parses arguments and routes to a command. This is the entire CLI surface:\n * it owns argument handling and dispatch only — never command behaviour, which\n * lives behind the {@link commands} registry.\n *\n * @returns A process exit code.\n */\nexport async function run(\n  argv: readonly string[],\n  options: RunOptions = {},\n): Promise<ExitCode> {\n  const verbose = argv.includes(\"--verbose\") || argv.includes(\"--debug\");\n  const logger = options.logger ?? createLogger({ verbose });\n  const cwd = options.cwd ?? process.cwd();\n\n  const [first, ...rest] = argv.filter((arg) => !isGlobalFlag(arg));\n\n  if (!first || first === \"--help\" || first === \"-h\" || first === \"help\") {\n    logger.info(helpText());\n    return ExitCode.Ok;\n  }\n\n  if (first === \"--version\" || first === \"-v\") {\n    logger.info(versionText());\n    return ExitCode.Ok;\n  }\n\n  const command = commands[first];\n  if (!command) {\n    logger.error(`Unknown command: \"${first}\"`);\n    logger.info(helpText());\n    return ExitCode.Error;\n  }\n\n  const ctx = await createContext({ cwd, logger });\n  await command.run(ctx, rest);\n  return ExitCode.Ok;\n}\n\n/** Flags handled by the runner itself rather than passed to commands. */\nfunction isGlobalFlag(arg: string): boolean {\n  return arg === \"--verbose\" || arg === \"--debug\";\n}\n"]}

package/dist/cli/index.d.ts

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

package/dist/cli/index.js

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+import { run, createLogger, isVantrisError } from '../chunk-PSXNP5S5.js';
+
+// src/cli/index.ts
+async function main() {
+  try {
+    const code = await run(process.argv.slice(2));
+    process.exitCode = code;
+  } catch (error) {
+    const logger = createLogger();
+    if (isVantrisError(error)) {
+      logger.error(error.message);
+    } else {
+      logger.error("An unexpected error occurred:");
+      logger.error(error instanceof Error ? error.stack ?? error.message : String(error));
+    }
+    process.exitCode = 1 /* Error */;
+  }
+}
+void main();
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;;AASA,eAAe,IAAA,GAAsB;AACnC,EAAA,IAAI;AACF,IAAA,MAAM,OAAO,MAAM,GAAA,CAAI,QAAQ,IAAA,CAAK,KAAA,CAAM,CAAC,CAAC,CAAA;AAC5C,IAAA,OAAA,CAAQ,QAAA,GAAW,IAAA;AAAA,EACrB,SAAS,KAAA,EAAO;AACd,IAAA,MAAM,SAAS,YAAA,EAAa;AAC5B,IAAA,IAAI,cAAA,CAAe,KAAK,CAAA,EAAG;AAEzB,MAAA,MAAA,CAAO,KAAA,CAAM,MAAM,OAAO,CAAA;AAAA,IAC5B,CAAA,MAAO;AACL,MAAA,MAAA,CAAO,MAAM,+BAA+B,CAAA;AAC5C,MAAA,MAAA,CAAO,KAAA,CAAM,iBAAiB,KAAA,GAAS,KAAA,CAAM,SAAS,KAAA,CAAM,OAAA,GAAW,MAAA,CAAO,KAAK,CAAC,CAAA;AAAA,IACtF;AACA,IAAA,OAAA,CAAQ,QAAA,GAAA,CAAA;AAAA,EACV;AACF;AAEA,KAAK,IAAA,EAAK","file":"index.js","sourcesContent":["#!/usr/bin/env node\nimport { createLogger } from \"../shared/logger.js\";\nimport { isVantrisError } from \"../shared/errors.js\";\nimport { ExitCode, run } from \"./run.js\";\n\n/**\n * Binary entry point. Owns process concerns only — argv intake, exit codes,\n * and top-level error rendering — and delegates all routing to {@link run}.\n */\nasync function main(): Promise<void> {\n  try {\n    const code = await run(process.argv.slice(2));\n    process.exitCode = code;\n  } catch (error) {\n    const logger = createLogger();\n    if (isVantrisError(error)) {\n      // Expected, user-facing failures: show the message, skip the stack.\n      logger.error(error.message);\n    } else {\n      logger.error(\"An unexpected error occurred:\");\n      logger.error(error instanceof Error ? (error.stack ?? error.message) : String(error));\n    }\n    process.exitCode = ExitCode.Error;\n  }\n}\n\nvoid main();\n"]}

package/dist/index.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Public, user-facing configuration for Vantris.
+ *
+ * Every field is optional: a project with zero configuration must still build
+ * and run using the documented defaults. This interface is intentionally the
+ * single extension point through which future versions will grow (plugins,
+ * build options, HMR, server tuning, …) without breaking existing configs.
+ */
+interface Config {
+    /**
+     * Project root. Resolved relative to the current working directory.
+     * The `index.html` entry and every other directory below are resolved
+     * relative to this root.
+     *
+     * @default "."
+     */
+    root?: string;
+    /**
+     * Directory containing application source files.
+     *
+     * @default "./src"
+     */
+    rootDir?: string;
+    /**
+     * Directory of static assets served as-is (copied verbatim on build).
+     *
+     * @default "./public"
+     */
+    publicDir?: string;
+    /**
+     * Output directory for production builds.
+     *
+     * @default "./dist"
+     */
+    outDir?: string;
+}
+/**
+ * A factory form of {@link Config}. Supporting a function (sync or async)
+ * lets configs react to environment/CLI input in later versions without an
+ * API change.
+ */
+type ConfigFn = () => Config | Promise<Config>;
+/** Anything accepted by {@link defineConfig}. */
+type ConfigInput = Config | ConfigFn;
+
+/**
+ * Identity helper that gives config authors full type-checking and
+ * autocompletion in `vantris.config.ts` / `vantris.config.js`.
+ *
+ * Accepts either a {@link Config} object or a (possibly async) factory, so the
+ * same entry point keeps working as configuration grows more dynamic.
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from "vantris";
+ *
+ * export default defineConfig({
+ *   rootDir: "./src",
+ *   outDir: "./dist",
+ * });
+ * ```
+ */
+declare function defineConfig(config: Config): Config;
+declare function defineConfig(config: ConfigInput): ConfigInput;
+
+/**
+ * Minimal logging contract injected throughout Vantris.
+ *
+ * Depending on an interface (rather than calling `console` directly) keeps the
+ * core testable and lets future versions swap in a richer, level-aware logger
+ * without touching call sites.
+ */
+interface Logger {
+    info(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    /** Verbose diagnostics; may be a no-op depending on configuration. */
+    debug(message: string): void;
+}
+
+interface LoadConfigOptions {
+    /** Directory to search for a config file. */
+    cwd: string;
+    /** Logger for diagnostics. */
+    logger: Logger;
+    /** Explicit config file path; bypasses filename discovery. */
+    configFile?: string;
+}
+interface LoadedConfig {
+    /** Parsed configuration. Empty object when no config file is present. */
+    config: Config;
+    /** Absolute path of the file that was loaded, or `null` when none. */
+    file: string | null;
+}
+/**
+ * Locates and loads a `vantris.config.*` file from `cwd`.
+ *
+ * The actual module evaluation is isolated here so the loading strategy
+ * (native TS stripping today; a bundled loader such as esbuild/jiti later)
+ * can change without affecting any caller. A missing config is not an error —
+ * defaults take over downstream.
+ */
+declare function loadConfig(options: LoadConfigOptions): Promise<LoadedConfig>;
+
+/**
+ * Fully resolved, absolute filesystem paths derived from a {@link Config}.
+ *
+ * Commands and subsystems should depend on this resolved shape rather than on
+ * the raw user config, so that path resolution lives in exactly one place.
+ */
+interface ResolvedPaths {
+    /** Absolute project root. */
+    root: string;
+    /** Absolute source directory. */
+    rootDir: string;
+    /** Absolute public/static directory. */
+    publicDir: string;
+    /** Absolute build output directory. */
+    outDir: string;
+}
+
+/**
+ * A {@link Config} after defaults have been applied and paths resolved.
+ *
+ * This is what the rest of the system consumes. Keeping it separate from the
+ * user-facing {@link Config} means defaults and resolution rules can evolve
+ * without forcing optionality onto every internal consumer.
+ */
+interface ResolvedConfig {
+    /** The raw configuration as authored by the user (post-normalisation). */
+    readonly raw: Config;
+    /** Absolute paths derived from the configuration. */
+    readonly paths: ResolvedPaths;
+    /** Absolute path of the config file that was loaded, if any. */
+    readonly configFile: string | null;
+}
+
+/**
+ * Applies defaults to a raw {@link Config} and resolves every directory to an
+ * absolute path. This is the single source of truth for default values and
+ * path resolution — no other module should re-derive these.
+ *
+ * @param raw        User configuration (after loading; may be empty).
+ * @param cwd        Working directory the invocation started from.
+ * @param configFile Absolute path of the loaded config file, or `null`.
+ */
+declare function resolveConfig(raw: Config, cwd: string, configFile?: string | null): ResolvedConfig;
+
+/**
+ * The HTML entry point of a project, as discovered and parsed by the
+ * `html` subsystem. Parsing is deliberately minimal in v0.1.0 — only what is
+ * needed to locate the entry — but the shape anticipates richer analysis
+ * (script tags, module graph roots, asset references) in later versions.
+ */
+interface HtmlEntry {
+    /** Absolute path to the `index.html` file. */
+    file: string;
+    /** Raw HTML contents. */
+    html: string;
+}
+
+/**
+ * Locates the project's `index.html` entry at `root`.
+ *
+ * @returns The parsed {@link HtmlEntry}, or `null` if no entry exists.
+ */
+declare function detectHtmlEntry(root: string): Promise<HtmlEntry | null>;
+
+/**
+ * Parses raw HTML into an {@link HtmlEntry}.
+ *
+ * v0.1.0 keeps this intentionally minimal: it only wraps the file path and
+ * contents. The function exists as the single, isolated home for HTML
+ * analysis so later versions can grow it (extracting `<script type="module">`
+ * entries, asset references, injection points for HMR) without scattering
+ * parsing logic across the codebase.
+ */
+declare function parseHtml(file: string, html: string): HtmlEntry;
+
+/** Current Vantris version. Kept in sync with package.json at release time. */
+declare const VERSION = "0.1.0";
+
+interface LoggerOptions {
+    /** When `false`, `debug` calls are dropped. @default false */
+    verbose?: boolean;
+    /** Sink for output. Defaults to the console; overridable for tests. */
+    sink?: Pick<Console, "log" | "warn" | "error">;
+}
+/**
+ * Creates the default console-backed {@link Logger}.
+ *
+ * The sink is injectable so tests can capture output, and verbosity is a
+ * construction-time concern rather than a global flag.
+ */
+declare function createLogger(options?: LoggerOptions): Logger;
+
+/**
+ * The execution context threaded into every command.
+ *
+ * It bundles the resolved configuration and the injected services a command
+ * may need. Commands receive everything they depend on through this object —
+ * there is no hidden global state — which keeps them pure and testable.
+ */
+interface Context {
+    /** Absolute working directory the invocation started from. */
+    readonly cwd: string;
+    /** Resolved configuration (defaults applied, paths absolute). */
+    readonly config: ResolvedConfig;
+    /** Injected logger. */
+    readonly logger: Logger;
+}
+
+interface CreateContextOptions {
+    /** Working directory the command was invoked from. */
+    cwd: string;
+    /** Injected logger. */
+    logger: Logger;
+    /** Optional explicit config file path. */
+    configFile?: string;
+}
+/**
+ * Builds the {@link Context} shared by every command: it loads the user config,
+ * applies defaults, resolves paths, and bundles the injected services.
+ *
+ * Centralising construction here means commands never reach for global state —
+ * everything they need arrives through the returned context.
+ */
+declare function createContext(options: CreateContextOptions): Promise<Context>;
+
+/**
+ * Base class for all errors thrown intentionally by Vantris. The CLI layer can
+ * recognise these and render them cleanly (without a stack trace), while
+ * unexpected errors keep their full trace.
+ */
+declare class VantrisError extends Error {
+    readonly name: string;
+    constructor(message: string, options?: ErrorOptions);
+}
+/** Thrown when configuration is missing, malformed, or fails to load. */
+declare class ConfigError extends VantrisError {
+    readonly name = "ConfigError";
+}
+/** Thrown when the project's HTML entry cannot be found. */
+declare class HtmlEntryError extends VantrisError {
+    readonly name = "HtmlEntryError";
+}
+/** Thrown for functionality declared but not yet implemented in this version. */
+declare class NotImplementedError extends VantrisError {
+    readonly name = "NotImplementedError";
+}
+/** Narrowing helper. */
+declare function isVantrisError(error: unknown): error is VantrisError;
+
+/**
+ * A single CLI command. The CLI layer only knows about this contract; it never
+ * contains command logic itself. New commands are added by implementing this
+ * interface and registering them — no CLI refactor required.
+ */
+interface Command {
+    /** Invocation name, e.g. `"dev"`. */
+    readonly name: string;
+    /** One-line description shown in help output. */
+    readonly description: string;
+    /**
+     * Execute the command.
+     *
+     * @param ctx  Fully-built execution context.
+     * @param args Remaining positional/flag arguments after the command name.
+     */
+    run(ctx: Context, args: readonly string[]): Promise<void> | void;
+}
+
+/**
+ * The command registry. The CLI routes purely against this map, so adding a
+ * command is a one-line registration here plus its module — no CLI changes.
+ */
+declare const commands: Readonly<Record<string, Command>>;
+
+interface RunOptions {
+    /** Working directory; defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Logger override, primarily for tests. */
+    logger?: Logger;
+}
+/** Process exit codes used by the CLI. */
+declare const enum ExitCode {
+    Ok = 0,
+    Error = 1
+}
+/**
+ * Parses arguments and routes to a command. This is the entire CLI surface:
+ * it owns argument handling and dispatch only — never command behaviour, which
+ * lives behind the {@link commands} registry.
+ *
+ * @returns A process exit code.
+ */
+declare function run(argv: readonly string[], options?: RunOptions): Promise<ExitCode>;
+
+export { type Command, type Config, ConfigError, type ConfigFn, type ConfigInput, type Context, type HtmlEntry, HtmlEntryError, type Logger, NotImplementedError, type ResolvedConfig, type ResolvedPaths, VERSION, VantrisError, commands, createContext, createLogger, defineConfig, detectHtmlEntry, isVantrisError, loadConfig, parseHtml, resolveConfig, run };

package/dist/index.js

@@ -0,0 +1,10 @@
+export { ConfigError, HtmlEntryError, NotImplementedError, VERSION, VantrisError, commands, createContext, createLogger, detectHtmlEntry, isVantrisError, loadConfig, parseHtml, resolveConfig, run } from './chunk-PSXNP5S5.js';
+
+// src/config/define-config.ts
+function defineConfig(config) {
+  return config;
+}
+
+export { defineConfig };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/define-config.ts"],"names":[],"mappings":";;;AAqBO,SAAS,aAAa,MAAA,EAAkC;AAC7D,EAAA,OAAO,MAAA;AACT","file":"index.js","sourcesContent":["import type { Config, ConfigInput } from \"../types/config.js\";\n\n/**\n * Identity helper that gives config authors full type-checking and\n * autocompletion in `vantris.config.ts` / `vantris.config.js`.\n *\n * Accepts either a {@link Config} object or a (possibly async) factory, so the\n * same entry point keeps working as configuration grows more dynamic.\n *\n * @example\n * ```ts\n * import { defineConfig } from \"vantris\";\n *\n * export default defineConfig({\n *   rootDir: \"./src\",\n *   outDir: \"./dist\",\n * });\n * ```\n */\nexport function defineConfig(config: Config): Config;\nexport function defineConfig(config: ConfigInput): ConfigInput;\nexport function defineConfig(config: ConfigInput): ConfigInput {\n  return config;\n}\n"]}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "vantris",
+  "version": "0.1.0",
+  "description": "A modern bundler for JavaScript/TypeScript",
+  "type": "module",
+  "license": "MIT",
+  "keywords": ["bundler", "build-tool", "dev-server", "typescript"],
+  "bin": {
+    "vantris": "dist/cli/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": ["dist"],
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm run build"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5"
+  }
+}