@g3nomaly/core 0.3.0 → 0.3.1

package/dist/installer/sourceRegistry.d.ts

@@ -0,0 +1,59 @@
+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";
+/** What a package's reader found in one checked-out source. */
+export interface SourceEntries<T extends OriginEntry> {
+    /** Entries by key, each with its `origin` filled in */
+    entries: [string, T][];
+    warnings: string[];
+}
+/** Reads the entries one checked-out source offers; each installer supplies its own. */
+export type ReadSource<T extends OriginEntry> = (checkout: SourceCheckout) => Promise<SourceEntries<T>>;
+/** A source that could not be checked out or read, with the reason. */
+export interface FailedSource {
+    name: string;
+    error: string;
+}
+/**
+ * The entries a set of sources offers, one registry store per source, read
+ * from checkouts that 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.
+ */
+export interface SourceRegistry<T extends OriginEntry> {
+    /** Entries by source name, in the order the sources were given */
+    sources: Map<string, RegistryStore<T>>;
+    checkouts: Map<string, SourceCheckout>;
+    warnings: string[];
+    failed: FailedSource[];
+    dispose: () => void;
+}
+/** One entry one source offers. */
+export interface SourceOffer<T extends OriginEntry> {
+    key: string;
+    entry: T;
+}
+/**
+ * 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 projectRoot - Absolute root that local source paths and the `node_modules` lookup start from
+ */
+export declare function loadSourceRegistry<T extends OriginEntry>(sources: readonly RegisteredSource[], projectRoot: string, readSource: ReadSource<T>): Promise<SourceRegistry<T>>;
+/** Every entry of every source, sources in their given order and keys sorted within each. */
+export declare function offers<T extends OriginEntry>(registry: SourceRegistry<T>): SourceOffer<T>[];
+/**
+ * File source for the core install commands: a file at `files[].path` is
+ * copied from `<checkout>/<origin.dir>/<path>` in the checkout of the
+ * entry's source.
+ */
+export declare function entrySource<T extends OriginEntry>(registry: SourceRegistry<T>): EntrySource;
+/** Registry the core install commands take, keyed by entry 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,+DAA+D;AAC/D,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,WAAW;IAClD,uDAAuD;IACvD,OAAO,EAAG,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAA;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,wFAAwF;AACxF,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;AAEvG,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAG,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,WAAW;IACnD,kEAAkE;IAClE,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,mCAAmC;AACnC,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,WAAW;IAChD,GAAG,EAAI,MAAM,CAAA;IACb,KAAK,EAAE,CAAC,CAAA;CACT;AAED;;;;;;;GAOG;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,6FAA6F;AAC7F,wBAAgB,MAAM,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAG3F;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,WAAW,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAO3F;AAED,mEAAmE;AACnE,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,71 @@
+// 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";
+/**
+ * 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 projectRoot - Absolute root that local source paths and the `node_modules` lookup start from
+ */
+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;
+}
+/** Every entry of every source, sources in their given order and keys sorted within each. */
+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 })));
+}
+/**
+ * File source for the core install commands: a file at `files[].path` is
+ * copied from `<checkout>/<origin.dir>/<path>` in the checkout of the
+ * entry's source.
+ */
+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));
+    };
+}
+/** Registry the core install commands take, keyed by entry 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,80 @@
+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`.)
+ */
+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;
+};
+export type FileState = (typeof FileState)[keyof typeof FileState];
+/** What to do with `UserOnly` and `Conflict` files when applying. */
+export declare const ConflictDecision: {
+    readonly Keep: 0;
+    readonly Overwrite: 1;
+};
+export type ConflictDecision = (typeof ConflictDecision)[keyof typeof ConflictDecision];
+/** Classification of one file, produced by `classifyFiles` and consumed by `applyClassifications`. */
+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. */
+export type FileContent = {
+    kind: "copy";
+    sourcePath: string;
+} | {
+    kind: "write";
+    content: string;
+} | null;
+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.
+ */
+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>;
+}
+export interface ApplyOptions {
+    decision: ConflictDecision;
+    force?: boolean;
+    dryRun?: boolean;
+}
+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[];
+}
+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,21 @@
+/**
+ * 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`.)
+ */
+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. */
+export const ConflictDecision = {
+    Keep: 0,
+    Overwrite: 1,
+};
+//# 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;;;;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"}

package/dist/registry/index.d.ts

@@ -0,0 +1,12 @@
+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";
+/**
+ * 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

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

package/dist/registry/index.js

@@ -0,0 +1,12 @@
+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";
+/**
+ * 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

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

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

@@ -0,0 +1,9 @@
+import type { BaseRegistry, BaseRegistryEntry } from "./types";
+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":"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"}

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":"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"}

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

@@ -0,0 +1,22 @@
+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.
+ */
+export declare function loadFrom<T extends BaseRegistryEntry>(registry: RegistryStore<T>, filePath: string): Promise<void>;
+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.
+ *
+ * @throws If 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.
+ */
+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":"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"}

