@jentic/arazzo-validator 1.0.0-alpha.24 → 1.0.0-alpha.26

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-alpha.26](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.25...v1.0.0-alpha.26) (2026-03-11)
+
+### Bug Fixes
+
+- **parser:** add consistent naming for exported options ([#134](https://github.com/jentic/jentic-arazzo-tools/issues/134)) ([cfa2a54](https://github.com/jentic/jentic-arazzo-tools/commit/cfa2a54fad0189da7d26ca4c76b63bfcc3c60eec))
+
+# [1.0.0-alpha.25](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.24...v1.0.0-alpha.25) (2026-03-11)
+
+### Bug Fixes
+
+- **release:** fix issue in lerna not publishing _.cjs|_.mjs files ([8982184](https://github.com/jentic/jentic-arazzo-tools/commit/8982184ddae167b6f2a772114f9a9321f3b67d14))
+
 # [1.0.0-alpha.24](https://github.com/jentic/jentic-arazzo-tools/compare/v1.0.0-alpha.23...v1.0.0-alpha.24) (2026-03-11)
 
 **Note:** Version bump only for package @jentic/arazzo-validator

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jentic/arazzo-validator",
-  "version": "1.0.0-alpha.24",
+  "version": "1.0.0-alpha.26",
   "description": "Validator & Linter for Arazzo Documents.",
   "keywords": [
     "arazzo",
@@ -56,7 +56,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@jentic/arazzo-parser": "1.0.0-alpha.24",
+    "@jentic/arazzo-parser": "1.0.0-alpha.26",
     "@speclynx/apidom-ls": "^2.4.2",
     "@speclynx/apidom-ns-arazzo-1": "^4.0.3",
     "@speclynx/apidom-reference": "^4.0.3",
@@ -69,8 +69,7 @@
   },
   "files": [
     "bin/",
-    "src/**/*.mjs",
-    "src/**/*.cjs",
+    "src/",
     "dist/",
     "types/arazzo-validator.d.ts",
     "LICENSE",
@@ -78,5 +77,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "4d69c9a6c690d8fac8938c7032f57258948d76ce"
+  "gitHead": "fa8637a6e4ad80e321a5808da52e4346a1a1f0d7"
 }

package/src/cli/formatters/codeframe.cjs

@@ -0,0 +1,92 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.formatCodeframe = formatCodeframe;
+var _chalk = _interopRequireDefault(require("chalk"));
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+var _stylish = require("./stylish.cjs");
+function formatCodeSnippet(sourceLines, diagnostic, gutterWidth) {
+  const lines = [];
+  const startLine = diagnostic.range.start.line;
+  const startChar = diagnostic.range.start.character;
+  const endChar = diagnostic.range.end.character;
+
+  // show context: 1 line before, problem line, 1 line after
+  const contextStart = Math.max(0, startLine - 1);
+  const contextEnd = Math.min(sourceLines.length - 1, startLine + 1);
+  for (let i = contextStart; i <= contextEnd; i++) {
+    const lineNum = i + 1;
+    const gutter = _chalk.default.dim(`${String(lineNum).padStart(gutterWidth)} |`);
+    const sourceLine = sourceLines[i] || '';
+    lines.push(`${gutter} ${sourceLine}`);
+
+    // add caret line under the problem line
+    if (i === startLine) {
+      const caretGutter = _chalk.default.dim(`${' '.repeat(gutterWidth)} |`);
+      const caretLength = Math.max(1, endChar - startChar);
+      const carets = _chalk.default.red('^'.repeat(caretLength));
+      lines.push(`${caretGutter} ${' '.repeat(startChar)}${carets}`);
+    }
+  }
+  return lines;
+}
+function formatCodeframe(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems,
+    sourceContent
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  if (limitedDiagnostics.length === 0) {
+    return '';
+  }
+  const sourceLines = sourceContent?.split('\n');
+  const maxLineNum = sourceLines?.length ?? 0;
+  const gutterWidth = Math.max(String(maxLineNum).length, 2);
+
+  // calculate max widths for alignment
+  const maxLocationLength = Math.max(...limitedDiagnostics.map(d => (0, _stylish.formatLocation)(d).length));
+  const maxCodeLength = Math.max(...limitedDiagnostics.map(d => d.code ? String(d.code).length : 0));
+  const lines = [];
+
+  // file path header
+  lines.push(_chalk.default.bold(filePath));
+
+  // diagnostics
+  for (const diagnostic of limitedDiagnostics) {
+    const locationStr = (0, _stylish.formatLocation)(diagnostic);
+    const location = _chalk.default.dim(locationStr.padEnd(maxLocationLength));
+    const severity = (0, _stylish.severityToString)(diagnostic.severity);
+    const codeStr = diagnostic.code ? String(diagnostic.code) : '';
+    const code = codeStr ? _chalk.default.cyan(codeStr.padEnd(maxCodeLength)) : ' '.repeat(maxCodeLength);
+    const message = diagnostic.message;
+    lines.push(`  ${location}  ${severity}  ${code}  ${message}`);
+
+    // add code snippet if source content is available
+    if (sourceLines) {
+      lines.push('');
+      lines.push(...formatCodeSnippet(sourceLines, diagnostic, gutterWidth));
+      lines.push('');
+    }
+  }
+
+  // summary
+  const errorCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Error).length;
+  const warningCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Warning).length;
+  const infoCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Information).length;
+  const hintCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Hint).length;
+  lines.push('');
+  const parts = [];
+  if (errorCount > 0) parts.push(`${errorCount} ${errorCount === 1 ? 'error' : 'errors'}`);
+  if (warningCount > 0) parts.push(`${warningCount} ${warningCount === 1 ? 'warning' : 'warnings'}`);
+  if (infoCount > 0) parts.push(`${infoCount} ${infoCount === 1 ? 'info' : 'infos'}`);
+  if (hintCount > 0) parts.push(`${hintCount} ${hintCount === 1 ? 'hint' : 'hints'}`);
+  const symbol = errorCount > 0 ? _chalk.default.red('✖') : _chalk.default.yellow('⚠');
+  const problemText = limitedDiagnostics.length === 1 ? 'problem' : 'problems';
+  const breakdown = parts.length > 0 ? ` (${parts.join(', ')})` : '';
+  lines.push(`${symbol} ${limitedDiagnostics.length} ${problemText}${breakdown}`);
+  if (maxProblems && diagnostics.length > maxProblems) {
+    lines.push(_chalk.default.dim(`(showing ${maxProblems} of ${diagnostics.length} problems)`));
+  }
+  return lines.join('\n');
+}

