@g3nomaly/core 0.3.0 → 0.3.2

package/dist/installer/sourceRegistry.d.ts

@@ -0,0 +1,96 @@
+import { type RegistryStore } from "../registry/registry.store";
+import type { RegisteredSource, SourceCheckout } from "../sources/types";
+import type { EntrySource } from "../cli/types";
+import { type OriginEntry } from "./origin";
+/**
+ * @brief What a package's reader found in one checked-out source.
+ *
+ * @property entries - Entries by key, each with its `origin` filled in.
+ * @property warnings - Problems the reader met that did not stop it.
+ */
+export interface SourceEntries<T extends OriginEntry> {
+    entries: [string, T][];
+    warnings: string[];
+}
+/**
+ * @brief Reads the entries one checked-out source offers. Each installer supplies its own.
+ *
+ * @param checkout - Checkout of the source to read.
+ * @returns Entries and warnings found in the checkout.
+ */
+export type ReadSource<T extends OriginEntry> = (checkout: SourceCheckout) => Promise<SourceEntries<T>>;
+/**
+ * @brief A source that could not be checked out or read.
+ *
+ * @property name - Name of the registered source.
+ * @property error - Reason it failed, as a message.
+ */
+export interface FailedSource {
+    name: string;
+    error: string;
+}
+/**
+ * @brief The entries a set of sources offers, one registry store per source.
+ *
+ * Checkouts stay on disk until `dispose` so the install can copy files out of them. Built by
+ * `loadSourceRegistry` in each installer's `add`, `update`, `ls` and `source add` commands. `offers`
+ * lists every entry for name resolution, and `entrySource` copies an entry's files from its checkout.
+ *
+ * @property sources - Entries by source name, in the order the sources were given.
+ * @property checkouts - Checkout of each source by name.
+ * @property warnings - Warnings from loading, prefixed with the source name.
+ * @property failed - Sources that could not be checked out or read.
+ * @property dispose - Releases every checkout.
+ */
+export interface SourceRegistry<T extends OriginEntry> {
+    sources: Map<string, RegistryStore<T>>;
+    checkouts: Map<string, SourceCheckout>;
+    warnings: string[];
+    failed: FailedSource[];
+    dispose: () => void;
+}
+/**
+ * @brief One entry that one source offers.
+ *
+ * @property key - Key of the entry within its source.
+ * @property entry - The entry itself.
+ */
+export interface SourceOffer<T extends OriginEntry> {
+    key: string;
+    entry: T;
+}
+/**
+ * @brief Checks out each source and reads its entries with `readSource`, all sources at once.
+ *
+ * A source that cannot be checked out or read lands in `failed` instead of throwing, so one unreachable
+ * source does not stop the rest. A key offered twice by one source keeps the first, with a warning.
+ *
+ * @param sources - Registered sources to load.
+ * @param projectRoot - Absolute root that local source paths and the `node_modules` lookup start from.
+ * @param readSource - Reads the entries of one checkout.
+ * @returns Registry holding every source that loaded, with the rest in `failed`.
+ */
+export declare function loadSourceRegistry<T extends OriginEntry>(sources: readonly RegisteredSource[], projectRoot: string, readSource: ReadSource<T>): Promise<SourceRegistry<T>>;
+/**
+ * @brief Lists every entry of every source, sources in their given order and keys sorted within each.
+ *
+ * @param registry - Registry returned by `loadSourceRegistry`.
+ * @returns One offer per entry.
+ */
+export declare function offers<T extends OriginEntry>(registry: SourceRegistry<T>): SourceOffer<T>[];
+/**
+ * @brief File source for the core install commands. Copies each file from `<checkout>/<origin.dir>/<path>` in its entry's source.
+ *
+ * @param registry - Registry whose checkouts the files are copied from.
+ * @returns Source that copies an entry's files from the checkout of `origin.source`.
+ * @throws {Error} When the entry's source is not checked out.
+ */
+export declare function entrySource<T extends OriginEntry>(registry: SourceRegistry<T>): EntrySource;
+/**
+ * @brief Converts offers into the registry the core install commands take, keyed by entry key.
+ *
+ * @param selected - Offers to include. A later offer with the same key replaces an earlier one.
+ * @returns Entries by key.
+ */
+export declare function offerRegistry<T extends OriginEntry>(selected: Iterable<SourceOffer<T>>): Record<string, T>;
+//# sourceMappingURL=sourceRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sourceRegistry.d.ts","sourceRoot":"","sources":["../../src/installer/sourceRegistry.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAIpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,UAAU,CAAA;AAE9D;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,WAAW;IAClD,OAAO,EAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;AAEvG;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAG,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,WAAW;IACnD,OAAO,EAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IACxC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;IACtC,QAAQ,EAAG,MAAM,EAAE,CAAA;IACnB,MAAM,EAAK,YAAY,EAAE,CAAA;IACzB,OAAO,EAAI,MAAM,IAAI,CAAA;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,WAAW;IAChD,GAAG,EAAI,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,CAAA;CACT;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,WAAW,EAC5D,OAAO,EAAE,SAAS,gBAAgB,EAAE,EACpC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,GACxB,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CA6B5B;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAG3F;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAO3F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAI1G"}

