@fuzdev/fuz_ui 0.193.1 → 0.195.0

package/dist/svelte_helpers.d.ts

@@ -1,92 +0,0 @@
-/**
- * Svelte component analysis helpers.
- *
- * Extracts metadata from Svelte components using svelte2tsx transformations:
- *
- * - Component props with types and JSDoc
- * - Component-level documentation
- * - Type information
- *
- * Workflow: Transform Svelte to TypeScript via svelte2tsx, parse the transformed
- * TypeScript with the TS Compiler API, extract component-level JSDoc from original source.
- *
- * **Svelte 5 only**: The svelte2tsx output format changed significantly between versions.
- * This module requires Svelte 5+ and will throw a clear error if an older version is detected.
- * There is no Svelte 4 compatibility layer.
- *
- * All functions are prefixed with `svelte_` for clarity.
- *
- * @module
- */
-import ts from 'typescript';
-import { TraceMap } from '@jridgewell/trace-mapping';
-import type { DeclarationJson } from '@fuzdev/fuz_util/source_json.js';
-import { type SourceFileInfo, type ModuleSourceOptions } from './module_helpers.js';
-import type { AnalysisContext } from './analysis_context.js';
-import type { ModuleAnalysis } from './library_analysis.js';
-/** Result of analyzing a Svelte file. */
-export interface SvelteFileAnalysis {
-    /** The component declaration metadata. */
-    declaration: DeclarationJson;
-    /** Module-level documentation comment, if present. */
-    module_comment?: string;
-}
-/**
- * Analyze a Svelte component file and extract module metadata.
- *
- * Wraps `svelte_analyze_file` and adds dependency information
- * from the source file info if available.
- *
- * This is a high-level function suitable for building documentation or library metadata.
- * For lower-level analysis, use `svelte_analyze_file` directly.
- *
- * Returns raw analysis data matching `ModuleAnalysis` structure.
- * Consumer decides filtering policy (Svelte components are never nodocs).
- *
- * @param source_file - the source file info (from Gro filer, file system, or other source)
- * @param module_path - the module path (relative to source root)
- * @param checker - TypeScript type checker
- * @param options - module source options for path extraction
- * @param ctx - analysis context for collecting diagnostics
- * @returns module analysis matching `ModuleAnalysis` structure
- */
-export declare const svelte_analyze_module: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleAnalysis;
-/**
- * Analyze a Svelte component file.
- *
- * This is a high-level function that handles the complete workflow:
- * 1. Transform Svelte source to TypeScript via svelte2tsx
- * 2. Extract component metadata (props, documentation)
- * 3. Extract module-level documentation
- *
- * Suitable for use in documentation generators, build tools, and analysis.
- *
- * @param source_file - source file info with path and content
- * @param module_path - module path relative to source root (e.g., 'Alert.svelte')
- * @param checker - TypeScript type checker for type resolution
- * @param ctx - analysis context for collecting diagnostics
- * @returns component declaration and optional module-level comment
- */
-export declare const svelte_analyze_file: (source_file: SourceFileInfo, module_path: string, checker: ts.TypeChecker, ctx: AnalysisContext) => SvelteFileAnalysis;
-/**
- * Analyze a Svelte component from its svelte2tsx transformation.
- */
-export declare const svelte_analyze_component: (ts_code: string, source_file: ts.SourceFile, checker: ts.TypeChecker, component_name: string, file_path: string, source_map: TraceMap | null, ctx: AnalysisContext) => DeclarationJson;
-/**
- * Extract the content of the main `<script>` tag from Svelte source.
- *
- * Matches `<script>` or `<script lang="ts">` but not `<script module>`.
- * Returns undefined if no matching script tag is found.
- */
-export declare const svelte_extract_script_content: (svelte_source: string) => string | undefined;
-/**
- * Extract module-level comment from Svelte script content.
- *
- * Requires `@module` tag to identify module comments. The tag line is stripped
- * from the output.
- *
- * @param script_content - the content of the `<script>` tag
- * @returns the cleaned module comment text, or undefined if none found
- */
-export declare const svelte_extract_module_comment: (script_content: string) => string | undefined;
-//# sourceMappingURL=svelte_helpers.d.ts.map

