Function lint

packages/cli/src/linter/lint.ts:56–111

(content: string, options?: LintOptions)

 * @throws If parsing or model resolution fails unrecoverably
 */
export function lint(content: string, options?: LintOptions): LintReport {
  const parser = new ParserHandler();
  const model = new ModelHandler();
  const tailwind = new TailwindEmitterHandler();

  const parseResult = parser.execute({ content });

  // Handle parse failures gracefully
  if (!parseResult.success) {
    // For recoverable errors (e.g. no YAML found), return a report
    // with an empty design system and a finding instead of throwing.
    if (parseResult.error.recoverable) {
      const emptyParsed: ParsedDesignSystem = { sourceMap: new Map() };
      const { designSystem } = model.execute(emptyParsed);

      // Still extract sections from the raw content even without YAML
      const sections = extractSectionsFromContent(content);

      return {
        designSystem,
        findings: [{
          severity: 'warning',
          message: parseResult.error.message,
        }],
        summary: { errors: 0, warnings: 1, infos: 0 },
        tailwindConfig: tailwind.execute(designSystem),
        sections: sections.map(s => s.heading).filter(Boolean),
        documentSections: sections,
      };
    }

    // Non-recoverable errors are still fatal
    throw new Error(`Parse failed: ${parseResult.error.message}`);
  }

  const { designSystem, findings: modelFindings } = model.execute(parseResult.data);
  const lintResult = runLinter(designSystem, options?.rules);
  const tailwindConfig = tailwind.execute(designSystem);

  const findings = [...modelFindings, ...lintResult.findings];
  const summary = {
    errors: modelFindings.filter((d) => d.severity === 'error').length + lintResult.summary.errors,
    warnings: modelFindings.filter((d) => d.severity === 'warning').length + lintResult.summary.warnings,
    infos: modelFindings.filter((d) => d.severity === 'info').length + lintResult.summary.infos,
  };

  return {
    designSystem,
    findings,
    summary,
    tailwindConfig,
    sections: parseResult.data.sections ?? [],
    documentSections: parseResult.data.documentSections ?? [],
  };

}

/**