pubm 0.0.5 → 0.1.2

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-type RegistryType = 'npm' | 'jsr' | string;
+type RegistryType = "npm" | "jsr" | "crates" | string;
 /**
  * Options for configuring the {@linkcode pubm} function.
  */
@@ -88,6 +88,184 @@ interface Options {
     registries?: RegistryType[];
 }
 
+type BumpType = "patch" | "minor" | "major";
+interface Release {
+    name: string;
+    type: BumpType;
+}
+interface Changeset {
+    id: string;
+    summary: string;
+    releases: Release[];
+}
+declare function parseChangeset(content: string, fileName: string): Changeset;
+
+interface ChangelogEntry {
+    summary: string;
+    type: BumpType;
+    id: string;
+}
+interface DependencyUpdate {
+    name: string;
+    version: string;
+}
+declare function generateChangelog(version: string, entries: ChangelogEntry[], depUpdates?: DependencyUpdate[]): string;
+
+interface MigrationResult {
+    success: boolean;
+    error?: string;
+    migratedFiles: string[];
+    configMigrated: boolean;
+}
+declare function migrateFromChangesets(cwd?: string): MigrationResult;
+
+declare function readChangesets(cwd?: string): Changeset[];
+
+interface PackageStatus {
+    bumpType: BumpType;
+    changesetCount: number;
+    summaries: string[];
+}
+interface Status {
+    packages: Map<string, PackageStatus>;
+    changesets: Changeset[];
+    hasChangesets: boolean;
+}
+declare function getStatus(cwd?: string): Status;
+
+interface VersionBump {
+    currentVersion: string;
+    newVersion: string;
+    bumpType: BumpType;
+}
+declare function calculateVersionBumps(currentVersions: Map<string, string>, cwd?: string): Map<string, VersionBump>;
+
+declare function generateChangesetId(): string;
+declare function generateChangesetContent(releases: Release[], summary: string): string;
+declare function writeChangeset(releases: Release[], summary: string, cwd?: string): string;
+
+interface PackageConfig {
+    path: string;
+    registries: RegistryType[];
+    buildCommand?: string;
+    testCommand?: string;
+}
+interface ValidateConfig {
+    cleanInstall?: boolean;
+    entryPoints?: boolean;
+    extraneousFiles?: boolean;
+}
+interface SnapshotConfig {
+    useCalculatedVersion?: boolean;
+    prereleaseTemplate?: string;
+}
+interface PubmConfig {
+    versioning?: "independent" | "fixed";
+    branch?: string;
+    registries?: RegistryType[];
+    packages?: PackageConfig[];
+    changelog?: boolean | string;
+    changelogFormat?: "default" | "github" | string;
+    commit?: boolean;
+    access?: "public" | "restricted";
+    fixed?: string[][];
+    linked?: string[][];
+    updateInternalDependencies?: "patch" | "minor";
+    ignore?: string[];
+    validate?: ValidateConfig;
+    snapshot?: SnapshotConfig;
+    tag?: string;
+    contents?: string;
+    saveToken?: boolean;
+    releaseDraft?: boolean;
+    releaseNotes?: boolean;
+    rollbackStrategy?: "individual" | "all";
+}
+interface ResolvedPubmConfig extends Required<Omit<PubmConfig, "packages" | "validate" | "snapshot">> {
+    packages: PackageConfig[];
+    validate: Required<ValidateConfig>;
+    snapshot: Required<SnapshotConfig>;
+}
+declare function defineConfig(config: PubmConfig): PubmConfig;
+
+declare function resolveConfig(config: PubmConfig): ResolvedPubmConfig;
+
+declare function loadConfig(cwd?: string): Promise<PubmConfig | null>;
+
+interface PackageNode {
+    name: string;
+    version: string;
+    path: string;
+    dependencies: Record<string, string>;
+}
+/**
+ * Builds an adjacency list of internal dependencies only.
+ * Each key is a package name, and the value is an array of internal package names it depends on.
+ */
+declare function buildDependencyGraph(packages: PackageNode[]): Map<string, string[]>;
+/**
+ * Topological sort using Kahn's algorithm.
+ * Returns packages in dependency order (dependencies first).
+ * Throws an error if circular dependencies are detected.
+ */
+declare function topologicalSort(graph: Map<string, string[]>): string[];
+
+/**
+ * Resolves glob patterns in groups to actual package names.
+ * Exact names are passed through; glob patterns are matched against allPackages.
+ */
+declare function resolveGroups(groups: string[][], allPackages: string[]): string[][];
+/**
+ * Fixed group: all packages in the group get the maximum bump type,
+ * even those without changesets. If no packages in the group have bumps,
+ * nothing is changed.
+ */
+declare function applyFixedGroup(bumps: Map<string, BumpType>, group: string[]): void;
+/**
+ * Linked group: only packages that already have bumps get aligned
+ * to the maximum bump type. Packages without bumps are not added.
+ */
+declare function applyLinkedGroup(bumps: Map<string, BumpType>, group: string[]): void;
+
+interface WorkspaceInfo {
+    type: "pnpm" | "npm" | "yarn";
+    patterns: string[];
+}
+declare function detectWorkspace(cwd?: string): WorkspaceInfo | null;
+
+interface PreState {
+    mode: "pre";
+    tag: string;
+    packages: Record<string, {
+        baseVersion: string;
+        iteration: number;
+    }>;
+}
+declare function readPreState(cwd?: string): PreState | null;
+declare function enterPreMode(tag: string, cwd?: string): void;
+declare function exitPreMode(cwd?: string): void;
+
+interface SnapshotOptions {
+    tag?: string;
+    baseVersion?: string;
+    useCalculatedVersion?: boolean;
+    template?: string;
+    commit?: string;
+}
+declare function generateSnapshotVersion(options: SnapshotOptions): string;
+
+interface EntryPointError {
+    field: string;
+    path: string;
+}
+declare function validateEntryPoints(pkg: Record<string, unknown>, cwd: string): EntryPointError[];
+
+interface ExtraneousFile {
+    file: string;
+    reason: string;
+}
+declare function detectExtraneousFiles(files: string[]): ExtraneousFile[];
+
 /**
  * Runs the `pubm` function with the provided options.
  *
@@ -100,4 +278,4 @@ interface Options {
  */
 declare function pubm(options: Options): Promise<void>;
 
