@ryanatkn/gro 0.143.3 → 0.144.0

package/src/lib/gro_plugin_moss.ts

@@ -0,0 +1,122 @@
+import {EMPTY_OBJECT} from '@ryanatkn/belt/object.js';
+import {throttle} from '@ryanatkn/belt/throttle.js';
+import {Unreachable_Error} from '@ryanatkn/belt/error.js';
+import {writeFileSync} from 'node:fs';
+import {collect_css_classes, Css_Classes} from '@ryanatkn/moss/css_class_helpers.js';
+import {css_classes_by_name} from '@ryanatkn/moss/css_classes.js';
+
+import type {Plugin} from './plugin.js';
+import type {Args} from './args.js';
+import type {Cleanup_Watch} from './filer.js';
+import {format_file} from './format_file.js';
+import type {File_Filter} from './path.js';
+
+export const generate_classes_css = (classes: Iterable<string>): string => {
+	let css = '';
+	for (const c of classes) {
+		const v = css_classes_by_name[c];
+		if (!v) {
+			// diagnostic
+			// if (!/^[a-z_0-9]+$/.test(c)) {
+			// 	console.error('invalid class detected, fix the regexps', c);
+			// }
+			continue;
+		}
+		if ('declaration' in v) {
+			css += `.${c} { ${v.declaration} }\n`;
+		} else {
+			css += v.ruleset + '\n';
+		}
+	}
+
+	return css;
+};
+
+const FLUSH_DEBOUNCE_DELAY = 500;
+
+export interface Task_Args extends Args {
+	watch?: boolean;
+}
+
+export interface Options {
+	include_classes?: string[] | Set<string> | null;
+	outfile?: string;
+	filter_file?: File_Filter | null;
+	flush_debounce_delay?: number;
+	banner?: string;
+}
+
+export const gro_plugin_moss = ({
+	include_classes = null,
+	outfile = 'src/routes/moss.css', // TODO maybe support multiple files using file filters to check where to collect them?
+	filter_file = (p) => !p.includes('.test.') && !p.includes('/test/'),
+	flush_debounce_delay = FLUSH_DEBOUNCE_DELAY,
+	banner = 'generated by gro_plugin_moss',
+}: Options = EMPTY_OBJECT): Plugin => {
+	const css_classes = new Css_Classes(
+		Array.isArray(include_classes) ? new Set(include_classes) : include_classes,
+	);
+
+	let previous_output: string | undefined;
+
+	let flushing_timeout: NodeJS.Timeout | undefined;
+	const queue_gen = () => {
+		if (flushing_timeout === undefined) {
+			flushing_timeout = setTimeout(() => {
+				flushing_timeout = undefined;
+				void flush_gen_queue();
+			}); // the timeout batches synchronously
+		}
+	};
+	const flush_gen_queue = throttle(
+		async () => {
+			const css = generate_classes_css(css_classes.get_sorted_array());
+			const contents = `/* ${banner} */\n\n${css}\n\n/* ${banner} */`;
+			const output = await format_file(contents, {filepath: outfile});
+			// TODO think about using gen to implement this, would have some nice benefits like automatic change detection
+			if (output === previous_output) return;
+			previous_output = output;
+			writeFileSync(outfile, output);
+		},
+		{delay: flush_debounce_delay, when: 'trailing'},
+	);
+
+	let cleanup: Cleanup_Watch | undefined;
+
+	return {
+		name: 'gro_plugin_moss',
+		setup: async ({filer}) => {
+			// When a file builds, check it and its tree of dependents
+			// for any `.gen.` files that need to run.
+			cleanup = await filer.watch((change, source_file) => {
+				if (filter_file && !filter_file(source_file.id)) {
+					return;
+				}
+				switch (change.type) {
+					case 'add':
+					case 'update': {
+						if (source_file.contents !== null) {
+							const classes = collect_css_classes(source_file.contents);
+							css_classes.add(source_file.id, classes);
+							queue_gen();
+						}
+						break;
+					}
+					case 'delete': {
+						css_classes.delete(source_file.id);
+						break;
+					}
+					default:
+						throw new Unreachable_Error(change.type);
+				}
+			});
+			queue_gen();
+		},
+		teardown: async () => {
+			if (cleanup !== undefined) {
+				await cleanup();
+				cleanup = undefined;
+			}
+		},
+	};
+};

