@fuzdev/fuz_ui 0.174.0 → 0.176.0

package/dist/library_gen_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_gen_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,UAAU,EAAE,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAE5E,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAErD,OAAO,EAA4B,KAAK,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAS7E;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,oDAAoD;IACpD,MAAM,EAAE,UAAU,CAAC;IACnB,mEAAmE;IACnE,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAChC;AAED;;;;;GAKG;AACH,eAAO,MAAM,kCAAkC,GAAI,aAAa,UAAU,EAAE,KAAK,MAAM,KAAG,IAyCzF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CAErF,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACrC,cAAc,WAAW,EACzB,aAAa,UAAU,KACrB,gBAuBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAC5C,OAAO,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAC5B,KAAK,MAAM,KACT,KAAK,CAAC,QAAQ,CAwBhB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,+BAA+B,GAC3C,UAAU,QAAQ,EAClB,aAAa,MAAM,EACnB,SAAS,EAAE,CAAC,WAAW,KACrB,UAaF,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mCAAmC,GAC/C,UAAU,QAAQ,EAClB,aAAa,EAAE,CAAC,UAAU,EAC1B,aAAa,MAAM,EACnB,SAAS,EAAE,CAAC,WAAW,KACrB,cA0BF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gCAAgC,GAC5C,UAAU,QAAQ,KAChB;IAAC,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;CAuBzD,CAAC"}
+{"version":3,"file":"library_gen_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,eAAe,EAAE,UAAU,EAAE,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAE7F,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACN,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAIxB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,qCAAqC;IACrC,WAAW,EAAE,eAAe,CAAC;IAC7B,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,uBAAuB,GACnC,aAAa,UAAU,KACrB,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,aAAa,CAAC,CA0BlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,KAAK,CAAC,UAAU,CAAC,KAAG,KAAK,CAAC,UAAU,CAEjF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,kDAAkD;IAClD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,SAAS,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,wBAAwB,GACpC,aAAa,UAAU,EACvB,sBAAsB,KAAK,CAAC,iBAAiB,CAAC,KAC5C,IAgCF,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACxC,OAAO,QAAQ,CAAC,cAAc,CAAC,EAC/B,SAAS,mBAAmB,EAC5B,MAAM,MAAM,KACV,KAAK,CAAC,cAAc,CA0BtB,CAAC"}

package/dist/library_gen_helpers.js

@@ -1,198 +1,157 @@
 /**
- * Build-time helpers for library metadata generation.
+ * Library metadata generation helpers - pipeline orchestration.
  *
- * These functions handle Gro-specific concerns like file collection and dependency
- * graph extraction. Core analysis logic has been extracted to reusable helpers:
+ * These functions handle collection, validation, and transformation of library metadata
+ * during the generation pipeline. They are internal to the generation process.
  *
- * - `ts_helpers.ts` - `ts_analyze_module_exports`
- * - `svelte_helpers.ts` - `svelte_analyze_file`
- * - `module_helpers.ts` - path utilities and source detection
+ * For source analysis (the consumer-facing API), see `library_analysis.ts`.
  *
- * Design philosophy: Fail fast with clear errors rather than silently producing invalid
- * metadata. All validation errors halt the build immediately with actionable messages.
+ * Pipeline stages:
+ * 1. **Collection** - `library_collect_source_files` gathers and filters source files
+ * 2. **Analysis** - `library_analyze_module` (in library_analysis.ts) extracts metadata
+ * 3. **Validation** - `library_find_duplicates` checks flat namespace constraints
+ * 4. **Transformation** - `library_merge_re_exports` resolves re-export relationships
+ * 5. **Output** - `library_sort_modules` prepares deterministic output
  *
- * @see library_gen.ts for the main generation task
- * @see @fuzdev/fuz_util/source_json.js for type definitions
- * @see ts_helpers.ts for reusable TypeScript analysis
- * @see svelte_helpers.ts for reusable Svelte component analysis
+ * @see library_analysis.ts for the analysis entry point
+ * @see library_gen_output.ts for output file generation (JSON/TS wrapper)
+ * @see library_gen.ts for the main generation task (Gro-specific)
+ *
+ * @module
  */
