@ryanatkn/gro 0.183.0 → 0.185.0

package/dist/disknode.d.ts

@@ -12,6 +12,11 @@ export interface Disknode {
     external: boolean;
     ctime: number | null;
     mtime: number | null;
+    /**
+     * SHA-256 hash of `contents`. `null` iff `contents` is `null`.
+     * Used for content-based change detection and caching.
+     */
+    content_hash: string | null;
     dependents: Map<PathId, Disknode>;
     dependencies: Map<PathId, Disknode>;
 }

package/dist/disknode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"disknode.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/disknode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAIrD,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACpC"}
+{"version":3,"file":"disknode.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/disknode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAIrD,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CACpC"}

package/dist/filer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filer.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/filer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAI1D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAC,UAAU,EAAE,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EACN,SAAS,EAET,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAI5C,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC5B,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,KAAK;;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAa;gBAetC,OAAO,GAAE,YAA2B;IAUhD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,SAAS,GAAI,IAAI,MAAM,KAAG,QAAQ,GAAG,SAAS,CAE5C;IAEF,aAAa,GAAI,IAAI,MAAM,KAAG,QAAQ,CAoBpC;IAEF,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI;IAU1E;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDrB,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAmBzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAyOtB;AAGD,eAAO,MAAM,iBAAiB,GAC7B,UAAU,QAAQ,EAClB,WAAW,CAAC,EAAE,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,EAC/C,SAAS,UAAU,EACnB,UAAS,GAAG,CAAC,MAAM,CAAa,EAChC,WAAU,GAAG,CAAC,MAAM,CAAa,EACjC,MAAM,MAAM,KACV,GAAG,CAAC,MAAM,CAuBZ,CAAC"}
+{"version":3,"file":"filer.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/filer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,2BAA2B,CAAC;AAI1D,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AACpD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAC,UAAU,EAAE,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAEjE,OAAO,EACN,SAAS,EAET,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,MAAM,gBAAgB,CAAC;AAOxB,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,eAAe,CAAC;AAK5C,MAAM,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;AAEhF,MAAM,WAAW,YAAY;IAC5B,SAAS,CAAC,EAAE,OAAO,SAAS,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AAED,qBAAa,KAAK;;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAa;gBAetC,OAAO,GAAE,YAA2B;IAUhD,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,SAAS,GAAI,IAAI,MAAM,KAAG,QAAQ,GAAG,SAAS,CAE5C;IAEF,aAAa,GAAI,IAAI,MAAM,KAAG,QAAQ,CAqBpC;IAEF,MAAM,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,IAAI;IAU1E;;;;OAIG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDrB,KAAK,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;IAmBzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CA8OtB;AAGD,eAAO,MAAM,iBAAiB,GAC7B,UAAU,QAAQ,EAClB,WAAW,CAAC,EAAE,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,EAC/C,SAAS,UAAU,EACnB,UAAS,GAAG,CAAC,MAAM,CAAa,EAChC,WAAU,GAAG,CAAC,MAAM,CAAa,EACjC,MAAM,MAAM,KACV,GAAG,CAAC,MAAM,CAuBZ,CAAC"}

package/dist/filer.js

@@ -11,6 +11,7 @@ import { resolve_specifier } from "./resolve_specifier.js";
 import { default_svelte_config } from "./svelte_config.js";
 import { map_sveltekit_aliases } from "./sveltekit_helpers.js";
 import { SVELTEKIT_GLOBAL_SPECIFIER } from "./constants.js";
+import { to_hash } from "./hash.js";
 const aliases = Object.entries(default_svelte_config.alias);
 export class Filer {
     root_dir;
@@ -51,6 +52,7 @@ export class Filer {
             external: this.#is_external(id), // TODO maybe filter externals by default? the user needs to configure the filer then
             ctime: null,
             mtime: null,
+            content_hash: null,
             dependents: new Map(),
             dependencies: new Map(),
         };
@@ -198,13 +200,16 @@ export class Filer {
                 throw error;
             }
         }
-        const old_mtime = file.mtime;
+        // Compute hash for new contents
+        const new_hash = new_contents !== null ? await to_hash(new_contents) : null;
         file.ctime = stats?.ctimeMs ?? null;
         file.mtime = stats?.mtimeMs ?? null;
