@savvy-web/changesets 0.1.0 → 0.1.1

package/esm/index.d.ts

@@ -0,0 +1,795 @@
+/**
+ * \@savvy-web/changesets
+ *
+ * Custom changelog formatter and markdown processing pipeline for the Silk Suite.
+ * Provides structured changeset sections, remark-based validation and transformation,
+ * and an Effect CLI.
+ *
+ * This module exposes two API surfaces:
+ * - **Effect primitives**: Services, layers, schemas, and tagged errors for Effect-native consumers
+ * - **Class-based API**: Static class wrappers for higher-level consumers
+ *
+ * @packageDocumentation
+ */
+
+import { Context } from 'effect';
+import { Effect } from 'effect';
+import { Equals } from 'effect/Types';
+import { Layer } from 'effect';
+import { ModCompWithPackage } from '@changesets/types';
+import { NewChangesetWithCommit } from '@changesets/types';
+import type { Root } from 'mdast';
+import { Schema } from 'effect';
+import { VersionType as VersionType_2 } from '@changesets/types';
+import { YieldableError } from 'effect/Cause';
+
+/**
+ * Static class wrapper for category operations.
+ *
+ * Provides methods for resolving conventional commit types to changelog
+ * section categories and validating section headings.
+ *
+ * @example
+ * ```typescript
+ * import { Categories } from "\@savvy-web/changesets";
+ * import type { SectionCategory } from "\@savvy-web/changesets";
+ *
+ * const cat: SectionCategory = Categories.fromCommitType("feat");
+ * console.log(cat.heading); // "Features"
+ * console.log(cat.priority); // 2
+ *
+ * const isValid: boolean = Categories.isValidHeading("Bug Fixes");
+ * console.log(isValid); // true
+ * ```
+ *
+ * @see {@link SectionCategory} for the category shape
+ *
+ * @public
+ */
+export declare class Categories {
+    private constructor();
+    /** Breaking changes - backward-incompatible changes (priority 1) */
+    static readonly BREAKING_CHANGES: SectionCategory;
+    /** Features - new functionality (priority 2) */
+    static readonly FEATURES: SectionCategory;
+    /** Bug Fixes - bug corrections (priority 3) */
+    static readonly BUG_FIXES: SectionCategory;
+    /** Performance - performance improvements (priority 4) */
+    static readonly PERFORMANCE: SectionCategory;
+    /** Documentation - documentation changes (priority 5) */
+    static readonly DOCUMENTATION: SectionCategory;
+    /** Refactoring - code restructuring (priority 6) */
+    static readonly REFACTORING: SectionCategory;
+    /** Tests - test additions or modifications (priority 7) */
+    static readonly TESTS: SectionCategory;
+    /** Build System - build configuration changes (priority 8) */
+    static readonly BUILD_SYSTEM: SectionCategory;
+    /** CI - continuous integration changes (priority 9) */
+    static readonly CI: SectionCategory;
+    /** Dependencies - dependency updates (priority 10) */
+    static readonly DEPENDENCIES: SectionCategory;
+    /** Maintenance - general maintenance (priority 11) */
+    static readonly MAINTENANCE: SectionCategory;
+    /** Reverts - reverted changes (priority 12) */
+    static readonly REVERTS: SectionCategory;
+    /** Other - uncategorized changes (priority 13) */
+    static readonly OTHER: SectionCategory;
+    /** All categories ordered by priority (ascending). */
+    static readonly ALL: readonly SectionCategory[];
+    /**
+     * Resolve a conventional commit type to its category.
+     *
+     * @remarks
+     * The breaking flag takes highest precedence, always returning the
+     * "Breaking Changes" category. The special scope `chore(deps)` maps
+     * to "Dependencies" rather than "Maintenance". Unknown types fall
+     * back to "Other".
+     *
+     * @param type - The commit type (e.g., "feat", "fix", "chore")
+     * @param scope - Optional scope (e.g., "deps" in `chore(deps):`)
+     * @param breaking - Whether the commit has a `!` suffix
+     * @returns The resolved section category
+     */
+    static fromCommitType(type: string, scope?: string, breaking?: boolean): SectionCategory;
+    /**
+     * Look up a category by its section heading text.
+     * Comparison is case-insensitive.
+     *
+     * @param heading - The heading text (e.g., "Features", "Bug Fixes")
+     * @returns The matching category, or `undefined` if not recognized
+     */
+    static fromHeading(heading: string): SectionCategory | undefined;
+    /**
+     * Get all valid section heading strings.
+     *
+     * @returns Array of heading strings in priority order
+     */
+    static allHeadings(): readonly string[];
+    /**
+     * Check whether a heading string matches a known category.
+     * Comparison is case-insensitive.
+     *
+     * @param heading - The heading text to check
+     * @returns `true` if the heading matches a known category
+     */
+    static isValidHeading(heading: string): boolean;
+}
+
+/**
+ * Static class wrapper for changelog operations.
+ *
+ * Delegates to the Changesets-compatible `getReleaseLine` and
+ * `getDependencyReleaseLine` functions with Effect-based internals.
+ *
+ * @example
+ * ```typescript
+ * import { Changelog } from "\@savvy-web/changesets";
+ *
+ * const changeset = {
+ *   id: "brave-pandas-learn",
+ *   summary: "feat: add authentication system",
+ *   releases: [{ name: "\@savvy-web/auth", type: "minor" as const }],
+ *   commit: "abc1234567890",
+ * };
+ *
+ * const line = await Changelog.formatReleaseLine(changeset, "minor", {
+ *   repo: "savvy-web/auth",
+ * });
+ * ```
+ *
+ * @see {@link Categories} for resolving commit types to section categories
+ *
+ * @public
+ */
+export declare class Changelog {
+    private constructor();
+    /**
+     * Format a single changeset into a changelog release line.
+     *
+     * @param changeset - The changeset to format
+     * @param versionType - The semantic version bump type
+     * @param options - Configuration with `repo` in `owner/repo` format
+     * @returns Formatted markdown string
+     */
+    static formatReleaseLine(changeset: NewChangesetWithCommit, versionType: VersionType_2, options: Record<string, unknown> | null): Promise<string>;
+    /**
+     * Format dependency update release lines.
+     *
+     * @param changesets - Changesets that caused dependency updates
+     * @param dependenciesUpdated - Dependencies that were updated
+     * @param options - Configuration with `repo` in `owner/repo` format
+     * @returns Formatted markdown string
+     */
+    static formatDependencyReleaseLine(changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], options: Record<string, unknown> | null): Promise<string>;
+}
+
+/**
+ * Service for changelog formatting.
+ *
+ * @remarks
+ * This service tag defines the interface. Use the Changesets API entry point
+ * (`\@savvy-web/changesets/changelog`) or the {@link Changelog} class for
+ * the concrete implementation.
+ *
+ * @public
+ */
+export declare class ChangelogService extends ChangelogServiceBase {
+}
+
+/**
+ * Base class for ChangelogService.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Context.Tag creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const ChangelogServiceBase: Context.TagClass<ChangelogService, "ChangelogService", ChangelogServiceShape>;
+
+/**
+ * Service interface for changelog formatting.
+ *
+ * @internal
+ */
+export declare interface ChangelogServiceShape {
+    /** Format a single changeset release line. */
+    readonly formatReleaseLine: (changeset: NewChangesetWithCommit, versionType: VersionType_2, options: ChangesetOptions) => Effect.Effect<string, never, GitHubService | MarkdownService>;
+    /** Format dependency update release lines. */
+    readonly formatDependencyReleaseLine: (changesets: NewChangesetWithCommit[], dependenciesUpdated: ModCompWithPackage[], options: ChangesetOptions) => Effect.Effect<string, never, GitHubService>;
+}
+
+/**
+ * Class-based API wrapper for changelog transformation.
+ *
+ * Provides a static class interface that runs all remark transform
+ * plugins against CHANGELOG markdown content.
+ */
+/**
+ * Static class for transforming CHANGELOG.md files.
+ *
+ * Runs all six remark transform plugins in the correct order:
+ * merge-sections, reorder-sections, deduplicate-items,
+ * contributor-footnotes, issue-link-refs, normalize-format.
+ *
+ * @example
+ * ```typescript
+ * import { ChangelogTransformer } from "\@savvy-web/changesets";
+ *
+ * // Transform a string
+ * const cleaned = ChangelogTransformer.transformContent(rawMarkdown);
+ *
+ * // Transform a file in-place
+ * ChangelogTransformer.transformFile("CHANGELOG.md");
+ * ```
+ *
+ * @public
+ */
+export declare class ChangelogTransformer {
+    private constructor();
+    /**
+     * Transform CHANGELOG markdown content by running all transform plugins.
+     *
+     * @param content - Raw CHANGELOG markdown string
+     * @returns The transformed markdown string
+     */
+    static transformContent(content: string): string;
+    /**
+     * Transform a CHANGELOG file in-place.
+     *
+     * Reads the file, runs all transform plugins, and writes the result back.
+     *
+     * @param filePath - Path to the CHANGELOG.md file
+     */
+    static transformFile(filePath: string): void;
+}
+
+/**
+ * Inferred type for {@link ChangesetSchema}.
+ *
+ * @public
+ */
+export declare interface Changeset extends Schema.Schema.Type<typeof ChangesetSchema> {
+}
+
+/**
+ * Static class for linting changeset files.
+ *
+ * Runs the three remark-lint rules (heading-hierarchy, required-sections,
+ * content-structure) against changeset markdown and returns structured
+ * diagnostic messages.
+ *
+ * @example
+ * ```typescript
+ * import { ChangesetLinter } from "\@savvy-web/changesets";
+ * import type { LintMessage } from "\@savvy-web/changesets";
+ *
+ * const messages: LintMessage[] = ChangesetLinter.validateFile("path/to/changeset.md");
+ * for (const msg of messages) {
+ *   console.log(`${msg.file}:${msg.line}:${msg.column} ${msg.rule} ${msg.message}`);
+ * }
+ * ```
+ *
+ * @public
+ */
+export declare class ChangesetLinter {
+    private constructor();
+    /**
+     * Validate a single changeset file.
+     *
+     * Reads the file, strips YAML frontmatter, and runs all lint rules.
+     *
+     * @param filePath - Path to the changeset `.md` file
+     * @returns Array of lint messages (empty if valid)
+     */
+    static validateFile(filePath: string): LintMessage[];
+    /**
+     * Validate a markdown string directly.
+     *
+     * Strips YAML frontmatter and runs all lint rules.
+     *
+     * @param content - Raw markdown content (may include frontmatter)
+     * @param filePath - File path for error reporting (defaults to `"<input>"`)
+     * @returns Array of lint messages (empty if valid)
+     */
+    static validateContent(content: string, filePath?: string): LintMessage[];
+    /**
+     * Validate all changeset `.md` files in a directory.
+     *
+     * Scans for `*.md` files (excluding `README.md`) and runs
+     * {@link ChangesetLinter.validateFile} on each.
+     *
+     * @param dir - Directory path to scan
+     * @returns Aggregated lint messages from all files
+     */
+    static validate(dir: string): LintMessage[];
+}
+
+/**
+ * Inferred type for {@link ChangesetOptionsSchema}.
+ *
+ * @public
+ */
+export declare interface ChangesetOptions extends Schema.Schema.Type<typeof ChangesetOptionsSchema> {
+}
+
+/**
+ * Schema for changeset configuration options.
+ *
+ * @public
+ */
+export declare const ChangesetOptionsSchema: Schema.Struct<{
+    /** GitHub repository in `owner/repo` format. */
+    repo: Schema.filter<typeof Schema.String>;
+    /** Whether to include commit hash links in output. */
+    commitLinks: Schema.optional<typeof Schema.Boolean>;
+    /** Whether to include pull request links in output. */
+    prLinks: Schema.optional<typeof Schema.Boolean>;
+    /** Whether to include issue reference links in output. */
+    issueLinks: Schema.optional<typeof Schema.Boolean>;
+    /** Custom issue reference prefixes (e.g., `["#", "GH-"]`). */
+    issuePrefixes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+}>;
+
+/**
+ * Schema for a changeset object.
+ *
+ * @public
+ */
+export declare const ChangesetSchema: Schema.Struct<{
+    /** The changeset summary text. */
+    summary: Schema.filter<Schema.filter<typeof Schema.String>>;
+    /** Unique changeset identifier. */
+    id: typeof Schema.String;
+    /** Git commit hash associated with this changeset. */
+    commit: Schema.optional<Schema.filter<typeof Schema.String>>;
+}>;
+
+/**
+ * Schema for a changeset summary (1-1000 characters).
+ *
+ * @public
+ */
+export declare const ChangesetSummarySchema: Schema.filter<Schema.filter<typeof Schema.String>>;
+
+/**
+ * Changeset file validation failure.
+ *
+ * Carries structured issue details with JSON-path and message per issue.
+ *
+ * @public
+ */
+export declare class ChangesetValidationError extends ChangesetValidationErrorBase<{
+    /** File path of the changeset that failed validation. */
+    readonly file?: string | undefined;
+    /** Individual validation issues found. */
+    readonly issues: ReadonlyArray<{
+        /** JSON-path to the problematic field. */
+        readonly path: string;
+        /** Human-readable description of the issue. */
+        readonly message: string;
+    }>;
+}> {
+    get message(): string;
+}
+
+/**
+ * Base class for ChangesetValidationError.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const ChangesetValidationErrorBase: new <A extends Record<string, any> = {}>(args: Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => YieldableError & {
+    readonly _tag: "ChangesetValidationError";
+} & Readonly<A>;
+
+/**
+ * Schema for a git commit hash (at least 7 lowercase hex characters).
+ *
+ * @public
+ */
+export declare const CommitHashSchema: Schema.filter<typeof Schema.String>;
+
+/**
+ * Invalid or missing configuration.
+ *
+ * @see {@link ChangesetOptionsSchema} for the expected configuration shape
+ *
+ * @public
+ */
+export declare class ConfigurationError extends ConfigurationErrorBase<{
+    /** Configuration field that is invalid or missing. */
+    readonly field: string;
+    /** Human-readable failure reason. */
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+
+/**
+ * Base class for ConfigurationError.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const ConfigurationErrorBase: new <A extends Record<string, any> = {}>(args: Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => YieldableError & {
+    readonly _tag: "ConfigurationError";
+} & Readonly<A>;
+
+/**
+ * Inferred type for {@link DependencyTypeSchema}.
+ *
+ * @public
+ */
+export declare type DependencyType = typeof DependencyTypeSchema.Type;
+
+/**
+ * Schema for npm dependency types.
+ *
+ * @public
+ */
+export declare const DependencyTypeSchema: Schema.Literal<["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]>;
+
+/**
+ * Inferred type for {@link DependencyUpdateSchema}.
+ *
+ * @public
+ */
+export declare interface DependencyUpdate extends Schema.Schema.Type<typeof DependencyUpdateSchema> {
+}
+
+/**
+ * Schema for a dependency update entry.
+ *
+ * @public
+ */
+export declare const DependencyUpdateSchema: Schema.Struct<{
+    /** Package name (must be non-empty). */
+    name: Schema.refine<string, typeof Schema.String>;
+    /** npm dependency type. */
+    type: Schema.Literal<["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]>;
+    /** Previous version string. */
+    oldVersion: typeof Schema.String;
+    /** New version string. */
+    newVersion: typeof Schema.String;
+}>;
+
+/**
+ * GitHub API request failure.
+ *
+ * @remarks
+ * Use {@link GitHubApiError.isRetryable} to determine whether a retry
+ * strategy should be applied. Rate-limited responses (403/429) and
+ * server errors (5xx) are considered retryable.
+ *
+ * @public
+ */
+export declare class GitHubApiError extends GitHubApiErrorBase<{
+    /** The API operation that failed (e.g., "getInfo"). */
+    readonly operation: string;
+    /** HTTP status code, if available. */
+    readonly statusCode?: number | undefined;
+    /** Human-readable failure reason. */
+    readonly reason: string;
+}> {
+    get message(): string;
+    /** Whether this error is a rate-limit response (403 or 429). */
+    get isRateLimited(): boolean;
+    /** Whether this error is eligible for retry (server errors or rate limits). */
+    get isRetryable(): boolean;
+}
+
+/**
+ * Base class for GitHubApiError.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const GitHubApiErrorBase: new <A extends Record<string, any> = {}>(args: Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => YieldableError & {
+    readonly _tag: "GitHubApiError";
+} & Readonly<A>;
+
+/**
+ * Structured result from the GitHub commit info API.
+ *
+ * @public
+ */
+export declare interface GitHubCommitInfo {
+    /** The GitHub username of the commit author (null if unknown). */
+    user: string | null;
+    /** The pull request number associated with this commit (null if none). */
+    pull: number | null;
+    /** Markdown-formatted links for the commit, PR, and user. */
+    links: {
+        /** Link to the commit on GitHub. */
+        commit: string;
+        /** Link to the associated pull request (null if none). */
+        pull: string | null;
+        /** Link to the author's GitHub profile (null if unknown). */
+        user: string | null;
+    };
+}
+
+/**
+ * Inferred type for {@link GitHubInfoSchema}.
+ *
+ * @public
+ */
+export declare interface GitHubInfo extends Schema.Schema.Type<typeof GitHubInfoSchema> {
+}
+
+/**
+ * Schema for a GitHub info response from \@changesets/get-github-info.
+ *
+ * @public
+ */
+export declare const GitHubInfoSchema: Schema.Struct<{
+    /** GitHub username of the commit author. */
+    user: Schema.optional<Schema.filter<typeof Schema.String>>;
+    /** Pull request number associated with the commit. */
+    pull: Schema.optional<Schema.refine<number, Schema.filter<typeof Schema.Number>>>;
+    /** Markdown-formatted links. */
+    links: Schema.Struct<{
+        /** Link to the commit. */
+        commit: Schema.filter<typeof Schema.String>;
+        /** Link to the associated pull request. */
+        pull: Schema.optional<Schema.filter<typeof Schema.String>>;
+        /** Link to the author's GitHub profile. */
+        user: Schema.optional<Schema.filter<typeof Schema.String>>;
+    }>;
+}>;
+
+/**
+ * Live layer that delegates to \@changesets/get-github-info.
+ *
+ * @public
+ */
+export declare const GitHubLive: Layer.Layer<GitHubService, never, never>;
+
+/**
+ * Service for GitHub API operations.
+ *
+ * @see {@link GitHubLive} for the production layer
+ * @see {@link makeGitHubTest} for creating test layers
+ *
+ * @public
+ */
+export declare class GitHubService extends GitHubServiceBase {
+}
+
+/**
+ * Base class for GitHubService.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Context.Tag creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const GitHubServiceBase: Context.TagClass<GitHubService, "GitHubService", GitHubServiceShape>;
+
+/**
+ * Service interface for GitHub API operations.
+ *
+ * @internal
+ */
+export declare interface GitHubServiceShape {
+    /** Fetch commit info (author, PR, links) for a given commit. */
+    readonly getInfo: (params: {
+        commit: string;
+        repo: string;
+    }) => Effect.Effect<GitHubCommitInfo, GitHubApiError>;
+}
+
+/**
+ * Schema for a GitHub issue or PR number (positive integer).
+ *
+ * @public
+ */
+export declare const IssueNumberSchema: Schema.refine<number, Schema.filter<typeof Schema.Number>>;
+
+/**
+ * Class-based API wrapper for changeset linting.
+ *
+ * Provides a static class interface that runs all remark-lint rules
+ * against changeset markdown files.
+ */
+/**
+ * A single lint message from validation.
+ *
+ * @public
+ */
+export declare interface LintMessage {
+    /** File path that was validated. */
+    file: string;
+    /** Rule name that produced the message. */
+    rule: string;
+    /** Line number (1-based). */
+    line: number;
+    /** Column number (1-based). */
+    column: number;
+    /** Human-readable message. */
+    message: string;
+}
+
+/**
+ * Create a test layer with pre-configured responses keyed by commit hash.
+ *
+ * @param responses - A map of commit hash to {@link GitHubCommitInfo}
+ * @returns A Layer providing the {@link GitHubService}
+ *
+ * @public
+ */
+export declare function makeGitHubTest(responses: Map<string, GitHubCommitInfo>): Layer.Layer<GitHubService>;
+
+/**
+ * Live layer wrapping the remark-pipeline functions.
+ *
+ * @public
+ */
+export declare const MarkdownLive: Layer.Layer<MarkdownService, never, never>;
+
+/**
+ * Markdown parsing failure.
+ *
+ * @public
+ */
+export declare class MarkdownParseError extends MarkdownParseErrorBase<{
+    /** Source file path, if known. */
+    readonly source?: string | undefined;
+    /** Human-readable failure reason. */
+    readonly reason: string;
+    /** Line number where the error occurred (1-based). */
+    readonly line?: number | undefined;
+    /** Column number where the error occurred (1-based). */
+    readonly column?: number | undefined;
+}> {
+    get message(): string;
+}
+
+/**
+ * Base class for MarkdownParseError.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const MarkdownParseErrorBase: new <A extends Record<string, any> = {}>(args: Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => YieldableError & {
+    readonly _tag: "MarkdownParseError";
+} & Readonly<A>;
+
+/**
+ * Service for markdown parsing and stringification.
+ *
+ * @see {@link MarkdownLive} for the production layer
+ *
+ * @public
+ */
+export declare class MarkdownService extends MarkdownServiceBase {
+}
+
+/**
+ * Base class for MarkdownService.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Context.Tag creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const MarkdownServiceBase: Context.TagClass<MarkdownService, "MarkdownService", MarkdownServiceShape>;
+
+/**
+ * Service interface for markdown parsing and stringification.
+ *
+ * @internal
+ */
+export declare interface MarkdownServiceShape {
+    /** Parse a markdown string into an mdast AST. */
+    readonly parse: (content: string) => Effect.Effect<Root>;
+    /** Stringify an mdast AST back to markdown. */
+    readonly stringify: (tree: Root) => Effect.Effect<string>;
+}
+
+/**
+ * A non-empty string schema.
+ *
+ * @public
+ */
+export declare const NonEmptyString: Schema.filter<typeof Schema.String>;
+
+/**
+ * A positive integer schema.
+ *
+ * @public
+ */
+export declare const PositiveInteger: Schema.filter<Schema.filter<typeof Schema.Number>>;
+
+/**
+ * Schema for a GitHub repository in `owner/repo` format.
+ *
+ * @public
+ */
+export declare const RepoSchema: Schema.filter<typeof Schema.String>;
+
+/**
+ * A section category defines how changes are grouped in release notes.
+ * Used across all three processing layers.
+ *
+ * Inferred from {@link SectionCategorySchema}.
+ *
+ * @public
+ */
+export declare interface SectionCategory extends Schema.Schema.Type<typeof SectionCategorySchema> {
+}
+
+/**
+ * Schema for a section category that defines how changes are grouped in release notes.
+ * Used across all three processing layers.
+ *
+ * Provides runtime validation and type inference via Effect Schema.
+ *
+ * @public
+ */
+export declare const SectionCategorySchema: Schema.Struct<{
+    /** Display heading used in CHANGELOG output. */
+    heading: typeof Schema.String;
+    /** Priority for ordering (lower = higher priority). */
+    priority: typeof Schema.Number;
+    /** Conventional commit types that map to this category. */
+    commitTypes: Schema.Array$<typeof Schema.String>;
+    /** Brief description for documentation. */
+    description: typeof Schema.String;
+}>;
+
+/**
+ * Schema accepting either a plain URL or a markdown link `[text](url)`.
+ *
+ * Used for GitHub API responses from \@changesets/get-github-info.
+ *
+ * @public
+ */
+export declare const UrlOrMarkdownLinkSchema: Schema.filter<typeof Schema.String>;
+
+/**
+ * Schema for a GitHub username.
+ *
+ * Rules: alphanumeric and hyphens, cannot start/end with hyphen.
+ *
+ * @public
+ */
+export declare const UsernameSchema: Schema.filter<typeof Schema.String>;
+
+/**
+ * Inferred type for {@link VersionTypeSchema}.
+ *
+ * @public
+ */
+export declare type VersionType = typeof VersionTypeSchema.Type;
+
+/**
+ * Semantic version bump type.
+ *
+ * @public
+ */
+export declare const VersionTypeSchema: Schema.Literal<["major", "minor", "patch", "none"]>;
+
+export { }