modular-library 0.0.3 → 0.0.4

package/README.md

@@ -163,6 +163,29 @@ To make your package consumable with subpath imports, add an `exports` map in yo
 }
 ```
 
+## CLI
+
+You can also use `modular-library` as a CLI with `npx`.
+
+### Check exports
+
+Validate that all `package.json` export targets exist and are inside your output directory:
+
+```bash
+npx modular-library check
+```
+
+Named options:
+
+- `--package-json` path to package manifest (default: `./package.json`)
+- `--out-dir` output directory to validate against (default: `./dist`)
+
+Example:
+
+```bash
+npx modular-library check --package-json ./package.json --out-dir ./dist
+```
+
 ## Development
 
 ```bash

package/dist/chunks/chunk.js

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return s}});

package/dist/chunks/createEntries.js

@@ -1 +1 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));let c=require(`node:fs`),l=require(`node:path`);l=s(l);var u=e=>typeof e==`string`,d=e=>e.replace(/\.[^/.]+$/,``).replace(/\\/g,`/`),f={relative:`src/`},p=(e,t)=>{let n=[e].flat(),r=n.filter(e=>u(e)),i=n.filter(e=>!u(e)),a=(0,c.globSync)(r.map(e=>e.replace(/\\/g,`/`)),{...t?.glob,withFileTypes:!1}).map(e=>{let n=l.default.relative(t?.relative??f.relative,e),r=n.startsWith(`../`)?l.default.relative(`./`,e):n;return[d(t?.transformOutputPath?t.transformOutputPath(r,e):r),e]});return Object.assign({},Object.fromEntries(a),...i)};Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return p}});
+const e=require(`./chunk.js`);let t=require(`node:path`);t=e.t(t);let n=require(`node:fs`);var r=e=>typeof e==`string`,i=e=>e.replace(/\.[^/.]+$/,``).replace(/\\/g,`/`),a={relative:`src/`},o=(e,o)=>{let s=[e].flat(),c=s.filter(e=>r(e)),l=s.filter(e=>!r(e)),u=(0,n.globSync)(c.map(e=>e.replace(/\\/g,`/`)),{...o?.glob,withFileTypes:!0}).filter(e=>e.isFile()).map(e=>{let n=t.default.join(e.parentPath,e.name),r=t.default.relative(o?.relative??a.relative,n),s=r.startsWith(`../`)?t.default.relative(`./`,n):r;return[i(o?.transformOutputPath?o.transformOutputPath(s,n):s),n]});return Object.assign({},Object.fromEntries(u),...l)};Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return o}});

package/dist/cli/check.d.ts

@@ -0,0 +1,16 @@
+export type ExportValidationIssue = {
+    exportPath: string;
+    condition: string | null;
+    target: string;
+    resolvedTarget: string;
+    reason: "invalid-target" | "outside-out-dir" | "file-not-found";
+};
+export type ValidateExportsInput = {
+    packageJsonPath: string;
+    outDir: string;
+};
+export declare const validatePackageExports: ({ packageJsonPath, outDir, }: ValidateExportsInput) => {
+    valid: boolean;
+    issues: ExportValidationIssue[];
+    checked: number;
+};

