@fuzdev/fuz_ui 0.198.1 → 0.199.0

package/src/lib/vite_plugin_pkg_json.ts

@@ -0,0 +1,142 @@
+/**
+ * Vite plugin serving a curated, publish-safe `package.json` as the virtual
+ * module `virtual:pkg.json`.
+ *
+ * Consumers' `src/routes/library.ts` (and root layouts) need package identity —
+ * name, version, the Fuz extension fields — in the client. Importing the root
+ * `package.json` directly inlines the *whole* file into the client bundle
+ * (`scripts`, `dependencies`, `devDependencies`, private config) and trips
+ * SvelteKit's `server.fs.allow` on cold HMR reloads. This plugin reads the
+ * project's `package.json` at build time, strips it to `pkg_json_keys`, and
+ * serves only that subset. Consumers combine it with `virtual:svelte-docinfo`'s
+ * analyzed `modules` via `library_json_from_modules` to build a `LibraryJson`
+ * (see `src/routes/library.ts` for the canonical pattern).
+ *
+ * The `.json` suffix on the virtual id is load-bearing, mirroring how
+ * `vite_plugin_fuz_css`'s `virtual:fuz.css` relies on `.css`: `load()` returns
+ * raw JSON text and Vite's built-in `vite:json` plugin transforms it into an ES
+ * module (default export plus named exports), so consumers write
+ * `import package_json from 'virtual:pkg.json'`. Do *not* return a JS module
+ * here — the `.json` id would double-transform it.
+ *
+ * ```ts
+ * // vite.config.ts
+ * import {vite_plugin_pkg_json} from '@fuzdev/fuz_ui/vite_plugin_pkg_json.js';
+ * export default defineConfig({plugins: [vite_plugin_pkg_json(), sveltekit()]});
+ * ```
+ *
+ * The kept field set defaults to `pkg_json_keys`. To expose extra publish-safe
+ * fields, pass a wider `keys` list — typically composed from the default with a
+ * spread (`` keys: [...pkg_json_keys, 'keywords'] ``). Because `library_json_from_modules`
+ * re-strips at runtime, the *same* list must reach that call (and the consumer's
+ * `virtual:pkg.json` ambient type) for the extras to survive end to end — share
+ * one const across all three sites:
+ *
+ * ```ts
+ * // src/routes/pkg_json_keys.ts
+ * import {pkg_json_keys} from '@fuzdev/fuz_util/pkg_json.js';
+ * export const pkg_json_keys_custom = [...pkg_json_keys, 'keywords'] as const;
+ *
+ * // vite.config.ts        → vite_plugin_pkg_json({keys: pkg_json_keys_custom})
+ * // src/routes/library.ts → library_json_from_modules(pkg_json, modules, pkg_json_keys_custom)
+ * ```
+ *
+ * @module
+ */
+
+import {readFileSync} from 'node:fs';
+import {join} from 'node:path';
+import type {Plugin, Rollup} from 'vite';
+import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
+import {pkg_json_from_package_json, pkg_json_keys} from '@fuzdev/fuz_util/pkg_json.js';
+
+const VIRTUAL_ID = 'virtual:pkg.json';
+/**
+ * Resolved id, `\0`-prefixed — the conventional Rollup marker for "this id is
+ * mine," hiding the virtual module from other plugins and the dev module graph.
+ *
+ * This deliberately diverges from `vite_plugin_fuz_css`, which avoids the `\0`
+ * on its resolved id: SvelteKit's dev FOUC prevention inlines `virtual:fuz.css`
+ * into the SSR'd `<head>` via URL lookup and can't resolve the `\0`-encoded
+ * form, so the page would flash unstyled. JSON is never inlined into `<head>`,
+ * so that constraint doesn't apply here and the `\0` is free to do its normal
+ * job. The trailing `.json` survives the prefix, so Vite's built-in `vite:json`
+ * plugin still matches and transforms the loaded text (see the module comment).
+ */
+const RESOLVED_VIRTUAL_ID = '\0virtual:pkg.json';
+
+/** Options for `vite_plugin_pkg_json`. */
+export interface VitePluginPkgJsonOptions {
+	/**
+	 * The `package.json` fields to keep in the served subset. Defaults to the
+	 * curated, publish-safe `pkg_json_keys`. Pass a wider list — usually
+	 * `` [...pkg_json_keys, 'extra'] `` — to expose more fields; the same list
+	 * must reach `library_json_from_modules` (see the module comment).
+	 */
+	keys?: ReadonlyArray<keyof PackageJson>;
+}
+
+/**
+ * Creates the `virtual:pkg.json` plugin. Zero-config for canonical fuz usage —
+ * the publish-safe field set defaults to `pkg_json_keys`; widen it via `keys`.
+ */
+export const vite_plugin_pkg_json = (options: VitePluginPkgJsonOptions = {}): Plugin => {
+	const {keys = pkg_json_keys} = options;
+	let root = '';
+	let is_dev = false;
+	/** Curated JSON cached for build; left `null` in dev so `load` re-reads. */
+	let cached: string | null = null;
+
+	/**
+	 * Reads `package.json`, strips it to the configured `keys` subset via
+	 * `pkg_json_from_package_json` (the same strip the runtime uses, so the two
+	 * can't drift), and returns the curated JSON text. Routes failures through the
+	 * plugin context (`ctx.error`/`ctx.warn`) so a missing or malformed file
+	 * surfaces as a named, actionable diagnostic rather than a raw
+	 * `readFileSync`/`JSON.parse` stack trace.
+	 */
+	const read_curated = (ctx: Rollup.PluginContext): string => {
+		const package_json_path = join(root, 'package.json');
+		ctx.addWatchFile(package_json_path); // re-emit when package.json changes
+		let raw: PackageJson;
+		try {
+			raw = JSON.parse(readFileSync(package_json_path, 'utf8')) as PackageJson;
+		} catch (err) {
+			// ctx.error throws, so this never returns
+			return ctx.error(
+				`vite_plugin_pkg_json: failed to read or parse ${package_json_path}: ${(err as Error).message}`,
+			);
+		}
+		if (raw.name === undefined) {
+			ctx.warn(`vite_plugin_pkg_json: ${package_json_path} has no "name" field`);
+		}
+		return JSON.stringify(pkg_json_from_package_json(raw, keys));
+	};
+
+	return {
+		name: 'vite-plugin-pkg-json',
+		// Resolve the virtual id before other plugins claim it.
+		enforce: 'pre',
+		configResolved(config) {
+			root = config.root;
+			is_dev = config.command === 'serve';
+		},
+		buildStart() {
+			// Read package.json once up front so a missing or malformed file fails
+			// immediately — at build start, or at dev-server startup — rather than
+			// only when something first imports the virtual module. In build the
+			// result is cached for `load`; in dev `load` re-reads each time so edits
+			// to package.json propagate through the `addWatchFile`-driven reload.
+			const curated = read_curated(this);
+			if (!is_dev) cached = curated;
+		},
+		resolveId(id) {
+			if (id === VIRTUAL_ID) return RESOLVED_VIRTUAL_ID;
+			return undefined;
+		},
+		load(id) {
+			if (id !== RESOLVED_VIRTUAL_ID) return undefined;
+			return cached ?? read_curated(this);
+		},
+	};
+};

