@ryanatkn/gro 0.142.0 → 0.143.1

package/src/lib/format.task.ts

@@ -17,10 +17,18 @@ export type Args = z.infer<typeof Args>;
 export const task: Task<Args> = {
 	summary: 'format source files',
 	Args,
-	run: async ({args, log}) => {
+	run: async ({args, log, config}) => {
 		const {check} = args;
 		// TODO forward prettier args
-		const format_result = await format_directory(log, paths.source, check);
+		const format_result = await format_directory(
+			log,
+			paths.source,
+			check,
+			undefined,
+			undefined,
+			undefined,
+			config.pm_cli,
+		);
 		if (!format_result.ok) {
 			throw new Task_Error(
 				`Failed ${check ? 'formatting check' : 'to format'}. ${print_spawn_result(format_result)}`,

package/src/lib/format_directory.ts

@@ -9,14 +9,14 @@ import {
 	VITE_CONFIG_FILENAME,
 	TSCONFIG_FILENAME,
 	GRO_CONFIG_PATH,
-} from './path_constants.js';
+	PM_CLI_DEFAULT,
+	PRETTIER_CLI_DEFAULT,
+} from './constants.js';
 import {serialize_args, to_forwarded_args} from './args.js';
 import {spawn_cli, to_cli_name, type Cli} from './cli.js';
 
-const PRETTIER_CLI = 'prettier';
-
-const DEFAULT_EXTENSIONS = 'ts,js,json,svelte,html,css,md,yml';
-const DEFAULT_ROOT_PATHS = `${[
+const EXTENSIONS_DEFAULT = 'ts,js,json,svelte,html,css,md,yml';
+const ROOT_PATHS_DEFAULT = `${[
 	README_FILENAME,
 	GRO_CONFIG_PATH,
 	SVELTEKIT_CONFIG_FILENAME,
@@ -35,9 +35,10 @@ export const format_directory = async (
 	log: Logger,
 	dir: string,
 	check = false,
-	extensions = DEFAULT_EXTENSIONS,
-	root_paths = DEFAULT_ROOT_PATHS,
-	prettier_cli: string | Cli = PRETTIER_CLI,
+	extensions = EXTENSIONS_DEFAULT,
+	root_paths = ROOT_PATHS_DEFAULT,
+	prettier_cli: string | Cli = PRETTIER_CLI_DEFAULT,
+	pm_cli: string = PM_CLI_DEFAULT,
 ): Promise<Spawn_Result> => {
 	const forwarded_args = to_forwarded_args(to_cli_name(prettier_cli));
 	forwarded_args[check ? 'check' : 'write'] = true;
@@ -49,7 +50,7 @@ export const format_directory = async (
 	const spawned = await spawn_cli(prettier_cli, serialized_args, log);
 	if (!spawned)
 		throw new Error(
-			`failed to find \`${to_cli_name(prettier_cli)}\` CLI locally or globally, do you need to run \`npm i\`?`,
+			`failed to find \`${to_cli_name(prettier_cli)}\` CLI locally or globally, do you need to run \`${pm_cli} install\`?`,
 		);
 	return spawned;
 };

package/src/lib/gen.task.ts

@@ -10,7 +10,7 @@ import {format_file} from './format_file.js';
 import {print_path} from './paths.js';
 import {log_error_reasons} from './task_logging.js';
 import {write_gen_results, analyze_gen_results, find_genfiles, load_genfiles} from './gen.js';
-import {SOURCE_DIRNAME} from './path_constants.js';
+import {SOURCE_DIRNAME} from './constants.js';
 
 export const Args = z
 	.object({

package/src/lib/gro_config.ts

@@ -4,11 +4,13 @@ import {existsSync} from 'node:fs';
 import {GRO_DIST_DIR, IS_THIS_GRO, paths} from './paths.js';
 import {
 	GRO_CONFIG_PATH,
+	JS_CLI_DEFAULT,
 	NODE_MODULES_DIRNAME,
+	PM_CLI_DEFAULT,
 	SERVER_DIST_PATH,
 	SVELTEKIT_BUILD_DIRNAME,
 	SVELTEKIT_DIST_DIRNAME,
-} from './path_constants.js';
+} from './constants.js';
 import create_default_config from './gro.config.default.js';
 import type {Create_Config_Plugins} from './plugin.js';
 import type {Map_Package_Json} from './package_json.js';
@@ -40,6 +42,10 @@ export interface Gro_Config {
 	 * directories and files are included if they pass all of these filters.
 	 */
 	search_filters: Path_Filter[];
+	/**
+	 * The CLI to use that's compatible with `node`.
+	 */
+	js_cli: string;
 	/**
 	 * The CLI to use that's compatible with `npm install` and `npm link`. Defaults to `'npm'`.
 	 */
@@ -56,6 +62,7 @@ export interface Raw_Gro_Config {
 	map_package_json?: Map_Package_Json | null;
 	task_root_dirs?: string[];
 	search_filters?: Path_Filter | Path_Filter[] | null;
+	js_cli?: string;
 	pm_cli?: string;
 }
 
@@ -72,8 +79,9 @@ export const create_empty_gro_config = (): Gro_Config => ({
 		IS_THIS_GRO ? null : paths.root,
 		IS_THIS_GRO ? null : GRO_DIST_DIR,
 	].filter((v) => v !== null),
-	search_filters: [(id) => !DEFAULT_SEARCH_EXCLUDER.test(id)],
-	pm_cli: 'npm',
+	search_filters: [(id) => !SEARCH_EXCLUDER_DEFAULT.test(id)],
+	js_cli: JS_CLI_DEFAULT,
+	pm_cli: PM_CLI_DEFAULT,
 });
 
 /**
@@ -82,7 +90,7 @@ export const create_empty_gro_config = (): Gro_Config => ({
  * Customize via `search_filters` in the `Gro_Config`.
  * See the test cases for the exact behavior.
  */
-export const DEFAULT_SEARCH_EXCLUDER = new RegExp(
+export const SEARCH_EXCLUDER_DEFAULT = new RegExp(
 	`(${
 		'(^|/)\\.[^/]+' + // exclude all `.`-prefixed directories
 		// TODO probably change to `pkg.name` instead of this catch-all (also `gro` below)
@@ -97,13 +105,13 @@ export const DEFAULT_SEARCH_EXCLUDER = new RegExp(
 const default_map_package_json: Map_Package_Json = (package_json) => {
 	if (package_json.exports) {
 		package_json.exports = Object.fromEntries(
-			Object.entries(package_json.exports).filter(([k]) => !DEFAULT_EXPORTS_EXCLUDER.test(k)),
+			Object.entries(package_json.exports).filter(([k]) => !EXPORTS_EXCLUDER_DEFAULT.test(k)),
 		);
 	}
 	return package_json;
 };
 
-export const DEFAULT_EXPORTS_EXCLUDER = /(\.md|\.(test|ignore)\.|\/(test|fixtures|ignore)\/)/;
+export const EXPORTS_EXCLUDER_DEFAULT = /(\.md|\.(test|ignore)\.|\/(test|fixtures|ignore)\/)/;
 
 /**
  * Transforms a `Raw_Gro_Config` to the more strict `Gro_Config`.
@@ -118,6 +126,7 @@ export const normalize_gro_config = (raw_config: Raw_Gro_Config): Gro_Config =>
 		map_package_json = empty_config.map_package_json,
 		task_root_dirs = empty_config.task_root_dirs,
 		search_filters = empty_config.search_filters,
+		js_cli = empty_config.js_cli,
 		pm_cli = empty_config.pm_cli,
 	} = raw_config;
 	return {
@@ -129,6 +138,7 @@ export const normalize_gro_config = (raw_config: Raw_Gro_Config): Gro_Config =>
 			: search_filters
 				? [search_filters]
 				: [],
+		js_cli,
 		pm_cli,
 	};
 };

package/src/lib/gro_helpers.ts

@@ -3,7 +3,7 @@ import {join, resolve} from 'node:path';
 import {fileURLToPath} from 'node:url';
 import {spawn, type Spawn_Result} from '@ryanatkn/belt/process.js';
 
-import {NODE_MODULES_DIRNAME, SVELTEKIT_DIST_DIRNAME} from './path_constants.js';
+import {JS_CLI_DEFAULT, NODE_MODULES_DIRNAME, SVELTEKIT_DIST_DIRNAME} from './constants.js';
 
 /*
 
@@ -84,6 +84,7 @@ export const spawn_with_loader = (
 	loader_path: string,
 	invoke_path: string,
 	argv: string[],
+	js_cli = JS_CLI_DEFAULT, // TODO source from config when possible
 ): Promise<Spawn_Result> => {
 	const args = [
 		'--import',
@@ -99,5 +100,5 @@ export const spawn_with_loader = (
 		args.push('-C', 'development'); // same as `--conditions`
 	}
 	args.push(invoke_path, ...argv);
-	return spawn('node', args);
+	return spawn(js_cli, args);
 };

package/src/lib/gro_plugin_server.ts

@@ -11,7 +11,7 @@ import {throttle} from '@ryanatkn/belt/throttle.js';
 import type {Plugin} from './plugin.js';
 import {base_path_to_path_id, LIB_DIRNAME, paths} from './paths.js';
 import type {Path_Id} from './path.js';
-import {GRO_DEV_DIRNAME, SERVER_DIST_PATH} from './path_constants.js';
+import {GRO_DEV_DIRNAME, SERVER_DIST_PATH} from './constants.js';
 import {watch_dir, type Watch_Node_Fs} from './watch_dir.js';
 import {init_sveltekit_config, default_sveltekit_config} from './sveltekit_config.js';
 import {esbuild_plugin_sveltekit_shim_app} from './esbuild_plugin_sveltekit_shim_app.js';
@@ -119,7 +119,7 @@ export const gro_plugin_server = ({
 	target = 'esnext',
 	esbuild_build_options = identity,
 	rebuild_throttle_delay = 1000,
-	cli_command = 'node',
+	cli_command,
 	run, // `dev` default is not available in this scope
 }: Options = {}): Plugin => {
 	let build_ctx: esbuild.BuildContext | null = null;
@@ -129,7 +129,7 @@ export const gro_plugin_server = ({
 
 	return {
 		name: 'gro_plugin_server',
-		setup: async ({dev, watch, timings, log}) => {
+		setup: async ({dev, watch, timings, log, config}) => {
 			const parsed_sveltekit_config =
 				!sveltekit_config && strip_end(dir, '/') === process.cwd()
 					? default_sveltekit_config
@@ -256,7 +256,7 @@ export const gro_plugin_server = ({
 					cli_args.push('-C', 'development'); // same as `--conditions`
 				}
 				cli_args.push(server_outpath);
-				server_process = spawn_restartable_process(cli_command, cli_args);
+				server_process = spawn_restartable_process(cli_command ?? config.js_cli, cli_args);
 			}
 		},
 		teardown: async () => {

package/src/lib/gro_plugin_sveltekit_app.ts

@@ -8,9 +8,9 @@ import {serialize_package_json, type Map_Package_Json, load_package_json} from '
 import {Task_Error} from './task.js';
 import {find_cli, spawn_cli, spawn_cli_process} from './cli.js';
 import {type Map_Src_Json, serialize_src_json, create_src_json} from './src_json.js';
-import {DEFAULT_EXPORTS_EXCLUDER} from './gro_config.js';
+import {EXPORTS_EXCLUDER_DEFAULT} from './gro_config.js';
 import {default_sveltekit_config} from './sveltekit_config.js';
-import {SOURCE_DIRNAME} from './path_constants.js';
+import {SOURCE_DIRNAME} from './constants.js';
 import {VITE_CLI} from './sveltekit_helpers.js';
 
 export interface Options {
@@ -57,10 +57,12 @@ export const gro_plugin_sveltekit_app = ({
 	let sveltekit_process: Spawned_Process | undefined = undefined;
 	return {
 		name: 'gro_plugin_sveltekit_app',
-		setup: async ({dev, watch, log}) => {
+		setup: async ({dev, watch, log, config}) => {
 			const found_vite_cli = find_cli(vite_cli);
 			if (!found_vite_cli)
-				throw new Error(`Failed to find Vite CLI \`${vite_cli}\`, do you need to run \`npm i\`?`);
+				throw new Error(
+					`Failed to find Vite CLI \`${vite_cli}\`, do you need to run \`${config.pm_cli} i\`?`,
+				);
 			if (dev) {
 				// `vite dev` in development mode
 				if (watch) {
@@ -123,7 +125,7 @@ export const gro_plugin_sveltekit_app = ({
 								assets_path,
 								'.well-known',
 								well_known_src_files === true
-									? (file_path) => !DEFAULT_EXPORTS_EXCLUDER.test(file_path)
+									? (file_path) => !EXPORTS_EXCLUDER_DEFAULT.test(file_path)
 									: well_known_src_files,
 							)
 						: null,

package/src/lib/gro_plugin_sveltekit_library.ts

@@ -28,15 +28,15 @@ export const gro_plugin_sveltekit_library = ({
 }: Options = {}): Plugin => {
 	return {
 		name: 'gro_plugin_sveltekit_library',
-		setup: async ({dev, log}) => {
+		setup: async ({dev, log, config}) => {
 			if (!dev) {
-				await run_svelte_package(svelte_package_options, svelte_package_cli, log);
+				await run_svelte_package(svelte_package_options, svelte_package_cli, log, config.pm_cli);
 			}
 		},
 		adapt: async ({log, timings, config}) => {
 			const package_json = load_package_json();
 
-			// `npm link`
+			// link the CLI binaries if they exist
 			if (package_json.bin) {
 				const timing_to_link = timings.start(`${config.pm_cli} link`);
 				await Promise.all(

package/src/lib/loader.ts

@@ -17,7 +17,7 @@ import {
 import {default_sveltekit_config} from './sveltekit_config.js';
 import {SVELTE_MATCHER, SVELTE_RUNES_MATCHER} from './svelte_helpers.js';
 import {IS_THIS_GRO, paths} from './paths.js';
-import {JSON_MATCHER, NODE_MODULES_DIRNAME, TS_MATCHER} from './path_constants.js';
+import {JSON_MATCHER, NODE_MODULES_DIRNAME, TS_MATCHER} from './constants.js';
 import {to_define_import_meta_env, default_ts_transform_options} from './esbuild_helpers.js';
 import {resolve_specifier} from './resolve_specifier.js';
 import {resolve_node_specifier} from './resolve_node_specifier.js';

package/src/lib/module.ts

@@ -1,5 +1,5 @@
 import {LIB_DIRNAME} from './paths.js';
-import {SOURCE_DIR, SOURCE_DIRNAME} from './path_constants.js';
+import {SOURCE_DIR, SOURCE_DIRNAME} from './constants.js';
 
 export const MODULE_PATH_SRC_PREFIX = SOURCE_DIR;
 export const MODULE_PATH_LIB_PREFIX = `$${LIB_DIRNAME}/`;

package/src/lib/moss_helpers.ts

@@ -3,7 +3,7 @@ import {existsSync} from 'node:fs';
 import {resolve} from 'node:path';
 
 import {has_dep, type Package_Json} from './package_json.js';
-import {NODE_MODULES_DIRNAME} from './path_constants.js';
+import {NODE_MODULES_DIRNAME, PM_CLI_DEFAULT} from './constants.js';
 
 export const MOSS_PACKAGE_DEP_NAME = '@ryanatkn/moss';
 
@@ -13,11 +13,12 @@ export const load_moss_plugin = async (
 	dep_name = MOSS_PACKAGE_DEP_NAME,
 	plugin_path = `${NODE_MODULES_DIRNAME}/${dep_name}/dist/gro_plugin_moss.js`, // TODO maybe lookup from its `package_json.exports`? kinda unnecessary
 	local_plugin_path = 'src/lib/gro_plugin_moss.ts',
+	pm_cli = PM_CLI_DEFAULT, // TODO source from config when possible, is just needed for error messages
 ): Promise<Result<{gro_plugin_moss: any}, {message: string}>> => {
 	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}\``,
 		};
 	}
 

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.142.0',
+	version: '0.143.1',
 	description: 'task runner and toolkit extending SvelteKit',
 	motto: 'generate, run, optimize',
 	glyph: '🌰',
@@ -56,7 +56,7 @@ export const package_json = {
 		tslib: '^2.8.0',
 		zod: '^3.23.8',
 	},
-	peerDependencies: {esbuild: '^0.21.0', svelte: '^5.0.0-next.0'},
+	peerDependencies: {esbuild: '^0.21.0', svelte: '^5'},
 	devDependencies: {
 		'@changesets/changelog-git': '^0.2.0',
 		'@changesets/types': '^6.0.0',
@@ -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.142.0',
+	version: '0.143.1',
 	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';
@@ -87,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:

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

@@ -19,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'),
@@ -44,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),
@@ -57,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 {
@@ -179,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>;
@@ -12,31 +12,31 @@ export const task: Task<Args> = {
 	summary: `refreshes ${LOCKFILE_FILENAME} with the latest and cleanest deps`,
 	Args,
 	run: async ({log, config}): Promise<void> => {
-		log.info('running the initial npm install');
-		const initial_install_result = await spawn(config.pm_cli, ['i']);
+		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(config.pm_cli, ['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(config.pm_cli, ['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

@@ -4,7 +4,7 @@ import {DEV} from 'esm-env';
 
 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';
 
 /**
@@ -48,7 +48,7 @@ export const resolve_node_specifier = (
 	if (!existsSync(package_dir)) {
 		if (throw_on_missing_package) {
 			throw Error(
-				`Package not found at ${package_dir} for specifier ${specifier}, you may need to npm install or fix the path` +
+				`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 {

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';
 
 /*