chore(types): regenerate stale declarations for .gitignore support (v1.3.0)

types/src/constants.d.mts

@@ -1,7 +1,27 @@
 /** @type {string} */
 export const DEFAULT_COMPANY_NAME: string;
-/** @type {number} */
+/** Header must sit near the top of the file, but a metadata block can legitimately
+ *	run long; cap the scan generously so a long block's closing `*​/` is still seen.
+ * @type {number} */
 export const DEFAULT_MAX_HEADER_SCAN_LINES: number;
-/** @type {Set<string>} */
+/**
+ * Folders skipped at ANY depth — vendored / VCS directories that are never source and can
+ * legitimately nest (hoisted `node_modules`, submodule `.git`).
+ * @type {Set<string>}
+ */
+export const ALWAYS_IGNORE_FOLDERS: Set<string>;
+/**
+ * Folders skipped ONLY at the project root — build / cache output directories. Anchored to
+ * the root so a nested SOURCE directory that happens to share the name (e.g. `tools/build`,
+ * `packages/x/dist`-style source) is still processed; only the top-level `/build`, `/dist`,
+ * `/coverage`, … are ignored.
+ * @type {Set<string>}
+ */
+export const ROOT_IGNORE_FOLDERS: Set<string>;
+/**
+ * Backward-compatible union of {@link ALWAYS_IGNORE_FOLDERS} and {@link ROOT_IGNORE_FOLDERS}.
+ * Discovery applies the two sets with different scoping; prefer the specific sets.
+ * @type {Set<string>}
+ */
 export const DEFAULT_IGNORE_FOLDERS: Set<string>;
 export { DETECTOR_PROFILES, getAllowedExtensions, getEnabledDetectors } from "./detectors/index.mjs";

types/src/core/file-discovery.d.mts

@@ -7,8 +7,10 @@
  *  enabledDetectors?: string[],
  *  disabledDetectors?: string[],
  *  includeFolders?: string[],
- *  excludeFolders?: string[]
- * }} options - File discovery options.
+ *  excludeFolders?: string[],
+ *  gitignore?: boolean | string | string[]
+ * }} options - File discovery options. `gitignore`: `false` disables; a path or array of
+ *  paths loads those ignore files; anything else / omitted auto-detects `<projectRoot>/.gitignore`.
  * @returns {Promise<string[]>} Absolute file paths.
  */
 export function discoverFiles(options: {
@@ -19,4 +21,5 @@ export function discoverFiles(options: {
     disabledDetectors?: string[];
     includeFolders?: string[];
     excludeFolders?: string[];
+    gitignore?: boolean | string | string[];
 }): Promise<string[]>;

types/src/core/fix-headers.d.mts

@@ -28,6 +28,7 @@ export type FixHeadersOptions = {
     includeFolders?: string[];
     excludeFolders?: string[];
     includeExtensions?: string[];
+    gitignore?: boolean | string | string[];
     projectName?: string;
     language?: string;
     projectRoot?: string;

types/src/detectors/index.d.mts

@@ -26,13 +26,14 @@ export function getDetectorById(id: string): (typeof DETECTOR_PROFILES)[number]
 /**
  * Resolves comment syntax for a file path using detector-specific templates.
  * @param {string} filePath - File path.
- * @param {{ language?: string, enabledDetectors?: string[], disabledDetectors?: string[], detectorSyntaxOverrides?: Record<string, { linePrefix?: string, lineSeparator?: string, blockStart?: string, blockLinePrefix?: string, blockEnd?: string }> }} [options={}] - Runtime options.
+ * @param {{ language?: string, enabledDetectors?: string[], disabledDetectors?: string[], detectors?: DetectorProfile[], detectorSyntaxOverrides?: Record<string, { linePrefix?: string, lineSeparator?: string, blockStart?: string, blockLinePrefix?: string, blockEnd?: string }> }} [options={}] - Runtime options. `detectors` overrides the enabled-detector set (matching {@link detectProjectFromMarkers}).
  * @returns {{kind: "block" | "line" | "html", linePrefix?: string, lineSeparator?: string, blockStart?: string, blockLinePrefix?: string, blockEnd?: string}} Syntax descriptor.
  */
 export function getCommentSyntaxForFile(filePath: string, options?: {
     language?: string;
     enabledDetectors?: string[];
     disabledDetectors?: string[];
+    detectors?: DetectorProfile[];
     detectorSyntaxOverrides?: Record<string, {
         linePrefix?: string;
         lineSeparator?: string;