@fuzdev/gro 0.192.0

package/dist/changeset_helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeset_helpers.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/changeset_helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,2BAA2B,eAAe,CAAC;AACxD,eAAO,MAAM,uBAAuB,WAAW,CAAC;AAEhD,eAAO,MAAM,eAAe;;;EAAiE,CAAC;AAC9F,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE9D,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,eAAO,MAAM,aAAa,eAAe,CAAC;AAE1C,eAAO,MAAM,aAAa;;;;EAAsC,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC"}

package/dist/changeset_helpers.js

@@ -0,0 +1,7 @@
+import { z } from 'zod';
+export const CHANGESET_RESTRICTED_ACCESS = 'restricted';
+export const CHANGESET_PUBLIC_ACCESS = 'public';
+export const ChangesetAccess = z.enum([CHANGESET_RESTRICTED_ACCESS, CHANGESET_PUBLIC_ACCESS]);
+export const CHANGESET_CLI = 'changeset';
+export const CHANGESET_DIR = '.changeset';
+export const ChangesetBump = z.enum(['patch', 'minor', 'major']);

package/dist/check.task.d.ts

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { type Task } from './task.ts';
+/** @nodocs */
+export declare const Args: z.ZodObject<{
+    typecheck: z.ZodDefault<z.ZodBoolean>;
+    'no-typecheck': z.ZodDefault<z.ZodBoolean>;
+    test: z.ZodDefault<z.ZodBoolean>;
+    'no-test': z.ZodDefault<z.ZodBoolean>;
+    gen: z.ZodDefault<z.ZodBoolean>;
+    'no-gen': z.ZodDefault<z.ZodBoolean>;
+    format: z.ZodDefault<z.ZodBoolean>;
+    'no-format': z.ZodDefault<z.ZodBoolean>;
+    package_json: z.ZodDefault<z.ZodBoolean>;
+    'no-package_json': z.ZodDefault<z.ZodBoolean>;
+    lint: z.ZodDefault<z.ZodBoolean>;
+    'no-lint': z.ZodDefault<z.ZodBoolean>;
+    build: z.ZodDefault<z.ZodBoolean>;
+    'no-build': z.ZodDefault<z.ZodBoolean>;
+    force_build: z.ZodDefault<z.ZodBoolean>;
+    sync: z.ZodDefault<z.ZodBoolean>;
+    'no-sync': z.ZodDefault<z.ZodBoolean>;
+    install: z.ZodDefault<z.ZodBoolean>;
+    workspace: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+/** @nodocs */
+export declare const task: Task<Args>;
+//# sourceMappingURL=check.task.d.ts.map

package/dist/check.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/check.task.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAKtB,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAG/C,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;kBA6Bf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAwF3B,CAAC"}

package/dist/check.task.js

@@ -0,0 +1,104 @@
+import { readdir } from 'node:fs/promises';
+import { z } from 'zod';
+import { spawn } from '@fuzdev/fuz_util/process.js';
+import { styleText as st } from 'node:util';
+import { git_check_clean_workspace } from '@fuzdev/fuz_util/git.js';
+import { TaskError } from "./task.js";
+import { package_json_sync } from "./package_json.js";
+/** @nodocs */
+export const Args = z.strictObject({
+    typecheck: z.boolean().meta({ description: 'dual of no-typecheck' }).default(true),
+    'no-typecheck': z.boolean().meta({ description: 'opt out of typechecking' }).default(false),
+    test: z.boolean().meta({ description: 'dual of no-test' }).default(true),
+    'no-test': z.boolean().meta({ description: 'opt out of running tests' }).default(false),
+    gen: z.boolean().meta({ description: 'dual of no-gen' }).default(true),
+    'no-gen': z.boolean().meta({ description: 'opt out of gen check' }).default(false),
+    format: z.boolean().meta({ description: 'dual of no-format' }).default(true),
+    'no-format': z.boolean().meta({ description: 'opt out of format check' }).default(false),
+    package_json: z.boolean().meta({ description: 'dual of no-package_json' }).default(true),
+    'no-package_json': z
+        .boolean()
+        .meta({ description: 'opt out of package.json check' })
+        .default(false),
+    lint: z.boolean().meta({ description: 'dual of no-lint' }).default(true),
+    'no-lint': z.boolean().meta({ description: 'opt out of linting' }).default(false),
+    build: z.boolean().meta({ description: 'dual of no-build' }).default(false),
+    'no-build': z.boolean().meta({ description: 'opt out of building' }).default(true),
+    force_build: z
+        .boolean()
+        .meta({ description: 'force a fresh build, ignoring the cache' })
+        .default(false),
+    sync: z.boolean().meta({ description: 'dual of no-sync' }).default(true),
+    'no-sync': z.boolean().meta({ description: 'opt out of syncing' }).default(false),
+    install: z.boolean().meta({ description: 'opt into installing packages' }).default(false),
+    workspace: z
+        .boolean()
+        .meta({ description: 'ensure a clean git workspace, useful for CI, also implies --no-sync' })
+        .default(false),
+});
+/** @nodocs */
+export const task = {
+    summary: 'check that everything is ready to commit',
+    Args,
+    run: async ({ args, invoke_task, log, config }) => {
+        const { typecheck, test, gen, format, package_json, lint, build, force_build, sync, install, workspace, } = args;
+        // When checking the workspace, which was added for CI, never sync.
+        // Setup like installing packages and `sveltekit-sync` should be done in the CI setup.
+        if (!workspace) {
+            if (sync || install) {
+                if (!sync)
+                    log.warn('sync is false but install is true, so ignoring the sync option');
+                await invoke_task('sync', { install, gen: false }); // never generate because `gro gen --check` runs below
+            }
+        }
+        if (typecheck) {
+            await invoke_task('typecheck');
+        }
+        if (test) {
+            await invoke_task('test');
+        }
+        if (gen) {
+            await invoke_task('gen', { check: true });
+        }
+        if (package_json && config.map_package_json) {
+            const { changed } = await package_json_sync(config.map_package_json, log, false);
+            if (changed) {
+                throw new TaskError('package.json is out of date, run `gro sync` to update it');
+            }
+            else {
+                log.info('check passed for package.json');
+            }
+        }
+        if (format) {
+            await invoke_task('format', { check: true });
+        }
+        // Run the linter last to surface every other kind of problem first.
+        // It's not the ideal order when the linter would catch errors that cause failing tests,
+        // but it's better for most usage.
+        if (lint) {
+            await invoke_task('lint');
+        }
+        if (build) {
+            // Skip sync/gen/install since check handles those separately
+            await invoke_task('build', { sync: false, gen: false, install: false, force_build });
+        }
+        // Disallow TODO*.md files in the project root on CI.
+        if (process.env.CI === 'true') {
+            const root_files = await readdir('.');
+            const todo_files = root_files.filter((f) => f.startsWith('TODO') && f.endsWith('.md'));
+            if (todo_files.length > 0) {
+                throw new TaskError('Found disallowed TODO*.md files in project root: ' + todo_files.join(', '));
+            }
+        }
+        if (workspace) {
+            const error_message = await git_check_clean_workspace();
+            if (error_message) {
+                log.error(st('red', 'git status'));
+                await spawn('git', ['status']);
+                throw new TaskError('Failed check for git_check_clean_workspace:' +
+                    error_message +
+                    ' - do you need to run `gro sync` or commit some files?');
+            }
+        }
+    },
+};

package/dist/child_process_logging.d.ts

@@ -0,0 +1,10 @@
+import type { ChildProcess } from 'node:child_process';
+/**
+ * Maps child process output through a transform function.
+ */
+export declare const map_child_process_output: (child_process: ChildProcess, transform: (data: string) => string) => void;
+/**
+ * Configures process output handling with path replacements while preserving ANSI colors.
+ */
+export declare const configure_colored_output_with_path_replacement: (child_process: ChildProcess, replacement?: string, cwd?: string) => void;
+//# sourceMappingURL=child_process_logging.d.ts.map

package/dist/child_process_logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child_process_logging.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/child_process_logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AAGrD;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACpC,eAAe,YAAY,EAC3B,WAAW,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,KACjC,IAYF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,8CAA8C,GAC1D,eAAe,YAAY,EAC3B,cAAa,MAAY,EACzB,MAAK,MAAsB,KACzB,IAOF,CAAC"}

package/dist/child_process_logging.js

@@ -0,0 +1,26 @@
+import { strip_end } from '@fuzdev/fuz_util/string.js';
+/**
+ * Maps child process output through a transform function.
+ */
+export const map_child_process_output = (child_process, transform) => {
+    if (child_process.stdout) {
+        child_process.stdout.on('data', (data) => {
+            process.stdout.write(transform(data.toString()));
+        });
+    }
+    if (child_process.stderr) {
+        child_process.stderr.on('data', (data) => {
+            process.stderr.write(transform(data.toString()));
+        });
+    }
+};
+/**
+ * Configures process output handling with path replacements while preserving ANSI colors.
+ */
+export const configure_colored_output_with_path_replacement = (child_process, replacement = '.', cwd = process.cwd()) => {
+    // Escape special characters in the cwd for regexp safety
+    const cwd_escaped = strip_end(cwd, '/').replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const cwd_reg_exp = new RegExp(cwd_escaped, 'g');
+    // Use the generic mapper with a path replacement transform
+    map_child_process_output(child_process, (data) => data.replace(cwd_reg_exp, replacement));
+};

package/dist/clean.task.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { Task } from './task.ts';
+/** @nodocs */
+export declare const Args: z.ZodObject<{
+    build_dev: z.ZodDefault<z.ZodBoolean>;
+    build_dist: z.ZodDefault<z.ZodBoolean>;
+    sveltekit: z.ZodDefault<z.ZodBoolean>;
+    nodemodules: z.ZodDefault<z.ZodBoolean>;
+    git: z.ZodDefault<z.ZodBoolean>;
+    git_origin: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+/** @nodocs */
+export declare const task: Task<Args>;
+//# sourceMappingURL=clean.task.d.ts.map

package/dist/clean.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/clean.task.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAGpC,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;kBAgBf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAmB3B,CAAC"}

package/dist/clean.task.js

@@ -0,0 +1,40 @@
+import { spawn } from '@fuzdev/fuz_util/process.js';
+import { z } from 'zod';
+import { GitOrigin } from '@fuzdev/fuz_util/git.js';
+import { clean_fs } from "./clean_fs.js";
+/** @nodocs */
+export const Args = z.strictObject({
+    build_dev: z.boolean().meta({ description: 'delete the Gro build dev directory' }).default(false),
+    build_dist: z.boolean().meta({ description: 'delete the Gro build dist directory' }).default(false),
+    sveltekit: z
+        .boolean()
+        .meta({ description: 'delete the SvelteKit directory and Vite cache' })
+        .default(false),
+    nodemodules: z.boolean().meta({ description: 'delete the node_modules directory' }).default(false),
+    git: z
+        .boolean()
+        .meta({
+        description: 'run "git remote prune" to delete local branches referencing nonexistent remote branches',
+    })
+        .default(false),
+    git_origin: GitOrigin.describe('the origin to "git remote prune"').default('origin'),
+});
+/** @nodocs */
+export const task = {
+    summary: 'remove temporary dev and build files, and optionally prune git branches',
+    Args,
+    run: async ({ args }) => {
+        const { build_dev, build_dist, sveltekit, nodemodules, git, git_origin } = args;
+        await clean_fs({
+            build: !build_dev && !build_dist,
+            build_dev,
+            build_dist,
+            sveltekit,
+            nodemodules,
+        });
+        // lop off stale git branches
+        if (git) {
+            await spawn('git', ['remote', 'prune', git_origin]);
+        }
+    },
+};

package/dist/clean_fs.d.ts

@@ -0,0 +1,9 @@
+import type { RmOptions } from 'node:fs';
+export declare const clean_fs: ({ build, build_dev, build_dist, sveltekit, nodemodules, }: {
+    build?: boolean;
+    build_dev?: boolean;
+    build_dist?: boolean;
+    sveltekit?: boolean;
+    nodemodules?: boolean;
+}, rm_options?: RmOptions) => Promise<void>;
+//# sourceMappingURL=clean_fs.d.ts.map

package/dist/clean_fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean_fs.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/clean_fs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,SAAS,CAAC;AAYvC,eAAO,MAAM,QAAQ,GACpB,2DAMG;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB,EACD,aAAY,SAA0C,KACpD,OAAO,CAAC,IAAI,CAyBd,CAAC"}

package/dist/clean_fs.js

@@ -0,0 +1,28 @@
+import { readdir, rm } from 'node:fs/promises';
+import { paths } from "./paths.js";
+import { NODE_MODULES_DIRNAME, GRO_DIST_PREFIX, SVELTEKIT_DEV_DIRNAME, SVELTEKIT_BUILD_DIRNAME, SVELTEKIT_VITE_CACHE_PATH, SVELTEKIT_DIST_DIRNAME, } from "./constants.js";
+export const clean_fs = async ({ build = false, build_dev = false, build_dist = false, sveltekit = false, nodemodules = false, }, rm_options = { force: true, recursive: true }) => {
+    const promises = [];
+    if (build) {
+        promises.push(rm(paths.build, rm_options));
+    }
+    else if (build_dev) {
+        promises.push(rm(paths.build_dev, rm_options));
+    }
+    if (build || build_dist) {
+        const dir_paths = (await readdir('.')).filter((p) => p.startsWith(GRO_DIST_PREFIX));
+        for (const path of dir_paths) {
+            promises.push(rm(path, rm_options));
+        }
+    }
+    if (sveltekit) {
+        promises.push(rm(SVELTEKIT_DEV_DIRNAME, rm_options));
+        promises.push(rm(SVELTEKIT_BUILD_DIRNAME, rm_options));
+        promises.push(rm(SVELTEKIT_DIST_DIRNAME, rm_options));
+        promises.push(rm(SVELTEKIT_VITE_CACHE_PATH, rm_options));
+    }
+    if (nodemodules) {
+        promises.push(rm(NODE_MODULES_DIRNAME, rm_options));
+    }
+    await Promise.all(promises);
+};

package/dist/cli.d.ts

@@ -0,0 +1,34 @@
+import type { SpawnOptions } from 'node:child_process';
+import { type SpawnResult, type SpawnedProcess } from '@fuzdev/fuz_util/process.js';
+import { type URL } from 'node:url';
+import type { Logger } from '@fuzdev/fuz_util/log.js';
+import type { PathId } from '@fuzdev/fuz_util/path.js';
+export type Cli = {
+    kind: 'local';
+    name: string;
+    id: PathId;
+} | {
+    kind: 'global';
+    name: string;
+    id: PathId;
+};
+/**
+ * Searches the filesystem for the CLI `name`, first local to the cwd and then globally.
+ * @returns `null` if not found locally or globally
+ */
+export declare const find_cli: (name: string, cwd?: string | URL, options?: SpawnOptions) => Promise<Cli | null>;
+/**
+ * Spawns a CLI if available using fuz_util's `spawn`.
+ * If a string is provided for `name_or_cli`, it checks first local to the cwd and then globally.
+ * @returns `undefined` if no CLI is found, or the spawn result
+ */
+export declare const spawn_cli: (name_or_cli: string | Cli, args?: Array<string>, log?: Logger, options?: SpawnOptions) => Promise<SpawnResult | undefined>;
+/**
+ * Spawns a CLI if available using fuz_util's `spawn_process`.
+ * If a string is provided for `name_or_cli`, it checks first local to the cwd and then globally.
+ * @returns `undefined` if no CLI is found, or the spawn result
+ */
+export declare const spawn_cli_process: (name_or_cli: string | Cli, args?: Array<string>, log?: Logger, options?: SpawnOptions) => Promise<SpawnedProcess | undefined>;
+export declare const resolve_cli: (name_or_cli: string | Cli, args: Array<string> | undefined, cwd: string | URL | undefined, log?: Logger, options?: SpawnOptions) => Promise<Cli | undefined>;
+export declare const to_cli_name: (cli: string | Cli) => string;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAIN,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAgB,KAAK,GAAG,EAAC,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAOrD,MAAM,MAAM,GAAG,GACZ;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,GACzC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAC,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,QAAQ,GACpB,MAAM,MAAM,EACZ,MAAK,MAAM,GAAG,GAAmB,EACjC,UAAU,YAAY,KACpB,OAAO,CAAC,GAAG,GAAG,IAAI,CAUpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACrB,aAAa,MAAM,GAAG,GAAG,EACzB,OAAM,KAAK,CAAC,MAAM,CAAM,EACxB,MAAM,MAAM,EACZ,UAAU,YAAY,KACpB,OAAO,CAAC,WAAW,GAAG,SAAS,CAIjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAC7B,aAAa,MAAM,GAAG,GAAG,EACzB,OAAM,KAAK,CAAC,MAAM,CAAM,EACxB,MAAM,MAAM,EACZ,UAAU,YAAY,KACpB,OAAO,CAAC,cAAc,GAAG,SAAS,CAIpC,CAAC;AAEF,eAAO,MAAM,WAAW,GACvB,aAAa,MAAM,GAAG,GAAG,EACzB,MAAM,KAAK,CAAC,MAAM,CAAC,YAAK,EACxB,KAAK,MAAM,GAAG,GAAG,GAAG,SAAS,EAC7B,MAAM,MAAM,EACZ,UAAU,YAAY,KACpB,OAAO,CAAC,GAAG,GAAG,SAAS,CAazB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,GAAG,GAAG,KAAG,MACP,CAAC"}

package/dist/cli.js

@@ -0,0 +1,61 @@
+import { spawn, spawn_out, spawn_process, } from '@fuzdev/fuz_util/process.js';
+import { join } from 'node:path';
+import { fs_exists } from '@fuzdev/fuz_util/fs.js';
+import { fileURLToPath } from 'node:url';
+import { NODE_MODULES_DIRNAME } from "./constants.js";
+import { print_command_args } from "./args.js";
+/**
+ * Searches the filesystem for the CLI `name`, first local to the cwd and then globally.
+ * @returns `null` if not found locally or globally
+ */
+export const find_cli = async (name, cwd = process.cwd(), options) => {
+    const final_cwd = typeof cwd === 'string' ? cwd : fileURLToPath(cwd);
+    const local_id = join(final_cwd, NODE_MODULES_DIRNAME, `.bin/${name}`);
+    if (await fs_exists(local_id)) {
+        return { name, id: local_id, kind: 'local' };
+    }
+    const { stdout } = await spawn_out('which', [name], options);
+    const global_id = stdout?.trim();
+    if (!global_id)
+        return null;
+    return { name, id: global_id, kind: 'global' };
+};
+/**
+ * Spawns a CLI if available using fuz_util's `spawn`.
+ * If a string is provided for `name_or_cli`, it checks first local to the cwd and then globally.
+ * @returns `undefined` if no CLI is found, or the spawn result
+ */
+export const spawn_cli = async (name_or_cli, args = [], log, options) => {
+    const cli = await resolve_cli(name_or_cli, args, options?.cwd, log, options);
+    if (!cli)
+        return;
+    return spawn(cli.id, args, options);
+};
+/**
+ * Spawns a CLI if available using fuz_util's `spawn_process`.
+ * If a string is provided for `name_or_cli`, it checks first local to the cwd and then globally.
+ * @returns `undefined` if no CLI is found, or the spawn result
+ */
+export const spawn_cli_process = async (name_or_cli, args = [], log, options) => {
+    const cli = await resolve_cli(name_or_cli, args, options?.cwd, log, options);
+    if (!cli)
+        return;
+    return spawn_process(cli.id, args, options);
+};
+export const resolve_cli = async (name_or_cli, args = [], cwd, log, options) => {
+    let final_cli;
+    if (typeof name_or_cli === 'string') {
+        const found = await find_cli(name_or_cli, cwd, options);
+        if (!found)
+            return;
+        final_cli = found;
+    }
+    else {
+        final_cli = name_or_cli;
+    }
+    if (log) {
+        log.info(print_command_args([final_cli.name].concat(args)));
+    }
+    return final_cli;
+};
+export const to_cli_name = (cli) => typeof cli === 'string' ? cli : cli.name;

package/dist/commit.task.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { Task } from './task.ts';
+/** @nodocs */
+export declare const Args: z.ZodObject<{
+    _: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    origin: z.ZodDefault<z.ZodString>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+/** @nodocs */
+export declare const task: Task<Args>;
+//# sourceMappingURL=commit.task.d.ts.map

package/dist/commit.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/commit.task.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAGtB,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,WAAW,CAAC;AAEpC,cAAc;AACd,eAAO,MAAM,IAAI;;;kBAQf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAc3B,CAAC"}

package/dist/commit.task.js

@@ -0,0 +1,24 @@
+import { spawn } from '@fuzdev/fuz_util/process.js';
+import { z } from 'zod';
+import { GitOrigin, git_current_branch_name, git_push } from '@fuzdev/fuz_util/git.js';
+/** @nodocs */
+export const Args = z.strictObject({
+    _: z
+        .array(z.string())
+        .meta({
+        description: 'the git commit message, the same as git commit -m or --message',
+    })
+        .default([]),
+    origin: GitOrigin.describe('git origin to commit to').default('origin'),
+});
+/** @nodocs */
+export const task = {
+    summary: 'commit and push to a new branch',
+    Args,
+    run: async ({ args }) => {
+        const { _: [message], origin, } = args;
+        const branch = await git_current_branch_name();
+        await spawn('git', ['commit', '-a', '-m', message]);
+        await git_push(origin, branch, undefined, true);
+    },
+};

package/dist/constants.d.ts

@@ -0,0 +1,46 @@
+export declare const SOURCE_DIRNAME = "src";
+export declare const GRO_DIRNAME = ".gro";
+export declare const GRO_DIST_PREFIX = "dist_";
+export declare const SERVER_DIST_PATH = "dist_server";
+export declare const GRO_DEV_DIRNAME: string;
+/** @trailing_slash */
+export declare const SOURCE_DIR: string;
+/** @trailing_slash */
+export declare const GRO_DIR: string;
+/** @trailing_slash */
+export declare const GRO_DEV_DIR: string;
+export declare const GRO_CONFIG_FILENAME = "gro.config.ts";
+export declare const README_FILENAME = "README.md";
+export declare const SVELTE_CONFIG_FILENAME = "svelte.config.js";
+export declare const VITE_CONFIG_FILENAME = "vite.config.ts";
+export declare const NODE_MODULES_DIRNAME = "node_modules";
+export declare const PACKAGE_JSON_FILENAME = "package.json";
+export declare const LOCKFILE_FILENAME = "package-lock.json";
+export declare const SVELTEKIT_DEV_DIRNAME = ".svelte-kit";
+export declare const SVELTEKIT_BUILD_DIRNAME = "build";
+export declare const SVELTEKIT_DIST_DIRNAME = "dist";
+export declare const SVELTEKIT_VITE_CACHE_PATH: string;
+export declare const GITHUB_DIRNAME = ".github";
+export declare const GIT_DIRNAME = ".git";
+export declare const TSCONFIG_FILENAME = "tsconfig.json";
+export declare const TS_MATCHER: RegExp;
+export declare const JS_MATCHER: RegExp;
+export declare const JSON_MATCHER: RegExp;
+export declare const SVELTE_MATCHER: RegExp;
+export declare const SVELTE_RUNES_MATCHER: RegExp;
+export declare const CSS_MATCHER: RegExp;
+/** Extracts the script content from Svelte files. */
+export declare const SVELTE_SCRIPT_MATCHER: RegExp;
+export declare const SVELTEKIT_ENV_MATCHER: RegExp;
+export declare const SVELTEKIT_GLOBAL_SPECIFIER: RegExp;
+export declare const EVERYTHING_MATCHER: RegExp;
+export declare const JS_CLI_DEFAULT = "node";
+export declare const PM_CLI_DEFAULT = "npm";
+export declare const PRETTIER_CLI_DEFAULT = "prettier";
+export declare const SVELTEKIT_CLI = "svelte-kit";
+export declare const SVELTE_CHECK_CLI = "svelte-check";
+export declare const SVELTE_PACKAGE_CLI = "svelte-package";
+export declare const SVELTE_PACKAGE_DEP_NAME = "@sveltejs/package";
+export declare const VITE_CLI = "vite";
+export declare const VITEST_CLI = "vitest";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/constants.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,cAAc,QAAQ,CAAC;AACpC,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,gBAAgB,gBAAgB,CAAC;AAC9C,eAAO,MAAM,eAAe,QAAuB,CAAC;AACpD,sBAAsB;AACtB,eAAO,MAAM,UAAU,QAAuB,CAAC;AAC/C,sBAAsB;AACtB,eAAO,MAAM,OAAO,QAAoB,CAAC;AACzC,sBAAsB;AACtB,eAAO,MAAM,WAAW,QAAwB,CAAC;AACjD,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AACnD,eAAO,MAAM,eAAe,cAAc,CAAC;AAC3C,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AACzD,eAAO,MAAM,oBAAoB,mBAAmB,CAAC;AACrD,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AACnD,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AACpD,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,qBAAqB,gBAAgB,CAAC;AACnD,eAAO,MAAM,uBAAuB,UAAU,CAAC;AAC/C,eAAO,MAAM,sBAAsB,SAAS,CAAC;AAC7C,eAAO,MAAM,yBAAyB,QAAkC,CAAC;AACzE,eAAO,MAAM,cAAc,YAAY,CAAC;AACxC,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAEjD,eAAO,MAAM,UAAU,QAAoB,CAAC;AAC5C,eAAO,MAAM,UAAU,QAAoB,CAAC;AAC5C,eAAO,MAAM,YAAY,QAAY,CAAC;AACtC,eAAO,MAAM,cAAc,QAAc,CAAC;AAC1C,eAAO,MAAM,oBAAoB,QAAuB,CAAC;AACzD,eAAO,MAAM,WAAW,QAAW,CAAC;AACpC,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,QAAiD,CAAC;AACpF,eAAO,MAAM,qBAAqB,QAAgD,CAAC;AACnF,eAAO,MAAM,0BAA0B,QAAmB,CAAC;AAC3D,eAAO,MAAM,kBAAkB,QAAO,CAAC;AAEvC,eAAO,MAAM,cAAc,SAAS,CAAC;AACrC,eAAO,MAAM,cAAc,QAAQ,CAAC;AACpC,eAAO,MAAM,oBAAoB,aAAa,CAAC;AAC/C,eAAO,MAAM,aAAa,eAAe,CAAC;AAC1C,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAC/C,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AACnD,eAAO,MAAM,uBAAuB,sBAAsB,CAAC;AAC3D,eAAO,MAAM,QAAQ,SAAS,CAAC;AAC/B,eAAO,MAAM,UAAU,WAAW,CAAC"}

package/dist/constants.js

@@ -0,0 +1,52 @@
+/*
+
+This module is intended to have no dependencies to avoid over-imports in the CLI and loader.
+If any of these become customizable from SvelteKit or Gro's configs, move them to `./paths.ts`.
+
+*/
+// TODO the slashes here are kinda gross - do we want to maintain the convention to have the trailing slash in most usage?
+export const SOURCE_DIRNAME = 'src';
+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_FILENAME = 'gro.config.ts';
+export const README_FILENAME = 'README.md';
+export const SVELTE_CONFIG_FILENAME = 'svelte.config.js';
+export const VITE_CONFIG_FILENAME = 'vite.config.ts';
+export const NODE_MODULES_DIRNAME = 'node_modules';
+export const PACKAGE_JSON_FILENAME = 'package.json';
+export const LOCKFILE_FILENAME = 'package-lock.json';
+export const SVELTEKIT_DEV_DIRNAME = '.svelte-kit'; // TODO use Svelte config value `outDir`
+export const SVELTEKIT_BUILD_DIRNAME = 'build';
+export const SVELTEKIT_DIST_DIRNAME = 'dist';
+export const SVELTEKIT_VITE_CACHE_PATH = NODE_MODULES_DIRNAME + '/.vite';
+export const GITHUB_DIRNAME = '.github';
+export const GIT_DIRNAME = '.git';
+export const TSCONFIG_FILENAME = 'tsconfig.json';
+export const TS_MATCHER = /\.(ts|mts|cts)$/;
+export const JS_MATCHER = /\.(js|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
+export const CSS_MATCHER = /\.css$/;
+/** 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 SVELTEKIT_ENV_MATCHER = /^\$env\/(static|dynamic)\/(public|private)$/;
+export const SVELTEKIT_GLOBAL_SPECIFIER = /^\$(env|app)\//;
+export const EVERYTHING_MATCHER = /.*/;
+export const JS_CLI_DEFAULT = 'node';
+export const PM_CLI_DEFAULT = 'npm';
+export const PRETTIER_CLI_DEFAULT = 'prettier';
+export const SVELTEKIT_CLI = 'svelte-kit';
+export const SVELTE_CHECK_CLI = 'svelte-check';
+export const SVELTE_PACKAGE_CLI = 'svelte-package';
+export const SVELTE_PACKAGE_DEP_NAME = '@sveltejs/package';
+export const VITE_CLI = 'vite';
+export const VITEST_CLI = 'vitest';

package/dist/deploy.task.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import { type Task } from './task.ts';
+/** @nodocs */
+export declare const Args: z.ZodObject<{
+    source: z.ZodDefault<z.ZodString>;
+    target: z.ZodDefault<z.ZodString>;
+    origin: z.ZodDefault<z.ZodString>;
+    deploy_dir: z.ZodDefault<z.ZodString>;
+    build_dir: z.ZodDefault<z.ZodString>;
+    dry: z.ZodDefault<z.ZodBoolean>;
+    force: z.ZodDefault<z.ZodBoolean>;
+    dangerous: z.ZodDefault<z.ZodBoolean>;
+    reset: z.ZodDefault<z.ZodBoolean>;
+    build: z.ZodDefault<z.ZodBoolean>;
+    'no-build': z.ZodDefault<z.ZodBoolean>;
+    sync: z.ZodDefault<z.ZodBoolean>;
+    'no-sync': z.ZodDefault<z.ZodBoolean>;
+    gen: z.ZodDefault<z.ZodBoolean>;
+    'no-gen': z.ZodDefault<z.ZodBoolean>;
+    install: z.ZodDefault<z.ZodBoolean>;
+    'no-install': z.ZodDefault<z.ZodBoolean>;
+    force_build: z.ZodDefault<z.ZodBoolean>;
+    pull: z.ZodDefault<z.ZodBoolean>;
+    'no-pull': z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strict>;
+export type Args = z.infer<typeof Args>;
+/** @nodocs */
+export declare const task: Task<Args>;
+//# sourceMappingURL=deploy.task.d.ts.map

package/dist/deploy.task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/deploy.task.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAqBtB,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAiB/C,cAAc;AACd,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;kBA8Cf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CAkM3B,CAAC"}