jsdoczoom 1.0.0 → 1.2.1

package/types/type-declarations.d.ts

@@ -35,6 +35,56 @@ export declare function getLanguageService(
  * @internal
  */
 export declare function resetCache(): void;
+/**
+ * Splits annotated .d.ts text into individual declaration chunks.
+ *
+ * Splits on blank-line boundaries that precede a line annotation (`// L`)
+ * or a declaration keyword (`export`, `declare`). Each chunk is a complete
+ * declaration including its preceding JSDoc comment and line annotation.
+ * Trailing whitespace is trimmed from each chunk. Empty chunks are filtered out.
+ *
+ * @param dtsText - The annotated .d.ts text to split
+ * @returns Array of declaration chunks
+ */
+export declare function splitDeclarations(dtsText: string): string[];
+/** A single top-level source block with its line annotation. */
+export interface SourceBlock {
+	annotation: string;
+	blockText: string;
+}
+/**
+ * Extracts all top-level source blocks from a TypeScript file.
+ * Walks all top-level statements (not just exported), includes leading
+ * JSDoc comments, and annotates each block with source line references.
+ * Import declarations are excluded.
+ *
+ * Returns an empty array for empty files.
+ *
+ * @param filePath - Absolute path to the TypeScript source file
+ * @param content - Pre-read file content (avoids redundant disk read)
+ */
+export declare function extractAllSourceBlocks(
+	filePath: string,
+	content: string,
+): SourceBlock[];
+/**
+ * Extracts top-level source blocks from a file that match a regex.
+ *
+ * Walks all top-level statements (not just exported ones), includes leading
+ * JSDoc comments, and tests the regex against each block's source text.
+ * Matching blocks are annotated with `// LN` or `// LN-LM` and joined with
+ * blank line separators.
+ *
+ * @param filePath - Absolute path to the TypeScript source file
+ * @param content - Pre-read file content (avoids redundant disk read)
+ * @param regex - Regular expression to test against each block's source text
+ * @returns Annotated matching blocks joined with blank lines, or null if no match
+ */
+export declare function extractSourceBlocks(
+	filePath: string,
+	content: string,
+	regex: RegExp,
+): string | null;
 /**
  * Generates TypeScript declaration output from a source file.
  *
@@ -54,4 +104,6 @@ export declare function resetCache(): void;
  * @returns The declaration output as a string
  * @throws {JsdocError} If the file cannot be read or parsed
  */
-export declare function generateTypeDeclarations(filePath: string): string;
+export declare function generateTypeDeclarations(
+	filePath: string,
+): Promise<string>;