@dbarrett24/tsdown-config 1.0.2 → 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,88 @@ 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`.
@@ -163,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
@@ -173,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.2",
+  "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",