@releasekit/notes 0.2.0-next.9 → 0.2.1

package/dist/chunk-SAUES3BF.js

@@ -0,0 +1,231 @@
+// ../core/dist/index.js
+import chalk from "chalk";
+var LOG_LEVELS = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  debug: 3,
+  trace: 4
+};
+var PREFIXES = {
+  error: "[ERROR]",
+  warn: "[WARN]",
+  info: "[INFO]",
+  debug: "[DEBUG]",
+  trace: "[TRACE]"
+};
+var COLORS = {
+  error: chalk.red,
+  warn: chalk.yellow,
+  info: chalk.blue,
+  debug: chalk.gray,
+  trace: chalk.dim
+};
+var currentLevel = "info";
+var quietMode = false;
+function setLogLevel(level) {
+  currentLevel = level;
+}
+function setQuietMode(quiet) {
+  quietMode = quiet;
+}
+function shouldLog(level) {
+  if (quietMode && level !== "error") return false;
+  return LOG_LEVELS[level] <= LOG_LEVELS[currentLevel];
+}
+function log(message, level = "info") {
+  if (!shouldLog(level)) return;
+  const formatted = COLORS[level](`${PREFIXES[level]} ${message}`);
+  console.error(formatted);
+}
+function error(message) {
+  log(message, "error");
+}
+function warn(message) {
+  log(message, "warn");
+}
+function info(message) {
+  log(message, "info");
+}
+function success(message) {
+  if (!shouldLog("info")) return;
+  console.error(chalk.green(`[SUCCESS] ${message}`));
+}
+function debug(message) {
+  log(message, "debug");
+}
+var ReleaseKitError = class _ReleaseKitError extends Error {
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+  }
+  logError() {
+    log(this.message, "error");
+    if (this.suggestions.length > 0) {
+      log("\nSuggested solutions:", "info");
+      for (const [i, suggestion] of this.suggestions.entries()) {
+        log(`${i + 1}. ${suggestion}`, "info");
+      }
+    }
+  }
+  static isReleaseKitError(error2) {
+    return error2 instanceof _ReleaseKitError;
+  }
+};
+var EXIT_CODES = {
+  SUCCESS: 0,
+  GENERAL_ERROR: 1,
+  CONFIG_ERROR: 2,
+  INPUT_ERROR: 3,
+  TEMPLATE_ERROR: 4,
+  LLM_ERROR: 5,
+  GITHUB_ERROR: 6,
+  GIT_ERROR: 7,
+  VERSION_ERROR: 8,
+  PUBLISH_ERROR: 9
+};
+
+// src/output/markdown.ts
+import * as fs from "fs";
+import * as path from "path";
+var TYPE_ORDER = ["added", "changed", "deprecated", "removed", "fixed", "security"];
+var TYPE_LABELS = {
+  added: "Added",
+  changed: "Changed",
+  deprecated: "Deprecated",
+  removed: "Removed",
+  fixed: "Fixed",
+  security: "Security"
+};
+function groupEntriesByType(entries) {
+  const grouped = /* @__PURE__ */ new Map();
+  for (const type of TYPE_ORDER) {
+    grouped.set(type, []);
+  }
+  for (const entry of entries) {
+    const existing = grouped.get(entry.type) ?? [];
+    existing.push(entry);
+    grouped.set(entry.type, existing);
+  }
+  return grouped;
+}
+function formatEntry(entry) {
+  let line;
+  if (entry.breaking && entry.scope) {
+    line = `- **BREAKING** **${entry.scope}**: ${entry.description}`;
+  } else if (entry.breaking) {
+    line = `- **BREAKING** ${entry.description}`;
+  } else if (entry.scope) {
+    line = `- **${entry.scope}**: ${entry.description}`;
+  } else {
+    line = `- ${entry.description}`;
+  }
+  if (entry.issueIds && entry.issueIds.length > 0) {
+    line += ` (${entry.issueIds.join(", ")})`;
+  }
+  return line;
+}
+function formatVersion(context, options) {
+  const lines = [];
+  const versionLabel = options?.includePackageName && context.packageName ? `${context.packageName}@${context.version}` : context.version;
+  const versionHeader = context.previousVersion ? `## [${versionLabel}]` : `## ${versionLabel}`;
+  lines.push(`${versionHeader} - ${context.date}`);
+  lines.push("");
+  if (context.compareUrl) {
+    lines.push(`[Full Changelog](${context.compareUrl})`);
+    lines.push("");
+  }
+  if (context.enhanced?.summary) {
+    lines.push(context.enhanced.summary);
+    lines.push("");
+  }
+  const grouped = groupEntriesByType(context.entries);
+  for (const [type, entries] of grouped) {
+    if (entries.length === 0) continue;
+    lines.push(`### ${TYPE_LABELS[type]}`);
+    for (const entry of entries) {
+      lines.push(formatEntry(entry));
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatHeader() {
+  return `# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+`;
+}
+function renderMarkdown(contexts, options) {
+  const sections = [formatHeader()];
+  for (const context of contexts) {
+    sections.push(formatVersion(context, options));
+  }
+  return sections.join("\n");
+}
+function prependVersion(existingPath, context, options) {
+  let existing = "";
+  if (fs.existsSync(existingPath)) {
+    existing = fs.readFileSync(existingPath, "utf-8");
+    const headerEnd = existing.indexOf("\n## ");
+    if (headerEnd >= 0) {
+      const header = existing.slice(0, headerEnd);
+      const body = existing.slice(headerEnd + 1);
+      const newVersion = formatVersion(context, options);
+      return `${header}
+
+${newVersion}
+${body}`;
+    }
+  }
+  return renderMarkdown([context]);
+}
+function writeMarkdown(outputPath, contexts, config, dryRun, options) {
+  const content = renderMarkdown(contexts, options);
+  const label = /changelog/i.test(outputPath) ? "Changelog" : "Release notes";
+  if (dryRun) {
+    info(`Would write ${label.toLowerCase()} to ${outputPath}`);
+    debug("--- Preview ---");
+    debug(content);
+    debug("--- End Preview ---");
+    return;
+  }
+  const dir = path.dirname(outputPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+  if (outputPath === "-") {
+    process.stdout.write(content);
+    return;
+  }
+  if (config.updateStrategy === "prepend" && fs.existsSync(outputPath) && contexts.length === 1) {
+    const firstContext = contexts[0];
+    if (firstContext) {
+      const updated = prependVersion(outputPath, firstContext, options);
+      fs.writeFileSync(outputPath, updated, "utf-8");
+    }
+  } else {
+    fs.writeFileSync(outputPath, content, "utf-8");
+  }
+  success(`${label} written to ${outputPath}`);
+}
+
+export {
+  setLogLevel,
+  setQuietMode,
+  error,
+  warn,
+  info,
+  success,
+  debug,
+  ReleaseKitError,
+  EXIT_CODES,
+  formatVersion,
+  renderMarkdown,
+  prependVersion,
+  writeMarkdown
+};

package/dist/cli.d.ts

@@ -1 +1,9 @@
 #!/usr/bin/env node
+import './core/config.ts';
+import './core/pipeline.ts';
+import './core/types.ts';
+import './errors/index.ts';
+import './input/package-versioner.ts';
+import './monorepo/aggregator.ts';
+import './output/json.ts';
+import './output/markdown.ts';

package/dist/cli.js

@@ -1,22 +1,25 @@
 #!/usr/bin/env node
 import {
-  EXIT_CODES,
   NotesError,
-  createTemplateContext,
-  detectMonorepo,
   getDefaultConfig,
   getExitCode,
   loadConfig,
   parsePackageVersioner,
   runPipeline,
-  saveAuth,
-  writeMonorepoChangelogs
-} from "./chunk-BLWJTLRD.js";
+  saveAuth
+} from "./chunk-IKER5VME.js";
+import {
+  EXIT_CODES,
+  error,
+  info,
+  setLogLevel,
+  setQuietMode,
+  success
+} from "./chunk-SAUES3BF.js";
 
 // src/cli.ts
 import * as fs from "fs";
 import * as readline from "readline";
-import { error, info, setLogLevel, setQuietMode, success } from "@releasekit/core";
 import { Command } from "commander";
 var program = new Command();
 program.name("releasekit-notes").description("Generate changelogs with LLM-powered enhancement and flexible templating").version("0.1.0");
@@ -82,29 +85,10 @@ program.command("generate", { isDefault: true }).description("Generate changelog
       }
       info(`Filtered to package: ${options.target}`);
     }
-    if (options.monorepo || config.monorepo) {
-      const monorepoMode = options.monorepo ?? config.monorepo?.mode ?? "both";
-      const detected = detectMonorepo(process.cwd());
-      if (!detected.isMonorepo) {
-        info("No monorepo detected, using single package mode");
-        await runPipeline(input, config, options.dryRun ?? false);
-      } else {
-        info(`Monorepo detected with packages at ${detected.packagesPath}`);
-        const contexts = input.packages.map(createTemplateContext);
-        writeMonorepoChangelogs(
-          contexts,
-          {
-            rootPath: config.monorepo?.rootPath ?? process.cwd(),
-            packagesPath: config.monorepo?.packagesPath ?? detected.packagesPath,
-            mode: monorepoMode
-          },
-          config,
-          options.dryRun ?? false
-        );
-      }
-    } else {
-      await runPipeline(input, config, options.dryRun ?? false);
+    if (options.monorepo) {
+      config.monorepo = { ...config.monorepo, mode: options.monorepo };
     }
+    await runPipeline(input, config, options.dryRun ?? false);
     if (options.dryRun) {
       info("Dry run complete - no files were written");
     } else {

package/dist/index.d.ts

@@ -1,182 +1,8 @@
-import { NotesConfig } from '@releasekit/config';
-export { loadAuth, saveAuth } from '@releasekit/config';
-import { ReleaseKitError } from '@releasekit/core';
-export { EXIT_CODES } from '@releasekit/core';
-
-declare function loadConfig(projectDir?: string, configFile?: string): NotesConfig;
-declare function getDefaultConfig(): NotesConfig;
-
-interface RetryOptions {
-    maxAttempts?: number;
-    initialDelay?: number;
-    maxDelay?: number;
-    backoffFactor?: number;
-}
-
-type ChangelogType = 'added' | 'changed' | 'deprecated' | 'removed' | 'fixed' | 'security';
-interface ChangelogEntry {
-    type: ChangelogType;
-    description: string;
-    issueIds?: string[];
-    scope?: string;
-    originalType?: string;
-    breaking?: boolean;
-}
-interface PackageChangelog {
-    packageName: string;
-    version: string;
-    previousVersion: string | null;
-    revisionRange: string;
-    repoUrl: string | null;
-    date: string;
-    entries: ChangelogEntry[];
-}
-type InputSource = 'package-versioner' | 'conventional-changelog' | 'git-log' | 'manual';
-interface ChangelogInput {
-    source: InputSource;
-    packages: PackageChangelog[];
-    metadata?: {
-        repoUrl?: string;
-        defaultBranch?: string;
-    };
-}
-interface EnhancedData {
-    entries: ChangelogEntry[];
-    summary?: string;
-    categories?: Record<string, ChangelogEntry[]>;
-    releaseNotes?: string;
-}
-interface TemplateContext {
-    packageName: string;
-    version: string;
-    previousVersion: string | null;
-    date: string;
-    repoUrl: string | null;
-    entries: ChangelogEntry[];
-    compareUrl?: string;
-    enhanced?: EnhancedData;
-}
-interface DocumentContext {
-    project: {
-        name: string;
-        repoUrl?: string;
-    };
-    versions: TemplateContext[];
-    unreleased?: TemplateContext;
-    compareUrls?: Record<string, string>;
-}
-interface LLMOptions {
-    timeout?: number;
-    maxTokens?: number;
-    temperature?: number;
-}
-interface LLMConfig {
-    provider: string;
-    model: string;
-    baseURL?: string;
-    apiKey?: string;
-    options?: LLMOptions;
-    concurrency?: number;
-    retry?: RetryOptions;
-    tasks?: {
-        summarize?: boolean;
-        enhance?: boolean;
-        categorize?: boolean;
-        releaseNotes?: boolean;
-    };
-    categories?: Array<{
-        name: string;
-        description: string;
-    }>;
-    style?: string;
-}
-type OutputFormat = 'markdown' | 'github-release' | 'json';
-interface OutputConfig {
-    format: OutputFormat;
-    file?: string;
-    options?: Record<string, unknown>;
-}
-type MonorepoMode = 'root' | 'packages' | 'both';
-interface MonorepoConfig {
-    mode?: MonorepoMode;
-    rootPath?: string;
-    packagesPath?: string;
-}
-type UpdateStrategy = 'prepend' | 'regenerate';
-type TemplateEngine = 'handlebars' | 'liquid' | 'ejs';
-interface TemplateConfig {
-    path?: string;
-    engine?: TemplateEngine;
-}
-interface Config {
-    input?: {
-        source?: string;
-        file?: string;
-    };
-    output: OutputConfig[];
-    monorepo?: MonorepoConfig;
-    templates?: TemplateConfig;
-    llm?: LLMConfig;
-    updateStrategy?: UpdateStrategy;
-}
-interface CompleteOptions {
-    maxTokens?: number;
-    temperature?: number;
-    timeout?: number;
-}
-
-declare function createTemplateContext(pkg: PackageChangelog): TemplateContext;
-declare function runPipeline(input: ChangelogInput, config: Config, dryRun: boolean): Promise<void>;
-declare function processInput(inputJson: string, config: Config, dryRun: boolean): Promise<void>;
-
-declare abstract class NotesError extends ReleaseKitError {
-}
-
-declare class InputParseError extends NotesError {
-    readonly code = "INPUT_PARSE_ERROR";
-    readonly suggestions: string[];
-}
-declare class TemplateError extends NotesError {
-    readonly code = "TEMPLATE_ERROR";
-    readonly suggestions: string[];
-}
-declare class LLMError extends NotesError {
-    readonly code = "LLM_ERROR";
-    readonly suggestions: string[];
-}
-declare class GitHubError extends NotesError {
-    readonly code = "GITHUB_ERROR";
-    readonly suggestions: string[];
-}
-declare class ConfigError extends NotesError {
-    readonly code = "CONFIG_ERROR";
-    readonly suggestions: string[];
-}
-declare function getExitCode(error: NotesError): number;
-
-declare function parsePackageVersioner(json: string): ChangelogInput;
-declare function parsePackageVersionerFile(filePath: string): ChangelogInput;
-declare function parsePackageVersionerStdin(): Promise<ChangelogInput>;
-
-interface MonorepoOptions {
-    rootPath: string;
-    packagesPath: string;
-    mode: 'root' | 'packages' | 'both';
-}
-declare function aggregateToRoot(contexts: TemplateContext[]): TemplateContext;
-
-declare function writeMonorepoChangelogs(contexts: TemplateContext[], options: MonorepoOptions, config: {
-    updateStrategy?: 'prepend' | 'regenerate';
-}, dryRun: boolean): void;
-declare function detectMonorepo(cwd: string): {
-    isMonorepo: boolean;
-    packagesPath: string;
-};
-
-declare function renderJson(contexts: TemplateContext[]): string;
-declare function writeJson(outputPath: string, contexts: TemplateContext[], dryRun: boolean): void;
-
-declare function renderMarkdown(contexts: TemplateContext[]): string;
-declare function writeMarkdown(outputPath: string, contexts: TemplateContext[], config: Config, dryRun: boolean): void;
-
-export { NotesError as ChangelogCreatorError, type ChangelogEntry, type ChangelogInput, type ChangelogType, type CompleteOptions, type Config, ConfigError, type DocumentContext, type EnhancedData, GitHubError, InputParseError, type InputSource, type LLMConfig, LLMError, type LLMOptions, type MonorepoConfig, type MonorepoMode, NotesError, type OutputConfig, type OutputFormat, type PackageChangelog, type RetryOptions, type TemplateConfig, type TemplateContext, type TemplateEngine, TemplateError, type UpdateStrategy, aggregateToRoot, createTemplateContext, detectMonorepo, getDefaultConfig, getExitCode, loadConfig, parsePackageVersioner, parsePackageVersionerFile, parsePackageVersionerStdin, processInput, renderJson, renderMarkdown, runPipeline, writeJson, writeMarkdown, writeMonorepoChangelogs };
+export { getDefaultConfig, loadAuth, loadConfig, saveAuth } from './core/config.ts';
+export { PipelineResult, createTemplateContext, processInput, runPipeline } from './core/pipeline.ts';
+export * from './core/types.ts';
+export * from './errors/index.ts';
+export { parsePackageVersioner, parsePackageVersionerFile, parsePackageVersionerStdin } from './input/package-versioner.ts';
+export { aggregateToRoot, detectMonorepo, writeMonorepoChangelogs } from './monorepo/aggregator.ts';
+export { renderJson, writeJson } from './output/json.ts';
+export { formatVersion, renderMarkdown, writeMarkdown } from './output/markdown.ts';

package/dist/index.js

@@ -1,14 +1,11 @@
 import {
   ConfigError,
-  EXIT_CODES,
   GitHubError,
   InputParseError,
   LLMError,
   NotesError,
   TemplateError,
-  aggregateToRoot,
   createTemplateContext,
-  detectMonorepo,
   getDefaultConfig,
   getExitCode,
   loadAuth,
@@ -18,13 +15,21 @@ import {
   parsePackageVersionerStdin,
   processInput,
   renderJson,
-  renderMarkdown,
   runPipeline,
   saveAuth,
-  writeJson,
-  writeMarkdown,
+  writeJson
+} from "./chunk-IKER5VME.js";
+import {
+  aggregateToRoot,
+  detectMonorepo,
   writeMonorepoChangelogs
-} from "./chunk-BLWJTLRD.js";
+} from "./chunk-ATNNRK62.js";
+import {
+  EXIT_CODES,
+  formatVersion,
+  renderMarkdown,
+  writeMarkdown
+} from "./chunk-SAUES3BF.js";
 export {
   NotesError as ChangelogCreatorError,
   ConfigError,
@@ -37,6 +42,7 @@ export {
   aggregateToRoot,
   createTemplateContext,
   detectMonorepo,
+  formatVersion,
   getDefaultConfig,
   getExitCode,
   loadAuth,

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@releasekit/notes",
-  "version": "0.2.0-next.9",
-  "description": "Changelog generation with LLM-powered enhancement and flexible templating",
+  "version": "0.2.1",
+  "description": "Release notes and changelog generation with LLM-powered enhancement and flexible templating",
   "type": "module",
-  "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
@@ -11,27 +10,19 @@
       "import": {
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
       }
     }
   },
   "bin": {
     "releasekit-notes": "dist/cli.js"
   },
-  "scripts": {
-    "build": "tsup src/index.ts src/cli.ts --format esm,cjs --dts",
-    "dev": "tsup src/index.ts src/cli.ts --format esm,cjs --watch --dts",
-    "clean": "rm -rf dist coverage .turbo",
-    "test": "vitest run",
-    "test:unit": "vitest run --coverage",
-    "test:coverage": "vitest run --coverage",
-    "lint": "biome check .",
-    "typecheck": "tsc --noEmit"
-  },
-  "keywords": ["changelog", "release-notes", "llm", "template", "cli"],
+  "keywords": [
+    "changelog",
+    "release-notes",
+    "llm",
+    "template",
+    "cli"
+  ],
   "author": "Sam Maister <goosewobbler@protonmail.com>",
   "license": "MIT",
   "repository": {
@@ -39,33 +30,49 @@
     "url": "git+https://github.com/goosewobbler/releasekit.git",
     "directory": "packages/notes"
   },
-  "files": ["dist", "templates", "README.md", "LICENSE"],
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
-    "@octokit/rest": "^21.1.1",
-    "@releasekit/config": "workspace:*",
-    "@releasekit/core": "workspace:*",
-    "chalk": "catalog:",
-    "commander": "catalog:",
-    "ejs": "^3.1.10",
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@octokit/rest": "^22.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "ejs": "^4.0.1",
     "handlebars": "^4.7.8",
-    "liquidjs": "^10.21.0",
-    "openai": "^4.87.0",
-    "zod": "catalog:"
+    "liquidjs": "^10.25.0",
+    "openai": "^6.27.0",
+    "smol-toml": "^1.6.0",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
-    "@biomejs/biome": "catalog:",
+    "@biomejs/biome": "^2.4.6",
     "@types/ejs": "^3.1.5",
-    "@types/node": "catalog:",
-    "@vitest/coverage-v8": "catalog:",
-    "tsup": "catalog:",
-    "typescript": "catalog:",
-    "vitest": "catalog:"
+    "@types/node": "^22.19.15",
+    "@vitest/coverage-v8": "^4.1.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0",
+    "@releasekit/core": "0.0.0",
+    "@releasekit/config": "0.0.0"
   },
   "engines": {
     "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist coverage .turbo",
+    "test": "vitest run",
+    "test:unit": "vitest run --coverage",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit"
   }
-}
+}