pluribuild 0.1.1 → 0.1.3

package/README.md

@@ -1,11 +1,28 @@
 # pluribuild
 
-Build multiple entry points into multiple output files with a single command.
+Build multiple entry points into multiple output files with a single command and esbuild under the hood.
+
+## CLI
 
 Run `npx pluribuild` to build:
 - `entries/<name>/src/index.ts(x)` into `dist/<name>/index.js`;
 - `entries/<name>/x.ts(x)` into `dist/<name>/x.js` (`index` as `x` is fine, too).
 
+Subdirectories of `entries` and entry point files whose names start with an underscore are ignored. Add `--ignore <subdir1> [<subdir2> ...]` to the command to additionally ignore the specified subdirectories of `entries`.
+
 Run `npx pluribuild <dir>` to point to a parent directory other than `entries`.
 
 Add `--dev` to the command to enable rebuilds on code changes. Add `--minify=off` to turn off minification.
+
+## Code
+
+```ts
+import { build } from "pluribuild";
+
+await build({
+  dir: "entries",  // Default
+  ignore: ["lib"], // Default: not set, ignores all starting with "_"
+  minify: true,    // Default
+  dev: false,      // Default
+});
+```

package/dist/index.cjs

@@ -38,16 +38,16 @@ function toEntryPoint(toName) {
   };
 }
 