package/dist/package_helpers.d.ts

@@ -1,150 +0,0 @@
-/**
- * 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
- *
- * 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
- * ```ts
- * url_github_file('https://github.com/foo/bar', 'src/index.ts')
- * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
- * ```
- *
- * @example
- * ```ts
- * 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
- * ```ts
- * 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
- * ```ts
- * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
- * // => 'fuzdev'
- * ```
- *
- * @example
- * ```ts
- * 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
- * ```ts
- * 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
- * ```ts
- * repo_name_parse('@fuzdev/fuz_ui')
- * // => 'fuz_ui'
- * ```
- *
- * @example
- * ```ts
- * 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
- * ```ts
- * repo_url_parse('https://github.com/foo/bar')
- * // => 'https://github.com/foo/bar'
- * ```
- *
- * @example
- * ```ts
- * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
- * // => 'https://github.com/foo/bar'
- * ```
- *
- * @example
- * ```ts
- * repo_url_parse(undefined)
- * // => null
- * ```
- */
-export declare const repo_url_parse: (repository: PackageJson["repository"]) => string | null;
-//# sourceMappingURL=package_helpers.d.ts.map

package/dist/package_helpers.d.ts.map

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

package/dist/package_helpers.js

@@ -1,179 +0,0 @@
-/**
- * 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
- *
- * 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 { 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
- * ```ts
- * url_github_file('https://github.com/foo/bar', 'src/index.ts')
- * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
- * ```
- *
- * @example
- * ```ts
- * 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
- * ```ts
- * 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
- * ```ts
- * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
- * // => 'fuzdev'
- * ```
- *
- * @example
- * ```ts
- * 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
- * ```ts
- * 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
- * ```ts
- * repo_name_parse('@fuzdev/fuz_ui')
- * // => 'fuz_ui'
- * ```
- *
- * @example
- * ```ts
- * 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
- * ```ts
- * repo_url_parse('https://github.com/foo/bar')
- * // => 'https://github.com/foo/bar'
- * ```
- *
- * @example
- * ```ts
- * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
- * // => 'https://github.com/foo/bar'
- * ```
- *
- * @example
- * ```ts
- * 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+'), '/');
-};

package/src/lib/package_helpers.ts

@@ -1,186 +0,0 @@
-/**
- * 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
- *
- * 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 {strip_end, strip_start} from '@fuzdev/fuz_util/string.js';
-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
- * ```ts
- * url_github_file('https://github.com/foo/bar', 'src/index.ts')
- * // => 'https://github.com/foo/bar/blob/main/src/index.ts'
- * ```
- *
- * @example
- * ```ts
- * 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: 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.
- *
- * @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
- * ```ts
- * url_github_org('https://github.com/fuzdev/fuz_ui', 'fuz_ui')
- * // => 'https://github.com/fuzdev'
- * ```
- */
-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;
-};
-
-/**
- * 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
- * ```ts
- * repo_url_github_owner('https://github.com/fuzdev/fuz_ui')
- * // => 'fuzdev'
- * ```
- *
- * @example
- * ```ts
- * repo_url_github_owner('https://gitlab.com/foo/bar')
- * // => null (not a GitHub URL)
- * ```
- */
-export const repo_url_github_owner = (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.
- *
- * @param package_name - package name (can be scoped like '@org/package')
- * @returns full npm package page URL
- *
- * @example
- * ```ts
- * url_npm_package('@fuzdev/fuz_ui')
- * // => 'https://www.npmjs.com/package/@fuzdev/fuz_ui'
- * ```
- */
-export const url_npm_package = (package_name: string): string =>
-	'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: PackageJson): boolean => {
-	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
- * ```ts
- * repo_name_parse('@fuzdev/fuz_ui')
- * // => 'fuz_ui'
- * ```
- *
- * @example
- * ```ts
- * repo_name_parse('lodash')
- * // => 'lodash'
- * ```
- */
-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.
- *
- * 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
- * ```ts
- * repo_url_parse('https://github.com/foo/bar')
- * // => 'https://github.com/foo/bar'
- * ```
- *
- * @example
- * ```ts
- * repo_url_parse({url: 'git+https://github.com/foo/bar.git'})
- * // => 'https://github.com/foo/bar'
- * ```
- *
- * @example
- * ```ts
- * repo_url_parse(undefined)
- * // => null
- * ```
- */
-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+'), '/');
-};