feat!: unified config for programmatic api

Author: pi0

README.md

@@ -8,7 +8,7 @@ The **obuild** project aims to be the next-generation successor to the current [
 
 - 👌 Focus on ESM compatibility.
 - 🌱 Fresh rewrite with cleanups and removal of legacy features.
-- 🚀 Using [**oxc**](https://oxc.rs/) and [**rolldown**](https://rolldown.rs/) for much faster builds!
+- 🚀 Using [**oxc**](https://oxc.rs/) (for transform) and [**rolldown**](https://rolldown.rs/) (for bundle) for much faster builds!
 
 Some differences are not easy to adopt. Developing as a standalone project allows for faster progress and dogfooding in real projects.
 
@@ -45,9 +45,22 @@ npx obuild ./src/runtime/:./dist/runtime
 
 You can use `--dir` to set the working directory.
 
-## Optional CLI Config
+If paths end with `/`, obuild uses transpile mode using [oxc-transform](https://www.npmjs.com/package/oxc-transform) instead of bundle mode with [rolldown](https://rolldown.rs/).
 
-**`build.config.mjs`:**
+### Programmatic
+
+```js
+import { build } from "obuild";
+
+await build({
+  cwd: ".",
+  entries: ["./src/index.ts"],
+});
+```
+
+## Config
+
+You can use `build.config.mjs` (or `.ts`) or pass config to `build()` function.
 
 ```js
 import { defineBuildConfig } from "obuild";
@@ -60,10 +73,8 @@ export default defineBuildConfig({
       // outDir: "./dist",
       // minify: false,
       // stub: false,
-      // https://rolldown.rs/reference/config-options
-      // rolldown: {},
-      // https://github.com/sxzz/rolldown-plugin-dts#options
-      // dts: {},
+      // rolldown: {}, // https://rolldown.rs/reference/config-options
+      // dts: {}, // https://github.com/sxzz/rolldown-plugin-dts#options
     },
     {
       type: "transform",
@@ -74,22 +85,16 @@ export default defineBuildConfig({
       // oxc: {},
     },
   ],
+  hooks: {
+    // start: (ctx) => {},
+    // end: (ctx) => {},
+    // entries: (entries, ctx) => {},
+    // rolldownConfig: (config, ctx) => {},
+    // rolldownOutput: (output, res, ctx) => {},
+  },
 });
 ```
 
-### Programmatic
-
-```js
-import { build } from "obuild";
-
-await build(".", [
-  /* ... entries ... */
-]);
-```
-
-> [!NOTE]
-> Auto entries inference similar to unbuild coming soon ([#4](https://github.com/unjs/obuild/issues/4)).
-
 ## Stub Mode
 
 When working on a package locally, it can be tedious to rebuild or run the watch command every time.

src/build.ts

@@ -1,4 +1,9 @@
-import type { BuildEntry, BuildContext, BuildConfig } from "./types.ts";
+import type {
+  BuildContext,
+  BuildConfig,
+  TransformEntry,
+  BundleEntry,
+} from "./types.ts";
 
 import { fileURLToPath } from "node:url";
 import { isAbsolute, join, resolve } from "node:path";
@@ -13,24 +18,29 @@ import prettyBytes from "pretty-bytes";
 /**
  * Build dist/ from src/
  */
-export async function build(
-  _cwd: string | URL,
-  _entries: BuildEntry[],
-  { hooks = {} }: Omit<BuildConfig, "entries"> = {},
-): Promise<void> {
+export async function build(config: BuildConfig): Promise<void> {
   const start = Date.now();
 
-  const pkgDir = normalizePath(_cwd);
+  const pkgDir = normalizePath(config.cwd);
   const pkg = await readJSON(join(pkgDir, "package.json")).catch(() => ({}));
   const ctx: BuildContext = { pkg, pkgDir };
 
   consola.log(
     `📦 Building \`${ctx.pkg.name || "<no name>"}\` (\`${ctx.pkgDir}\`)`,
   );
 
+  const hooks = config.hooks || {};
+
   await hooks.start?.(ctx);
 
-  const entries = _entries.map((entry) => {
+  const entries = (config.entries || []).map((entry) => {
+    if (typeof entry === "string") {
+      const [input, outDir] = entry.split(":") as [string, string | undefined];
+      return input.endsWith("/")
+        ? ({ type: "transform", input, outDir } as TransformEntry)
+        : ({ type: "bundle", input: input.split(","), outDir } as BundleEntry);
+    }
+
     if (!entry.input) {
       throw new Error(
         `Build entry missing \`input\`: ${JSON.stringify(entry, null, 2)}`,

src/cli.ts

@@ -29,8 +29,6 @@ const { config = {} } = await loadConfig<BuildConfig>({
   cwd: args.values.dir,
 });
 
-const dir = args.values.dir;
-
 const rawEntries =
   args.positionals.length > 0
     ? (args.positionals as string[])
@@ -57,4 +55,8 @@ if (rawEntries.length === 0) {
   process.exit(1);
 }
 
-await build(dir, entries, config);
+await build({
+  cwd: args.values.dir,
+  ...config,
+  entries,
+});

src/types.ts

@@ -104,6 +104,7 @@ export interface BuildHooks {
 }
 
 export interface BuildConfig {
+  cwd?: string | URL;
   entries?: (BuildEntry | string)[];
   hooks?: BuildHooks;
 }

test/obuild.test.ts

@@ -12,10 +12,13 @@ describe("obuild", () => {
   });
 
   test("build fixture", async () => {
-    await build(fixtureDir, [
-      { type: "bundle", input: ["src/index", "src/cli"] },
-      { type: "transform", input: "src/runtime", outDir: "dist/runtime" },
-    ]);
+    await build({
+      cwd: fixtureDir,
+      entries: [
+        { type: "bundle", input: ["src/index", "src/cli"] },
+        { type: "transform", input: "src/runtime", outDir: "dist/runtime" },
+      ],
+    });
   });
 
   test("dist files match expected", async () => {