@g3nomaly/core 0.3.1 → 0.3.2

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":"AAAA,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAIrD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,cAAc,CACrB,QAA0B,EAC1B,QAA6B;IAE7B,OAAO,QAAQ,IAAI,QAAQ,CAAC,OAAO,IAAI,SAAS,CAAA;AAClD,CAAC;AAED,SAAS,aAAa,CAA8B,QAA0B;IAC5E,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAC5E,CAAA;AACH,CAAC;AAED,8EAA8E;AAC9E,0BAA0B;AAC1B,8EAA8E;AAE9E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAA0B,EAC1B,QAAgB;IAEhB,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,EAAE;AACF,8CAA8C;AAC9C,6EAA6E;AAC7E,qEAAqE;AACrE,yDAAyD;AACzD,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,QAA0B,EAC1B,QAAiB;IAEjB,MAAM,MAAM,GAAG,QAAQ,IAAI,QAAQ,CAAC,QAAQ,CAAC;IAC7C,IAAI,CAAC,MAAM;QAAE,OAAO;IAEpB,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,CAAC,MAAM,MAAM,CAAC,UAAU,MAAM,EAAE,CAAC,CAAoC,CAAA;YACjF,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAA;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAK,cAAc,CAAC,QAAQ,CAAC,CAAA;YACpC,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;YACzC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAA;QAC5D,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6CAA6C;IAC/C,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,iCAAiC;AACjC,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CACnB,QAA0B,EAC1B,OAA4B;IAE5B,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,uFAAuF,CACxF,CAAA;IACH,CAAC;IAED,MAAM,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC3C,aAAa,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;AACjF,CAAC;AAED,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,UAAU,OAAO,CACrB,QAA0B,EAC1B,QAAgB,EAChB,OAA4B;IAE5B,MAAM,CAAC,GAAG,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;IAC3C,aAAa,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;AACxE,CAAC"}
+{"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"}

package/dist/registry/registry.selectors.js