package/src/cli/formatters/codeframe.mjs

@@ -0,0 +1,87 @@
+import chalk from 'chalk';
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+import { severityToString, formatLocation } from "./stylish.mjs";
+function formatCodeSnippet(sourceLines, diagnostic, gutterWidth) {
+  const lines = [];
+  const startLine = diagnostic.range.start.line;
+  const startChar = diagnostic.range.start.character;
+  const endChar = diagnostic.range.end.character;
+
+  // show context: 1 line before, problem line, 1 line after
+  const contextStart = Math.max(0, startLine - 1);
+  const contextEnd = Math.min(sourceLines.length - 1, startLine + 1);
+  for (let i = contextStart; i <= contextEnd; i++) {
+    const lineNum = i + 1;
+    const gutter = chalk.dim(`${String(lineNum).padStart(gutterWidth)} |`);
+    const sourceLine = sourceLines[i] || '';
+    lines.push(`${gutter} ${sourceLine}`);
+
+    // add caret line under the problem line
+    if (i === startLine) {
+      const caretGutter = chalk.dim(`${' '.repeat(gutterWidth)} |`);
+      const caretLength = Math.max(1, endChar - startChar);
+      const carets = chalk.red('^'.repeat(caretLength));
+      lines.push(`${caretGutter} ${' '.repeat(startChar)}${carets}`);
+    }
+  }
+  return lines;
+}
+export function formatCodeframe(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems,
+    sourceContent
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  if (limitedDiagnostics.length === 0) {
+    return '';
+  }
+  const sourceLines = sourceContent?.split('\n');
+  const maxLineNum = sourceLines?.length ?? 0;
+  const gutterWidth = Math.max(String(maxLineNum).length, 2);
+
+  // calculate max widths for alignment
+  const maxLocationLength = Math.max(...limitedDiagnostics.map(d => formatLocation(d).length));
+  const maxCodeLength = Math.max(...limitedDiagnostics.map(d => d.code ? String(d.code).length : 0));
+  const lines = [];
+
+  // file path header
+  lines.push(chalk.bold(filePath));
+
+  // diagnostics
+  for (const diagnostic of limitedDiagnostics) {
+    const locationStr = formatLocation(diagnostic);
+    const location = chalk.dim(locationStr.padEnd(maxLocationLength));
+    const severity = severityToString(diagnostic.severity);
+    const codeStr = diagnostic.code ? String(diagnostic.code) : '';
+    const code = codeStr ? chalk.cyan(codeStr.padEnd(maxCodeLength)) : ' '.repeat(maxCodeLength);
+    const message = diagnostic.message;
+    lines.push(`  ${location}  ${severity}  ${code}  ${message}`);
+
+    // add code snippet if source content is available
+    if (sourceLines) {
+      lines.push('');
+      lines.push(...formatCodeSnippet(sourceLines, diagnostic, gutterWidth));
+      lines.push('');
+    }
+  }
+
+  // summary
+  const errorCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Error).length;
+  const warningCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Warning).length;
+  const infoCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Information).length;
+  const hintCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Hint).length;
+  lines.push('');
+  const parts = [];
+  if (errorCount > 0) parts.push(`${errorCount} ${errorCount === 1 ? 'error' : 'errors'}`);
+  if (warningCount > 0) parts.push(`${warningCount} ${warningCount === 1 ? 'warning' : 'warnings'}`);
+  if (infoCount > 0) parts.push(`${infoCount} ${infoCount === 1 ? 'info' : 'infos'}`);
+  if (hintCount > 0) parts.push(`${hintCount} ${hintCount === 1 ? 'hint' : 'hints'}`);
+  const symbol = errorCount > 0 ? chalk.red('✖') : chalk.yellow('⚠');
+  const problemText = limitedDiagnostics.length === 1 ? 'problem' : 'problems';
+  const breakdown = parts.length > 0 ? ` (${parts.join(', ')})` : '';
+  lines.push(`${symbol} ${limitedDiagnostics.length} ${problemText}${breakdown}`);
+  if (maxProblems && diagnostics.length > maxProblems) {
+    lines.push(chalk.dim(`(showing ${maxProblems} of ${diagnostics.length} problems)`));
+  }
+  return lines.join('\n');
+}