-import { library_json_parse } from '@fuzdev/fuz_util/library_json.js';
-import { ts_analyze_module_exports } from './ts_helpers.js';
-import { svelte_analyze_file } from './svelte_helpers.js';
-import { module_extract_path, module_is_typescript, module_is_svelte, module_matches_source, } from './module_helpers.js';
+import { module_is_source, module_validate_source_options, module_get_source_root, } from './module_helpers.js';
 /**
- * Validates that no declaration names are duplicated across modules.
- * The flat namespace is intentional - duplicates should fail fast.
+ * Find duplicate declaration names across modules.
+ *
+ * Returns a Map of declaration names to their full metadata (only includes duplicates).
+ * Callers can decide how to handle duplicates (throw, warn, ignore).
  *
- * @throws Error if duplicate declaration names are found
+ * @example
+ * const duplicates = library_find_duplicates(source_json);
+ * if (duplicates.size > 0) {
+ *   for (const [name, occurrences] of duplicates) {
+ *     console.error(`"${name}" found in:`);
+ *     for (const {declaration, module} of occurrences) {
+ *       console.error(`  - ${module}:${declaration.source_line} (${declaration.kind})`);
+ *     }
+ *   }
+ *   throw new Error(`Found ${duplicates.size} duplicate declaration names`);
+ * }
  */
