@ryanatkn/gro 0.156.0 → 0.157.1

package/dist/test_helpers.js

@@ -0,0 +1,122 @@
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import ts from 'typescript';
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryanatkn/gro",
-  "version": "0.156.0",
+  "version": "0.157.1",
   "description": "task runner and toolkit extending SvelteKit",
   "motto": "generate, run, optimize",
   "glyph": "🌰",
@@ -54,17 +54,17 @@
     "dotenv": "^16.5.0",
     "esm-env": "^1.2.2",
     "mri": "^1.2.0",
-    "oxc-parser": "^0.67.0",
+    "oxc-parser": "^0.68.1",
     "prettier": "^3.5.3",
     "prettier-plugin-svelte": "^3.3.3",
     "ts-blank-space": "^0.6.1",
-    "ts-morph": "^25.0.1",
     "tslib": "^2.8.1",
-    "zod": "^3.24.3"
+    "zod": "^3.24.4"
   },
   "peerDependencies": {
     "esbuild": "^0.25",
-    "svelte": "^5"
+    "svelte": "^5",
+    "typescript": "^5"
   },
   "devDependencies": {
     "@changesets/changelog-git": "^0.2.1",
@@ -78,16 +78,16 @@
     "@sveltejs/vite-plugin-svelte": "^5.0.3",
     "@types/node": "^22.15.3",
     "esbuild": "^0.25.3",
-    "eslint": "^9.25.1",
+    "eslint": "9.25.1",
     "eslint-plugin-svelte": "^3.5.1",
     "svelte": "^5.28.2",
-    "svelte-check": "^4.1.6",
+    "svelte-check": "^4.1.7",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.31.1",
+    "typescript-eslint": "^8.32.0",
     "uvu": "^0.5.6"
   },
   "optionalDependencies": {
-    "@ryanatkn/moss": ">=0.27.0 <0.29.0"
+    "@ryanatkn/moss": ">=0.27.0 <0.30.0"
   },
   "prettier": {
     "plugins": [
@@ -325,6 +325,14 @@
       "types": "./dist/package.d.ts",
       "default": "./dist/package.js"
     },
+    "./parse_exports_context.js": {
+      "types": "./dist/parse_exports_context.d.ts",
+      "default": "./dist/parse_exports_context.js"
+    },
+    "./parse_exports.js": {
+      "types": "./dist/parse_exports.d.ts",
+      "default": "./dist/parse_exports.js"
+    },
     "./parse_imports.js": {
       "types": "./dist/parse_imports.d.ts",
       "default": "./dist/parse_imports.js"
@@ -389,10 +397,6 @@
       "types": "./dist/svelte_config.d.ts",
       "default": "./dist/svelte_config.js"
     },
-    "./svelte_helpers.js": {
-      "types": "./dist/svelte_helpers.d.ts",
-      "default": "./dist/svelte_helpers.js"
-    },
     "./sveltekit_helpers.js": {
       "types": "./dist/sveltekit_helpers.d.ts",
       "default": "./dist/sveltekit_helpers.js"
@@ -437,6 +441,10 @@
       "types": "./dist/task.d.ts",
       "default": "./dist/task.js"
     },
+    "./test_helpers.js": {
+      "types": "./dist/test_helpers.d.ts",
+      "default": "./dist/test_helpers.js"
+    },
     "./test.task.js": {
       "types": "./dist/test.task.d.ts",
       "default": "./dist/test.task.js"

package/src/lib/constants.ts

@@ -12,8 +12,11 @@ export const GRO_DIRNAME = '.gro';
 export const GRO_DIST_PREFIX = 'dist_'; //
 export const SERVER_DIST_PATH = 'dist_server'; // TODO should all of these be `_PATH` or should this be `DIRNAME`? also, add `_PLUGIN` to this name?
 export const GRO_DEV_DIRNAME = GRO_DIRNAME + '/dev';
+/** @trailing_slash */
 export const SOURCE_DIR = SOURCE_DIRNAME + '/';
+/** @trailing_slash */
 export const GRO_DIR = GRO_DIRNAME + '/';
+/** @trailing_slash */
 export const GRO_DEV_DIR = GRO_DEV_DIRNAME + '/';
 export const GRO_CONFIG_PATH = 'gro.config.ts';
 export const README_FILENAME = 'README.md';
@@ -31,6 +34,9 @@ export const TSCONFIG_FILENAME = 'tsconfig.json';
 
 export const TS_MATCHER = /\.(ts|tsx|mts|cts)$/;
 export const JS_MATCHER = /\.(js|jsx|mjs|cjs)$/;
+export const JSON_MATCHER = /\.json$/;
+export const SVELTE_MATCHER = /\.svelte$/;
+export const SVELTE_RUNES_MATCHER = /\.svelte\.(js|ts)$/; // TODO probably let `.svelte.` appear anywhere - https://github.com/sveltejs/svelte/issues/11536
 /** Extracts the script content from Svelte files. */
 export const SVELTE_SCRIPT_MATCHER = /<script(?:\s+[^>]*)?>([\s\S]*?)<\/script>/gim; // TODO maybe this shouldnt be global? or make a getter?
 export const EVERYTHING_MATCHER = /.*/;

package/src/lib/esbuild_plugin_svelte.ts

@@ -10,14 +10,13 @@ import {
 import {readFile} from 'node:fs/promises';
 import {relative} from 'node:path';
 
-import {SVELTE_MATCHER, SVELTE_RUNES_MATCHER} from './svelte_helpers.ts';
 import {to_define_import_meta_env, default_ts_transform_options} from './esbuild_helpers.ts';
 import {
 	default_svelte_config,
 	to_default_compile_module_options,
 	type Parsed_Svelte_Config,
 } from './svelte_config.ts';
-import {TS_MATCHER} from './constants.ts';
+import {TS_MATCHER, SVELTE_MATCHER, SVELTE_RUNES_MATCHER} from './constants.ts';
 
 export interface Esbuild_Plugin_Svelte_Options {
 	dev: boolean;

package/src/lib/gro_plugin_sveltekit_app.ts

@@ -92,7 +92,7 @@ export const gro_plugin_sveltekit_app = ({
 
 				// `.well-known/src.json` and `.well-known/src/`
 				const final_package_json = mapped_package_json ?? package_json;
-				const src_json = create_src_json(final_package_json);
+				const src_json = create_src_json(final_package_json, undefined);
 				if (well_known_src_json === undefined) {
 					well_known_src_json = final_package_json.public; // eslint-disable-line no-param-reassign
 				}

package/src/lib/loader.ts

@@ -15,9 +15,13 @@ import {
 	sveltekit_shim_app_specifiers,
 } from './sveltekit_shim_app.ts';
 import {default_svelte_config} from './svelte_config.ts';
-import {SVELTE_MATCHER, SVELTE_RUNES_MATCHER} from './svelte_helpers.ts';
 import {IS_THIS_GRO, paths} from './paths.ts';
-import {NODE_MODULES_DIRNAME, TS_MATCHER} from './constants.ts';
+import {
+	NODE_MODULES_DIRNAME,
+	TS_MATCHER,
+	SVELTE_MATCHER,
+	SVELTE_RUNES_MATCHER,
+} from './constants.ts';
 import {resolve_specifier} from './resolve_specifier.ts';
 import {map_sveltekit_aliases} from './sveltekit_helpers.ts';
 

package/src/lib/package.gen.ts

@@ -14,7 +14,7 @@ import {create_src_json} from './src_json.ts';
  */
 export const gen: Gen = ({origin_path}) => {
 	const package_json = load_package_json();
-	const src_json = create_src_json(package_json);
+	const src_json = create_src_json(package_json, undefined);
 
 	return `
 // generated by ${origin_path}

package/src/lib/package.ts

@@ -5,7 +5,7 @@ import type {Src_Json} from './src_json.ts';
 
 export const package_json = {
 	name: '@ryanatkn/gro',
-	version: '0.156.0',
+	version: '0.157.1',
 	description: 'task runner and toolkit extending SvelteKit',
 	motto: 'generate, run, optimize',
 	glyph: '🌰',
@@ -49,15 +49,14 @@ export const package_json = {
 		dotenv: '^16.5.0',
 		'esm-env': '^1.2.2',
 		mri: '^1.2.0',
-		'oxc-parser': '^0.67.0',
+		'oxc-parser': '^0.68.1',
 		prettier: '^3.5.3',
 		'prettier-plugin-svelte': '^3.3.3',
 		'ts-blank-space': '^0.6.1',
-		'ts-morph': '^25.0.1',
 		tslib: '^2.8.1',
-		zod: '^3.24.3',
+		zod: '^3.24.4',
 	},
-	peerDependencies: {esbuild: '^0.25', svelte: '^5'},
+	peerDependencies: {esbuild: '^0.25', svelte: '^5', typescript: '^5'},
 	devDependencies: {
 		'@changesets/changelog-git': '^0.2.1',
 		'@changesets/types': '^6.1.0',
@@ -70,15 +69,15 @@ export const package_json = {
 		'@sveltejs/vite-plugin-svelte': '^5.0.3',
 		'@types/node': '^22.15.3',
 		esbuild: '^0.25.3',
-		eslint: '^9.25.1',
+		eslint: '9.25.1',
 		'eslint-plugin-svelte': '^3.5.1',
 		svelte: '^5.28.2',
-		'svelte-check': '^4.1.6',
+		'svelte-check': '^4.1.7',
 		typescript: '^5.8.3',
-		'typescript-eslint': '^8.31.1',
+		'typescript-eslint': '^8.32.0',
 		uvu: '^0.5.6',
 	},
-	optionalDependencies: {'@ryanatkn/moss': '>=0.27.0 <0.29.0'},
+	optionalDependencies: {'@ryanatkn/moss': '>=0.27.0 <0.30.0'},
 	prettier: {
 		plugins: ['prettier-plugin-svelte'],
 		useTabs: true,
@@ -191,6 +190,11 @@ export const package_json = {
 		'./package_meta.js': {types: './dist/package_meta.d.ts', default: './dist/package_meta.js'},
 		'./package.gen.js': {types: './dist/package.gen.d.ts', default: './dist/package.gen.js'},
 		'./package.js': {types: './dist/package.d.ts', default: './dist/package.js'},
+		'./parse_exports_context.js': {
+			types: './dist/parse_exports_context.d.ts',
+			default: './dist/parse_exports_context.js',
+		},
+		'./parse_exports.js': {types: './dist/parse_exports.d.ts', default: './dist/parse_exports.js'},
 		'./parse_imports.js': {types: './dist/parse_imports.d.ts', default: './dist/parse_imports.js'},
 		'./path.js': {types: './dist/path.d.ts', default: './dist/path.js'},
 		'./paths.js': {types: './dist/paths.d.ts', default: './dist/paths.js'},
@@ -213,10 +217,6 @@ export const package_json = {
 		'./search_fs.js': {types: './dist/search_fs.d.ts', default: './dist/search_fs.js'},
 		'./src_json.js': {types: './dist/src_json.d.ts', default: './dist/src_json.js'},
 		'./svelte_config.js': {types: './dist/svelte_config.d.ts', default: './dist/svelte_config.js'},
-		'./svelte_helpers.js': {
-			types: './dist/svelte_helpers.d.ts',
-			default: './dist/svelte_helpers.js',
-		},
 		'./sveltekit_helpers.js': {
 			types: './dist/sveltekit_helpers.d.ts',
 			default: './dist/sveltekit_helpers.js',
@@ -252,6 +252,7 @@ export const package_json = {
 		'./sync.task.js': {types: './dist/sync.task.d.ts', default: './dist/sync.task.js'},
 		'./task_logging.js': {types: './dist/task_logging.d.ts', default: './dist/task_logging.js'},
 		'./task.js': {types: './dist/task.d.ts', default: './dist/task.js'},
+		'./test_helpers.js': {types: './dist/test_helpers.d.ts', default: './dist/test_helpers.js'},
 		'./test.task.js': {types: './dist/test.task.d.ts', default: './dist/test.task.js'},
 		'./typecheck.task.js': {
 			types: './dist/typecheck.task.d.ts',
@@ -264,7 +265,7 @@ export const package_json = {
 
 export const src_json = {
 	name: '@ryanatkn/gro',
-	version: '0.156.0',
+	version: '0.157.1',
 	modules: {
 		'.': {
 			path: 'index.ts',
@@ -281,7 +282,7 @@ export const src_json = {
 				{name: 'Task_Error', kind: 'class'},
 			],
 		},
-		'./package.json': {path: 'package.json', declarations: []},
+		'./package.json': {path: 'package.json', declarations: [{name: 'default', kind: 'json'}]},
 		'./args.js': {
 			path: 'args.ts',
 			declarations: [
@@ -392,6 +393,9 @@ export const src_json = {
 				{name: 'TSCONFIG_FILENAME', kind: 'variable'},
 				{name: 'TS_MATCHER', kind: 'variable'},
 				{name: 'JS_MATCHER', kind: 'variable'},
+				{name: 'JSON_MATCHER', kind: 'variable'},
+				{name: 'SVELTE_MATCHER', kind: 'variable'},
+				{name: 'SVELTE_RUNES_MATCHER', kind: 'variable'},
 				{name: 'SVELTE_SCRIPT_MATCHER', kind: 'variable'},
 				{name: 'EVERYTHING_MATCHER', kind: 'variable'},
 				{name: 'JS_CLI_DEFAULT', kind: 'variable'},
@@ -736,6 +740,21 @@ export const src_json = {
 				{name: 'src_json', kind: 'variable'},
 			],
 		},
+		'./parse_exports_context.js': {
+			path: 'parse_exports_context.ts',
+			declarations: [{name: 'Parse_Exports_Context', kind: 'class'}],
+		},
+		'./parse_exports.js': {
+			path: 'parse_exports.ts',
+			declarations: [
+				{name: 'Declaration_Kind', kind: 'type'},
+				{name: 'Declaration', kind: 'type'},
+				{name: 'Export_Declaration', kind: 'type'},
+				{name: 'parse_exports', kind: 'function'},
+				{name: 'infer_declarations_from_file_type', kind: 'function'},
+				{name: 'process_ts_exports', kind: 'function'},
+			],
+		},
 		'./parse_imports.js': {
 			path: 'parse_imports.ts',
 			declarations: [
@@ -855,6 +874,7 @@ export const src_json = {
 		'./src_json.js': {
 			path: 'src_json.ts',
 			declarations: [
+				{name: 'Src_Module_Declaration_Kind', kind: 'variable'},
 				{name: 'Src_Module_Declaration', kind: 'variable'},
 				{name: 'Src_Module', kind: 'variable'},
 				{name: 'Src_Modules', kind: 'variable'},
@@ -875,13 +895,6 @@ export const src_json = {
 				{name: 'default_svelte_config', kind: 'variable'},
 			],
 		},
-		'./svelte_helpers.js': {
-			path: 'svelte_helpers.ts',
-			declarations: [
-				{name: 'SVELTE_MATCHER', kind: 'variable'},
-				{name: 'SVELTE_RUNES_MATCHER', kind: 'variable'},
-			],
-		},
 		'./sveltekit_helpers.js': {
 			path: 'sveltekit_helpers.ts',
 			declarations: [
@@ -1003,6 +1016,15 @@ export const src_json = {
 				{name: 'validate_task_module', kind: 'function'},
 			],
 		},
+		'./test_helpers.js': {
+			path: 'test_helpers.ts',
+			declarations: [
+				{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/parse_exports.ts

@@ -0,0 +1,108 @@
+import ts from 'typescript';
+import {extname} from 'node:path';
+import type {Flavored} from '@ryanatkn/belt/types.js';
+import type {Logger} from '@ryanatkn/belt/log.js';
+
+import type {Path_Id} from './path.ts';
+import {TS_MATCHER} from './constants.ts';
+import {Parse_Exports_Context} from './parse_exports_context.ts';
+
+export type Declaration_Kind =
+	| 'type'
+	| 'function'
+	| 'variable' // TODO maybe expand this to have literals/primitives?
+	| 'class'
+	| 'component'
+	| 'json'
+	| 'css';
+
+export interface Declaration {
+	name: string;
+	kind: Declaration_Kind | null;
+}
+
+export type Export_Declaration = Flavored<Declaration, 'Export_Declaration'>;
+
+/**
+ * Parse exports from a file based on its file type and content.
+ */
+export const parse_exports = (
+	id: Path_Id,
+	program?: ts.Program,
+	declarations: Array<Export_Declaration> = [],
+	log?: Logger,
+): Array<Export_Declaration> => {
+	// First, infer declarations based on file extension
+	infer_declarations_from_file_type(id, declarations);
+
+	// For TypeScript files with program, perform detailed export analysis
+	if (TS_MATCHER.test(id) && program) {
+		const source_file = program.getSourceFile(id);
+		if (!source_file) return declarations;
+
+		const checker = program.getTypeChecker();
+
+		// Get the exports of the source file (module)
+		const symbol = checker.getSymbolAtLocation(source_file);
+		if (!symbol) return declarations;
+
+		// Get the module exports
+		const exports = checker.getExportsOfModule(symbol);
+
+		// Process TypeScript declarations
+		const export_context = new Parse_Exports_Context(program, log);
+		export_context.analyze_source_file(source_file);
+		export_context.process_exports(source_file, exports, declarations);
+	}
+
+	return declarations;
+};
+
+// TODO temporary until proper type inference
+export const infer_declarations_from_file_type = (
+	file_path: Path_Id,
+	declarations: Array<Export_Declaration> = [],
+): Array<Export_Declaration> => {
+	const extension = extname(file_path).toLowerCase();
+
+	switch (extension) {
+		case '.svelte': {
+			declarations.push({
+				name: 'default',
+				kind: 'component',
+			});
+			break;
+		}
+		case '.css': {
+			declarations.push({
+				name: 'default',
+				kind: 'css',
+			});
+			break;
+		}
+		case '.json': {
+			declarations.push({
+				name: 'default',
+				kind: 'json',
+			});
+			break;
+		}
+	}
+
+	return declarations;
+};
+
+/**
+ * Process TypeScript exports, identifying their kinds.
+ */
+export const process_ts_exports = (
+	source_file: ts.SourceFile,
+	program: ts.Program,
+	exports: Array<ts.Symbol>,
+	declarations: Array<Export_Declaration> = [],
+	log?: Logger,
+): Array<Export_Declaration> => {
+	const export_context = new Parse_Exports_Context(program, log);
+	export_context.analyze_source_file(source_file);
+	return export_context.process_exports(source_file, exports, declarations);
+};