@fuzdev/fuz_ui 0.191.0 → 0.191.2

package/dist/library_helpers.js

@@ -23,7 +23,7 @@ export const url_api_declaration = (declaration_name) => `${DOCS_API_PATH}#${enc
  *
  * @param homepage - package homepage URL
  * @param declaration_name - name of the declaration to link to
- * @returns Full URL like 'https://example.com/docs/api#declaration_name'
+ * @returns full URL like 'https://example.com/docs/api#declaration_name'
  */
 export const url_api_declaration_full = (homepage, declaration_name) => `${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
 /**
@@ -38,7 +38,7 @@ export const url_api_module = (module_path) => `${DOCS_API_PATH}/${module_path}`
  *
  * @param homepage_url - package homepage URL, or null
  * @param logo_path - optional custom logo path (defaults to 'favicon.png')
- * @returns Full URL to the logo, or null if no homepage
+ * @returns full URL to the logo, or null if no homepage
  */
 export const url_package_logo = (homepage_url, logo_path) => {
     if (!homepage_url)
@@ -53,12 +53,14 @@ export const url_package_logo = (homepage_url, logo_path) => {
  *
  * @param url - full URL to convert
  * @param origin - origin to strip (defaults to current page origin)
- * @returns Root-relative URL starting with '/'
+ * @returns root-relative URL starting with '/'
  *
  * @example
+ * ```ts
  * // Assuming page.url.origin is 'https://example.com'
  * url_to_root_relative('https://example.com/docs/api')
  * // => '/docs/api'
+ * ```
  */
 export const url_to_root_relative = (url, origin = page.url.origin) => {
     const origin_with_slash = ensure_end(origin, '/');

package/dist/library_output.d.ts

@@ -1,11 +1,11 @@
 /**
  * Library output generation.
  *
- * Generates the library.json and library.ts files from analyzed metadata.
+ * Generates the `library.json` and `library.ts` files from analyzed metadata.
  *
- * @see library_generate.ts for the main generation entry point
- * @see library_pipeline.ts for pipeline orchestration functions
- * @see library_gen.ts for Gro-specific integration
+ * @see `library_generate.ts` for the main generation entry point
+ * @see `library_pipeline.ts` for pipeline orchestration functions
+ * @see `library_gen.ts` for Gro-specific integration
  *
  * @module
  */
@@ -16,13 +16,13 @@ import type { SourceJson } from '@fuzdev/fuz_util/source_json.js';
  * Contains both the JSON data and the TypeScript wrapper file.
  */
 export interface LibraryOutputResult {
-    /** JSON content for library.json */
+    /** JSON content for `library.json`. */
     json_content: string;
-    /** TypeScript wrapper content for library.ts */
+    /** TypeScript wrapper content for `library.ts`. */
     ts_content: string;
 }
 /**
- * Generate the library.json and library.ts file contents.
+ * 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:

package/dist/library_output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_output.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GACnC,cAAc,WAAW,EACzB,aAAa,UAAU,KACrB,mBAuBF,CAAC"}
+{"version":3,"file":"library_output.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,iCAAiC,CAAC;AAGhE;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IACnC,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GACnC,cAAc,WAAW,EACzB,aAAa,UAAU,KACrB,mBAuBF,CAAC"}

package/dist/library_output.js

@@ -1,17 +1,17 @@
 /**
  * Library output generation.
  *
- * Generates the library.json and library.ts files from analyzed metadata.
+ * Generates the `library.json` and `library.ts` files from analyzed metadata.
  *
- * @see library_generate.ts for the main generation entry point
- * @see library_pipeline.ts for pipeline orchestration functions
- * @see library_gen.ts for Gro-specific integration
+ * @see `library_generate.ts` for the main generation entry point
+ * @see `library_pipeline.ts` for pipeline orchestration functions
+ * @see `library_gen.ts` for Gro-specific integration
  *
  * @module
  */
 import { library_json_parse } from '@fuzdev/fuz_util/library_json.js';
 /**
- * Generate the library.json and library.ts file contents.
+ * 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:

package/dist/library_pipeline.d.ts

@@ -6,15 +6,15 @@
  *
  * Pipeline stages:
  * 1. **Collection** - `library_collect_source_files` gathers and filters source files
- * 2. **Analysis** - `library_analyze_module` (in library_analysis.ts) extracts metadata
+ * 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_generate.ts for the main generation entry point
- * @see library_analysis.ts for module-level analysis
- * @see library_output.ts for output file generation (JSON/TS wrapper)
- * @see library_gen.ts for Gro-specific integration
+ * @see `library_generate.ts` for the main generation entry point
+ * @see `library_analysis.ts` for module-level analysis
+ * @see `library_output.ts` for output file generation (JSON/TS wrapper)
+ * @see `library_gen.ts` for Gro-specific integration
  *
  * @module
  */
@@ -38,6 +38,7 @@ export interface DuplicateInfo {
  * Callers can decide how to handle duplicates (throw, warn, ignore).
  *
  * @example
+ * ```ts
  * const duplicates = library_find_duplicates(source_json);
  * if (duplicates.size > 0) {
  *   for (const [name, occurrences] of duplicates) {
@@ -48,6 +49,7 @@ export interface DuplicateInfo {
  *   }
  *   throw new Error(`Found ${duplicates.size} duplicate declaration names`);
  * }
+ * ```
  */
 export declare const library_find_duplicates: (source_json: SourceJson) => Map<string, Array<DuplicateInfo>>;
 /**
@@ -80,12 +82,14 @@ export interface CollectedReExport {
  * after all modules are analyzed.
  *
  * @example
+ * ```ts
  * // 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']
+ * ```
  *
  * @param source_json - the source JSON with all modules (will be mutated)
  * @param collected_re_exports - array of re-exports collected during phase 1

package/dist/library_pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_pipeline.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;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"}
+{"version":3,"file":"library_pipeline.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;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;;;;;;;;;;;;;;;;;;;GAmBG;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;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;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_pipeline.js

@@ -6,15 +6,15 @@
  *
  * Pipeline stages:
  * 1. **Collection** - `library_collect_source_files` gathers and filters source files
- * 2. **Analysis** - `library_analyze_module` (in library_analysis.ts) extracts metadata
+ * 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_generate.ts for the main generation entry point
- * @see library_analysis.ts for module-level analysis
- * @see library_output.ts for output file generation (JSON/TS wrapper)
- * @see library_gen.ts for Gro-specific integration
+ * @see `library_generate.ts` for the main generation entry point
+ * @see `library_analysis.ts` for module-level analysis
+ * @see `library_output.ts` for output file generation (JSON/TS wrapper)
+ * @see `library_gen.ts` for Gro-specific integration
  *
  * @module
  */
@@ -26,6 +26,7 @@ import { module_is_source, module_validate_source_options, module_get_source_roo
  * Callers can decide how to handle duplicates (throw, warn, ignore).
  *
  * @example
+ * ```ts
  * const duplicates = library_find_duplicates(source_json);
  * if (duplicates.size > 0) {
  *   for (const [name, occurrences] of duplicates) {
@@ -36,6 +37,7 @@ import { module_is_source, module_validate_source_options, module_get_source_roo
  *   }
  *   throw new Error(`Found ${duplicates.size} duplicate declaration names`);
  * }
+ * ```
  */
 export const library_find_duplicates = (source_json) => {
     const all_occurrences = new Map();
@@ -80,12 +82,14 @@ export const library_sort_modules = (modules) => {
  * after all modules are analyzed.
  *
  * @example
+ * ```ts
  * // 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']
+ * ```
  *
  * @param source_json - the source JSON with all modules (will be mutated)
  * @param collected_re_exports - array of re-exports collected during phase 1

package/dist/logos.d.ts

@@ -12,7 +12,7 @@ export declare const logo_fuz: {
         d: string;
     }[];
 };
-export declare const logo_fuz_ui: {
+export declare const logo_fuz_app: {
     label: string;
     fill: string;
     paths: {
@@ -29,6 +29,13 @@ export declare const logo_fuz_css: {
         style: string;
     };
 };
+export declare const logo_fuz_ui: {
+    label: string;
+    fill: string;
+    paths: {
+        d: string;
+    }[];
+};
 export declare const logo_fuz_code: {
     label: string;
     fill: string;
@@ -57,6 +64,13 @@ export declare const logo_fuz_gitops: {
         d: string;
     }[];
 };
+export declare const logo_fuz_docs: {
+    label: string;
+    fill: string;
+    paths: {
+        d: string;
+    }[];
+};
 export declare const logo_fuz_template: {
     label: string;
     fill: string;

package/dist/logos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;CAIT,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}
+{"version":3,"file":"logos.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/logos.ts"],"names":[],"mappings":"AAqBA,eAAO,MAAM,QAAQ;;;;;;CAgCF,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;CAIN,CAAC;AAEpB,eAAO,MAAM,YAAY;;;;;;;;;CAKN,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;CAIL,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAIX,CAAC;AAEpB,eAAO,MAAM,eAAe;;;;;;CAIT,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAIP,CAAC;AAEpB,eAAO,MAAM,iBAAiB;;;;;;CAQX,CAAC;AAEpB,eAAO,MAAM,aAAa;;;;;;CAwBP,CAAC;AAEpB,eAAO,MAAM,WAAW;;;;;;;;;CAWL,CAAC;AAEpB,eAAO,MAAM,QAAQ;;;;;;CAQF,CAAC"}

package/dist/logos.js

@@ -57,9 +57,9 @@ export const logo_fuz = {
         },
     ],
 };
-export const logo_fuz_ui = {
-    label: 'a friendly red spider facing you',
-    fill: '#d93636',
+export const logo_fuz_app = {
+    label: 'a friendly teal spider facing you',
+    fill: '#2e9e6f',
     paths: logo_fuz.paths,
 };
 export const logo_fuz_css = {
@@ -68,6 +68,11 @@ export const logo_fuz_css = {
     paths: logo_fuz.paths,
     attrs: { style: 'transform: scaleX(-1) rotate(180deg)' },
 };
+export const logo_fuz_ui = {
+    label: 'a friendly red spider facing you',
+    fill: '#d93636',
+    paths: logo_fuz.paths,
+};
 export const logo_fuz_code = {
     label: 'a friendly pink spider facing you',
     fill: '#e55d95',
@@ -88,6 +93,11 @@ export const logo_fuz_gitops = {
     fill: '#6199d1',
     paths: logo_fuz.paths,
 };
+export const logo_fuz_docs = {
+    label: 'a friendly cyan spider facing you',
+    fill: '#1ec3d2',
+    paths: logo_fuz.paths,
+};
 export const logo_fuz_template = {
     label: 'a friendly orange pixelated spider facing you',
     fill: '#f4672f',

package/dist/mdz.js

@@ -627,7 +627,7 @@ export class MdzParser {
     /**
      * Restore previously saved text accumulation state.
      * Used to restore parent state when exiting nested structure parsing.
-     * @param state - State object returned from `#save_accumulation_state()`
+     * @param state - state object returned from `#save_accumulation_state()`
      */
     #restore_accumulation_state(state) {
         this.#accumulated_text = state.accumulated_text;
@@ -640,9 +640,9 @@ export class MdzParser {
      * Word boundary = not surrounded by word characters (A-Z, a-z, 0-9).
      * Used to prevent intraword emphasis for underscores and tildes.
      *
-     * @param index - Position to check
-     * @param check_before - Whether to check the character before this position
-     * @param check_after - Whether to check the character after this position
+     * @param index - position to check
+     * @param check_before - whether to check the character before this position
+     * @param check_after - whether to check the character after this position
      */
     #is_at_word_boundary(index, check_before, check_after) {
         if (check_before && index > 0) {
@@ -832,9 +832,9 @@ export class MdzParser {
      * - Paragraph break (double newline) is encountered (allows block elements to interrupt inline formatting)
      * - `end_index` boundary is reached
      *
-     * @param delimiter - The delimiter string to stop at (e.g., '**', '_', ']')
-     * @param end_index - Optional maximum index to parse up to (for greedy/bounded parsing)
-     * @returns Array of parsed nodes (may be empty if delimiter found immediately)
+     * @param delimiter - the delimiter string to stop at (e.g., '**', '_', ']')
+     * @param end_index - optional maximum index to parse up to (for greedy/bounded parsing)
+     * @returns array of parsed nodes (may be empty if delimiter found immediately)
      */
     #parse_nodes_until(delimiter, end_index) {
         const nodes = [];

package/dist/mdz_helpers.d.ts

@@ -123,9 +123,9 @@ export declare const mdz_is_url: (s: string) => boolean;
  * (e.g., `'./a/../b'` → navigates up then down).
  * Clamps at root — excess `..` segments stop at `/` rather than escaping.
  *
- * @param reference - a relative path starting with `./` or `../`.
- * @param base - an absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ * @param reference - a relative path starting with `./` or `../`
+ * @param base - An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns an absolute resolved path (e.g., `'/docs/mdz/grammar'`)
  */
 export declare const resolve_relative_path: (reference: string, base: string) => string;
 export declare const extract_single_tag: (nodes: Array<MdzNode>) => MdzComponentNode | MdzElementNode | null;

package/dist/mdz_helpers.js

@@ -243,9 +243,9 @@ export const mdz_is_url = (s) => URL_PATTERN.test(s);
  * (e.g., `'./a/../b'` → navigates up then down).
  * Clamps at root — excess `..` segments stop at `/` rather than escaping.
  *
- * @param reference - a relative path starting with `./` or `../`.
- * @param base - an absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
- * @returns An absolute resolved path (e.g., `'/docs/mdz/grammar'`).
+ * @param reference - a relative path starting with `./` or `../`
+ * @param base - An absolute base path (e.g., `'/docs/mdz/'`). Empty string is treated as root.
+ * @returns an absolute resolved path (e.g., `'/docs/mdz/grammar'`)
  */
 export const resolve_relative_path = (reference, base) => {
     const segments = base.split('/');

package/dist/mdz_to_svelte.d.ts

@@ -28,12 +28,12 @@ export interface MdzToSvelteResult {
  * Each node type produces output matching what `MdzNodeView.svelte` renders at runtime.
  * Collects required imports and flags unconfigured component/element references.
  *
- * @param nodes - parsed mdz nodes to render.
- * @param components - component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`).
+ * @param nodes - parsed mdz nodes to render
+ * @param components - Component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`)
  *   If content references a component not in this map, `has_unconfigured_tags` is set.
- * @param elements - allowed HTML element names (e.g., `new Set(['aside', 'details'])`).
+ * @param elements - Allowed HTML element names (e.g., `new Set(['aside', 'details'])`)
  *   If content references an element not in this set, `has_unconfigured_tags` is set.
- * @param base - base path for resolving relative links (e.g., `'/docs/mdz/'`).
+ * @param base - Base path for resolving relative links (e.g., `'/docs/mdz/'`)
  *   When provided, relative references (`./`, `../`) are resolved to absolute paths
  *   and passed through `resolve()`. Trailing slash recommended.
  */

package/dist/mdz_to_svelte.js

@@ -17,12 +17,12 @@ import { resolve_relative_path } from './mdz_helpers.js';
  * Each node type produces output matching what `MdzNodeView.svelte` renders at runtime.
  * Collects required imports and flags unconfigured component/element references.
  *
- * @param nodes - parsed mdz nodes to render.
- * @param components - component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`).
+ * @param nodes - parsed mdz nodes to render
+ * @param components - Component name to import path mapping (e.g., `{Alert: '$lib/Alert.svelte'}`)
  *   If content references a component not in this map, `has_unconfigured_tags` is set.
- * @param elements - allowed HTML element names (e.g., `new Set(['aside', 'details'])`).
+ * @param elements - Allowed HTML element names (e.g., `new Set(['aside', 'details'])`)
  *   If content references an element not in this set, `has_unconfigured_tags` is set.
- * @param base - base path for resolving relative links (e.g., `'/docs/mdz/'`).
+ * @param base - Base path for resolving relative links (e.g., `'/docs/mdz/'`)
  *   When provided, relative references (`./`, `../`) are resolved to absolute paths
  *   and passed through `resolve()`. Trailing slash recommended.
  */

package/dist/module.svelte.d.ts

@@ -17,7 +17,7 @@ export declare class Module {
     path_import: string;
     module_comment: string | undefined;
     /**
-     * Array of Declaration instances. Filters out default exports.
+     * Array of `Declaration` instances. Filters out default exports.
      */
     declarations: Declaration[];
     /**

package/dist/module.svelte.js

@@ -16,7 +16,7 @@ export class Module {
     path_import = $derived('./' + this.path);
     module_comment = $derived(this.module_json.module_comment);
     /**
-     * Array of Declaration instances. Filters out default exports.
+     * Array of `Declaration` instances. Filters out default exports.
      */
     declarations = $derived(this.module_json.declarations
         ? this.module_json.declarations

package/dist/module_helpers.d.ts

@@ -18,7 +18,7 @@ export type AnalyzerType = 'typescript' | 'svelte';
 /**
  * File information for source analysis.
  *
- * Can be constructed from Gro's Disknode or from plain file system access.
+ * Can be constructed from Gro's `Disknode` or from plain file system access.
  * This abstraction enables non-Gro usage while keeping Gro support via adapter.
  *
  * Note: `content` is required to keep analysis functions pure (no hidden I/O).
@@ -235,7 +235,7 @@ export declare const module_validate_source_options: (options: ModuleSourceOptio
  *
  * Returns `source_root` if provided, otherwise returns `source_paths[0]` for single-path configs.
  *
- * @throws Error if source_root is required but not provided (multiple source_paths)
+ * @throws Error if `source_root` is required but not provided (multiple `source_paths`)
  */
 export declare const module_get_source_root: (options: ModuleSourceOptions) => string;
 /**
@@ -307,7 +307,7 @@ export declare const module_is_test: (path: string) => boolean;
  *
  * @param path - full absolute path to check
  * @param options - module source options for filtering
- * @returns True if the path is an analyzable source file
+ * @returns true if the path is an analyzable source file
  *
  * @example
  * ```ts

package/dist/module_helpers.js

@@ -166,7 +166,7 @@ export const module_validate_source_options = (options) => {
  *
  * Returns `source_root` if provided, otherwise returns `source_paths[0]` for single-path configs.
  *
- * @throws Error if source_root is required but not provided (multiple source_paths)
+ * @throws Error if `source_root` is required but not provided (multiple `source_paths`)
  */
 export const module_get_source_root = (options) => {
     if (options.source_root !== undefined) {
@@ -256,7 +256,7 @@ export const module_is_test = (path) => path.endsWith('.test.ts');
  *
  * @param path - full absolute path to check
  * @param options - module source options for filtering
- * @returns True if the path is an analyzable source file
+ * @returns true if the path is an analyzable source file
  *
  * @example
  * ```ts

package/dist/package_helpers.d.ts

@@ -11,7 +11,7 @@
  * - `url_well_known` - .well-known metadata file
  *
  * Parsers:
- * - `repo_url_parse` - extract repo URL from package.json repository field
+ * - `repo_url_parse` - extract repo URL from `package.json` repository field
  * - `repo_name_parse` - extract repo name from scoped package name
  * - `repo_url_github_owner` - extract GitHub owner from repo URL
  *
@@ -27,7 +27,7 @@ import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param file_path - path to the file (leading './' is stripped)
  * @param line - optional line number for deep linking
- * @returns Full GitHub URL to the file on the main branch
+ * @returns full GitHub URL to the file on the main branch
  *
  * @example
  * ```ts
@@ -47,7 +47,7 @@ export declare const url_github_file: (repo_url: string, file_path: string, line
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param repo_name - repository name to strip from the URL
- * @returns Organization URL, or null if repo_url doesn't end with repo_name
+ * @returns organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
  * ```ts
@@ -60,7 +60,7 @@ export declare const url_github_org: (repo_url: string, repo_name: string) => st
  * Extract GitHub owner/org name from repository URL.
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
- * @returns Owner name, or null if not a valid GitHub URL
+ * @returns owner name, or null if not a valid GitHub URL
  *
  * @example
  * ```ts
@@ -79,7 +79,7 @@ export declare const repo_url_github_owner: (repo_url: string) => string | null;
  * Build npm package URL.
  *
  * @param package_name - package name (can be scoped like '@org/package')
- * @returns Full npm package page URL
+ * @returns full npm package page URL
  *
  * @example
  * ```ts
@@ -96,15 +96,15 @@ export declare const url_npm_package: (package_name: string) => string;
  * - It has exports defined
  * - Its version is not the initial '0.0.1'
  *
- * @param package_json - the package.json object to check
- * @returns True if the package appears to be published
+ * @param package_json - the `package.json` object to check
+ * @returns `true` if the package appears to be published
  */
 export declare const package_is_published: (package_json: PackageJson) => boolean;
 /**
  * Extract repository name without scope from package name.
  *
  * @param name - package name (can be scoped like '@org/package')
- * @returns Repository name without scope
+ * @returns repository name without scope
  * @throws Error if scoped package name is malformed
  *
  * @example
@@ -121,13 +121,13 @@ export declare const package_is_published: (package_json: PackageJson) => boolea
  */
 export declare const repo_name_parse: (name: string) => string;
 /**
- * Parse repository URL from package.json format.
+ * Parse repository URL from `package.json` format.
  *
  * Handles both string format and object format with `url` property.
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
- * @param repository - the repository field from package.json
- * @returns Clean repository URL, or null if not provided
+ * @param repository - the repository field from `package.json`
+ * @returns clean repository URL, or null if not provided
  *
  * @example
  * ```ts
@@ -153,7 +153,7 @@ export declare const repo_url_parse: (repository: PackageJson["repository"]) =>
  *
  * @param homepage_url - package homepage URL
  * @param filename - filename in .well-known directory
- * @returns Full URL to the .well-known file
+ * @returns full URL to the .well-known file
  *
  * @example
  * ```ts

package/dist/package_helpers.js

@@ -11,7 +11,7 @@
  * - `url_well_known` - .well-known metadata file
  *
  * Parsers:
- * - `repo_url_parse` - extract repo URL from package.json repository field
+ * - `repo_url_parse` - extract repo URL from `package.json` repository field
  * - `repo_name_parse` - extract repo name from scoped package name
  * - `repo_url_github_owner` - extract GitHub owner from repo URL
  *
@@ -27,7 +27,7 @@ import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param file_path - path to the file (leading './' is stripped)
  * @param line - optional line number for deep linking
- * @returns Full GitHub URL to the file on the main branch
+ * @returns full GitHub URL to the file on the main branch
  *
  * @example
  * ```ts
@@ -51,7 +51,7 @@ export const url_github_file = (repo_url, file_path, line) => {
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
  * @param repo_name - repository name to strip from the URL
- * @returns Organization URL, or null if repo_url doesn't end with repo_name
+ * @returns organization URL, or null if repo_url doesn't end with repo_name
  *
  * @example
  * ```ts
@@ -66,7 +66,7 @@ export const url_github_org = (repo_url, repo_name) => {
  * Extract GitHub owner/org name from repository URL.
  *
  * @param repo_url - repository URL (e.g., 'https://github.com/owner/repo')
- * @returns Owner name, or null if not a valid GitHub URL
+ * @returns owner name, or null if not a valid GitHub URL
  *
  * @example
  * ```ts
@@ -91,7 +91,7 @@ export const repo_url_github_owner = (repo_url) => {
  * Build npm package URL.
  *
  * @param package_name - package name (can be scoped like '@org/package')
- * @returns Full npm package page URL
+ * @returns full npm package page URL
  *
  * @example
  * ```ts
@@ -108,8 +108,8 @@ export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/
  * - It has exports defined
  * - Its version is not the initial '0.0.1'
  *
- * @param package_json - the package.json object to check
- * @returns True if the package appears to be published
+ * @param package_json - the `package.json` object to check
+ * @returns `true` if the package appears to be published
  */
 export const package_is_published = (package_json) => {
     return !package_json.private && !!package_json.exports && package_json.version !== '0.0.1';
@@ -118,7 +118,7 @@ export const package_is_published = (package_json) => {
  * Extract repository name without scope from package name.
  *
  * @param name - package name (can be scoped like '@org/package')
- * @returns Repository name without scope
+ * @returns repository name without scope
  * @throws Error if scoped package name is malformed
  *
  * @example
@@ -144,13 +144,13 @@ export const repo_name_parse = (name) => {
     return name;
 };
 /**
- * Parse repository URL from package.json format.
+ * Parse repository URL from `package.json` format.
  *
  * Handles both string format and object format with `url` property.
  * Strips common prefixes ('git+') and suffixes ('.git', '/').
  *
- * @param repository - the repository field from package.json
- * @returns Clean repository URL, or null if not provided
+ * @param repository - the repository field from `package.json`
+ * @returns clean repository URL, or null if not provided
  *
  * @example
  * ```ts
@@ -183,7 +183,7 @@ export const repo_url_parse = (repository) => {
  *
  * @param homepage_url - package homepage URL
  * @param filename - filename in .well-known directory
- * @returns Full URL to the .well-known file
+ * @returns full URL to the .well-known file
  *
  * @example
  * ```ts

package/dist/storage.d.ts

@@ -7,7 +7,7 @@ export declare const save_to_storage: (key: string, value: any, is_json?: boolea
  * @param key - the localStorage key
  * @param is_json - whether to parse the value as JSON
  * @param parse_fn - optional custom parsing function to transform the value
- * @returns The parsed value or null if not found or parsing fails
+ * @returns the parsed value or null if not found or parsing fails
  */
 export declare const load_from_storage: <T>(key: string, is_json?: boolean, parse_fn?: (value: unknown) => T | null) => T | null;
 //# sourceMappingURL=storage.d.ts.map