@savvy-web/silk 1.1.2 → 1.3.0

package/changesets-markdownlint.d.cts

@@ -3298,7 +3298,7 @@ type Label = Label$1;
 type Severity = Severity$1;
 type Plugin<Tree extends Node$3 = Node$3, Option extends unknown = unknown> = (config?: [level: Label | Severity | boolean, option?: Option] | Label | Option | Severity) => ((tree: Tree, file: VFile, next: TransformCallback<Tree>) => undefined) | undefined;
 //#endregion
-//#region ../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect+platform@0.96.1_effect@3.21.3__effect@3.21.3/node_modules/workspaces-effect/index.d.ts
+//#region ../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect+platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/index.d.ts
 /**
  * Result of comparing two WorkspacePackage dependency snapshots.
  * @public
@@ -4328,6 +4328,11 @@ type Changeset$1 = {
 type NewChangeset = Changeset$1 & {
   id: string;
 };
+type ReleasePlan = {
+  changesets: NewChangeset[];
+  releases: ComprehensiveRelease[];
+  preState: PreState | undefined;
+};
 type PackageJSON = {
   name: string;
   version: string;
@@ -4365,6 +4370,14 @@ type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenc
 type ChangelogFunctions = {
   getReleaseLine: GetReleaseLine;
   getDependencyReleaseLine: GetDependencyReleaseLine;
+};
+type PreState = {
+  mode: "pre" | "exit";
+  tag: string;
+  initialVersions: {
+    [pkgName: string]: string;
+  };
+  changesets: string[];
 }; //#endregion
 //#region src/changesets/api/changelog.d.ts
 /**
@@ -6188,7 +6201,6 @@ declare const changelogFunctions: ChangelogFunctions; //#endregion
  *
  * @see {@link https://effect.website/docs/data-types/data#taggerror | Effect TaggedError documentation}
  *
- * @packageDocumentation
  */
 /**
  * Base class for {@link ChangesetValidationError}.
@@ -6490,6 +6502,33 @@ declare class GitError extends GitErrorBase<{
   readonly reason: string;
 }> {
   get message(): string;
+}
+/**
+ * Base class for {@link ReleasePlanError}.
+ *
+ * @privateRemarks
+ * Required export for api-extractor (anonymous Data.TaggedError base). Do not delete.
+ *
+ * @internal
+ */
+declare const ReleasePlanErrorBase: 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: "ReleasePlanError";
+} & Readonly<A>;
+/**
+ * Release planning, preview, or apply failure.
+ *
+ * @remarks
+ * Wraps any failure from the underlying `@changesets/*` machinery
+ * (`getReleasePlan`, `applyReleasePlan`, config resolution) into a typed
+ * Effect error, tagged with the phase that failed.
+ *
+ * @public
+ */
+declare class ReleasePlanError extends ReleasePlanErrorBase<{
+  /** The phase that failed. */readonly phase: "plan" | "preview" | "apply"; /** Human-readable failure reason. */
+  readonly reason: string;
+}> {
+  get message(): string;
 } //#endregion
 //#region src/errors/ChangesetConfigError.d.ts
 declare const ChangesetConfigError_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 & {
@@ -6499,10 +6538,11 @@ declare const ChangesetConfigError_base: new <A extends Record<string, any> = {}
  * Raised when the `.changeset/config.json` file cannot be read or decoded.
  *
  * @remarks
- * Returned by {@link ChangesetConfigReader.read} when the file is missing,
+ * Returned by `ChangesetConfigReader.read` when the file is missing,
  * contains invalid JSON, or fails Effect Schema validation.
  *
  * @since 0.1.0
+ * @public
  */
 declare class ChangesetConfigError extends ChangesetConfigError_base<{
   readonly path: string;
@@ -6516,11 +6556,12 @@ declare class ChangesetConfigError extends ChangesetConfigError_base<{
  *
  * @remarks
  * Represents the parsed `.changeset/config.json` file. All fields are optional
- * to allow partial configs. Use {@link SilkChangesetConfigFile} when the Silk changelog
+ * to allow partial configs. Use {@link (SilkChangesetConfigFile:type)} when the Silk changelog
  * adapter is detected.
  *
  * @since 0.1.0
  */
+/** @public */
 declare const ChangesetConfigFile: Schema.Struct<{
   changelog: Schema.optional<Schema.Union<[typeof Schema.String, Schema.Array$<typeof Schema.Unknown>, Schema.Literal<[false]>]>>;
   commit: Schema.optional<Schema.Union<[typeof Schema.Boolean, typeof Schema.String, Schema.Array$<typeof Schema.Unknown>]>>;
@@ -6542,18 +6583,22 @@ declare const ChangesetConfigFile: Schema.Struct<{
     prereleaseTemplate: Schema.optional<typeof Schema.String>;
   }>>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type ChangesetConfigFile = typeof ChangesetConfigFile.Type;
 /**
  * Extended changeset config for repos using the `@savvy-web/changesets` changelog adapter.
  *
  * @remarks
- * Extends {@link ChangesetConfigFile} with a `_isSilk` marker flag that is automatically
+ * Extends {@link (ChangesetConfigFile:type)} with a `_isSilk` marker flag that is automatically
  * set to `true`. Detected by {@link ChangesetConfigReader} when the `changelog` field
  * references `@savvy-web/changesets`.
  *
  * @since 0.1.0
  */
+/** @public */
 declare const SilkChangesetConfigFile: Schema.extend<Schema.Struct<{
   changelog: Schema.optional<Schema.Union<[typeof Schema.String, Schema.Array$<typeof Schema.Unknown>, Schema.Literal<[false]>]>>;
   commit: Schema.optional<Schema.Union<[typeof Schema.Boolean, typeof Schema.String, Schema.Array$<typeof Schema.Unknown>]>>;
@@ -6579,7 +6624,10 @@ declare const SilkChangesetConfigFile: Schema.extend<Schema.Struct<{
     default: () => true;
   }>;
 }>>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type SilkChangesetConfigFile = typeof SilkChangesetConfigFile.Type;
 /**
  * Versioning strategy classification for a workspace.
@@ -6590,6 +6638,7 @@ type SilkChangesetConfigFile = typeof SilkChangesetConfigFile.Type;
  * - `"independent"` — multiple publishable packages with independent version bumps.
  *
  * @since 0.1.0
+ * @public
  */
 //#endregion
 //#region src/services/ChangesetConfigReader.d.ts
@@ -6609,8 +6658,8 @@ declare const ChangesetConfigReader_base: Context.TagClass<ChangesetConfigReader
  *
  * @remarks
  * Automatically detects whether the config uses the Silk changelog adapter
- * (`@savvy-web/changesets`) and decodes as {@link SilkChangesetConfigFile} or the
- * standard {@link ChangesetConfigFile} accordingly.
+ * (`@savvy-web/changesets`) and decodes as {@link (SilkChangesetConfigFile:type)} or the
+ * standard {@link (ChangesetConfigFile:type)} accordingly.
  *
  * @example
  * ```typescript
@@ -6626,6 +6675,7 @@ declare const ChangesetConfigReader_base: Context.TagClass<ChangesetConfigReader
  * ```
  *
  * @since 0.1.0
+ * @public
  */
 declare class ChangesetConfigReader extends ChangesetConfigReader_base {}
 /**
@@ -6636,6 +6686,7 @@ declare class ChangesetConfigReader extends ChangesetConfigReader_base {}
  * `BunContext.layer` to satisfy this dependency.
  *
  * @since 0.1.0
+ * @public
  */
 //#endregion
 //#region src/changesets/services/config-inspector.d.ts
@@ -6768,7 +6819,7 @@ declare class ConfigInspector extends ConfigInspectorBase {}
 /**
  * Live layer for {@link ConfigInspector}.
  *
- * Requires {@link ChangesetConfigReader} and {@link WorkspaceDiscovery}
+ * Requires {@link ChangesetConfigReader} and `WorkspaceDiscovery`
  * in the environment.
  *
  * @public
@@ -7402,6 +7453,118 @@ declare const ChangelogServiceBase: Context.TagClass<ChangelogService, "Changelo
  * @public
  */
 declare class ChangelogService extends ChangelogServiceBase {} //#endregion
+//#region src/changesets/schemas/release-plan.d.ts
+/** A semantic-version bump level (the `"none"` plan type is filtered out upstream). @public */
+declare const BumpTypeSchema: Schema.Literal<["major", "minor", "patch"]>;
+/** A semantic-version bump level. @public */
+type BumpType = Schema.Schema.Type<typeof BumpTypeSchema>;
+/** One package's previewed release: version transition + rendered changelog block. @public */
+declare const PreviewReleaseSchema: Schema.Struct<{
+  name: typeof Schema.String;
+  type: Schema.Literal<["major", "minor", "patch"]>;
+  oldVersion: typeof Schema.String;
+  newVersion: typeof Schema.String;
+  changesetIds: Schema.Array$<typeof Schema.String>;
+  changelogEntry: typeof Schema.String;
+}>;
+/** One package's previewed release. @public */
+type PreviewRelease = Schema.Schema.Type<typeof PreviewReleaseSchema>;
+/** A parsed pending changeset (id + summary + the packages it bumps). @public */
+declare const PendingChangesetSchema: Schema.Struct<{
+  id: typeof Schema.String;
+  summary: typeof Schema.String;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+  }>>;
+}>;
+/** A parsed pending changeset. @public */
+type PendingChangeset = Schema.Schema.Type<typeof PendingChangesetSchema>;
+/** Read-only preview of what the next release would produce. @public */
+declare const ChangesetPreviewSchema: Schema.Struct<{
+  preMode: Schema.NullOr<Schema.Literal<["exit", "pre"]>>;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+    oldVersion: typeof Schema.String;
+    newVersion: typeof Schema.String;
+    changesetIds: Schema.Array$<typeof Schema.String>;
+    changelogEntry: typeof Schema.String;
+  }>>;
+  changesets: Schema.Array$<Schema.Struct<{
+    id: typeof Schema.String;
+    summary: typeof Schema.String;
+    releases: Schema.Array$<Schema.Struct<{
+      name: typeof Schema.String;
+      type: Schema.Literal<["major", "minor", "patch"]>;
+    }>>;
+  }>>;
+}>;
+/** Read-only preview of what the next release would produce. @public */
+type ChangesetPreview = Schema.Schema.Type<typeof ChangesetPreviewSchema>;
+/** One applied package release (version transition). @public */
+declare const AppliedReleaseEntrySchema: Schema.Struct<{
+  name: typeof Schema.String;
+  type: Schema.Literal<["major", "minor", "patch"]>;
+  oldVersion: typeof Schema.String;
+  newVersion: typeof Schema.String;
+}>;
+/** A single versionFiles update applied (or planned, when dry). @public */
+declare const VersionFileUpdateRecordSchema: Schema.Struct<{
+  filePath: typeof Schema.String;
+  version: typeof Schema.String;
+}>;
+/** Result of {@link ReleasePlanner.apply}. @public */
+declare const AppliedReleaseSchema: Schema.Struct<{
+  dryRun: typeof Schema.Boolean;
+  touchedFiles: Schema.Array$<typeof Schema.String>;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+    oldVersion: typeof Schema.String;
+    newVersion: typeof Schema.String;
+  }>>;
+  versionFileUpdates: Schema.Array$<Schema.Struct<{
+    filePath: typeof Schema.String;
+    version: typeof Schema.String;
+  }>>;
+}>;
+/** Result of a native apply. @public */
+type AppliedRelease = Schema.Schema.Type<typeof AppliedReleaseSchema>; //#endregion
+//#region src/changesets/services/release-planner.d.ts
+/** The `ReleasePlanner` service surface. @public */
+interface ReleasePlannerShape {
+  /** Compute the in-memory release plan (read-only). */
+  readonly plan: (root: string) => Effect.Effect<ReleasePlan, ReleasePlanError>;
+  /** Render a non-destructive preview of the next release. */
+  readonly preview: (root: string) => Effect.Effect<ChangesetPreview, ReleasePlanError>;
+  /** Natively apply the release (destructive unless `dryRun`). */
+  readonly apply: (root: string, options?: {
+    readonly dryRun?: boolean;
+  }) => Effect.Effect<AppliedRelease, ReleasePlanError>;
+}
+/**
+ * Base class for {@link ReleasePlanner}.
+ *
+ * @privateRemarks Required export for api-extractor (anonymous Context.Tag base). Do not delete.
+ * @internal
+ */
+declare const ReleasePlannerBase: Context.TagClass<ReleasePlanner, "ReleasePlanner", ReleasePlannerShape>;
+/** Effect service tag for the release planner. @public */
+declare class ReleasePlanner extends ReleasePlannerBase {}
+/** Production layer. Requires {@link ConfigInspector} (used by `apply`). @public */
+declare const ReleasePlannerLive: Layer.Layer<ReleasePlanner, never, ConfigInspector>;
+/**
+ * Test factory — supply fixed results for any subset of methods. Unsupplied
+ * methods fail with a `ReleasePlanError`.
+ *
+ * @public
+ */
+declare function makeReleasePlannerTest(fixed: {
+  readonly plan?: ReleasePlan;
+  readonly preview?: ChangesetPreview;
+  readonly apply?: AppliedRelease;
+}): Layer.Layer<ReleasePlanner>; //#endregion
 //#region src/changesets/services/workspace-snapshot.d.ts
 /**
  * One workspace package as it existed at a specific git ref.
@@ -8150,7 +8313,7 @@ declare function serializeDependencyTableToMarkdown(rows: DependencyTableRow[]):
  * Compute the set of currently-publishable workspace package names.
  *
  * @remarks
- * Uses the currently-active {@link PublishabilityDetector} — wire the
+ * Uses the currently-active {@link SilkPublishability} — wire the
  * {@link SilkPublishabilityDetectorLive} layer to get silk semantics.
  *
  * @param packages - The workspace packages to evaluate
@@ -9036,7 +9199,7 @@ declare const RequiredSectionsRule$2: Plugin<Root, unknown>; //#endregion
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule$2: Plugin<Root, unknown>;
 declare namespace index_d_exports {
-  export { AggregateDependencyTablesPlugin, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule$2 as HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PositiveInteger, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
+  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule$2 as HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
 } //#endregion
 //#region src/commitlint/config/schema.d.ts
 /**

package/changesets-markdownlint.d.ts

@@ -3298,7 +3298,7 @@ type Label = Label$1;
 type Severity = Severity$1;
 type Plugin<Tree extends Node$3 = Node$3, Option extends unknown = unknown> = (config?: [level: Label | Severity | boolean, option?: Option] | Label | Option | Severity) => ((tree: Tree, file: VFile, next: TransformCallback<Tree>) => undefined) | undefined;
 //#endregion
-//#region ../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect+platform@0.96.1_effect@3.21.3__effect@3.21.3/node_modules/workspaces-effect/index.d.ts
+//#region ../../node_modules/.pnpm/workspaces-effect@1.2.0_@effect+platform@0.96.2_effect@3.21.4__effect@3.21.4/node_modules/workspaces-effect/index.d.ts
 /**
  * Result of comparing two WorkspacePackage dependency snapshots.
  * @public
@@ -4328,6 +4328,11 @@ type Changeset$1 = {
 type NewChangeset = Changeset$1 & {
   id: string;
 };
+type ReleasePlan = {
+  changesets: NewChangeset[];
+  releases: ComprehensiveRelease[];
+  preState: PreState | undefined;
+};
 type PackageJSON = {
   name: string;
   version: string;
@@ -4365,6 +4370,14 @@ type GetDependencyReleaseLine = (changesets: NewChangesetWithCommit[], dependenc
 type ChangelogFunctions = {
   getReleaseLine: GetReleaseLine;
   getDependencyReleaseLine: GetDependencyReleaseLine;
+};
+type PreState = {
+  mode: "pre" | "exit";
+  tag: string;
+  initialVersions: {
+    [pkgName: string]: string;
+  };
+  changesets: string[];
 }; //#endregion
 //#region src/changesets/api/changelog.d.ts
 /**
@@ -6188,7 +6201,6 @@ declare const changelogFunctions: ChangelogFunctions; //#endregion
  *
  * @see {@link https://effect.website/docs/data-types/data#taggerror | Effect TaggedError documentation}
  *
- * @packageDocumentation
  */
 /**
  * Base class for {@link ChangesetValidationError}.
@@ -6490,6 +6502,33 @@ declare class GitError extends GitErrorBase<{
   readonly reason: string;
 }> {
   get message(): string;
+}
+/**
+ * Base class for {@link ReleasePlanError}.
+ *
+ * @privateRemarks
+ * Required export for api-extractor (anonymous Data.TaggedError base). Do not delete.
+ *
+ * @internal
+ */
+declare const ReleasePlanErrorBase: 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: "ReleasePlanError";
+} & Readonly<A>;
+/**
+ * Release planning, preview, or apply failure.
+ *
+ * @remarks
+ * Wraps any failure from the underlying `@changesets/*` machinery
+ * (`getReleasePlan`, `applyReleasePlan`, config resolution) into a typed
+ * Effect error, tagged with the phase that failed.
+ *
+ * @public
+ */
+declare class ReleasePlanError extends ReleasePlanErrorBase<{
+  /** The phase that failed. */readonly phase: "plan" | "preview" | "apply"; /** Human-readable failure reason. */
+  readonly reason: string;
+}> {
+  get message(): string;
 } //#endregion
 //#region src/errors/ChangesetConfigError.d.ts
 declare const ChangesetConfigError_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 & {
@@ -6499,10 +6538,11 @@ declare const ChangesetConfigError_base: new <A extends Record<string, any> = {}
  * Raised when the `.changeset/config.json` file cannot be read or decoded.
  *
  * @remarks
- * Returned by {@link ChangesetConfigReader.read} when the file is missing,
+ * Returned by `ChangesetConfigReader.read` when the file is missing,
  * contains invalid JSON, or fails Effect Schema validation.
  *
  * @since 0.1.0
+ * @public
  */
 declare class ChangesetConfigError extends ChangesetConfigError_base<{
   readonly path: string;
@@ -6516,11 +6556,12 @@ declare class ChangesetConfigError extends ChangesetConfigError_base<{
  *
  * @remarks
  * Represents the parsed `.changeset/config.json` file. All fields are optional
- * to allow partial configs. Use {@link SilkChangesetConfigFile} when the Silk changelog
+ * to allow partial configs. Use {@link (SilkChangesetConfigFile:type)} when the Silk changelog
  * adapter is detected.
  *
  * @since 0.1.0
  */
+/** @public */
 declare const ChangesetConfigFile: Schema.Struct<{
   changelog: Schema.optional<Schema.Union<[typeof Schema.String, Schema.Array$<typeof Schema.Unknown>, Schema.Literal<[false]>]>>;
   commit: Schema.optional<Schema.Union<[typeof Schema.Boolean, typeof Schema.String, Schema.Array$<typeof Schema.Unknown>]>>;
@@ -6542,18 +6583,22 @@ declare const ChangesetConfigFile: Schema.Struct<{
     prereleaseTemplate: Schema.optional<typeof Schema.String>;
   }>>;
 }>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type ChangesetConfigFile = typeof ChangesetConfigFile.Type;
 /**
  * Extended changeset config for repos using the `@savvy-web/changesets` changelog adapter.
  *
  * @remarks
- * Extends {@link ChangesetConfigFile} with a `_isSilk` marker flag that is automatically
+ * Extends {@link (ChangesetConfigFile:type)} with a `_isSilk` marker flag that is automatically
  * set to `true`. Detected by {@link ChangesetConfigReader} when the `changelog` field
  * references `@savvy-web/changesets`.
  *
  * @since 0.1.0
  */
+/** @public */
 declare const SilkChangesetConfigFile: Schema.extend<Schema.Struct<{
   changelog: Schema.optional<Schema.Union<[typeof Schema.String, Schema.Array$<typeof Schema.Unknown>, Schema.Literal<[false]>]>>;
   commit: Schema.optional<Schema.Union<[typeof Schema.Boolean, typeof Schema.String, Schema.Array$<typeof Schema.Unknown>]>>;
@@ -6579,7 +6624,10 @@ declare const SilkChangesetConfigFile: Schema.extend<Schema.Struct<{
     default: () => true;
   }>;
 }>>;
-/** @since 0.1.0 */
+/**
+ * @since 0.1.0
+ * @public
+ */
 type SilkChangesetConfigFile = typeof SilkChangesetConfigFile.Type;
 /**
  * Versioning strategy classification for a workspace.
@@ -6590,6 +6638,7 @@ type SilkChangesetConfigFile = typeof SilkChangesetConfigFile.Type;
  * - `"independent"` — multiple publishable packages with independent version bumps.
  *
  * @since 0.1.0
+ * @public
  */
 //#endregion
 //#region src/services/ChangesetConfigReader.d.ts
@@ -6609,8 +6658,8 @@ declare const ChangesetConfigReader_base: Context.TagClass<ChangesetConfigReader
  *
  * @remarks
  * Automatically detects whether the config uses the Silk changelog adapter
- * (`@savvy-web/changesets`) and decodes as {@link SilkChangesetConfigFile} or the
- * standard {@link ChangesetConfigFile} accordingly.
+ * (`@savvy-web/changesets`) and decodes as {@link (SilkChangesetConfigFile:type)} or the
+ * standard {@link (ChangesetConfigFile:type)} accordingly.
  *
  * @example
  * ```typescript
@@ -6626,6 +6675,7 @@ declare const ChangesetConfigReader_base: Context.TagClass<ChangesetConfigReader
  * ```
  *
  * @since 0.1.0
+ * @public
  */
 declare class ChangesetConfigReader extends ChangesetConfigReader_base {}
 /**
@@ -6636,6 +6686,7 @@ declare class ChangesetConfigReader extends ChangesetConfigReader_base {}
  * `BunContext.layer` to satisfy this dependency.
  *
  * @since 0.1.0
+ * @public
  */
 //#endregion
 //#region src/changesets/services/config-inspector.d.ts
@@ -6768,7 +6819,7 @@ declare class ConfigInspector extends ConfigInspectorBase {}
 /**
  * Live layer for {@link ConfigInspector}.
  *
- * Requires {@link ChangesetConfigReader} and {@link WorkspaceDiscovery}
+ * Requires {@link ChangesetConfigReader} and `WorkspaceDiscovery`
  * in the environment.
  *
  * @public
@@ -7402,6 +7453,118 @@ declare const ChangelogServiceBase: Context.TagClass<ChangelogService, "Changelo
  * @public
  */
 declare class ChangelogService extends ChangelogServiceBase {} //#endregion
+//#region src/changesets/schemas/release-plan.d.ts
+/** A semantic-version bump level (the `"none"` plan type is filtered out upstream). @public */
+declare const BumpTypeSchema: Schema.Literal<["major", "minor", "patch"]>;
+/** A semantic-version bump level. @public */
+type BumpType = Schema.Schema.Type<typeof BumpTypeSchema>;
+/** One package's previewed release: version transition + rendered changelog block. @public */
+declare const PreviewReleaseSchema: Schema.Struct<{
+  name: typeof Schema.String;
+  type: Schema.Literal<["major", "minor", "patch"]>;
+  oldVersion: typeof Schema.String;
+  newVersion: typeof Schema.String;
+  changesetIds: Schema.Array$<typeof Schema.String>;
+  changelogEntry: typeof Schema.String;
+}>;
+/** One package's previewed release. @public */
+type PreviewRelease = Schema.Schema.Type<typeof PreviewReleaseSchema>;
+/** A parsed pending changeset (id + summary + the packages it bumps). @public */
+declare const PendingChangesetSchema: Schema.Struct<{
+  id: typeof Schema.String;
+  summary: typeof Schema.String;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+  }>>;
+}>;
+/** A parsed pending changeset. @public */
+type PendingChangeset = Schema.Schema.Type<typeof PendingChangesetSchema>;
+/** Read-only preview of what the next release would produce. @public */
+declare const ChangesetPreviewSchema: Schema.Struct<{
+  preMode: Schema.NullOr<Schema.Literal<["exit", "pre"]>>;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+    oldVersion: typeof Schema.String;
+    newVersion: typeof Schema.String;
+    changesetIds: Schema.Array$<typeof Schema.String>;
+    changelogEntry: typeof Schema.String;
+  }>>;
+  changesets: Schema.Array$<Schema.Struct<{
+    id: typeof Schema.String;
+    summary: typeof Schema.String;
+    releases: Schema.Array$<Schema.Struct<{
+      name: typeof Schema.String;
+      type: Schema.Literal<["major", "minor", "patch"]>;
+    }>>;
+  }>>;
+}>;
+/** Read-only preview of what the next release would produce. @public */
+type ChangesetPreview = Schema.Schema.Type<typeof ChangesetPreviewSchema>;
+/** One applied package release (version transition). @public */
+declare const AppliedReleaseEntrySchema: Schema.Struct<{
+  name: typeof Schema.String;
+  type: Schema.Literal<["major", "minor", "patch"]>;
+  oldVersion: typeof Schema.String;
+  newVersion: typeof Schema.String;
+}>;
+/** A single versionFiles update applied (or planned, when dry). @public */
+declare const VersionFileUpdateRecordSchema: Schema.Struct<{
+  filePath: typeof Schema.String;
+  version: typeof Schema.String;
+}>;
+/** Result of {@link ReleasePlanner.apply}. @public */
+declare const AppliedReleaseSchema: Schema.Struct<{
+  dryRun: typeof Schema.Boolean;
+  touchedFiles: Schema.Array$<typeof Schema.String>;
+  releases: Schema.Array$<Schema.Struct<{
+    name: typeof Schema.String;
+    type: Schema.Literal<["major", "minor", "patch"]>;
+    oldVersion: typeof Schema.String;
+    newVersion: typeof Schema.String;
+  }>>;
+  versionFileUpdates: Schema.Array$<Schema.Struct<{
+    filePath: typeof Schema.String;
+    version: typeof Schema.String;
+  }>>;
+}>;
+/** Result of a native apply. @public */
+type AppliedRelease = Schema.Schema.Type<typeof AppliedReleaseSchema>; //#endregion
+//#region src/changesets/services/release-planner.d.ts
+/** The `ReleasePlanner` service surface. @public */
+interface ReleasePlannerShape {
+  /** Compute the in-memory release plan (read-only). */
+  readonly plan: (root: string) => Effect.Effect<ReleasePlan, ReleasePlanError>;
+  /** Render a non-destructive preview of the next release. */
+  readonly preview: (root: string) => Effect.Effect<ChangesetPreview, ReleasePlanError>;
+  /** Natively apply the release (destructive unless `dryRun`). */
+  readonly apply: (root: string, options?: {
+    readonly dryRun?: boolean;
+  }) => Effect.Effect<AppliedRelease, ReleasePlanError>;
+}
+/**
+ * Base class for {@link ReleasePlanner}.
+ *
+ * @privateRemarks Required export for api-extractor (anonymous Context.Tag base). Do not delete.
+ * @internal
+ */
+declare const ReleasePlannerBase: Context.TagClass<ReleasePlanner, "ReleasePlanner", ReleasePlannerShape>;
+/** Effect service tag for the release planner. @public */
+declare class ReleasePlanner extends ReleasePlannerBase {}
+/** Production layer. Requires {@link ConfigInspector} (used by `apply`). @public */
+declare const ReleasePlannerLive: Layer.Layer<ReleasePlanner, never, ConfigInspector>;
+/**
+ * Test factory — supply fixed results for any subset of methods. Unsupplied
+ * methods fail with a `ReleasePlanError`.
+ *
+ * @public
+ */
+declare function makeReleasePlannerTest(fixed: {
+  readonly plan?: ReleasePlan;
+  readonly preview?: ChangesetPreview;
+  readonly apply?: AppliedRelease;
+}): Layer.Layer<ReleasePlanner>; //#endregion
 //#region src/changesets/services/workspace-snapshot.d.ts
 /**
  * One workspace package as it existed at a specific git ref.
@@ -8150,7 +8313,7 @@ declare function serializeDependencyTableToMarkdown(rows: DependencyTableRow[]):
  * Compute the set of currently-publishable workspace package names.
  *
  * @remarks
- * Uses the currently-active {@link PublishabilityDetector} — wire the
+ * Uses the currently-active {@link SilkPublishability} — wire the
  * {@link SilkPublishabilityDetectorLive} layer to get silk semantics.
  *
  * @param packages - The workspace packages to evaluate
@@ -9036,7 +9199,7 @@ declare const RequiredSectionsRule$2: Plugin<Root, unknown>; //#endregion
 //#region src/changesets/remark/rules/uncategorized-content.d.ts
 declare const UncategorizedContentRule$2: Plugin<Root, unknown>;
 declare namespace index_d_exports {
-  export { AggregateDependencyTablesPlugin, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule$2 as HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PositiveInteger, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
+  export { AggregateDependencyTablesPlugin, AppliedRelease, AppliedReleaseEntrySchema, AppliedReleaseSchema, BranchAnalysis, BranchAnalysisSchema, BranchAnalyzer, BranchAnalyzerBase, BranchAnalyzerLive, BranchAnalyzerShape, BranchFileEntry, BranchFileEntrySchema, BumpType, BumpTypeSchema, Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangelogServiceShape, ChangelogTransformer, Changeset, ChangesetLinter, ChangesetOptions, ChangesetOptionsSchema, ChangesetPreview, ChangesetPreviewSchema, ChangesetSchema, ChangesetSummarySchema, ChangesetValidationError, ChangesetValidationErrorBase, Classification, ClassificationReason, ClassificationReasonSchema, ClassificationSchema, CommitHashSchema, ConfigInspector, ConfigInspectorBase, ConfigInspectorLive, ConfigInspectorShape, ConfigurationError, ConfigurationErrorBase, ContentStructureRule$2 as ContentStructureRule, ContributorFootnotesPlugin, DeduplicateItemsPlugin, DependencyAction, DependencyActionSchema, DependencyTable, DependencyTableFormatRule$2 as DependencyTableFormatRule, DependencyTableRow, DependencyTableRowSchema, DependencyTableSchema, DependencyTableType, DependencyTableTypeSchema, DependencyType, DependencyTypeSchema, DependencyUpdate, DependencyUpdateSchema, FileStatus, FileStatusSchema, GitError, GitErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubCommitInfo, GitHubInfo, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, GitHubServiceShape, GlobSchema, HeadingHierarchyRule$2 as HeadingHierarchyRule, InspectedConfig, InspectedConfigSchema, IssueLinkRefsPlugin, IssueNumberSchema, JsonPathSchema, LegacyVersionFileConfig, LegacyVersionFileConfigSchema, LegacyVersionFilesSchema, LintMessage, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, MarkdownServiceShape, ContentStructureRule$1 as MarkdownlintContentStructureRule, DependencyTableFormatRule$1 as MarkdownlintDependencyTableFormatRule, HeadingHierarchyRule$1 as MarkdownlintHeadingHierarchyRule, RequiredSectionsRule$1 as MarkdownlintRequiredSectionsRule, UncategorizedContentRule$1 as MarkdownlintUncategorizedContentRule, MergeSectionsPlugin, NonEmptyString, NormalizeFormatPlugin, PackageScope, PackageScopeSchema, PackagesRecordSchema, PendingChangeset, PendingChangesetSchema, PositiveInteger, PreviewRelease, PreviewReleaseSchema, ReleasePlanError, ReleasePlanErrorBase, ReleasePlanner, ReleasePlannerBase, ReleasePlannerLive, ReleasePlannerShape, ReorderSectionsPlugin, RepoSchema, RequiredSectionsRule$2 as RequiredSectionsRule, ResolvedPackageScope, ResolvedPackageScopeSchema, ResolvedVersionFile, ResolvedVersionFileSchema, SectionCategory, SectionCategorySchema, SilkChangesetPreset, SilkChangesetTransformPreset, SilkChangesetsRules$1 as SilkChangesetsRules, UncategorizedContentRule$2 as UncategorizedContentRule, UrlOrMarkdownLinkSchema, UsernameSchema, VersionFileConfig, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFileUpdate, VersionFileUpdateRecordSchema, VersionFiles, VersionFilesSchema, VersionOrEmptySchema, VersionType, VersionTypeSchema, WorkspaceDependencyDiff, WorkspaceSnapshot, WorkspaceSnapshotReader, WorkspaceSnapshotReaderBase, WorkspaceSnapshotReaderLive, WorkspaceSnapshotReaderShape, WorkspaceVersion, changelogFunctions, computeWorkspaceDependencyDiffs, gitMergeBase, listPublishablePackageNames, makeBranchAnalyzerTest, makeConfigInspectorTest, makeGitHubTest, makeReleasePlannerTest, serializeDependencyTableToMarkdown, snapshotFromWorktree };
 } //#endregion
 //#region src/commitlint/config/schema.d.ts
 /**