package/dist/registry/registry.io.js

@@ -0,0 +1,78 @@
+import { writeFileSync, readFileSync } from "node:fs";
+import { tsHandler } from "./registry.handlers";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function resolveHandler(registry, override) {
+    return override ?? registry.handler ?? tsHandler;
+}
+function sortedEntries(registry) {
+    return Object.fromEntries(Object.entries(registry.store.state).sort(([a], [b]) => a.localeCompare(b)));
+}
+// ---------------------------------------------------------------------------
+// loadFrom (file → store)
+// ---------------------------------------------------------------------------
+/**
+ * name alias for load() when you want to specify an explicit filePath. Otherwise identical behavior.
+ */
+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.
+// ---------------------------------------------------------------------------
+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)
+// ---------------------------------------------------------------------------
+/**
+ * Flushes the store to its already-bound filePath.
+ * Sorts entries alphabetically for deterministic output.
+ *
+ * @throws If 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)
+// ---------------------------------------------------------------------------
+/**
+ * Writes the store to an explicit path.
+ * Sorts entries alphabetically for deterministic output.
+ * Does not affect the store's bound filePath.
+ */
+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":"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"}

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

@@ -0,0 +1,12 @@
+import type { BaseRegistryEntry } from "./types";
+import type { RegistryStore } from "./registry.store";
+/**
+ * Register or overwrite an entry in the 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.
+ */
+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":"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"}

package/dist/registry/registry.mutations.js

@@ -0,0 +1,22 @@
+/**
+ * Register or overwrite an entry in the 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.
+ */
+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":"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"}

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

@@ -0,0 +1,38 @@
+import type { BaseRegistry, BaseRegistryEntry } from "./types";
+import type { RegistryStore } from "./registry.store";
+/**
+ * Get a single entry by key. Returns undefined if not found.
+ */
+export declare function get<T extends BaseRegistryEntry>(registry: RegistryStore<T>, key: string): T | undefined;
+/**
+ * Check whether a key exists in the store.
+ */
+export declare function has<T extends BaseRegistryEntry>(registry: RegistryStore<T>, key: string): boolean;
+/**
+ * Return all entries as a plain record.
+ */
+export declare function entries<T extends BaseRegistryEntry>(registry: RegistryStore<T>): BaseRegistry<T>;
+/**
+ * Return all registered keys.
+ */
+export declare function keys<T extends BaseRegistryEntry>(registry: RegistryStore<T>): string[];
+/**
+ * Return all entries that match a given version string.
+ */
+export declare function getByVersion<T extends BaseRegistryEntry>(registry: RegistryStore<T>, version: string): BaseRegistry<T>;
+/**
+ * Return the count of registered 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.
+ */
+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.
+ */
+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

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

package/dist/registry/registry.selectors.js

@@ -0,0 +1,61 @@
+/**
+ * Get a single entry by key. Returns undefined if not found.
+ */
+export function get(registry, key) {
+    return registry.store.state[key];
+}
+/**
+ * Check whether a key exists in the store.
+ */
+export function has(registry, key) {
+    return key in registry.store.state;
+}
+/**
+ * Return all entries as a plain record.
+ */
+export function entries(registry) {
+    return registry.store.state;
+}
+/**
+ * Return all registered keys.
+ */
+export function keys(registry) {
+    return Object.keys(registry.store.state);
+}
+/**
+ * Return all entries that match a given version string.
+ */
+export function getByVersion(registry, version) {
+    return Object.fromEntries(Object.entries(registry.store.state).filter(([, entry]) => entry.version === version));
+}
+/**
+ * Return the count of registered 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.
+ */
+export function collectDependencies(key, entries, seen, unknown) {
+    if (seen.has(key))
+        return;
+    const entry = entries[key];
+    if (!entry) {
+        unknown.push(key);
+        return;
+    }
+    seen.add(key);
+    for (const dep of entry.registryDependencies ?? [])
+        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.
+ */
+export function entryDependencies(key, entries, candidates) {
+    return candidates.filter((k) => entries[k]?.registryDependencies?.includes(key) ?? false);
+}
+//# sourceMappingURL=registry.selectors.js.map

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

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

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

@@ -0,0 +1,34 @@
+import { Store } from "@tanstack/store";
+import type { BaseRegistry, BaseRegistryEntry } from "./types";
+import type { RegistryHandler } from "./registry.handlers";
+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.
+ */
+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.
+ *
+ * @example
+ * const registry = createRegistryStore<MyEntry>({ filePath: "/abs/.g3nerate-manifest.ts" })
+ * await load(registry)
+ */
+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.
+ */
+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

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