utils.js

// /utils.js

// Formats milliseconds into a human-readable duration string.
export function formatDuration(ms) {
  if (ms < 1000) {
    return `${Math.round(ms)}ms`;
  }
  const seconds = ms / 1000;
  if (seconds < 60) {
    return `${seconds.toFixed(1)}s`;
  }
  const minutes = Math.floor(seconds / 60);
  const remainingSeconds = (seconds % 60).toFixed(0);
  return `${minutes}m ${remainingSeconds}s`;
}

// Formats milliseconds into compact elapsed time for checkpoints.
export function formatElapsed(ms) {
  const seconds = Math.round(ms / 1000);
  if (seconds < 60) {
    return `${seconds}s`;
  }
  const minutes = Math.floor(seconds / 60);
  const remainingSeconds = seconds % 60;
  if (remainingSeconds === 0) {
    return `${minutes}m`;
  }
  return `${minutes}m ${remainingSeconds}s`;
}

// Truncates text to a max length with ellipsis.
export function truncateText(text, maxLength = 50) {
  if (text.length <= maxLength) {
    return text;
  }
  return text.slice(0, maxLength - 3) + '...';
}

// Copies text to clipboard.
export async function copyToClipboard(text) {
  try {
    await navigator.clipboard.writeText(text);
    return true;
  } catch (err) {
    console.error('Failed to copy to clipboard:', err);
    return false;
  }
}

// Downloads content as a file.
export function downloadFile(content, filename, mimeType = 'text/plain') {
  const blob = new Blob([content], { type: mimeType });
  const url = URL.createObjectURL(blob);
  const link = document.createElement('a');
  link.href = url;
  link.download = filename;
  document.body.appendChild(link);
  link.click();
  document.body.removeChild(link);
  URL.revokeObjectURL(url);
}

// Gets the file extension for an export format.
export function getExportExtension(format) {
  const extensions = {
    plaintext: 'txt',
    json: 'json',
    xml: 'xml',
    xmltags: 'xml',
    markdown: 'md'
  };
  return extensions[format] || 'txt';
}

// Gets the MIME type for an export format.
export function getExportMimeType(format) {
  const mimeTypes = {
    plaintext: 'text/plain',
    json: 'application/json',
    xml: 'application/xml',
    xmltags: 'text/plain',
    markdown: 'text/markdown'
  };
  return mimeTypes[format] || 'text/plain';
}