@fuzdev/fuz_ui 0.176.1 → 0.177.0

package/src/lib/library_gen.ts

@@ -1,25 +1,15 @@
 /**
- * Library metadata generator helper.
+ * Gro-specific library metadata generation.
  *
- * Generates package_json and source_json with rich metadata:
- * - JSDoc/TSDoc comments with full tag support
- * - Full type signatures
- * - Source code locations
- * - Parameter information with descriptions and defaults
- * - Return value documentation
- * - Usage examples
- * - Dependency graphs
- * - Svelte component props
+ * This module provides Gro integration for library generation. It wraps the generic
+ * `library_generate` function with Gro's `Gen` interface and provides adapters for
+ * converting Gro's `Disknode` to the build-tool agnostic `SourceFileInfo`.
  *
- * This file contains Gro-specific integration. The actual analysis logic is in
- * build-tool agnostic helpers that work with `SourceFileInfo`.
+ * For build-tool agnostic usage, see `library_generate.ts`.
  *
- * @see @fuzdev/fuz_util/source_json.js for type definitions
- * @see `library_analysis.ts` for the unified analysis entry point
- * @see `library_gen_helpers.ts` for pipeline orchestration helpers
- * @see `tsdoc_helpers.ts` for JSDoc/TSDoc parsing
- * @see `ts_helpers.ts` for TypeScript analysis
- * @see `svelte_helpers.ts` for Svelte component analysis
+ * @see library_generate.ts for the generic generation entry point
+ * @see library_pipeline.ts for pipeline helpers
+ * @see library_output.ts for output file generation
  *
  * @module
  */
@@ -27,9 +17,7 @@
 import type {Gen} from '@ryanatkn/gro';
 import {package_json_load} from '@ryanatkn/gro/package_json.js';
 import type {Disknode} from '@ryanatkn/gro/disknode.js';
-import type {SourceJson, ModuleJson} from '@fuzdev/fuz_util/source_json.js';
 