package/src/cli/formatters/github-actions.cjs

@@ -0,0 +1,47 @@
+"use strict";
+
+exports.__esModule = true;
+exports.formatGitHubActions = formatGitHubActions;
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+function severityToGitHub(severity) {
+  switch (severity) {
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Error:
+      return 'error';
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Warning:
+      return 'warning';
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Information:
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Hint:
+      return 'notice';
+    default:
+      return 'notice';
+  }
+}
+function escapeData(data) {
+  return data.replace(/%/g, '%25').replace(/\r/g, '%0D').replace(/\n/g, '%0A');
+}
+function escapeProperty(value) {
+  return value.replace(/%/g, '%25').replace(/\r/g, '%0D').replace(/\n/g, '%0A').replace(/:/g, '%3A').replace(/,/g, '%2C');
+}
+/**
+ * Formats diagnostics as GitHub Actions workflow commands.
+ * @see https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions
+ */
+function formatGitHubActions(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  const lines = [];
+  for (const diagnostic of limitedDiagnostics) {
+    const level = severityToGitHub(diagnostic.severity);
+    const line = diagnostic.range.start.line + 1;
+    const col = diagnostic.range.start.character + 1;
+    const endLine = diagnostic.range.end.line + 1;
+    const endCol = diagnostic.range.end.character + 1;
+    const message = escapeData(diagnostic.message);
+    const title = escapeProperty(diagnostic.code ? String(diagnostic.code) : 'validation');
+    const file = escapeProperty(filePath);
+    lines.push(`::${level} file=${file},line=${line},col=${col},endLine=${endLine},endColumn=${endCol},title=${title}::${message}`);
+  }
+  return lines.join('\n');
+}

