@g3nomaly/core 0.3.1 → 0.3.3

package/dist/installer/types.d.ts

@@ -1,40 +1,61 @@
 import type { BaseFileEntry } from "../registry/types";
 /**
- * How one installed file relates to its package version. Ordered by
- * severity: everything >= UserOnly carries local changes.
- * (Const-object enum — the `enum` keyword is barred by `erasableSyntaxOnly`.)
+ * @brief Relation of one installed file to its package version, ordered by severity.
+ *
+ * Const object standing in for an enum. Every state from `UserOnly` up carries local changes.
+ *
+ * @property UpToDate - On disk and identical to the package file.
+ * @property SafeUpdate - Missing, or unmodified while the package file changed. Writable without data loss.
+ * @property UserOnly - Modified locally while the package file is unchanged.
+ * @property Conflict - Modified locally and the package file changed too.
  */
 export declare const FileState: {
-    /** On disk and identical to the package file */
     readonly UpToDate: 0;
-    /** Missing, or unmodified while the package file changed; writable without data loss */
     readonly SafeUpdate: 1;
-    /** Modified locally while the package file is unchanged */
     readonly UserOnly: 2;
-    /** Modified locally and the package file changed too */
     readonly Conflict: 3;
 };
+/** One of the `FileState` values. */
 export type FileState = (typeof FileState)[keyof typeof FileState];
-/** What to do with `UserOnly` and `Conflict` files when applying. */
+/**
+ * @brief Choice for an entry whose files have local changes (`UserOnly` and `Conflict`).
+ *
+ * Const object standing in for an enum. `remove` offers only `Keep` and `Overwrite`.
+ *
+ * @property Keep - Skip: leave the changed files alone and keep their install-time hash, so the next run asks again.
+ * @property Overwrite - Restore: write the source version over the changes.
+ * @property Fork - Keep the files as they are under a new key that no update touches.
+ */
 export declare const ConflictDecision: {
     readonly Keep: 0;
     readonly Overwrite: 1;
+    readonly Fork: 2;
 };
+/** One of the `ConflictDecision` values. */
 export type ConflictDecision = (typeof ConflictDecision)[keyof typeof ConflictDecision];
-/** Classification of one file, produced by `classifyFiles` and consumed by `applyClassifications`. */
+/**
+ * @brief Classification of one file, produced by `classifyFiles` and consumed by `applyClassifications`.
+ *
+ * @property file - Registry entry of the file, with the hash the package ships.
+ * @property destPath - Absolute path the file is installed at: `installDir` joined with `file.path`.
+ * @property state - What the install or update does with the file.
+ * @property exists - Whether a file is on disk at `destPath`.
+ * @property currentHash - Hash of the file on disk, e.g. `"a1b2"`. `null` when it does not exist.
+ * @property recordedHash - Hash recorded in the user manifest at install time. `undefined` when never installed.
+ * @property latestHash - Hash of the package's current version of the file.
+ */
 export interface FileClassification<F extends BaseFileEntry = BaseFileEntry> {
     file: F;
     destPath: string;
     state: FileState;
     exists: boolean;
-    /** Hash of the file currently on disk, null when it does not exist */
     currentHash: string | null;
-    /** Hash recorded in the user manifest at install time, undefined when never installed */
     recordedHash: string | undefined;
-    /** Hash of the package's current version of the file */
     latestHash: string;
 }
