@ryanatkn/gro 0.169.1 → 0.171.0

package/src/lib/package.ts

@@ -5,7 +5,7 @@ import type {Src_Json} from '@ryanatkn/belt/src_json.js';
 
 export const package_json: Package_Json = {
 	name: '@ryanatkn/gro',
-	version: '0.169.1',
+	version: '0.171.0',
 	description: 'task runner and toolkit extending SvelteKit',
 	motto: 'generate, run, optimize',
 	glyph: '🌰',
@@ -44,7 +44,6 @@ export const package_json: Package_Json = {
 		'typescript',
 	],
 	dependencies: {
-		'@ryanatkn/belt': '^0.35.1',
 		chokidar: '^4.0.3',
 		dotenv: '^17.2.2',
 		'esm-env': '^1.2.2',
@@ -54,36 +53,37 @@ export const package_json: Package_Json = {
 		'prettier-plugin-svelte': '^3.4.0',
 		'ts-blank-space': '^0.6.2',
 		tslib: '^2.8.1',
-		zod: '^4.1.5',
+		zod: '^4.1.12',
 	},
 	peerDependencies: {
+		'@ryanatkn/belt': '^0.36.0',
 		'@sveltejs/kit': '^2',
 		esbuild: '^0.25',
 		svelte: '^5',
 		typescript: '^5',
-		vitest: '^3',
+		vitest: '^3 || ^4',
 	},
 	peerDependenciesMeta: {'@sveltejs/kit': {optional: true}, vitest: {optional: true}},
-	optionalDependencies: {vitest: '^3'},
+	optionalDependencies: {vitest: '^3 || ^4'},
 	devDependencies: {
 		'@changesets/changelog-git': '^0.2.1',
 		'@changesets/types': '^6.1.0',
 		'@ryanatkn/eslint-config': '^0.8.0',
 		'@ryanatkn/fuz': '^0.147.0',
 		'@ryanatkn/moss': '^0.36.0',
-		'@sveltejs/adapter-static': '^3.0.9',
-		'@sveltejs/kit': '^2.37.1',
-		'@sveltejs/package': '^2.5.0',
-		'@sveltejs/vite-plugin-svelte': '^6.1.4',
+		'@sveltejs/adapter-static': '^3.0.10',
+		'@sveltejs/kit': '^2.47.2',
+		'@sveltejs/package': '^2.5.4',
+		'@sveltejs/vite-plugin-svelte': '^6.2.1',
 		'@types/node': '^24.3.1',
 		esbuild: '^0.25.9',
 		eslint: '^9.35.0',
-		'eslint-plugin-svelte': '^3.12.2',
-		svelte: '^5.38.7',
-		'svelte-check': '^4.3.2',
-		typescript: '^5.9.2',
+		'eslint-plugin-svelte': '^3.12.5',
+		svelte: '^5.41.2',
+		'svelte-check': '^4.3.3',
+		typescript: '^5.9.3',
 		'typescript-eslint': '^8.42.0',
-		vitest: '^3.2.4',
+		vitest: '^4.0.3',
 	},
 	prettier: {
 		plugins: ['prettier-plugin-svelte'],
@@ -105,7 +105,7 @@ export const package_json: Package_Json = {
 
 export const src_json: Src_Json = {
 	name: '@ryanatkn/gro',
-	version: '0.169.1',
+	version: '0.171.0',
 	modules: {
 		'.': {
 			path: 'index.ts',
@@ -138,10 +138,28 @@ export const src_json: Src_Json = {
 				{name: 'print_command_args', kind: 'function'},
 			],
 		},
+		'./build_cache.js': {
+			path: 'build_cache.ts',
+			declarations: [
+				{name: 'BUILD_CACHE_METADATA_FILENAME', kind: 'variable'},
+				{name: 'BUILD_CACHE_VERSION', kind: 'variable'},
+				{name: 'Build_Output_Entry', kind: 'variable'},
+				{name: 'Build_Cache_Metadata', kind: 'variable'},
+				{name: 'compute_build_cache_key', kind: 'function'},
+				{name: 'load_build_cache_metadata', kind: 'function'},
+				{name: 'save_build_cache_metadata', kind: 'function'},
+				{name: 'validate_build_cache', kind: 'function'},
+				{name: 'is_build_cache_valid', kind: 'function'},
+				{name: 'collect_build_outputs', kind: 'function'},
+				{name: 'discover_build_output_dirs', kind: 'function'},
+				{name: 'create_build_cache_metadata', kind: 'function'},
+			],
+		},
 		'./build.task.js': {
 			path: 'build.task.ts',
 			declarations: [
 				{name: 'Args', kind: 'variable'},
+				{name: 'GIT_SHORT_HASH_LENGTH', kind: 'variable'},
 				{name: 'task', kind: 'variable'},
 			],
 		},
@@ -414,6 +432,7 @@ export const src_json: Src_Json = {
 		'./gro_config.js': {
 			path: 'gro_config.ts',
 			declarations: [
+				{name: 'EMPTY_BUILD_CACHE_CONFIG_HASH', kind: 'variable'},
 				{name: 'Gro_Config', kind: 'type'},
 				{name: 'Raw_Gro_Config', kind: 'type'},
 				{name: 'Create_Gro_Config', kind: 'type'},
@@ -826,16 +845,6 @@ export const src_json: Src_Json = {
 				{name: 'validate_task_module', kind: 'function'},
 			],
 		},
-		'./test_helpers.js': {
-			path: 'test_helpers.ts',
-			declarations: [
-				{name: 'TEST_TIMEOUT_MD', kind: 'variable'},
-				{name: 'SOME_PUBLIC_ENV_VAR_NAME', kind: 'variable'},
-				{name: 'SOME_PUBLIC_ENV_VAR_VALUE', kind: 'variable'},
-				{name: 'init_test_env', kind: 'function'},
-				{name: 'create_ts_test_env', kind: 'function'},
-			],
-		},
 		'./test.task.js': {
 			path: 'test.task.ts',
 			declarations: [

package/src/lib/package_json.ts

@@ -34,7 +34,7 @@ export const load_package_json = (
 ): Package_Json => {
 	let package_json: Package_Json;
 	if (cache && dir in cache) {
-		return cache[dir];
+		return cache[dir]!;
 	}
 	try {
 		package_json = JSON.parse(load_package_json_contents(dir));
@@ -194,7 +194,7 @@ export const parse_repo_url = (
 		return;
 	}
 	const [, owner, repo] = parsed_repo_url;
-	return {owner, repo};
+	return {owner: owner!, repo: repo!};
 };
 
 /**

package/src/lib/parse_exports_context.ts

@@ -130,7 +130,7 @@ export class Parse_Exports_Context {
 
 		// If no direct match from flags, look at declarations
 		if (symbol.declarations && symbol.declarations.length > 0) {
-			const decl = symbol.declarations[0];
+			const decl = symbol.declarations[0]!;
 			const kind_from_decl = this.#infer_kind_from_declaration(decl);
 			if (kind_from_decl) {
 				return kind_from_decl;
@@ -348,7 +348,7 @@ export class Parse_Exports_Context {
 	 */
 	#get_export_name(node: ts.Node): string | undefined {
 		if (ts.isVariableStatement(node) && node.declarationList.declarations.length > 0) {
-			const decl = node.declarationList.declarations[0];
+			const decl = node.declarationList.declarations[0]!;
 			if (ts.isIdentifier(decl.name)) {
 				return decl.name.text;
 			}

package/src/lib/parse_imports.ts

@@ -159,7 +159,7 @@ export const parse_imports = (
 			// If we're not nested (no HTML tag nesting), process this script
 			if (!(contains_opening_tag && !contains_closing_tag)) {
 				script_blocks.push({
-					content: match[1],
+					content: match[1]!,
 					start,
 					end,
 				});

package/src/lib/upgrade.task.ts

@@ -135,7 +135,7 @@ const to_upgrade_items = (deps: Array<Package_Json_Dep>): Array<string> =>
 		}
 		const custom_tag_matches = CUSTOM_TAG_MATCHER.exec(dep.version);
 		if (custom_tag_matches) {
-			return dep.name + '@' + custom_tag_matches[1].split('.')[0]; // I tried adding `\.?` to the end but doesn't work and I'm being lazy so I'm just splitting
+			return dep.name + '@' + custom_tag_matches[1]!.split('.')[0]; // I tried adding `\.?` to the end but doesn't work and I'm being lazy so I'm just splitting
 		}
 		return dep.name + '@latest';
 	});

package/dist/test_helpers.d.ts

@@ -1,22 +0,0 @@
-import ts from 'typescript';
-export declare const TEST_TIMEOUT_MD = 20000;
-export declare const SOME_PUBLIC_ENV_VAR_NAME = "PUBLIC_SOME_PUBLIC_ENV_VAR";
-export declare const SOME_PUBLIC_ENV_VAR_VALUE = "SOME_PUBLIC_ENV_VAR";
-/**
- * Hacky global helper to init the test env.
- *
- * @returns boolean indicating if the env file was created or not
- */
-export declare const init_test_env: (dir?: string, env_filename?: string) => boolean;
-/**
- * Creates a TypeScript environment for testing.
- * Change to `typescript-go` when it's more ready.
- * @see https://github.com/microsoft/typescript-go?tab=readme-ov-file#what-works-so-far
- */
-export declare const create_ts_test_env: (source_code: string, dir?: string, virtual_files?: Record<string, string>) => {
-    source_file: ts.SourceFile;
-    checker: ts.TypeChecker;
-    program: ts.Program;
-    exports: Array<ts.Symbol>;
-};
-//# sourceMappingURL=test_helpers.d.ts.map

package/dist/test_helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"test_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/test_helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,eAAO,MAAM,eAAe,QAAS,CAAC;AAEtC,eAAO,MAAM,wBAAwB,+BAA+B,CAAC;AACrE,eAAO,MAAM,yBAAyB,wBAAwB,CAAC;AAM/D;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,YAAmB,EAAE,qBAAqB,KAAG,OA6B1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAC9B,aAAa,MAAM,EACnB,MAAK,MAAsB,EAC3B,gBAAe,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,KACxC;IACF,WAAW,EAAE,EAAE,CAAC,UAAU,CAAC;IAC3B,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC;IACxB,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;CAkG1B,CAAC"}

package/dist/test_helpers.js

@@ -1,123 +0,0 @@
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import ts from 'typescript';
-export const TEST_TIMEOUT_MD = 20_000;
-export const SOME_PUBLIC_ENV_VAR_NAME = 'PUBLIC_SOME_PUBLIC_ENV_VAR';
-export const SOME_PUBLIC_ENV_VAR_VALUE = 'SOME_PUBLIC_ENV_VAR';
-const name_equals = SOME_PUBLIC_ENV_VAR_NAME + '=';
-const line = name_equals + SOME_PUBLIC_ENV_VAR_VALUE;
-let inited = false;
-/**
- * Hacky global helper to init the test env.
- *
- * @returns boolean indicating if the env file was created or not
- */
-export const init_test_env = (dir = process.cwd(), env_filename = '.env') => {
-    if (inited)
-        return false;
-    inited = true;
-    const env_file = join(dir, env_filename);
-    if (!existsSync(env_file)) {
-        writeFileSync(env_file, line + '\n', 'utf8');
-        return true;
-    }
-    const contents = readFileSync(env_file, 'utf8');
-    const lines = contents.split('\n');
-    if (lines.includes(line)) {
-        return false; // already exists
-    }
-    let new_contents;
-    const found_index = lines.findIndex((l) => l.startsWith(name_equals));
-    if (found_index === -1) {
-        // if the line does not exist, add it
-        new_contents = contents + (contents.endsWith('\n') ? '' : '\n') + line + '\n';
-    }
-    else {
-        // if the line exists but with a different value, replace it
-        new_contents = contents.replace(new RegExp(`${SOME_PUBLIC_ENV_VAR_NAME}=.*`), line);
-    }
-    writeFileSync(env_file, new_contents, 'utf8');
-    return true;
-};
-/**
- * Creates a TypeScript environment for testing.
- * Change to `typescript-go` when it's more ready.
- * @see https://github.com/microsoft/typescript-go?tab=readme-ov-file#what-works-so-far
- */
-export const create_ts_test_env = (source_code, dir = process.cwd(), virtual_files = {}) => {
-    // Create a virtual file path for testing
-    const file_path = join(dir, 'virtual_test_file.ts');
-    // Create a compiler host with custom module resolution
-    const host = ts.createCompilerHost({});
-    const original_get_source_file = host.getSourceFile.bind(host);
-    // Override getSourceFile to return our test files
-    host.getSourceFile = (fileName, languageVersion) => {
-        if (fileName === file_path) {
-            return ts.createSourceFile(fileName, source_code, languageVersion);
-        }
-        // Check if we have a virtual file for this path
-        for (const [virtual_path, content] of Object.entries(virtual_files)) {
-            const full_path = join(dir, virtual_path);
-            if (fileName === full_path) {
-                return ts.createSourceFile(fileName, content, languageVersion);
-            }
-        }
-        return original_get_source_file(fileName, languageVersion);
-    };
-    // TODO simplify?
-    // Add custom module resolution using resolveModuleNameLiterals
-    host.resolveModuleNameLiterals = (module_literals, containing_file, _redirected_reference, options) => {
-        return module_literals.map((module_literal) => {
-            const module_name = module_literal.text;
-            // Handle relative imports that might be in our virtual files
-            if (module_name.startsWith('./') || module_name.startsWith('../')) {
-                const module_path = join(containing_file, '..', module_name);
-                // Normalize the path handling for the virtual files
-                for (const virtual_path of Object.keys(virtual_files)) {
-                    const full_path = join(dir, virtual_path);
-                    const normalized_module_path = module_path.replace(/\.ts$/, '') + '.ts';
-                    if (normalized_module_path === full_path) {
-                        return {
-                            resolvedModule: {
-                                resolvedFileName: full_path,
-                                isExternalLibraryImport: false,
-                                extension: ts.Extension.Ts,
-                            },
-                        };
-                    }
-                }
-            }
-            // If it's our main file
-            if (join(dir, module_name) === file_path) {
-                return {
-                    resolvedModule: {
-                        resolvedFileName: file_path,
-                        isExternalLibraryImport: false,
-                        extension: ts.Extension.Ts,
-                    },
-                };
-            }
-            // For non-virtual modules, try standard resolution
-            return ts.resolveModuleName(module_name, containing_file, options, host);
-        });
-    };
-    // Include all virtual files in the program files list
-    const program_files = [file_path, ...Object.keys(virtual_files).map((path) => join(dir, path))];
-    // TODO get from tsconfig?
-    // Create program options
-    const compiler_options = {
-        target: ts.ScriptTarget.ESNext,
-        module: ts.ModuleKind.ESNext,
-        moduleResolution: ts.ModuleResolutionKind.NodeNext,
-        verbatimModuleSyntax: true,
-        isolatedModules: true,
-    };
-    // Create a program with our virtual files
-    const program = ts.createProgram(program_files, compiler_options, host);
-    const source_file = program.getSourceFile(file_path);
-    const checker = program.getTypeChecker();
-    // Get the exports from the source file
-    const symbol = checker.getSymbolAtLocation(source_file);
-    const exports = symbol ? checker.getExportsOfModule(symbol) : [];
-    return { source_file, checker, program, exports };
-};

package/src/lib/test_helpers.ts

@@ -1,161 +0,0 @@
-import {existsSync, readFileSync, writeFileSync} from 'node:fs';
-import {join} from 'node:path';
-import ts from 'typescript';
-
-export const TEST_TIMEOUT_MD = 20_000;
-
-export const SOME_PUBLIC_ENV_VAR_NAME = 'PUBLIC_SOME_PUBLIC_ENV_VAR';
-export const SOME_PUBLIC_ENV_VAR_VALUE = 'SOME_PUBLIC_ENV_VAR';
-const name_equals = SOME_PUBLIC_ENV_VAR_NAME + '=';
-const line = name_equals + SOME_PUBLIC_ENV_VAR_VALUE;
-
-let inited = false;
-
-/**
- * Hacky global helper to init the test env.
- *
- * @returns boolean indicating if the env file was created or not
- */
-export const init_test_env = (dir = process.cwd(), env_filename = '.env'): boolean => {
-	if (inited) return false;
-	inited = true;
-
-	const env_file = join(dir, env_filename);
-
-	if (!existsSync(env_file)) {
-		writeFileSync(env_file, line + '\n', 'utf8');
-		return true;
-	}
-
-	const contents = readFileSync(env_file, 'utf8');
-	const lines = contents.split('\n');
-	if (lines.includes(line)) {
-		return false; // already exists
-	}
-
-	let new_contents: string;
-	const found_index = lines.findIndex((l) => l.startsWith(name_equals));
-	if (found_index === -1) {
-		// if the line does not exist, add it
-		new_contents = contents + (contents.endsWith('\n') ? '' : '\n') + line + '\n';
-	} else {
-		// if the line exists but with a different value, replace it
-		new_contents = contents.replace(new RegExp(`${SOME_PUBLIC_ENV_VAR_NAME}=.*`), line);
-	}
-	writeFileSync(env_file, new_contents, 'utf8');
-
-	return true;
-};
-
-/**
- * Creates a TypeScript environment for testing.
- * Change to `typescript-go` when it's more ready.
- * @see https://github.com/microsoft/typescript-go?tab=readme-ov-file#what-works-so-far
- */
-export const create_ts_test_env = (
-	source_code: string,
-	dir: string = process.cwd(),
-	virtual_files: Record<string, string> = {},
-): {
-	source_file: ts.SourceFile;
-	checker: ts.TypeChecker;
-	program: ts.Program;
-	exports: Array<ts.Symbol>;
-} => {
-	// Create a virtual file path for testing
-	const file_path = join(dir, 'virtual_test_file.ts');
-
-	// Create a compiler host with custom module resolution
-	const host = ts.createCompilerHost({});
-	const original_get_source_file = host.getSourceFile.bind(host);
-
-	// Override getSourceFile to return our test files
-	host.getSourceFile = (fileName: string, languageVersion: ts.ScriptTarget) => {
-		if (fileName === file_path) {
-			return ts.createSourceFile(fileName, source_code, languageVersion);
-		}
-
-		// Check if we have a virtual file for this path
-		for (const [virtual_path, content] of Object.entries(virtual_files)) {
-			const full_path = join(dir, virtual_path);
-			if (fileName === full_path) {
-				return ts.createSourceFile(fileName, content, languageVersion);
-			}
-		}
-
-		return original_get_source_file(fileName, languageVersion);
-	};
-
-	// TODO simplify?
-	// Add custom module resolution using resolveModuleNameLiterals
-	host.resolveModuleNameLiterals = (
-		module_literals: ReadonlyArray<ts.StringLiteralLike>,
-		containing_file: string,
-		_redirected_reference: ts.ResolvedProjectReference | undefined,
-		options: ts.CompilerOptions,
-	): Array<ts.ResolvedModuleWithFailedLookupLocations> => {
-		return module_literals.map((module_literal) => {
-			const module_name = module_literal.text;
-
-			// Handle relative imports that might be in our virtual files
-			if (module_name.startsWith('./') || module_name.startsWith('../')) {
-				const module_path = join(containing_file, '..', module_name);
-
-				// Normalize the path handling for the virtual files
-				for (const virtual_path of Object.keys(virtual_files)) {
-					const full_path = join(dir, virtual_path);
-					const normalized_module_path = module_path.replace(/\.ts$/, '') + '.ts';
-
-					if (normalized_module_path === full_path) {
-						return {
-							resolvedModule: {
-								resolvedFileName: full_path,
-								isExternalLibraryImport: false,
-								extension: ts.Extension.Ts,
-							},
-						};
-					}
-				}
-			}
-
-			// If it's our main file
-			if (join(dir, module_name) === file_path) {
-				return {
-					resolvedModule: {
-						resolvedFileName: file_path,
-						isExternalLibraryImport: false,
-						extension: ts.Extension.Ts,
-					},
-				};
-			}
-
-			// For non-virtual modules, try standard resolution
-			return ts.resolveModuleName(module_name, containing_file, options, host);
-		});
-	};
-
-	// Include all virtual files in the program files list
-	const program_files = [file_path, ...Object.keys(virtual_files).map((path) => join(dir, path))];
-
-	// TODO get from tsconfig?
-	// Create program options
-	const compiler_options: ts.CompilerOptions = {
-		target: ts.ScriptTarget.ESNext,
-		module: ts.ModuleKind.ESNext,
-		moduleResolution: ts.ModuleResolutionKind.NodeNext,
-		verbatimModuleSyntax: true,
-		isolatedModules: true,
-	};
-
-	// Create a program with our virtual files
-	const program = ts.createProgram(program_files, compiler_options, host);
-
-	const source_file = program.getSourceFile(file_path)!;
-	const checker = program.getTypeChecker();
-
-	// Get the exports from the source file
-	const symbol = checker.getSymbolAtLocation(source_file);
-	const exports = symbol ? checker.getExportsOfModule(symbol) : [];
-
-	return {source_file, checker, program, exports};
-};