@fuzdev/fuz_ui 0.175.0 → 0.176.1

package/README.md

@@ -5,7 +5,7 @@
 > friendly user zystem 🧶 [fuz.dev](https://ui.fuz.dev/)
 
 Fuz UI is a [Svelte](https://svelte.dev/) UI library
-with components and helpers for making modern websites.
+with components and helpers for making zippy websites.
 It's in early alpha and it will go through many breaking changes.
 
 Fuz UI is being made to support

package/dist/Alert.svelte

@@ -6,6 +6,8 @@
 
 	/**
 	 * @see https://www.w3.org/WAI/ARIA/apg/patterns/alert/
+	 *
+	 * @module
 	 */
 
 	// TODO think through Alert+Card APIs together, one can be a button and the other a link atm

package/dist/Alert.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Alert.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAuB,KAAK,WAAW,EAAC,MAAM,YAAY,CAAC;AAEjE,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GACjD,kBAAkB,CAAC,QAAQ,CAAC,GAAG;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA8DJ,QAAA,MAAM,KAAK,sDAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Alert.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Alert.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAuB,KAAK,WAAW,EAAC,MAAM,YAAY,CAAC;AAEjE,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,KAAK,CAAC,GACjD,kBAAkB,CAAC,QAAQ,CAAC,GAAG;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,OAAO,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3D,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AAgEJ,QAAA,MAAM,KAAK,sDAAwC,CAAC;AACpD,KAAK,KAAK,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC;AACtC,eAAe,KAAK,CAAC"}

package/dist/ApiModule.svelte

@@ -62,17 +62,16 @@
 			<p>Module not found: {module_path}</p>
 		</section>
 	{:else}
+		{#if module.module_comment}
+			<section>
+				<Mdz content={module.module_comment} />
+			</section>
+		{/if}
 		<!-- Declarations Section -->
 		<TomeSection>
 			<TomeSectionHeader text="Declarations" />
 
 			<section>
-				{#if module.module_comment}
-					<blockquote>
-						<Mdz content={module.module_comment} />
-					</blockquote>
-				{/if}
-
 				{#if search.all.length > 1}
 					<DocsSearch
 						placeholder="search declarations in this module..."

package/dist/ApiModule.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ApiModule.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ApiModule.svelte"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAmB,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAUrD,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AA4GH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"ApiModule.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/ApiModule.svelte"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,OAAO,EAAC,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAmB,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAUrD,KAAK,gBAAgB,GAAI;IACxB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACZ,CAAC;AA2GH,QAAA,MAAM,SAAS,sDAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/DeclarationDetail.svelte

@@ -6,6 +6,7 @@
 	import TypeLink from './TypeLink.svelte';
 	import ModuleLink from './ModuleLink.svelte';
 	import Mdz from './Mdz.svelte';
+	import {tsdoc_see_to_mdz} from './tsdoc_mdz.js';
 
 	const {declaration}: {declaration: Declaration} = $props();
 </script>
@@ -215,7 +216,7 @@
 		<ul>
 			{#each declaration.see_also as ref (ref)}
 				<li>
-					<Mdz content={ref} />
+					<Mdz content={tsdoc_see_to_mdz(ref)} />
 				</li>
 			{/each}
 		</ul>

package/dist/DeclarationDetail.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DeclarationDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAMxD,KAAK,gBAAgB,GAAI;IAAC,WAAW,EAAE,WAAW,CAAA;CAAC,CAAC;AAgVrD,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"DeclarationDetail.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/DeclarationDetail.svelte"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,yBAAyB,CAAC;AAOxD,KAAK,gBAAgB,GAAI;IAAC,WAAW,EAAE,WAAW,CAAA;CAAC,CAAC;AAiVrD,QAAA,MAAM,iBAAiB,sDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}

package/dist/Details.svelte

@@ -8,6 +8,8 @@
 
 	/**
 	 * Like `details` but renders children lazily by default.
+	 *
+	 * @module
 	 */
 
 	let {

package/dist/Details.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Details.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Details.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAGvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,SAAS,CAAC,GAAG;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9C,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA0CH,QAAA,MAAM,OAAO,0DAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}
+{"version":3,"file":"Details.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Details.svelte"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,QAAQ,CAAC;AACpC,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,iBAAiB,CAAC;AAGvD,KAAK,gBAAgB,GAAI,kBAAkB,CAAC,SAAS,CAAC,GAAG;IACxD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC9C,QAAQ,EAAE,OAAO,CAAC;CAClB,CAAC;AA4CH,QAAA,MAAM,OAAO,0DAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/Themed.svelte

@@ -63,6 +63,8 @@
 	/**
 	 * `Themed` adds global color scheme and theme support to the page.
 	 * It also sets in the Svelte context a reactive `themer` containing the theme and color scheme.
+	 *
+	 * @module
 	 */
 
 	themer_context.set(themer);

package/dist/Themed.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Themed.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Themed.svelte"],"names":[],"mappings":"AAMA,OAAO,EAAU,KAAK,OAAO,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAqB,KAAK,KAAK,EAAC,MAAM,0BAA0B,CAAC;AAIxE,OAAO,EACL,iBAAiB,IAAI,yBAAyB,EAC9C,iBAAiB,IAAI,yBAAyB,EAC9C,iBAAiB,IAAI,yBAAyB,EAC9C,UAAU,IAAI,kBAAkB,EAChC,UAAU,IAAI,kBAAkB,EAEhC,MAAM,EACN,MAAM,oBAAoB,CAAC;AAG5B,KAAK,gBAAgB,GAAI;IACxB,iBAAiB,CAAC,EAAE,OAAO,yBAAyB,CAAC;IACrD,iBAAiB,CAAC,EAAE,OAAO,yBAAyB,CAAC;IACrD,iBAAiB,CAAC,EAAE,OAAO,yBAAyB,CAAC;IACrD,UAAU,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACvC,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC3F,CAAC;AAgFH,QAAA,MAAM,MAAM,sDAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}
+{"version":3,"file":"Themed.svelte.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/Themed.svelte"],"names":[],"mappings":"AAMA,OAAO,EAAU,KAAK,OAAO,EAAC,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAqB,KAAK,KAAK,EAAC,MAAM,0BAA0B,CAAC;AAIxE,OAAO,EACL,iBAAiB,IAAI,yBAAyB,EAC9C,iBAAiB,IAAI,yBAAyB,EAC9C,iBAAiB,IAAI,yBAAyB,EAC9C,UAAU,IAAI,kBAAkB,EAChC,UAAU,IAAI,kBAAkB,EAEhC,MAAM,EACN,MAAM,oBAAoB,CAAC;AAG5B,KAAK,gBAAgB,GAAI;IACxB,iBAAiB,CAAC,EAAE,OAAO,yBAAyB,CAAC;IACrD,iBAAiB,CAAC,EAAE,OAAO,yBAAyB,CAAC;IACrD,iBAAiB,CAAC,EAAE,OAAO,yBAAyB,CAAC;IACrD,UAAU,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACvC,UAAU,CAAC,EAAE,OAAO,kBAAkB,CAAC;IACvC,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC3F,CAAC;AAkFH,QAAA,MAAM,MAAM,sDAAwC,CAAC;AACrD,KAAK,MAAM,GAAG,UAAU,CAAC,OAAO,MAAM,CAAC,CAAC;AACxC,eAAe,MAAM,CAAC"}

package/dist/analysis_context.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Diagnostic collection for source analysis.
+ *
+ * Provides structured error/warning collection during TypeScript and Svelte
+ * analysis, replacing silent catch blocks with actionable diagnostics.
+ *
+ * ## Error Handling Contract
+ *
+ * Analysis functions follow a two-tier error model:
+ *
+ * **Accumulated (non-fatal)** - Collected in AnalysisContext, analysis continues:
+ * - Type resolution failures (complex generics, circular refs)
+ * - Missing or unparseable JSDoc
+ * - Individual member/prop extraction failures
+ * - The return value is still valid but may have partial data
+ *
+ * **Thrown (fatal)** - Analysis cannot continue for this file:
+ * - File not found or unreadable
+ * - Syntax errors preventing parsing
+ * - svelte2tsx transformation failures
+ * - Svelte version incompatibility
+ *
+ * ## Usage Pattern
+ *
+ * ```ts
+ * const ctx = new AnalysisContext();
+ * const results = files.map(f => {
+ *   try {
+ *     return library_analyze_module(f, program, options, ctx);
+ *   } catch (e) {
+ *     // Fatal error - log and skip this file
+ *     console.error(`Failed to analyze ${f.id}: ${e}`);
+ *     return null;
+ *   }
+ * });
+ *
+ * // Results are valid even with accumulated errors
+ * // Check ctx for diagnostics to display to user
+ * if (ctx.has_errors()) {
+ *   for (const err of ctx.errors()) {
+ *     console.error(format_diagnostic(err));
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * const ctx = new AnalysisContext();
+ * // ... analysis functions add diagnostics via ctx.add(...)
+ * if (ctx.has_errors()) {
+ *   for (const err of ctx.errors()) {
+ *     console.error(`${err.file}:${err.line}: ${err.message}`);
+ *   }
+ * }
+ *
+ * @module
+ */
+/**
+ * Diagnostic severity levels.
+ *
+ * - `error`: Analysis failed, declaration may be incomplete or missing data
+ * - `warning`: Partial success, something seems off but analysis continued
+ */
+export type DiagnosticSeverity = 'error' | 'warning';
+/**
+ * Discriminant for diagnostic types.
+ */
+export type DiagnosticKind = 'type_extraction_failed' | 'signature_analysis_failed' | 'class_member_failed' | 'svelte_prop_failed' | 'module_skipped';
+/**
+ * Base diagnostic fields shared by all diagnostic types.
+ */
+export interface BaseDiagnostic {
+    kind: DiagnosticKind;
+    /** File path relative to project root (display with './' prefix). */
+    file: string;
+    /** Line number (1-based), or null if location unavailable. */
+    line: number | null;
+    /** Column number (1-based), or null if location unavailable. */
+    column: number | null;
+    /** Human-readable description of the issue. */
+    message: string;
+    severity: DiagnosticSeverity;
+}
+/**
+ * Type extraction failed (e.g., complex or recursive types).
+ */
+export interface TypeExtractionDiagnostic extends BaseDiagnostic {
+    kind: 'type_extraction_failed';
+    /** Name of the symbol whose type couldn't be extracted. */
+    symbol_name: string;
+}
+/**
+ * Function/method signature analysis failed.
+ */
+export interface SignatureAnalysisDiagnostic extends BaseDiagnostic {
+    kind: 'signature_analysis_failed';
+    /** Name of the function or method. */
+    function_name: string;
+}
+/**
+ * Class member analysis failed.
+ */
+export interface ClassMemberDiagnostic extends BaseDiagnostic {
+    kind: 'class_member_failed';
+    /** Name of the class. */
+    class_name: string;
+    /** Name of the member that failed. */
+    member_name: string;
+}
+/**
+ * Svelte prop type resolution failed.
+ */
+export interface SveltePropDiagnostic extends BaseDiagnostic {
+    kind: 'svelte_prop_failed';
+    /** Name of the component. */
+    component_name: string;
+    /** Name of the prop. */
+    prop_name: string;
+}
+/**
+ * Module was skipped during analysis.
+ * Could be due to missing source file in program or no analyzer available.
+ */
+export interface ModuleSkippedDiagnostic extends BaseDiagnostic {
+    kind: 'module_skipped';
+    /** Reason the module was skipped. */
+    reason: 'not_in_program' | 'no_analyzer';
+}
+/**
+ * Union of all diagnostic types.
+ */
+export type Diagnostic = TypeExtractionDiagnostic | SignatureAnalysisDiagnostic | ClassMemberDiagnostic | SveltePropDiagnostic | ModuleSkippedDiagnostic;
+/**
+ * Context for collecting diagnostics during source analysis.
+ *
+ * Thread an instance through analysis functions to collect errors and warnings
+ * without halting analysis. After analysis completes, check `has_errors()` and
+ * report collected diagnostics.
+ *
+ * @example
+ * const ctx = new AnalysisContext();
+ * ts_analyze_module_exports(source_file, checker, options, ctx);
+ * if (ctx.has_errors()) {
+ *   console.error('Analysis completed with errors:');
+ *   for (const d of ctx.errors()) {
+ *     console.error(format_diagnostic(d));
+ *   }
+ * }
+ */
+export declare class AnalysisContext {
+    readonly diagnostics: Array<Diagnostic>;
+    /**
+     * Add a diagnostic to the collection.
+     */
+    add(diagnostic: Diagnostic): void;
+    /**
+     * Check if any errors were collected.
+     */
+    has_errors(): boolean;
+    /**
+     * Check if any warnings were collected.
+     */
+    has_warnings(): boolean;
+    /**
+     * Get all error diagnostics.
+     */
+    errors(): Array<Diagnostic>;
+    /**
+     * Get all warning diagnostics.
+     */
+    warnings(): Array<Diagnostic>;
+    /**
+     * Get diagnostics of a specific kind.
+     */
+    by_kind<K extends DiagnosticKind>(kind: K): Array<Extract<Diagnostic, {
+        kind: K;
+    }>>;
+}
+/**
+ * Options for formatting diagnostics.
+ */
+export interface FormatDiagnosticOptions {
+    /** Prefix for file path (default: './'). */
+    prefix?: string;
+    /** Base path to strip from absolute file paths (e.g., process.cwd()). */
+    strip_base?: string;
+}
+/**
+ * Format a diagnostic for display.
+ *
+ * @param diagnostic The diagnostic to format
+ * @param options Formatting options
+ * @returns Formatted string like './file.ts:10:5: error: message'
+ */
+export declare const format_diagnostic: (diagnostic: Diagnostic, options?: FormatDiagnosticOptions) => string;
+//# sourceMappingURL=analysis_context.d.ts.map

package/dist/analysis_context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis_context.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/analysis_context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,cAAc,GACvB,wBAAwB,GACxB,2BAA2B,GAC3B,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC;AAEpB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,cAAc,CAAC;IACrB,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,kBAAkB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,cAAc;IAC/D,IAAI,EAAE,wBAAwB,CAAC;IAC/B,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA4B,SAAQ,cAAc;IAClE,IAAI,EAAE,2BAA2B,CAAC;IAClC,sCAAsC;IACtC,aAAa,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC5D,IAAI,EAAE,qBAAqB,CAAC;IAC5B,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC3D,IAAI,EAAE,oBAAoB,CAAC;IAC3B,6BAA6B;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,cAAc;IAC9D,IAAI,EAAE,gBAAgB,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,gBAAgB,GAAG,aAAa,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GACnB,wBAAwB,GACxB,2BAA2B,GAC3B,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,CAAC;AAE3B;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC3B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAM;IAE7C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAIjC;;OAEG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC;IAI3B;;OAEG;IACH,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC;IAI7B;;OAEG;IACH,OAAO,CAAC,CAAC,SAAS,cAAc,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE;QAAC,IAAI,EAAE,CAAC,CAAA;KAAC,CAAC,CAAC;CAGjF;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACvC,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC7B,YAAY,UAAU,EACtB,UAAU,uBAAuB,KAC/B,MAeF,CAAC"}

package/dist/analysis_context.js

@@ -0,0 +1,134 @@
+/**
+ * Diagnostic collection for source analysis.
+ *
+ * Provides structured error/warning collection during TypeScript and Svelte
+ * analysis, replacing silent catch blocks with actionable diagnostics.
+ *
+ * ## Error Handling Contract
+ *
+ * Analysis functions follow a two-tier error model:
+ *
+ * **Accumulated (non-fatal)** - Collected in AnalysisContext, analysis continues:
+ * - Type resolution failures (complex generics, circular refs)
+ * - Missing or unparseable JSDoc
+ * - Individual member/prop extraction failures
+ * - The return value is still valid but may have partial data
+ *
+ * **Thrown (fatal)** - Analysis cannot continue for this file:
+ * - File not found or unreadable
+ * - Syntax errors preventing parsing
+ * - svelte2tsx transformation failures
+ * - Svelte version incompatibility
+ *
+ * ## Usage Pattern
+ *
+ * ```ts
+ * const ctx = new AnalysisContext();
+ * const results = files.map(f => {
+ *   try {
+ *     return library_analyze_module(f, program, options, ctx);
+ *   } catch (e) {
+ *     // Fatal error - log and skip this file
+ *     console.error(`Failed to analyze ${f.id}: ${e}`);
+ *     return null;
+ *   }
+ * });
+ *
+ * // Results are valid even with accumulated errors
+ * // Check ctx for diagnostics to display to user
+ * if (ctx.has_errors()) {
+ *   for (const err of ctx.errors()) {
+ *     console.error(format_diagnostic(err));
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * const ctx = new AnalysisContext();
+ * // ... analysis functions add diagnostics via ctx.add(...)
+ * if (ctx.has_errors()) {
+ *   for (const err of ctx.errors()) {
+ *     console.error(`${err.file}:${err.line}: ${err.message}`);
+ *   }
+ * }
+ *
+ * @module
+ */
+/**
+ * Context for collecting diagnostics during source analysis.
+ *
+ * Thread an instance through analysis functions to collect errors and warnings
+ * without halting analysis. After analysis completes, check `has_errors()` and
+ * report collected diagnostics.
+ *
+ * @example
+ * const ctx = new AnalysisContext();
+ * ts_analyze_module_exports(source_file, checker, options, ctx);
+ * if (ctx.has_errors()) {
+ *   console.error('Analysis completed with errors:');
+ *   for (const d of ctx.errors()) {
+ *     console.error(format_diagnostic(d));
+ *   }
+ * }
+ */
+export class AnalysisContext {
+    diagnostics = [];
+    /**
+     * Add a diagnostic to the collection.
+     */
+    add(diagnostic) {
+        this.diagnostics.push(diagnostic);
+    }
+    /**
+     * Check if any errors were collected.
+     */
+    has_errors() {
+        return this.diagnostics.some((d) => d.severity === 'error');
+    }
+    /**
+     * Check if any warnings were collected.
+     */
+    has_warnings() {
+        return this.diagnostics.some((d) => d.severity === 'warning');
+    }
+    /**
+     * Get all error diagnostics.
+     */
+    errors() {
+        return this.diagnostics.filter((d) => d.severity === 'error');
+    }
+    /**
+     * Get all warning diagnostics.
+     */
+    warnings() {
+        return this.diagnostics.filter((d) => d.severity === 'warning');
+    }
+    /**
+     * Get diagnostics of a specific kind.
+     */
+    by_kind(kind) {
+        return this.diagnostics.filter((d) => d.kind === kind);
+    }
+}
+/**
+ * Format a diagnostic for display.
+ *
+ * @param diagnostic The diagnostic to format
+ * @param options Formatting options
+ * @returns Formatted string like './file.ts:10:5: error: message'
+ */
+export const format_diagnostic = (diagnostic, options) => {
+    const prefix = options?.prefix ?? './';
+    const strip_base = options?.strip_base;
+    let file = diagnostic.file;
+    if (strip_base && file.startsWith(strip_base)) {
+        file = file.slice(strip_base.length);
+        // Remove leading slash if present
+        if (file.startsWith('/'))
+            file = file.slice(1);
+    }
+    const { line, column, severity, message } = diagnostic;
+    const location = line !== null ? (column !== null ? `${line}:${column}` : `${line}`) : '';
+    const file_part = location ? `${prefix}${file}:${location}` : `${prefix}${file}`;
+    return `${file_part}: ${severity}: ${message}`;
+};

package/dist/library_analysis.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Library source analysis - unified entry point and shared types.
+ *
+ * Provides a single function for analyzing TypeScript and Svelte source files,
+ * dispatching to the appropriate domain-specific analyzer.
+ *
+ * This module also exports shared types used by both analyzers:
+ * - `DeclarationAnalysis` - A declaration with its nodocs flag
+ * - `ReExportInfo` - Information about a same-name re-export
+ * - `ModuleAnalysis` - Result of analyzing a module (unified structure)
+ *
+ * @example
+ * ```ts
+ * import {library_analyze_module} from './library_analysis.js';
+ * import {ts_create_program} from './ts_helpers.js';
+ * import {module_create_source_options} from './module_helpers.js';
+ * import {AnalysisContext} from './analysis_context.js';
+ *
+ * const {program} = ts_create_program({root: './my-project'});
+ * const ctx = new AnalysisContext();
+ * const options = module_create_source_options('/my-project');
+ *
+ * const result = library_analyze_module(
+ *   {id: '/my-project/src/lib/file.ts', content: '...'},
+ *   program,
+ *   options,
+ *   ctx,
+ * );
+ *
+ * if (result) {
+ *   // Filter out @nodocs declarations
+ *   const declarations = result.declarations
+ *     .filter(d => !d.nodocs)
+ *     .map(d => d.declaration);
+ *   console.log('Declarations:', declarations);
+ * }
+ * ```
+ *
+ * @see ts_helpers.ts for TypeScript-specific analysis
+ * @see svelte_helpers.ts for Svelte component analysis
+ * @see module_helpers.ts for path utilities and SourceFileInfo
+ *
+ * @module
+ */
+import ts from 'typescript';
+import type { Logger } from '@fuzdev/fuz_util/log.js';
+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';
+/**
+ * Result of analyzing a single declaration.
+ * Used by both TypeScript and Svelte analyzers for uniform handling.
+ */
+export interface DeclarationAnalysis {
+    /** The analyzed declaration metadata. */
+    declaration: DeclarationJson;
+    /** Whether the declaration is marked @nodocs (should be excluded from documentation). */
+    nodocs: boolean;
+}
+/**
+ * Information about a same-name re-export.
+ * Used for post-processing to build `also_exported_from` arrays.
+ */
+export interface ReExportInfo {
+    /** Name of the re-exported declaration. */
+    name: string;
+    /** Module path (relative to src/lib) where the declaration is originally declared. */
+    original_module: string;
+}
+/**
+ * Result of analyzing a module (TypeScript or Svelte).
+ * Both analyzers return this same structure for uniform handling.
+ */
+export interface ModuleAnalysis {
+    /** Module path relative to source root. */
+    path: string;
+    /** Module-level documentation comment. */
+    module_comment?: string;
+    /** All declarations with nodocs flags - consumer filters based on policy. */
+    declarations: Array<DeclarationAnalysis>;
+    /** Dependencies (other source modules this module imports). Empty if none. */
+    dependencies: Array<string>;
+    /** Dependents (other source modules that import this module). Empty if none. */
+    dependents: Array<string>;
+    /** Star exports (`export * from './module'`). Empty for Svelte components. */
+    star_exports: Array<string>;
+    /** Re-exports discovered during analysis. Empty for Svelte components. */
+    re_exports: Array<ReExportInfo>;
+}
+/**
+ * Analyze a source file and extract module metadata.
+ *
+ * Unified entry point that dispatches to the appropriate analyzer based on file type:
+ * - TypeScript/JavaScript files → `ts_analyze_module`
+ * - Svelte components → `svelte_analyze_module`
+ *
+ * Returns raw analysis data including `nodocs` flags on declarations.
+ * Consumer is responsible for filtering based on their policy.
+ *
+ * This function can be called incrementally - consumers may cache results and
+ * only re-analyze changed files. The TypeScript program should include all files
+ * for accurate type resolution, but only changed files need re-analysis.
+ *
+ * @param source_file The source file info with content and optional dependency data
+ * @param program TypeScript program (used for type checking and source file lookup)
+ * @param options Module source options for path extraction
+ * @param ctx Analysis context for collecting diagnostics
+ * @param log Optional logger for warnings
+ * @returns Module metadata and re-exports, or undefined if source file not found in program
+ */
+export declare const library_analyze_module: (source_file: SourceFileInfo, program: ts.Program, options: ModuleSourceOptions, ctx: AnalysisContext, log?: Logger) => ModuleAnalysis | undefined;
+//# sourceMappingURL=library_analysis.d.ts.map

package/dist/library_analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library_analysis.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_analysis.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,iCAAiC,CAAC;AAIrE,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAExB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,uBAAuB,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,yCAAyC;IACzC,WAAW,EAAE,eAAe,CAAC;IAC7B,yFAAyF;IACzF,MAAM,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,eAAe,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,YAAY,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACzC,8EAA8E;IAC9E,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,gFAAgF;IAChF,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1B,8EAA8E;IAC9E,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,0EAA0E;IAC1E,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,sBAAsB,GAClC,aAAa,cAAc,EAC3B,SAAS,EAAE,CAAC,OAAO,EACnB,SAAS,mBAAmB,EAC5B,KAAK,eAAe,EACpB,MAAM,MAAM,KACV,cAAc,GAAG,SAuCnB,CAAC"}

package/dist/library_analysis.js

@@ -0,0 +1,106 @@
+/**
+ * Library source analysis - unified entry point and shared types.
+ *
+ * Provides a single function for analyzing TypeScript and Svelte source files,
+ * dispatching to the appropriate domain-specific analyzer.
+ *
+ * This module also exports shared types used by both analyzers:
+ * - `DeclarationAnalysis` - A declaration with its nodocs flag
+ * - `ReExportInfo` - Information about a same-name re-export
+ * - `ModuleAnalysis` - Result of analyzing a module (unified structure)
+ *
+ * @example
+ * ```ts
+ * import {library_analyze_module} from './library_analysis.js';
+ * import {ts_create_program} from './ts_helpers.js';
+ * import {module_create_source_options} from './module_helpers.js';
+ * import {AnalysisContext} from './analysis_context.js';
+ *
+ * const {program} = ts_create_program({root: './my-project'});
+ * const ctx = new AnalysisContext();
+ * const options = module_create_source_options('/my-project');
+ *
+ * const result = library_analyze_module(
+ *   {id: '/my-project/src/lib/file.ts', content: '...'},
+ *   program,
+ *   options,
+ *   ctx,
+ * );
+ *
+ * if (result) {
+ *   // Filter out @nodocs declarations
+ *   const declarations = result.declarations
+ *     .filter(d => !d.nodocs)
+ *     .map(d => d.declaration);
+ *   console.log('Declarations:', declarations);
+ * }
+ * ```
+ *
+ * @see ts_helpers.ts for TypeScript-specific analysis
+ * @see svelte_helpers.ts for Svelte component analysis
+ * @see module_helpers.ts for path utilities and SourceFileInfo
+ *
+ * @module
+ */
+import ts from 'typescript';
+import { ts_analyze_module } from './ts_helpers.js';
+import { svelte_analyze_module } from './svelte_helpers.js';
+import { module_extract_path, } from './module_helpers.js';
+/**
+ * Analyze a source file and extract module metadata.
+ *
+ * Unified entry point that dispatches to the appropriate analyzer based on file type:
+ * - TypeScript/JavaScript files → `ts_analyze_module`
+ * - Svelte components → `svelte_analyze_module`
+ *
+ * Returns raw analysis data including `nodocs` flags on declarations.
+ * Consumer is responsible for filtering based on their policy.
+ *
+ * This function can be called incrementally - consumers may cache results and
+ * only re-analyze changed files. The TypeScript program should include all files
+ * for accurate type resolution, but only changed files need re-analysis.
+ *
+ * @param source_file The source file info with content and optional dependency data
+ * @param program TypeScript program (used for type checking and source file lookup)
+ * @param options Module source options for path extraction
+ * @param ctx Analysis context for collecting diagnostics
+ * @param log Optional logger for warnings
+ * @returns Module metadata and re-exports, or undefined if source file not found in program
+ */
+export const library_analyze_module = (source_file, program, options, ctx, log) => {
+    const checker = program.getTypeChecker();
+    const module_path = module_extract_path(source_file.id, options);
+    const analyzer_type = options.get_analyzer(source_file.id);
+    if (analyzer_type === 'svelte') {
+        return svelte_analyze_module(source_file, module_path, checker, options, ctx);
+    }
+    if (analyzer_type === 'typescript') {
+        const ts_source_file = program.getSourceFile(source_file.id);
+        if (!ts_source_file) {
+            ctx.add({
+                kind: 'module_skipped',
+                file: module_path,
+                line: null,
+                column: null,
+                message: `Could not get source file from program: ${source_file.id}`,
+                severity: 'warning',
+                reason: 'not_in_program',
+            });
+            log?.warn(`Could not get source file from program: ${source_file.id}`);
+            return undefined;
+        }
+        return ts_analyze_module(source_file, ts_source_file, module_path, checker, options, ctx);
+    }
+    // analyzer_type is null - skip this file
+    ctx.add({
+        kind: 'module_skipped',
+        file: module_path,
+        line: null,
+        column: null,
+        message: `No analyzer for file type: ${source_file.id}`,
+        severity: 'warning',
+        reason: 'no_analyzer',
+    });
+    log?.warn(`No analyzer for file: ${source_file.id}`);
+    return undefined;
+};