@asaidimu/utils-artifacts 1.0.0 → 2.0.1

package/index.d.ts

@@ -90,59 +90,6 @@ interface DataStore<T extends object> {
     state(): Readonly<StoreExecutionState<T>>;
 }
 
-/**
- * Represents all errors within the ArtifactContainer system, categorized
- * into "system" (internal structural), "external" (runtime failures),
- * or "cycle" (circular dependencies). This unified error class simplifies
- * error handling and provides clear semantics.
- */
-declare class ArtifactError extends Error {
-    category: "system" | "external";
-    constructor(message: string, category: "system" | "external", cause?: unknown);
-}
-/**
- * Error thrown when a circular dependency is detected during artifact resolution.
- * This indicates a structural problem in the artifact graph.
- */
-declare class CircularDependencyError extends ArtifactError {
-    /**
-     * Creates an instance of CircularDependencyError.
-     * @param path The dependency path that caused the cycle.
-     */
-    constructor(path: string[]);
-}
-/**
- * Error thrown when an artifact requested for resolution is not found
- * within the current container or its parent hierarchy.
- */
-declare class ArtifactNotFoundError extends ArtifactError {
-    /**
-     * Creates an instance of ArtifactNotFoundError.
-     * @param key The key of the artifact that was not found.
-     */
-    constructor(key: string);
-}
-/**
- * Error thrown when an operation is attempted that is not permitted
- * due to the artifact's scope or current state (e.g., calling `yield` on a Transient artifact).
- */
-declare class IllegalScopeError extends ArtifactError {
-    /**
-     * Creates an instance of IllegalScopeError.
-     * @param message A descriptive message about the illegal operation.
-     */
-    constructor(message: string);
-}
-/**
- * Error returned when all a watched instance is disposed
- */
-declare class WatcherDisposedError extends ArtifactError {
-    /**
-     * Creates an instance of IllegalScopeError.
-     * @param message A descriptive message about the illegal operation.
-     */
-    constructor(key: string);
-}
 /**
  * Defines the lifecycle and sharing strategy for an artifact.
  */
@@ -161,50 +108,6 @@ declare enum ArtifactScopes {
     Singleton = "singleton",
     Transient = "transient"
 }
-/**
- * Configuration options for defining an artifact. These options control
- * its lifecycle, instantiation, and error handling behavior.
- */
-interface ArtifactOptions {
-    /**
-     * The scope of the artifact, determining its lifecycle and sharing strategy.
-     * Defaults to `ArtifactScopes.Singleton`.
-     */
-    scope?: ArtifactScope;
-    /**
-     * If `true` (default), the artifact's factory is executed only when the artifact
-     * is first requested. If `false`, the artifact is built immediately upon registration
-     * (only applies to Singleton scopes).
-     */
-    lazy?: boolean;
-    /**
-     * Maximum time in milliseconds allowed for the artifact's factory function
-     * to complete execution. If exceeded, the factory will time out.
-     */
-    timeoutMs?: number;
-    /**
-     * Number of times to retry the artifact's factory on failure due to an
-     * external (runtime) error. SystemErrors are not retried. Defaults to `0`.
-     */
-    retries?: number;
-    /**
-     * Base debounce time in milliseconds for invalidation events originating
-     * from this artifact. This can be overridden by `UseOptions.debounce`.
-     */
-    debounce?: number;
-}
-/**
- * Options that can be applied to dependency resolutions within an artifact's factory,
- * allowing for fine-grained control over how dependencies affect the current artifact.
- */
-interface UseOptions {
-    /**
-     * Applies a specific debounce time in milliseconds to dependencies resolved
-     * within the `use` block. If this value is higher than the artifact's
-     * `baseDebounceMs` (or `activeDebounceMs`), it will be used for subsequent invalidations.
-     */
-    debounce?: number;
-}
 /**
  * Represents a snapshot of an artifact's state and dependencies for debugging purposes.
  * Provides insight into the artifact's current status and its position within the dependency graph.
@@ -259,6 +162,11 @@ interface UseDependencyContext<TRegistry extends Record<string, any>, TState ext
      */
     select<S>(selector: (state: TState) => S): S;
 }
+type ArtifactStreamContext<TArtifact> = {
+    value: TArtifact | undefined;
+    signal: AbortSignal;
+    emit: (value: TArtifact) => Promise<void>;
+};
 /**
  * The full context provided to an artifact's factory function.
  * This context allows the artifact to interact with the container,
@@ -289,7 +197,7 @@ interface ArtifactFactoryContext<TRegistry extends Record<string, any>, TState e
      * @param options Optional settings for this dependency block, like debounce.
      * @returns A Promise resolving to the result of the callback.
      */
-    use<R>(callback: (ctx: UseDependencyContext<TRegistry, TState>) => R | Promise<R>, options?: UseOptions): Promise<R>;
+    use<R>(callback: (ctx: UseDependencyContext<TRegistry, TState>) => R | Promise<R>): Promise<R>;
     /**
      * Registers a cleanup function to be executed when the artifact is
      * invalidated and before its new instance is built. This is useful
@@ -313,7 +221,7 @@ interface ArtifactFactoryContext<TRegistry extends Record<string, any>, TState e
      * @throws {SystemError} if called on a Transient artifact, as Transient artifacts
      *         do not maintain a persistent value.
      */
-    yield(value: TArtifact): void;
+    stream(callback: (ctx: ArtifactStreamContext<TArtifact>) => void | Promise<void>): void;
 }
 /**
  * A function that performs cleanup logic for an artifact, potentially asynchronously.
@@ -363,7 +271,7 @@ type ArtifactFactory<TRegistry extends Record<string, any>, TState extends objec
  * Provides a way to get the current resolved artifact and subscribe to updates.
  * @template TArtifact The type of the artifact being watched.
  */