package/src/cli/formatters/github-actions.mjs

@@ -0,0 +1,43 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+function severityToGitHub(severity) {
+  switch (severity) {
+    case DiagnosticSeverity.Error:
+      return 'error';
+    case DiagnosticSeverity.Warning:
+      return 'warning';
+    case DiagnosticSeverity.Information:
+    case DiagnosticSeverity.Hint:
+      return 'notice';
+    default:
+      return 'notice';
+  }
+}
+function escapeData(data) {
+  return data.replace(/%/g, '%25').replace(/\r/g, '%0D').replace(/\n/g, '%0A');
+}
+function escapeProperty(value) {
+  return value.replace(/%/g, '%25').replace(/\r/g, '%0D').replace(/\n/g, '%0A').replace(/:/g, '%3A').replace(/,/g, '%2C');
+}
+/**
+ * Formats diagnostics as GitHub Actions workflow commands.
+ * @see https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions
+ */
+export function formatGitHubActions(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  const lines = [];
+  for (const diagnostic of limitedDiagnostics) {
+    const level = severityToGitHub(diagnostic.severity);
+    const line = diagnostic.range.start.line + 1;
+    const col = diagnostic.range.start.character + 1;
+    const endLine = diagnostic.range.end.line + 1;
+    const endCol = diagnostic.range.end.character + 1;
+    const message = escapeData(diagnostic.message);
+    const title = escapeProperty(diagnostic.code ? String(diagnostic.code) : 'validation');
+    const file = escapeProperty(filePath);
+    lines.push(`::${level} file=${file},line=${line},col=${col},endLine=${endLine},endColumn=${endCol},title=${title}::${message}`);
+  }
+  return lines.join('\n');
+}

package/src/cli/formatters/index.cjs

@@ -0,0 +1,12 @@
+"use strict";
+
+exports.__esModule = true;
+exports.formatStylish = exports.formatJSON = exports.formatGitHubActions = exports.formatCodeframe = void 0;
+var _stylish = require("./stylish.cjs");
+exports.formatStylish = _stylish.formatStylish;
+var _codeframe = require("./codeframe.cjs");
+exports.formatCodeframe = _codeframe.formatCodeframe;
+var _json = require("./json.cjs");
+exports.formatJSON = _json.formatJSON;
+var _githubActions = require("./github-actions.cjs");
+exports.formatGitHubActions = _githubActions.formatGitHubActions;

package/src/cli/formatters/index.mjs

@@ -0,0 +1,4 @@
+export { formatStylish } from "./stylish.mjs";
+export { formatCodeframe } from "./codeframe.mjs";
+export { formatJSON } from "./json.mjs";
+export { formatGitHubActions } from "./github-actions.mjs";

package/src/cli/formatters/json.cjs

