@savvy-web/tsdown-plugins 0.6.0 → 0.7.0

package/changesets/next-versions.js

@@ -0,0 +1,42 @@
+import getReleasePlan from "@changesets/get-release-plan";
+import { getPackages } from "@manypkg/get-packages";
+
+//#region src/changesets/next-versions.ts
+/**
+* Resolve the next release version of every workspace package from pending changesets.
+*
+* Walks up from `cwd` to the monorepo root via `@manypkg/get-packages`, seeds the map with
+* each package's CURRENT version, then overlays `newVersion` for changeset-affected packages
+* via `@changesets/get-release-plan`. Never rejects: any failure (not a workspace, missing
+* `.changeset/config.json`, parse error) degrades to current versions (or an empty map).
+*/
+async function resolveNextVersions(cwd) {
+	try {
+		const packages = await getPackages(cwd);
+		if (packages.tool === "root") return {
+			root: packages.root.dir,
+			versions: /* @__PURE__ */ new Map()
+		};
+		const versions = /* @__PURE__ */ new Map();
+		for (const p of packages.packages) {
+			const { name, version } = p.packageJson;
+			if (name && version) versions.set(name, version);
+		}
+		try {
+			const plan = await getReleasePlan(packages.root.dir);
+			for (const r of plan.releases) versions.set(r.name, r.newVersion);
+		} catch {}
+		return {
+			root: packages.root.dir,
+			versions
+		};
+	} catch {
+		return {
+			root: cwd,
+			versions: /* @__PURE__ */ new Map()
+		};
+	}
+}
+
+//#endregion
+export { resolveNextVersions };

package/index.d.ts

@@ -564,6 +564,24 @@ declare function syncPublicDir(sourceDir: string, targetDir: string): void;
  */
 declare function resolveManifest(pkg: ManifestLike$1): Promise<ManifestLike$1>;
 //#endregion