-interface ArtifactWatcher<TArtifact> {
+interface ArtifactObserver<TArtifact> {
     /** The unique identifier (key) of the artifact being watched. */
     id: string;
     /**
@@ -382,7 +290,7 @@ interface ArtifactWatcher<TArtifact> {
      * @param callback The function to call on updates.
      * @returns A function to unsubscribe the callback.
      */
-    subscribe(callback: () => void): () => void;
+    subscribe(callback: (artifact: ResolvedArtifact<TArtifact>) => void): () => void;
     /**
      * Disposes of this watcher reference, decrementing the reference count.
      * When the count reaches zero, cleans up all associated resources.
@@ -396,218 +304,154 @@ interface ArtifactWatcher<TArtifact> {
  * depends on another or is depended upon by another, potentially across
  * different `ArtifactContainer` instances (e.g., parent/child containers).
  */
-interface DependencyLink {
+interface DependencyLink<T> {
     /** The key of the artifact involved in the dependency. */
     key: string;
     /** The `ArtifactContainer` instance that owns the linked artifact. */
-    container: ArtifactContainer<any, any>;
+    container: T;
 }
+/**
+ * Configuration options for defining an artifact. These options control
+ * its lifecycle, instantiation, and error handling behavior.
+ */
+interface ArtifactTemplate<TRegistry extends Record<string, any>, TState extends object, K extends keyof TRegistry> {
+    /** The unique key identifying this artifact. */
+    key: K;
+    /** The factory function responsible for creating the artifact's instance. */
+    factory: ArtifactFactory<TRegistry, TState, K>;
+    /**
+     * The scope of the artifact, determining its lifecycle and sharing strategy.
+     * Defaults to `ArtifactScopes.Singleton`.
+     */
+    scope?: ArtifactScope;
+    /**
+     * If `true` (default), the artifact's factory is executed only when the artifact
+     * is first requested. If `false`, the artifact is built immediately upon registration
+     * (only applies to Singleton scopes).
+     */
+    lazy?: boolean;
+    /**
+     * Maximum time in milliseconds allowed for the artifact's factory function
+     * to complete execution. If exceeded, the factory will time out.
+     */
+    timeout?: number;
+    /**
+     * Number of times to retry the artifact's factory on failure due to an
+     * external (runtime) error. SystemErrors are not retried. Defaults to `0`.
+     */
+    retries?: number;
+    /**
+     * Base debounce time in milliseconds for invalidation events originating
+     * from this artifact. This can be overridden by `UseOptions.debounce`.
+     */
+    debounce?: number;
+}
+
 /**
  * A dependency injection container for managing the lifecycle, dependencies,
  * and instances of "artifacts" (any JavaScript/TypeScript object or value).
- * It supports hierarchical containers, different scopes (singleton, transient),
- * dependency resolution, state-based invalidation, and debounced rebuilding.
  *
- * @template TRegistry A type that maps artifact keys (strings) to their
- *                     corresponding artifact types. This provides strong
- *                     typing for `resolve`, `register`, and other operations.
- * @template TState The type of the global state object that artifacts can depend on.
+ * Refactored to separate concerns:
+ * - ArtifactRegistry: Stores artifact templates (factories + options)
+ * - ArtifactCache: Stores resolved singleton instances
+ * - ArtifactDependencyGraph: Tracks artifact dependencies using DependencyGraph
+ * - ArtifactManager: Handles lifecycle (build, invalidate, dispose)
+ * - ArtifactObserver: Manages watchers and subscriptions
+ *
+ * @template TRegistry A type that maps artifact keys to their types
+ * @template TState The type of the global state object
  */
 declare class ArtifactContainer<TRegistry extends Record<string, any> = Record<string, any>, TState extends object = any> {
-    private readonly artifacts;
-    private readonly resolvingStack;
-    private readonly listeners;
-    private readonly watcherCache;
-    private readonly props;
-    private readonly parent?;
-    private isDisposed;
-    private resolvedArtifacts;
+    private readonly registry;
+    private readonly cache;
+    private readonly graph;
+    private readonly manager;
+    private readonly observer;
+    private readonly store;
     /**
      * Creates a new ArtifactContainer instance.
-     * @param props An object providing functions to interact with a global data store,
-     *              specifically `watch` for state changes and `get` for current state.
-     * @param parent An optional parent `ArtifactContainer`. If provided, this container
-     *               can resolve artifacts registered in its parent.
-     */
-    constructor(store: Pick<DataStore<TState>, "watch" | "get">, parent?: ArtifactContainer<TRegistry, TState>);
-    /**
-     * Creates a new child `ArtifactContainer` that inherits from the current container.
-     * Child containers can resolve artifacts registered in their parent, but
-     * artifacts registered in the child are local to that child.
-     * @returns A new `ArtifactContainer` instance.
+     *
+     * @param store An object providing functions to interact with a global data store
      */
-    createChild(): ArtifactContainer<TRegistry, TState>;
+    constructor(store: Pick<DataStore<TState>, "watch" | "get">);
     /**
      * Provides debug information about all artifacts currently registered in this container.
-     * This is useful for inspecting the state, scope, dependencies, and activity of artifacts.
-     * @returns An array of `ArtifactDebugNode` objects, each representing a registered artifact.
+     *
+     * @returns An array of ArtifactDebugNode objects
      */
-    getDebugInfo(): ArtifactDebugNode[];
+    debugInfo(): ArtifactDebugNode[];
     /**
      * Registers a new artifact with the container.
      * If an artifact with the same key already exists, it will be overwritten and disposed.
      * For Singleton, non-lazy artifacts, the factory will be immediately invoked.
-     * @template K The key of the artifact to register.
-     * @param {object} params The registration parameters.
-     * @param {K} params.key The unique identifier for the artifact.
-     * @param {ArtifactFactory<TRegistry, TState, K>} params.factory The function that creates the artifact instance.
-     * @param {ArtifactOptions} params.options Optional configuration for the artifact's lifecycle.
-     * @returns A cleanup function that, when called, unregisters the artifact.
-     */
-    register<K extends keyof TRegistry>({ key, factory, ...options }: {
-        key: K;
-        factory: ArtifactFactory<TRegistry, TState, K>;
-    } & ArtifactOptions): () => void;
+     *
+     * @param params The registration parameters
+     * @returns A cleanup function that unregisters the artifact
+     */
+    register<K extends keyof TRegistry>(params: ArtifactTemplate<TRegistry, TState, K>): () => void;
     /**
      * Unregisters an artifact from the container, disposing of its current instance
      * and removing all associated resources and dependency links.
-     * @template K The key of the artifact to unregister.
-     * @param key The unique identifier of the artifact.
-     * @returns A Promise that resolves when the artifact has been fully unregistered and disposed.
+     *
+     * @param key The unique identifier of the artifact
      */
     unregister<K extends keyof TRegistry>(key: K): Promise<void>;
     /**
      * Resolves an artifact by its key, returning its instance or an error.
-     * This method handles dependency resolution, cycle detection, caching,
-     * and retry logic. It traverses the container hierarchy if the artifact
+     * This method handles dependency resolution, cycle detection (via graph),
+     * caching, and retry logic. Traverses the container hierarchy if the artifact
      * is not found locally.
-     * @template K The key of the artifact to resolve.
-     * @param key The unique identifier for the artifact.
-     * @returns A Promise that resolves to a `ResolvedArtifact`. This object
-     *          will contain either the `instance` (if successful) or an `error`
-     *          (if an external error occurred during factory execution).
-     * @throws {CircularDependencyError} if a circular dependency is detected during resolution.
-     * @throws {ArtifactNotFoundError} if the artifact with the given key is not found
-     *                                  in the current container or any parent containers.
-     * @throws {SystemError} for any other critical structural or configuration issues.
+     *
+     * @param key The unique identifier for the artifact
+     * @returns A Promise that resolves to a ResolvedArtifact
+     * @throws {ArtifactNotFoundError} if the artifact is not found
+     * @throws {ArtifactError} if a cycle is detected or other system errors occur
      */
     resolve<K extends keyof TRegistry>(key: K): Promise<ResolvedArtifact<TRegistry[K]>>;
     /**
-     * Returns an `ArtifactWatcher` for a given artifact key.
-     * The watcher allows subscribing to changes in the artifact's resolved value
-     * @template K The key of the artifact to watch.
-     * @param key The unique identifier for the artifact.
-     * @returns An `ArtifactWatcher` instance.
+     * Returns an ArtifactWatcher for a given artifact key.
+     * The watcher allows subscribing to changes in the artifact's resolved value.
+     *
+     * @param key The unique identifier for the artifact
+     * @returns An ArtifactWatcher instance
      */
-    watch<K extends keyof TRegistry>(key: K): ArtifactWatcher<TRegistry[K]>;
+    watch<K extends keyof TRegistry>(key: K): ArtifactObserver<TRegistry[K]>;
     /**
      * Peeks at the resolved instance of an artifact without triggering its resolution
-     * if it's lazy, or registering a dependency. It simply returns the currently
-     * available instance (if any).
-     * @template K The key of the artifact to peek at.
-     * @param key The unique identifier for the artifact.
-     * @returns The artifact instance if it's already built, otherwise `undefined`.
+     * if it's lazy, or registering a dependency.
+     *
+     * @param key The unique identifier for the artifact
+     * @returns The artifact instance if it's already built, otherwise undefined
      */
     peek<K extends keyof TRegistry>(key: K): TRegistry[K] | undefined;
-    private findDefinition;
-    /**
-     * Packages an `ArtifactDefinition` into a `ResolvedArtifact` for public consumption.
-     * This abstracts away internal details and provides the external API for interacting
-     * with a resolved artifact (e.g., `invalidate`).
-     * @template T The expected type of the artifact instance.
-     * @param def The internal `ArtifactDefinition`.
-     * @returns A `ResolvedArtifact` object.
-     */
-    private packageArtifact;
-    /**
-     * Core logic for executing an artifact's factory and capturing its dependencies.
-     * This method is responsible for setting up the factory context, running the
-     * factory (with retries and timeouts), and collecting all declared dependencies
-     * (both artifact and state).
-     * @template K The key of the artifact being created.
-     * @param def The `ArtifactDefinition` for the artifact.
-     * @param outArtifactDeps A Set to capture discovered artifact dependencies.
-     * @param outStateDeps A Set to capture discovered state dependencies.
-     * @returns A Promise resolving to an object containing the instance, cleanup function, and any external error.
-     * @throws {SystemError} if a critical internal error occurs (e.g., circular dependency detected).
-     */
-    private createArtifactInstance;
-    /**
-     * Handles the propagation of a `yield` event from a Singleton artifact.
-     * This involves invalidating all direct dependents and notifying any listeners.
-     * @param key The key of the artifact that yielded a new value.
-     */
-    private processYieldPropagation;
-    /**
-     * Registers a dependency from a `dependent` artifact on a `target` artifact.
-     * This builds the inverse dependency graph, allowing for efficient cascade invalidations.
-     * This method is public so that child containers can register dependents on artifacts
-     * owned by a parent container.
-     * @param targetKey The key of the artifact being depended upon.
-     * @param dependentKey The key of the artifact that depends on the target.
-     * @param dependentContainer The container instance where the dependent artifact is registered.
-     */
-    registerDependent(targetKey: string, dependentKey: string, dependentContainer: ArtifactContainer<any, any>): void;
-    /**
-     * Removes a previously registered dependency link.
-     * This method is public so that child containers can remove dependents on artifacts
-     * owned by a parent container when their artifacts are disposed.
-     * @param targetKey The key of the artifact that was depended upon.
-     * @param dependentKey The key of the artifact that previously depended on the target.
-     * @param dependentContainer The container instance where the dependent artifact was registered.
-     */
-    removeDependent(targetKey: string, dependentKey: string, dependentContainer: ArtifactContainer<any, any>): void;
-    /**
-     * Initiates the invalidation process for an artifact, potentially debouncing the rebuild.
-     * Invalidation marks an artifact as needing to be rebuilt on its next resolution.
-     * @template K The key of the artifact to invalidate.
-     * @param key The unique identifier for the artifact.
-     * @param replace If `true`, bypasses debouncing and forces an immediate execution of `executeInvalidation`.
-     * @returns A Promise that resolves when the invalidation (and potential debounced rebuild) is complete.
-     */
-    private invalidate;
-    /**
-     * Executes the actual invalidation and rebuild logic for an artifact.
-     * This includes disposing the old instance, invalidating dependents, and (optionally) resolving a new instance.
-     * @template K The key of the artifact to invalidate.
-     * @param key The unique identifier for the artifact.
-     * @param replace If `true`, forces immediate disposal and rebuild without waiting for existing rebuild promises.
-     * @returns A Promise that resolves when the invalidation and rebuild process is complete.
-     */
-    private executeInvalidation;
-    /**
-     * Disposes of an artifact's instance by running its cleanup and dispose functions,
-     * unsubscribing from state changes, and clearing its cached instance and error.
-     * This prepares the artifact for a rebuild or removal.
-     * @param def The `ArtifactDefinition` of the instance to dispose.
-     */
-    private disposeInstance;
-    /**
-     * Fully disposes of an artifact, including its instance and all its associated
-     * dependency graph links and resources. This is typically called when an artifact
-     * is unregistered or the container itself is disposed.
-     * @param key The unique identifier of the artifact to dispose.
-     */
-    private disposeArtifact;
-    /**
-     * Updates the dependency graph for an artifact based on newly discovered dependencies
-     * during its factory execution. This involves adding and removing dependent links,
-     * and setting up or tearing down state subscriptions.
-     * @param def The `ArtifactDefinition` whose graph is being updated.
-     * @param newArtifactDeps The set of artifact dependencies discovered during the latest build.
-     * @param newStateDeps The set of state path dependencies discovered during the latest build.
-     */
-    private updateGraph;
-    /**
-     * Creates a single composite cleanup function from an array of individual cleanup functions.
-     * The composite function executes all provided cleanups in reverse order of registration,
-     * ensuring proper resource release, and handles potential asynchronous cleanups.
-     * @param fns An array of `ArtifactCleanup` functions.
-     * @returns A composite `ArtifactCleanup` function, or `undefined` if the array is empty.
-     */
-    private createCompositeCleanup;
-    /**
-     * Notifies all registered listeners (watchers) for a specific artifact that
-     * its state (instance or error) has potentially changed.
-     * @param key The key of the artifact whose listeners should be notified.
-     */
-    private notifyListeners;
-    /**
-     * Disposes of the entire `ArtifactContainer` and all artifacts registered within it.
+    /**
+     * Invalidates an artifact, triggering rebuild and cascade to dependents.
+     *
+     * @param key The artifact key to invalidate
+     * @param replace If true, forces immediate rebuild bypassing debounce
+     */
+    invalidate<K extends keyof TRegistry>(key: K, replace?: boolean): Promise<void>;
+    /**
+     * Notifies observers that an artifact has changed.
+     * Called by ArtifactManager during stream propagation.
+     *
+     * @param key The artifact key
+     */
+    notifyObservers(key: string): void;
+    /**
+     * Checks if an artifact has active watchers.
+     * Called by ArtifactManager to determine if lazy artifacts should rebuild.
+     *
+     * @param key The artifact key
+     * @returns True if the artifact has active watchers
+     */
+    hasWatchers(key: string): boolean;
+    /**
+     * Disposes of the entire ArtifactContainer and all artifacts registered within it.
      * This releases all resources, stops all watchers, and clears all internal state.
      * After disposal, the container should no longer be used.
      */
     dispose(): void;
 }
 
-export { type ArtifactCleanup, ArtifactContainer, type ArtifactDebugNode, ArtifactError, type ArtifactFactory, type ArtifactFactoryContext, ArtifactNotFoundError, type ArtifactOptions, type ArtifactScope, ArtifactScopes, type ArtifactWatcher, CircularDependencyError, type DependencyLink, IllegalScopeError, type ResolvedArtifact, type UseDependencyContext, type UseOptions, WatcherDisposedError };
+export { type ArtifactCleanup, ArtifactContainer, type ArtifactDebugNode, type ArtifactFactory, type ArtifactFactoryContext, type ArtifactObserver, type ArtifactScope, ArtifactScopes, type ArtifactStreamContext, type ArtifactTemplate, type DependencyLink, type ResolvedArtifact, type UseDependencyContext };

package/index.js

@@ -1 +1 @@
-"use strict";var e,t,r=Object.create,n=Object.defineProperty,i=Object.getOwnPropertyDescriptor,s=Object.getOwnPropertyNames,a=Object.getPrototypeOf,o=Object.prototype.hasOwnProperty,c=(e={"src/store/node_modules/@asaidimu/events/index.js"(e,t){var r,n=Object.defineProperty,i=Object.getOwnPropertyDescriptor,s=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,o={};((e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})})(o,{createEventBus:()=>c}),t.exports=(r=o,((e,t,r,o)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of s(t))a.call(e,c)||c===r||n(e,c,{get:()=>t[c],enumerable:!(o=i(t,c))||o.enumerable});return e})(n({},"__esModule",{value:!0}),r));var c=(e={async:!1,batchSize:1e3,batchDelay:16,errorHandler:e=>console.error("EventBus Error:",e),crossTab:!1,channelName:"event-bus-channel"})=>{const t=new Map;let r=[],n=0,i=0;const s=new Map,a=new Map;let o=null;e.crossTab&&"undefined"!=typeof BroadcastChannel?o=new BroadcastChannel(e.channelName):e.crossTab&&console.warn("BroadcastChannel is not supported in this browser. Cross-tab notifications are disabled.");const c=(e,t)=>{n++,i+=t,s.set(e,(s.get(e)||0)+1)},l=()=>{const t=r;r=[],t.forEach((({name:t,payload:r})=>{const n=performance.now();try{(a.get(t)||[]).forEach((e=>e(r)))}catch(n){e.errorHandler({...n,eventName:t,payload:r})}c(t,performance.now()-n)}))},d=(()=>{let t;return()=>{clearTimeout(t),t=setTimeout(l,e.batchDelay)}})(),p=e=>{const r=t.get(e);r?a.set(e,Array.from(r)):a.delete(e)};return o&&(o.onmessage=e=>{const{name:t,payload:r}=e.data;(a.get(t)||[]).forEach((e=>e(r)))}),{subscribe:(e,r)=>{t.has(e)||t.set(e,new Set);const n=t.get(e);return n.add(r),p(e),()=>{n.delete(r),0===n.size?(t.delete(e),a.delete(e)):p(e)}},emit:({name:t,payload:n})=>{if(e.async)return r.push({name:t,payload:n}),r.length>=e.batchSize?l():d(),void(o&&o.postMessage({name:t,payload:n}));const i=performance.now();try{(a.get(t)||[]).forEach((e=>e(n))),o&&o.postMessage({name:t,payload:n})}catch(r){e.errorHandler({...r,eventName:t,payload:n})}c(t,performance.now()-i)},getMetrics:()=>({totalEvents:n,activeSubscriptions:Array.from(t.values()).reduce(((e,t)=>e+t.size),0),eventCounts:s,averageEmitDuration:n>0?i/n:0}),clear:()=>{t.clear(),a.clear(),r=[],n=0,i=0,s.clear(),o&&(o.close(),o=null)}}}}},function(){return t||(0,e[s(e)[0]])((t={exports:{}}).exports,t),t.exports});((e,t,c)=>{c=null!=e?r(a(e)):{},((e,t,r,a)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of s(t))o.call(e,c)||c===r||n(e,c,{get:()=>t[c],enumerable:!(a=i(t,c))||a.enumerable})})(e&&e.__esModule?c:n(c,"default",{value:e,enumerable:!0}),e)})(c());var l=class e extends Error{category;constructor(t,r,n){super(t,{cause:n}),this.name="ArtifactError",this.category=r,Object.setPrototypeOf(this,e.prototype)}},d=class extends l{constructor(e){super(`[ArtifactContainer] Cycle detected: ${e.join(" -> ")}`,"system")}},p=class extends l{constructor(e){super(`[ArtifactContainer] Artifact "${e}" not found.`,"system")}},u=class extends l{constructor(e){super(`[ArtifactContainer] Artifact ${e} has already been disposed`,"system")}},h=(e=>(e.Singleton="singleton",e.Transient="transient",e))(h||{});exports.ArtifactContainer=class e{artifacts=new Map;resolvingStack=[];listeners=new Map;watcherCache=new Map;props;parent;isDisposed=!1;resolvedArtifacts=new Map;constructor(e,t){this.props={watch:(...t)=>e.watch(...t),get:()=>e.get(!0)},this.parent=t}createChild(){return new e(this.props,this)}getDebugInfo(){const e=[];return this.artifacts.forEach(((t,r)=>{e.push({id:r,scope:t.scope,status:t.initializationPromise||t.rebuildPromise?"pending":t.error?"error":t.instance?"active":"idle",dependencies:Array.from(t.artifactDependencies).map((e=>e.key)),dependents:Array.from(t.dependents).map((e=>e.key)),stateDependencies:Array.from(t.stateDependencies),renderCount:t.buildCount})})),e}register({key:e,factory:t,...r}){const n=e;this.artifacts.has(n)&&(console.warn(`[ArtifactContainer] Overwriting "${n}".`),this.disposeArtifact(n));const i={key:e,factory:t,scope:r.scope??"singleton",lazy:r.lazy??!0,timeoutMs:r.timeoutMs,retries:r.retries??0,baseDebounceMs:r.debounce??0,activeDebounceMs:r.debounce??0,isInvalidationScheduled:!1,cleanupFunctions:[],disposeFunctions:[],stateDependencies:new Set,artifactDependencies:new Set,dependents:new Set,buildCount:0};return this.artifacts.set(n,i),i.lazy||"singleton"!==i.scope||this.resolve(e).catch((e=>{console.error(`[ArtifactContainer] Eager load failed for "${n}":`,e)})),()=>this.unregister(e)}async unregister(e){const t=e;this.artifacts.has(t)&&(await this.disposeArtifact(t),this.artifacts.delete(t))}async resolve(e){const t=e,{def:r,container:n}=this.findDefinition(t)||{};if(!r||!n){if(this.parent)return this.parent.resolve(e);throw new p(t)}if("singleton"===r.scope&&r.initializationPromise){try{await r.initializationPromise}catch(e){}finally{r.initializationPromise=void 0}return this.packageArtifact(r)}if(this.resolvingStack.includes(t))throw new d([...this.resolvingStack,t]);if(n!==this)return n.resolve(e);const i="transient"===r.scope?(new Date).toISOString():e;this.resolvingStack.push(i);try{if("transient"===r.scope){const e=await this.createArtifactInstance(r,new Set,new Set);return{instance:e.instance,cleanup:e.cleanup,error:e.error,ready:!0,invalidate:async()=>console.warn(`[ArtifactContainer] Cannot invalidate transient "${t}"`)}}if(void 0!==r.instance||void 0!==r.error)return this.packageArtifact(r);const e=(async()=>{try{const e=new Set,t=new Set,n=await this.createArtifactInstance(r,e,t);this.updateGraph(r,e,t),n.error?r.error=n.error:r.instance=n.instance}catch(e){if(e instanceof l)throw e;r.error=e}finally{r.initializationPromise=void 0}})();return r.initializationPromise=e,await e,this.packageArtifact(r)}finally{this.resolvingStack.pop()}}watch(e){const t=e,r=this.findDefinition(t);if(!r){if(this.parent)return this.parent.watch(e);throw new p(t)}const{def:n,container:i}=r;if(i!==this)return i.watch(e);let s=t;if("transient"===n.scope&&(s=`${t}__watched`),this.watcherCache.has(s)){const e=this.watcherCache.get(s);return e.count++,e}"transient"!==n.scope||this.findDefinition(s)||this.register({key:s,factory:n.factory,scope:"singleton",lazy:n.lazy,timeoutMs:n.timeoutMs,retries:n.retries,debounce:n.baseDebounceMs});let a=!1;const o={id:t,count:1,get:()=>{const e=this.artifacts.get(s);if(!e)throw new p(s);const r=this.packageArtifact(e);return a&&(r.ready=!1,r.instance=void 0,r.invalidate=e=>Promise.resolve(),r.cleanup=()=>{},r.error=new u(t)),r},subscribe:e=>this.isDisposed?()=>{}:(this.listeners.has(s)||this.listeners.set(s,new Set),this.listeners.get(s).add(e),this.resolve(s).catch((e=>{console.error(`[ArtifactContainer] Background resolution failed for "${s}":`,e)})).then((()=>e())),()=>this.listeners.get(s)?.delete(e)),dispose:async()=>{o.count--,o.count<=0&&(this.watcherCache.delete(s),"transient"===n.scope&&await this.unregister(s),a=!0,this.notifyListeners(s),this.listeners.delete(s))}};return this.watcherCache.set(s,o),o}peek(e){return this.artifacts.get(e)?.instance??this.parent?.peek(e)}findDefinition(e){return this.artifacts.has(e)?{def:this.artifacts.get(e),container:this}:this.parent?this.parent.findDefinition(e):null}packageArtifact(e){const t=this.resolvedArtifacts.get(e.key),r=(t,r=!1)=>(t.instance=e.instance,t.cleanup=this.createCompositeCleanup(e.cleanupFunctions),t.error=e.error,t.ready=void 0===e.initializationPromise,t.invalidate=async t=>this.invalidate(e.key,t),r&&this.resolvedArtifacts.set(e.key,t),t);return t?r(t):r({},"singleton"===e.scope)}async createArtifactInstance(e,t,r){e.buildCount++;const n=[],i=[];let s=!0;e.activeDebounceMs=e.baseDebounceMs,n.push((()=>{s=!1}));const a={state:(...e)=>this.props.get(...e),current:e.instance,onCleanup:e=>n.push(e),onDispose:e=>i.push(e),use:async(n,i)=>(i?.debounce&&i.debounce>e.activeDebounceMs&&(e.activeDebounceMs=i.debounce),n({resolve:async r=>{if(r===e.key)throw new l(`Artifact "${String(e.key)}" depends on itself.`,"system");const n=this.findDefinition(r);return n&&(t.add({key:r,container:n.container}),n.container.registerDependent(r,e.key,this)),this.resolve(r)},select:e=>(function(e,t="."){const r=new Set,n=(e=[])=>new Proxy({},{get:(i,s)=>{if("symbol"==typeof s)return;const a=[...e,s],o=a.join(t);return r.add(o),n(a)}});try{e(n())}catch(e){throw new Error(`Selector failed during path analysis. This usually means the selector is too complex. Selectors must be simple property accessors only. Error: ${e instanceof Error?e.message:String(e)}`)}const i=Array.from(r);return i.filter((e=>!i.some((r=>r!==e&&r.startsWith(e+t)))))}(e).forEach((e=>r.add(e))),e(this.props.get()))})),yield:t=>{queueMicrotask((()=>{s&&("transient"!==e.scope?(e.instance=t,e.error=void 0,this.processYieldPropagation(e.key)):console.error(`[ArtifactContainer] Illegal yield on transient artifact "${String(e.key)}"`))}))}};let o,c,d=0;const p=(e.retries||0)+1;for(;d<p;)try{const t=e.factory(a);if(e.timeoutMs){const r=new Promise(((t,r)=>setTimeout((()=>r(new Error(`Timeout: ${e.timeoutMs}ms`))),e.timeoutMs)));o=await Promise.race([t,r])}else o=await t;break}catch(e){if(e instanceof l)throw e;d++,d>=p&&(c=e)}return"singleton"===e.scope&&(e.cleanupFunctions=n,e.disposeFunctions=i),{instance:o,cleanup:this.createCompositeCleanup(n),error:c}}async processYieldPropagation(e){const t=this.artifacts.get(e);if(t)try{await Promise.all(Array.from(t.dependents).map((e=>e.container.invalidate(e.key,!1).catch((t=>{console.error(`[ArtifactContainer] Failed to invalidate dependent "${e.key}":`,t)}))))),this.notifyListeners(e)}catch(t){console.error(`[ArtifactContainer] Yield propagation error "${e}":`,t)}}registerDependent(e,t,r){const n=this.artifacts.get(e);n&&n.dependents.add({key:t,container:r})}removeDependent(e,t,r){const n=this.artifacts.get(e);if(n)for(const e of n.dependents)if(e.key===t&&e.container===r){n.dependents.delete(e);break}}async invalidate(e,t=!1){const r=e,n=this.artifacts.get(r);if(n){if(n.debounceTimer&&(clearTimeout(n.debounceTimer),n.debounceTimer=void 0,n.isInvalidationScheduled=!1),!t&&n.activeDebounceMs>0&&!n.isInvalidationScheduled){n.isInvalidationScheduled=!0;const r=new Promise((r=>{n.debounceTimer=setTimeout((()=>{n.debounceTimer=void 0,n.isInvalidationScheduled=!1,this.executeInvalidation(e,t).then(r).catch(r)}),n.activeDebounceMs)}));return n.rebuildPromise=r,r}return t&&n.isInvalidationScheduled&&(n.isInvalidationScheduled=!1),this.executeInvalidation(e,t)}}async executeInvalidation(e,t){const r=e,n=this.artifacts.get(r);if(!n)return;if(n.initializationPromise)try{await n.initializationPromise}catch{}if(n.rebuildPromise&&!n.debounceTimer&&!t)return n.rebuildPromise;const i=(async()=>{try{await Promise.all(Array.from(n.dependents).map((e=>e.container.invalidate(e.key,t).catch((t=>{console.error(`[ArtifactContainer] Cascade failed for "${e.key}":`,t)}))))),await this.disposeInstance(n,!1),(t||!n.lazy||this.watcherCache.has(r))&&(await this.resolve(e),this.notifyListeners(r))}finally{n.rebuildPromise=void 0}})();return n.rebuildPromise=i,i}async disposeInstance(e,t=!0){e.stateSubscriptionCleanup&&(e.stateSubscriptionCleanup(),e.stateSubscriptionCleanup=void 0),e.debounceTimer&&(clearTimeout(e.debounceTimer),e.debounceTimer=void 0);for(let t=e.disposeFunctions.length-1;t>=0;t--)try{await e.disposeFunctions[t]()}catch(e){console.error(e)}for(let t=e.cleanupFunctions.length-1;t>=0;t--)try{await e.cleanupFunctions[t]()}catch(e){console.error(e)}e.instance=void 0,e.error=void 0,e.cleanupFunctions=[],e.disposeFunctions=[],e.initializationPromise=void 0,this.resolvedArtifacts.get(e.key)&&this.resolvedArtifacts.delete(e.key),t&&this.notifyListeners(e.key)}async disposeArtifact(e){const t=this.artifacts.get(e);t&&(this.watcherCache.delete(e),t.rebuildPromise&&await t.rebuildPromise,await this.disposeInstance(t),t.artifactDependencies.forEach((t=>{t.container.removeDependent(t.key,e,this)})))}updateGraph(e,t,r){e.artifactDependencies.forEach((r=>{let n=!1;for(const e of t)if(e.key===r.key&&e.container===r.container){n=!0;break}n||r.container.removeDependent(r.key,e.key,this)})),t.forEach((t=>{t.container.registerDependent(t.key,e.key,this)})),e.artifactDependencies=t,e.stateSubscriptionCleanup&&e.stateSubscriptionCleanup(),e.stateDependencies=r,r.size>0?e.stateSubscriptionCleanup=this.props.watch(Array.from(r),(()=>this.invalidate(e.key,!1))):e.stateSubscriptionCleanup=void 0,this.notifyListeners(e.key)}createCompositeCleanup(e){if(e.length)return async()=>{for(let t=e.length-1;t>=0;t--)try{await e[t]()}catch(e){console.error(e)}}}notifyListeners(e){const t=this.listeners.get(e);t&&t.forEach((t=>{try{t()}catch(t){console.error(`[ArtifactContainer] Listener error for "${e}":`,t)}}))}dispose(){this.isDisposed=!0,this.artifacts.forEach(((e,t)=>this.disposeArtifact(t))),this.artifacts.clear(),this.watcherCache.clear(),this.listeners.clear()}},exports.ArtifactError=l,exports.ArtifactNotFoundError=p,exports.ArtifactScopes=h,exports.CircularDependencyError=d,exports.IllegalScopeError=class extends l{constructor(e){super(`[ArtifactContainer] ${e}`,"system")}},exports.WatcherDisposedError=u;
+"use strict";var e,t,r=Object.create,s=Object.defineProperty,n=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,a=Object.getPrototypeOf,o=Object.prototype.hasOwnProperty,c=(e={"src/store/node_modules/@asaidimu/events/index.js"(e,t){var r,s=Object.defineProperty,n=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,a=Object.prototype.hasOwnProperty,o={};((e,t)=>{for(var r in t)s(e,r,{get:t[r],enumerable:!0})})(o,{createEventBus:()=>c}),t.exports=(r=o,((e,t,r,o)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of i(t))a.call(e,c)||c===r||s(e,c,{get:()=>t[c],enumerable:!(o=n(t,c))||o.enumerable});return e})(s({},"__esModule",{value:!0}),r));var c=(e={async:!1,batchSize:1e3,batchDelay:16,errorHandler:e=>console.error("EventBus Error:",e),crossTab:!1,channelName:"event-bus-channel"})=>{const t=new Map;let r=[],s=0,n=0;const i=new Map,a=new Map;let o=null;e.crossTab&&"undefined"!=typeof BroadcastChannel?o=new BroadcastChannel(e.channelName):e.crossTab&&console.warn("BroadcastChannel is not supported in this browser. Cross-tab notifications are disabled.");const c=(e,t)=>{s++,n+=t,i.set(e,(i.get(e)||0)+1)},h=()=>{const t=r;r=[],t.forEach((({name:t,payload:r})=>{const s=performance.now();try{(a.get(t)||[]).forEach((e=>e(r)))}catch(s){e.errorHandler({...s,eventName:t,payload:r})}c(t,performance.now()-s)}))},d=(()=>{let t;return()=>{clearTimeout(t),t=setTimeout(h,e.batchDelay)}})(),l=e=>{const r=t.get(e);r?a.set(e,Array.from(r)):a.delete(e)};return o&&(o.onmessage=e=>{const{name:t,payload:r}=e.data;(a.get(t)||[]).forEach((e=>e(r)))}),{subscribe:(e,r)=>{t.has(e)||t.set(e,new Set);const s=t.get(e);return s.add(r),l(e),()=>{s.delete(r),0===s.size?(t.delete(e),a.delete(e)):l(e)}},emit:({name:t,payload:s})=>{if(e.async)return r.push({name:t,payload:s}),r.length>=e.batchSize?h():d(),void(o&&o.postMessage({name:t,payload:s}));const n=performance.now();try{(a.get(t)||[]).forEach((e=>e(s))),o&&o.postMessage({name:t,payload:s})}catch(r){e.errorHandler({...r,eventName:t,payload:s})}c(t,performance.now()-n)},getMetrics:()=>({totalEvents:s,activeSubscriptions:Array.from(t.values()).reduce(((e,t)=>e+t.size),0),eventCounts:i,averageEmitDuration:s>0?n/s:0}),clear:()=>{t.clear(),a.clear(),r=[],s=0,n=0,i.clear(),o&&(o.close(),o=null)}}}}},function(){return t||(0,e[i(e)[0]])((t={exports:{}}).exports,t),t.exports}),h=(e=>(e.Singleton="singleton",e.Transient="transient",e))(h||{}),d=class e extends Error{category;constructor(t,r,s){super(t,{cause:s}),this.name="ArtifactError",this.category=r,Object.setPrototypeOf(this,e.prototype)}},l=class extends d{constructor(e){super(`[ArtifactContainer] Artifact "${e}" not found.`,"system")}},u=class extends d{constructor(e){super(`[ArtifactContainer] Artifact with key:${e} has already been disposed`,"system")}},p=class extends d{constructor(e){super(`[ArtifactContainer] Operation timed out: ${e}`,"system")}},g=class extends d{constructor(e){super(`[ArtifactContainer] An artifact with key:${e} already exists!`,"system")}},f=class extends d{constructor(){super("[Serializer] The serializer has been marked as done!","system")}},y=class{artifacts=new Map;register({key:e,factory:t,lazy:r,...s}){if(this.artifacts.has(e))throw new g(String(e));const{scope:n,...i}=s,a={key:e,factory:t,scope:s.scope??"singleton",lazy:void 0===r||r,...i};return this.artifacts.set(e,a),()=>this.unregister(e)}get(e){if(!this.has(e))throw new l(String(e));return this.artifacts.get(e)}has(e){return this.artifacts.has(e)}async unregister(e){this.artifacts.has(e)&&this.artifacts.delete(e)}size(){return this.artifacts.size}keys(){return Array.from(this.artifacts.keys())}clear(){this.artifacts.clear()}};((e,t,c)=>{c=null!=e?r(a(e)):{},((e,t,r,a)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of i(t))o.call(e,c)||c===r||s(e,c,{get:()=>t[c],enumerable:!(a=n(t,c))||a.enumerable})})(e&&e.__esModule?c:s(c,"default",{value:e,enumerable:!0}),e)})(c());var m=class{_locked=!1;_capacity;waiters=[];constructor(e){this._capacity=e?.capacity??1/0}async lock(e){if(!this._locked)return void(this._locked=!0);if(this.waiters.length>=this._capacity)throw new Error(`Mutex queue is full (capacity: ${this._capacity})`);let t;const r=new Promise((e=>t=e));if(this.waiters.push(t),null!=e)try{await Promise.race([r,new Promise(((r,s)=>setTimeout((()=>{const e=this.waiters.indexOf(t);-1!==e&&this.waiters.splice(e,1),s(new p("Mutex lock timed out"))}),e)))])}catch(e){throw e}else await r}tryLock(){return!this._locked&&(this._locked=!0,!0)}unlock(){if(!this._locked)throw new Error("Mutex is not locked");const e=this.waiters.shift();e?setTimeout(e,0):this._locked=!1}locked(){return this._locked}pending(){return this.waiters.length}},w=class{constructor(e=!1,t=!1){this.retry=e,this.throws=t}mutex=new m;promise=null;_value=null;_error;_done=!1;async do(e,t){return this._done?this.peek():this.promise?this._awaitWithTimeout(this.promise,t,"Once do() timed out"):(await this.mutex.lock(),this.promise?(this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,"Once do() timed out")):(this.promise=(async()=>{try{const t=await e();this._value=t,this._done=!0}catch(e){if(this._error=e,this.retry||(this._done=!0),this.throws)throw e}finally{this.retry&&!this._done&&(this.promise=null)}return this.peek()})(),this.mutex.unlock(),this._awaitWithTimeout(this.promise,t,"Once do() timed out")))}running(){return null!==this.promise&&!this._done}peek(){return{value:this._value,error:this._error}}get(){if(!this._done)throw new Error("Once operation is not yet complete");if(this._error)throw this._error;return this._value}reset(){this._done=!1,this.promise=null,this._value=null,this._error=void 0}resolved(){return this.promise}done(){return this._done}_awaitWithTimeout(e,t,r="Operation timed out"){return null==t?e:Promise.race([e,new Promise(((e,s)=>setTimeout((()=>s(new p(r))),t)))])}},v=class{mutex;_done=!1;_lastValue=null;_lastError=void 0;constructor(e){this.mutex=new m({capacity:e?.capacity??1e3})}async do(e,t){if(this._done)return{value:null,error:new f};try{await this.mutex.lock(t)}catch(e){return{value:null,error:e}}let r,s=null;try{if(this._done)throw new f;s=await e(),this._lastValue=s,this._lastError=void 0}catch(e){r=e,this._lastError=e}finally{this.mutex.unlock()}return{value:s,error:r}}peek(){return{value:this._lastValue,error:this._lastError}}close(){this._done=!0}pending(){return this.mutex.pending()}running(){return this.mutex.locked()}},b=class{constructor(e,t,r,s,n){this.registry=e,this.cache=t,this.graph=r,this.store=s,this.observer=n}async build(e,t){const r=this.registry.get(e);if(!r)throw new d(`Template not found for artifact "${String(e)}"`,"system");const s=t?new Set(t):new Set;if(s.has(e))throw new d(`Cycle detected: Artifact "${String(e)}" depends on itself via path: ${Array.from(s).join(" -> ")}`,"system");s.add(e);let n=this.cache.get(e);n||(n=this.createCachedArtifact(r),this.cache.set(e,n));const i=await("transient"===r.scope?this.executeBuild(r,n,s):n.buildOnce.do((()=>this.executeBuild(r,n,s))));if("transient"===r.scope)return i;const a=this.cache.package(e,(t=>this.invalidate(e,t)));return n.stream&&n.streamOnce.do(n.stream),a}async executeBuild(e,t,r){const s=e.key;t.buildCount++;const n=[],i=[];let a=!0;t.activeDebounceMs=e.debounce??0,n.push((()=>{a=!1}));const o=new Set,c=new Set,h=new Map,l={state:()=>this.store.get(!0),current:t.instance,onCleanup:e=>n.push(e),onDispose:e=>i.push(e),use:async e=>e({resolve:async e=>{if(e===s)throw new d(`Artifact "${String(s)}" depends on itself.`,"system");const t=this.graph.wouldCreateCycle(s,e,r);if(t)throw new d(`Adding dependency "${String(e)}" to "${String(s)}" would create a cycle: ${t.join(" -> ")}`,"system");c.add(e);const n=await this.build(e,r),i=this.cache.get(e);return i&&h.set(e,i.version),n},select:e=>(function(e,t="."){const r=new Set,s=(e=[])=>new Proxy({},{get:(n,i)=>{if("symbol"==typeof i)return;const a=[...e,i],o=a.join(t);return r.add(o),s(a)}});try{e(s())}catch(e){throw new Error(`Selector failed during path analysis. This usually means the selector is too complex. Selectors must be simple property accessors only. Error: ${e instanceof Error?e.message:String(e)}`)}const n=Array.from(r);return n.filter((e=>!n.some((r=>r!==e&&r.startsWith(e+t)))))}(e).forEach((e=>o.add(e))),e(this.store.get(!0)))}),stream:async r=>{if("transient"===e.scope)throw new d(`[ArtifactManager] Illegal stream on transient artifact "${String(s)}"`,"system");const n=async(e,r=void 0)=>{await t.streamSerializer.do((async()=>{a&&(t.instance=e,t.error=r,t.version++,this.cache.invalidatePackage(s),await this.processStream(s))}))},i={value:t.instance,signal:t.streamController.signal,emit:e=>n(e)};t.stream=async()=>{try{await r(i)}catch(e){await n(void 0,e),this.invalidate(s,!1,!0)}}}};let u,p,g=0;const f=(e.retries??0)+1;for(;g<f;)try{const t=e.factory(l);if(e.timeout){const r=new Promise(((t,r)=>setTimeout((()=>r(new Error(`Timeout: ${e.timeout}ms`))),e.timeout)));u=await Promise.race([t,r])}else u=await t;break}catch(e){if(e instanceof d)throw e;g++,g>=f&&(p=e)}if(a){for(const[e,t]of h){const r=this.cache.get(e);r&&r.version!==t&&(p=new d(`Build stale on arrival: Dependency "${String(e)}" changed during build.`,"system"))}if("singleton"===e.scope&&this.updateDependencyGraph(s,c,o),"singleton"===e.scope&&(t.cleanupFunctions=n,t.disposeFunctions=i),p?t.error=p:t.instance=u,t.version++,this.cache.invalidatePackage(s),"transient"===e.scope)return{instance:u,cleanup:this.createCompositeCleanup(n),error:p,ready:!0,invalidate:async()=>console.warn(`[ArtifactManager] Cannot invalidate transient "${String(s)}"`)}}else{const e=this.createCompositeCleanup(n);e&&await e()}}async invalidate(e,t=!1,r=!1){const s=this.cache.get(e);if(s)return s.debounceTimer&&(clearTimeout(s.debounceTimer),s.debounceTimer=void 0),!t&&s.activeDebounceMs>0?new Promise((n=>{s.debounceTimer=setTimeout((()=>{s.debounceTimer=void 0,this.executeInvalidation(e,t,r).then(n).catch(n)}),s.activeDebounceMs)})):this.executeInvalidation(e,t,r)}async executeInvalidation(e,t,r=!1){const s=this.cache.get(e);s&&(await s.invalidationOnce.do((async()=>{s.version++;const n=this.graph.getDependents(e);await Promise.all(n.map((e=>this.invalidate(e).catch((t=>{console.error(`[ArtifactManager] Cascade failed for "${String(e)}":`,t)}))))),await this.cache.invalidateInstance(e);const i=this.registry.get(e);!i||!t&&i.lazy&&!this.hasWatchers(e)||r||await this.build(e),this.observer.notify(e)})),s.invalidationOnce.reset())}async dispose(e){const t=this.cache.get(e);t&&(t.streamController.abort(),t.buildOnce.running()&&await t.buildOnce.resolved(),t.invalidationOnce.running()&&await t.invalidationOnce.resolved(),t.streamOnce.running()&&await t.streamOnce.resolved(),await this.cache.invalidateInstance(e),this.graph.removeNode(e),this.cache.delete(e))}async processStream(e){try{const t=this.graph.getDependents(e);await Promise.all(t.map((e=>this.invalidate(e).catch((t=>{console.error(`[ArtifactManager] Failed to invalidate dependent "${String(e)}":`,t)}))))),this.observer.notify(e)}catch(t){console.error(`[ArtifactManager] Stream propagation error "${e}":`,t)}}updateDependencyGraph(e,t,r){const s=this.cache.get(e);s&&(this.graph.hasNode(e)||this.graph.registerNode(e),this.graph.setDependencies(e,t),s.stateUnsubscribe&&s.stateUnsubscribe(),s.stateDependencies=r,r.size>0&&(s.stateUnsubscribe=this.store.watch(Array.from(r),(async()=>{await this.invalidate(e)}))))}createCachedArtifact(e){return{instance:void 0,version:0,streamController:new AbortController,error:void 0,cleanupFunctions:[],disposeFunctions:[],buildCount:0,stateDependencies:new Set,buildOnce:new w(!0,!0),streamOnce:new w(!0,!0),streamSerializer:new v,activeDebounceMs:e.debounce??0,invalidationOnce:new w(!0,!1)}}createCompositeCleanup(e){if(e.length)return async()=>{for(let t=e.length-1;t>=0;t--)try{await e[t]()}catch(e){console.error("[ArtifactManager] Cleanup error:",e)}}}hasWatchers(e){return this.observer.hasWatchers(e)??!1}},C=class{dependencies=new Map;dependents=new Map;metadata=new Map;registerNode(e,t){this.dependencies.has(e)||this.dependencies.set(e,new Set),this.dependents.has(e)||this.dependents.set(e,new Set),void 0!==t&&this.metadata.set(e,t)}removeNode(e){if(!this.hasNode(e))return;const t=this.dependencies.get(e);if(t)for(const r of t)this.dependents.get(r)?.delete(e);const r=this.dependents.get(e);if(r)for(const t of r)this.dependencies.get(t)?.delete(e);this.dependencies.delete(e),this.dependents.delete(e),this.metadata.delete(e)}hasNode(e){return this.dependencies.has(e)}addDependency(e,t){this.registerNode(e),this.registerNode(t),this.dependencies.get(e).add(t),this.dependents.get(t).add(e)}removeDependency(e,t){this.dependencies.get(e)?.delete(t),this.dependents.get(t)?.delete(e)}getDependencies(e){const t=this.dependencies.get(e);return t?new Set(t):new Set}getDependents(e){const t=this.dependents.get(e);return t?new Set(t):new Set}getMetadata(e){return this.metadata.get(e)}setMetadata(e,t){this.registerNode(e),this.metadata.set(e,t)}setDependencies(e,t){this.registerNode(e);const r=this.dependencies.get(e),s=new Set(t);for(const t of r)s.has(t)||this.removeDependency(e,t);for(const t of s)r.has(t)||this.addDependency(e,t)}wouldCreateCycle(e,t){if(e===t)return[e,t];const r=[t],s=new Set([t]),n=new Map;for(;r.length>0;){const i=r.shift();if(i===e){const r=[];let s=e;for(;void 0!==s&&(r.push(s),s!==t);)s=n.get(s);return r.reverse(),[e,...r]}const a=this.dependencies.get(i);if(a)for(const e of a)s.has(e)||(s.add(e),n.set(e,i),r.push(e))}return null}topologicalSort(){const e=new Map,t=Array.from(this.dependencies.keys());for(const r of t)e.set(r,this.dependencies.get(r)?.size??0);const r=[];for(const[t,s]of e)0===s&&r.push(t);const s=[];for(;r.length>0;){const t=r.shift();s.push(t);const n=this.dependents.get(t);if(n)for(const t of n){const s=(e.get(t)||0)-1;e.set(t,s),0===s&&r.push(t)}}if(s.length!==t.length)throw new Error("Cycle detected in graph; topological sort impossible.");return s}getTransitiveDependencies(e,t=!1){return this.bfs(e,"dependencies",t)}getTransitiveDependents(e,t=!1){return this.bfs(e,"dependents",t)}bfs(e,t,r){const s=new Set,n=new Set,i=[e];n.add(e),r&&s.add(e);const a="dependencies"===t?this.dependencies:this.dependents;for(;i.length>0;){const e=i.shift(),t=a.get(e);if(t)for(const e of t)n.has(e)||(n.add(e),s.add(e),i.push(e))}return s}getAllNodes(){return Array.from(this.dependencies.keys())}size(){return this.dependencies.size}clear(){this.dependencies.clear(),this.dependents.clear(),this.metadata.clear()}toDebugString(){return Array.from(this.dependencies.entries()).map((([e,t])=>{const r=Array.from(t).join(", ");return`${String(e)} → [${r||"∅"}]`})).join("\n")}},A=class{graph;constructor(){this.graph=new C}registerNode(e){this.graph.registerNode(e)}removeNode(e){this.graph.removeNode(e)}addDependency(e,t){this.graph.addDependency(e,t)}removeDependency(e,t){this.graph.removeDependency(e,t)}getDependents(e){const t=this.graph.getDependents(e);return Array.from(t)}getDependencies(e){const t=this.graph.getDependencies(e);return Array.from(t)}getTransitiveDependents(e){const t=this.graph.getTransitiveDependents(e,!1);return new Set(Array.from(t))}setDependencies(e,t){const r=Array.from(t).map((e=>e));this.graph.setDependencies(e,r)}wouldCreateCycle(e,t,r){if(r?.has(t)){const e=Array.from(r),s=e.indexOf(t),n=e.slice(s);return n.push(t),n}const s=this.graph.wouldCreateCycle(e,t);return s||null}hasNode(e){return this.graph.hasNode(e)}getAllNodes(){return this.graph.getAllNodes()}clear(){this.graph.clear()}size(){return this.graph.size()}toDebugString(){return this.graph.toDebugString()}},_=class{cache=new Map;get(e){return this.cache.get(e)}set(e,t){this.cache.set(e,t)}delete(e){this.cache.delete(e)}has(e){return this.cache.has(e)}clear(){this.cache.clear()}size(){return this.cache.size}keys(){return Array.from(this.cache.keys())}package(e,t){const r=this.get(e);if(!r)return{instance:void 0,error:void 0,ready:!1,cleanup:void 0,invalidate:t};if(r.packagedArtifact)return this.updatePackagedArtifact(r,r.packagedArtifact,t),r.packagedArtifact;const s={instance:r.instance,error:r.error,ready:r.buildOnce.done()&&!r.buildOnce.running(),cleanup:this.createCompositeCleanup(r.cleanupFunctions),invalidate:t};return r.packagedArtifact=s,s}async invalidatePackage(e){const t=this.get(e);t&&(t.packagedArtifact=void 0)}async invalidateInstance(e){const t=this.get(e);if(t){t.stateUnsubscribe&&(t.stateUnsubscribe(),t.stateUnsubscribe=void 0),t.debounceTimer&&(clearTimeout(t.debounceTimer),t.debounceTimer=void 0),t.streamController.abort(),await t.streamOnce.resolved(),t.streamOnce.reset(),t.streamSerializer.close();for(let e=t.disposeFunctions.length-1;e>=0;e--)try{await t.disposeFunctions[e]()}catch(e){console.error("[ArtifactManager] Dispose error:",e)}for(let e=t.cleanupFunctions.length-1;e>=0;e--)try{await t.cleanupFunctions[e]()}catch(e){console.error("[ArtifactManager] Cleanup error:",e)}t.instance=void 0,t.error=void 0,t.cleanupFunctions=[],t.disposeFunctions=[],t.buildOnce.reset(),t.stream=void 0,t.streamSerializer=new v,t.streamController=new AbortController}}updatePackagedArtifact(e,t,r){t.instance=e.instance,t.error=e.error,t.ready=e.buildOnce.done()&&!e.buildOnce.running(),t.cleanup=this.createCompositeCleanup(e.cleanupFunctions),t.invalidate=r}createCompositeCleanup(e){if(e.length)return async()=>{for(let t=e.length-1;t>=0;t--)try{await e[t]()}catch(e){console.error("[ArtifactCache] Cleanup error:",e)}}}},k=class{constructor(e,t,r){this.registry=e,this.cache=t,this.container=r}listeners=new Map;watcherCache=new Map;watch(e){const t=e,r=this.registry.get(e);if(!r)throw new Error(`Artifact "${t}" not registered`);let s=t;if("transient"===r.scope&&(s=`${t}__watched`,this.registry.has(s)||this.registry.register({key:s,factory:r.factory,scope:"singleton",lazy:r.lazy,timeout:r.timeout,retries:r.retries,debounce:r.debounce})),this.watcherCache.has(s)){const e=this.watcherCache.get(s);return e.count++,e}let n=!1;const i={id:t,count:1,get:()=>{if(!this.cache.get(s))return this.cache.package(s,(e=>this.container.invalidate(s,e)));const e=this.cache.package(s,(e=>this.container.invalidate(s,e)));return n?{...e,ready:!1,instance:void 0,error:new u(t),cleanup:()=>{},invalidate:()=>Promise.resolve()}:e},subscribe:e=>{this.listeners.has(s)||this.listeners.set(s,new Set);const t=()=>e(i.get());return this.listeners.get(s).add(t),this.container.resolve(s).catch((e=>{console.error(`[ArtifactObserver] Background resolution failed for "${s}":`,e)})).then(t),()=>this.listeners.get(s)?.delete(t)},dispose:async()=>{i.count--,i.count<=0&&(this.watcherCache.delete(s),"transient"===r.scope&&(await this.registry.unregister(s),this.cache.delete(s)),n=!0,this.notify(s),this.listeners.delete(s))}};return this.watcherCache.set(s,i),i}notify(e){const t=this.listeners.get(e);t&&t.forEach((t=>{try{t()}catch(t){console.error(`[ArtifactObserver] Listener error for "${e}":`,t)}}))}hasWatchers(e){return this.watcherCache.has(e)||this.watcherCache.has(`${e}__watched`)}getWatcherCount(e){const t=this.watcherCache.get(e)||this.watcherCache.get(`${e}__watched`);return t?.count??0}clear(){this.watcherCache.clear(),this.listeners.clear()}};exports.ArtifactContainer=class{registry;cache;graph;manager;observer;store;constructor(e){this.store={watch:(...t)=>e.watch(...t),get:()=>e.get(!0)},this.registry=new y,this.cache=new _,this.graph=new A,this.observer=new k(this.registry,this.cache,this),this.manager=new b(this.registry,this.cache,this.graph,this.store,this.observer)}debugInfo(){const e=[];return this.registry.keys().forEach((t=>{const r=this.registry.get(t),s=this.cache.get(t);if(!r)return;const n=s?s.buildOnce.running()?"pending":s.error?"error":void 0!==s.instance?"active":"idle":"idle";e.push({id:t,scope:r.scope??"singleton",status:n,dependencies:this.graph.getDependencies(t).map((e=>String(e))),dependents:this.graph.getDependents(t).map((e=>String(e))),stateDependencies:s?Array.from(s.stateDependencies):[],renderCount:s?.buildCount??0})})),e}register(e){const{key:t}=e,r=t;this.registry.has(t)&&(console.warn(`[ArtifactContainer] Overwriting "${r}".`),this.manager.dispose(t).catch((e=>{console.error(`[ArtifactContainer] Failed to dispose existing artifact "${r}":`,e)}))),this.registry.register(e),this.graph.registerNode(t);const s=e.scope??"singleton";return(e.lazy??!0)||"singleton"!==s||this.resolve(t).catch((e=>{console.error(`[ArtifactContainer] Eager load failed for "${r}":`,e)})),()=>this.unregister(t)}async unregister(e){await this.manager.dispose(e),await this.registry.unregister(e)}async resolve(e){if(!this.registry.has(e))throw new l(e);return this.manager.build(e)}watch(e){if(!this.registry.has(e))throw new l(e);return this.observer.watch(e)}peek(e){const t=this.cache.get(e);if(void 0!==t?.instance)return t?.instance}async invalidate(e,t=!1){return this.manager.invalidate(e,t)}notifyObservers(e){this.observer.notify(e)}hasWatchers(e){return this.observer.hasWatchers(e)}dispose(){this.registry.keys().forEach((e=>{this.manager.dispose(e).catch((t=>{console.error(`[ArtifactContainer] Failed to dispose artifact "${String(e)}":`,t)}))})),this.registry.clear(),this.cache.clear(),this.graph.clear(),this.observer.clear()}},exports.ArtifactScopes=h;