-export const library_gen_validate_no_duplicates = (source_json, log) => {
-    const declaration_locations = new Map();
-    // Collect all declaration names and their locations
+export const library_find_duplicates = (source_json) => {
+    const all_occurrences = new Map();
+    // Collect all declaration names and their full metadata
     for (const mod of source_json.modules ?? []) {
         for (const declaration of mod.declarations ?? []) {
             const name = declaration.name;
-            if (!declaration_locations.has(name)) {
-                declaration_locations.set(name, []);
+            if (!all_occurrences.has(name)) {
+                all_occurrences.set(name, []);
             }
-            declaration_locations.get(name).push({
+            all_occurrences.get(name).push({
+                declaration,
                 module: mod.path,
-                kind: declaration.kind,
             });
         }
     }
-    // Check for duplicates
-    const duplicates = [];
-    for (const [name, locations] of declaration_locations.entries()) {
-        if (locations.length > 1) {
-            duplicates.push({ name, locations });
-        }
-    }
-    if (duplicates.length > 0) {
-        log.error('Duplicate declaration names detected in flat namespace:');
-        for (const { name, locations } of duplicates) {
-            log.error(`  "${name}" found in:`);
-            for (const { module, kind } of locations) {
-                log.error(`    - ${module} (${kind})`);
-            }
+    // Filter to only duplicates
+    const duplicates = new Map();
+    for (const [name, occurrences] of all_occurrences) {
+        if (occurrences.length > 1) {
+            duplicates.set(name, occurrences);
         }
-        throw new Error(`Found ${duplicates.length} duplicate declaration name${duplicates.length === 1 ? '' : 's'} across modules. ` +
-            'The flat namespace requires unique names. To resolve: ' +
-            '(1) rename one of the conflicting declarations, or ' +
-            '(2) add /** @nodocs */ to exclude from documentation. ' +
-            'See CLAUDE.md "Declaration namespacing" section for details.');
     }
+    return duplicates;
 };
 /**
  * Sort modules alphabetically by path for deterministic output and cleaner diffs.
  */
-export const library_gen_sort_modules = (modules) => {
+export const library_sort_modules = (modules) => {
     return modules.slice().sort((a, b) => a.path.localeCompare(b.path));
 };
 /**
- * Generate the library.json and library.ts file contents.
- * Parses at generation time so runtime only needs the pre-computed result.
+ * Build `also_exported_from` arrays from collected re-export data.
  *
- * Returns JSON + .ts wrapper because:
- * - JSON is natively importable by Node.js and Vite without TypeScript loaders
- * - Works in CI environments that don't have TS compilation
- * - The .ts wrapper validates with zod and exports with proper types
- *   (JSON imports get widened types like `string` instead of literal unions)
- */
-export const library_gen_generate_json = (package_json, source_json) => {
-    const is_this_fuz_util = package_json.name === '@fuzdev/fuz_util';
-    const fuz_util_prefix = is_this_fuz_util ? './' : '@fuzdev/fuz_util/';
-    // Parse at generation time, not runtime
-    const library_json = library_json_parse(package_json, source_json);
-    const json_content = JSON.stringify(library_json, null, '\t') + '\n';
-    const banner = '// generated by library.gen.ts - do not edit';
-    const ts_content = `${banner}
-
-import type {LibraryJson} from '${fuz_util_prefix}library_json.js';
-
-import json from './library.json' with {type: 'json'};
-
-export const library_json: LibraryJson = json as LibraryJson;
-
-${banner}
-`;
-    return { json_content, ts_content };
-};
-/**
- * Collect and filter source files from filer.
+ * This function resolves the two-phase re-export problem:
  *
- * Returns disknodes for TypeScript/JS files and Svelte components from src/lib, excluding test files.
- * Returns an empty array with a warning if no source files are found.
- */
-export const library_gen_collect_source_files = (files, log) => {
-    log.info(`filer has ${files.size} files total`);
-    const source_disknodes = [];
-    for (const [id, disknode] of files.entries()) {
-        if (module_matches_source(id)) {
-            // Include TypeScript/JS files and Svelte components
-            if (module_is_typescript(id) || module_is_svelte(id)) {
-                source_disknodes.push(disknode);
-            }
-        }
-    }
-    log.info(`found ${source_disknodes.length} source files to analyze`);
-    if (source_disknodes.length === 0) {
-        log.warn('No source files found in src/lib - generating empty library metadata');
-        return [];
-    }
-    // Sort for deterministic output (stable alphabetical module ordering)
-    source_disknodes.sort((a, b) => a.id.localeCompare(b.id));
-    return source_disknodes;
-};
-/**
- * Analyze a Svelte component file and extract metadata.
+ * **Problem**: When module A re-exports from module B, we discover this while
+ * analyzing A, but need to update B's declarations. However, B may already be
+ * processed or may be processed later.
  *
- * Uses `svelte_analyze_file` for core analysis, then adds
- * Gro-specific dependency information from the disknode.
- */
-export const library_gen_analyze_svelte_file = (disknode, module_path, checker) => {
-    // Use the extracted helper for core analysis
-    const declaration_json = svelte_analyze_file(disknode.id, module_path, checker);
-    // Extract dependencies and dependents (Gro-specific)
-    const { dependencies, dependents } = library_gen_extract_dependencies(disknode);
-    return {
-        path: module_path,
-        declarations: [declaration_json],
-        dependencies: dependencies.length > 0 ? dependencies : undefined,
-        dependents: dependents.length > 0 ? dependents : undefined,
-    };
-};
-/**
- * Analyze a TypeScript file and extract all declarations.
+ * **Solution**: Collect all re-exports in phase 1, then merge them in phase 2
+ * after all modules are analyzed.
  *
- * Uses `ts_analyze_module_exports` for core analysis, then adds
- * Gro-specific dependency information from the disknode.
+ * @example
+ * // helpers.ts exports: foo, bar
+ * // index.ts does: export {foo, bar} from './helpers.js'
+ * //
+ * // After processing:
+ * // - helpers.ts foo declaration gets: also_exported_from: ['index.ts']
+ * // - helpers.ts bar declaration gets: also_exported_from: ['index.ts']
  *
- * Returns both the module metadata and re-export information for post-processing.
+ * @param source_json The source JSON with all modules (will be mutated)
+ * @param collected_re_exports Array of re-exports collected during phase 1
+ * @mutates source_json - adds `also_exported_from` to declarations
  */
-export const library_gen_analyze_typescript_file = (disknode, source_file, module_path, checker) => {
-    // Use the extracted helper for core analysis
-    const { module_comment, declarations, re_exports } = ts_analyze_module_exports(source_file, checker);
-    const mod = {
-        path: module_path,
-        declarations,
-    };
-    if (module_comment) {
-        mod.module_comment = module_comment;
-    }
-    // Extract dependencies and dependents (Gro-specific)
-    const { dependencies, dependents } = library_gen_extract_dependencies(disknode);
-    if (dependencies.length > 0) {
-        mod.dependencies = dependencies;
+export const library_merge_re_exports = (source_json, collected_re_exports) => {
+    // Group re-exports by original module and declaration name
+    // Structure: Map<original_module_path, Map<declaration_name, Array<re_exporting_module_path>>>
+    const re_export_map = new Map();
+    for (const { re_exporting_module, re_export } of collected_re_exports) {
+        const { name, original_module } = re_export;
+        if (!re_export_map.has(original_module)) {
+            re_export_map.set(original_module, new Map());
+        }
+        const module_map = re_export_map.get(original_module);
+        if (!module_map.has(name)) {
+            module_map.set(name, []);
+        }
+        module_map.get(name).push(re_exporting_module);
     }
-    if (dependents.length > 0) {
-        mod.dependents = dependents;
+    // Merge into original declarations
+    for (const mod of source_json.modules ?? []) {
+        const module_re_exports = re_export_map.get(mod.path);
+        if (!module_re_exports)
+            continue;
+        for (const declaration of mod.declarations ?? []) {
+            const re_exporters = module_re_exports.get(declaration.name);
+            if (re_exporters?.length) {
+                // Sort for deterministic output
+                declaration.also_exported_from = re_exporters.sort();
+            }
+        }
     }
-    return { module: mod, re_exports };
 };
 /**
- * Extract dependencies and dependents for a module from the filer's dependency graph.
+ * Collect and filter source files.
+ *
+ * Returns source files for TypeScript/JS files and Svelte components, excluding test files.
+ * Returns an empty array with a warning if no source files are found.
  *
- * Filters to only include source modules from src/lib (excludes external packages, node_modules, tests).
- * Returns sorted arrays of module paths (relative to src/lib) for deterministic output.
+ * File types are determined by `options.get_analyzer`. By default, `.ts`, `.js`, and `.svelte`
+ * files are supported. Customize `get_analyzer` to support additional file types like `.svx`.
+ *
+ * @param files Iterable of source file info (from Gro filer, file system, or other source)
+ * @param options Module source options for filtering
+ * @param log Optional logger for status messages
  */
-export const library_gen_extract_dependencies = (disknode) => {
-    const dependencies = [];
-    const dependents = [];
-    // Extract dependencies (files this module imports)
-    for (const dep_id of disknode.dependencies.keys()) {
-        if (module_matches_source(dep_id)) {
-            dependencies.push(module_extract_path(dep_id));
+export const library_collect_source_files = (files, options, log) => {
+    // Validate options early to fail fast on misconfiguration
+    module_validate_source_options(options);
+    const all_files = Array.from(files);
+    log?.info(`received ${all_files.length} files total`);
+    const source_files = [];
+    for (const file of all_files) {
+        if (module_is_source(file.id, options)) {
+            source_files.push(file);
         }
     }
-    // Extract dependents (files that import this module)
-    for (const dependent_id of disknode.dependents.keys()) {
-        if (module_matches_source(dependent_id)) {
-            dependents.push(module_extract_path(dependent_id));
-        }
+    log?.info(`found ${source_files.length} source files to analyze`);
+    if (source_files.length === 0) {
+        const effective_root = module_get_source_root(options);
+        log?.warn(`No source files found in ${effective_root} - generating empty library metadata`);
+        return [];
     }
-    // Sort for deterministic output
-    dependencies.sort();
-    dependents.sort();
-    return { dependencies, dependents };
+    // Sort for deterministic output (stable alphabetical module ordering)
+    source_files.sort((a, b) => a.id.localeCompare(b.id));
+    return source_files;
 };

package/dist/library_gen_output.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Library output generation.
+ *
+ * Generates the library.json and library.ts files from analyzed metadata.
+ *
+ * @see library_gen_helpers.ts for orchestration functions
+ * @see library_gen.ts for the main generation task (Gro-specific)
+ *
+ * @module
+ */
+import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
+import type { SourceJson } from '@fuzdev/fuz_util/source_json.js';
+/**
+ * Result of generating library files.
+ * Contains both the JSON data and the TypeScript wrapper file.
+ */
+export interface LibraryGenResult {
+    /** JSON content for library.json */
+    json_content: string;
+    /** TypeScript wrapper content for library.ts */
+    ts_content: string;
+}
+/**
+ * Generate the library.json and library.ts file contents.
+ * Parses at generation time so runtime only needs the pre-computed result.
+ *
+ * Returns JSON + .ts wrapper because:
+ * - JSON is natively importable by Node.js and Vite without TypeScript loaders
+ * - Works in CI environments that don't have TS compilation
+ * - The .ts wrapper validates with zod and exports with proper types
+ *   (JSON imports get widened types like `string` instead of literal unions)
+ */
+export declare const library_generate_json: (package_json: PackageJson, source_json: SourceJson) => LibraryGenResult;
+//# sourceMappingURL=library_gen_output.d.ts.map

package/dist/library_gen_output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"library_gen_output.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_gen_output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAChC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,GACjC,cAAc,WAAW,EACzB,aAAa,UAAU,KACrB,gBAuBF,CAAC"}

package/dist/library_gen_output.js

@@ -0,0 +1,40 @@
+/**
+ * Library output generation.
+ *
+ * Generates the library.json and library.ts files from analyzed metadata.
+ *
+ * @see library_gen_helpers.ts for orchestration functions
+ * @see library_gen.ts for the main generation task (Gro-specific)
+ *
+ * @module
+ */
+import { library_json_parse } from '@fuzdev/fuz_util/library_json.js';
+/**
+ * Generate the library.json and library.ts file contents.
+ * Parses at generation time so runtime only needs the pre-computed result.
+ *
+ * Returns JSON + .ts wrapper because:
+ * - JSON is natively importable by Node.js and Vite without TypeScript loaders
+ * - Works in CI environments that don't have TS compilation
+ * - The .ts wrapper validates with zod and exports with proper types
+ *   (JSON imports get widened types like `string` instead of literal unions)
+ */
+export const library_generate_json = (package_json, source_json) => {
+    const is_this_fuz_util = package_json.name === '@fuzdev/fuz_util';
+    const fuz_util_prefix = is_this_fuz_util ? './' : '@fuzdev/fuz_util/';
+    // Parse at generation time, not runtime
+    const library_json = library_json_parse(package_json, source_json);
+    const json_content = JSON.stringify(library_json, null, '\t') + '\n';
+    const banner = '// generated by library.gen.ts - do not edit';
+    const ts_content = `${banner}
+
+import type {LibraryJson} from '${fuz_util_prefix}library_json.js';
+
+import json from './library.json' with {type: 'json'};
+
+export const library_json: LibraryJson = json as LibraryJson;
+
+${banner}
+`;
+    return { json_content, ts_content };
+};

package/dist/mdz.d.ts

@@ -25,6 +25,8 @@
  * ## Status
  *
  * This is an early proof of concept with missing features and edge cases.
+ *
+ * @module
  */
 /**
  * Parses text to an array of `MdzNode`.
@@ -103,4 +105,5 @@ export declare class MdzParser {
      */
     parse(): Array<MdzNode>;
 }
+export declare const mdz_is_url: (s: string) => boolean;
 //# sourceMappingURL=mdz.d.ts.map

package/dist/mdz.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,OAAO,CAAgC,CAAC;AAEvF,MAAM,MAAM,OAAO,GAChB,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,cAAc,GACd,cAAc,GACd,gBAAgB,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACxD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;CACnC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC7C,IAAI,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AA+CD;;;;GAIG;AACH,qBAAa,SAAS;;gBAQT,QAAQ,EAAE,MAAM;IAI5B;;;OAGG;IACH,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;CA+lDvB"}
+{"version":3,"file":"mdz.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/mdz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAIH;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,KAAG,KAAK,CAAC,OAAO,CAAgC,CAAC;AAEvF,MAAM,MAAM,OAAO,GAChB,WAAW,GACX,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,oBAAoB,GACpB,WAAW,GACX,gBAAgB,GAChB,SAAS,GACT,cAAc,GACd,cAAc,GACd,gBAAgB,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IACjD,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACxD,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACzB,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;CACnC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,SAAU,SAAQ,WAAW;IAC7C,IAAI,EAAE,IAAI,CAAC;CACX;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IAClD,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;CACzB;AA+CD;;;;GAIG;AACH,qBAAa,SAAS;;gBAQT,QAAQ,EAAE,MAAM;IAI5B;;;OAGG;IACH,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC;CA8lDvB;AAQD,eAAO,MAAM,UAAU,GAAI,GAAG,MAAM,KAAG,OAA8B,CAAC"}

package/dist/mdz.js

@@ -25,6 +25,8 @@
  * ## Status
  *
  * This is an early proof of concept with missing features and edge cases.
+ *
+ * @module
  */
 // TODO design incremental parsing or some system that preserves Svelte components across re-renders when possible
 /**
@@ -489,7 +491,7 @@ export class MdzParser {
         }
         this.#index = close_paren + 1;
         // Determine link type (external vs internal)
-        const link_type = reference.startsWith('https://') || reference.startsWith('http://') ? 'external' : 'internal';
+        const link_type = mdz_is_url(reference) ? 'external' : 'internal';
         return {
             type: 'Link',
             reference,
@@ -841,7 +843,7 @@ export class MdzParser {
             char_code === PERCENT);
     }
     /**
-     * Check if current position is the start of an external URL (https:// or http://).
+     * Check if current position is the start of an external URL (`https://` or `http://`).
      */
     #is_at_url() {
         if (this.#match('https://')) {
@@ -889,7 +891,7 @@ export class MdzParser {
         return next_char !== SLASH && next_char !== SPACE && next_char !== NEWLINE;
     }
     /**
-     * Parse auto-detected external URL (https:// or http://).
+     * Parse auto-detected external URL (`https://` or `http://`).
      * Uses RFC 3986 whitelist validation for valid URI characters.
      */
     #parse_auto_link_url() {
@@ -1479,3 +1481,10 @@ export class MdzParser {
         throw Error('Code block not properly closed');
     }
 }
+/**
+ * Check if a string is a URL (`https://` or `http://`).
+ * Requires at least one valid character after the protocol.
+ * Rejects whitespace and characters that can't start a valid hostname.
+ */
+const URL_PATTERN = /^https?:\/\/[^\s)\]}<>.,:/?#!]/;
+export const mdz_is_url = (s) => URL_PATTERN.test(s);