package/dist/svelte_helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"svelte_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/svelte_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,OAAO,EAAC,QAAQ,EAAsB,MAAM,2BAA2B,CAAC;AAExE,OAAO,KAAK,EAAC,eAAe,EAAoB,MAAM,iCAAiC,CAAC;AAIxF,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAGxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAqB1D,yCAAyC;AACzC,MAAM,WAAW,kBAAkB;IAClC,0CAA0C;IAC1C,WAAW,EAAE,eAAe,CAAC;IAC7B,sDAAsD;IACtD,cAAc,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,qBAAqB,GACjC,aAAa,cAAc,EAC3B,aAAa,MAAM,EACnB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,KAAK,eAAe,KAClB,cAiBF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,GAC/B,aAAa,cAAc,EAC3B,aAAa,MAAM,EACnB,SAAS,EAAE,CAAC,WAAW,EACvB,KAAK,eAAe,KAClB,kBAqDF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACpC,SAAS,MAAM,EACf,aAAa,EAAE,CAAC,UAAU,EAC1B,SAAS,EAAE,CAAC,WAAW,EACvB,gBAAgB,MAAM,EACtB,WAAW,MAAM,EACjB,YAAY,QAAQ,GAAG,IAAI,EAC3B,KAAK,eAAe,KAClB,eA0CF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GAAI,eAAe,MAAM,KAAG,MAAM,GAAG,SAM9E,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,GAAI,gBAAgB,MAAM,KAAG,MAAM,GAAG,SAU/E,CAAC"}

package/dist/svelte_helpers.js