package/dist/installer/sourceRegistry.js

@@ -0,0 +1,86 @@
+// packages/core/src/installer/sourceRegistry.ts
+import path from "node:path";
+import { createRegistryStore } from "../registry/registry.store";
+import { register } from "../registry/registry.mutations";
+import { entries } from "../registry/registry.selectors";
+import { checkoutSource } from "../sources/checkout";
+import { errorMessage } from "../utils/errors";
+import { copySource } from "./install";
+import { OriginEntrySchema } from "./origin";
+/**
+ * @brief Checks out each source and reads its entries with `readSource`, all sources at once.
+ *
+ * A source that cannot be checked out or read lands in `failed` instead of throwing, so one unreachable
+ * source does not stop the rest. A key offered twice by one source keeps the first, with a warning.
+ *
+ * @param sources - Registered sources to load.
+ * @param projectRoot - Absolute root that local source paths and the `node_modules` lookup start from.
+ * @param readSource - Reads the entries of one checkout.
+ * @returns Registry holding every source that loaded, with the rest in `failed`.
+ */
+export async function loadSourceRegistry(sources, projectRoot, readSource) {
+    const registry = { sources: new Map(), checkouts: new Map(), warnings: [], failed: [], dispose: () => { } };
+    registry.dispose = () => { for (const checkout of registry.checkouts.values())
+        checkout.dispose(); };
+    const results = await Promise.allSettled(sources.map(async (source) => {
+        const checkout = await checkoutSource(source, projectRoot);
+        registry.checkouts.set(source.name, checkout);
+        return readSource(checkout);
+    }));
+    results.forEach((result, index) => {
+        const name = sources[index]?.name ?? "";
+        if (result.status === "rejected") {
+            registry.failed.push({ name, error: errorMessage(result.reason) });
+            return;
+        }
+        const store = createRegistryStore();
+        for (const [key, entry] of result.value.entries) {
+            if (store.store.state[key] !== undefined) {
+                registry.warnings.push(`${name}: "${key}" is offered twice, using the first`);
+                continue;
+            }
+            register(store, key, entry);
+        }
+        registry.sources.set(name, store);
+        registry.warnings.push(...result.value.warnings.map((warning) => `${name}: ${warning}`));
+    });
+    return registry;
+}
+/**
+ * @brief Lists every entry of every source, sources in their given order and keys sorted within each.
+ *
+ * @param registry - Registry returned by `loadSourceRegistry`.
+ * @returns One offer per entry.
+ */
+export function offers(registry) {
+    return [...registry.sources.values()].flatMap((store) => Object.entries(entries(store)).sort(([a], [b]) => a.localeCompare(b)).map(([key, entry]) => ({ key, entry })));
+}
+/**
+ * @brief File source for the core install commands. Copies each file from `<checkout>/<origin.dir>/<path>` in its entry's source.
+ *
+ * @param registry - Registry whose checkouts the files are copied from.
+ * @returns Source that copies an entry's files from the checkout of `origin.source`.
+ * @throws {Error} When the entry's source is not checked out.
+ */
+export function entrySource(registry) {
+    return (entry) => {
+        const { origin } = OriginEntrySchema.pick({ origin: true }).parse(entry);
+        const checkout = registry.checkouts.get(origin.source);
+        if (checkout === undefined)
+            throw new Error(`source ${origin.source} of "${entry.name}" is not checked out`);
+        return copySource((filePath) => path.join(checkout.dir, origin.dir, filePath));
+    };
+}
+/**
+ * @brief Converts offers into the registry the core install commands take, keyed by entry key.
+ *
+ * @param selected - Offers to include. A later offer with the same key replaces an earlier one.
+ * @returns Entries by key.
+ */
+export function offerRegistry(selected) {
+    const registry = {};
+    for (const offer of selected)
+        registry[offer.key] = offer.entry;
+    return registry;
+}
+//# sourceMappingURL=sourceRegistry.js.map

package/dist/installer/sourceRegistry.js.map

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

package/dist/installer/types.d.ts

