@savvy-web/tsdown-plugins 2.9.4 → 2.10.1

package/index.d.ts

@@ -10,7 +10,6 @@ import { CatalogAssemblyError, DependencyResolutionError, ManifestDecodeError, U
 import { Plugin } from "rolldown";
 import { Context, Effect, Layer, Schema } from "effect";
 import { BundleManifest, ManifestSource, OpenGraphImage, RegistryRef } from "@tsdoctor/manifest";
-//#region src/manifest/transform.d.ts
 /** @public */
 type Json = Record<string, unknown>;
 /**
@@ -109,8 +108,6 @@ interface TransformManifestOptions {
  * @public
  */
 export declare function transformManifest(pkg: Json, options?: TransformManifestOptions): Json;
-//#endregion
-//#region src/manifest/emit-manifest.d.ts
 /** @public */
 interface TargetGroupRef {
   readonly id: string;
@@ -167,15 +164,13 @@ interface EmitManifestOptions {
  * @public
  */
 export declare function emitManifest(options: EmitManifestOptions): Plugin;
-//#endregion
-//#region src/report/schema.d.ts
 declare const ReportTimings_base: Schema.Class<ReportTimings, Schema.Struct<{
   readonly totalMs: Schema.Number;
 }>, {}>;
 /** @public */
 export declare class ReportTimings extends ReportTimings_base {}
 declare const DiagnosticEntry_base: Schema.Class<DiagnosticEntry, Schema.Struct<{
-  readonly source: Schema.Literals<readonly ["tsdown", "rolldown", "api-extractor", "meta"]>;
+  readonly source: Schema.Literals<readonly ["tsdown", "rolldown", "api-extractor", "meta", "config"]>;
   readonly level: Schema.Literals<readonly ["warn", "error"]>;
   readonly text: Schema.String;
   /**
@@ -190,8 +185,9 @@ declare const DiagnosticEntry_base: Schema.Class<DiagnosticEntry, Schema.Struct<
   readonly column: Schema.optional<Schema.Number>;
 }>, {}>;
 /**
- * A captured warning or error, from tsdown's logger, rolldown's onLog, API Extractor, or the meta
- * pass's own sidecar work (`tsdoctor.json` sources, Open Graph generation).
+ * A captured warning or error, from tsdown's logger, rolldown's onLog, API Extractor, the meta
+ * pass's own sidecar work (`tsdoctor.json` sources, Open Graph generation), or an advisory finding
+ * about the build config itself (`config`, e.g. a `publishConfig.targets` set no final release reaches).
  *
  * @public
  */
@@ -236,8 +232,6 @@ declare const BuildReport_base: Schema.Class<BuildReport, Schema.Struct<{
 }>, {}>;
 /** @public */
 declare class BuildReport extends BuildReport_base {}
-//#endregion
-//#region src/report/collector.d.ts
 /** @public */
 type PassKind = PassReport["id"];
 /** @public */
@@ -272,8 +266,6 @@ export declare class BuildCollector {
 declare const BuildCollectorTag_base: Context.ServiceClass<BuildCollectorTag, "@savvy-web/tsdown-plugins/BuildCollector", BuildCollector>;
 /** @public */
 export declare class BuildCollectorTag extends BuildCollectorTag_base {}
-//#endregion
-//#region src/build/target-groups.d.ts
 /**
  * A build group id: "dev" or any prod byte-variant id (e.g. "npm", "github", a custom key).
  *
@@ -428,8 +420,6 @@ interface DerivedTsdownOptions {
  * @public
  */
 export declare function deriveTargetGroupOptions(options: DeriveOptions): DerivedTsdownOptions;
-//#endregion
-//#region src/build/loose-files.d.ts
 /**
  * One standalone bundled output file, declared by its literal output filename.
  *
@@ -475,8 +465,6 @@ interface NormalizedLooseFile {
  * @public
  */
 export declare function normalizeLooseFiles(files: LooseFiles): ReadonlyArray<NormalizedLooseFile>;
-//#endregion
-//#region src/build/build-target-groups.d.ts
 /**
  * Signature compatible with tsdown's `build(inlineConfig)`.
  *
@@ -671,8 +659,6 @@ interface BuildTargetGroupsOptions {
  * @public
  */
 export declare function buildTargetGroups(options: BuildTargetGroupsOptions): Promise<void>;
-//#endregion
-//#region src/build/cjs-default-interop.d.ts
 /**
  * Rolldown plugin: append the CJS default-interop footer to ENTRY chunks of the
  * `cjs` format that export a default alongside named exports.
@@ -692,8 +678,6 @@ export declare function buildTargetGroups(options: BuildTargetGroupsOptions): Pr
  * @public
  */
 export declare function cjsDefaultInterop(): Plugin;
-//#endregion
-//#region src/build/node-builtin-default-interop.d.ts
 /**
  * Rewrite a default import / default re-export of a Node built-in into the
  * equivalent NAMESPACE form, so rolldown's CJS codegen produces correct interop.
@@ -740,8 +724,6 @@ export declare function cjsDefaultInterop(): Plugin;
  * @public
  */
 export declare function nodeBuiltinDefaultInterop(): Plugin;
-//#endregion
-//#region src/build/strip-maps.d.ts
 /**
  * Remove declaration source-map files (`.d.ts.map` / `.d.cts.map`) from a built `pkg`
  * directory, returning the removed paths.
@@ -758,8 +740,6 @@ export declare function nodeBuiltinDefaultInterop(): Plugin;
  * @public
  */
 export declare function removeDeclarationMaps(pkgDir: string): string[];
-//#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";
 } & Readonly<A>;
@@ -804,8 +784,6 @@ export declare class TsdoctorEmitError extends TsdoctorEmitError_base<{
 }> {
   get message(): string;
 }
-//#endregion
-//#region src/entry/extract.d.ts
 /** @public */
 interface PackageJsonLike {
   readonly exports?: unknown;
@@ -837,8 +815,6 @@ interface ExtractResult {
 export declare const createEntryName: (exportKey: string, exportsAsIndexes: boolean) => string;
 /** @public */
 export declare function extractEntries(pkg: PackageJsonLike, options?: ExtractOptions): ExtractResult;
-//#endregion
-//#region src/entry/ambient-dts.d.ts
 /** The declaration-file extension of a path, or undefined when it is not a declaration file. @public */
 export declare function declarationExt(p: string): ".d.ts" | ".d.cts" | ".d.mts" | undefined;
 /** Classification of a single export value for ambient-.d.ts handling. @public */
@@ -887,8 +863,6 @@ export declare function extractAmbientDts(pkg: PackageJsonLike, options?: Extrac
  * extension stripped. @public
  */
 export declare function assertNoEntryCollisions(jsEntryNames: ReadonlyArray<string>, ambient: ReadonlyArray<AmbientDtsEntry>): void;
-//#endregion
-//#region src/build/sync-public.d.ts
 /**
  * Copy the CONTENTS of `sourceDir` into `outDir`, additively.
  *
@@ -925,8 +899,6 @@ interface CopyAmbientDtsOptions {
  * @public
  */
 export declare function copyAmbientDts(options: CopyAmbientDtsOptions): void;
-//#endregion
-//#region src/catalog/resolve-catalogs.d.ts
 /**
  * Minimal shape of a `package.json` manifest needed to resolve catalog and
  * workspace specifiers.
@@ -957,8 +929,6 @@ interface ManifestLike {
  * @public
  */
 export declare function resolveManifest(pkg: ManifestLike): Promise<ManifestLike>;
-//#endregion
-//#region src/changesets/next-versions.d.ts
 /**
  * Result of resolving next release versions for a workspace.
  *
@@ -981,8 +951,6 @@ interface NextVersions {
  * @public
  */
 export declare function resolveNextVersions(cwd: string): Promise<NextVersions>;
-//#endregion
-//#region src/exe/config.d.ts
 /**
  * Default Node runtime embedded in the SEA (parity with the vitest-agent reference).
  *
@@ -1067,8 +1035,6 @@ interface PkgOsCpu {
  * @public
  */
 export declare function normalizeExeOptions(exe: ExeConfig | ReadonlyArray<ExeConfig>, pkg: PkgOsCpu): ReadonlyArray<NormalizedExe>;
-//#endregion
-//#region src/meta/tsdoctor-config.d.ts
 /**
  * What an Open Graph image generator receives: the merged identity of the
  * package being built, after the config, leaf and project tiers resolved.
@@ -1129,8 +1095,6 @@ interface TsdoctorMetaOptions {
   /** Registries; `false` disables the default derived from `targets.json`. */
   readonly registries?: ReadonlyArray<RegistryRef> | false | undefined;
 }
-//#endregion
-//#region src/meta/config.d.ts
 /**
  * A single TSDoc tag definition (parity with api-extractor's TSDoc config).
  *
@@ -1207,8 +1171,23 @@ export declare function normalizeMetaOptions(meta: MetaOptions, env?: {
   CI?: string | undefined;
   GITHUB_ACTIONS?: string | undefined;
 }): NormalizedMeta;
-//#endregion
-//#region src/targets/config.d.ts
+/**
+ * Which release versions a target receives: every version, only final versions, or only prereleases.
+ *
+ * @remarks
+ * A prerelease is any version carrying a SemVer prerelease suffix (`1.2.0-beta.1`). The filter is
+ * applied per target at publish time, never at build time, so a `from` target that shares a group
+ * with a differently-filtered target still reuses the same bytes.
+ *
+ * @public
+ */
+type ReleaseChannel = "all" | "stable" | "prerelease";
+/**
+ * Every {@link ReleaseChannel} value, in declaration order.
+ *
+ * @public
+ */
+export declare const RELEASE_CHANNELS: ReadonlyArray<ReleaseChannel>;
 /**
  * A single object-form publish target. Uses `from` XOR `name` (never both).
  *
@@ -1221,6 +1200,10 @@ interface PublishTargetObject {
   readonly name?: string | undefined;
   /** Reuse another target's group bytes (deploy them to this registry). Mutually exclusive with `name`. */
   readonly from?: string | undefined;
+  /** Which release versions this target receives. Defaults to `"all"`. */
+  readonly releases?: ReleaseChannel | undefined;
+  /** Force the provenance attestation on or off, overriding the registry-derived default. */
+  readonly provenance?: boolean | undefined;
 }
 /**
  * A `publishConfig.targets` value: `true` (well-known registry, base name), a string (name override), or an object.
@@ -1261,6 +1244,10 @@ interface ResolvedTarget {
   readonly name: string;
   /** The resolved registry endpoint. */
   readonly registry: string;
+  /** Which release versions this target receives; always written, `"all"` when undeclared. */
+  readonly releases: ReleaseChannel;
+  /** The declared provenance override; absent when the target leaves it to the registry default. */
+  readonly provenance?: boolean;
 }
 /**
  * The full resolution of `publishConfig.targets`: the distinct groups to build, and every target bound to one.
@@ -1277,8 +1264,6 @@ interface TargetResolution {
  * @public
  */
 export declare function isTargetObject(value: PublishTargetValue): value is PublishTargetObject;
-//#endregion
-//#region src/config-validation/ConfigValidator.d.ts
 /**
  * The normalized facts the validator checks, assembled by the bundler before any build work.
  *
@@ -1309,8 +1294,6 @@ declare const ConfigValidator_base: Context.ServiceClass<ConfigValidator, "@savv
 export declare class ConfigValidator extends ConfigValidator_base {
   static readonly layer: Layer.Layer<ConfigValidator>;
 }
-//#endregion
-//#region src/dts/reexport-stub.d.ts
 /**
  * The analysis of an entry source treated as a candidate re-export barrel.
  *
@@ -1372,11 +1355,7 @@ export declare function renderReexportStub(options: {
   readonly typeNames: ReadonlyArray<string>;
   readonly baseSpecifier: string;
 }): string;
-//#endregion
-//#region src/dts/relative-imports.d.ts
 export declare function findRelativeSpecifiers(source: string, fileName?: string): string[];
-//#endregion
-//#region src/dts/resolved-tsconfig.d.ts
 /** @public */
 interface ResolvedTsconfigOptions {
   /** Absolute package root. */
@@ -1433,8 +1412,6 @@ export declare function writeResolvedTsconfig(options: ResolvedTsconfigOptions):
  * @public
  */
 export declare function writeDtsEmitTsconfig(resolvedTsconfigPath: string): string;
-//#endregion
-//#region src/entry/package-json-entries.d.ts
 /** @public */
 interface PackageJsonEntriesOptions extends ExtractOptions {
   /** In-memory package.json. If omitted, reads `<cwd>/package.json`. */
@@ -1448,8 +1425,6 @@ interface PackageJsonEntriesOptions extends ExtractOptions {
  * @public
  */
 export declare function packageJsonEntries(options?: PackageJsonEntriesOptions): Record<string, string>;
-//#endregion
-//#region src/exe/build.d.ts
 /**
  * A minimal structural type for tsdown's build, kept loose so this package keeps no tsdown runtime dep (interface-only).
  *
@@ -1482,8 +1457,6 @@ interface RunExeBuildOptions {
  * @public
  */
 export declare function runExeBuild(options: RunExeBuildOptions): Promise<void>;
-//#endregion
-//#region src/exe/filename.d.ts
 /**
  * The exact filename `@tsdown/exe` emits for a SEA target, mirroring tsdown's
  * `resolveOutputFileName`: base fileName + `-<platform>-<arch>` + `.exe` on win.
@@ -1491,8 +1464,6 @@ export declare function runExeBuild(options: RunExeBuildOptions): Promise<void>;
  * @public
  */
 export declare function computeExeFileName(fileName: string, target: ExeTarget): string;
-//#endregion
-//#region src/jsx/config.d.ts
 /**
  * Resolved JSX transform settings. The shape mirrors the subset of rolldown's JsxOptions, but the
  * bundler consumes it to populate the generated dts tsconfig's `jsx`/`jsxImportSource`, not by
@@ -1529,8 +1500,6 @@ export declare function resolveJsxConfig(tsconfig: TsconfigJsx, override: JsxCon
  * @public
  */
 export declare function readTsconfigJsx(cwd: string): TsconfigJsx;
-//#endregion
-//#region src/meta/tsdoctor-manifest.d.ts
 /**
  * A `targets.json` target as the manifest composer sees it: the human label and the registry endpoint.
  *
@@ -1606,8 +1575,6 @@ export declare function composeTsdoctorManifest(input: ComposeManifestInput): Bu
 export declare function ogImageInfoOf(input: ComposeManifestInput & {
   readonly version: string;
 }): OgImageInfo;
-//#endregion
-//#region src/meta/generate.d.ts
 /** @public */
 interface GenerateMetaOptions {
   readonly cwd: string;
@@ -1669,8 +1636,6 @@ interface MetaResult {
  * @public
  */
 export declare function generateMeta(options: GenerateMetaOptions): Promise<MetaResult>;
-//#endregion
-//#region src/meta/og-image.d.ts
 declare const OgGenerateError_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: "OgGenerateError";
 } & Readonly<A>;
@@ -1724,8 +1689,6 @@ interface WriteGeneratedOgImageOptions {
  * @public
  */
 export declare function writeGeneratedOgImage(options: WriteGeneratedOgImageOptions): Promise<OpenGraphImage>;
-//#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
@@ -1734,8 +1697,6 @@ export declare function writeGeneratedOgImage(options: WriteGeneratedOgImageOpti
  * @public
  */
 export declare function rewriteMetaVersions(pkg: Record<string, unknown>, versions: ReadonlyMap<string, string>, selfName: string): Record<string, unknown>;
-//#endregion
-//#region src/meta/tsdoctor-source.d.ts
 declare const TsdoctorSourceError_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: "TsdoctorSourceError";
 } & Readonly<A>;
@@ -1774,8 +1735,6 @@ interface TsdoctorSources {
  * @public
  */
 export declare function loadTsdoctorSources(cwd: string): Promise<TsdoctorSources>;
-//#endregion
-//#region src/meta/run-pass.d.ts
 /**
  * Options for the meta-pass orchestrator.
  *
@@ -1837,8 +1796,6 @@ export declare function applySubdirMetaEntries(overrides: ReadonlyArray<{
   entries: ReadonlyArray<string>;
   outSubdir?: string | undefined;
 }> | undefined, dtsBasenames: Record<string, string>, exportPaths: Record<string, string>): void;
-//#endregion
-//#region src/meta/tsconfig-resolver.d.ts
 /**
  * Compiler options with enum values converted to their string equivalents.
  *
@@ -1891,8 +1848,6 @@ interface PortableTsconfig {
  * @public
  */
 export declare function resolvePortableTsconfig(cwd: string, fallbackConfigPath?: string): PortableTsconfig;
-//#endregion
-//#region src/report/formatters/types.d.ts
 /** @public */
 interface RenderedOutput {
   readonly target: "stdout" | "file" | "github-summary";
@@ -1909,28 +1864,16 @@ interface Formatter {
   readonly format: string;
   readonly render: (reports: ReadonlyArray<BuildReport>, ctx: FormatterContext) => ReadonlyArray<RenderedOutput>;
 }
-//#endregion
-//#region src/report/formatters/ci-annotations.d.ts
 /** @public */
 export declare const CiAnnotationsFormatter: Formatter;
-//#endregion
-//#region src/report/formatters/json.d.ts
 /** @public */
 export declare const JsonFormatter: Formatter;
-//#endregion
-//#region src/report/formatters/markdown.d.ts
 /** @public */
 export declare const MarkdownFormatter: Formatter;
-//#endregion
-//#region src/report/formatters/silent.d.ts
 /** @public */
 export declare const SilentFormatter: Formatter;
-//#endregion
-//#region src/report/formatters/terminal.d.ts
 /** @public */
 export declare const TerminalFormatter: Formatter;
-//#endregion
-//#region src/report/issues-artifact.d.ts
 /**
  * A diagnostic flattened to a plain JSON object (only defined fields are present).
  *
@@ -2021,8 +1964,6 @@ export declare function writeIssuesArtifact(opts: {
     message: string;
   } | undefined;
 }): string;
-//#endregion
-//#region src/report/metrics-plugin.d.ts
 /**
  * Rolldown plugin that records emitted-file metrics into the BuildCollector via writeBundle (which
  * fires for the JS pass AND the emitDtsOnly dts pass — verified against tsdown 0.22.3), plus a
@@ -2036,8 +1977,6 @@ export declare function writeIssuesArtifact(opts: {
  * @public
  */
 export declare function buildMetricsPlugin(collector: BuildCollector, groupId: string, pass: PassKind, verbose: boolean, suppressMixedExports?: boolean): Plugin;
-//#endregion
-//#region src/report/services/EnvironmentDetector.d.ts
 /** @public */
 type Environment = "agent-shell" | "terminal" | "ci-github" | "ci-generic";
 declare const EnvironmentDetector_base: Context.ServiceClass<EnvironmentDetector, "@savvy-web/tsdown-plugins/EnvironmentDetector", {
@@ -2047,8 +1986,6 @@ declare const EnvironmentDetector_base: Context.ServiceClass<EnvironmentDetector
 export declare class EnvironmentDetector extends EnvironmentDetector_base {
   static readonly layer: Layer.Layer<EnvironmentDetector>;
 }
-//#endregion
-//#region src/report/services/ExecutorResolver.d.ts
 /** @public */
 type Executor = "human" | "agent" | "ci";
 declare const ExecutorResolver_base: Context.ServiceClass<ExecutorResolver, "@savvy-web/tsdown-plugins/ExecutorResolver", {
@@ -2058,8 +1995,6 @@ declare const ExecutorResolver_base: Context.ServiceClass<ExecutorResolver, "@sa
 export declare class ExecutorResolver extends ExecutorResolver_base {
   static readonly layer: Layer.Layer<ExecutorResolver>;
 }
-//#endregion
-//#region src/report/services/FormatSelector.d.ts
 /** @public */
 type OutputFormat = "terminal" | "json" | "markdown" | "ci-annotations" | "silent";
 declare const FormatSelector_base: Context.ServiceClass<FormatSelector, "@savvy-web/tsdown-plugins/FormatSelector", {
@@ -2069,8 +2004,6 @@ declare const FormatSelector_base: Context.ServiceClass<FormatSelector, "@savvy-
 export declare class FormatSelector extends FormatSelector_base {
   static readonly layer: Layer.Layer<FormatSelector>;
 }
-//#endregion
-//#region src/report/services/OutputRenderer.d.ts
 declare const OutputRenderer_base: Context.ServiceClass<OutputRenderer, "@savvy-web/tsdown-plugins/OutputRenderer", {
   readonly render: (reports: ReadonlyArray<BuildReport>, format: OutputFormat, ctx: FormatterContext) => Effect.Effect<ReadonlyArray<RenderedOutput>>;
 }>;
@@ -2078,8 +2011,6 @@ declare const OutputRenderer_base: Context.ServiceClass<OutputRenderer, "@savvy-
 export declare class OutputRenderer extends OutputRenderer_base {
   static readonly layer: Layer.Layer<OutputRenderer>;
 }
-//#endregion
-//#region src/report/pipeline.d.ts
 /** @public */
 export declare const ReportPipeline: Layer.Layer<EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer, never, never>;
 /** @public */
@@ -2092,8 +2023,6 @@ interface RenderReportOptions {
 }
 /** @public */
 export declare const renderReport: (reports: ReadonlyArray<BuildReport>, options: RenderReportOptions) => Effect.Effect<ReadonlyArray<RenderedOutput>, never, EnvironmentDetector | ExecutorResolver | FormatSelector | OutputRenderer>;
-//#endregion
-//#region src/report/timer.d.ts
 /** @public */
 export declare function formatTime(ms: number): string;
 /** @public */
@@ -2107,8 +2036,6 @@ interface Timer {
  * @public
  */
 export declare function createTimer(now?: () => number): Timer;
-//#endregion
-//#region src/report/tsdown-logger.d.ts
 /**
  * Structural match for tsdown's Logger interface (tsdown 0.22.x).
  *
@@ -2131,16 +2058,12 @@ interface TsdownLogger {
  * @public
  */
 export declare function createTsdownLogger(collector: BuildCollector, groupId: string): TsdownLogger;
-//#endregion
-//#region src/targets/binding.d.ts
 /**
  * Write the target-to-group binding to dist/prod/targets.json for the release action to consume. Returns the path.
  *
  * @public
  */
 export declare function writeTargetsBinding(cwd: string, resolution: TargetResolution): string;
-//#endregion
-//#region src/targets/resolve-targets.d.ts
 /**
  * Resolve a `publishConfig.targets` map into the distinct groups to build and every target bound to one. Pure; throws ConfigValidationError on structurally-invalid config.
  *
@@ -2150,6 +2073,16 @@ export declare function resolveTargets(options: {
   targets: PublishTargets;
   baseName: string;
 }): TargetResolution;
-//#endregion
-export { type AmbientDtsEntry, type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildIssues, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, type ComposeManifestInput, type CopyAmbientDtsOptions, type CssOptions, DependencyResolutionError, type DeriveOptions, type DerivedTsdownOptions, type DiagnosticEntry, type DiagnosticInput, type DtsExportClass, type DualExports, type EmitManifestOptions, type EmittedFile, type EntryOverride, type Environment, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, type ExtractAmbientOptions, type ExtractOptions, type ExtractResult, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, type JsxConfig, type LooseFileSpec, type LooseFiles, ManifestDecodeError, type ManifestLike, type ManifestRepository, type ManifestTarget, type MetaOptions, type MetaResult, type ModuleExportNames, type NextVersions, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OgImageCacheOptions, type OgImageGenerator, type OgImageInfo, type OutputFormat, type PackageJsonEntriesOptions, type PackageJsonLike, type PassKind, type PassReport, type PkgOsCpu, type PlainDiagnostic, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type ReexportBarrelAnalysis, type RenderReportOptions, type RenderedOutput, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, type RunMetaPassOptions, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, type Timer, type TransformManifestOptions, type TsconfigJsx, type TsdocOptions, type TsdocTagDefinition, type TsdoctorMetaOptions, type TsdoctorSources, type TsdownBuild, type TsdownLogger, UnresolvedDependencyError, type ValidationInput, type WarningSuppressionRule, type WriteGeneratedOgImageOptions };
+/**
+ * Advisory warnings for a resolved target set that is valid but probably not what was meant.
+ *
+ * @remarks
+ * Today the only one is a set whose every target is `releases: "prerelease"`, which leaves final
+ * versions with nowhere to publish. A warning rather than a {@link ConfigValidationError}, since a
+ * prerelease-only package is a legitimate if unusual setup. Pure; returns one message per finding.
+ *
+ * @public
+ */
+export declare function releaseWarnings(resolution: TargetResolution): ReadonlyArray<string>;
+export { type AmbientDtsEntry, type BuildEmittedManifestOptions, type BuildFormat, type BuildGroupSpec, type BuildIssues, type BuildPlatform, type BuildReport, BuildReport as BuildReportSchema, type BuildTargetGroupsOptions, CatalogAssemblyError, type ComposeManifestInput, type CopyAmbientDtsOptions, type CssOptions, DependencyResolutionError, type DeriveOptions, type DerivedTsdownOptions, type DiagnosticEntry, type DiagnosticInput, type DtsExportClass, type DualExports, type EmitManifestOptions, type EmittedFile, type EntryOverride, type Environment, type ExeBuild, type ExeConfig, type ExeRewrite, type ExeSeaConfig, type ExeTarget, type ExeTargetInput, type Executor, type ExtractAmbientOptions, type ExtractOptions, type ExtractResult, type Formatter, type FormatterContext, type GenerateMetaOptions, type Json, type JsxConfig, type LooseFileSpec, type LooseFiles, ManifestDecodeError, type ManifestLike, type ManifestRepository, type ManifestTarget, type MetaOptions, type MetaResult, type ModuleExportNames, type NextVersions, type NormalizedExe, type NormalizedLooseFile, type NormalizedMeta, type OgImageCacheOptions, type OgImageGenerator, type OgImageInfo, type OutputFormat, type PackageJsonEntriesOptions, type PackageJsonLike, type PassKind, type PassReport, type PkgOsCpu, type PlainDiagnostic, type PortableTsconfig, type PublishTargetObject, type PublishTargetValue, type PublishTargets, type ReexportBarrelAnalysis, type ReleaseChannel, type RenderReportOptions, type RenderedOutput, type ResolvedCompilerOptions, type ResolvedGroup, type ResolvedTarget, type ResolvedTsconfig, type ResolvedTsconfigOptions, type RunExeBuildOptions, type RunMetaPassOptions, type TargetGroupId, type TargetGroupRef, type TargetGroupReport, TargetGroupReport as TargetGroupReportSchema, type TargetResolution, type Timer, type TransformManifestOptions, type TsconfigJsx, type TsdocOptions, type TsdocTagDefinition, type TsdoctorMetaOptions, type TsdoctorSources, type TsdownBuild, type TsdownLogger, UnresolvedDependencyError, type ValidationInput, type WarningSuppressionRule, type WriteGeneratedOgImageOptions };
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -19,8 +19,8 @@ import { normalizeLooseFiles } from "./build/loose-files.js";
 import { removeDeclarationMaps } from "./build/strip-maps.js";
 import { resolveNextVersions } from "./changesets/next-versions.js";
 import { DEFAULT_EXE_NODE_VERSION, normalizeExeOptions } from "./exe/config.js";
-import { isTargetObject } from "./targets/config.js";
-import { resolveTargets } from "./targets/resolve-targets.js";
+import { RELEASE_CHANNELS, isTargetObject } from "./targets/config.js";
+import { releaseWarnings, resolveTargets } from "./targets/resolve-targets.js";
 import { ConfigValidator } from "./config-validation/ConfigValidator.js";
 import { packageJsonEntries } from "./entry/package-json-entries.js";
 import { runExeBuild } from "./exe/build.js";
@@ -50,4 +50,4 @@ import { ReportPipeline, renderReport } from "./report/pipeline.js";
 import { writeTargetsBinding } from "./targets/binding.js";
 import { CatalogAssemblyError, DependencyResolutionError, ManifestDecodeError, UnresolvedDependencyError } from "@effected/npm";
 
-export { BuildCollector, BuildCollectorTag, BuildReport as BuildReportSchema, CatalogAssemblyError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, DEFAULT_EXE_NODE_VERSION, DependencyResolutionError, EnvironmentDetector, ExecutorResolver, FormatSelector, JsonFormatter, ManifestDecodeError, MarkdownFormatter, MetaGenerationError, OgGenerateError, OutputRenderer, ReportPipeline, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsdoctorEmitError, TsdoctorSourceError, UnresolvedDependencyError, ambientOutName, analyzeReexportBarrel, applySubdirMetaEntries, assertNoEntryCollisions, buildEmittedManifest, buildMetricsPlugin, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, classifyDtsExport, collectExportNames, composeTsdoctorManifest, computeExeFileName, copyAmbientDts, copyPublicDir, createEntryName, createTimer, createTsdownLogger, declarationExt, defaultManifestTransform, deriveExportPaths, deriveTargetGroupOptions, emitManifest, extractAmbientDts, extractEntries, findRelativeSpecifiers, flattenIssues, formatTime, generateMeta, githubOwnerRepo, isTargetObject, loadTsdoctorSources, mixedDtsExportError, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, ogImageInfoOf, packageJsonEntries, readTsconfigJsx, registriesFromTargets, removeDeclarationMaps, renderReexportStub, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolveOgCacheSalt, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, runMetaPass, serializeIssues, transformBin, transformExports, transformManifest, writeDtsEmitTsconfig, writeGeneratedOgImage, writeIssuesArtifact, writeResolvedTsconfig, writeTargetsBinding };
+export { BuildCollector, BuildCollectorTag, BuildReport as BuildReportSchema, CatalogAssemblyError, CiAnnotationsFormatter, ConfigValidationError, ConfigValidator, DEFAULT_EXE_NODE_VERSION, DependencyResolutionError, EnvironmentDetector, ExecutorResolver, FormatSelector, JsonFormatter, ManifestDecodeError, MarkdownFormatter, MetaGenerationError, OgGenerateError, OutputRenderer, RELEASE_CHANNELS, ReportPipeline, ReportTimings, SilentFormatter, TargetGroupReport as TargetGroupReportSchema, TerminalFormatter, TsdoctorEmitError, TsdoctorSourceError, UnresolvedDependencyError, ambientOutName, analyzeReexportBarrel, applySubdirMetaEntries, assertNoEntryCollisions, buildEmittedManifest, buildMetricsPlugin, buildResolvedTsconfig, buildTargetGroups, cjsDefaultInterop, classifyDtsExport, collectExportNames, composeTsdoctorManifest, computeExeFileName, copyAmbientDts, copyPublicDir, createEntryName, createTimer, createTsdownLogger, declarationExt, defaultManifestTransform, deriveExportPaths, deriveTargetGroupOptions, emitManifest, extractAmbientDts, extractEntries, findRelativeSpecifiers, flattenIssues, formatTime, generateMeta, githubOwnerRepo, isTargetObject, loadTsdoctorSources, mixedDtsExportError, nodeBuiltinDefaultInterop, normalizeBinPaths, normalizeExeOptions, normalizeLooseFiles, normalizeMetaOptions, ogImageInfoOf, packageJsonEntries, readTsconfigJsx, registriesFromTargets, releaseWarnings, removeDeclarationMaps, renderReexportStub, renderReport, resolveJsxConfig, resolveManifest, resolveNextVersions, resolveOgCacheSalt, resolvePortableTsconfig, resolveTargets, rewriteMetaVersions, runExeBuild, runMetaPass, serializeIssues, transformBin, transformExports, transformManifest, writeDtsEmitTsconfig, writeGeneratedOgImage, writeIssuesArtifact, writeResolvedTsconfig, writeTargetsBinding };

package/jsx/config.js

@@ -4,7 +4,7 @@ import * as nodePath from "node:path";
 import { JsxConfig, TsconfigLoaderSync } from "@effected/tsconfig-json";
 import { Option } from "effect";
 
-//#region src/jsx/config.ts
+// src/jsx/config.ts
 /**
 * Resolve the effective JSX config: an explicit override wins; otherwise infer from the tsconfig
 * values via `@effected/tsconfig-json`'s `JsxConfig.fromCompilerOptions`. Returns undefined when
@@ -48,5 +48,4 @@ function readTsconfigJsx(cwd) {
 	}
 }
 
-//#endregion
 export { readTsconfigJsx, resolveJsxConfig };

package/manifest/emit-manifest.js

@@ -4,7 +4,7 @@ import { DependencySpecifier } from "@effected/npm";
 import { join } from "node:path";
 import { readFile } from "node:fs/promises";
 
-//#region src/manifest/emit-manifest.ts
+// src/manifest/emit-manifest.ts
 const DEPENDENCY_FIELDS = [
 	"dependencies",
 	"devDependencies",
@@ -85,5 +85,4 @@ function emitManifest(options) {
 	};
 }
 
-//#endregion
 export { buildEmittedManifest, emitManifest, manifestNeedsCatalogResolution };

package/manifest/transform.js

@@ -2,7 +2,7 @@ import { createEntryName } from "../entry/extract.js";
 import { ambientOutName, classifyDtsExport, mixedDtsExportError } from "../entry/ambient-dts.js";
 import { PackageJsonFormat } from "@effected/package-json";
 
-//#region src/manifest/transform.ts
+// src/manifest/transform.ts
 const isDualKey = (dual, exportKey) => typeof dual === "boolean" ? dual : dual.has(exportKey);
 /**
 * Package.json fields that are never wanted in a published manifest: they describe
@@ -212,5 +212,4 @@ function transformManifest(pkg, options = {}) {
 	return PackageJsonFormat.sortValue(result);
 }
 
-//#endregion
 export { defaultManifestTransform, normalizeBinPaths, transformBin, transformExports, transformManifest };

package/meta/api-extractor.js

@@ -8,7 +8,7 @@ import { createHash } from "node:crypto";
 import { Extractor, ExtractorConfig, ExtractorLogLevel } from "@microsoft/api-extractor";
 import { TSDocConfigFile } from "@microsoft/tsdoc-config";
 
-//#region src/meta/api-extractor.ts
+// src/meta/api-extractor.ts
 const require_ = createRequire(import.meta.url);
 /** messageIds that become a hard build error in CI (they corrupt the .api.json). */
 const CI_FATAL_MESSAGE_IDS = /* @__PURE__ */ new Set(["ae-forgotten-export"]);
@@ -163,5 +163,4 @@ function runApiExtractor(options) {
 	});
 }
 
-//#endregion
 export { mapExtractorMessage, runApiExtractor, writeApiExtractorTsconfig };

package/meta/config.js

@@ -1,4 +1,4 @@
-//#region src/meta/config.ts
+// src/meta/config.ts
 /** Resolve `"auto"` against the environment; explicit booleans pass through. */
 function resolveOptimistic(value, env) {
 	if (value === true || value === false) return value;
@@ -21,5 +21,4 @@ function normalizeMetaOptions(meta, env = process.env) {
 	};
 }
 
-//#endregion
 export { normalizeMetaOptions };

package/meta/generate.js

@@ -10,7 +10,7 @@ import { join } from "node:path";
 import { Effect } from "effect";
 import { TSDOCTOR_MANIFEST_FILENAME, encodeBundleManifest } from "@tsdoctor/manifest";
 
-//#region src/meta/generate.ts
+// src/meta/generate.ts
 function unscopedName(name) {
 	const slash = name.lastIndexOf("/");
 	return slash >= 0 ? name.slice(slash + 1) : name;
@@ -217,5 +217,4 @@ async function generateMeta(options) {
 	};
 }
 
-//#endregion
 export { generateMeta };

package/meta/merge-models.js

@@ -1,4 +1,4 @@
-//#region src/meta/merge-models.ts
+// src/meta/merge-models.ts
 /** Rewrite every nested member canonicalReference that starts with originalPrefix to use newPrefix. Skips the EntryPoint node itself. */
 function rewriteCanonicalReferences(node, originalPrefix, newPrefix) {
 	if (!node || typeof node !== "object") return;
@@ -40,5 +40,4 @@ function mergeApiModels(options) {
 	return merged;
 }
 
-//#endregion
 export { mergeApiModels };

package/meta/message-suppressor.js

@@ -1,4 +1,4 @@
-//#region src/meta/message-suppressor.ts
+// src/meta/message-suppressor.ts
 function compileRule(rule) {
 	if (rule.pattern === void 0) return {
 		messageId: rule.messageId,
@@ -33,5 +33,4 @@ function createMessageSuppressor(rules) {
 	} };
 }
 
-//#endregion
 export { createMessageSuppressor };

package/meta/og-image.js

@@ -4,7 +4,7 @@ import { Data, Effect, Layer, Option, Result, Schema } from "effect";
 import * as NodeServices from "@effect/platform-node/NodeServices";
 import { ImageBackend, ImageCache, ImageCacheKey } from "@effected/images/cache";
 
-//#region src/meta/og-image.ts
+// src/meta/og-image.ts
 /**
 * A configured `openGraph.generate` renderer threw, returned no bytes, or returned bytes that are
 * not an image. Fails the build: a half-written OG image is worse than none.
@@ -103,5 +103,4 @@ async function writeGeneratedOgImage(options) {
 	};
 }
 
-//#endregion
 export { OgGenerateError, resolveOgCacheSalt, writeGeneratedOgImage };