@@ -1,367 +0,0 @@
-/**
- * Svelte component analysis helpers.
- *
- * Extracts metadata from Svelte components using svelte2tsx transformations:
- *
- * - Component props with types and JSDoc
- * - Component-level documentation
- * - Type information
- *
- * Workflow: Transform Svelte to TypeScript via svelte2tsx, parse the transformed
- * TypeScript with the TS Compiler API, extract component-level JSDoc from original source.
- *
- * **Svelte 5 only**: The svelte2tsx output format changed significantly between versions.
- * This module requires Svelte 5+ and will throw a clear error if an older version is detected.
- * There is no Svelte 4 compatibility layer.
- *
- * All functions are prefixed with `svelte_` for clarity.
- *
- * @module
- */
-import ts from 'typescript';
-import { svelte2tsx } from 'svelte2tsx';
-import { TraceMap, originalPositionFor } from '@jridgewell/trace-mapping';
-import { VERSION } from 'svelte/compiler';
-import { tsdoc_parse, tsdoc_apply_to_declaration } from './tsdoc_helpers.js';
-import { ts_extract_module_comment } from './ts_helpers.js';
-import { module_get_component_name, module_extract_dependencies, } from './module_helpers.js';
-/** Guard to ensure version check runs only once. */
-let svelte_version_checked = false;
-/**
- * Assert Svelte 5+ is installed (lazy, runs once on first use).
- * Throws a clear error message if an older version is detected.
- */
-const svelte_assert_version = () => {
-    if (svelte_version_checked)
-        return;
-    svelte_version_checked = true;
-    const [major] = VERSION.split('.');
-    if (parseInt(major, 10) < 5) {
-        throw new Error(`Svelte ${VERSION} detected but Svelte 5+ is required for source analysis. ` +
-            `The svelte2tsx output format changed significantly between versions.`);
-    }
-};
-/**
- * Analyze a Svelte component file and extract module metadata.
- *
- * Wraps `svelte_analyze_file` and adds dependency information
- * from the source file info if available.
- *
- * This is a high-level function suitable for building documentation or library metadata.
- * For lower-level analysis, use `svelte_analyze_file` directly.
- *
- * Returns raw analysis data matching `ModuleAnalysis` structure.
- * Consumer decides filtering policy (Svelte components are never nodocs).
- *
- * @param source_file - the source file info (from Gro filer, file system, or other source)
- * @param module_path - the module path (relative to source root)
- * @param checker - TypeScript type checker
- * @param options - module source options for path extraction
- * @param ctx - analysis context for collecting diagnostics
- * @returns module analysis matching `ModuleAnalysis` structure
- */
-export const svelte_analyze_module = (source_file, module_path, checker, options, ctx) => {
-    // Use the existing helper for core analysis
-    const { declaration, module_comment } = svelte_analyze_file(source_file, module_path, checker, ctx);
-    // Extract dependencies and dependents if provided
-    const { dependencies, dependents } = module_extract_dependencies(source_file, options);
-    return {
-        path: module_path,
-        module_comment,
-        // Wrap declaration in DeclarationAnalysis format (Svelte components are never nodocs)
-        declarations: [{ declaration, nodocs: false }],
-        dependencies,
-        dependents,
-        star_exports: [],
-        re_exports: [],
-    };
-};
-/**
- * Analyze a Svelte component file.
- *
- * This is a high-level function that handles the complete workflow:
- * 1. Transform Svelte source to TypeScript via svelte2tsx
- * 2. Extract component metadata (props, documentation)
- * 3. Extract module-level documentation
- *
- * Suitable for use in documentation generators, build tools, and analysis.
- *
- * @param source_file - source file info with path and content
- * @param module_path - module path relative to source root (e.g., 'Alert.svelte')
- * @param checker - TypeScript type checker for type resolution
- * @param ctx - analysis context for collecting diagnostics
- * @returns component declaration and optional module-level comment
- */
-export const svelte_analyze_file = (source_file, module_path, checker, ctx) => {
-    svelte_assert_version();
-    const svelte_source = source_file.content;
-    // Check if component uses TypeScript
-    const is_ts_file = svelte_source.includes('lang="ts"');
-    // Transform Svelte to TS
-    const ts_result = svelte2tsx(svelte_source, {
-        filename: source_file.id,
-        isTsFile: is_ts_file,
-        emitOnTemplateError: true, // Handle malformed templates gracefully
-    });
-    // Create source map for position mapping back to original .svelte file
-    let source_map = null;
-    try {
-        // svelte2tsx returns a magic-string SourceMap which is compatible with TraceMap
-        // Cast to unknown first since the types don't perfectly align but are compatible
-        source_map = new TraceMap(ts_result.map);
-    }
-    catch (_error) {
-        // If source map parsing fails, diagnostics will use virtual file positions
-    }
-    // Get component name from filename
-    const component_name = module_get_component_name(module_path);
-    // Create a temporary source file from the original Svelte content for JSDoc extraction
-    const temp_source = ts.createSourceFile(source_file.id, svelte_source, ts.ScriptTarget.Latest, true);
-    // Analyze the component using the existing lower-level function
-    const declaration = svelte_analyze_component(ts_result.code, temp_source, checker, component_name, module_path, source_map, ctx);
-    // Extract module-level comment from the script content
-    const script_content = svelte_extract_script_content(svelte_source);
-    const module_comment = script_content ? svelte_extract_module_comment(script_content) : undefined;
-    return { declaration, module_comment };
-};
-/**
- * Analyze a Svelte component from its svelte2tsx transformation.
- */
-export const svelte_analyze_component = (ts_code, source_file, checker, component_name, file_path, source_map, ctx) => {
-    const result = {
-        name: component_name,
-        kind: 'component',
-    };
-    try {
-        // Create a virtual source file from the svelte2tsx output
-        // svelte2tsx generates plain TypeScript (not TSX/JSX)
-        const virtual_source = ts.createSourceFile(source_file.fileName + '.ts', ts_code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
-        // Extract component-level TSDoc from svelte2tsx transformed output
-        const component_tsdoc = svelte_extract_component_tsdoc(virtual_source);
-        tsdoc_apply_to_declaration(result, component_tsdoc);
-        // Extract props from svelte2tsx transformed output
-        const props = svelte_extract_props(virtual_source, checker, component_name, file_path, source_map, ctx);
-        if (props.length > 0) {
-            result.props = props;
-        }
-        // Extract source line from original file
-        const start_pos = source_file.getLineAndCharacterOfPosition(0);
-        result.source_line = start_pos.line + 1;
-    }
-    catch (error) {
-        throw new Error(`Failed to analyze Svelte component ${component_name}`, { cause: error });
-    }
-    return result;
-};
-/**
- * Extract the content of the main `<script>` tag from Svelte source.
- *
- * Matches `<script>` or `<script lang="ts">` but not `<script module>`.
- * Returns undefined if no matching script tag is found.
- */
-export const svelte_extract_script_content = (svelte_source) => {
-    // Match <script> or <script lang="ts"> but not <script module>
-    // Captures the content between opening and closing tags
-    const script_regex = /<script(?:\s+lang=["']ts["'])?(?:\s*)>([^]*?)<\/script>/i;
-    const match = script_regex.exec(svelte_source);
-    return match?.[1];
-};
-/**
- * Extract module-level comment from Svelte script content.
- *
- * Requires `@module` tag to identify module comments. The tag line is stripped
- * from the output.
- *
- * @param script_content - the content of the `<script>` tag
- * @returns the cleaned module comment text, or undefined if none found
- */
-export const svelte_extract_module_comment = (script_content) => {
-    // Parse the script content as TypeScript and reuse the shared extraction logic
-    const source_file = ts.createSourceFile('script.ts', script_content, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
-    return ts_extract_module_comment(source_file);
-};
-/**
- * Extract component-level TSDoc comment from svelte2tsx transformed output.
- *
- * svelte2tsx places component-level JSDoc inside the $$render() function,
- * attached to a variable statement (usually before the props destructuring).
- * This function searches the AST recursively to find it.
- */
-const svelte_extract_component_tsdoc = (source_file) => {
-    let found_tsdoc = undefined;
-    // Recursively search for component-level JSDoc
-    function visit(node) {
-        if (found_tsdoc)
-            return; // Already found, stop searching
-        // Skip PropertySignature nodes - those are prop-level JSDoc, not component-level
-        if (ts.isPropertySignature(node)) {
-            return; // Don't recurse into property signatures
-        }
-        // Check for JSDoc on VariableStatement or VariableDeclaration
-        // Component-level JSDoc is attached to these node types
-        if (ts.isVariableStatement(node) || ts.isVariableDeclaration(node)) {
-            const tsdoc = tsdoc_parse(node, source_file);
-            if (tsdoc) {
-                found_tsdoc = tsdoc;
-                return;
-            }
-        }
-        // Continue searching child nodes
-        ts.forEachChild(node, visit);
-    }
-    visit(source_file);
-    return found_tsdoc;
-};
-/**
- * Extract prop info from a property signature member.
- */
-const svelte_extract_prop_from_member = (member, source_file, checker, component_name, file_path, source_map, ctx) => {
-    if (!ts.isIdentifier(member.name))
-        return undefined;
-    const prop_name = member.name.text;
-    const optional = !!member.questionToken;
-    // Get type string
-    let type_string = 'any';
-    if (member.type) {
-        type_string = member.type.getText(source_file);
-    }
-    else {
-        // Try to get type from type checker
-        try {
-            const prop_type = checker.getTypeAtLocation(member);
-            type_string = checker.typeToString(prop_type);
-        }
-        catch (err) {
-            // Fallback to 'any' but report diagnostic with mapped position
-            const { line, character } = source_file.getLineAndCharacterOfPosition(member.getStart());
-            // Map virtual position back to original .svelte file if source map available
-            let final_line = line + 1;
-            let final_column = character + 1;
-            if (source_map) {
-                const original = originalPositionFor(source_map, { line: line + 1, column: character });
-                // When line is found, column is guaranteed to be present (same mapping entry)
-                if (original.line !== null) {
-                    final_line = original.line;
-                    final_column = original.column + 1;
-                }
-            }
-            ctx.add({
-                kind: 'svelte_prop_failed',
-                file: file_path,
-                line: final_line,
-                column: final_column,
-                message: `Failed to resolve type for prop "${prop_name}" in ${component_name}, falling back to 'any': ${err instanceof Error ? err.message : String(err)}`,
-                severity: 'warning',
-                component_name,
-                prop_name,
-            });
-        }
-    }
-    // Extract TSDoc description
-    let description;
-    const tsdoc = tsdoc_parse(member, source_file);
-    if (tsdoc) {
-        description = tsdoc.text;
-    }
-    // Extract default value (if available in TSDoc or initializer)
-    let default_value;
-    const default_match = description?.match(/@default\s+(.+)/);
-    if (default_match) {
-        default_value = default_match[1].trim();
-    }
-    return {
-        name: prop_name,
-        type: type_string,
-        ...(optional && { optional }),
-        description,
-        default_value,
-    };
-};
-/**
- * Extract bindable prop names from svelte2tsx transformed output.
- *
- * svelte2tsx marks bindable props with `__sveltets_$$bindings('prop1', 'prop2', ...)`.
- * This function extracts those prop names.
- */
-const svelte_extract_bindable_props = (virtual_source) => {
-    const bindable_props = new Set();
-    // Search for __sveltets_$$bindings call
-    function visit(node) {
-        if (ts.isCallExpression(node)) {
-            const expr = node.expression;
-            if (ts.isIdentifier(expr) && expr.text === '__sveltets_$$bindings') {
-                // Extract string literal arguments
-                for (const arg of node.arguments) {
-                    if (ts.isStringLiteral(arg)) {
-                        bindable_props.add(arg.text);
-                    }
-                }
-            }
-        }
-        ts.forEachChild(node, visit);
-    }
-    visit(virtual_source);
-    return bindable_props;
-};
-/**
- * Extract props from a type node (handles type literals and intersection types).
- *
- * @mutates props - adds extracted prop info to the array
- */
-const svelte_extract_props_from_type = (type_node, virtual_source, checker, bindable_props, props, component_name, file_path, source_map, ctx) => {
-    if (ts.isTypeLiteralNode(type_node)) {
-        // Handle direct type literal: { prop1: type1, prop2: type2 }
-        for (const member of type_node.members) {
-            if (ts.isPropertySignature(member)) {
-                const prop_info = svelte_extract_prop_from_member(member, virtual_source, checker, component_name, file_path, source_map, ctx);
-                if (prop_info) {
-                    // Mark as bindable if found in bindings
-                    if (bindable_props.has(prop_info.name)) {
-                        prop_info.bindable = true;
-                    }
-                    props.push(prop_info);
-                }
-            }
-        }
-    }
-    else if (ts.isIntersectionTypeNode(type_node)) {
-        // Handle intersection type: TypeA & TypeB & { prop: type }
-        for (const type_part of type_node.types) {
-            svelte_extract_props_from_type(type_part, virtual_source, checker, bindable_props, props, component_name, file_path, source_map, ctx);
-        }
-    }
-    // Skip other type references like SvelteHTMLElements['details'] since we can't easily resolve them
-};
-/**
- * Extract props from svelte2tsx transformed output.
- *
- * svelte2tsx generates a `$$ComponentProps` type alias containing the component props.
- * This function extracts prop metadata from that type.
- */
-const svelte_extract_props = (virtual_source, checker, component_name, file_path, source_map, ctx) => {
-    const props = [];
-    const bindable_props = svelte_extract_bindable_props(virtual_source);
-    // Look for $$ComponentProps type alias or Props interface
-    ts.forEachChild(virtual_source, (node) => {
-        // Check for type alias ($$ComponentProps)
-        if (ts.isTypeAliasDeclaration(node) && node.name.text === '$$ComponentProps') {
-            svelte_extract_props_from_type(node.type, virtual_source, checker, bindable_props, props, component_name, file_path, source_map, ctx);
-        }
-        // Also check for Props interface (fallback/older format)
-        else if (ts.isInterfaceDeclaration(node) && node.name.text === 'Props') {
-            for (const member of node.members) {
-                if (ts.isPropertySignature(member)) {
-                    const prop_info = svelte_extract_prop_from_member(member, virtual_source, checker, component_name, file_path, source_map, ctx);
-                    if (prop_info) {
-                        // Mark as bindable if found in bindings
-                        if (bindable_props.has(prop_info.name)) {
-                            prop_info.bindable = true;
-                        }
-                        props.push(prop_info);
-                    }
-                }
-            }
-        }
-    });
-    return props;
-};

package/dist/ts_helpers.d.ts

@@ -1,181 +0,0 @@
-/**
- * TypeScript compiler API helpers for extracting metadata from source code.
- *
- * All functions are prefixed with `ts_` for clarity.
- *
- * @module
- */
-import ts from 'typescript';
-import type { DeclarationJson, DeclarationKind } from '@fuzdev/fuz_util/source_json.js';
-import type { Logger } from '@fuzdev/fuz_util/log.js';
-import { tsdoc_parse } from './tsdoc_helpers.js';
-import { type ModuleSourceOptions, type SourceFileInfo } from './module_helpers.js';
-import type { AnalysisContext } from './analysis_context.js';
-import type { DeclarationAnalysis, ReExportInfo, ModuleAnalysis } from './library_analysis.js';
-/**
- * Options for creating a TypeScript program.
- */
-export interface TsProgramOptions {
-    /** Project root directory. @default './' */
-    root?: string;
-    /** Path to `tsconfig.json` (relative to root). @default 'tsconfig.json' */
-    tsconfig?: string;
-    /** Override compiler options. */
-    compiler_options?: ts.CompilerOptions;
-}
-/**
- * Result of creating a TypeScript program.
- */
-export interface TsProgram {
-    program: ts.Program;
-    checker: ts.TypeChecker;
-}
-/**
- * Result of analyzing a module's exports.
- */
-export interface ModuleExportsAnalysis {
-    /** Module-level documentation comment. */
-    module_comment?: string;
-    /** All exported declarations with nodocs flags - consumer filters based on policy. */
-    declarations: Array<DeclarationAnalysis>;
-    /** Same-name re-exports (for building `also_exported_from` in post-processing). */
-    re_exports: Array<ReExportInfo>;
-    /** Star exports (`export * from './module'`) - module paths that are fully re-exported. */
-    star_exports: Array<string>;
-}
-/**
- * Create TypeScript program for analysis.
- *
- * @param options - configuration options for program creation
- * @param log - optional logger for info messages
- * @returns the program and type checker
- * @throws Error if `tsconfig.json` is not found
- */
-export declare const ts_create_program: (options?: TsProgramOptions, log?: Logger) => TsProgram;
-/**
- * Analyze a TypeScript file and extract module metadata.
- *
- * Wraps `ts_analyze_module_exports` and adds dependency information
- * from the source file info if available.
- *
- * This is a high-level function suitable for building documentation or library metadata.
- * For lower-level analysis, use `ts_analyze_module_exports` directly.
- *
- * @param source_file_info - the source file info (from Gro filer, file system, or other source)
- * @param ts_source_file - TypeScript source file from the program
- * @param module_path - the module path (relative to source root)
- * @param checker - TypeScript type checker
- * @param options - module source options for path extraction
- * @param ctx - analysis context for collecting diagnostics
- * @returns module metadata and re-export information
- */
-export declare const ts_analyze_module: (source_file_info: SourceFileInfo, ts_source_file: ts.SourceFile, module_path: string, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleAnalysis;
-/**
- * Analyze all exports from a TypeScript source file.
- *
- * Extracts the module-level comment and all exported declarations with
- * complete metadata. Handles re-exports by:
- * - Same-name re-exports: tracked in `re_exports` for `also_exported_from` building
- * - Renamed re-exports: included as new declarations with `alias_of` metadata
- * - Star exports (`export * from`): tracked in `star_exports` for namespace-level info
- *
- * This is a mid-level function (above `ts_extract_*`, below `library_gen`)
- * suitable for building documentation, API explorers, or analysis tools.
- * For standard SvelteKit library layouts, use `module_create_source_options(process.cwd())`.
- *
- * @param source_file - the TypeScript source file to analyze
- * @param checker - the TypeScript type checker
- * @param options - module source options for path extraction in re-exports
- * @param ctx - analysis context for collecting diagnostics
- * @returns module comment, declarations, re-exports, and star exports
- */
-export declare const ts_analyze_module_exports: (source_file: ts.SourceFile, checker: ts.TypeChecker, options: ModuleSourceOptions, ctx: AnalysisContext) => ModuleExportsAnalysis;
-/**
- * Analyze a TypeScript symbol and extract rich metadata.
- *
- * This is a high-level function that combines TSDoc parsing with TypeScript
- * type analysis to produce complete declaration metadata. Suitable for use
- * in documentation generators, IDE integrations, and other tooling.
- *
- * @param symbol - the TypeScript symbol to analyze
- * @param source_file - the source file containing the symbol
- * @param checker - the TypeScript type checker
- * @param ctx - optional analysis context for collecting diagnostics
- * @returns complete declaration metadata including docs, types, and parameters, plus nodocs flag
- */
-export declare const ts_analyze_declaration: (symbol: ts.Symbol, source_file: ts.SourceFile, checker: ts.TypeChecker, ctx: AnalysisContext) => DeclarationAnalysis;
-/**
- * Extract module-level comment.
- *
- * Requires `@module` tag to identify module comments. The tag line is stripped
- * from the output. Supports optional module renaming: `@module custom-name`.
- *
- * @see {@link https://typedoc.org/documents/Tags._module.html}
- */
-export declare const ts_extract_module_comment: (source_file: ts.SourceFile) => string | undefined;
-/**
- * Infer declaration kind from symbol and node.
- *
- * Maps TypeScript constructs to `DeclarationKind`:
- * - Classes → `'class'`
- * - Functions (declarations, expressions, arrows) → `'function'`
- * - Interfaces, type aliases → `'type'`
- * - Enums (regular and const) → `'type'`
- * - Variables → `'variable'` (unless function-valued → `'function'`)
- */
-export declare const ts_infer_declaration_kind: (symbol: ts.Symbol, node: ts.Node) => DeclarationKind;
-/**
- * Extract parameters from a TypeScript signature with TSDoc descriptions and default values.
- *
- * Shared helper for extracting parameter information from both standalone functions
- * and class methods/constructors.
- *
- * @param sig - the TypeScript signature to extract parameters from
- * @param checker - TypeScript type checker for type resolution
- * @param tsdoc_params - map of parameter names to TSDoc descriptions (from tsdoc.params)
- * @returns array of parameter info objects
- */
-export declare const ts_extract_signature_parameters: (sig: ts.Signature, checker: ts.TypeChecker, tsdoc_params: Map<string, string> | undefined) => Array<{
-    name: string;
-    type: string;
-    optional?: boolean;
-    description?: string;
-    default_value?: string;
-}>;
-/**
- * Extract function/method information including parameters
- * with descriptions and default values.
- *
- * @internal Use `ts_analyze_declaration` for high-level analysis.
- * @mutates declaration - adds type_signature, return_type, return_description, throws, since, parameters, generic_params
- */
-export declare const ts_extract_function_info: (node: ts.Node, symbol: ts.Symbol, checker: ts.TypeChecker, declaration: DeclarationJson, tsdoc: ReturnType<typeof tsdoc_parse>, ctx: AnalysisContext) => void;
-/**
- * Extract type/interface information with rich property metadata.
- *
- * @internal Use `ts_analyze_declaration` for high-level analysis.
- * @mutates declaration - adds type_signature, generic_params, extends, properties
- */
-export declare const ts_extract_type_info: (node: ts.Node, _symbol: ts.Symbol, checker: ts.TypeChecker, declaration: DeclarationJson, ctx: AnalysisContext) => void;
-/**
- * Extract class information with rich member metadata.
- *
- * @internal Use `ts_analyze_declaration` for high-level analysis.
- * @mutates declaration - adds extends, implements, generic_params, members
- */
-export declare const ts_extract_class_info: (node: ts.Node, _symbol: ts.Symbol, checker: ts.TypeChecker, declaration: DeclarationJson, ctx: AnalysisContext) => void;
-/**
- * Extract variable information.
- *
- * @internal Use `ts_analyze_declaration` for high-level analysis.
- * @mutates declaration - adds type_signature
- */
-export declare const ts_extract_variable_info: (node: ts.Node, symbol: ts.Symbol, checker: ts.TypeChecker, declaration: DeclarationJson, ctx: AnalysisContext) => void;
-/**
- * TypeScript modifier keywords extracted from declarations.
- *
- * These are the access modifiers and other keywords that can appear
- * on class members, interface properties, etc.
- */
-export type TsModifier = 'public' | 'private' | 'protected' | 'readonly' | 'static' | 'abstract';
-//# sourceMappingURL=ts_helpers.d.ts.map

package/dist/ts_helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ts_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ts_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EACX,eAAe,EAEf,eAAe,EACf,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAC,WAAW,EAAkD,MAAM,oBAAoB,CAAC;AAChG,OAAO,EACN,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAInB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EAAC,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAC,MAAM,uBAAuB,CAAC;AAE7F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACrC,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,YAAY,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,mFAAmF;IACnF,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,2FAA2F;IAC3F,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,gBAAgB,EAAE,MAAM,MAAM,KAAG,SAqB5E,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,iBAAiB,GAC7B,kBAAkB,cAAc,EAChC,gBAAgB,EAAE,CAAC,UAAU,EAC7B,aAAa,MAAM,EACnB,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,KAAK,eAAe,KAClB,cAqBF,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GACrC,aAAa,EAAE,CAAC,UAAU,EAC1B,SAAS,EAAE,CAAC,WAAW,EACvB,SAAS,mBAAmB,EAC5B,KAAK,eAAe,KAClB,qBAwGF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,GAClC,QAAQ,EAAE,CAAC,MAAM,EACjB,aAAa,EAAE,CAAC,UAAU,EAC1B,SAAS,EAAE,CAAC,WAAW,EACvB,KAAK,eAAe,KAClB,mBAsCF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,EAAE,CAAC,UAAU,KAAG,MAAM,GAAG,SAqC/E,CAAC;AAgBF;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GAAI,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,IAAI,KAAG,eA0B5E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B,GAC3C,KAAK,EAAE,CAAC,SAAS,EACjB,SAAS,EAAE,CAAC,WAAW,EACvB,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,KAC3C,KAAK,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB,CAiCA,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACpC,MAAM,EAAE,CAAC,IAAI,EACb,QAAQ,EAAE,CAAC,MAAM,EACjB,SAAS,EAAE,CAAC,WAAW,EACvB,aAAa,eAAe,EAC5B,OAAO,UAAU,CAAC,OAAO,WAAW,CAAC,EACrC,KAAK,eAAe,KAClB,IA+CF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAChC,MAAM,EAAE,CAAC,IAAI,EACb,SAAS,EAAE,CAAC,MAAM,EAClB,SAAS,EAAE,CAAC,WAAW,EACvB,aAAa,eAAe,EAC5B,KAAK,eAAe,KAClB,IA6DF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GACjC,MAAM,EAAE,CAAC,IAAI,EACb,SAAS,EAAE,CAAC,MAAM,EAClB,SAAS,EAAE,CAAC,WAAW,EACvB,aAAa,eAAe,EAC5B,KAAK,eAAe,KAClB,IAyIF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACpC,MAAM,EAAE,CAAC,IAAI,EACb,QAAQ,EAAE,CAAC,MAAM,EACjB,SAAS,EAAE,CAAC,WAAW,EACvB,aAAa,eAAe,EAC5B,KAAK,eAAe,KAClB,IAgBF,CAAC;AAgCF;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAC"}