@fuzdev/fuz_ui 0.195.1 → 0.196.0

package/src/lib/library_output.ts

@@ -1,67 +0,0 @@
-/**
- * Library output generation.
- *
- * Generates the library.json and library.ts files from analyzed metadata.
- * Uses svelte-docinfo's `compactReplacer` to strip Zod default values
- * (empty arrays, false booleans) for compact JSON output.
- *
- * @see `library_gen.ts` for the main generation entry point
- * @see {@link https://github.com/ryanatkn/svelte-docinfo svelte-docinfo} for the analysis library
- *
- * @module
- */
-
-import type {PackageJson} from '@fuzdev/fuz_util/package_json.js';
-import type {SourceJson} from '@fuzdev/fuz_util/source_json.js';
-import {library_json_parse, type LibraryJson} from '@fuzdev/fuz_util/library_json.js';
-import {compactReplacer} from 'svelte-docinfo';
-
-/**
- * Result of generating library output files.
- * Contains both the JSON data and the TypeScript wrapper file.
- */
-export interface LibraryOutputResult {
-	/** JSON content for `library.json`. */
-	json_content: string;
-	/** TypeScript wrapper content for `library.ts`. */
-	ts_content: string;
-}
-
-/**
- * Generate the `library.json` and `library.ts` file contents.
- * Parses at generation time so runtime only needs the pre-computed result.
- *
- * Returns JSON + .ts wrapper because:
- * - JSON is natively importable by Node.js and Vite without TypeScript loaders
- * - Works in CI environments that don't have TS compilation
- * - 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_output = (
-	package_json: PackageJson,
-	source_json: SourceJson,
-): LibraryOutputResult => {
-	// Compact source_json (strips Zod default values like empty arrays and false booleans)
-	// Only applied to source_json, not the outer library_json package metadata
-	const compacted_source_json = JSON.parse(JSON.stringify(source_json, compactReplacer));
-
-	// Parse at generation time, not runtime
-	const library_json: LibraryJson = library_json_parse(package_json, compacted_source_json);
-
-	const json_content = JSON.stringify(library_json, null, '\t') + '\n';
-
-	const banner = '// generated by library.gen.ts - do not edit';
-
-	const ts_content = `${banner}
-
-import type {LibraryJson} from '@fuzdev/fuz_util/library_json.js';
-
-import json from './library.json' with {type: 'json'};
-
-export const library_json: LibraryJson = json as LibraryJson;
-
-${banner}
-`;
-
-	return {json_content, ts_content};
-};

package/src/lib/vite_plugin_library_well_known.ts

@@ -1,189 +0,0 @@
-import type {Plugin} from 'vite';
-import type {ServerResponse} from 'node:http';
-import {isAbsolute, join} from 'node:path';
-import {readFile} from 'node:fs/promises';
-import type {LibraryJson} from '@fuzdev/fuz_util/library_json.js';
-
-export interface VitePluginLibraryWellKnownOptions {
-	/**
-	 * Path to the `library.json` file (relative to `vite.config.ts`).
-	 * @default './src/routes/library.json'
-	 */
-	library_path?: string;
-}
-
-interface WellKnownContent {
-	package_json: string | null;
-	library_json: string | null;
-}
-
-const respond_json = (res: ServerResponse, body: string): void => {
-	res.setHeader('Content-Type', 'application/json');
-	res.setHeader('Cache-Control', 'no-store');
-	res.setHeader('Access-Control-Allow-Origin', '*');
-	res.end(body);
-};
-
-/**
- * Vite plugin that publishes `package.json` and `library.json` to `.well-known/`.
- *
- * Requires a generated `library.json` file (created by `library_gen` from `gro gen`).
- * The plugin reads this JSON file and publishes its metadata to `.well-known/` for
- * both dev and production builds.
- *
- * Note: This plugin respects SvelteKit's `base` path configuration, so `.well-known/`
- * will be served at `{base}.well-known/` (e.g., `/my-app/.well-known/`). This deviates
- * from RFC 8615 which specifies `.well-known` should be at the domain root. This tradeoff
- * allows the plugin to work correctly when apps are deployed to non-root paths.
- *
- * Note: CORS headers are only set for the dev server. For production, configure
- * CORS at the server level (nginx, Caddy, etc.) if cross-origin access is needed.
- *
- * @example
- * ```ts
- * // vite.config.ts
- * import {defineConfig} from 'vite';
- * import {sveltekit} from '@sveltejs/kit/vite';
- * import {vite_plugin_library_well_known} from '@fuzdev/fuz_ui/vite_plugin_library_well_known.js';
- *
- * export default defineConfig({
- *   plugins: [sveltekit(), vite_plugin_library_well_known()],
- * });
- * ```
- */
-export const vite_plugin_library_well_known = (
-	options: VitePluginLibraryWellKnownOptions = {},
-): Plugin => {
-	const {library_path = './src/routes/library.json'} = options;
-
-	const content: WellKnownContent = {
-		package_json: null,
-		library_json: null,
-	};
-
-	// Set by configResolved
-	let root: string;
-	let base: string; // e.g., '/' or '/my-app/'
-
-	// Promise that resolves when library is loaded, used by middleware to avoid race condition
-	let ready_promise: Promise<void> | null = null;
-
-	const load_library = async (): Promise<void> => {
-		// Resolve path relative to project root
-		const resolved_path = isAbsolute(library_path) ? library_path : join(root, library_path);
-
-		let json_content: string;
-		try {
-			json_content = await readFile(resolved_path, 'utf-8');
-		} catch (error) {
-			throw new Error(
-				`vite_plugin_library_well_known: failed to read library.json from "${library_path}"\n` +
-					`Resolved to: ${resolved_path}\n` +
-					`Make sure you've run \`gro gen\` to generate the library metadata.\n` +
-					`Error: ${error}`,
-			);
-		}
-
-		let raw: unknown;
-		try {
-			raw = JSON.parse(json_content);
-		} catch (error) {
-			throw new Error(
-				`vite_plugin_library_well_known: failed to parse library.json from "${library_path}"\n` +
-					`Error: ${error}`,
-			);
-		}
-
-		// Basic structure validation (file is generated by library_gen)
-		if (raw == null || typeof raw !== 'object') {
-			throw new Error(
-				`vite_plugin_library_well_known: invalid library.json at "${library_path}"\n` +
-					`Expected object, got ${typeof raw}`,
-			);
-		}
-		if (!('package_json' in raw) || !('source_json' in raw)) {
-			throw new Error(
-				`vite_plugin_library_well_known: invalid library.json at "${library_path}"\n` +
-					`Expected object with package_json and source_json properties`,
-			);
-		}
-		const library_json = raw as LibraryJson;
-
-		content.package_json = JSON.stringify(library_json.package_json, null, '\t') + '\n';
-		content.library_json = JSON.stringify(library_json, null, '\t') + '\n';
-	};
-
-	return {
-		name: 'vite_plugin_library_well_known',
-
-		configResolved(config) {
-			root = config.root;
-			base = config.base; // e.g., '/' or '/my-app/'
-		},
-
-		async buildStart() {
-			ready_promise = load_library();
-			await ready_promise;
-		},
-
-		configureServer(server) {
-			// TODO: add HMR support to reload library.json when it changes
-			const well_known_prefix = `${base}.well-known/`;
-
-			server.middlewares.use(async (req, res, next) => {
-				if (!req.url) {
-					next();
-					return;
-				}
-
-				const {pathname} = new URL(req.url, 'http://localhost');
-				if (!pathname.startsWith(well_known_prefix)) {
-					next();
-					return;
-				}
-
-				// Wait for library to load before serving
-				try {
-					if (!ready_promise) throw new Error('not initialized');
-					await ready_promise;
-				} catch (_error) {
-					res.statusCode = 503;
-					respond_json(res, JSON.stringify({error: 'Library not ready'}));
-					return;
-				}
-
-				const path = pathname.slice(well_known_prefix.length);
-
-				if (path === 'package.json' && content.package_json) {
-					respond_json(res, content.package_json);
-					return;
-				}
-
-				if (path === 'library.json' && content.library_json) {
-					respond_json(res, content.library_json);
-					return;
-				}
-
-				next();
-			});
-		},
-
-		generateBundle() {
-			if (content.package_json) {
-				this.emitFile({
-					type: 'asset',
-					fileName: '.well-known/package.json',
-					source: content.package_json,
-				});
-			}
-
-			if (content.library_json) {
-				this.emitFile({
-					type: 'asset',
-					fileName: '.well-known/library.json',
-					source: content.library_json,
-				});
-			}
-		},
-	};
-};