@@ -0,0 +1,20 @@
+"use strict";
+
+exports.__esModule = true;
+exports.formatJSON = formatJSON;
+function formatJSON(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  const output = {
+    filePath,
+    diagnostics: limitedDiagnostics,
+    summary: {
+      total: limitedDiagnostics.length,
+      truncated: maxProblems ? diagnostics.length > maxProblems : false,
+      originalTotal: diagnostics.length
+    }
+  };
+  return JSON.stringify(output, null, 2);
+}

package/src/cli/formatters/json.mjs

@@ -0,0 +1,16 @@
+export function formatJSON(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  const output = {
+    filePath,
+    diagnostics: limitedDiagnostics,
+    summary: {
+      total: limitedDiagnostics.length,
+      truncated: maxProblems ? diagnostics.length > maxProblems : false,
+      originalTotal: diagnostics.length
+    }
+  };
+  return JSON.stringify(output, null, 2);
+}

package/src/cli/formatters/stylish.cjs

@@ -0,0 +1,76 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequireDefault").default;
+exports.__esModule = true;
+exports.formatLocation = formatLocation;
+exports.formatStylish = formatStylish;
+exports.severityToString = severityToString;
+var _chalk = _interopRequireDefault(require("chalk"));
+var _vscodeLanguageserverTypes = require("vscode-languageserver-types");
+function severityToString(severity) {
+  switch (severity) {
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Error:
+      return _chalk.default.red('error');
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Warning:
+      return _chalk.default.yellow('warning');
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Information:
+      return _chalk.default.blue('info');
+    case _vscodeLanguageserverTypes.DiagnosticSeverity.Hint:
+      return _chalk.default.cyan('hint');
+    default:
+      return 'unknown';
+  }
+}
+function formatLocation(diagnostic) {
+  const line = diagnostic.range.start.line + 1;
+  const col = diagnostic.range.start.character + 1;
+  return `${line}:${col}`;
+}
+function formatStylish(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  if (limitedDiagnostics.length === 0) {
+    return '';
+  }
+  const lines = [];
+
+  // calculate max widths for alignment
+  const maxLocationLength = Math.max(...limitedDiagnostics.map(d => formatLocation(d).length));
+  const maxCodeLength = Math.max(...limitedDiagnostics.map(d => d.code ? String(d.code).length : 0));
+
+  // file path header
+  lines.push(_chalk.default.bold(filePath));
+
+  // diagnostics
+  for (const diagnostic of limitedDiagnostics) {
+    const locationStr = formatLocation(diagnostic);
+    const location = _chalk.default.dim(locationStr.padEnd(maxLocationLength));
+    const severity = severityToString(diagnostic.severity);
+    const codeStr = diagnostic.code ? String(diagnostic.code) : '';
+    const code = codeStr ? _chalk.default.cyan(codeStr.padEnd(maxCodeLength)) : ' '.repeat(maxCodeLength);
+    const message = diagnostic.message;
+    lines.push(`  ${location}  ${severity}  ${code}  ${message}`);
+  }
+
+  // summary
+  const errorCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Error).length;
+  const warningCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Warning).length;
+  const infoCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Information).length;
+  const hintCount = limitedDiagnostics.filter(d => d.severity === _vscodeLanguageserverTypes.DiagnosticSeverity.Hint).length;
+  lines.push('');
+  const parts = [];
+  if (errorCount > 0) parts.push(`${errorCount} ${errorCount === 1 ? 'error' : 'errors'}`);
+  if (warningCount > 0) parts.push(`${warningCount} ${warningCount === 1 ? 'warning' : 'warnings'}`);
+  if (infoCount > 0) parts.push(`${infoCount} ${infoCount === 1 ? 'info' : 'infos'}`);
+  if (hintCount > 0) parts.push(`${hintCount} ${hintCount === 1 ? 'hint' : 'hints'}`);
+  const symbol = errorCount > 0 ? _chalk.default.red('✖') : _chalk.default.yellow('⚠');
+  const problemText = limitedDiagnostics.length === 1 ? 'problem' : 'problems';
+  const breakdown = parts.length > 0 ? ` (${parts.join(', ')})` : '';
+  lines.push(`${symbol} ${limitedDiagnostics.length} ${problemText}${breakdown}`);
+  if (maxProblems && diagnostics.length > maxProblems) {
+    lines.push(_chalk.default.dim(`(showing ${maxProblems} of ${diagnostics.length} problems)`));
+  }
+  return lines.join('\n');
+}