-function getDefaultEntryPoints(dir = "entries") {
-  let entryPoints = new Map([...(0, node_fs.globSync)(`${dir}/[!_]*/src/index.{ts,tsx}`).map(toEntryPoint((path) => {
+function getDefaultEntryPoints(dir, ignore) {
+  let entryPoints = new Map([...(0, node_fs.globSync)(`${dir}/[!_]*/src/index.{ts,tsx}`, { exclude: ignore?.map((subdir) => `${dir}/${subdir}/src/index.{ts,tsx}`) }).map(toEntryPoint((path) => {
     let p = path.split(node_path.sep);
     return `${p.at(-3)}/${p.at(-1)}`;
-  })), ...(0, node_fs.globSync)(`${dir}/[!_]*/[!_]*.{ts,tsx}`).map(toEntryPoint((path) => path.split(node_path.sep).slice(-2).join("/")))]);
+  })), ...(0, node_fs.globSync)(`${dir}/[!_]*/[!_]*.{ts,tsx}`, { exclude: ignore?.map((subdir) => `${dir}/${subdir}/[!_]*.{ts,tsx}`) }).map(toEntryPoint((path) => path.split(node_path.sep).slice(-2).join("/")))]);
   return Array.from(entryPoints.values());
 }
 
-async function build({ entryPoints, dev, dir, ...options } = {}) {
-  let e = entryPoints ?? getDefaultEntryPoints(dir);
+async function build({ entryPoints, dev, dir = "entries", ignore, ...options } = {}) {
+  let e = entryPoints ?? getDefaultEntryPoints(dir, ignore);
   if (Object.keys(e).length === 0) {
     console.warn("No entry points");
     return;

package/dist/index.d.ts

@@ -1,7 +1,12 @@
 import { BuildOptions as BuildOptions$1 } from "esbuild";
 
 type BuildOptions = BuildOptions$1 & {
-  /** Directory containing entry points. */dir?: string; /** Development mode. Enables rebuilds on code changes. */
+  /**
+   * Directory containing entry points.
+   * @default "entries"
+   */
+  dir?: string; /** List of ignored subdirectories of `dir`. */
+  ignore?: string[]; /** Development mode. Enables rebuilds on code changes. */
   dev?: boolean;
 };
 
@@ -9,6 +14,7 @@ declare function build({
   entryPoints,
   dev,
   dir,
+  ignore,
   ...options
 }?: BuildOptions): Promise<void>;
 
@@ -17,7 +23,7 @@ type EntryPoint = {
   out: string;
 };
 
-declare function getDefaultEntryPoints(dir?: string): EntryPoint[];
+declare function getDefaultEntryPoints(dir: string, ignore?: string[]): EntryPoint[];
 
 declare function toEntryPoint(toName: (path: string) => string | undefined): (path: string) => [string, EntryPoint];
 

package/dist/index.mjs

@@ -14,16 +14,16 @@ function toEntryPoint(toName) {
   };
 }
 
-function getDefaultEntryPoints(dir = "entries") {
-  let entryPoints = new Map([...globSync(`${dir}/[!_]*/src/index.{ts,tsx}`).map(toEntryPoint((path) => {
+function getDefaultEntryPoints(dir, ignore) {
+  let entryPoints = new Map([...globSync(`${dir}/[!_]*/src/index.{ts,tsx}`, { exclude: ignore?.map((subdir) => `${dir}/${subdir}/src/index.{ts,tsx}`) }).map(toEntryPoint((path) => {
     let p = path.split(sep);
     return `${p.at(-3)}/${p.at(-1)}`;
-  })), ...globSync(`${dir}/[!_]*/[!_]*.{ts,tsx}`).map(toEntryPoint((path) => path.split(sep).slice(-2).join("/")))]);
+  })), ...globSync(`${dir}/[!_]*/[!_]*.{ts,tsx}`, { exclude: ignore?.map((subdir) => `${dir}/${subdir}/[!_]*.{ts,tsx}`) }).map(toEntryPoint((path) => path.split(sep).slice(-2).join("/")))]);
   return Array.from(entryPoints.values());
 }
 
-async function build({ entryPoints, dev, dir, ...options } = {}) {
-  let e = entryPoints ?? getDefaultEntryPoints(dir);
+async function build({ entryPoints, dev, dir = "entries", ignore, ...options } = {}) {
+  let e = entryPoints ?? getDefaultEntryPoints(dir, ignore);
   if (Object.keys(e).length === 0) {
     console.warn("No entry points");
     return;

package/dist/run.mjs

@@ -248,10 +248,12 @@ function toEntryPoint(toName) {
 }
 
 // src/getDefaultEntryPoints.ts
-function getDefaultEntryPoints(dir = "entries") {
+function getDefaultEntryPoints(dir, ignore) {
   let entryPoints = new Map([
     // entries/x/src/index.ts -> dist/x/index.js
-    ...globSync(`${dir}/[!_]*/src/index.{ts,tsx}`).map(
+    ...globSync(`${dir}/[!_]*/src/index.{ts,tsx}`, {
+      exclude: ignore?.map((subdir) => `${dir}/${subdir}/src/index.{ts,tsx}`)
+    }).map(
       toEntryPoint((path) => {
         let p = path.split(sep);
         return `${p.at(-3)}/${p.at(-1)}`;
@@ -259,9 +261,9 @@ function getDefaultEntryPoints(dir = "entries") {
     ),
     // entries/x/index.ts -> dist/x/index.js (overrides entries/x/src/index.ts, if present)
     // entries/x/y.ts -> dist/x/y.js
-    ...globSync(`${dir}/[!_]*/[!_]*.{ts,tsx}`).map(
-      toEntryPoint((path) => path.split(sep).slice(-2).join("/"))
-    )
+    ...globSync(`${dir}/[!_]*/[!_]*.{ts,tsx}`, {
+      exclude: ignore?.map((subdir) => `${dir}/${subdir}/[!_]*.{ts,tsx}`)
+    }).map(toEntryPoint((path) => path.split(sep).slice(-2).join("/")))
   ]);
   return Array.from(entryPoints.values());
 }
@@ -270,10 +272,11 @@ function getDefaultEntryPoints(dir = "entries") {
 async function build({
   entryPoints,
   dev: dev2,
-  dir,
+  dir = "entries",
+  ignore,
   ...options2
 } = {}) {
-  let e = entryPoints ?? getDefaultEntryPoints(dir);
+  let e = entryPoints ?? getDefaultEntryPoints(dir, ignore);
   if (Object.keys(e).length === 0) {
     console.warn("No entry points");
     return;
@@ -305,7 +308,8 @@ var args = new import_args_json.Args();
 var dev = args.hasKey("--dev");
 var options = {
   dev,
-  minify: !args.isExplicitlyOff("--minify")
+  minify: !args.isExplicitlyOff("--minify"),
+  ignore: args.getValues("--ignore")
 };
 var rawArgs = process.argv.slice(2);
 if (rawArgs.length !== 0 && !(0, import_args_json.isKey)(rawArgs[0])) options.dir = rawArgs[0];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pluribuild",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Build multiple entry points into multiple output files with a single command",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",

package/src/BuildOptions.ts

@@ -1,8 +1,13 @@
 import type { BuildOptions as EsbuildOptions } from "esbuild";
 
 export type BuildOptions = EsbuildOptions & {
-  /** Directory containing entry points. */
+  /**
+   * Directory containing entry points.
+   * @default "entries"
+   */
   dir?: string;
+  /** List of ignored subdirectories of `dir`. */
+  ignore?: string[];
   /** Development mode. Enables rebuilds on code changes. */
   dev?: boolean;
 };

package/src/build.ts

@@ -5,10 +5,11 @@ import { getDefaultEntryPoints } from "./getDefaultEntryPoints.ts";
 export async function build({
   entryPoints,
   dev,
-  dir,
+  dir = "entries",
+  ignore,
   ...options
 }: BuildOptions = {}) {
-  let e = entryPoints ?? getDefaultEntryPoints(dir);
+  let e = entryPoints ?? getDefaultEntryPoints(dir, ignore);
 
   if (Object.keys(e).length === 0) {
     console.warn("No entry points");

package/src/getDefaultEntryPoints.ts

@@ -2,10 +2,12 @@ import { globSync } from "node:fs";
 import { sep } from "node:path";
 import { toEntryPoint } from "./toEntryPoint.ts";
 
-export function getDefaultEntryPoints(dir = "entries") {
+export function getDefaultEntryPoints(dir: string, ignore?: string[]) {
   let entryPoints = new Map([
     // entries/x/src/index.ts -> dist/x/index.js
-    ...globSync(`${dir}/[!_]*/src/index.{ts,tsx}`).map(
+    ...globSync(`${dir}/[!_]*/src/index.{ts,tsx}`, {
+      exclude: ignore?.map((subdir) => `${dir}/${subdir}/src/index.{ts,tsx}`),
+    }).map(
       toEntryPoint((path) => {
         let p = path.split(sep);
         return `${p.at(-3)}/${p.at(-1)}`;
@@ -13,9 +15,9 @@ export function getDefaultEntryPoints(dir = "entries") {
     ),
     // entries/x/index.ts -> dist/x/index.js (overrides entries/x/src/index.ts, if present)
     // entries/x/y.ts -> dist/x/y.js
-    ...globSync(`${dir}/[!_]*/[!_]*.{ts,tsx}`).map(
-      toEntryPoint((path) => path.split(sep).slice(-2).join("/")),
-    ),
+    ...globSync(`${dir}/[!_]*/[!_]*.{ts,tsx}`, {
+      exclude: ignore?.map((subdir) => `${dir}/${subdir}/[!_]*.{ts,tsx}`),
+    }).map(toEntryPoint((path) => path.split(sep).slice(-2).join("/"))),
   ]);
 
   return Array.from(entryPoints.values());

package/src/run.ts

@@ -9,6 +9,7 @@ let dev = args.hasKey("--dev");
 let options: BuildOptions = {
   dev,
   minify: !args.isExplicitlyOff("--minify"),
+  ignore: args.getValues("--ignore"),
 };
 
 let rawArgs = process.argv.slice(2);