@fuzdev/fuz_ui 0.176.1 → 0.177.1

package/dist/{library_gen_output.d.ts → library_output.d.ts}

@@ -3,18 +3,19 @@
  *
  * 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)
+ * @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 type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
 import type { SourceJson } from '@fuzdev/fuz_util/source_json.js';
 /**
- * Result of generating library files.
+ * Result of generating library output files.
  * Contains both the JSON data and the TypeScript wrapper file.
  */
-export interface LibraryGenResult {
+export interface LibraryOutputResult {
     /** JSON content for library.json */
     json_content: string;
     /** TypeScript wrapper content for library.ts */
@@ -30,5 +31,5 @@ export interface LibraryGenResult {
  * - 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
+export declare const library_generate_output: (package_json: PackageJson, source_json: SourceJson) => LibraryOutputResult;
+//# sourceMappingURL=library_output.d.ts.map

package/dist/library_output.d.ts.map

@@ -0,0 +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"}

package/dist/{library_gen_output.js → library_output.js}

@@ -3,8 +3,9 @@
  *
  * 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)
+ * @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
  */
@@ -19,7 +20,7 @@ import { library_json_parse } from '@fuzdev/fuz_util/library_json.js';
  * - 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) => {
+export const library_generate_output = (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

package/dist/{library_gen_helpers.d.ts → library_pipeline.d.ts}

@@ -1,10 +1,8 @@
 /**
- * Library metadata generation helpers - pipeline orchestration.
+ * Library metadata generation pipeline.
  *
  * These functions handle collection, validation, and transformation of library metadata
- * during the generation pipeline. They are internal to the generation process.
- *
- * For source analysis (the consumer-facing API), see `library_analysis.ts`.
+ * during the generation pipeline.
  *
  * Pipeline stages:
  * 1. **Collection** - `library_collect_source_files` gathers and filters source files
@@ -13,9 +11,10 @@
  * 4. **Transformation** - `library_merge_re_exports` resolves re-export relationships
  * 5. **Output** - `library_sort_modules` prepares deterministic output
  *
- * @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)
+ * @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
  */
@@ -107,4 +106,4 @@ export declare const library_merge_re_exports: (source_json: SourceJson, collect
  * @param log Optional logger for status messages
  */
 export declare const library_collect_source_files: (files: Iterable<SourceFileInfo>, options: ModuleSourceOptions, log?: Logger) => Array<SourceFileInfo>;
-//# sourceMappingURL=library_gen_helpers.d.ts.map
+//# sourceMappingURL=library_pipeline.d.ts.map

package/dist/library_pipeline.d.ts.map

@@ -0,0 +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"}

package/dist/{library_gen_helpers.js → library_pipeline.js}

@@ -1,10 +1,8 @@
 /**
- * Library metadata generation helpers - pipeline orchestration.
+ * Library metadata generation pipeline.
  *
  * These functions handle collection, validation, and transformation of library metadata
- * during the generation pipeline. They are internal to the generation process.
- *
- * For source analysis (the consumer-facing API), see `library_analysis.ts`.
+ * during the generation pipeline.
  *
  * Pipeline stages:
  * 1. **Collection** - `library_collect_source_files` gathers and filters source files
@@ -13,9 +11,10 @@
  * 4. **Transformation** - `library_merge_re_exports` resolves re-export relationships
  * 5. **Output** - `library_sort_modules` prepares deterministic output
  *
- * @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)
+ * @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
  */

package/dist/module.svelte.js

@@ -1,5 +1,5 @@
 import { Declaration } from './declaration.svelte.js';
-import { url_github_file } from './library_helpers.js';
+import { url_github_file } from './package_helpers.js';
 /**
  * Rich runtime representation of a module with computed properties.
  */

package/dist/package_helpers.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Package and repository URL helpers.
+ *
+ * Generic utilities for building URLs and parsing package/repository metadata.
+ * These functions have no framework dependencies and can be used at build-time or runtime.
+ *
+ * URL builders:
+ * - `url_github_file` - GitHub file permalink
+ * - `url_github_org` - GitHub organization page
+ * - `url_npm_package` - npm package page
+ * - `url_well_known` - .well-known metadata file
+ *
+ * Parsers:
+ * - `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
+ *
+ * Predicates:
+ * - `package_is_published` - check if package is published to npm
+ *
+ * @module
+ */
+import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
+/**
+ * Build GitHub file URL for a repository.
+ *
+ * @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
+ *
+ * @example
+ * url_github_file('https://github.com/foo/bar', 'src/index.ts')
+ * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
+ *
+ * @example
+ * url_github_file('https://github.com/foo/bar', './src/index.ts', 42)
+ * // => 'https://github.com/foo/bar/blob/main/src/index.ts#L42'
+ */
+export declare const url_github_file: (repo_url: string, file_path: string, line?: number) => string;
+/**
+ * Build GitHub organization URL from repo URL and repo name.
+ *
+ * @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
+ *
+ * @example
+ * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
+ * // => 'https://github.com/fuzdev'
+ */
+export declare const url_github_org: (repo_url: string, repo_name: string) => string | null;
+/**
+ * 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
+ *
+ * @example
+ * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
+ * // => 'fuzdev'
+ *
+ * @example
+ * repo_url_github_owner('https://gitlab.com/foo/bar')
+ * // => null (not a GitHub URL)
+ */
+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
+ *
+ * @example
+ * url_npm_package('@fuzdev/fuz_ui')
+ * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
+ */
+export declare const url_npm_package: (package_name: string) => string;
+/**
+ * Check if a package is published to npm.
+ *
+ * A package is considered published if:
+ * - It's not marked as private
+ * - 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
+ */
+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
+ * @throws Error if scoped package name is malformed
+ *
+ * @example
+ * repo_name_parse('@fuzdev/fuz_ui')
+ * // => 'fuz_ui'
+ *
+ * @example
+ * repo_name_parse('lodash')
+ * // => 'lodash'
+ */
+export declare const repo_name_parse: (name: string) => string;
+/**
+ * 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
+ *
+ * @example
+ * repo_url_parse('https://github.com/foo/bar')
+ * // => 'https://github.com/foo/bar'
+ *
+ * @example
+ * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
+ * // => 'https://github.com/foo/bar'
+ *
+ * @example
+ * repo_url_parse(undefined)
+ * // => null
+ */
+export declare const repo_url_parse: (repository: PackageJson["repository"]) => string | null;
+/**
+ * Build .well-known URL for package metadata files.
+ *
+ * @param homepage_url Package homepage URL
+ * @param filename Filename in .well-known directory
+ * @returns Full URL to the .well-known file
+ *
+ * @example
+ * url_well_known('https://fuz.dev', 'package.json')
+ * // => 'https://fuz.dev/.well-known/package.json'
+ */
+export declare const url_well_known: (homepage_url: string, filename: string) => string;
+//# sourceMappingURL=package_helpers.d.ts.map

package/dist/package_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAKjE,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAEvE,CAAC"}

package/dist/package_helpers.js

@@ -0,0 +1,172 @@
+/**
+ * Package and repository URL helpers.
+ *
+ * Generic utilities for building URLs and parsing package/repository metadata.
+ * These functions have no framework dependencies and can be used at build-time or runtime.
+ *
+ * URL builders:
+ * - `url_github_file` - GitHub file permalink
+ * - `url_github_org` - GitHub organization page
+ * - `url_npm_package` - npm package page
+ * - `url_well_known` - .well-known metadata file
+ *
+ * Parsers:
+ * - `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
+ *
+ * Predicates:
+ * - `package_is_published` - check if package is published to npm
+ *
+ * @module
+ */
+import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
+/**
+ * Build GitHub file URL for a repository.
+ *
+ * @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
+ *
+ * @example
+ * url_github_file('https://github.com/foo/bar', 'src/index.ts')
+ * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
+ *
+ * @example
+ * url_github_file('https://github.com/foo/bar', './src/index.ts', 42)
+ * // => 'https://github.com/foo/bar/blob/main/src/index.ts#L42'
+ */
+export const url_github_file = (repo_url, file_path, line) => {
+    const clean_path = file_path.replace(/^\.\//, '');
+    const base = `${repo_url}/blob/main/${clean_path}`;
+    return line ? `${base}#L${line}` : base;
+};
+/**
+ * Build GitHub organization URL from repo URL and repo name.
+ *
+ * @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
+ *
+ * @example
+ * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
+ * // => 'https://github.com/fuzdev'
+ */
+export const url_github_org = (repo_url, repo_name) => {
+    return repo_url.endsWith('/' + repo_name) ? strip_end(repo_url, '/' + repo_name) : null;
+};
+/**
+ * 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
+ *
+ * @example
+ * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
+ * // => 'fuzdev'
+ *
+ * @example
+ * repo_url_github_owner('https://gitlab.com/foo/bar')
+ * // => null (not a GitHub URL)
+ */
+export const repo_url_github_owner = (repo_url) => {
+    const stripped = strip_start(repo_url, 'https://github.com/');
+    if (stripped === repo_url)
+        return null;
+    const parts = stripped.split('/');
+    return parts[0] || null;
+};
+/**
+ * Build npm package URL.
+ *
+ * @param package_name Package name (can be scoped like '@org/package')
+ * @returns Full npm package page URL
+ *
+ * @example
+ * url_npm_package('@fuzdev/fuz_ui')
+ * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
+ */
+export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/' + package_name;
+/**
+ * Check if a package is published to npm.
+ *
+ * A package is considered published if:
+ * - It's not marked as private
+ * - 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
+ */
+export const package_is_published = (package_json) => {
+    return !package_json.private && !!package_json.exports && package_json.version !== '0.0.1';
+};
+/**
+ * Extract repository name without scope from package name.
+ *
+ * @param name Package name (can be scoped like '@org/package')
+ * @returns Repository name without scope
+ * @throws Error if scoped package name is malformed
+ *
+ * @example
+ * repo_name_parse('@fuzdev/fuz_ui')
+ * // => 'fuz_ui'
+ *
+ * @example
+ * repo_name_parse('lodash')
+ * // => 'lodash'
+ */
+export const repo_name_parse = (name) => {
+    if (name[0] === '@') {
+        const parts = name.split('/');
+        if (parts.length < 2) {
+            throw new Error(`invalid scoped package name: "${name}" (expected format: @org/package)`);
+        }
+        return parts[1];
+    }
+    return name;
+};
+/**
+ * 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
+ *
+ * @example
+ * repo_url_parse('https://github.com/foo/bar')
+ * // => 'https://github.com/foo/bar'
+ *
+ * @example
+ * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
+ * // => 'https://github.com/foo/bar'
+ *
+ * @example
+ * repo_url_parse(undefined)
+ * // => null
+ */
+export const repo_url_parse = (repository) => {
+    if (!repository)
+        return null;
+    const url = typeof repository === 'string' ? repository : repository.url;
+    if (!url)
+        return null;
+    return strip_end(strip_start(strip_end(url, '.git'), 'git+'), '/');
+};
+/**
+ * Build .well-known URL for package metadata files.
+ *
+ * @param homepage_url Package homepage URL
+ * @param filename Filename in .well-known directory
+ * @returns Full URL to the .well-known file
+ *
+ * @example
+ * url_well_known('https://fuz.dev', 'package.json')
+ * // => 'https://fuz.dev/.well-known/package.json'
+ */
+export const url_well_known = (homepage_url, filename) => {
+    return `${ensure_end(homepage_url, '/')}.well-known/${filename}`;
+};

package/dist/tome.d.ts

@@ -9,6 +9,9 @@ export declare const Tome: z.ZodObject<{
     related_declarations: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 export type Tome = z.infer<typeof Tome>;
+/**
+ * @param hash - URL fragment to append, with or without the `#`.
+ */
 export declare const to_tome_pathname: (item: Tome | string, docs_path?: string, hash?: string) => string;
 export declare const tomes_context: {
     get: (error_message?: string) => Map<string, {

package/dist/tome.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tome.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tome.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAKtB,eAAO,MAAM,IAAI;;;;;;;iBAQf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,eAAO,MAAM,gBAAgB,GAC5B,MAAM,IAAI,GAAG,MAAM,EACnB,kBAA6B,EAC7B,OAAO,MAAM,KACX,MAIF,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,IAK/C,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAyB,CAAC"}
+{"version":3,"file":"tome.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/tome.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAMtB,eAAO,MAAM,IAAI;;;;;;;iBAQf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC5B,MAAM,IAAI,GAAG,MAAM,EACnB,kBAA6B,EAC7B,OAAO,MAAM,KACX,MAIF,CAAC;AAEF,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAsC,CAAC;AAEjE,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,IAK/C,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAyB,CAAC"}

package/dist/tome.js

@@ -1,5 +1,6 @@
 import { resolve } from '$app/paths';
 import { z } from 'zod';
+import { ensure_start } from '@fuzdev/fuz_util/string.js';
 import { create_context } from './context_helpers.js';
 import { DOCS_PATH_DEFAULT, docs_slugify } from './docs_helpers.svelte.js';
 export const Tome = z.object({
@@ -11,10 +12,13 @@ export const Tome = z.object({
     related_modules: z.array(z.string()),
     related_declarations: z.array(z.string()),
 });
+/**
+ * @param hash - URL fragment to append, with or without the `#`.
+ */
 export const to_tome_pathname = (item, docs_path = DOCS_PATH_DEFAULT, hash) => {
     const name = typeof item === 'string' ? item : item.name;
     const path = docs_path + '/' + docs_slugify(name);
-    return resolve((hash ? path + '#' + hash : path));
+    return resolve((hash ? path + ensure_start(hash, '#') : path));
 };
 export const tomes_context = create_context();
 export const get_tome_by_name = (name) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzdev/fuz_ui",
-  "version": "0.176.1",
+  "version": "0.177.1",
   "description": "Svelte UI library",
   "motto": "friendly user zystem",
   "glyph": "🧶",
@@ -61,7 +61,7 @@
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
-    "@fuzdev/fuz_code": "^0.38.0",
+    "@fuzdev/fuz_code": "^0.39.0",
     "@fuzdev/fuz_css": "^0.42.1",
     "@fuzdev/fuz_util": "^0.45.1",
     "@jridgewell/trace-mapping": "^0.3.31",

package/src/lib/contextmenu_helpers.ts

@@ -39,16 +39,14 @@ export const contextmenu_create_keyboard_handlers = (
 		['Enter', () => contextmenu.activate_selected()],
 	]);
 
-export const contextmenu_create_keydown_handler = (
-	keyboard_handlers: Map<string, () => void>,
-): ((e: KeyboardEvent) => void) => {
-	return (e: KeyboardEvent): void => {
+export const contextmenu_create_keydown_handler =
+	(keyboard_handlers: Map<string, () => void>): ((e: KeyboardEvent) => void) =>
+	(e: KeyboardEvent): void => {
 		const handler = keyboard_handlers.get(e.key);
 		if (!handler || is_editable(e.target)) return;
 		swallow(e);
 		handler();
 	};
-};
 
 export const contextmenu_calculate_constrained_x = (
 	menu_x: number,

package/src/lib/declaration.svelte.ts

@@ -5,7 +5,7 @@ import {
 } from '@fuzdev/fuz_util/source_json.js';
 
 import type {Module} from './module.svelte.js';
-import {url_github_file} from './library_helpers.js';
+import {url_github_file} from './package_helpers.js';
 
 /**
  * Rich runtime representation of an exported declaration.