-import {ts_create_program} from './ts_helpers.js';
 import {
 	type SourceFileInfo,
 	type ModuleSourceOptions,
@@ -39,18 +27,9 @@ import {
 	module_is_source,
 	module_get_source_root,
 } from './module_helpers.js';
-import {library_analyze_module} from './library_analysis.js';
-import {
-	library_sort_modules,
-	library_find_duplicates,
-	library_merge_re_exports,
-	type CollectedReExport,
-	type DuplicateInfo,
-} from './library_gen_helpers.js';
-import {library_generate_json} from './library_gen_output.js';
-import {AnalysisContext, format_diagnostic} from './analysis_context.js';
+import {library_generate, type OnDuplicatesCallback} from './library_generate.js';
 
-/** Options for library generation. */
+/** Options for Gro library generation. */
 export interface LibraryGenOptions {
 	/**
 	 * Module source options for filtering and path extraction.
@@ -64,11 +43,11 @@ export interface LibraryGenOptions {
 	 * Callback invoked when duplicate declaration names are found.
 	 *
 	 * Consumers decide how to handle duplicates: throw, warn, or ignore.
-	 * Use `library_gen_throw_on_duplicates` for strict flat namespace enforcement.
+	 * Use `library_throw_on_duplicates` for strict flat namespace enforcement.
 	 *
 	 * @example
 	 * // Throw on duplicates (strict flat namespace)
-	 * library_gen({ on_duplicates: library_gen_throw_on_duplicates });
+	 * library_gen({ on_duplicates: library_throw_on_duplicates });
 	 *
 	 * // Warn but continue
 	 * library_gen({
@@ -82,45 +61,6 @@ export interface LibraryGenOptions {
 	on_duplicates?: OnDuplicatesCallback;
 }
 
-/**
- * Callback for handling duplicate declaration names.
- *
- * @param duplicates Map of declaration names to their occurrences across modules
- * @param log Logger for reporting
- */
-export type OnDuplicatesCallback = (
-	duplicates: Map<string, Array<DuplicateInfo>>,
-	log: {error: (...args: Array<unknown>) => void},
-) => void;
-
-/**
- * Strict duplicate handler that throws on any duplicate declaration names.
- *
- * Use this callback with `library_gen({ on_duplicates: library_gen_throw_on_duplicates })`
- * to enforce a flat namespace where all declaration names must be unique.
- *
- * @throws Error if any duplicate declaration names are found
- */
-export const library_gen_throw_on_duplicates: OnDuplicatesCallback = (duplicates, log) => {
-	if (duplicates.size === 0) return;
-
-	log.error('Duplicate declaration names detected in flat namespace:');
-	for (const [name, occurrences] of duplicates) {
-		log.error(`  "${name}" found in:`);
-		for (const {declaration, module} of occurrences) {
-			const line_info = declaration.source_line !== undefined ? `:${declaration.source_line}` : '';
-			log.error(`    - ${module}${line_info} (${declaration.kind})`);
-		}
-	}
-	throw new Error(
-		`Found ${duplicates.size} duplicate declaration name${duplicates.size === 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.',
-	);
-};
-
 /**
  * Convert Gro's Disknode to the build-tool agnostic SourceFileInfo interface.
  *
@@ -142,7 +82,6 @@ export const source_file_from_disknode = (disknode: Disknode): SourceFileInfo =>
 	};
 };
 
-// TODO more generic helpers
 /**
  * Collect source files from Gro disknodes, filtering BEFORE conversion to SourceFileInfo.
  *
@@ -192,6 +131,13 @@ export const library_collect_source_files_from_disknodes = (
 /**
  * Creates a Gen object for generating library metadata with full TypeScript analysis.
  *
+ * This is the Gro-specific entry point. It handles:
+ * - Reading files from Gro's filer
+ * - Loading package.json via Gro utilities
+ * - Returning output in Gro's Gen format
+ *
+ * For build-tool agnostic usage, use `library_generate` directly.
+ *
  * Usage in a `.gen.ts` file:
  *
  * ```ts
@@ -213,111 +159,35 @@ export const library_gen = (options?: LibraryGenOptions): Gen => {
 					? options.source
 					: module_create_source_options(process.cwd(), options?.source);
 
-			// Validate options early to fail fast on misconfiguration
-			// (before expensive operations like program creation)
-			module_validate_source_options(source_options);
-
 			// Ensure filer is initialized
 			await filer.init();
 
 			// Read package.json
 			const package_json = await package_json_load();
 
-			// Create TypeScript program
-			const {program} = ts_create_program(undefined, log);
-
-			// Create analysis context for collecting diagnostics
-			const ctx = new AnalysisContext();
-
-			// Collect source files, filtering by source_options BEFORE converting to SourceFileInfo
-			// This avoids errors from files outside source directories (like test fixtures)
+			// Collect source files from Gro filer
 			const source_files = library_collect_source_files_from_disknodes(
 				filer.files.values(),
 				source_options,
 				log,
 			);
 
-			// Collect modules (declared before source_json to include directly)
-			const modules: Array<ModuleJson> = [];
-
-			// Build source_json with array-based modules
-			// Phase 1: Analyze all modules and collect re-exports
-			const source_json: SourceJson = {
-				name: package_json.name,
-				version: package_json.version,
-				modules,
-			};
-
-			// Collect re-exports for phase 2 merging
-			// See library_merge_re_exports for the two-phase resolution strategy
-			const collected_re_exports: Array<CollectedReExport> = [];
-
-			for (const source_file of source_files) {
-				// Use unified analyzer that dispatches based on file type
-				const result = library_analyze_module(source_file, program, source_options, ctx, log);
-				if (!result) continue;
-
-				// Build ModuleJson, filtering out @nodocs declarations
-				const module: ModuleJson = {
-					path: result.path,
-					declarations: result.declarations.filter((d) => !d.nodocs).map((d) => d.declaration),
-				};
-				if (result.module_comment) module.module_comment = result.module_comment;
-				if (result.dependencies.length > 0) module.dependencies = result.dependencies;
-				if (result.dependents.length > 0) module.dependents = result.dependents;
-				if (result.star_exports.length > 0) module.star_exports = result.star_exports;
-
-				modules.push(module);
-
-				// Collect re-exports for phase 2 merging
-				for (const re_export of result.re_exports) {
-					collected_re_exports.push({re_exporting_module: result.path, re_export});
-				}
-			}
-
-			// Phase 2: Build also_exported_from arrays from re-export data
-			library_merge_re_exports(source_json, collected_re_exports);
-
-			// Sort modules alphabetically for deterministic output and cleaner diffs
-			source_json.modules = library_sort_modules(modules);
-
-			// Check for duplicate declaration names and invoke callback if provided
-			if (options?.on_duplicates) {
-				const duplicates = library_find_duplicates(source_json);
-				if (duplicates.size > 0) {
-					options.on_duplicates(duplicates, log);
-				}
-			}
-
-			// Report any analysis diagnostics
-			if (ctx.diagnostics.length > 0) {
-				const errors = ctx.errors();
-				const warnings = ctx.warnings();
-				const format_options = {strip_base: process.cwd()};
-
-				if (errors.length > 0) {
-					log.error(`Analysis completed with ${errors.length} error(s):`);
-					for (const diagnostic of errors) {
-						log.error(`  ${format_diagnostic(diagnostic, format_options)}`);
-					}
-				}
-
-				if (warnings.length > 0) {
-					log.warn(`Analysis completed with ${warnings.length} warning(s):`);
-					for (const diagnostic of warnings) {
-						log.warn(`  ${format_diagnostic(diagnostic, format_options)}`);
-					}
-				}
-			}
+			// Use generic library_generate for the actual work
+			const result = library_generate({
+				source_files,
+				package_json,
+				source_options,
+				on_duplicates: options?.on_duplicates,
+				log,
+			});
 
 			log.info('library metadata generation complete');
 
-			const {json_content, ts_content} = library_generate_json(package_json, source_json);
-
-			// Return array of files:
-			// - library.json (default from .gen.json.ts naming)
-			// - library.ts (typed wrapper that validates with zod)
-			return [{content: ts_content}, {content: json_content, filename: 'library.json'}];
+			// Return array of files in Gro's expected format
+			return [
+				{content: result.ts_content},
+				{content: result.json_content, filename: 'library.json'},
+			];
 		},
 	};
 };

package/src/lib/library_generate.ts

@@ -0,0 +1,215 @@
+/**
+ * Generic library metadata generation.
+ *
+ * This module provides build-tool agnostic library generation. It takes source files
+ * and package metadata, analyzes them, and produces structured metadata with:
+ * - JSDoc/TSDoc comments with full tag support
+ * - Full type signatures
+ * - Source code locations
+ * - Parameter information with descriptions and defaults
+ * - Return value documentation
+ * - Usage examples
+ * - Dependency graphs
+ * - Svelte component props
+ *
+ * For Gro integration, see `library_gen.ts` which wraps this with Gro's Gen interface.
+ *
+ * @see @fuzdev/fuz_util/source_json.js for type definitions
+ * @see `library_analysis.ts` for the unified analysis entry point
+ * @see `library_pipeline.ts` for pipeline helpers
+ * @see `library_output.ts` for JSON/TS file generation
+ *
+ * @module
+ */
+
+import type ts from 'typescript';
+import type {SourceJson, ModuleJson} from '@fuzdev/fuz_util/source_json.js';
+import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
+import type {Logger} from '@fuzdev/fuz_util/log.js';
+
+import {ts_create_program} from './ts_helpers.js';
+import {type SourceFileInfo, type ModuleSourceOptions} from './module_helpers.js';
+import {library_analyze_module} from './library_analysis.js';
+import {
+	library_sort_modules,
+	library_find_duplicates,
+	library_merge_re_exports,
+	type CollectedReExport,
+	type DuplicateInfo,
+} from './library_pipeline.js';
+import {library_generate_output} from './library_output.js';
+import {AnalysisContext, format_diagnostic} from './analysis_context.js';
+
+/**
+ * Callback for handling duplicate declaration names.
+ *
+ * @param duplicates Map of declaration names to their occurrences across modules
+ * @param log Logger for reporting
+ */
+export type OnDuplicatesCallback = (
+	duplicates: Map<string, Array<DuplicateInfo>>,
+	log: {error: (...args: Array<unknown>) => void},
+) => void;
+
+/**
+ * Strict duplicate handler that throws on any duplicate declaration names.
+ *
+ * Use this callback with `library_generate({ on_duplicates: library_throw_on_duplicates })`
+ * to enforce a flat namespace where all declaration names must be unique.
+ *
+ * @throws Error if any duplicate declaration names are found
+ */
+export const library_throw_on_duplicates: OnDuplicatesCallback = (duplicates, log) => {
+	if (duplicates.size === 0) return;
+
+	log.error('Duplicate declaration names detected in flat namespace:');
+	for (const [name, occurrences] of duplicates) {
+		log.error(`  "${name}" found in:`);
+		for (const {declaration, module} of occurrences) {
+			const line_info = declaration.source_line !== undefined ? `:${declaration.source_line}` : '';
+			log.error(`    - ${module}${line_info} (${declaration.kind})`);
+		}
+	}
+	throw new Error(
+		`Found ${duplicates.size} duplicate declaration name${duplicates.size === 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.',
+	);
+};
+
+/** Input for library metadata generation. */
+export interface LibraryGenerateInput {
+	/** Source files to analyze (must have content loaded). */
+	source_files: Array<SourceFileInfo>;
+	/** Package metadata (name, version). */
+	package_json: PackageJson;
+	/** Module source options for path extraction. */
+	source_options: ModuleSourceOptions;
+	/**
+	 * Optional TypeScript program. If not provided, one will be created.
+	 * Pass an existing program to reuse across multiple calls.
+	 */
+	program?: ts.Program;
+	/** Optional callback for handling duplicate declaration names. */
+	on_duplicates?: OnDuplicatesCallback;
+	/** Optional logger for status and diagnostic messages. */
+	log?: Logger;
+}
+
+/** Result of library metadata generation. */
+export interface LibraryGenerateResult {
+	/** The generated source metadata. */
+	source_json: SourceJson;
+	/** JSON file content string. */
+	json_content: string;
+	/** TypeScript wrapper file content string. */
+	ts_content: string;
+}
+
+/**
+ * Generate library metadata from source files.
+ *
+ * This is the main entry point for library generation. It analyzes source files,
+ * extracts metadata, and produces both structured data and file contents.
+ *
+ * @example
+ * ```ts
+ * const result = library_generate({
+ *   source_files,
+ *   package_json: {name: '@my/lib', version: '1.0.0'},
+ *   source_options: module_create_source_options(process.cwd()),
+ * });
+ *
+ * await writeFile('library.json', result.json_content);
+ * await writeFile('library.ts', result.ts_content);
+ * ```
+ */
+export const library_generate = (input: LibraryGenerateInput): LibraryGenerateResult => {
+	const {source_files, package_json, source_options, on_duplicates, log} = input;
+
+	// Create or use provided TypeScript program
+	const program = input.program ?? ts_create_program(undefined, log).program;
+
+	// Create analysis context for collecting diagnostics
+	const ctx = new AnalysisContext();
+
+	// Collect modules
+	const modules: Array<ModuleJson> = [];
+
+	// Build source_json with array-based modules
+	// Phase 1: Analyze all modules and collect re-exports
+	const source_json: SourceJson = {
+		name: package_json.name,
+		version: package_json.version,
+		modules,
+	};
+
+	// Collect re-exports for phase 2 merging
+	// See library_merge_re_exports for the two-phase resolution strategy
+	const collected_re_exports: Array<CollectedReExport> = [];
+
+	for (const source_file of source_files) {
+		// Use unified analyzer that dispatches based on file type
+		const result = library_analyze_module(source_file, program, source_options, ctx, log);
+		if (!result) continue;
+
+		// Build ModuleJson, filtering out @nodocs declarations
+		const module: ModuleJson = {
+			path: result.path,
+			declarations: result.declarations.filter((d) => !d.nodocs).map((d) => d.declaration),
+		};
+		if (result.module_comment) module.module_comment = result.module_comment;
+		if (result.dependencies.length > 0) module.dependencies = result.dependencies;
+		if (result.dependents.length > 0) module.dependents = result.dependents;
+		if (result.star_exports.length > 0) module.star_exports = result.star_exports;
+
+		modules.push(module);
+
+		// Collect re-exports for phase 2 merging
+		for (const re_export of result.re_exports) {
+			collected_re_exports.push({re_exporting_module: result.path, re_export});
+		}
+	}
+
+	// Phase 2: Build also_exported_from arrays from re-export data
+	library_merge_re_exports(source_json, collected_re_exports);
+
+	// Sort modules alphabetically for deterministic output and cleaner diffs
+	source_json.modules = library_sort_modules(modules);
+
+	// Check for duplicate declaration names and invoke callback if provided
+	if (on_duplicates) {
+		const duplicates = library_find_duplicates(source_json);
+		if (duplicates.size > 0) {
+			// Use provided logger or a minimal fallback
+			const error_log = log ?? {error: (...args: Array<unknown>) => console.error(...args)}; // eslint-disable-line no-console
+			on_duplicates(duplicates, error_log);
+		}
+	}
+
+	// Report any analysis diagnostics
+	if (ctx.diagnostics.length > 0 && log) {
+		const errors = ctx.errors();
+		const warnings = ctx.warnings();
+		const format_options = {strip_base: source_options.project_root};
+
+		if (errors.length > 0) {
+			log.error(`Analysis completed with ${errors.length} error(s):`);
+			for (const diagnostic of errors) {
+				log.error(`  ${format_diagnostic(diagnostic, format_options)}`);
+			}
+		}
+
+		if (warnings.length > 0) {
+			log.warn(`Analysis completed with ${warnings.length} warning(s):`);
+			for (const diagnostic of warnings) {
+				log.warn(`  ${format_diagnostic(diagnostic, format_options)}`);
+			}
+		}
+	}
+
+	const {json_content, ts_content} = library_generate_output(package_json, source_json);
+
+	return {source_json, json_content, ts_content};
+};

package/src/lib/library_helpers.ts

@@ -1,67 +1,52 @@
-import {ensure_end, strip_end, strip_start} from '@fuzdev/fuz_util/string.js';
-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
+ */
+
+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: string): string =>
 	`${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: string, declaration_name: string): string =>
 	`${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: string): string => `${DOCS_API_PATH}/${module_path}`;
 
-/**
- * Build GitHub file URL for a repository.
- */
-export const url_github_file = (repo_url: string, file_path: string, line?: number): string => {
-	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: string, repo_name: string): string | null => {
-	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: string): string | null => {
-	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: string): string =>
-	'https://www.npmjs.com/package/' + package_name;
-
-/**
- * Check if a package is published to npm.
- */
-export const package_is_published = (package_json: PackageJson): boolean => {
-	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: string | null,
@@ -72,39 +57,19 @@ export const url_package_logo = (
 	return ensure_end(homepage_url, '/') + path;
 };
 
-/**
- * Extract repository name without scope from package name.
- */
-export const repo_name_parse = (name: string): string => {
-	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: PackageJson['repository']): string | null => {
-	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: string, filename: string): string => {
-	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: string, origin: string = page.url.origin): string => {
 	const origin_with_slash = ensure_end(origin, '/');

package/src/lib/{library_gen_output.ts → library_output.ts}

@@ -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
  */
@@ -14,10 +15,10 @@ import type {SourceJson} from '@fuzdev/fuz_util/source_json.js';
 import {library_json_parse, type LibraryJson} from '@fuzdev/fuz_util/library_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 */
@@ -34,10 +35,10 @@ 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 const library_generate_json = (
+export const library_generate_output = (
 	package_json: PackageJson,
 	source_json: SourceJson,
-): LibraryGenResult => {
+): LibraryOutputResult => {
 	const is_this_fuz_util = package_json.name === '@fuzdev/fuz_util';
 	const fuz_util_prefix = is_this_fuz_util ? './' : '@fuzdev/fuz_util/';