-        if (file.mtime === old_mtime && file.contents === new_contents) {
+        // Use hash comparison for change detection (content-based, not mtime-based)
+        if (file.content_hash === new_hash) {
             return null;
         }
         file.contents = new_contents;
+        file.content_hash = new_hash;
         const dir = dirname(file.id);
         const dependencies_before = new Set(file.dependencies.keys());
         const dependencies_removed = new Set(dependencies_before);
@@ -260,6 +265,7 @@ export class Filer {
         if (!file)
             return null; // this is safe because the object would exist if any other file referenced it as a dependency or dependent
         file.contents = null; // clear contents in case it gets re-added later, we want the change to be detected
+        file.content_hash = null; // clear hash so re-add detects the change
         file.dependencies.clear();
         // keep the file in memory if other files still depend on it
         if (file.dependents.size === 0) {

package/dist/gen.js

@@ -1,7 +1,7 @@
 import { join, basename, dirname, isAbsolute } from 'node:path';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { styleText as st } from 'node:util';
-import { map_concurrent } from '@fuzdev/fuz_util/async.js';
+import { each_concurrent, map_concurrent } from '@fuzdev/fuz_util/async.js';
 import { fs_search } from '@fuzdev/fuz_util/fs.js';
 import { print_path } from "./paths.js";
 import { load_modules } from "./modules.js";
@@ -112,7 +112,7 @@ export const analyze_gen_result = async (file) => {
 };
 export const write_gen_results = async (gen_results, analyzed_gen_results, log) => {
     const files = gen_results.successes.flatMap((result) => result.files);
-    await map_concurrent(files, async (file) => {
+    await each_concurrent(files, async (file) => {
         const analyzed = analyzed_gen_results.find((r) => r.file.id === file.id);
         if (!analyzed)
             throw Error('Expected to find analyzed result: ' + file.id);

package/dist/gro_config.d.ts

@@ -1,5 +1,5 @@
 import type { PathFilter, PathId } from '@fuzdev/fuz_util/path.js';
-import type { CreateConfigPlugins } from './plugin.ts';
+import type { PluginsCreateConfig } from './plugin.ts';
 import type { PackageJsonMapper } from './package_json.ts';
 import type { ParsedSvelteConfig } from './svelte_config.ts';
 /**
@@ -16,7 +16,7 @@ export interface GroConfig extends RawGroConfig {
     /**
      * @see https://github.com/ryanatkn/gro/blob/main/src/docs/plugin.md
      */
-    plugins: CreateConfigPlugins;
+    plugins: PluginsCreateConfig;
     /**
      * Maps the project's `package.json` before writing it to the filesystem.
      * The `package_json` argument may be mutated, but the return value is what's used by the caller.
@@ -57,7 +57,7 @@ export interface GroConfig extends RawGroConfig {
  * @see https://github.com/ryanatkn/gro/blob/main/src/docs/config.md
  */
 export interface RawGroConfig {
-    plugins?: CreateConfigPlugins;
+    plugins?: PluginsCreateConfig;
     map_package_json?: PackageJsonMapper | null;
     task_root_dirs?: Array<string>;
     search_filters?: PathFilter | Array<PathFilter> | null;

package/dist/gro_config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gro_config.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gro_config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,UAAU,EAAE,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAcjE,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAG3D;;;GAGG;AACH,eAAO,MAAM,6BAA6B,qEACyB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC9C;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;;OAIG;IACH,gBAAgB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,EAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,MAAM,eAAe,GAAG,CAC7B,WAAW,EAAE,SAAS,EACtB,aAAa,CAAC,EAAE,kBAAkB,KAC9B,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE1C,eAAO,MAAM,uBAAuB,QAAO,SAazC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAUnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAA+C,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,YAAY,YAAY,KAAG,OAAO,CAAC,SAAS,CA+CjF,CAAC;AAEF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CAAC;CACjD;AAED,eAAO,MAAM,eAAe,GAAU,YAAgB,KAAG,OAAO,CAAC,SAAS,CAqBzE,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,CACxC,aAAa,EAAE,GAAG,EAClB,WAAW,EAAE,MAAM,KACf,OAAO,CAAC,aAAa,IAAI,eAS7B,CAAC"}
+{"version":3,"file":"gro_config.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/gro_config.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAC,UAAU,EAAE,MAAM,EAAC,MAAM,0BAA0B,CAAC;AAcjE,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,aAAa,CAAC;AACrD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAC,kBAAkB,EAAC,MAAM,oBAAoB,CAAC;AAG3D;;;GAGG;AACH,eAAO,MAAM,6BAA6B,qEACyB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC9C;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;;;OAIG;IACH,gBAAgB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC3C;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9B;;;OAGG;IACH,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC;;;;;OAKG;IACH,uBAAuB,EAAE,MAAM,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC5C,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,EAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;CACtE;AAED,MAAM,MAAM,eAAe,GAAG,CAC7B,WAAW,EAAE,SAAS,EACtB,aAAa,CAAC,EAAE,kBAAkB,KAC9B,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;AAE1C,eAAO,MAAM,uBAAuB,QAAO,SAazC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,QAUnC,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAA+C,CAAC;AAErF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAU,YAAY,YAAY,KAAG,OAAO,CAAC,SAAS,CA6CjF,CAAC;AAEF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,eAAe,CAAC;CACjD;AAED,eAAO,MAAM,eAAe,GAAU,YAAgB,KAAG,OAAO,CAAC,SAAS,CAqBzE,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,CACxC,aAAa,EAAE,GAAG,EAClB,WAAW,EAAE,MAAM,KACf,OAAO,CAAC,aAAa,IAAI,eAS7B,CAAC"}

package/dist/gro_config.js

@@ -67,7 +67,7 @@ export const cook_gro_config = async (raw_config) => {
         // Resolve if it's a function
         const resolved = typeof build_cache_config === 'function' ? await build_cache_config() : build_cache_config;
         // Hash the JSON representation with deterministic key ordering
-        build_cache_config_hash = await to_hash(new TextEncoder().encode(json_stringify_deterministic(resolved)));
+        build_cache_config_hash = await to_hash(json_stringify_deterministic(resolved));
     }
     // Delete the raw value to ensure it doesn't persist in memory
     delete raw_config.build_cache_config;

package/dist/hash.d.ts

@@ -1,5 +1,11 @@
 /**
+ * Computes a cryptographic hash of the given data.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded internally.
+ * @param algorithm - Hash algorithm to use. Defaults to SHA-256.
+ * @returns Hexadecimal hash string.
+ *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto
  */
-export declare const to_hash: (data: BufferSource, algorithm?: "SHA-1" | "SHA-256" | "SHA-384" | "SHA-512") => Promise<string>;
+export declare const to_hash: (data: BufferSource | string, algorithm?: "SHA-1" | "SHA-256" | "SHA-384" | "SHA-512") => Promise<string>;
 //# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hash.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,OAAO,GACnB,MAAM,YAAY,EAClB,YAAW,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAqB,KAChE,OAAO,CAAC,MAAM,CAQhB,CAAC"}
+{"version":3,"file":"hash.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/hash.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GACnB,MAAM,YAAY,GAAG,MAAM,EAC3B,YAAW,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAqB,KAChE,OAAO,CAAC,MAAM,CAShB,CAAC"}

package/dist/hash.js

@@ -1,9 +1,17 @@
 const { subtle } = globalThis.crypto;
+const encoder = new TextEncoder();
 /**
+ * Computes a cryptographic hash of the given data.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded internally.
+ * @param algorithm - Hash algorithm to use. Defaults to SHA-256.
+ * @returns Hexadecimal hash string.
+ *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto
  */
 export const to_hash = async (data, algorithm = 'SHA-256') => {
-    const digested = await subtle.digest(algorithm, data);
+    const buffer = typeof data === 'string' ? encoder.encode(data) : data;
+    const digested = await subtle.digest(algorithm, buffer);
     const bytes = Array.from(new Uint8Array(digested));
     let hex = '';
     for (const h of bytes) {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 /** @nodocs */
 export type { GroConfig, CreateGroConfig, RawGroConfig } from './gro_config.ts';
 /** @nodocs */
-export { type Plugin, replace_plugin } from './plugin.ts';
+export { type Plugin, plugin_replace } from './plugin.ts';
 /** @nodocs */
 export type { Gen, GenContext } from './gen.ts';
 /** @nodocs */

package/dist/index.js

@@ -1,4 +1,4 @@
 /** @nodocs */
-export { replace_plugin } from "./plugin.js";
+export { plugin_replace } from "./plugin.js";
 /** @nodocs */
 export { TaskError } from "./task.js";

package/dist/package_json.d.ts

@@ -4,7 +4,6 @@ export type PackageJsonMapper = (package_json: PackageJson) => PackageJson | nul
 export declare const PACKAGE_JSON_EMPTY: PackageJson;
 export declare const package_json_load: (dir?: string, cache?: Record<string, PackageJson>, parse?: boolean, // TODO pass `false` here in more places, especially anything perf-sensitive like work on startup
 log?: Logger) => Promise<PackageJson>;
-export declare const load_package_json: (dir?: string, cache?: Record<string, PackageJson>, parse?: boolean, log?: Logger) => Promise<PackageJson>;
 export declare const package_json_sync: (map_package_json: PackageJsonMapper, log: Logger, write?: boolean, dir?: string, exports_dir?: string) => Promise<{
     package_json: PackageJson | null;
     changed: boolean;

package/dist/package_json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"package_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_json.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAC,WAAW,EAAE,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AAgBjF,MAAM,MAAM,iBAAiB,GAAG,CAC/B,YAAY,EAAE,WAAW,KACrB,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AAEtD,eAAO,MAAM,kBAAkB,EAAE,WAAqC,CAAC;AAEvE,eAAO,MAAM,iBAAiB,GAC7B,YAA+C,EAC/C,QAAQ,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,eAAY,EAAE,iGAAiG;AAC/G,MAAM,MAAM,KACV,OAAO,CAAC,WAAW,CAkBrB,CAAC;AAGF,eAAO,MAAM,iBAAiB,yBAxBrB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,yBAE7B,MAAM,KACV,OAAO,CAAC,WAAW,CAqB4B,CAAC;AAEnD,eAAO,MAAM,iBAAiB,GAC7B,kBAAkB,iBAAiB,EACnC,KAAK,MAAM,EACX,eAAY,EACZ,YAAgB,EAChB,oBAAuB,KACrB,OAAO,CAAC;IAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC,CA0B9D,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAAO,OAAO,CAAC,WAAW,CAC9B,CAAC;AAMnC,eAAO,MAAM,kBAAkB,GAAI,yBAAyB,MAAM,KAAG,OAAO,CAAC,IAAI,CACL,CAAC;AAE7E,eAAO,MAAM,sBAAsB,GAAI,cAAc,WAAW,KAAG,MACW,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC/B,QAAQ,CAAC,YAAY,EAAE,WAAW,KAAK,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,EACvF,YAAgB,EAChB,eAAY,KACV,OAAO,CAAC;IAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC,CAa9D,CAAC;AAIF,eAAO,MAAM,uBAAuB,GAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAG,kBAmD9D,CAAC;AAIF,eAAO,MAAM,2BAA2B,GACvC,cAAc,WAAW,KACvB;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GAAG,SAgBlC,CAAC;AA8BF,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,EAAE,cAAc,WAAW,KAAG,OAG9C,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iCAAiC,GAC7C,cAAc,WAAW,KACvB,KAAK,CAAC,cAAc,CAetB,CAAC"}
+{"version":3,"file":"package_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/package_json.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAEpD,OAAO,EAAC,WAAW,EAAE,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AAgBjF,MAAM,MAAM,iBAAiB,GAAG,CAC/B,YAAY,EAAE,WAAW,KACrB,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;AAEtD,eAAO,MAAM,kBAAkB,EAAE,WAAqC,CAAC;AAEvE,eAAO,MAAM,iBAAiB,GAC7B,YAA+C,EAC/C,QAAQ,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACnC,eAAY,EAAE,iGAAiG;AAC/G,MAAM,MAAM,KACV,OAAO,CAAC,WAAW,CAkBrB,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC7B,kBAAkB,iBAAiB,EACnC,KAAK,MAAM,EACX,eAAY,EACZ,YAAgB,EAChB,oBAAuB,KACrB,OAAO,CAAC;IAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC,CA0B9D,CAAC;AAEF,eAAO,MAAM,yBAAyB,QAAO,OAAO,CAAC,WAAW,CAC9B,CAAC;AAMnC,eAAO,MAAM,kBAAkB,GAAI,yBAAyB,MAAM,KAAG,OAAO,CAAC,IAAI,CACL,CAAC;AAE7E,eAAO,MAAM,sBAAsB,GAAI,cAAc,WAAW,KAAG,MACW,CAAC;AAE/E;;GAEG;AACH,eAAO,MAAM,mBAAmB,GAC/B,QAAQ,CAAC,YAAY,EAAE,WAAW,KAAK,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,EACvF,YAAgB,EAChB,eAAY,KACV,OAAO,CAAC;IAAC,YAAY,EAAE,WAAW,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAC,CAa9D,CAAC;AAIF,eAAO,MAAM,uBAAuB,GAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAG,kBAmD9D,CAAC;AAIF,eAAO,MAAM,2BAA2B,GACvC,cAAc,WAAW,KACvB;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GAAG,SAgBlC,CAAC;AA8BF,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,EAAE,cAAc,WAAW,KAAG,OAG9C,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,iCAAiC,GAC7C,cAAc,WAAW,KACvB,KAAK,CAAC,cAAc,CAetB,CAAC"}

package/dist/package_json.js

@@ -31,8 +31,6 @@ log) => {
     }
     return package_json;
 };
-// TODO remove
-export const load_package_json = package_json_load;
 export const package_json_sync = async (map_package_json, log, write = true, dir = paths.root, exports_dir = paths.lib) => {
     const exported_files = await fs_search(exports_dir);
     const exported_paths = exported_files.map((f) => f.path);

package/dist/plugin.d.ts

@@ -9,7 +9,7 @@ export interface Plugin<TPluginContext extends PluginContext = PluginContext> {
     adapt?: (ctx: TPluginContext) => void | Promise<void>;
     teardown?: (ctx: TPluginContext) => void | Promise<void>;
 }
-export type CreateConfigPlugins<TPluginContext extends PluginContext = PluginContext> = (ctx: TPluginContext) => Array<Plugin<TPluginContext>> | Promise<Array<Plugin<TPluginContext>>>;
+export type PluginsCreateConfig<TPluginContext extends PluginContext = PluginContext> = (ctx: TPluginContext) => Array<Plugin<TPluginContext>> | Promise<Array<Plugin<TPluginContext>>>;
 export interface PluginContext<TArgs = object> extends TaskContext<TArgs> {
     dev: boolean;
     watch: boolean;
@@ -27,10 +27,10 @@ export declare class Plugins<TPluginContext extends PluginContext> {
 /**
  * Replaces a plugin by name in `plugins` without mutating the param.
  * Throws if the plugin name cannot be found.
- * @param plugins - accepts the same types as the return value of `CreateConfigPlugins`
+ * @param plugins - accepts the same types as the return value of `PluginsCreateConfig`
  * @param new_plugin
  * @param name - @default new_plugin.name
  * @returns `plugins` with `new_plugin` at the index of the plugin with `name`
  */
-export declare const replace_plugin: (plugins: Array<Plugin>, new_plugin: Plugin, name?: string) => Array<Plugin>;
+export declare const plugin_replace: (plugins: Array<Plugin>, new_plugin: Plugin, name?: string) => Array<Plugin>;
 //# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.js

@@ -63,12 +63,12 @@ export class Plugins {
 /**
  * Replaces a plugin by name in `plugins` without mutating the param.
  * Throws if the plugin name cannot be found.
- * @param plugins - accepts the same types as the return value of `CreateConfigPlugins`
+ * @param plugins - accepts the same types as the return value of `PluginsCreateConfig`
  * @param new_plugin
  * @param name - @default new_plugin.name
  * @returns `plugins` with `new_plugin` at the index of the plugin with `name`
  */
-export const replace_plugin = (plugins, new_plugin, name = new_plugin.name) => {
+export const plugin_replace = (plugins, new_plugin, name = new_plugin.name) => {
     const index = plugins.findIndex((p) => p.name === name);
     if (index === -1)
         throw Error('Failed to find plugin to replace: ' + name);

package/dist/run.task.d.ts

@@ -3,6 +3,8 @@ import { type Task } from './task.ts';
 /**
  * Runs a TypeScript file with Gro's loader, forwarding all args to the script.
  * Useful for scripts that need SvelteKit shims ($lib, $env, etc).
+ *
+ * @module
  */
 /** @nodocs */
 export declare const Args: z.ZodObject<{

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

@@ -1 +1 @@
-{"version":3,"file":"run.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/run.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAI/C;;;GAGG;AAEH,cAAc;AACd,eAAO,MAAM,IAAI;;8JAWf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA+B3B,CAAC"}
+{"version":3,"file":"run.task.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/run.task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAItB,OAAO,EAAY,KAAK,IAAI,EAAC,MAAM,WAAW,CAAC;AAI/C;;;;;GAKG;AAEH,cAAc;AACd,eAAO,MAAM,IAAI;;8JAWf,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;AAExC,cAAc;AACd,eAAO,MAAM,IAAI,EAAE,IAAI,CAAC,IAAI,CA+B3B,CAAC"}

package/dist/run.task.js

@@ -7,6 +7,8 @@ import { serialize_args, to_implicit_forwarded_args } from "./args.js";
 /**
  * Runs a TypeScript file with Gro's loader, forwarding all args to the script.
  * Useful for scripts that need SvelteKit shims ($lib, $env, etc).
+ *
+ * @module
  */
 /** @nodocs */
 export const Args = z

package/dist/source_json.d.ts

@@ -3,5 +3,5 @@ import { SourceJson, type ModuleJson } from '@fuzdev/fuz_util/source_json.js';
 import type { Logger } from '@fuzdev/fuz_util/log.js';
 export type SourceJsonMapper = (source_json: SourceJson) => SourceJson | null | Promise<SourceJson | null>;
 export declare const source_json_create: (package_json: PackageJson, lib_path?: string, log?: Logger) => Promise<SourceJson>;
-export declare const source_modules_create: (exports: PackageJsonExports | undefined, lib_path?: string, log?: Logger) => Promise<Array<ModuleJson> | undefined>;
+export declare const source_json_modules_create: (exports: PackageJsonExports | undefined, lib_path?: string, log?: Logger) => Promise<Array<ModuleJson> | undefined>;
 //# sourceMappingURL=source_json.d.ts.map

package/dist/source_json.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/source_json.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,WAAW,EAAE,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAC,UAAU,EAAE,KAAK,UAAU,EAAuB,MAAM,iCAAiC,CAAC;AAClG,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAMpD,MAAM,MAAM,gBAAgB,GAAG,CAC9B,WAAW,EAAE,UAAU,KACnB,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAC9B,cAAc,WAAW,EACzB,WAAW,MAAM,EACjB,MAAM,MAAM,KACV,OAAO,CAAC,UAAU,CAKlB,CAAC;AAEJ,eAAO,MAAM,qBAAqB,GACjC,SAAS,kBAAkB,GAAG,SAAS,EACvC,iBAAoB,EACpB,MAAM,MAAM,KACV,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,CAgDvC,CAAC"}
+{"version":3,"file":"source_json.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/source_json.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,WAAW,EAAE,kBAAkB,EAAC,MAAM,kCAAkC,CAAC;AACtF,OAAO,EAAC,UAAU,EAAE,KAAK,UAAU,EAAuB,MAAM,iCAAiC,CAAC;AAClG,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,yBAAyB,CAAC;AAMpD,MAAM,MAAM,gBAAgB,GAAG,CAC9B,WAAW,EAAE,UAAU,KACnB,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;AAEpD,eAAO,MAAM,kBAAkB,GAC9B,cAAc,WAAW,EACzB,WAAW,MAAM,EACjB,MAAM,MAAM,KACV,OAAO,CAAC,UAAU,CAKlB,CAAC;AAEJ,eAAO,MAAM,0BAA0B,GACtC,SAAS,kBAAkB,GAAG,SAAS,EACvC,iBAAoB,EACpB,MAAM,MAAM,KACV,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,CAgDvC,CAAC"}

package/dist/source_json.js

@@ -9,9 +9,9 @@ import { TS_MATCHER, SVELTE_MATCHER, JSON_MATCHER, CSS_MATCHER } from "./constan
 export const source_json_create = async (package_json, lib_path, log) => SourceJson.parse({
     name: package_json.name,
     version: package_json.version,
-    modules: await source_modules_create(package_json.exports, lib_path, log),
+    modules: await source_json_modules_create(package_json.exports, lib_path, log),
 });
-export const source_modules_create = async (exports, lib_path = paths.lib, log) => {
+export const source_json_modules_create = async (exports, lib_path = paths.lib, log) => {
     if (!exports)
         return;
     const file_paths = await collect_file_paths(exports, lib_path);

package/dist/sveltekit_shim_app_environment.d.ts

@@ -3,6 +3,8 @@
  * but exists here for the sake of the Node loader.
  * There may be a cleaner workaround but I couldn't find it.
  * @see https://github.com/nodejs/loaders for details about the forthcoming virtual file support
+ *
+ * @module
  */
 export declare const browser = false;
 export declare const building = false;

package/dist/sveltekit_shim_app_environment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sveltekit_shim_app_environment.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/sveltekit_shim_app_environment.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,GAAG,OAAO,CAAC;AACxB,eAAO,MAAM,OAAO,SAAS,CAAC"}
+{"version":3,"file":"sveltekit_shim_app_environment.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/sveltekit_shim_app_environment.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,eAAO,MAAM,OAAO,QAAQ,CAAC;AAC7B,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAC9B,eAAO,MAAM,GAAG,OAAO,CAAC;AACxB,eAAO,MAAM,OAAO,SAAS,CAAC"}

package/dist/sveltekit_shim_app_environment.js

@@ -5,6 +5,8 @@
  * but exists here for the sake of the Node loader.
  * There may be a cleaner workaround but I couldn't find it.
  * @see https://github.com/nodejs/loaders for details about the forthcoming virtual file support
+ *
+ * @module
  */
 export const browser = false;
 export const building = false;

package/dist/sveltekit_shim_app_paths.d.ts

@@ -3,6 +3,8 @@
  * but exists here for the sake of the Node loader.
  * There may be a cleaner workaround but I couldn't find it.
  * @see https://github.com/nodejs/loaders for details about the forthcoming virtual file support
+ *
+ * @module
  */
 import type { resolve as base_resolve, asset as base_asset, resolveRoute as base_resolveRoute } from '$app/paths';
 export declare const assets = "";

package/dist/sveltekit_shim_app_paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sveltekit_shim_app_paths.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/sveltekit_shim_app_paths.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AAEH,OAAO,KAAK,EACX,OAAO,IAAI,YAAY,EACvB,KAAK,IAAI,UAAU,EACnB,YAAY,IAAI,iBAAiB,EACjC,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,MAAM,KAAK,CAAC;AACzB,kBAAkB;AAClB,eAAO,MAAM,IAAI,KAAK,CAAC;AACvB,eAAO,MAAM,OAAO,EAAE,OAAO,YAAmE,CAAC;AACjG,kBAAkB;AAClB,eAAO,MAAM,YAAY,EAAE,OAAO,iBAAwB,CAAC;AAC3D,eAAO,MAAM,KAAK,EAAE,OAAO,UAAuD,CAAC"}
+{"version":3,"file":"sveltekit_shim_app_paths.d.ts","sourceRoot":"../src/lib/","sources":["../src/lib/sveltekit_shim_app_paths.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,OAAO,IAAI,YAAY,EACvB,KAAK,IAAI,UAAU,EACnB,YAAY,IAAI,iBAAiB,EACjC,MAAM,YAAY,CAAC;AAGpB,eAAO,MAAM,MAAM,KAAK,CAAC;AACzB,kBAAkB;AAClB,eAAO,MAAM,IAAI,KAAK,CAAC;AACvB,eAAO,MAAM,OAAO,EAAE,OAAO,YAAmE,CAAC;AACjG,kBAAkB;AAClB,eAAO,MAAM,YAAY,EAAE,OAAO,iBAAwB,CAAC;AAC3D,eAAO,MAAM,KAAK,EAAE,OAAO,UAAuD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ryanatkn/gro",
-  "version": "0.183.0",
+  "version": "0.185.0",
   "description": "task runner and toolkit extending SvelteKit",
   "motto": "generate, run, optimize",
   "glyph": "🌰",
@@ -53,8 +53,8 @@
     "esm-env": "^1.2.2",
     "mri": "^1.2.0",
     "oxc-parser": "^0.99.0",
-    "prettier": "^3.6.2",
-    "prettier-plugin-svelte": "^3.4.0",
+    "prettier": "^3.7.4",
+    "prettier-plugin-svelte": "^3.4.1",
     "ts-blank-space": "^0.6.2",
     "tslib": "^2.8.1",
     "zod": "^4.1.13"
@@ -83,8 +83,8 @@
     "@changesets/types": "^6.1.0",
     "@fuzdev/fuz_code": "^0.38.0",
     "@fuzdev/fuz_css": "^0.42.1",
-    "@fuzdev/fuz_ui": "^0.173.0",
-    "@fuzdev/fuz_util": "^0.45.0",
+    "@fuzdev/fuz_ui": "^0.177.0",
+    "@fuzdev/fuz_util": "^0.45.3",
     "@ryanatkn/eslint-config": "^0.9.0",
     "@sveltejs/adapter-static": "^3.0.10",
     "@sveltejs/kit": "^2.49.1",

package/src/lib/disknode.ts

@@ -16,6 +16,11 @@ export interface Disknode {
 	external: boolean;
 	ctime: number | null;
 	mtime: number | null;
+	/**
+	 * SHA-256 hash of `contents`. `null` iff `contents` is `null`.
+	 * Used for content-based change detection and caching.
+	 */
+	content_hash: string | null;
 	dependents: Map<PathId, Disknode>;
 	dependencies: Map<PathId, Disknode>;
 }

package/src/lib/filer.ts

@@ -23,6 +23,7 @@ import {default_svelte_config} from './svelte_config.ts';
 import {map_sveltekit_aliases} from './sveltekit_helpers.ts';
 import {SVELTEKIT_GLOBAL_SPECIFIER} from './constants.ts';
 import type {Disknode} from './disknode.ts';
+import {to_hash} from './hash.ts';
 
 const aliases = Object.entries(default_svelte_config.alias);
 
@@ -81,6 +82,7 @@ export class Filer {
 			external: this.#is_external(id), // TODO maybe filter externals by default? the user needs to configure the filer then
 			ctime: null,
 			mtime: null,
+			content_hash: null,
 			dependents: new Map(),
 			dependencies: new Map(),
 		};
@@ -242,15 +244,19 @@ export class Filer {
 			}
 		}
 
-		const old_mtime = file.mtime;
+		// Compute hash for new contents
+		const new_hash = new_contents !== null ? await to_hash(new_contents) : null;
+
 		file.ctime = stats?.ctimeMs ?? null;
 		file.mtime = stats?.mtimeMs ?? null;
 
-		if (file.mtime === old_mtime && file.contents === new_contents) {
+		// Use hash comparison for change detection (content-based, not mtime-based)
+		if (file.content_hash === new_hash) {
 			return null;
 		}
 
 		file.contents = new_contents;
+		file.content_hash = new_hash;
 
 		const dir = dirname(file.id);
 
@@ -308,6 +314,7 @@ export class Filer {
 		if (!file) return null; // this is safe because the object would exist if any other file referenced it as a dependency or dependent
 
 		file.contents = null; // clear contents in case it gets re-added later, we want the change to be detected
+		file.content_hash = null; // clear hash so re-add detects the change
 
 		file.dependencies.clear();
 

package/src/lib/gen.ts

@@ -5,7 +5,7 @@ import type {Result} from '@fuzdev/fuz_util/result.js';
 import type {Timings} from '@fuzdev/fuz_util/timings.js';
 import {styleText as st} from 'node:util';
 import type {PathId} from '@fuzdev/fuz_util/path.js';
-import {map_concurrent} from '@fuzdev/fuz_util/async.js';
+import {each_concurrent, map_concurrent} from '@fuzdev/fuz_util/async.js';
 import {fs_search} from '@fuzdev/fuz_util/fs.js';
 
 import {print_path} from './paths.ts';
@@ -246,7 +246,7 @@ export const write_gen_results = async (
 	log: Logger,
 ): Promise<void> => {
 	const files = gen_results.successes.flatMap((result) => result.files);
-	await map_concurrent(
+	await each_concurrent(
 		files,
 		async (file) => {
 			const analyzed = analyzed_gen_results.find((r) => r.file.id === file.id);

package/src/lib/gro_config.ts

@@ -15,7 +15,7 @@ import {
 	SVELTEKIT_DIST_DIRNAME,
 } from './constants.ts';
 import create_default_config from './gro.config.default.ts';
-import type {CreateConfigPlugins} from './plugin.ts';
+import type {PluginsCreateConfig} from './plugin.ts';
 import type {PackageJsonMapper} from './package_json.ts';
 import type {ParsedSvelteConfig} from './svelte_config.ts';
 import {to_hash} from './hash.ts';
@@ -36,7 +36,7 @@ export interface GroConfig extends RawGroConfig {
 	/**
 	 * @see https://github.com/ryanatkn/gro/blob/main/src/docs/plugin.md
 	 */
-	plugins: CreateConfigPlugins;
+	plugins: PluginsCreateConfig;
 	/**
 	 * Maps the project's `package.json` before writing it to the filesystem.
 	 * The `package_json` argument may be mutated, but the return value is what's used by the caller.
@@ -78,7 +78,7 @@ export interface GroConfig extends RawGroConfig {
  * @see https://github.com/ryanatkn/gro/blob/main/src/docs/config.md
  */
 export interface RawGroConfig {
-	plugins?: CreateConfigPlugins;
+	plugins?: PluginsCreateConfig;
 	map_package_json?: PackageJsonMapper | null;
 	task_root_dirs?: Array<string>;
 	search_filters?: PathFilter | Array<PathFilter> | null;
@@ -175,9 +175,7 @@ export const cook_gro_config = async (raw_config: RawGroConfig): Promise<GroConf
 			typeof build_cache_config === 'function' ? await build_cache_config() : build_cache_config;
 
 		// Hash the JSON representation with deterministic key ordering
-		build_cache_config_hash = await to_hash(
-			new TextEncoder().encode(json_stringify_deterministic(resolved)),
-		);
+		build_cache_config_hash = await to_hash(json_stringify_deterministic(resolved));
 	}
 
 	// Delete the raw value to ensure it doesn't persist in memory

package/src/lib/hash.ts

@@ -1,13 +1,22 @@
 const {subtle} = globalThis.crypto;
 
+const encoder = new TextEncoder();
+
 /**
+ * Computes a cryptographic hash of the given data.
+ *
+ * @param data - String or binary data to hash. Strings are UTF-8 encoded internally.
+ * @param algorithm - Hash algorithm to use. Defaults to SHA-256.
+ * @returns Hexadecimal hash string.
+ *
  * @see https://developer.mozilla.org/en-US/docs/Web/API/SubtleCrypto
  */
 export const to_hash = async (
-	data: BufferSource,
+	data: BufferSource | string,
 	algorithm: 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512' = 'SHA-256',
 ): Promise<string> => {
-	const digested = await subtle.digest(algorithm, data);
+	const buffer = typeof data === 'string' ? encoder.encode(data) : data;
+	const digested = await subtle.digest(algorithm, buffer);
 	const bytes = Array.from(new Uint8Array(digested));
 	let hex = '';
 	for (const h of bytes) {

package/src/lib/index.ts

@@ -1,7 +1,7 @@
 /** @nodocs */
 export type {GroConfig, CreateGroConfig, RawGroConfig} from './gro_config.ts';
 /** @nodocs */
-export {type Plugin, replace_plugin} from './plugin.ts';
+export {type Plugin, plugin_replace} from './plugin.ts';
 /** @nodocs */
 export type {Gen, GenContext} from './gen.ts';
 /** @nodocs */

package/src/lib/package_json.ts

@@ -51,9 +51,6 @@ export const package_json_load = async (
 	return package_json;
 };
 
-// TODO remove
-export const load_package_json = package_json_load;
-
 export const package_json_sync = async (
 	map_package_json: PackageJsonMapper,
 	log: Logger,

package/src/lib/plugin.ts

@@ -11,7 +11,7 @@ export interface Plugin<TPluginContext extends PluginContext = PluginContext> {
 	teardown?: (ctx: TPluginContext) => void | Promise<void>;
 }
 
-export type CreateConfigPlugins<TPluginContext extends PluginContext = PluginContext> = (
+export type PluginsCreateConfig<TPluginContext extends PluginContext = PluginContext> = (
 	ctx: TPluginContext,
 ) => Array<Plugin<TPluginContext>> | Promise<Array<Plugin<TPluginContext>>>;
 
@@ -88,12 +88,12 @@ export class Plugins<TPluginContext extends PluginContext> {
 /**
  * Replaces a plugin by name in `plugins` without mutating the param.
  * Throws if the plugin name cannot be found.
- * @param plugins - accepts the same types as the return value of `CreateConfigPlugins`
+ * @param plugins - accepts the same types as the return value of `PluginsCreateConfig`
  * @param new_plugin
  * @param name - @default new_plugin.name
  * @returns `plugins` with `new_plugin` at the index of the plugin with `name`
  */
-export const replace_plugin = (
+export const plugin_replace = (
 	plugins: Array<Plugin>,
 	new_plugin: Plugin,
 	name = new_plugin.name,

package/src/lib/run.task.ts

@@ -9,6 +9,8 @@ import {serialize_args, to_implicit_forwarded_args} from './args.ts';
 /**
  * Runs a TypeScript file with Gro's loader, forwarding all args to the script.
  * Useful for scripts that need SvelteKit shims ($lib, $env, etc).
+ *
+ * @module
  */
 
 /** @nodocs */

package/src/lib/source_json.ts

@@ -22,10 +22,10 @@ export const source_json_create = async (
 	SourceJson.parse({
 		name: package_json.name,
 		version: package_json.version,
-		modules: await source_modules_create(package_json.exports, lib_path, log),
+		modules: await source_json_modules_create(package_json.exports, lib_path, log),
 	});
 
-export const source_modules_create = async (
+export const source_json_modules_create = async (
 	exports: PackageJsonExports | undefined,
 	lib_path = paths.lib,
 	log?: Logger,

package/src/lib/sveltekit_shim_app_environment.ts

@@ -6,6 +6,8 @@
  * but exists here for the sake of the Node loader.
  * There may be a cleaner workaround but I couldn't find it.
  * @see https://github.com/nodejs/loaders for details about the forthcoming virtual file support
+ *
+ * @module
  */
 
 export const browser = false;

package/src/lib/sveltekit_shim_app_paths.ts

@@ -6,6 +6,8 @@
  * but exists here for the sake of the Node loader.
  * There may be a cleaner workaround but I couldn't find it.
  * @see https://github.com/nodejs/loaders for details about the forthcoming virtual file support
+ *
+ * @module
  */
 
 import type {