@dbarrett24/tsdown-config 1.0.1 → 1.1.0

package/dist/index.d.ts

@@ -1,5 +1,43 @@
 import { UserConfig } from "tsdown";
 
+//#region entryManifest.d.ts
+/**
+ * Published-source support for the Evolve UI MCP.
+ *
+ * The MCP indexes design-system *sources* at runtime, so every publishable library ships
+ * `src/**` and an `evolve-ui.entries.json` manifest inside `dist/` (the tarball root). The
+ * manifest is generated from the same entry maps tsdown consumes, so the published subpaths
+ * it lists can never drift from the real build entries.
+ */
+/** Manifest filename at the package (tarball) root. */
+declare const ENTRY_MANIFEST_FILENAME = "evolve-ui.entries.json";
+/** Which entry map an entry came from; the MCP scanner uses it to classify barrels. */
+type EntryManifestSource = 'clientEntries' | 'entries';
+type EntryManifestEntry = {
+  /** Entry key, which is also the published subpath. */exportName: string; /** Entry file as written in the build config, relative to the package root. */
+  filePath: string;
+  source: EntryManifestSource;
+};
+type EntryManifest = {
+  entries: EntryManifestEntry[];
+  package: string;
+  schemaVersion: 1;
+};
+/** Whether a path relative to `src/` belongs in the published source copy. */
+declare const shouldShipSource: (relativePath: string) => boolean;
+/**
+ * Copy the shippable subset of `sourceDir` into `targetDir`, preserving structure. A missing
+ * source directory is a no-op so packages without `src/` still build.
+ */
+declare const copySources: (sourceDir: string, targetDir: string) => void;
+/**
+ * Build the manifest from the same entry maps handed to tsdown. When a key appears in both
+ * maps, `clientEntries` wins — matching how the build merges them into one `entry` object.
+ */
+declare const buildEntryManifest: (packageName: string, entries: Record<string, string>, clientEntries?: Record<string, string>) => EntryManifest;
+/** Write the manifest into `targetDir` (the dist/tarball root). */
+declare const writeEntryManifest: (packageName: string, entries: Record<string, string>, clientEntries?: Record<string, string>, targetDir?: string) => void;
+//#endregion
 //#region index.d.ts
 declare const makeConfig: (entries: Record<string, string>, clientEntries?: Record<string, string>, optionOverrides?: Partial<UserConfig>) => UserConfig;
 declare const defaultConfigObject: {
@@ -16,5 +54,5 @@ declare const defaultConfigObject: {
   };
 };
 //#endregion
-export { defaultConfigObject, makeConfig };
+export { ENTRY_MANIFEST_FILENAME, type EntryManifest, type EntryManifestEntry, type EntryManifestSource, buildEntryManifest, copySources, defaultConfigObject, makeConfig, shouldShipSource, writeEntryManifest };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -3,6 +3,117 @@ import { merge } from "es-toolkit";
 import fs from "fs";
 import path from "path";
 import { defineConfig } from "tsdown";
