@fuzdev/fuz_ui 0.176.0 → 0.177.0

package/dist/library_helpers.d.ts

@@ -1,54 +1,56 @@
-import type { PackageJson } from '@fuzdev/fuz_util/package_json.js';
+/**
+ * Library documentation URL helpers.
+ *
+ * Runtime UI helpers for building URLs in the library documentation system.
+ * These depend on fuz_ui's documentation paths and SvelteKit's runtime state.
+ *
+ * For generic package/repository URL helpers, see `package_helpers.ts`.
+ *
+ * @module
+ */
 /**
  * Build project-relative API documentation URL with hash anchor.
+ *
+ * @param declaration_name Name of the declaration to link to
+ * @returns URL path like '/docs/api#declaration_name'
  */
 export declare const url_api_declaration: (declaration_name: string) => string;
 /**
  * Build full API documentation URL with domain and hash anchor.
+ *
+ * @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'
  */
 export declare const url_api_declaration_full: (homepage: string, declaration_name: string) => string;
 /**
  * Build project-relative module documentation URL.
+ *
+ * @param module_path Module path (e.g., 'helpers.ts')
+ * @returns URL path like '/docs/api/helpers.ts'
  */
 export declare const url_api_module: (module_path: string) => string;
-/**
- * Build GitHub file URL for a repository.
- */
-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.
- */
-export declare const url_github_org: (repo_url: string, repo_name: string) => string | null;
-/**
- * Parse GitHub owner/org name from repository URL.
- */
-export declare const github_owner_parse: (repo_url: string) => string | null;
-/**
- * Build npm package URL.
- */
-export declare const url_npm_package: (package_name: string) => string;
-/**
- * Check if a package is published to npm.
- */
-export declare const package_is_published: (package_json: PackageJson) => boolean;
 /**
  * Build package logo URL with favicon.png fallback.
+ *
+ * @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
  */
 export declare const url_package_logo: (homepage_url: string | null, logo_path?: string) => string | null;
-/**
- * Extract repository name without scope from package name.
- */
-export declare const repo_name_parse: (name: string) => string;
-/**
- * Parse repository URL from package.json format.
- */
-export declare const repo_url_parse: (repository: PackageJson["repository"]) => string | null;
-/**
- * Build .well-known URL for package metadata files.
- */
-export declare const url_well_known: (homepage_url: string, filename: string) => string;
 /**
  * Convert a full URL to root-relative format by removing the origin.
+ *
+ * Uses SvelteKit's page state for the current origin by default.
+ *
+ * @param url Full URL to convert
+ * @param origin Origin to strip (defaults to current page origin)
+ * @returns Root-relative URL starting with '/'
+ *
+ * @example
+ * // Assuming page.url.origin is 'https://example.com'
+ * url_to_root_relative('https://example.com/docs/api')
+ * // => '/docs/api'
  */
 export declare const url_to_root_relative: (url: string, origin?: string) => string;
 //# sourceMappingURL=library_helpers.d.ts.map

package/dist/library_helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"library_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAKlE;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAAI,kBAAkB,MAAM,KAAG,MACJ,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,EAAE,kBAAkB,MAAM,KAAG,MACR,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAA2C,CAAC;AAEjG;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,EAAE,OAAO,MAAM,KAAG,MAIpF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,WAAW,MAAM,KAAG,MAAM,GAAG,IAE7E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,IAK9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,cAAc,MAAM,KAAG,MACP,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,cAAc,WAAW,KAAG,OAEhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAC5B,cAAc,MAAM,GAAG,IAAI,EAC3B,YAAY,MAAM,KAChB,MAAM,GAAG,IAIX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAS9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,WAAW,CAAC,YAAY,CAAC,KAAG,MAAM,GAAG,IAK/E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,cAAc,MAAM,EAAE,UAAU,MAAM,KAAG,MAEvE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,EAAE,SAAQ,MAAwB,KAAG,MAcpF,CAAC"}
+{"version":3,"file":"library_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/library_helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,GAAI,kBAAkB,MAAM,KAAG,MACJ,CAAC;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAAI,UAAU,MAAM,EAAE,kBAAkB,MAAM,KAAG,MACR,CAAC;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,KAAG,MAA2C,CAAC;AAEjG;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAC5B,cAAc,MAAM,GAAG,IAAI,EAC3B,YAAY,MAAM,KAChB,MAAM,GAAG,IAIX,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,EAAE,SAAQ,MAAwB,KAAG,MAcpF,CAAC"}