@@ -0,0 +1,133 @@
+import type { BaseFileEntry } from "../registry/types";
+/**
+ * @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: {
+    readonly UpToDate: 0;
+    readonly SafeUpdate: 1;
+    readonly UserOnly: 2;
+    readonly Conflict: 3;
+};
+/** One of the `FileState` values. */
+export type FileState = (typeof FileState)[keyof typeof FileState];
+/**
+ * @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];
+/**
+ * @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;
+    currentHash: string | null;
+    recordedHash: string | undefined;
+    latestHash: string;
+}
+/**
+ * Where a file's content comes from when it is written. `null` skips the file.
+ */
+export type FileContent = {
+    kind: "copy";
+    sourcePath: string;
+} | {
+    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>;
+/**
+ * @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;
+    ensureDir: (dir: string) => void;
+    copyFile: (src: string, dest: string) => void;
+    writeFile: (dest: string, content: string) => void;
+    removeFile: (path: string) => void;
+    listDir: (dir: string) => string[];
+    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> {
+    written: string[];
+    kept: string[];
+    missingSource: string[];
+    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[];
+    missing: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/installer/types.js

@@ -0,0 +1,31 @@
+/**
+ * @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 = {
+    UpToDate: 0,
+    SafeUpdate: 1,
+    UserOnly: 2,
+    Conflict: 3,
+};
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,8 @@
+export * from "./types";
+export * from "./registry.handlers";
+export * from "./registry.store";
+export * from "./registry.mutations";
+export * from "./registry.selectors";
+export * from "./registry.template";
+export * from "./registry.io";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,9 @@
+// packages/core/src/registry/index.ts
+export * from "./types";
+export * from "./registry.handlers";
+export * from "./registry.store";
+export * from "./registry.mutations";
+export * from "./registry.selectors";
+export * from "./registry.template";
+export * from "./registry.io";
+//# sourceMappingURL=index.js.map

package/dist/registry/index.js.map

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,16 @@
+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;
+    deserialize: (raw: string) => BaseRegistry<T>;
+}
+export declare const tsHandler: RegistryHandler<any>;
+export declare const jsonHandler: RegistryHandler<any>;
+//# sourceMappingURL=registry.handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,13 @@
+export const tsHandler = {
+    extensions: ["ts"],
+    serialize: (data) => `export const registry = ${JSON.stringify(data, null, 2)} as const\n`,
+    deserialize: () => {
+        throw new Error("TS handler deserializes via dynamic import — use load()");
+    },
+};
+export const jsonHandler = {
+    extensions: ["json"],
+    serialize: (data) => JSON.stringify(data, null, 2),
+    deserialize: (raw) => JSON.parse(raw),
+};
+//# sourceMappingURL=registry.handlers.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,38 @@
+import type { BaseRegistryEntry } from "./types";
+import type { RegistryStore } from "./registry.store";
+import type { RegistryHandler } from "./registry.handlers";
+/**
+ * @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>;
+/**
+ * @brief Writes the store to its bound `filePath`, entries sorted by key.
+ *
+ * @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;
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,101 @@
+// 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)));
+}
+// ---------------------------------------------------------------------------
+// loadFrom (file → store)
+// ---------------------------------------------------------------------------
+/**
+ * @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)
+// ---------------------------------------------------------------------------
+/**
+ * @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)
+        return;
+    try {
+        if (target.endsWith(".ts")) {
+            const mod = (await import(`file://${target}`));
+            registry.store.setState(() => ({ ...mod.registry }));
+        }
+        else {
+            const h = resolveHandler(registry);
+            const raw = readFileSync(target, "utf-8");
+            registry.store.setState(() => ({ ...h.deserialize(raw) }));
+        }
+    }
+    catch {
+        // File doesn't exist yet — store stays empty
+    }
+}
+// ---------------------------------------------------------------------------
+// flush (store → bound filePath)
+// ---------------------------------------------------------------------------
+/**
+ * @brief Writes the store to its bound `filePath`, entries sorted by key.
+ *
+ * @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) {
+        throw new Error("flush() requires a bound filePath. Use createRegistryStore({ filePath }) to bind one.");
+    }
+    const h = resolveHandler(registry, handler);
+    writeFileSync(registry.filePath, h.serialize(sortedEntries(registry)), "utf-8");
+}
+// ---------------------------------------------------------------------------
+// writeTo (store → explicit path)
+// ---------------------------------------------------------------------------
+/**
+ * @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);
+    writeFileSync(filePath, h.serialize(sortedEntries(registry)), "utf-8");
+}
+//# sourceMappingURL=registry.io.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,19 @@
+import type { BaseRegistryEntry } from "./types";
+import type { RegistryStore } from "./registry.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;
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,29 @@
+/**
+ * @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 }));
+}
+/**
+ * @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;
+    if (existed) {
+        registry.store.setState((s) => {
+            const next = { ...s };
+            delete next[key];
+            return next;
+        });
+    }
+    return existed;
+}
+//# sourceMappingURL=registry.mutations.js.map

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

@@ -0,0 +1 @@
+{"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"}