package/dist/cli.cjs.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunks/chunk.js`);let t=require(`node:path`);t=e.t(t);let n=require(`commander`),r=require(`node:fs`);var i=e=>typeof e==`object`&&!!e&&!Array.isArray(e),a=(e,t,n=[])=>typeof e==`string`?[{exportPath:t,condition:n.length>0?n.join(`.`):null,target:e}]:Object.entries(e).flatMap(([e,r])=>typeof r==`string`||i(r)?a(r,t,[...n,e]):[]),o=e=>e&&(typeof e==`string`||i(e))?typeof e==`string`||Object.values(e).every(e=>typeof e==`string`||i(e))&&Object.keys(e).every(e=>!e.startsWith(`.`))?a(e,`.`):Object.entries(e).flatMap(([e,t])=>typeof t==`string`||i(t)?a(t,e):[]):[],s=({packageJsonPath:e,outDir:n})=>{let i=(0,r.readFileSync)(e,`utf8`),a=JSON.parse(i),s=t.default.dirname(e),c=t.default.resolve(n),l=o(a.exports),u=[];return l.forEach(e=>{if(!e.target.startsWith(`./`)){u.push({...e,resolvedTarget:e.target,reason:`invalid-target`});return}let n=t.default.resolve(s,e.target),i=t.default.relative(c,n);if(i.startsWith(`..`)||t.default.isAbsolute(i)){u.push({...e,resolvedTarget:n,reason:`outside-out-dir`});return}(0,r.existsSync)(n)||u.push({...e,resolvedTarget:n,reason:`file-not-found`})}),{valid:u.length===0,issues:u,checked:l.length}},c=(e,t)=>{let n=t.condition?` (${t.condition})`:``;e.write(`- ${t.exportPath}${n}: ${t.target} -> ${t.reason} (${t.resolvedTarget})\n`)},l=({stdout:e,stderr:r,cwd:i})=>{let a=new n.Command;return a.name(`modular-library`).description(`CLI for modular-library`).showHelpAfterError().configureOutput({writeOut:t=>{e.write(t)},writeErr:e=>{r.write(e)}}).exitOverride(),a.command(`check`).description(`Validate that package.json exports exist inside out-dir`).option(`--package-json <path>`,`Path to package.json`,`./package.json`).option(`--out-dir <path>`,`Output directory to validate against`,`./dist`).action(a=>{let o=t.default.resolve(i,a.packageJson),l=t.default.resolve(i,a.outDir),u=s({packageJsonPath:o,outDir:l});if(u.valid){e.write(`All exports are valid. Checked ${u.checked} export target(s) in ${l}.\n`);return}throw r.write(`Found ${u.issues.length} invalid export target(s) out of ${u.checked}:\n`),u.issues.forEach(e=>{c(r,e)}),new n.CommanderError(1,`check.invalidExports`,``)}),a},u=(e,{stdout:t=process.stdout,stderr:r=process.stderr,cwd:i=process.cwd()}={})=>{let a=l({stdout:t,stderr:r,cwd:i});try{return e.length===0?(a.outputHelp(),0):(a.parse(e,{from:`user`}),0)}catch(e){if(e instanceof n.CommanderError)return e.code===`check.invalidExports`?1:e.exitCode;let t=e instanceof Error?e.message:String(e);return r.write(`${t}\n`),1}},d=async()=>{process.exitCode=u(process.argv.slice(2))};typeof require<`u`&&require.main===module&&d(),exports.main=d,exports.runCli=u;

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+type StdoutLike = Pick<typeof process.stdout, "write">;
+type StderrLike = Pick<typeof process.stderr, "write">;
+type RunCliOptions = {
+    stdout?: StdoutLike;
+    stderr?: StderrLike;
+    cwd?: string;
+};
+export declare const runCli: (argv: string[], { stdout, stderr, cwd, }?: RunCliOptions) => number;
+export declare const main: () => Promise<void>;
+export {};

package/dist/cli.es.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import e from "node:path";
+import { Command as t, CommanderError as n } from "commander";
+import { existsSync as r, readFileSync as i } from "node:fs";
+//#region \0rolldown/runtime.js
+var a = /* @__PURE__ */ ((e) => typeof require < "u" ? require : typeof Proxy < "u" ? new Proxy(e, { get: (e, t) => (typeof require < "u" ? require : e)[t] }) : e)(function(e) {
+	if (typeof require < "u") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + e + "\" in an environment that doesn't expose the `require` function. See https://rolldown.rs/in-depth/bundling-cjs#require-external-modules for more details.");
+}), o = (e) => typeof e == "object" && !!e && !Array.isArray(e), s = (e, t, n = []) => typeof e == "string" ? [{
+	exportPath: t,
+	condition: n.length > 0 ? n.join(".") : null,
+	target: e
+}] : Object.entries(e).flatMap(([e, r]) => typeof r == "string" || o(r) ? s(r, t, [...n, e]) : []), c = (e) => e && (typeof e == "string" || o(e)) ? typeof e == "string" || Object.values(e).every((e) => typeof e == "string" || o(e)) && Object.keys(e).every((e) => !e.startsWith(".")) ? s(e, ".") : Object.entries(e).flatMap(([e, t]) => typeof t == "string" || o(t) ? s(t, e) : []) : [], l = ({ packageJsonPath: t, outDir: n }) => {
+	let a = i(t, "utf8"), o = JSON.parse(a), s = e.dirname(t), l = e.resolve(n), u = c(o.exports), d = [];
+	return u.forEach((t) => {
+		if (!t.target.startsWith("./")) {
+			d.push({
+				...t,
+				resolvedTarget: t.target,
+				reason: "invalid-target"
+			});
+			return;
+		}
+		let n = e.resolve(s, t.target), i = e.relative(l, n);
+		if (i.startsWith("..") || e.isAbsolute(i)) {
+			d.push({
+				...t,
+				resolvedTarget: n,
+				reason: "outside-out-dir"
+			});
+			return;
+		}
+		r(n) || d.push({
+			...t,
+			resolvedTarget: n,
+			reason: "file-not-found"
+		});
+	}), {
+		valid: d.length === 0,
+		issues: d,
+		checked: u.length
+	};
+}, u = (e, t) => {
+	let n = t.condition ? ` (${t.condition})` : "";
+	e.write(`- ${t.exportPath}${n}: ${t.target} -> ${t.reason} (${t.resolvedTarget})\n`);
+}, d = ({ stdout: r, stderr: i, cwd: a }) => {
+	let o = new t();
+	return o.name("modular-library").description("CLI for modular-library").showHelpAfterError().configureOutput({
+		writeOut: (e) => {
+			r.write(e);
+		},
+		writeErr: (e) => {
+			i.write(e);
+		}
+	}).exitOverride(), o.command("check").description("Validate that package.json exports exist inside out-dir").option("--package-json <path>", "Path to package.json", "./package.json").option("--out-dir <path>", "Output directory to validate against", "./dist").action((t) => {
+		let o = e.resolve(a, t.packageJson), s = e.resolve(a, t.outDir), c = l({
+			packageJsonPath: o,
+			outDir: s
+		});
+		if (c.valid) {
+			r.write(`All exports are valid. Checked ${c.checked} export target(s) in ${s}.\n`);
+			return;
+		}
+		throw i.write(`Found ${c.issues.length} invalid export target(s) out of ${c.checked}:\n`), c.issues.forEach((e) => {
+			u(i, e);
+		}), new n(1, "check.invalidExports", "");
+	}), o;
+}, f = (e, { stdout: t = process.stdout, stderr: r = process.stderr, cwd: i = process.cwd() } = {}) => {
+	let a = d({
+		stdout: t,
+		stderr: r,
+		cwd: i
+	});
+	try {
+		return e.length === 0 ? (a.outputHelp(), 0) : (a.parse(e, { from: "user" }), 0);
+	} catch (e) {
+		if (e instanceof n) return e.code === "check.invalidExports" ? 1 : e.exitCode;
+		let t = e instanceof Error ? e.message : String(e);
+		return r.write(`${t}\n`), 1;
+	}
+}, p = async () => {
+	process.exitCode = f(process.argv.slice(2));
+};
+a !== void 0 && a.main === module && p();
+//#endregion
+export { p as main, f as runCli };

package/dist/createEntries.d.ts

@@ -1,6 +1,6 @@
-import { GlobOptionsWithoutFileTypes } from 'node:fs';
+import { GlobOptions } from 'node:fs';
 export type CreateEntryInput = string | string[] | Record<string, string>;
-type CreateEntriesGlobOptions = GlobOptionsWithoutFileTypes;
+type CreateEntriesGlobOptions = GlobOptions;
 export type CreateEntriesOptions = {
     glob?: CreateEntriesGlobOptions;
     relative?: string;

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "modular-library",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "private": false,
+  "bin": {
+    "modular-library": "./dist/cli.cjs.js"
+  },
   "files": [
     "dist"
   ],
@@ -53,6 +56,9 @@
   },
   "homepage": "https://github.com/alfredosalzillo/modular-library#readme",
   "description": "Plugins for Vite, Rollup, and Rolldown to build modular multi-entry TypeScript libraries.",
+  "dependencies": {
+    "commander": "^14.0.1"
+  },
   "devDependencies": {
     "@biomejs/biome": "^2.4.11",
     "@rollup/plugin-json": "^6.1.0",