@@ -1,43 +1,69 @@
 /**
- * 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 function get(registry, key) {
     return registry.store.state[key];
 }
 /**
- * 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 function has(registry, key) {
     return key in registry.store.state;
 }
 /**
- * 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 function entries(registry) {
     return registry.store.state;
 }
 /**
- * Return all registered keys.
+ * @brief Returns all registered keys.
+ *
+ * @param registry - Store to read from.
+ * @returns Keys of the store's state.
  */
 export function keys(registry) {
     return Object.keys(registry.store.state);
 }
 /**
- * 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 function getByVersion(registry, version) {
     return Object.fromEntries(Object.entries(registry.store.state).filter(([, entry]) => entry.version === version));
 }
 /**
- * Return the count of registered entries.
+ * @brief Returns the count of registered entries.
+ *
+ * @param registry - Store to read from.
+ * @returns Number of entries.
  */
 export function size(registry) {
     return Object.keys(registry.store.state).length;
 }
 /**
- * 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 function collectDependencies(key, entries, seen, unknown) {
     if (seen.has(key))
@@ -52,8 +78,12 @@ export function collectDependencies(key, entries, seen, unknown) {
         collectDependencies(dep, entries, seen, unknown);
 }
 /**
- * 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 function entryDependencies(key, entries, candidates) {
     return candidates.filter((k) => entries[k]?.registryDependencies?.includes(key) ?? false);

package/dist/registry/registry.selectors.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.selectors.js","sourceRoot":"","sources":["../../src/registry/registry.selectors.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,UAAU,GAAG,CACjB,QAA0B,EAC1B,GAAW;IAEX,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CACjB,QAA0B,EAC1B,GAAW;IAEX,OAAO,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CACrB,QAA0B;IAE1B,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAA;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,QAA0B;IAE1B,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA0B,EAC1B,OAAe;IAEf,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CACtF,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAClB,QAA0B;IAE1B,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,OAAqB,EACrB,IAAiB,EACjB,OAAiB;IAEjB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAM;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,OAAM;IACR,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE;QAAE,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AACtG,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,OAAqB,EACrB,UAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAA;AAC3F,CAAC"}
+{"version":3,"file":"registry.selectors.js","sourceRoot":"","sources":["../../src/registry/registry.selectors.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CACjB,QAA0B,EAC1B,GAAW;IAEX,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,GAAG,CACjB,QAA0B,EAC1B,GAAW;IAEX,OAAO,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAA;AACpC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CACrB,QAA0B;IAE1B,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAA;AAC7B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAClB,QAA0B;IAE1B,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAC1B,QAA0B,EAC1B,OAAe;IAEf,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,CACtF,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAClB,QAA0B;IAE1B,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;AACjD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,OAAqB,EACrB,IAAiB,EACjB,OAAiB;IAEjB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAM;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAC1B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,OAAM;IACR,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE;QAAE,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AACtG,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAW,EACX,OAAqB,EACrB,UAAoB;IAEpB,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,oBAAoB,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAA;AAC3F,CAAC"}

package/dist/registry/registry.store.d.ts

@@ -1,34 +1,47 @@
 import { Store } from "@tanstack/store";
 import type { BaseRegistry, BaseRegistryEntry } from "./types";
 import type { RegistryHandler } from "./registry.handlers";
+/**
+ * @brief Options for `createRegistryStore`.
+ *
+ * @property filePath - Absolute path to the manifest file. Used by `load()` and `flush()`.
+ * @property handler - Serialization handler. Defaults to `tsHandler`.
+ */
 export interface RegistryStoreOptions<T extends BaseRegistryEntry = BaseRegistryEntry> {
-    /** Absolute path to the manifest file. Used by load() and flush(). */
     filePath?: string;
-    /** Default handler for serialization/deserialization. Defaults to tsHandler. */
     handler?: RegistryHandler<T>;
 }
 /**
- * The registry store instance — passed to mutations, selectors, and io helpers.
+ * @brief A registry store, passed to mutations, selectors and io helpers.
+ *
+ * @property store - The underlying TanStack Store. Subscribe, derive, or read `.state` directly.
+ * @property filePath - Absolute path this store is bound to, if any.
+ * @property handler - Serialization handler used when `load()` and `flush()` are not given one.
  */
 export interface RegistryStore<T extends BaseRegistryEntry = BaseRegistryEntry> {
-    /** The underlying TanStack Store. Subscribe, derive, or read .state directly. */
     store: Store<BaseRegistry<T>>;
-    /** Absolute path this store is bound to (if any). */
     filePath?: string;
-    /** Default handler for serialization/deserialization. */
     handler?: RegistryHandler<T>;
 }
 /**
- * Creates a RegistryStore backed by TanStack Store.
- * State starts empty — call load() to hydrate from disk.
+ * @brief Creates a `RegistryStore` backed by TanStack Store, starting empty.
+ *
+ * Call `load()` to hydrate it from disk.
  *
  * @example
  * const registry = createRegistryStore<MyEntry>({ filePath: "/abs/.g3nerate-manifest.ts" })
  * await load(registry)
+ *
+ * @param options - Bound file path and handler. Both optional.
+ * @returns A new store with no entries.
  */
 export declare function createRegistryStore<T extends BaseRegistryEntry = BaseRegistryEntry>(options?: RegistryStoreOptions<T>): RegistryStore<T>;
 /**
- * Sets the default handler on the store. Returns the store for chaining.
+ * @brief Sets the default handler on a store.
+ *
+ * @param registry - Store to update.
+ * @param handler - Handler used for serialization and deserialization.
+ * @returns The same store, for chaining.
  */
 export declare function useHandler<T extends BaseRegistryEntry>(registry: RegistryStore<T>, handler: RegistryHandler<T>): RegistryStore<T>;
 //# sourceMappingURL=registry.store.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"registry.store.d.ts","sourceRoot":"","sources":["../../src/registry/registry.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAM1D,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IACnF,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gFAAgF;IAChF,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAC5E,iFAAiF;IACjF,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,yDAAyD;IACzD,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAC7B;AAMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EACjF,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM,GACpC,aAAa,CAAC,CAAC,CAAC,CAMlB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,iBAAiB,EACpD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAGlB"}
