v10/site/scripts/api-docs-builder/src/utils.ts

import type { PropDef } from './types.js';

export function kebabToPascal(str: string): string {
  return str
    .split('-')
    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
    .join('');
}

/**
 * Derive the kebab-case part segment from an `index.parts.ts` source path.
 *
 * Strips the leading `'./{componentKebab}-'` prefix to get the part segment.
 * Example: `partKebabFromSource('./time-value', 'time')` -> `'value'`
 */
export function partKebabFromSource(source: string, componentKebab: string): string {
  const prefix = `./${componentKebab}-`;
  if (source.startsWith(prefix)) {
    return source.slice(prefix.length);
  }
  // Fallback: strip leading './' and the component prefix
  return source.replace(/^\.\//, '').replace(new RegExp(`^${componentKebab}-`), '');
}

export function sortProps(props: Record<string, PropDef>): Record<string, PropDef> {
  const entries = Object.entries(props);

  entries.sort((a, b) => {
    // Required first
    const aRequired = a[1].required ?? false;
    const bRequired = b[1].required ?? false;

    if (aRequired && !bRequired) return -1;
    if (!aRequired && bRequired) return 1;

    // Then alphabetical
    return a[0].localeCompare(b[0]);
  });

  return Object.fromEntries(entries);
}