-/** Where a file's content comes from when it is written. `null` skips the file. */
+/**
+ * Where a file's content comes from when it is written. `null` skips the file.
+ */
 export type FileContent = {
     kind: "copy";
     sourcePath: string;
@@ -42,10 +63,24 @@ export type FileContent = {
     kind: "write";
     content: string;
 } | null;
+/**
+ * @brief Produces the content of one file for `applyClassifications`.
+ *
+ * @param file - Registry entry of the file to produce content for.
+ * @returns Where the content comes from, or `null` to skip the file.
+ */
 export type FileSource<F extends BaseFileEntry = BaseFileEntry> = (file: F) => FileContent | Promise<FileContent>;
 /**
- * Filesystem boundary for the installer. `createInstallerIO` supplies the
- * real implementation; tests inject stubs per field.
+ * @brief Filesystem boundary for the installer. `createInstallerIO` supplies the real implementation; tests inject stubs per field.
+ *
+ * @property exists - Whether a path exists on disk.
+ * @property ensureDir - Creates a directory and its parents when missing.
+ * @property copyFile - Copies the file at `src` to `dest`.
+ * @property writeFile - Writes `content` to `dest` as UTF-8.
+ * @property removeFile - Deletes the file at `path`.
+ * @property listDir - Names of the entries directly inside `dir`.
+ * @property removeDir - Deletes `dir` and everything below it.
+ * @property hashFile - Content hash of the file at `path`.
  */
 export interface InstallerIO {
     exists: (path: string) => boolean;
@@ -57,21 +92,39 @@ export interface InstallerIO {
     removeDir: (dir: string) => void;
     hashFile: (path: string) => Promise<string>;
 }
+/**
+ * @brief Options that decide which changed files `applyClassifications` writes.
+ *
+ * @property decision - What to do with entries that have local changes.
+ * @property force - Writes changed files even when `decision` is not `Overwrite`.
+ * @property dryRun - Reports the result without touching the disk.
+ */
 export interface ApplyOptions {
     decision: ConflictDecision;
     force?: boolean;
     dryRun?: boolean;
 }
+/**
+ * @brief Outcome of `applyClassifications`, per file.
+ *
+ * @property written - Relative paths written, or that would be written under `dryRun`.
+ * @property kept - Relative paths with local changes that were left alone.
+ * @property missingSource - Relative paths whose source produced no content.
+ * @property files - Manifest entries reflecting the on-disk state after the apply.
+ */
 export interface ApplyResult<F extends BaseFileEntry = BaseFileEntry> {
-    /** Relative paths written (or that would be written under dryRun) */
     written: string[];
-    /** Relative paths with local changes that were left alone */
     kept: string[];
-    /** Relative paths whose source produced no content */
     missingSource: string[];
-    /** Manifest entries reflecting the on-disk state after the apply */
     files: F[];
 }
+/**
+ * @brief Outcome of removing installed files.
+ *
+ * @property removed - Relative paths deleted.
+ * @property kept - Relative paths with local changes that were left alone.
+ * @property missing - Relative paths that were not on disk.
+ */
 export interface RemoveResult {
     removed: string[];
     kept: string[];

package/dist/installer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/installer/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/installer/types.ts"],"names":[],"mappings":"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"}

package/dist/installer/types.js

@@ -1,21 +1,31 @@
 /**
- * How one installed file relates to its package version. Ordered by
- * severity: everything >= UserOnly carries local changes.
- * (Const-object enum — the `enum` keyword is barred by `erasableSyntaxOnly`.)
+ * @brief Relation of one installed file to its package version, ordered by severity.
+ *
+ * Const object standing in for an enum. Every state from `UserOnly` up carries local changes.
+ *
+ * @property UpToDate - On disk and identical to the package file.
+ * @property SafeUpdate - Missing, or unmodified while the package file changed. Writable without data loss.
+ * @property UserOnly - Modified locally while the package file is unchanged.
+ * @property Conflict - Modified locally and the package file changed too.
  */
 export const FileState = {
-    /** On disk and identical to the package file */
     UpToDate: 0,
-    /** Missing, or unmodified while the package file changed; writable without data loss */
     SafeUpdate: 1,
-    /** Modified locally while the package file is unchanged */
     UserOnly: 2,
-    /** Modified locally and the package file changed too */
     Conflict: 3,
 };
-/** What to do with `UserOnly` and `Conflict` files when applying. */
+/**
+ * @brief Choice for an entry whose files have local changes (`UserOnly` and `Conflict`).
+ *
+ * Const object standing in for an enum. `remove` offers only `Keep` and `Overwrite`.
+ *
+ * @property Keep - Skip: leave the changed files alone and keep their install-time hash, so the next run asks again.
+ * @property Overwrite - Restore: write the source version over the changes.
+ * @property Fork - Keep the files as they are under a new key that no update touches.
+ */
 export const ConflictDecision = {
     Keep: 0,
     Overwrite: 1,
+    Fork: 2,
 };
 //# sourceMappingURL=types.js.map

package/dist/installer/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/installer/types.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,gDAAgD;IAChD,QAAQ,EAAI,CAAC;IACb,wFAAwF;IACxF,UAAU,EAAE,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAI,CAAC;IACb,wDAAwD;IACxD,QAAQ,EAAI,CAAC;CACL,CAAA;AAGV,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAO,CAAC;IACZ,SAAS,EAAE,CAAC;CACJ,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/installer/types.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAI,CAAC;IACb,UAAU,EAAE,CAAC;IACb,QAAQ,EAAI,CAAC;IACb,QAAQ,EAAI,CAAC;CACL,CAAA;AAIV;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAO,CAAC;IACZ,SAAS,EAAE,CAAC;IACZ,IAAI,EAAO,CAAC;CACJ,CAAA"}

package/dist/registry/index.d.ts

@@ -5,8 +5,4 @@ export * from "./registry.mutations";
 export * from "./registry.selectors";
 export * from "./registry.template";
 export * from "./registry.io";
-/**
- * Purposfully a custom registry store. To reduce dependencies. Still follows the same pattern as the tanstack store design skill. Though it could still be improved since it is still missing a lot of default operators.
- * Nevertheless, this stores doesn't need reactive updates. Hence, once more the, part of why it is a custom store.
- */ 
 //# sourceMappingURL=index.d.ts.map

package/dist/registry/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAE7B;;;GAGG"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}

package/dist/registry/index.js

@@ -1,3 +1,4 @@
+// packages/core/src/registry/index.ts
 export * from "./types";
 export * from "./registry.handlers";
 export * from "./registry.store";
@@ -5,8 +6,4 @@ export * from "./registry.mutations";
 export * from "./registry.selectors";
 export * from "./registry.template";
 export * from "./registry.io";
-/**
- * Purposfully a custom registry store. To reduce dependencies. Still follows the same pattern as the tanstack store design skill. Though it could still be improved since it is still missing a lot of default operators.
- * Nevertheless, this stores doesn't need reactive updates. Hence, once more the, part of why it is a custom store.
- */ 
 //# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAE7B;;;GAGG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/registry/index.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,cAAc,SAAS,CAAA;AACvB,cAAc,qBAAqB,CAAA;AACnC,cAAc,kBAAkB,CAAA;AAChC,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA"}

package/dist/registry/registry.handlers.d.ts

@@ -1,4 +1,11 @@
 import type { BaseRegistry, BaseRegistryEntry } from "./types";
+/**
+ * @brief Converts a registry map to and from the text of a manifest file.
+ *
+ * @property extensions - File extensions this handler reads and writes, without the dot, e.g. `json`.
+ * @property serialize - Turns the registry map into file text.
+ * @property deserialize - Parses file text back into a registry map.
+ */
 export interface RegistryHandler<T extends BaseRegistryEntry = BaseRegistryEntry> {
     extensions: string[];
     serialize: (data: BaseRegistry<T>) => string;

package/dist/registry/registry.handlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.handlers.d.ts","sourceRoot":"","sources":["../../src/registry/registry.handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE9D,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;IAC5C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;CAC9C;AAED,eAAO,MAAM,SAAS,EAAE,eAAe,CAAC,GAAG,CAO1C,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,eAAe,CAAC,GAAG,CAI5C,CAAA"}
+{"version":3,"file":"registry.handlers.d.ts","sourceRoot":"","sources":["../../src/registry/registry.handlers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAC9E,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,MAAM,CAAA;IAC5C,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;CAC9C;AAED,eAAO,MAAM,SAAS,EAAE,eAAe,CAAC,GAAG,CAO1C,CAAA;AAED,eAAO,MAAM,WAAW,EAAE,eAAe,CAAC,GAAG,CAI5C,CAAA"}

package/dist/registry/registry.handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.handlers.js","sourceRoot":"","sources":["../../src/registry/registry.handlers.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC7C,UAAU,EAAE,CAAC,IAAI,CAAC;IAClB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAClB,2BAA2B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa;IACvE,WAAW,EAAE,GAAG,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC5E,CAAC;CACF,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;CACtC,CAAA"}
+{"version":3,"file":"registry.handlers.js","sourceRoot":"","sources":["../../src/registry/registry.handlers.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC7C,UAAU,EAAE,CAAC,IAAI,CAAC;IAClB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAClB,2BAA2B,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,aAAa;IACvE,WAAW,EAAE,GAAG,EAAE;QAChB,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAA;IAC5E,CAAC;CACF,CAAA;AAED,MAAM,CAAC,MAAM,WAAW,GAAyB;IAC/C,UAAU,EAAE,CAAC,MAAM,CAAC;IACpB,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;CACtC,CAAA"}

package/dist/registry/registry.io.d.ts

@@ -2,21 +2,37 @@ import type { BaseRegistryEntry } from "./types";
 import type { RegistryStore } from "./registry.store";
 import type { RegistryHandler } from "./registry.handlers";
 /**
- * name alias for load() when you want to specify an explicit filePath. Otherwise identical behavior.
+ * @brief Alias of `load()` that takes an explicit file path. Behaves the same.
+ *
+ * @param registry - Store to hydrate.
+ * @param filePath - Absolute path to read from.
  */
 export declare function loadFrom<T extends BaseRegistryEntry>(registry: RegistryStore<T>, filePath: string): Promise<void>;
+/**
+ * @brief Hydrates the store from a file.
+ *
+ * A `.ts` file is read by dynamic import, which skips the handler, since such a file exports a `registry`
+ * object directly at runtime. Any other file is read with `readFileSync` and `handler.deserialize`.
+ * Does nothing when there is no file path or the file does not exist yet.
+ *
+ * @param registry - Store to hydrate.
+ * @param filePath - File to read. Defaults to the store's bound `filePath`.
+ */
 export declare function load<T extends BaseRegistryEntry>(registry: RegistryStore<T>, filePath?: string): Promise<void>;
 /**
- * Flushes the store to its already-bound filePath.
- * Sorts entries alphabetically for deterministic output.
+ * @brief Writes the store to its bound `filePath`, entries sorted by key.
  *
- * @throws If the store has no bound filePath.
+ * @param registry - Store to write.
+ * @param handler - Serialization handler. Defaults to the store's handler, then `tsHandler`.
+ * @throws {Error} When the store has no bound `filePath`.
  */
 export declare function flush<T extends BaseRegistryEntry>(registry: RegistryStore<T>, handler?: RegistryHandler<T>): void;
 /**
- * Writes the store to an explicit path.
- * Sorts entries alphabetically for deterministic output.
- * Does not affect the store's bound filePath.
+ * @brief Writes the store to an explicit path, entries sorted by key. The store's bound `filePath` is not changed.
+ *
+ * @param registry - Store to write.
+ * @param filePath - Absolute path to write to.
+ * @param handler - Serialization handler. Defaults to the store's handler, then `tsHandler`.
  */
 export declare function writeTo<T extends BaseRegistryEntry>(registry: RegistryStore<T>, filePath: string, handler?: RegistryHandler<T>): void;
 //# sourceMappingURL=registry.io.d.ts.map

package/dist/registry/registry.io.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.io.d.ts","sourceRoot":"","sources":["../../src/registry/registry.io.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAwB1D;;GAEG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EACxD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAYD,wBAAsB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EACpD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAMD;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,iBAAiB,EAC/C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,IAAI,CASN;AAMD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,iBAAiB,EACjD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,IAAI,CAGN"}
+{"version":3,"file":"registry.io.d.ts","sourceRoot":"","sources":["../../src/registry/registry.io.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAqC1D;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EACxD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAEf;AAMD;;;;;;;;;GASG;AACH,wBAAsB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EACpD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAMD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,iBAAiB,EAC/C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,IAAI,CASN;AAMD;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,iBAAiB,EACjD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,GAC3B,IAAI,CAGN"}

package/dist/registry/registry.io.js

@@ -1,11 +1,25 @@
+// packages/core/src/registry/registry.io.ts
 import { writeFileSync, readFileSync } from "node:fs";
 import { tsHandler } from "./registry.handlers";
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
+/**
+ * @brief Picks the handler for a read or write: the override, then the store's handler, then `tsHandler`.
+ *
+ * @param registry - Store whose handler is the fallback.
+ * @param override - Handler passed by the caller, if any.
+ * @returns The handler to use.
+ */
 function resolveHandler(registry, override) {
     return override ?? registry.handler ?? tsHandler;
 }
+/**
+ * @brief Returns the store's entries sorted by key, for deterministic output.
+ *
+ * @param registry - Store to read from.
+ * @returns Entries by key, in alphabetical key order.
+ */
 function sortedEntries(registry) {
     return Object.fromEntries(Object.entries(registry.store.state).sort(([a], [b]) => a.localeCompare(b)));
 }
@@ -13,21 +27,27 @@ function sortedEntries(registry) {
 // loadFrom (file → store)
 // ---------------------------------------------------------------------------
 /**
- * name alias for load() when you want to specify an explicit filePath. Otherwise identical behavior.
+ * @brief Alias of `load()` that takes an explicit file path. Behaves the same.
+ *
+ * @param registry - Store to hydrate.
+ * @param filePath - Absolute path to read from.
  */
 export async function loadFrom(registry, filePath) {
     return load(registry, filePath);
 }
 // ---------------------------------------------------------------------------
 // load (file → store)
-//
-// Hydrates the store from its bound filePath.
-// - .ts files:  uses dynamic import (handler is not called — TS files export
-//               a `registry` object directly at runtime via Bun/tsx)
-// - other files: uses readFileSync + handler.deserialize
-//
-// No-op if the store has no filePath or the file does not exist yet.
 // ---------------------------------------------------------------------------
+/**
+ * @brief Hydrates the store from a file.
+ *
+ * A `.ts` file is read by dynamic import, which skips the handler, since such a file exports a `registry`
+ * object directly at runtime. Any other file is read with `readFileSync` and `handler.deserialize`.
+ * Does nothing when there is no file path or the file does not exist yet.
+ *
+ * @param registry - Store to hydrate.
+ * @param filePath - File to read. Defaults to the store's bound `filePath`.
+ */
 export async function load(registry, filePath) {
     const target = filePath ?? registry.filePath;
     if (!target)
@@ -51,10 +71,11 @@ export async function load(registry, filePath) {
 // flush (store → bound filePath)
 // ---------------------------------------------------------------------------
 /**
- * Flushes the store to its already-bound filePath.
- * Sorts entries alphabetically for deterministic output.
+ * @brief Writes the store to its bound `filePath`, entries sorted by key.
  *
- * @throws If the store has no bound filePath.
+ * @param registry - Store to write.
+ * @param handler - Serialization handler. Defaults to the store's handler, then `tsHandler`.
+ * @throws {Error} When the store has no bound `filePath`.
  */
 export function flush(registry, handler) {
     if (!registry.filePath) {
@@ -67,9 +88,11 @@ export function flush(registry, handler) {
 // writeTo (store → explicit path)
 // ---------------------------------------------------------------------------
 /**
- * Writes the store to an explicit path.
- * Sorts entries alphabetically for deterministic output.
- * Does not affect the store's bound filePath.
+ * @brief Writes the store to an explicit path, entries sorted by key. The store's bound `filePath` is not changed.
+ *
+ * @param registry - Store to write.
+ * @param filePath - Absolute path to write to.
+ * @param handler - Serialization handler. Defaults to the store's handler, then `tsHandler`.
  */
 export function writeTo(registry, filePath, handler) {
     const h = resolveHandler(registry, handler);

package/dist/registry/registry.io.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.io.js","sourceRoot":"","sources":["../../src/registry/registry.io.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.io.js","sourceRoot":"","sources":["../../src/registry/registry.io.ts"],"names":[],"mappings":"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"}

package/dist/registry/registry.mutations.d.ts

@@ -1,12 +1,19 @@
 import type { BaseRegistryEntry } from "./types";
 import type { RegistryStore } from "./registry.store";
 /**
- * Register or overwrite an entry in the store.
+ * @brief Registers an entry in the store, overwriting any entry under the same key.
+ *
+ * @param registry - Store to write to.
+ * @param key - Key the entry is stored under.
+ * @param entry - Entry to store.
  */
 export declare function register<T extends BaseRegistryEntry>(registry: RegistryStore<T>, key: string, entry: T): void;
 /**
- * Remove an entry from the store.
- * Returns true if the entry existed, false if it was already absent.
+ * @brief Removes an entry from the store.
+ *
+ * @param registry - Store to remove from.
+ * @param key - Key of the entry to remove.
+ * @returns `true` if the entry existed, `false` if it was already absent.
  */
 export declare function unregister<T extends BaseRegistryEntry>(registry: RegistryStore<T>, key: string): boolean;
 //# sourceMappingURL=registry.mutations.d.ts.map

package/dist/registry/registry.mutations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.mutations.d.ts","sourceRoot":"","sources":["../../src/registry/registry.mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EAClD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,iBAAiB,EACpD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAYT"}
+{"version":3,"file":"registry.mutations.d.ts","sourceRoot":"","sources":["../../src/registry/registry.mutations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAChD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,iBAAiB,EAClD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,GACP,IAAI,CAEN;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,iBAAiB,EACpD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAYT"}

package/dist/registry/registry.mutations.js

@@ -1,12 +1,19 @@
 /**
- * Register or overwrite an entry in the store.
+ * @brief Registers an entry in the store, overwriting any entry under the same key.
+ *
+ * @param registry - Store to write to.
+ * @param key - Key the entry is stored under.
+ * @param entry - Entry to store.
  */
 export function register(registry, key, entry) {
     registry.store.setState((s) => ({ ...s, [key]: entry }));
 }
 /**
- * Remove an entry from the store.
- * Returns true if the entry existed, false if it was already absent.
+ * @brief Removes an entry from the store.
+ *
+ * @param registry - Store to remove from.
+ * @param key - Key of the entry to remove.
+ * @returns `true` if the entry existed, `false` if it was already absent.
  */
 export function unregister(registry, key) {
     const existed = key in registry.store.state;

package/dist/registry/registry.mutations.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.mutations.js","sourceRoot":"","sources":["../../src/registry/registry.mutations.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA0B,EAC1B,GAAW,EACX,KAAQ;IAER,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0B,EAC1B,GAAW;IAEX,MAAM,OAAO,GAAG,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAA;IAE3C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;YACrB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}
+{"version":3,"file":"registry.mutations.js","sourceRoot":"","sources":["../../src/registry/registry.mutations.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,QAA0B,EAC1B,GAAW,EACX,KAAQ;IAER,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0B,EAC1B,GAAW;IAEX,MAAM,OAAO,GAAG,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAA;IAE3C,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,EAAE,GAAG,CAAC,EAAE,CAAA;YACrB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;YAChB,OAAO,IAAI,CAAA;QACb,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/registry/registry.selectors.d.ts

@@ -1,38 +1,68 @@
 import type { BaseRegistry, BaseRegistryEntry } from "./types";
 import type { RegistryStore } from "./registry.store";
 /**
- * Get a single entry by key. Returns undefined if not found.
+ * @brief Gets a single entry by key.
+ *
+ * @param registry - Store to read from.
+ * @param key - Key of the entry.
+ * @returns The entry, or `undefined` when not found.
  */
 export declare function get<T extends BaseRegistryEntry>(registry: RegistryStore<T>, key: string): T | undefined;
 /**
- * Check whether a key exists in the store.
+ * @brief Checks whether a key exists in the store.
+ *
+ * @param registry - Store to read from.
+ * @param key - Key to look for.
+ * @returns `true` when the key is present.
  */
 export declare function has<T extends BaseRegistryEntry>(registry: RegistryStore<T>, key: string): boolean;
 /**
- * Return all entries as a plain record.
+ * @brief Returns all entries as a plain record.
+ *
+ * @param registry - Store to read from.
+ * @returns Entries by key. This is the store's own state, not a copy.
  */
 export declare function entries<T extends BaseRegistryEntry>(registry: RegistryStore<T>): BaseRegistry<T>;
 /**
- * Return all registered keys.
+ * @brief Returns all registered keys.
+ *
+ * @param registry - Store to read from.
+ * @returns Keys of the store's state.
  */
 export declare function keys<T extends BaseRegistryEntry>(registry: RegistryStore<T>): string[];
 /**
- * Return all entries that match a given version string.
+ * @brief Returns all entries whose `version` equals the given string.
+ *
+ * @param registry - Store to read from.
+ * @param version - Version to match exactly.
+ * @returns Matching entries by key.
  */
 export declare function getByVersion<T extends BaseRegistryEntry>(registry: RegistryStore<T>, version: string): BaseRegistry<T>;
 /**
- * Return the count of registered entries.
+ * @brief Returns the count of registered entries.
+ *
+ * @param registry - Store to read from.
+ * @returns Number of entries.
  */
 export declare function size<T extends BaseRegistryEntry>(registry: RegistryStore<T>): number;
 /**
- * Depth-first walk of `registryDependencies` starting at `key`. Every entry
- * reached is added to `seen`; keys without a registry entry are pushed to
- * `unknown` and not walked further.
+ * @brief Walks `registryDependencies` depth-first, starting at `key`.
+ *
+ * Every entry reached is added to `seen`. Keys without a registry entry are pushed to `unknown` and not walked further.
+ *
+ * @param key - Key to start from.
+ * @param entries - Registry to walk, by key.
+ * @param seen - Keys already reached. Filled in place.
+ * @param unknown - Keys with no registry entry. Filled in place.
  */
 export declare function collectDependencies(key: string, entries: BaseRegistry, seen: Set<string>, unknown: string[]): void;
 /**
- * Return which of `candidates` have `key` in their `registryDependencies` —
- * the entries that need it and would break if it were removed.
+ * @brief Finds the candidates that depend on `key`, the entries that would break if it were removed.
+ *
+ * @param key - Key that may be needed.
+ * @param entries - Registry to read `registryDependencies` from, by key.
+ * @param candidates - Keys to check.
+ * @returns The candidates whose `registryDependencies` include `key`.
  */
 export declare function entryDependencies(key: string, entries: BaseRegistry, candidates: string[]): string[];
 //# sourceMappingURL=registry.selectors.d.ts.map

package/dist/registry/registry.selectors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.selectors.d.ts","sourceRoot":"","sources":["../../src/registry/registry.selectors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,SAAS,CAEf;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,iBAAiB,EACjD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,YAAY,CAAC,CAAC,CAAC,CAEjB;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAC9C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,MAAM,EAAE,CAEV;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EACtD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,GACd,YAAY,CAAC,CAAC,CAAC,CAIjB;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAC9C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,MAAM,CAER;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI,CASN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,EAAE,CAEV"}
+{"version":3,"file":"registry.selectors.d.ts","sourceRoot":"","sources":["../../src/registry/registry.selectors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GACV,CAAC,GAAG,SAAS,CAEf;AAED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,CAAC,SAAS,iBAAiB,EAC7C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,GAAG,EAAE,MAAM,GACV,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,iBAAiB,EACjD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,YAAY,CAAC,CAAC,CAAC,CAEjB;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAC9C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,MAAM,EAAE,CAEV;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,iBAAiB,EACtD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,MAAM,GACd,YAAY,CAAC,CAAC,CAAC,CAIjB;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,iBAAiB,EAC9C,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GACzB,MAAM,CAER;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,IAAI,CASN;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,EAAE,CAEV"}