package/src/cli/formatters/stylish.mjs

@@ -0,0 +1,69 @@
+import chalk from 'chalk';
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+export function severityToString(severity) {
+  switch (severity) {
+    case DiagnosticSeverity.Error:
+      return chalk.red('error');
+    case DiagnosticSeverity.Warning:
+      return chalk.yellow('warning');
+    case DiagnosticSeverity.Information:
+      return chalk.blue('info');
+    case DiagnosticSeverity.Hint:
+      return chalk.cyan('hint');
+    default:
+      return 'unknown';
+  }
+}
+export function formatLocation(diagnostic) {
+  const line = diagnostic.range.start.line + 1;
+  const col = diagnostic.range.start.character + 1;
+  return `${line}:${col}`;
+}
+export function formatStylish(filePath, diagnostics, options = {}) {
+  const {
+    maxProblems
+  } = options;
+  const limitedDiagnostics = maxProblems ? diagnostics.slice(0, maxProblems) : diagnostics;
+  if (limitedDiagnostics.length === 0) {
+    return '';
+  }
+  const lines = [];
+
+  // calculate max widths for alignment
+  const maxLocationLength = Math.max(...limitedDiagnostics.map(d => formatLocation(d).length));
+  const maxCodeLength = Math.max(...limitedDiagnostics.map(d => d.code ? String(d.code).length : 0));
+
+  // file path header
+  lines.push(chalk.bold(filePath));
+
+  // diagnostics
+  for (const diagnostic of limitedDiagnostics) {
+    const locationStr = formatLocation(diagnostic);
+    const location = chalk.dim(locationStr.padEnd(maxLocationLength));
+    const severity = severityToString(diagnostic.severity);
+    const codeStr = diagnostic.code ? String(diagnostic.code) : '';
+    const code = codeStr ? chalk.cyan(codeStr.padEnd(maxCodeLength)) : ' '.repeat(maxCodeLength);
+    const message = diagnostic.message;
+    lines.push(`  ${location}  ${severity}  ${code}  ${message}`);
+  }
+
+  // summary
+  const errorCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Error).length;
+  const warningCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Warning).length;
+  const infoCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Information).length;
+  const hintCount = limitedDiagnostics.filter(d => d.severity === DiagnosticSeverity.Hint).length;
+  lines.push('');
+  const parts = [];
+  if (errorCount > 0) parts.push(`${errorCount} ${errorCount === 1 ? 'error' : 'errors'}`);
+  if (warningCount > 0) parts.push(`${warningCount} ${warningCount === 1 ? 'warning' : 'warnings'}`);
+  if (infoCount > 0) parts.push(`${infoCount} ${infoCount === 1 ? 'info' : 'infos'}`);
+  if (hintCount > 0) parts.push(`${hintCount} ${hintCount === 1 ? 'hint' : 'hints'}`);
+  const symbol = errorCount > 0 ? chalk.red('✖') : chalk.yellow('⚠');
+  const problemText = limitedDiagnostics.length === 1 ? 'problem' : 'problems';
+  const breakdown = parts.length > 0 ? ` (${parts.join(', ')})` : '';
+  lines.push(`${symbol} ${limitedDiagnostics.length} ${problemText}${breakdown}`);
+  if (maxProblems && diagnostics.length > maxProblems) {
+    lines.push(chalk.dim(`(showing ${maxProblems} of ${diagnostics.length} problems)`));
+  }
+  return lines.join('\n');
+}