/** * @fileoverview Header template builder used to generate normalized file headers. * @module fix-headers/header/template */ /** * Builds a normalized header block for a source file. * @param {{ * absoluteFilePath: string, * language?: string, * syntaxOptions?: { language?: string, enabledDetectors?: string[], disabledDetectors?: string[], forcedDetectors?: string[], detectorSyntaxOverrides?: Record, spacing?: number, margin?: number }, * projectRoot: string, * createdByName?: string, * createdByEmail?: string, * lastModifiedByName?: string, * lastModifiedByEmail?: string, * projectName: string, * authorName: string, * authorEmail: string, * createdAt: {date: string, timestamp: number}, * lastModifiedAt: {date: string, timestamp: number}, * copyrightStartYear: number, * companyName?: string | null, * currentYear: number * }} data - Header data. Without a `companyName` (null, undefined or blank), the `@Copyright` * line carries no holder: `Copyright (c) 2019-2026 All rights reserved.` * @returns {string} Header block text. */ export function buildHeader(data: { absoluteFilePath: string; language?: string; syntaxOptions?: { language?: string; enabledDetectors?: string[]; disabledDetectors?: string[]; forcedDetectors?: string[]; detectorSyntaxOverrides?: Record; spacing?: number; margin?: number; }; projectRoot: string; createdByName?: string; createdByEmail?: string; lastModifiedByName?: string; lastModifiedByEmail?: string; projectName: string; authorName: string; authorEmail: string; createdAt: { date: string; timestamp: number; }; lastModifiedAt: { date: string; timestamp: number; }; copyrightStartYear: number; companyName?: string | null; currentYear: number; }): string;