package/dist/library_helpers.js

@@ -1,54 +1,44 @@
-import { ensure_end, strip_end, strip_start } from '@fuzdev/fuz_util/string.js';
+/**
+ * Library documentation URL helpers.
+ *
+ * Runtime UI helpers for building URLs in the library documentation system.
+ * These depend on fuz_ui's documentation paths and SvelteKit's runtime state.
+ *
+ * For generic package/repository URL helpers, see `package_helpers.ts`.
+ *
+ * @module
+ */
+import { ensure_end, strip_start } from '@fuzdev/fuz_util/string.js';
 import { page } from '$app/state';
 import { DOCS_API_PATH, DOCS_PATH_DEFAULT } from './docs_helpers.svelte.js';
 /**
  * Build project-relative API documentation URL with hash anchor.
+ *
+ * @param declaration_name Name of the declaration to link to
+ * @returns URL path like '/docs/api#declaration_name'
  */
 export const url_api_declaration = (declaration_name) => `${DOCS_API_PATH}#${encodeURIComponent(declaration_name)}`;
 /**
  * Build full API documentation URL with domain and hash anchor.
+ *
+ * @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'
  */
 export const url_api_declaration_full = (homepage, declaration_name) => `${homepage}${DOCS_PATH_DEFAULT}/api#${encodeURIComponent(declaration_name)}`;
 /**
  * Build project-relative module documentation URL.
+ *
+ * @param module_path Module path (e.g., 'helpers.ts')
+ * @returns URL path like '/docs/api/helpers.ts'
  */
 export const url_api_module = (module_path) => `${DOCS_API_PATH}/${module_path}`;
-/**
- * Build GitHub file URL for a repository.
- */
-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.
- */
-export const url_github_org = (repo_url, repo_name) => {
-    return repo_url.endsWith('/' + repo_name) ? strip_end(repo_url, '/' + repo_name) : null;
-};
-/**
- * Parse GitHub owner/org name from repository URL.
- */
-export const github_owner_parse = (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.
- */
-export const url_npm_package = (package_name) => 'https://www.npmjs.com/package/' + package_name;
-/**
- * Check if a package is published to npm.
- */
-export const package_is_published = (package_json) => {
-    return !package_json.private && !!package_json.exports && package_json.version !== '0.0.1';
-};
 /**
  * Build package logo URL with favicon.png fallback.
+ *
+ * @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
  */
 export const url_package_logo = (homepage_url, logo_path) => {
     if (!homepage_url)
@@ -56,38 +46,19 @@ export const url_package_logo = (homepage_url, logo_path) => {
     const path = logo_path ? strip_start(logo_path, '/') : 'favicon.png';
     return ensure_end(homepage_url, '/') + path;
 };
-/**
- * Extract repository name without scope from package name.
- */
-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.
- */
-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.
- */
-export const url_well_known = (homepage_url, filename) => {
-    return `${ensure_end(homepage_url, '/')}.well-known/${filename}`;
-};
 /**
  * Convert a full URL to root-relative format by removing the origin.
+ *
+ * Uses SvelteKit's page state for the current origin by default.
+ *
+ * @param url Full URL to convert
+ * @param origin Origin to strip (defaults to current page origin)
+ * @returns Root-relative URL starting with '/'
+ *
+ * @example
+ * // 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_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"}