+//#region src/changesets/next-versions.d.ts
+/** Result of resolving next release versions for a workspace. */
+interface NextVersions {
+  /** Monorepo root containing `.changeset/` (or `cwd` when no workspace was found). */
+  readonly root: string;
+  /** Canonical package name -> next release version (current version when unbumped). */
+  readonly versions: ReadonlyMap<string, string>;
+}
+/**
+ * Resolve the next release version of every workspace package from pending changesets.
+ *
+ * Walks up from `cwd` to the monorepo root via `@manypkg/get-packages`, seeds the map with
+ * each package's CURRENT version, then overlays `newVersion` for changeset-affected packages
+ * via `@changesets/get-release-plan`. Never rejects: any failure (not a workspace, missing
+ * `.changeset/config.json`, parse error) degrades to current versions (or an empty map).
+ */
+declare function resolveNextVersions(cwd: string): Promise<NextVersions>;
+//#endregion
 //#region src/errors.d.ts
 declare const MetaGenerationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => import("effect/Cause").YieldableError & {
   readonly _tag: "MetaGenerationError";
@@ -662,20 +680,30 @@ interface TsdocOptions {
 }
 /** The `meta` field on defineBuild. Absent means no api-model generation. */
 interface MetaOptions {
-  /** Directories to copy the api-model into on `savvy build --target meta`. */
+  /** Directories to copy the canonical group's api-model into after `savvy build --target prod`. */
   readonly localPaths?: ReadonlyArray<string> | undefined;
+  /**
+   * Forward-look the meta bundle's own `version` and workspace-sibling dep versions to their
+   * NEXT release version from pending changesets. `"auto"` (default) is `false` under CI
+   * (`CI`/`GITHUB_ACTIONS` set) and `true` locally, so a local bundle matches the CI release build.
+   */
+  readonly optimistic?: "auto" | boolean | undefined;
   readonly tsdoc?: TsdocOptions | undefined;
 }
 /** Fully-resolved meta options (no optionals). */
 interface NormalizedMeta {
   readonly localPaths: ReadonlyArray<string>;
+  readonly optimistic: boolean;
   readonly tsdoc: {
     readonly suppressWarnings: ReadonlyArray<WarningSuppressionRule>;
     readonly tagDefinitions: ReadonlyArray<TsdocTagDefinition>;
   };
 }
 /** Fill defaults so downstream code never branches on undefined. */
-declare function normalizeMetaOptions(meta: MetaOptions): NormalizedMeta;
+declare function normalizeMetaOptions(meta: MetaOptions, env?: {
+  CI?: string | undefined;
+  GITHUB_ACTIONS?: string | undefined;
+}): NormalizedMeta;
 //#endregion
 //#region src/targets/config.d.ts
 /** A single object-form publish target. Uses `from` XOR `name` (never both). */
@@ -846,6 +874,12 @@ interface GenerateMetaOptions {
   /** Directories (relative to cwd) to copy the meta bundle into. */
   readonly localPaths: ReadonlyArray<string>;
   readonly tsdoc: NormalizedMeta["tsdoc"];
+  /**
+   * Optional transform applied to the bundle `package.json` (read from `dtsDir`) before it is
+   * written to `outMetaDir` and copied into `localPaths`. Used for the optimistic next-version
+   * rewrite. When omitted, the package.json is copied verbatim.
+   */
+  readonly manifestTransform?: ((pkg: Record<string, unknown>) => Record<string, unknown>) | undefined;
 }
 interface MetaResult {
   readonly apiJsonPath: string;
@@ -860,6 +894,15 @@ interface MetaResult {
  */
 declare function generateMeta(options: GenerateMetaOptions): Promise<MetaResult>;
 //#endregion
+//#region src/meta/optimistic.d.ts
+/**
+ * Rewrite a meta `package.json` so the package's own `version` and any workspace-sibling
+ * dependency version reflect their NEXT release version from `versions`. Pure: returns a new
+ * object, never mutates the input. External/catalog-resolved deps (names absent from `versions`)
+ * are left as-is.
+ */
+declare function rewriteMetaVersions(pkg: Record<string, unknown>, versions: ReadonlyMap<string, string>, selfName: string): Record<string, unknown>;
+//#endregion
 //#region src/meta/tsconfig-resolver.d.ts
 /**
  * Compiler options with enum values converted to their string equivalents.
@@ -1579,5 +1622,5 @@ declare function resolveTargets(options: {
   baseName: string;
 }): TargetResolution;
 //#endregion
-export { type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, type CssOptions, DEFAULT_EXE_NODE_VERSION, type DeriveOptions, type DerivedTsdownOptions, type DualExports, type EmitManifestOptions, type EntryOverride, type Environment, EnvironmentDetector, EnvironmentDetectorLive, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, ExecutorResolver, ExecutorResolverLive, type ExtractOptions, type ExtractResult, FormatSelector, FormatSelectorLive, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, JsonFormatter, type JsxConfig, type LooseFileSpec, type LooseFiles, type ManifestLike, MarkdownFormatter, MetaGenerationError, type MetaOptions, type MetaResult, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PkgOsCpu, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type RenderReportOptions, type RenderedOutput, ReportPipelineLive, ReportTimings, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, SilentFormatter, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, TerminalFormatter, type Timer, type TransformManifestOptions, type TsconfigJsx, TsconfigResolver, type TsdocOptions, type TsdocTagDefinition, type TsdownBuild, type ValidationInput, type WarningSuppressionRule, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
+export { type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, type CssOptions, DEFAULT_EXE_NODE_VERSION, type DeriveOptions, type DerivedTsdownOptions, type DualExports, type EmitManifestOptions, type EntryOverride, type Environment, EnvironmentDetector, EnvironmentDetectorLive, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, ExecutorResolver, ExecutorResolverLive, type ExtractOptions, type ExtractResult, FormatSelector, FormatSelectorLive, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, JsonFormatter, type JsxConfig, type LooseFileSpec, type LooseFiles, type ManifestLike, MarkdownFormatter, MetaGenerationError, type MetaOptions, type MetaResult, type NextVersions, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OutputFormat, OutputRenderer, OutputRendererLive, type PackageJsonEntriesOptions, type PackageJsonLike, type PkgOsCpu, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type RenderReportOptions, type RenderedOutput, ReportPipelineLive, ReportTimings, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, SilentFormatter, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, TerminalFormatter, type Timer, type TransformManifestOptions, type TsconfigJsx, TsconfigResolver, type TsdocOptions, type TsdocTagDefinition, type TsdownBuild, type ValidationInput, type WarningSuppressionRule, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -10,6 +10,7 @@ import { buildTargetGroups } from "./build/build-target-groups.js";
 import { ConfigValidationError, MetaGenerationError } from "./errors.js";
 import { normalizeLooseFiles } from "./build/loose-files.js";
 import { removeDeclarationMaps } from "./build/strip-maps.js";
+import { resolveNextVersions } from "./changesets/next-versions.js";
 import { ConfigValidator } from "./config-validation/ConfigValidator.js";
 import { DEFAULT_EXE_NODE_VERSION, normalizeExeOptions } from "./exe/config.js";
 import { isTargetObject } from "./targets/config.js";
@@ -23,6 +24,7 @@ import { readTsconfigJsx, resolveJsxConfig } from "./jsx/config.js";
 import { normalizeMetaOptions } from "./meta/config.js";
 import { TsconfigResolver, resolvePortableTsconfig } from "./meta/tsconfig-resolver.js";
 import { generateMeta } from "./meta/generate.js";
+import { rewriteMetaVersions } from "./meta/optimistic.js";
 import { CiAnnotationsFormatter } from "./report/formatters/ci-annotations.js";
 import { JsonFormatter } from "./report/formatters/json.js";
 import { MarkdownFormatter } from "./report/formatters/markdown.js";
@@ -43,4 +45,4 @@ import { generateBuildReportSchema } from "./report/schema-export.js";
 import { writeTargetsBinding } from "./targets/binding.js";
 import { CatalogAssemblyError, CatalogResolutionError } from "workspaces-effect";
 
-export { BuildReport as BuildReportSchema, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, DEFAULT_EXE_NODE_VERSION, EnvironmentDetector, EnvironmentDetectorLive, ExecutorResolver, ExecutorResolverLive, FormatSelector, FormatSelectorLive, JsonFormatter, MarkdownFormatter, MetaGenerationError, OutputRenderer, OutputRendererLive, ReportPipelineLive, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsconfigResolver, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolvePortableTsconfig, resolveTargets, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };
+export { BuildReport as BuildReportSchema, CatalogAssemblyError, CatalogResolutionError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, ConfigValidatorLive, DEFAULT_EXE_NODE_VERSION, EnvironmentDetector, EnvironmentDetectorLive, ExecutorResolver, ExecutorResolverLive, FormatSelector, FormatSelectorLive, JsonFormatter, MarkdownFormatter, MetaGenerationError, OutputRenderer, OutputRendererLive, ReportPipelineLive, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsconfigResolver, buildEmittedManifest, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, computeExeFileName, createEntryName, createTimer, defaultManifestTransform, deriveTargetGroupOptions, emitManifest, extractEntries, formatTime, generateBuildReportSchema, generateMeta, isTargetObject, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, packageJsonEntries, readTsconfigJsx, removeDeclarationMaps, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, syncPublicDir, transformBin, transformExports, transformManifest, writeResolvedTsconfig, writeTargetsBinding };

package/meta/config.js

@@ -1,8 +1,14 @@
 //#region src/meta/config.ts
+/** Resolve `"auto"` against the environment; explicit booleans pass through. */
+function resolveOptimistic(value, env) {
+	if (value === true || value === false) return value;
+	return !(env.CI || env.GITHUB_ACTIONS);
+}
 /** Fill defaults so downstream code never branches on undefined. */
-function normalizeMetaOptions(meta) {
+function normalizeMetaOptions(meta, env = process.env) {
 	return {
 		localPaths: meta.localPaths ?? [],
+		optimistic: resolveOptimistic(meta.optimistic, env),
 		tsdoc: {
 			suppressWarnings: meta.tsdoc?.suppressWarnings ?? [],
 			tagDefinitions: meta.tsdoc?.tagDefinitions ?? []

package/meta/generate.js

@@ -18,7 +18,7 @@ function unscopedName(name) {
 * published-package artifact and is written into `dtsDir` (the built pkg/), not the meta bundle.
 */
 async function generateMeta(options) {
-	const { cwd, packageName, tsconfigPath, dtsDir, entries, exportPaths, outMetaDir, localPaths, tsdoc } = options;
+	const { cwd, packageName, tsconfigPath, dtsDir, entries, exportPaths, outMetaDir, localPaths, tsdoc, manifestTransform } = options;
 	const tsdocConfigPath = writeTsdocConfig(cwd, tsdoc);
 	const packageJsonPath = join(cwd, "package.json");
 	mkdirSync(outMetaDir, { recursive: true });
@@ -55,7 +55,9 @@ async function generateMeta(options) {
 	writeFileSync(apiJsonPath, `${JSON.stringify(finalModel, null, 2)}\n`, "utf-8");
 	for (const intermediate of intermediateApiJsons) rmSync(intermediate, { force: true });
 	const bundlePackageJson = join(outMetaDir, "package.json");
-	copyFileSync(join(dtsDir, "package.json"), bundlePackageJson);
+	const builtPkg = JSON.parse(readFileSync(join(dtsDir, "package.json"), "utf-8"));
+	const finalPkg = manifestTransform ? manifestTransform(builtPkg) : builtPkg;
+	writeFileSync(bundlePackageJson, `${JSON.stringify(finalPkg, null, 2)}\n`, "utf-8");
 	const bundleTsconfig = join(outMetaDir, "tsconfig.json");
 	const portableTsconfig = resolvePortableTsconfig(cwd, tsconfigPath);
 	writeFileSync(bundleTsconfig, `${JSON.stringify(portableTsconfig, null, 2)}\n`, "utf-8");

package/meta/optimistic.js

@@ -0,0 +1,32 @@
+//#region src/meta/optimistic.ts
+/** Dependency map fields whose workspace-sibling versions get the optimistic bump. */
+const DEP_FIELDS = [
+	"dependencies",
+	"peerDependencies",
+	"optionalDependencies"
+];
+/**
+* Rewrite a meta `package.json` so the package's own `version` and any workspace-sibling
+* dependency version reflect their NEXT release version from `versions`. Pure: returns a new
+* object, never mutates the input. External/catalog-resolved deps (names absent from `versions`)
+* are left as-is.
+*/
+function rewriteMetaVersions(pkg, versions, selfName) {
+	const out = { ...pkg };
+	const selfNext = versions.get(selfName);
+	if (selfNext !== void 0) out.version = selfNext;
+	for (const field of DEP_FIELDS) {
+		const deps = pkg[field];
+		if (deps === null || typeof deps !== "object") continue;
+		const next = { ...deps };
+		for (const depName of Object.keys(next)) {
+			const v = versions.get(depName);
+			if (v !== void 0) next[depName] = v;
+		}
+		out[field] = next;
+	}
+	return out;
+}
+
+//#endregion
+export { rewriteMetaVersions };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/tsdown-plugins",
-	"version": "0.6.0",
+	"version": "0.7.0",
 	"private": false,
 	"description": "Interface-only tsdown/rolldown plugin pack powering @savvy-web/bundler",
 	"homepage": "https://github.com/savvy-web/systems/tree/main/packages/tsdown-plugins",
@@ -28,7 +28,9 @@
 		"./package.json": "./package.json"
 	},
 	"dependencies": {
+		"@changesets/get-release-plan": "^4.0.16",
 		"@effect/platform-node": "^0.107.0",
+		"@manypkg/get-packages": "^1.1.3",
 		"@microsoft/api-extractor": "^7.58.9",
 		"@microsoft/tsdoc": "^0.16.0",
 		"@microsoft/tsdoc-config": "^0.18.1",