+//#region entryManifest.ts
+/**
+* Published-source support for the Evolve UI MCP.
+*
+* The MCP indexes design-system *sources* at runtime, so every publishable library ships
+* `src/**` and an `evolve-ui.entries.json` manifest inside `dist/` (the tarball root). The
+* manifest is generated from the same entry maps tsdown consumes, so the published subpaths
+* it lists can never drift from the real build entries.
+*/
+/** Manifest filename at the package (tarball) root. */
+const ENTRY_MANIFEST_FILENAME = "evolve-ui.entries.json";
+/**
+* Inclusion allowlist for the source copy: the MCP scanner only ever reads TS/TSX, and an
+* allowlist cannot silently ship whatever new file type lands in `src/` later.
+*/
+const SHIPPABLE_EXTENSIONS = [".ts", ".tsx"];
+const EXCLUDED_NAME_INFIXES = [
+	".spec.",
+	".test.",
+	".stories."
+];
+const EXCLUDED_DIRECTORY_NAMES = /* @__PURE__ */ new Set(["__mocks__", "__snapshots__"]);
+/** Whether a path relative to `src/` belongs in the published source copy. */
+const shouldShipSource = (relativePath) => {
+	const segments = relativePath.split(/[\\/]/);
+	if (segments.some((segment) => EXCLUDED_DIRECTORY_NAMES.has(segment))) return false;
+	const fileName = segments[segments.length - 1] ?? "";
+	if (!SHIPPABLE_EXTENSIONS.some((extension) => fileName.endsWith(extension))) return false;
+	return !EXCLUDED_NAME_INFIXES.some((infix) => fileName.includes(infix));
+};
+const copyDirectory = (sourceDir, targetDir, relativePrefix) => {
+	for (const entry of fs.readdirSync(sourceDir, { withFileTypes: true })) {
+		const relativePath = relativePrefix.length === 0 ? entry.name : `${relativePrefix}/${entry.name}`;
+		const sourcePath = path.join(sourceDir, entry.name);
+		const targetPath = path.join(targetDir, entry.name);
+		if (entry.isDirectory()) {
+			if (!EXCLUDED_DIRECTORY_NAMES.has(entry.name)) copyDirectory(sourcePath, targetPath, relativePath);
+			continue;
+		}
+		if (entry.isFile() && shouldShipSource(relativePath)) {
+			fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+			fs.copyFileSync(sourcePath, targetPath);
+		}
+	}
+};
+/**
+* Copy the shippable subset of `sourceDir` into `targetDir`, preserving structure. A missing
+* source directory is a no-op so packages without `src/` still build.
+*/
+const copySources = (sourceDir, targetDir) => {
+	if (!fs.existsSync(sourceDir)) return;
+	copyDirectory(sourceDir, targetDir, "");
+};
+/**
+* Build the manifest from the same entry maps handed to tsdown. When a key appears in both
+* maps, `clientEntries` wins — matching how the build merges them into one `entry` object.
+*/
+const buildEntryManifest = (packageName, entries, clientEntries = {}) => {
+	const manifestEntries = [];
+	for (const [exportName, filePath] of Object.entries(entries)) if (!(exportName in clientEntries)) manifestEntries.push({
+		exportName,
+		filePath,
+		source: "entries"
+	});
+	for (const [exportName, filePath] of Object.entries(clientEntries)) manifestEntries.push({
+		exportName,
+		filePath,
+		source: "clientEntries"
+	});
+	return {
+		entries: manifestEntries,
+		package: packageName,
+		schemaVersion: 1
+	};
+};
+/** Write the manifest into `targetDir` (the dist/tarball root). */
+const writeEntryManifest = (packageName, entries, clientEntries = {}, targetDir = "dist") => {
+	const manifest = buildEntryManifest(packageName, entries, clientEntries);
+	fs.mkdirSync(targetDir, { recursive: true });
+	fs.writeFileSync(path.join(targetDir, ENTRY_MANIFEST_FILENAME), `${JSON.stringify(manifest, null, 4)}\n`);
+};
+//#endregion
+//#region workspace-specifier.ts
+/**
+* Resolution of pnpm workspace protocol specifiers for the emitted `dist/package.json`.
+*
+* Kept in its own dependency-free module so it can be unit-tested without loading tsdown or
+* the pnpm lockfile reader. Its correctness is load-bearing at publish time: a specifier that
+* survives into the emitted manifest publishes successfully and is uninstallable for every
+* consumer, which is the most expensive failure this package can produce.
+*/
+/**
+* Convert a `workspace:` specifier into a publishable semver range.
+*
+* `workspace:*` pins the dependency exactly, which is right for packages that must move in
+* lockstep. `workspace:^` and `workspace:~` publish as the matching range, which is what a
+* package wants when consumers should be able to pick up the dependency's patch releases —
+* without it, a fix published to the dependency is unreachable behind an exact pin.
+*
+* @param specifier the raw dependency value, e.g. `workspace:^`
+* @param resolvedVersion the dependency's actual version, e.g. `1.2.3`
+*/
+const resolveWorkspaceSpecifier = (specifier, resolvedVersion) => {
+	if (specifier === "workspace:*") return resolvedVersion;
+	if (specifier === "workspace:^") return `^${resolvedVersion}`;
+	if (specifier === "workspace:~") return `~${resolvedVersion}`;
+	return specifier.replace(/^workspace:/, "");
+};
+/** True when a dependency value uses the pnpm workspace protocol. */
+const isWorkspaceSpecifier = (specifier) => specifier.startsWith("workspace:");
+//#endregion
 //#region index.ts
 const formatEmittedPackageJson = (obj) => `${JSON.stringify(obj, null, 4)}\n`;
 const makeConfig = (entries, clientEntries, optionOverrides) => {
@@ -68,18 +179,18 @@ const copyPackageJson = async () => {
 	const merged_deps = merge(lockfile_package_list?.dependencies ?? {}, lockfile_package_list?.devDependencies ?? {});
 	for (const item of Object.entries(newPackageJSON.peerDependencies)) {
 		const [dep, version] = item;
-		if (version.includes("workspace")) {
+		if (isWorkspaceSpecifier(version)) {
 			const package_path = merged_deps?.[dep].version.replace(/(?:link:|\/dist)/g, "") + "/package.json";
 			const packageJSON = JSON.parse(fs.readFileSync(package_path).toString());
-			newPackageJSON.peerDependencies[dep] = version.replace("workspace:*", packageJSON.version);
+			newPackageJSON.peerDependencies[dep] = resolveWorkspaceSpecifier(version, packageJSON.version);
 		}
 	}
 	for (const item of Object.entries(newPackageJSON.dependencies ?? {})) {
 		const [dep, version] = item;
-		if (version.includes("workspace")) {
+		if (isWorkspaceSpecifier(version)) {
 			const package_path = merged_deps?.[dep].version.replace(/(?:link:|\/dist)/g, "") + "/package.json";
 			const packageJSON = JSON.parse(fs.readFileSync(package_path).toString());
-			newPackageJSON.dependencies[dep] = version.replace("workspace:*", packageJSON.version);
+			newPackageJSON.dependencies[dep] = resolveWorkspaceSpecifier(version, packageJSON.version);
 		}
 	}
 	fs.writeFileSync("dist/package.json", formatEmittedPackageJson(newPackageJSON));
@@ -134,7 +245,11 @@ const makeConfigObject = (entries, clientEntries = {}, optionOverrides = {}) =>
 		...optionOverrides,
 		onSuccess: async (config, signal) => {
 			if (typeof optionOverrides.onSuccess === "function") await optionOverrides.onSuccess(config, signal);
+			const packageName = JSON.parse(fs.readFileSync("package.json").toString()).name;
+			if (typeof packageName !== "string" || packageName.length === 0) throw new Error("tsdown-config: package.json has no \"name\" to write into the entry manifest");
 			await copyPackageJson();
+			copySources("src", "dist/src");
+			writeEntryManifest(packageName, entries, clientEntries, "dist");
 			fillDuplicateDts({
 				...entries,
 				...clientEntries
@@ -144,6 +259,6 @@ const makeConfigObject = (entries, clientEntries = {}, optionOverrides = {}) =>
 	};
 };
 //#endregion
-export { defaultConfigObject, makeConfig };
+export { ENTRY_MANIFEST_FILENAME, buildEntryManifest, copySources, defaultConfigObject, makeConfig, shouldShipSource, writeEntryManifest };
 
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dbarrett24/tsdown-config",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Shared tsdown configuration for building component libraries (publish-from-dist with generated wildcard exports)",
   "type": "module",
   "module": "dist/index.js",
@@ -23,7 +23,9 @@
     "typescript": "^6.0.3"
   },
   "devDependencies": {
+    "@swc/jest": "^0.2.39",
     "concurrently": "^8.2.2",
+    "jest": "^30.3.0",
     "@dbarrett24/typescript-config": "1.0.1"
   },
   "peerDependencies": {
@@ -53,9 +55,9 @@
     "lint-fix": "pnpm lint-oxlint-fix && pnpm lint-oxfmt-fix",
     "lint-oxfmt": "oxfmt --config ../../.oxfmtrc.json --check \"*.ts\"",
     "lint-oxfmt-fix": "oxfmt --config ../../.oxfmtrc.json --write \"*.ts\"",
-    "lint-oxlint": "oxlint index.ts tsdown.config.ts",
-    "lint-oxlint-fix": "oxlint --fix index.ts tsdown.config.ts",
+    "lint-oxlint": "oxlint index.ts tsdown.config.ts workspace-specifier.ts",
+    "lint-oxlint-fix": "oxlint --fix index.ts tsdown.config.ts workspace-specifier.ts",
     "ts-check": "tsc --noEmit",
-    "test": "echo 'No tests for tsdown-config'"
+    "test": "jest --passWithNoTests"
   }
 }