package/src/lib/gro_plugin_server.ts

@@ -33,7 +33,7 @@ export const has_server = (path = SERVER_SOURCE_ID): Result<object, {message: st
 	return {ok: true};
 };
 
-export interface Options {
+export interface Gro_Plugin_Server_Options {
 	/**
 	 * same as esbuild's `entryPoints`
 	 */
@@ -121,7 +121,7 @@ export const gro_plugin_server = ({
 	rebuild_throttle_delay = 1000,
 	cli_command,
 	run, // `dev` default is not available in this scope
-}: Options = {}): Plugin => {
+}: Gro_Plugin_Server_Options = {}): Plugin => {
 	let build_ctx: esbuild.BuildContext | null = null;
 	let watcher: Watch_Node_Fs | null = null;
 	let server_process: Restartable_Process | null = null;

package/src/lib/gro_plugin_sveltekit_app.ts

@@ -13,7 +13,7 @@ import {default_sveltekit_config} from './sveltekit_config.js';
 import {SOURCE_DIRNAME} from './constants.js';
 import {VITE_CLI} from './sveltekit_helpers.js';
 
-export interface Options {
+export interface Gro_Plugin_Sveltekit_App_Options {
 	/**
 	 * Used for finalizing a SvelteKit build like adding a `.nojekyll` file for GitHub Pages.
 	 * @default 'github_pages'
@@ -53,7 +53,7 @@ export const gro_plugin_sveltekit_app = ({
 	well_known_src_json,
 	well_known_src_files,
 	vite_cli = VITE_CLI,
-}: Options = {}): Plugin => {
+}: Gro_Plugin_Sveltekit_App_Options = {}): Plugin => {
 	let sveltekit_process: Spawned_Process | undefined = undefined;
 	return {
 		name: 'gro_plugin_sveltekit_app',

package/src/lib/gro_plugin_sveltekit_library.ts

@@ -9,7 +9,7 @@ import {
 	type Svelte_Package_Options,
 } from './sveltekit_helpers.js';
 
-export interface Options {
+export interface Gro_Plugin_Sveltekit_Library_Options {
 	/**
 	 * The options passed to the SvelteKit packaging CLI.
 	 * @see https://kit.svelte.dev/docs/packaging#options
@@ -25,7 +25,7 @@ export interface Options {
 export const gro_plugin_sveltekit_library = ({
 	svelte_package_options,
 	svelte_package_cli = SVELTE_PACKAGE_CLI,
-}: Options = {}): Plugin => {
+}: Gro_Plugin_Sveltekit_Library_Options = {}): Plugin => {
 	return {
 		name: 'gro_plugin_sveltekit_library',
 		setup: async ({dev, log, config}) => {

package/src/lib/package.ts

@@ -5,7 +5,7 @@ import type {Src_Json} from './src_json.js';
 
 export const package_json = {
 	name: '@ryanatkn/gro',
-	version: '0.143.3',
+	version: '0.144.0',
 	description: 'task runner and toolkit extending SvelteKit',
 	motto: 'generate, run, optimize',
 	glyph: '🌰',
@@ -44,11 +44,11 @@ export const package_json = {
 		'typescript',
 	],
 	dependencies: {
-		'@ryanatkn/belt': '^0.25.3',
+		'@ryanatkn/belt': '^0.26.0',
 		chokidar: '^4.0.1',
 		dotenv: '^16.4.5',
 		'es-module-lexer': '^1.5.4',
-		'esm-env': '^1.0.0',
+		'esm-env': '^1.1.4',
 		mri: '^1.2.0',
 		prettier: '^3.3.3',
 		'prettier-plugin-svelte': '^3.2.7',
@@ -61,21 +61,21 @@ export const package_json = {
 		'@changesets/changelog-git': '^0.2.0',
 		'@changesets/types': '^6.0.0',
 		'@ryanatkn/eslint-config': '^0.5.5',
-		'@ryanatkn/fuz': '^0.130.1',
+		'@ryanatkn/fuz': '^0.130.3',
 		'@ryanatkn/moss': '^0.18.2',
 		'@sveltejs/adapter-static': '^3.0.6',
 		'@sveltejs/kit': '^2.7.3',
 		'@sveltejs/package': '^2.3.7',
 		'@sveltejs/vite-plugin-svelte': '^4.0.0',
 		'@types/fs-extra': '^11.0.4',
-		'@types/node': '^22.8.1',
+		'@types/node': '^22.8.4',
 		esbuild: '^0.21.5',
 		eslint: '^9.13.0',
 		'eslint-plugin-svelte': '^2.46.0',
-		svelte: '^5.1.3',
+		svelte: '^5.1.5',
 		'svelte-check': '^4.0.5',
 		typescript: '^5.6.3',
-		'typescript-eslint': '^8.11.0',
+		'typescript-eslint': '^8.12.1',
 		uvu: '^0.5.6',
 	},
 	prettier: {
@@ -157,6 +157,10 @@ export const package_json = {
 			types: './dist/gro_plugin_gen.d.ts',
 			default: './dist/gro_plugin_gen.js',
 		},
+		'./gro_plugin_moss.js': {
+			types: './dist/gro_plugin_moss.d.ts',
+			default: './dist/gro_plugin_moss.js',
+		},
 		'./gro_plugin_server.js': {
 			types: './dist/gro_plugin_server.d.ts',
 			default: './dist/gro_plugin_server.js',
@@ -267,7 +271,7 @@ export const package_json = {
 
 export const src_json = {
 	name: '@ryanatkn/gro',
-	version: '0.143.3',
+	version: '0.144.0',
 	modules: {
 		'.': {
 			path: 'index.ts',
@@ -431,14 +435,14 @@ export const src_json = {
 		'./esbuild_plugin_external_worker.js': {
 			path: 'esbuild_plugin_external_worker.ts',
 			declarations: [
-				{name: 'Options', kind: 'type'},
+				{name: 'Esbuild_Plugin_External_Worker_Options', kind: 'type'},
 				{name: 'esbuild_plugin_external_worker', kind: 'function'},
 			],
 		},
 		'./esbuild_plugin_svelte.js': {
 			path: 'esbuild_plugin_svelte.ts',
 			declarations: [
-				{name: 'Options', kind: 'type'},
+				{name: 'Esbuild_Plugin_Svelte_Options', kind: 'type'},
 				{name: 'esbuild_plugin_svelte', kind: 'function'},
 			],
 		},
@@ -449,21 +453,21 @@ export const src_json = {
 		'./esbuild_plugin_sveltekit_shim_alias.js': {
 			path: 'esbuild_plugin_sveltekit_shim_alias.ts',
 			declarations: [
-				{name: 'Options', kind: 'type'},
+				{name: 'Esbuild_Plugin_Sveltekit_Shim_Alias_Options', kind: 'type'},
 				{name: 'esbuild_plugin_sveltekit_shim_alias', kind: 'function'},
 			],
 		},
 		'./esbuild_plugin_sveltekit_shim_app.js': {
 			path: 'esbuild_plugin_sveltekit_shim_app.ts',
 			declarations: [
-				{name: 'Options', kind: 'type'},
+				{name: 'Esbuild_Plugin_Sveltekit_Shim_App_Options', kind: 'type'},
 				{name: 'esbuild_plugin_sveltekit_shim_app', kind: 'function'},
 			],
 		},
 		'./esbuild_plugin_sveltekit_shim_env.js': {
 			path: 'esbuild_plugin_sveltekit_shim_env.ts',
 			declarations: [
-				{name: 'Options', kind: 'type'},
+				{name: 'Esbuild_Plugin_Sveltekit_Shim_Env_Options', kind: 'type'},
 				{name: 'esbuild_plugin_sveltekit_shim_env', kind: 'function'},
 			],
 		},
@@ -473,7 +477,7 @@ export const src_json = {
 				{name: 'Source_File', kind: 'type'},
 				{name: 'Cleanup_Watch', kind: 'type'},
 				{name: 'On_Filer_Change', kind: 'type'},
-				{name: 'Options', kind: 'type'},
+				{name: 'Filer_Options', kind: 'type'},
 				{name: 'Filer', kind: 'class'},
 			],
 		},
@@ -594,17 +598,26 @@ export const src_json = {
 			path: 'gro_plugin_gen.ts',
 			declarations: [
 				{name: 'Task_Args', kind: 'type'},
-				{name: 'Options', kind: 'type'},
+				{name: 'Gro_Plugin_Gen_Options', kind: 'type'},
 				{name: 'gro_plugin_gen', kind: 'function'},
 				{name: 'filter_dependents', kind: 'function'},
 			],
 		},
+		'./gro_plugin_moss.js': {
+			path: 'gro_plugin_moss.ts',
+			declarations: [
+				{name: 'generate_classes_css', kind: 'function'},
+				{name: 'Task_Args', kind: 'type'},
+				{name: 'Options', kind: 'type'},
+				{name: 'gro_plugin_moss', kind: 'function'},
+			],
+		},
 		'./gro_plugin_server.js': {
 			path: 'gro_plugin_server.ts',
 			declarations: [
 				{name: 'SERVER_SOURCE_ID', kind: 'variable'},
 				{name: 'has_server', kind: 'function'},
-				{name: 'Options', kind: 'type'},
+				{name: 'Gro_Plugin_Server_Options', kind: 'type'},
 				{name: 'Outpaths', kind: 'type'},
 				{name: 'Create_Outpaths', kind: 'type'},
 				{name: 'gro_plugin_server', kind: 'function'},
@@ -613,7 +626,7 @@ export const src_json = {
 		'./gro_plugin_sveltekit_app.js': {
 			path: 'gro_plugin_sveltekit_app.ts',
 			declarations: [
-				{name: 'Options', kind: 'type'},
+				{name: 'Gro_Plugin_Sveltekit_App_Options', kind: 'type'},
 				{name: 'Host_Target', kind: 'type'},
 				{name: 'Copy_File_Filter', kind: 'type'},
 				{name: 'gro_plugin_sveltekit_app', kind: 'function'},
@@ -622,7 +635,7 @@ export const src_json = {
 		'./gro_plugin_sveltekit_library.js': {
 			path: 'gro_plugin_sveltekit_library.ts',
 			declarations: [
-				{name: 'Options', kind: 'type'},
+				{name: 'Gro_Plugin_Sveltekit_Library_Options', kind: 'type'},
 				{name: 'gro_plugin_sveltekit_library', kind: 'function'},
 			],
 		},
@@ -704,6 +717,7 @@ export const src_json = {
 				{name: 'Package_Json_Repository', kind: 'variable'},
 				{name: 'Package_Json_Author', kind: 'variable'},
 				{name: 'Package_Json_Funding', kind: 'variable'},
+				{name: 'Export_Value', kind: 'variable'},
 				{name: 'Package_Json_Exports', kind: 'variable'},
 				{name: 'Package_Json', kind: 'variable'},
 				{name: 'Map_Package_Json', kind: 'type'},
@@ -1037,7 +1051,7 @@ export const src_json = {
 				{name: 'Watcher_Change', kind: 'type'},
 				{name: 'Watcher_Change_Type', kind: 'type'},
 				{name: 'Watcher_Change_Callback', kind: 'type'},
-				{name: 'Options', kind: 'type'},
+				{name: 'Watch_Dir_Options', kind: 'type'},
 				{name: 'watch_dir', kind: 'function'},
 			],
 		},

package/src/lib/package_json.ts

@@ -63,20 +63,21 @@ export const Package_Json_Funding = z.union([
 ]);
 export type Package_Json_Funding = z.infer<typeof Package_Json_Funding>;
 
-// exports: {
-// 	'./': './index.js',
-// 	'./record': {default: './record.js'},
-//  './export_condition': {default: {development: './ec1', default: './ec2.js'}},
-// }
-export const Package_Json_Exports = z.record(
-	z
-		.union([
-			z.string(),
-			z.record(z.string().optional()),
-			z.record(z.record(z.string().optional()).optional()),
-		])
-		.optional(),
-);
+// Helper to create a recursive type that represents export conditions and values
+const create_export_value_schema = (): z.ZodType => {
+	return z.lazy(() => z.union([z.string(), z.null(), z.record(z.lazy(() => export_value_schema))]));
+};
+
+// The base export value schema that can be a string, null, or nested conditions
+const export_value_schema = create_export_value_schema();
+export const Export_Value = export_value_schema;
+export type Export_Value = z.infer<typeof Export_Value>;
+
+// Package exports can be:
+// 1. A string (shorthand for main export)
+// 2. null (to block exports)
+// 3. A record of export conditions/paths
+export const Package_Json_Exports = z.union([z.string(), z.null(), z.record(export_value_schema)]);
 export type Package_Json_Exports = z.infer<typeof Package_Json_Exports>;
 
 /**