-export { type Options, pubm };
+export { type BumpType, type ChangelogEntry, type Changeset, type DependencyUpdate, type EntryPointError, type ExtraneousFile, type MigrationResult, type Options, type PackageConfig, type PackageNode, type PackageStatus, type PreState, type PubmConfig, type Release, type ResolvedPubmConfig, type SnapshotOptions, type Status, type VersionBump, type WorkspaceInfo, applyFixedGroup, applyLinkedGroup, buildDependencyGraph, calculateVersionBumps, defineConfig, detectExtraneousFiles, detectWorkspace, enterPreMode, exitPreMode, generateChangelog, generateChangesetContent, generateChangesetId, generateSnapshotVersion, getStatus, loadConfig, migrateFromChangesets, parseChangeset, pubm, readChangesets, readPreState, resolveConfig, resolveGroups, topologicalSort, validateEntryPoints, writeChangeset };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-type RegistryType = 'npm' | 'jsr' | string;
+type RegistryType = "npm" | "jsr" | "crates" | string;
 /**
  * Options for configuring the {@linkcode pubm} function.
  */
@@ -88,6 +88,184 @@ interface Options {
     registries?: RegistryType[];
 }
 
+type BumpType = "patch" | "minor" | "major";
+interface Release {
+    name: string;
+    type: BumpType;
+}
+interface Changeset {
+    id: string;
+    summary: string;
+    releases: Release[];
+}
+declare function parseChangeset(content: string, fileName: string): Changeset;
+
+interface ChangelogEntry {
+    summary: string;
+    type: BumpType;
+    id: string;
+}
+interface DependencyUpdate {
+    name: string;
+    version: string;
+}
+declare function generateChangelog(version: string, entries: ChangelogEntry[], depUpdates?: DependencyUpdate[]): string;
+
+interface MigrationResult {
+    success: boolean;
+    error?: string;
+    migratedFiles: string[];
+    configMigrated: boolean;
+}
+declare function migrateFromChangesets(cwd?: string): MigrationResult;
+
+declare function readChangesets(cwd?: string): Changeset[];
+
+interface PackageStatus {
+    bumpType: BumpType;
+    changesetCount: number;
+    summaries: string[];
+}
+interface Status {
+    packages: Map<string, PackageStatus>;
+    changesets: Changeset[];
+    hasChangesets: boolean;
+}
+declare function getStatus(cwd?: string): Status;
+
+interface VersionBump {
+    currentVersion: string;
+    newVersion: string;
+    bumpType: BumpType;
+}
+declare function calculateVersionBumps(currentVersions: Map<string, string>, cwd?: string): Map<string, VersionBump>;
+
+declare function generateChangesetId(): string;
+declare function generateChangesetContent(releases: Release[], summary: string): string;
+declare function writeChangeset(releases: Release[], summary: string, cwd?: string): string;
+
+interface PackageConfig {
+    path: string;
+    registries: RegistryType[];
+    buildCommand?: string;
+    testCommand?: string;
+}
+interface ValidateConfig {
+    cleanInstall?: boolean;
+    entryPoints?: boolean;
+    extraneousFiles?: boolean;
+}
+interface SnapshotConfig {
+    useCalculatedVersion?: boolean;
+    prereleaseTemplate?: string;
+}
+interface PubmConfig {
+    versioning?: "independent" | "fixed";
+    branch?: string;
+    registries?: RegistryType[];
+    packages?: PackageConfig[];
+    changelog?: boolean | string;
+    changelogFormat?: "default" | "github" | string;
+    commit?: boolean;
+    access?: "public" | "restricted";
+    fixed?: string[][];
+    linked?: string[][];
+    updateInternalDependencies?: "patch" | "minor";
+    ignore?: string[];
+    validate?: ValidateConfig;
+    snapshot?: SnapshotConfig;
+    tag?: string;
+    contents?: string;
+    saveToken?: boolean;
+    releaseDraft?: boolean;
+    releaseNotes?: boolean;
+    rollbackStrategy?: "individual" | "all";
+}
+interface ResolvedPubmConfig extends Required<Omit<PubmConfig, "packages" | "validate" | "snapshot">> {
+    packages: PackageConfig[];
+    validate: Required<ValidateConfig>;
+    snapshot: Required<SnapshotConfig>;
+}
+declare function defineConfig(config: PubmConfig): PubmConfig;
+
+declare function resolveConfig(config: PubmConfig): ResolvedPubmConfig;
+
+declare function loadConfig(cwd?: string): Promise<PubmConfig | null>;
+
+interface PackageNode {
+    name: string;
+    version: string;
+    path: string;
+    dependencies: Record<string, string>;
+}
+/**
+ * Builds an adjacency list of internal dependencies only.
+ * Each key is a package name, and the value is an array of internal package names it depends on.
+ */
+declare function buildDependencyGraph(packages: PackageNode[]): Map<string, string[]>;
+/**
+ * Topological sort using Kahn's algorithm.
+ * Returns packages in dependency order (dependencies first).
+ * Throws an error if circular dependencies are detected.
+ */
+declare function topologicalSort(graph: Map<string, string[]>): string[];
+
+/**
+ * Resolves glob patterns in groups to actual package names.
+ * Exact names are passed through; glob patterns are matched against allPackages.
+ */
+declare function resolveGroups(groups: string[][], allPackages: string[]): string[][];
+/**
+ * Fixed group: all packages in the group get the maximum bump type,
+ * even those without changesets. If no packages in the group have bumps,
+ * nothing is changed.
+ */
+declare function applyFixedGroup(bumps: Map<string, BumpType>, group: string[]): void;
+/**
+ * Linked group: only packages that already have bumps get aligned
+ * to the maximum bump type. Packages without bumps are not added.
+ */
+declare function applyLinkedGroup(bumps: Map<string, BumpType>, group: string[]): void;
+
+interface WorkspaceInfo {
+    type: "pnpm" | "npm" | "yarn";
+    patterns: string[];
+}
+declare function detectWorkspace(cwd?: string): WorkspaceInfo | null;
+
+interface PreState {
+    mode: "pre";
+    tag: string;
+    packages: Record<string, {
+        baseVersion: string;
+        iteration: number;
+    }>;
+}
+declare function readPreState(cwd?: string): PreState | null;
+declare function enterPreMode(tag: string, cwd?: string): void;
+declare function exitPreMode(cwd?: string): void;
+
+interface SnapshotOptions {
+    tag?: string;
+    baseVersion?: string;
+    useCalculatedVersion?: boolean;
+    template?: string;
+    commit?: string;
+}
+declare function generateSnapshotVersion(options: SnapshotOptions): string;
+
+interface EntryPointError {
+    field: string;
+    path: string;
+}
+declare function validateEntryPoints(pkg: Record<string, unknown>, cwd: string): EntryPointError[];
+
+interface ExtraneousFile {
+    file: string;
+    reason: string;
+}
+declare function detectExtraneousFiles(files: string[]): ExtraneousFile[];
+
 /**
  * Runs the `pubm` function with the provided options.
  *
@@ -100,4 +278,4 @@ interface Options {
  */
 declare function pubm(options: Options): Promise<void>;
 
-export { type Options, pubm };
+export { type BumpType, type ChangelogEntry, type Changeset, type DependencyUpdate, type EntryPointError, type ExtraneousFile, type MigrationResult, type Options, type PackageConfig, type PackageNode, type PackageStatus, type PreState, type PubmConfig, type Release, type ResolvedPubmConfig, type SnapshotOptions, type Status, type VersionBump, type WorkspaceInfo, applyFixedGroup, applyLinkedGroup, buildDependencyGraph, calculateVersionBumps, defineConfig, detectExtraneousFiles, detectWorkspace, enterPreMode, exitPreMode, generateChangelog, generateChangesetContent, generateChangesetId, generateSnapshotVersion, getStatus, loadConfig, migrateFromChangesets, parseChangeset, pubm, readChangesets, readPreState, resolveConfig, resolveGroups, topologicalSort, validateEntryPoints, writeChangeset };