@ryanatkn/gro 0.141.1 → 0.143.0

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.141.1',
+	version: '0.143.0',
 	description: 'task runner and toolkit extending SvelteKit',
 	motto: 'generate, run, optimize',
 	glyph: '🌰',
@@ -53,7 +53,7 @@ export const package_json = {
 		prettier: '^3.3.3',
 		'prettier-plugin-svelte': '^3.2.7',
 		'ts-morph': '^24.0.0',
-		tslib: '^2.7.0',
+		tslib: '^2.8.0',
 		zod: '^3.23.8',
 	},
 	peerDependencies: {esbuild: '^0.21.0', svelte: '^5.0.0-next.0'},
@@ -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.129.2',
-		'@ryanatkn/moss': '^0.18.0',
-		'@sveltejs/adapter-static': '^3.0.5',
-		'@sveltejs/kit': '^2.6.4',
-		'@sveltejs/package': '^2.3.5',
-		'@sveltejs/vite-plugin-svelte': '^4.0.0-next.6',
+		'@ryanatkn/fuz': '^0.129.5',
+		'@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.7.5',
+		'@types/node': '^22.8.1',
 		esbuild: '^0.21.5',
-		eslint: '^9.12.0',
-		'eslint-plugin-svelte': '^2.44.1',
-		svelte: '^5.0.0-next.264',
-		'svelte-check': '^4.0.4',
+		eslint: '^9.13.0',
+		'eslint-plugin-svelte': '^2.46.0',
+		svelte: '^5.1.3',
+		'svelte-check': '^4.0.5',
 		typescript: '^5.6.3',