+{"version":3,"file":"registry.store.d.ts","sourceRoot":"","sources":["../../src/registry/registry.store.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAM1D;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAC7B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAC5E,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;CAC7B;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EACjF,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM,GACpC,aAAa,CAAC,CAAC,CAAC,CAMlB;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,iBAAiB,EACpD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAGlB"}

package/dist/registry/registry.store.js

@@ -1,14 +1,19 @@
+// packages/core/src/registry/registry.store.ts
 import { Store } from "@tanstack/store";
 // ---------------------------------------------------------------------------
 // Factory
 // ---------------------------------------------------------------------------
 /**
- * Creates a RegistryStore backed by TanStack Store.
- * State starts empty — call load() to hydrate from disk.
+ * @brief Creates a `RegistryStore` backed by TanStack Store, starting empty.
+ *
+ * Call `load()` to hydrate it from disk.
  *
  * @example
  * const registry = createRegistryStore<MyEntry>({ filePath: "/abs/.g3nerate-manifest.ts" })
  * await load(registry)
+ *
+ * @param options - Bound file path and handler. Both optional.
+ * @returns A new store with no entries.
  */
 export function createRegistryStore(options = {}) {
     return {
@@ -18,7 +23,11 @@ export function createRegistryStore(options = {}) {
     };
 }
 /**
- * Sets the default handler on the store. Returns the store for chaining.
+ * @brief Sets the default handler on a store.
+ *
+ * @param registry - Store to update.
+ * @param handler - Handler used for serialization and deserialization.
+ * @returns The same store, for chaining.
  */
 export function useHandler(registry, handler) {
     registry.handler = handler;

package/dist/registry/registry.store.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.store.js","sourceRoot":"","sources":["../../src/registry/registry.store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AA2BvC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAO,GAA4B,EAAE;IAErC,OAAO;QACL,KAAK,EAAE,IAAI,KAAK,CAAkB,EAAE,CAAC;QACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0B,EAC1B,OAA2B;IAE3B,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAA;IAC1B,OAAO,QAAQ,CAAA;AACjB,CAAC"}
+{"version":3,"file":"registry.store.js","sourceRoot":"","sources":["../../src/registry/registry.store.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAgCvC,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAO,GAA4B,EAAE;IAErC,OAAO;QACL,KAAK,EAAE,IAAI,KAAK,CAAkB,EAAE,CAAC;QACrC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAA;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,QAA0B,EAC1B,OAA2B;IAE3B,QAAQ,CAAC,OAAO,GAAG,OAAO,CAAA;IAC1B,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/registry/registry.template.d.ts

@@ -1,14 +1,20 @@
 /**
- * Recursively serializes a value to a TypeScript object literal string.
- * Used by generateRegistryFile to produce human-readable .ts output.
+ * @brief Recursively serializes a value to a TypeScript object literal string.
+ *
+ * Used by `generateRegistryFile` to produce human-readable `.ts` output.
+ *
+ * @param value - Value to serialize. Objects, arrays, strings, numbers, booleans and null are written as literals.
+ * @param depth - Nesting level of `value`, used for indentation.
+ * @returns Source text of the literal.
  */
 export declare function stringifyValue(value: unknown, depth?: number): string;
 /**
- * Generates the full content of a typed .ts registry manifest file.
+ * @brief Generates the full content of a typed `.ts` registry manifest file.
  *
- * @param entries    - The registry entries to serialize
- * @param typeName   - TypeScript type name for the `satisfies` clause
- * @param importFrom - Package to import the type from
+ * @param entries - Registry entries to serialize, by key.
+ * @param typeName - TypeScript type name for the `satisfies` clause, e.g. `G3nerateRegistry`.
+ * @param importFrom - Package the type is imported from, e.g. `@g3nomaly/g3nerate`.
+ * @returns Source text of the file, ending with a newline.
  *
  * @example
  * generateRegistryFile(entries, "G3nerateRegistry", "@g3nomaly/g3nerate")

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

@@ -1 +1 @@
-{"version":3,"file":"registry.template.d.ts","sourceRoot":"","sources":["../../src/registry/registry.template.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CA2BhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAeR"}
+{"version":3,"file":"registry.template.d.ts","sourceRoot":"","sources":["../../src/registry/registry.template.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,MAAM,CA2BhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAeR"}