-		'typescript-eslint': '^8.8.1',
+		'typescript-eslint': '^8.11.0',
 		uvu: '^0.5.6',
 	},
 	prettier: {
@@ -107,6 +107,7 @@ export const package_json = {
 		'./clean.task.js': {types: './dist/clean.task.d.ts', default: './dist/clean.task.js'},
 		'./cli.js': {types: './dist/cli.d.ts', default: './dist/cli.js'},
 		'./commit.task.js': {types: './dist/commit.task.d.ts', default: './dist/commit.task.js'},
+		'./constants.js': {types: './dist/constants.d.ts', default: './dist/constants.js'},
 		'./deploy.task.js': {types: './dist/deploy.task.d.ts', default: './dist/deploy.task.js'},
 		'./dev.task.js': {types: './dist/dev.task.d.ts', default: './dist/dev.task.js'},
 		'./env.js': {types: './dist/env.d.ts', default: './dist/env.js'},
@@ -187,10 +188,6 @@ export const package_json = {
 		'./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_imports.js': {types: './dist/parse_imports.d.ts', default: './dist/parse_imports.js'},
-		'./path_constants.js': {
-			types: './dist/path_constants.d.ts',
-			default: './dist/path_constants.js',
-		},
 		'./path.js': {types: './dist/path.d.ts', default: './dist/path.js'},
 		'./paths.js': {types: './dist/paths.d.ts', default: './dist/paths.js'},
 		'./plugin.js': {types: './dist/plugin.d.ts', default: './dist/plugin.js'},
@@ -270,7 +267,7 @@ export const package_json = {
 
 export const src_json = {
 	name: '@ryanatkn/gro',
-	version: '0.141.1',
+	version: '0.143.0',
 	modules: {
 		'.': {
 			path: 'index.ts',
@@ -365,6 +362,39 @@ export const src_json = {
 				{name: 'task', kind: 'variable'},
 			],
 		},
+		'./constants.js': {
+			path: 'constants.ts',
+			declarations: [
+				{name: 'SOURCE_DIRNAME', kind: 'variable'},
+				{name: 'GRO_DIRNAME', kind: 'variable'},
+				{name: 'GRO_DIST_PREFIX', kind: 'variable'},
+				{name: 'SERVER_DIST_PATH', kind: 'variable'},
+				{name: 'GRO_DEV_DIRNAME', kind: 'variable'},
+				{name: 'SOURCE_DIR', kind: 'variable'},
+				{name: 'GRO_DIR', kind: 'variable'},
+				{name: 'GRO_DEV_DIR', kind: 'variable'},
+				{name: 'GRO_CONFIG_PATH', kind: 'variable'},
+				{name: 'README_FILENAME', kind: 'variable'},
+				{name: 'SVELTEKIT_CONFIG_FILENAME', kind: 'variable'},
+				{name: 'VITE_CONFIG_FILENAME', kind: 'variable'},
+				{name: 'NODE_MODULES_DIRNAME', kind: 'variable'},
+				{name: 'LOCKFILE_FILENAME', kind: 'variable'},
+				{name: 'SVELTEKIT_DEV_DIRNAME', kind: 'variable'},
+				{name: 'SVELTEKIT_BUILD_DIRNAME', kind: 'variable'},
+				{name: 'SVELTEKIT_DIST_DIRNAME', kind: 'variable'},
+				{name: 'SVELTEKIT_VITE_CACHE_PATH', kind: 'variable'},
+				{name: 'GITHUB_DIRNAME', kind: 'variable'},
+				{name: 'GIT_DIRNAME', kind: 'variable'},
+				{name: 'TSCONFIG_FILENAME', kind: 'variable'},
+				{name: 'TS_MATCHER', kind: 'variable'},
+				{name: 'JS_MATCHER', kind: 'variable'},
+				{name: 'JSON_MATCHER', kind: 'variable'},
+				{name: 'EVERYTHING_MATCHER', kind: 'variable'},
+				{name: 'JS_CLI_DEFAULT', kind: 'variable'},
+				{name: 'PM_CLI_DEFAULT', kind: 'variable'},
+				{name: 'PRETTIER_CLI_DEFAULT', kind: 'variable'},
+			],
+		},
 		'./deploy.task.js': {
 			path: 'deploy.task.ts',
 			declarations: [
@@ -545,8 +575,8 @@ export const src_json = {
 				{name: 'Raw_Gro_Config', kind: 'type'},
 				{name: 'Create_Gro_Config', kind: 'type'},
 				{name: 'create_empty_gro_config', kind: 'function'},
-				{name: 'DEFAULT_SEARCH_EXCLUDER', kind: 'variable'},
-				{name: 'DEFAULT_EXPORTS_EXCLUDER', kind: 'variable'},
+				{name: 'SEARCH_EXCLUDER_DEFAULT', kind: 'variable'},
+				{name: 'EXPORTS_EXCLUDER_DEFAULT', kind: 'variable'},
 				{name: 'normalize_gro_config', kind: 'function'},
 				{name: 'Gro_Config_Module', kind: 'type'},
 				{name: 'load_gro_config', kind: 'function'},
@@ -716,36 +746,6 @@ export const src_json = {
 				{name: 'parse_imports', kind: 'function'},
 			],
 		},
-		'./path_constants.js': {
-			path: 'path_constants.ts',
-			declarations: [
-				{name: 'SOURCE_DIRNAME', kind: 'variable'},
-				{name: 'GRO_DIRNAME', kind: 'variable'},
-				{name: 'GRO_DIST_PREFIX', kind: 'variable'},
-				{name: 'SERVER_DIST_PATH', kind: 'variable'},
-				{name: 'GRO_DEV_DIRNAME', kind: 'variable'},
-				{name: 'SOURCE_DIR', kind: 'variable'},
-				{name: 'GRO_DIR', kind: 'variable'},
-				{name: 'GRO_DEV_DIR', kind: 'variable'},
-				{name: 'GRO_CONFIG_PATH', kind: 'variable'},
-				{name: 'README_FILENAME', kind: 'variable'},
-				{name: 'SVELTEKIT_CONFIG_FILENAME', kind: 'variable'},
-				{name: 'VITE_CONFIG_FILENAME', kind: 'variable'},
-				{name: 'NODE_MODULES_DIRNAME', kind: 'variable'},
-				{name: 'LOCKFILE_FILENAME', kind: 'variable'},
-				{name: 'SVELTEKIT_DEV_DIRNAME', kind: 'variable'},
-				{name: 'SVELTEKIT_BUILD_DIRNAME', kind: 'variable'},
-				{name: 'SVELTEKIT_DIST_DIRNAME', kind: 'variable'},
-				{name: 'SVELTEKIT_VITE_CACHE_PATH', kind: 'variable'},
-				{name: 'GITHUB_DIRNAME', kind: 'variable'},
-				{name: 'GIT_DIRNAME', kind: 'variable'},
-				{name: 'TSCONFIG_FILENAME', kind: 'variable'},
-				{name: 'TS_MATCHER', kind: 'variable'},
-				{name: 'JS_MATCHER', kind: 'variable'},
-				{name: 'JSON_MATCHER', kind: 'variable'},
-				{name: 'EVERYTHING_MATCHER', kind: 'variable'},
-			],
-		},
 		'./path.js': {
 			path: 'path.ts',
 			declarations: [

package/src/lib/package_json.ts

@@ -7,7 +7,7 @@ import type {Flavored} from '@ryanatkn/belt/types.js';
 import {styleText as st} from 'node:util';
 
 import {paths, gro_paths, IS_THIS_GRO, replace_extension} from './paths.js';
-import {SVELTEKIT_DIST_DIRNAME} from './path_constants.js';
+import {SVELTEKIT_DIST_DIRNAME} from './constants.js';
 import {search_fs} from './search_fs.js';
 import {has_sveltekit_library} from './sveltekit_helpers.js';
 import {GITHUB_REPO_MATCHER} from './github.js';
@@ -21,7 +21,7 @@ export const Email = z.string();
 export type Email = Flavored<z.infer<typeof Email>, 'Email'>;
 
 // TODO move this where?
-export const transform_empty_object_to_undefined = (val: any): any => {
+export const transform_empty_object_to_undefined = <T>(val: T): T | undefined => {
 	if (val && Object.keys(val).length === 0) {
 		return;
 	}
@@ -63,8 +63,19 @@ 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
+		.union([
+			z.string(),
+			z.record(z.string().optional()),
+			z.record(z.record(z.string().optional()).optional()),
+		])
+		.optional(),
 );
 export type Package_Json_Exports = z.infer<typeof Package_Json_Exports>;
 
@@ -76,7 +87,7 @@ export const Package_Json = z
 		// according to the npm docs, `name` and `version` are the only required properties
 		name: z.string(),
 		version: z.string(),
-		private: z.boolean({description: 'disallow npm publish'}).optional(),
+		private: z.boolean({description: 'disallow publishing to the configured registry'}).optional(),
 		public: z
 			.boolean({
 				description:
@@ -131,6 +142,7 @@ export const Package_Json = z
 		bin: z.record(z.string()).optional(),
 		sideEffects: z.array(z.string()).optional(),
 		files: z.array(z.string()).optional(),
+		main: z.string().optional(),
 		exports: Package_Json_Exports.transform(transform_empty_object_to_undefined).optional(),
 	})
 	.passthrough();
@@ -145,6 +157,7 @@ export const EMPTY_PACKAGE_JSON: Package_Json = {name: '', version: ''};
 export const load_package_json = (
 	dir = IS_THIS_GRO ? gro_paths.root : paths.root,
 	cache?: Record<string, Package_Json>,
+	parse = true, // TODO pass `false` here in more places, especially anything perf-sensitive like work on startup
 ): Package_Json => {
 	let package_json: Package_Json;
 	if (cache && dir in cache) {
@@ -155,8 +168,12 @@ export const load_package_json = (
 	} catch (_err) {
 		return EMPTY_PACKAGE_JSON;
 	}
-	package_json = parse_package_json(Package_Json, package_json);
-	if (cache) cache[dir] = package_json;
+	if (parse) {
+		package_json = parse_package_json(Package_Json, package_json);
+	}
+	if (cache) {
+		cache[dir] = package_json;
+	}
 	return package_json;
 };
 

package/src/lib/package_meta.ts

@@ -11,7 +11,7 @@ export interface Package_Meta {
 	name: string; // '@ryanatkn/fuz_library'
 	repo_name: string; // fuz_library
 	/**
-	 * the is the github user/org, not npm
+	 * The github user/org.
 	 */
 	owner_name: string | null; // 'fuz-dev'
 	homepage_url: Url | null; // 'https://www.fuz.dev/'

package/src/lib/parse_imports.ts

@@ -3,7 +3,7 @@ import type {Flavored} from '@ryanatkn/belt/types.js';
 
 import type {Path_Id} from './path.js';
 import {SVELTE_MATCHER} from './svelte_helpers.js';
-import {JS_MATCHER, TS_MATCHER} from './path_constants.js';
+import {JS_MATCHER, TS_MATCHER} from './constants.js';
 
 export const init_lexer = (): Promise<void> => init;
 

package/src/lib/paths.ts

@@ -9,7 +9,7 @@ import {
 	GRO_DIR,
 	SOURCE_DIR,
 	SVELTEKIT_DIST_DIRNAME,
-} from './path_constants.js';
+} from './constants.js';
 import {default_sveltekit_config} from './sveltekit_config.js';
 import type {Path_Id} from './path.js';
 

package/src/lib/publish.task.ts

@@ -6,7 +6,6 @@ import {existsSync} from 'node:fs';
 import {Task_Error, type Task} from './task.js';
 import {load_package_json, parse_repo_url} from './package_json.js';
 import {find_cli, spawn_cli} from './cli.js';
-import {IS_THIS_GRO} from './paths.js';
 import {has_sveltekit_library} from './sveltekit_helpers.js';
 import {update_changelog} from './changelog.js';
 import {load_from_env} from './env.js';
@@ -20,13 +19,6 @@ import {
 } from './git.js';
 import {CHANGESET_CLI} from './changeset_helpers.js';
 
-// publish.task.ts
-// - usage: `gro publish patch`
-// - forwards args to `npm version`: https://docs.npmjs.com/v6/commands/npm-version
-// - runs the production build
-// - publishes to npm from the `main` branch, configurable with `--branch`
-// - syncs commits and tags to the configured main branch
-
 export const Args = z
 	.object({
 		branch: Git_Branch.describe('branch to publish from').default('main'),
@@ -45,9 +37,7 @@ export const Args = z
 			.boolean({description: 'build and prepare to publish without actually publishing'})
 			.default(false),
 		check: z.boolean({description: 'dual of no-check'}).default(true),
-		'no-check': z
-			.boolean({description: 'opt out of npm checking before publishing'})
-			.default(false),
+		'no-check': z.boolean({description: 'opt out of checking before publishing'}).default(false),
 		build: z.boolean({description: 'dual of no-build'}).default(true),
 		'no-build': z.boolean({description: 'opt out of building'}).default(false),
 		pull: z.boolean({description: 'dual of no-pull'}).default(true),
@@ -58,7 +48,7 @@ export const Args = z
 export type Args = z.infer<typeof Args>;
 
 export const task: Task<Args> = {
-	summary: 'bump version, publish to npm, and git push',
+	summary: 'bump version, publish to the configured registry, and git push',
 	Args,
 	run: async ({args, log, invoke_task}): Promise<void> => {
 		const {
@@ -84,11 +74,6 @@ export const task: Task<Args> = {
 			);
 		}
 
-		// TODO hacky, ensures Gro bootstraps itself
-		if (IS_THIS_GRO) {
-			await spawn('npm', ['run', 'build']);
-		}
-
 		const changelog_exists = existsSync(changelog);
 
 		const found_changeset_cli = find_cli(changeset_cli);
@@ -139,9 +124,9 @@ export const task: Task<Args> = {
 
 			// This is the first line that alters the repo.
 
-			const npmVersionResult = await spawn_cli(found_changeset_cli, ['version'], log);
-			if (!npmVersionResult?.ok) {
-				throw Error('npm version failed: no commits were made: see the error above');
+			const changeset_ersion_result = await spawn_cli(found_changeset_cli, ['version'], log);
+			if (!changeset_ersion_result?.ok) {
+				throw Error('changeset version failed: no commits were made: see the error above');
 			}
 
 			if (!preserve_changelog) {
@@ -185,8 +170,8 @@ export const task: Task<Args> = {
 			return;
 		}
 
-		const npm_publish_result = await spawn_cli(found_changeset_cli, ['publish'], log);
-		if (!npm_publish_result?.ok) {
+		const changeset_publish_result = await spawn_cli(found_changeset_cli, ['publish'], log);
+		if (!changeset_publish_result?.ok) {
 			throw new Task_Error(
 				`\`${changeset_cli} publish\` failed - continue manually or try again after running \`git reset --hard\``,
 			);

package/src/lib/reinstall.task.ts

@@ -3,7 +3,7 @@ import {spawn} from '@ryanatkn/belt/process.js';
 import {rm} from 'node:fs/promises';
 
 import {Task_Error, type Task} from './task.js';
-import {LOCKFILE_FILENAME, NODE_MODULES_DIRNAME} from './path_constants.js';
+import {LOCKFILE_FILENAME, NODE_MODULES_DIRNAME} from './constants.js';
 
 export const Args = z.object({}).strict();
 export type Args = z.infer<typeof Args>;
@@ -11,32 +11,32 @@ export type Args = z.infer<typeof Args>;
 export const task: Task<Args> = {
 	summary: `refreshes ${LOCKFILE_FILENAME} with the latest and cleanest deps`,
 	Args,
-	run: async ({log}): Promise<void> => {
-		log.info('running the initial npm install');
-		const initial_install_result = await spawn('npm', ['i']);
+	run: async ({log, config}): Promise<void> => {
+		log.info(`running the initial \`${config.pm_cli} install\``);
+		const initial_install_result = await spawn(config.pm_cli, ['install']);
 		if (!initial_install_result.ok) {
-			throw new Task_Error('Failed initial npm install');
+			throw new Task_Error(`Failed initial \`${config.pm_cli} install\``);
 		}
 
 		// Deleting both the lockfile and node_modules upgrades to the latest minor/patch versions.
 		await Promise.all([rm(LOCKFILE_FILENAME), rm(NODE_MODULES_DIRNAME, {recursive: true})]);
 		log.info(
-			`running npm install after deleting ${LOCKFILE_FILENAME} and ${NODE_MODULES_DIRNAME}, this can take a while...`,
+			`running \`${config.pm_cli} install\` after deleting ${LOCKFILE_FILENAME} and ${NODE_MODULES_DIRNAME}, this can take a while...`,
 		);
-		const second_install_result = await spawn('npm', ['i']);
+		const second_install_result = await spawn(config.pm_cli, ['install']);
 		if (!second_install_result.ok) {
 			throw new Task_Error(
-				`Failed npm install after deleting ${LOCKFILE_FILENAME} and ${NODE_MODULES_DIRNAME}`,
+				`Failed \`${config.pm_cli} install\` after deleting ${LOCKFILE_FILENAME} and ${NODE_MODULES_DIRNAME}`,
 			);
 		}
 
 		// Deleting the lockfile and reinstalling cleans the lockfile of unnecessary dep noise,
 		// like esbuild's many packages for each platform.
 		await rm(LOCKFILE_FILENAME);
-		log.info(`running npm install one last time to clean ${LOCKFILE_FILENAME}`);
-		const final_install_result = await spawn('npm', ['i']);
+		log.info(`running \`${config.pm_cli} install\` one last time to clean ${LOCKFILE_FILENAME}`);
+		const final_install_result = await spawn(config.pm_cli, ['install']);
 		if (!final_install_result.ok) {
-			throw new Task_Error('Failed npm install');
+			throw new Task_Error(`Failed \`${config.pm_cli} install\``);
 		}
 	},
 };

package/src/lib/resolve_node_specifier.ts

@@ -1,21 +1,32 @@
 import {join} from 'node:path';
+import {existsSync} from 'node:fs';
+import {DEV} from 'esm-env';
 
-import {Package_Json, load_package_json} from './package_json.js';
+import {Package_Json, Package_Json_Exports, load_package_json} from './package_json.js';
 import {paths} from './paths.js';
-import {NODE_MODULES_DIRNAME} from './path_constants.js';
+import {NODE_MODULES_DIRNAME} from './constants.js';
 import type {Resolved_Specifier} from './resolve_specifier.js';
 
+/**
+ * Like `resolve_specifier` but for Node specifiers,
+ * typically those that aren't relative or absolute.
+ * Optionally return `null` instead of throwing by setting
+ * `throw_on_missing_package` to `false`.
+ */
 export const resolve_node_specifier = (
 	specifier: string,
 	dir = paths.root,
-	parent_url?: string,
+	parent_path?: string,
 	cache?: Record<string, Package_Json>,
-	exports_key = specifier.endsWith('.svelte') ? 'svelte' : 'default',
-): Resolved_Specifier => {
+	throw_on_missing_package = true,
+	// TODO this needs to use `--conditions`/`-C` to determine the correct key
+	exports_condition = DEV ? 'development' : 'default',
+): Resolved_Specifier | null => {
 	const raw = specifier.endsWith('?raw');
 	const mapped_specifier = raw ? specifier.substring(0, specifier.length - 4) : specifier;
 
-	let idx!: number;
+	// Parse the specifier
+	let idx: number = -1;
 	if (mapped_specifier[0] === '@') {
 		// get the index of the second `/`
 		let count = 0;
@@ -29,21 +40,47 @@ export const resolve_node_specifier = (
 	} else {
 		idx = mapped_specifier.indexOf('/');
 	}
-	const name = mapped_specifier.substring(0, idx);
-	const path = mapped_specifier.substring(idx + 1);
+	const pkg_name = idx === -1 ? mapped_specifier : mapped_specifier.substring(0, idx);
+	const module_path = idx === -1 ? '' : mapped_specifier.substring(idx + 1);
+	const subpath = module_path ? './' + module_path : '.';
+	const package_dir = join(dir, NODE_MODULES_DIRNAME, pkg_name);
 
-	const subpath = './' + path;
-	const package_dir = join(dir, NODE_MODULES_DIRNAME, name);
-	const package_json = load_package_json(package_dir, cache);
-	const exported = package_json.exports?.[subpath];
+	if (!existsSync(package_dir)) {
+		if (throw_on_missing_package) {
+			throw Error(
+				`Package not found at ${package_dir} for specifier ${specifier}, you may need to install packages or fix the path` +
+					(parent_path ? ` imported from ${parent_path}` : ''),
+			);
+		} else {
+			return null;
+		}
+	}
+
+	const package_json = load_package_json(package_dir, cache, false);
+	const {exported, exports_key} = resolve_subpath(package_json, specifier, subpath);
 	if (!exported) {
-		// same error message as Node
-		throw Error(
-			`[ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath '${subpath}' is not defined by "exports" in ${package_dir}/package.json` +
-				(parent_url ? ` imported from ${parent_url}` : ''),
-		);
+		if (throw_on_missing_package) {
+			// same error message as Node
+			throw Error(
+				`[ERR_PACKAGE_PATH_NOT_EXPORTED]: Package subpath '${subpath}' is not defined by 'exports' in ${package_dir}/package.json` +
+					(parent_path ? ` imported from ${parent_path}` : ''),
+			);
+		} else {
+			return null;
+		}
 	}
-	const path_id = join(package_dir, exported[exports_key]);
+	const exported_value = resolve_exported_value(exported, exports_key, exports_condition);
+	if (exported_value === undefined) {
+		if (throw_on_missing_package) {
+			throw Error(
+				`Package subpath '${subpath}' does not define the key '${exports_key}' in 'exports' in ${package_dir}/package.json` +
+					(parent_path ? ` imported from ${parent_path}` : ''),
+			);
+		} else {
+			return null;
+		}
+	}
+	const path_id = join(package_dir, exported_value);
 
 	return {
 		path_id,
@@ -54,3 +91,48 @@ export const resolve_node_specifier = (
 		namespace: undefined,
 	};
 };
+
+/**
+ * Resolves the subpath of a package.json `exports` field based on the `specifier`.
+ */
+const resolve_subpath = (
+	package_json: Package_Json,
+	specifier: string,
+	subpath: string,
+): {exported: Package_Json_Exports[string]; exports_key: string} => {
+	const exports_key = specifier.endsWith('.svelte') ? 'svelte' : 'default';
+
+	const exported =
+		subpath === '.' && !package_json.exports
+			? {[exports_key]: package_json.main}
+			: package_json.exports?.[subpath];
+
+	return {exported, exports_key};
+};
+
+/**
+ * Resolves the exported value based on the exports key and condition.
+ */
+const resolve_exported_value = (
+	exported: Exclude<Package_Json_Exports[string], undefined>,
+	exports_key: string,
+	exports_condition: string,
+): string | undefined => {
+	let exported_value = typeof exported === 'string' ? exported : exported[exports_key];
+
+	// TODO best effort fallback, support `default` but fall back to `import` or `node` as the exports key.
+	if (exported_value === undefined && typeof exported !== 'string' && exports_key === 'default') {
+		exported_value = exported.import ?? exported.node;
+	}
+
+	// Possibly resolve to conditional exports.
+	exported_value =
+		exported_value === undefined || typeof exported_value === 'string'
+			? exported_value
+			: (exported_value[exports_condition] ??
+				exported_value.default ??
+				exported_value.import ??
+				exported_value.node); // TODO this fallback has corner case bugs for off-spec exports
+
+	return exported_value;
+};

package/src/lib/resolve_specifier.ts

@@ -20,13 +20,9 @@ export interface Resolved_Specifier {
 }
 
 /**
- * Maps a `path` import specifier relative to the `importer`,
+ * Maps an import `specifier` relative to `dir`,
  * and infer the correct extension following Vite conventions.
- * If no `.js` file is found for the `path` on the filesystem, it assumes `.ts`.
- * @param specifier
- * @param dir - if defined, enables relative importers like from esbuild plugins
- * @param passthrough_extensions - used to support specifiers that have no file extention, which Vite supports, so we do our best effort
- * @returns
+ * If no `.js` file is found for the specifier on the filesystem, it assumes `.ts`.
  */
 export const resolve_specifier = (specifier: string, dir: string): Resolved_Specifier => {
 	const raw = specifier.endsWith('?raw');

package/src/lib/run_task.ts

@@ -72,7 +72,7 @@ export const run_task = async (
 					: `Unexpected error running task ${st(
 							'cyan',
 							task_meta.name,
-						)}. If this is unexpected try running \`npm i\` and \`gro clean\`.`,
+						)}. If this is unexpected try running \`${config.pm_cli} install\` and \`gro clean\`.`,
 			),
 			error: err,
 		};

package/src/lib/sveltekit_config.ts

@@ -2,7 +2,7 @@ import type {Config as SveltekitConfig} from '@sveltejs/kit';
 import type {CompileOptions, ModuleCompileOptions, PreprocessorGroup} from 'svelte/compiler';
 import {join} from 'node:path';
 
-import {SVELTEKIT_CONFIG_FILENAME} from './path_constants.js';
+import {SVELTEKIT_CONFIG_FILENAME} from './constants.js';
 
 /*
 
@@ -57,7 +57,7 @@ export interface Parsed_Sveltekit_Config {
 	private_prefix: string | undefined;
 	public_prefix: string | undefined;
 	svelte_compile_options: CompileOptions;
-	svelte_compile_module_options: CompileOptions;
+	svelte_compile_module_options: ModuleCompileOptions;
 	svelte_preprocessors: PreprocessorGroup | PreprocessorGroup[] | undefined;
 }
 

package/src/lib/sveltekit_helpers.ts

@@ -5,7 +5,7 @@ import {join} from 'node:path';
 
 import {Package_Json, has_dep} from './package_json.js';
 import {default_sveltekit_config, type Parsed_Sveltekit_Config} from './sveltekit_config.js';
-import {SVELTEKIT_CONFIG_FILENAME, SVELTEKIT_DEV_DIRNAME} from './path_constants.js';
+import {SVELTEKIT_CONFIG_FILENAME, SVELTEKIT_DEV_DIRNAME, PM_CLI_DEFAULT} from './constants.js';
 import {find_cli, spawn_cli, to_cli_name, type Cli} from './cli.js';
 import {Task_Error} from './task.js';
 import {serialize_args, to_forwarded_args} from './args.js';
@@ -33,6 +33,7 @@ export const has_sveltekit_library = (
 	package_json?: Package_Json,
 	sveltekit_config: Parsed_Sveltekit_Config = default_sveltekit_config,
 	dep_name = SVELTE_PACKAGE_DEP_NAME,
+	pm_cli = PM_CLI_DEFAULT, // TODO source from config when possible, is just needed for error messages
 ): Result<object, {message: string}> => {
 	const has_sveltekit_app_result = has_sveltekit_app();
 	if (!has_sveltekit_app_result.ok) {
@@ -46,7 +47,7 @@ export const has_sveltekit_library = (
 	if (!has_dep(dep_name, package_json)) {
 		return {
 			ok: false,
-			message: `no dependency found in package.json for ${dep_name}, install it with \`npm i -D ${dep_name}\``,
+			message: `no dependency found in package.json for ${dep_name}, install it with \`${pm_cli} install -D ${dep_name}\``,
 		};
 	}
 
@@ -55,11 +56,12 @@ export const has_sveltekit_library = (
 
 export const sveltekit_sync = async (
 	sveltekit_cli: string | Cli = SVELTEKIT_CLI,
+	pm_cli = PM_CLI_DEFAULT, // TODO source from config when possible, is just needed for error messages
 ): Promise<void> => {
 	const result = await spawn_cli(sveltekit_cli, ['sync']);
 	if (!result) {
 		throw new Task_Error(
-			`Failed to find SvelteKit CLI \`${to_cli_name(sveltekit_cli)}\`, do you need to run \`npm i\`?`,
+			`Failed to find SvelteKit CLI \`${to_cli_name(sveltekit_cli)}\`, do you need to run \`${pm_cli} install\`?`,
 		);
 	} else if (!result.ok) {
 		throw new Task_Error(`Failed ${to_cli_name(sveltekit_cli)} sync`);
@@ -151,6 +153,7 @@ export const run_svelte_package = async (
 	options: Svelte_Package_Options | undefined,
 	cli: string | Cli,
 	log: Logger,
+	pm_cli: string,
 ): Promise<void> => {
 	const has_sveltekit_library_result = has_sveltekit_library();
 	if (!has_sveltekit_library_result.ok) {
@@ -162,7 +165,7 @@ export const run_svelte_package = async (
 	const found_svelte_package_cli = cli === cli_name ? find_cli(cli) : (cli as Cli);
 	if (found_svelte_package_cli?.kind !== 'local') {
 		throw new Task_Error(
-			`Failed to find SvelteKit packaging CLI \`${cli_name}\`, do you need to run \`npm i\`?`,
+			`Failed to find SvelteKit packaging CLI \`${cli_name}\`, do you need to run \`${pm_cli} install\`?`,
 		);
 	}
 	const serialized_args = serialize_args({