patron-oop 1.44.1 → 1.46.0

package/dist/patron.d.ts

@@ -1,17 +1,14 @@
 type GuestIntroduction = "guest" | "patron";
-interface GiveOptions {
-    data?: unknown;
-}
-type GuestExecutorType<T = any, This = void> = (value: T, options?: GiveOptions) => This;
+type GuestExecutorType<T = any, This = void> = (value: T) => This;
 interface GuestObjectType<T = any> {
-    give(value: T, options?: GiveOptions): this;
+    give(value: T): this;
     introduction?(): GuestIntroduction;
 }
 type GuestType<T = any> = GuestExecutorType<T> | GuestObjectType<T>;
 /**
  * @url https://kosukhin.github.io/patron.site/#/utils/give
  */
-declare function give<T>(data: T, guest: GuestType<T>, options?: GiveOptions): void;
+declare function give<T>(data: T, guest: GuestType<T>): void;
 /**
  * @url https://kosukhin.github.io/patron.site/#/utils/is-guest
  */
@@ -22,72 +19,40 @@ declare function isGuest(mbGuest: any): mbGuest is GuestType;
 declare class Guest<T> implements GuestObjectType<T> {
     private receiver;
     constructor(receiver: GuestExecutorType<T>);
-    give(value: T, options?: GiveOptions): this;
-}
-
-type GuestAwareExecutorType<T> = (guest: GuestType<T>) => unknown;
-interface GuestAwareObjectType<T> {
-    value: GuestAwareExecutorType<T>;
-}
-type GuestAwareType<T = any> = GuestAwareExecutorType<T> | GuestAwareObjectType<T>;
-/**
- * @url https://kosukhin.github.io/patron.site/#/utils/give
- */
-declare function value<T>(guestAware: GuestAwareType<T>, guest: GuestType<T>): unknown;
-/**
- * @url https://kosukhin.github.io/patron.site/#/utils/is-guest-aware
- */
-declare function isGuestAware(mbGuestAware: any): mbGuestAware is GuestAwareType;
-/**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware
- */
-declare class GuestAware<T = any> implements GuestAwareObjectType<T> {
-    private guestAware;
-    constructor(guestAware: GuestAwareType<T>);
-    value(guest: GuestType<T>): GuestType<T>;
+    give(value: T): this;
 }
 
-/**
- * @url https://kosukhin.github.io/patron.site/#/utils/private
- */
-interface PrivateType<T> {
-    get<R extends unknown[], CT = null>(...args: R): CT extends null ? T : CT;
-}
-declare class Private<T> implements PrivateType<T> {
-    private buildingFn;
-    constructor(buildingFn: (...args: any[]) => T);
-    get<R extends unknown[], CT = null>(...args: R): CT extends null ? T : CT;
+interface GuestDisposableType<T = any> extends GuestObjectType<T> {
+    disposed(value: T | null): boolean;
 }
-
+type MaybeDisposableType<T = any> = Partial<GuestDisposableType<T>>;
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-sequence
+ * @url https://kosukhin.github.io/patron.site/#/guest/guest-disposable
  */
-declare class GuestAwareSequence<T, TG> implements GuestAwareObjectType<TG[]> {
-    private baseSource;
-    private targetSource;
-    constructor(baseSource: GuestAwareType<T[]>, targetSource: PrivateType<GuestAwareType<TG>>);
-    value(guest: GuestType<TG[]>): this;
+declare class GuestDisposable<T> implements GuestDisposableType<T> {
+    private guest;
+    private disposeCheck;
+    constructor(guest: GuestType, disposeCheck: (value: T | null) => boolean);
+    disposed(value: T | null): boolean;
+    give(value: T): this;
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-map
+ * @url https://kosukhin.github.io/patron.site/#/guest/guest-cast
  */
-declare class GuestAwareMap<T, TG> implements GuestAwareObjectType<TG[]> {
-    private baseSource;
-    private targetSource;
-    constructor(baseSource: GuestAwareType<T[]>, targetSource: PrivateType<GuestAwareType<TG>>);
-    value(guest: GuestType<TG[]>): this;
+declare class GuestCast<T> implements GuestDisposableType<T> {
+    private sourceGuest;
+    private targetGuest;
+    constructor(sourceGuest: GuestType<any>, targetGuest: GuestType<T>);
+    introduction(): "guest" | "patron";
+    give(value: T): this;
+    disposed(value: T | null): boolean;
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-race
+ * @url https://kosukhin.github.io/patron.site/#/utils/patron-pools
  */
-declare class GuestAwareRace<T> implements GuestAwareObjectType<T> {
-    private guestAwares;
-    constructor(guestAwares: GuestAwareType<T>[]);
-    value(guest: GuestType<T>): this;
-}
-
+declare const patronPools: (patron: GuestObjectType) => PoolType<any>[];
 /**
  * @url https://kosukhin.github.io/patron.site/#/utils/remove-patron-from-pools
  */
@@ -108,7 +73,7 @@ interface PoolType<T = any> extends GuestObjectType<T> {
 declare class PatronPool<T> implements PoolType<T> {
     private initiator;
     private patrons;
-    give: (value: T, options?: GiveOptions) => this;
+    give: (value: T) => this;
     constructor(initiator: unknown);
     size(): number;
     add(shouldBePatron: GuestType<T>): this;
@@ -118,76 +83,144 @@ declare class PatronPool<T> implements PoolType<T> {
     private guestDisposed;
 }
 
-interface PoolAware<T = any> {
-    pool(): PatronPool<T>;
+/**
+ * @url https://kosukhin.github.io/patron.site/#/guest/guest-pool
+ */
+declare class GuestPool<T> implements GuestObjectType<T>, PoolType<T> {
+    private guests;
+    private patronPool;
+    constructor(initiator: unknown);
+    give(value: T): this;
+    add(guest: GuestType<T>): this;
+    remove(patron: GuestObjectType<T>): this;
+    distribute(receiving: T, possiblePatron: GuestObjectType<T>): this;
+    size(): number;
+    private deliverToGuests;
+}
+
+interface GuestValueType<T = any> extends GuestObjectType<T> {
+    value(): T;
 }
 /**
- * @url https://kosukhin.github.io/patron.site/#/source
+ * @url https://kosukhin.github.io/patron.site/#/guest/guest-sync
  */
-type SourceType<T = any> = GuestAwareObjectType<T> & GuestObjectType<T> & PoolAware<T>;
-declare class Source<T> implements SourceType<T> {
-    private sourceDocument;
-    private thePool;
-    constructor(sourceDocument: T);
-    pool(): PatronPool<unknown>;
+declare class GuestSync<T> implements GuestValueType<T> {
+    private theValue;
+    constructor(theValue: T);
     give(value: T): this;
-    value(guest: GuestType<T>): this;
+    value(): T;
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/action-type
+ * @url https://kosukhin.github.io/patron.site/#/guest/guest-object
  */
-interface ActionType<P = any> {
-    do(config: P): this;
+declare class GuestObject<T> implements GuestDisposableType<T> {
+    private baseGuest;
+    constructor(baseGuest: GuestType<T>);
+    give(value: T): this;
+    introduction(): "guest" | "patron";
+    disposed(value: T | null): boolean;
 }
-interface GuestAwareAcitveType<R = unknown, T = unknown> extends GuestAwareObjectType<T>, ActionType<R> {
+
+/**
+ * @url https://kosukhin.github.io/patron.site/#/guest/guest-applied
+ */
+declare class GuestApplied<T, R> implements GuestObjectType<T> {
+    private baseGuest;
+    private applier;
+    constructor(baseGuest: GuestType<R>, applier: (value: T) => R);
+    give(value: T): this;
 }
+
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-active
+ * @url https://kosukhin.github.io/patron.site/#/guest/guest-executor-applied
  */
-declare class GuestAwareActive<R, T> implements GuestAwareAcitveType<R, T> {
-    private configExecutor;
-    private source;
-    constructor(configExecutor: (config: R, source: SourceType<T>) => void);
-    do(config: R): this;
-    value(guest: GuestType<T>): this;
+declare class GuestExecutorApplied<T> implements GuestObjectType<T> {
+    give: GuestExecutorType<T, this>;
+    constructor(baseGuest: GuestType<T>, applier: (executor: GuestExecutorType) => GuestExecutorType);
 }
 
-interface GuestDisposableType<T = any> extends GuestObjectType<T> {
+/**
+ * @url https://kosukhin.github.io/patron.site/#/patron
+ */
+declare class Patron<T> implements GuestDisposableType<T> {
+    private willBePatron;
+    constructor(willBePatron: GuestType<T>);
+    introduction(): "patron";
+    give(value: T): this;
     disposed(value: T | null): boolean;
 }
-type MaybeDisposableType<T = any> = Partial<GuestDisposableType<T>>;
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-disposable
+ * @url https://kosukhin.github.io/patron.site/#/utils/is-patron
  */
-declare class GuestDisposable<T> implements GuestDisposableType<T> {
-    private guest;
-    private disposeCheck;
-    constructor(guest: GuestType, disposeCheck: (value: T | null) => boolean);
+declare const isPatron: (guest: GuestType) => guest is Patron<unknown>;
+
+/**
+ * @url https://kosukhin.github.io/patron.site/#/patron/patron-once
+ */
+declare class PatronOnce<T> implements GuestDisposableType<T> {
+    private baseGuest;
+    private received;
+    constructor(baseGuest: GuestType<T>);
+    introduction(): "patron";
+    give(value: T): this;
     disposed(value: T | null): boolean;
-    give(value: T, options?: GiveOptions): this;
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-cast
+ * @url https://kosukhin.github.io/patron.site/#/patron/patron-applied
  */
-declare class GuestCast<T> implements GuestDisposableType<T> {
-    private sourceGuest;
-    private targetGuest;
-    constructor(sourceGuest: GuestType<any>, targetGuest: GuestType<T>);
+declare class PatronApplied<T, R> implements GuestObjectType<T> {
+    private guestApplied;
+    constructor(baseGuest: GuestType<R>, applier: (value: T) => R);
+    give(value: T): this;
     introduction(): "guest" | "patron";
-    give(value: T, options?: GiveOptions): this;
-    disposed(value: T | null): boolean;
 }
 
-interface GuestAwareAllType<T = any> extends GuestAwareObjectType<T> {
+/**
+ * @url https://kosukhin.github.io/patron.site/#/patron/patron-executor-applied
+ */
+declare class PatronExecutorApplied<T> implements GuestObjectType<T> {
+    private guestApplied;
+    constructor(baseGuest: GuestType<T>, applier: (executor: GuestExecutorType) => GuestExecutorType);
+    give(value: T): this;
+    introduction(): "guest" | "patron";
+}
+
+type SourceExecutorType<T> = (guest: GuestType<T>) => unknown;
+interface SourceObjectType<T> {
+    value: SourceExecutorType<T>;
+}
+type SourceType<T = any> = SourceExecutorType<T> | SourceObjectType<T>;
+/**
+ * @url https://kosukhin.github.io/patron.site/#/utils/value
+ */
+declare function value<T>(source: SourceType<T>, guest: GuestType<T>): unknown;
+/**
+ * @url https://kosukhin.github.io/patron.site/#/utils/is-source
+ */
+declare function isSource(mbSource: any): mbSource is SourceType;
+/**
+ * @url https://kosukhin.github.io/patron.site/#/guest/source
+ */
+declare class Source<T = any> implements SourceObjectType<T> {
+    private source;
+    constructor(source: SourceType<T>);
+    value(guest: GuestType<T>): GuestType<T>;
+}
+/**
+ * @url https://kosukhin.github.io/patron.site/#/utils/source-of
+ */
+declare const sourceOf: <T>(value: T) => Source<T>;
+
+interface SourceAllType<T = any> extends SourceObjectType<T> {
     valueArray(guest: GuestObjectType<T>): this;
     guestKey<R>(key: string): GuestObjectType<R>;
 }
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-aware-all
+ * @url https://kosukhin.github.io/patron.site/#/guest/source-all
  */
-declare class GuestAwareAll<T> implements GuestAwareAllType<T> {
+declare class SourceAll<T> implements SourceAllType<T> {
     private theAll;
     private keysKnown;
     private keysFilled;
@@ -200,88 +233,120 @@ declare class GuestAwareAll<T> implements GuestAwareAllType<T> {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-pool
+ * @url https://kosukhin.github.io/patron.site/#/utils/private
  */
-declare class GuestPool<T> implements GuestObjectType<T>, PoolType<T> {
-    private guests;
-    private patronPool;
-    constructor(initiator: unknown);
-    give(value: T, options?: GiveOptions): this;
-    add(guest: GuestType<T>): this;
-    remove(patron: GuestObjectType<T>): this;
-    distribute(receiving: T, possiblePatron: GuestObjectType<T>): this;
-    size(): number;
-    private deliverToGuests;
+interface PrivateType<T> {
+    get<R extends unknown[], CT = null>(...args: R): CT extends null ? T : CT;
+}
+declare class Private<T> implements PrivateType<T> {
+    private buildingFn;
+    constructor(buildingFn: (...args: any[]) => T);
+    get<R extends unknown[], CT = null>(...args: R): CT extends null ? T : CT;
 }
 
-interface GuestValueType<T = any> extends GuestObjectType<T> {
-    value(): T;
+/**
+ * @url https://kosukhin.github.io/patron.site/#/guest/source-sequence
+ */
+declare class SourceSequence<T, TG> implements SourceObjectType<TG[]> {
+    private baseSource;
+    private targetSource;
+    constructor(baseSource: SourceType<T[]>, targetSource: PrivateType<SourceType<TG>>);
+    value(guest: GuestType<TG[]>): this;
 }
+
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-sync
+ * @url https://kosukhin.github.io/patron.site/#/guest/source-map
  */
-declare class GuestSync<T> implements GuestValueType<T> {
-    private theValue;
-    constructor(theValue: T);
-    give(value: T): this;
-    value(): T;
+declare class SourceMap<T, TG> implements SourceObjectType<TG[]> {
+    private baseSource;
+    private targetSource;
+    constructor(baseSource: SourceType<T[]>, targetSource: PrivateType<SourceType<TG>>);
+    value(guest: GuestType<TG[]>): this;
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/guest-object
+ * @url https://kosukhin.github.io/patron.site/#/guest/source-race
  */
-declare class GuestObject<T> implements GuestDisposableType<T> {
-    private baseGuest;
-    constructor(baseGuest: GuestType<T>);
-    give(value: T, options?: GiveOptions): this;
-    introduction(): "guest" | "patron";
-    disposed(value: T | null): boolean;
+declare class SourceRace<T> implements SourceObjectType<T> {
+    private sources;
+    constructor(sources: SourceType<T>[]);
+    value(guest: GuestType<T>): this;
 }
 
+interface PoolAwareType<T = any> {
+    pool(): PatronPool<T>;
+}
 /**
- * @url https://kosukhin.github.io/patron.site/#/patron
+ * @url https://kosukhin.github.io/patron.site/#/source-with-pool
  */
-declare class Patron<T> implements GuestDisposableType<T> {
-    private willBePatron;
-    constructor(willBePatron: GuestType<T>);
-    introduction(): "patron";
-    give(value: T, options?: GiveOptions): this;
-    disposed(value: T | null): boolean;
+type SourceWithPoolType<T = any> = SourceObjectType<T> & GuestObjectType<T> & PoolAwareType<T>;
+declare class SourceWithPool<T> implements SourceWithPoolType<T> {
+    private sourceDocument?;
+    private thePool;
+    private theEmptyPool;
+    private isEmpty;
+    constructor(sourceDocument?: T | undefined);
+    pool(): PatronPool<unknown>;
+    give(value: T): this;
+    value(guest: GuestType<T>): this;
+    filled(): boolean;
 }
 
-type PoolAwareOptions = {
-    pool?: PoolType;
-    castedGuest?: GuestObjectType;
-};
 /**
- * @url https://kosukhin.github.io/patron.site/#/patron/patron-once
+ * @url https://kosukhin.github.io/patron.site/#/utils/action-type
  */
-declare class PatronOnce<T> implements GuestDisposableType<T> {
-    private baseGuest;
-    private received;
-    constructor(baseGuest: GuestType<T>);
-    introduction(): "patron";
-    give(value: T, options?: GiveOptions): this;
-    disposed(value: T | null): boolean;
+interface ActionType<P = any> {
+    do(config: P): this;
+}
+interface SourceAcitveType<R = unknown, T = unknown> extends SourceObjectType<T>, ActionType<R> {
+}
+/**
+ * @url https://kosukhin.github.io/patron.site/#/guest/source-active
+ */
+declare class SourceActive<R, T> implements SourceAcitveType<R, T> {
+    private configExecutor;
+    private source;
+    constructor(configExecutor: (config: R, source: SourceWithPoolType<T>) => void);
+    do(config: R): this;
+    value(guest: GuestType<T>): this;
 }
 
 /**
  * @url https://kosukhin.github.io/patron.site/#/source-dynamic
  */
-declare class SourceDynamic<T = unknown> implements SourceType<T> {
+declare class SourceDynamic<T = unknown> implements SourceWithPoolType<T> {
     private baseGuest;
-    private baseGuestAware;
-    constructor(baseGuest: GuestType<T>, baseGuestAware: GuestAwareType<T>);
+    private baseSource;
+    constructor(baseGuest: GuestType<T>, baseSource: SourceType<T>);
     value(guest: GuestType<T>): this;
     give(value: T): this;
     pool(): PatronPool<T>;
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/source/source-empty
+ * @url https://kosukhin.github.io/patron.site/#/source/source-applied
  */
-declare class SourceEmpty<T> implements SourceType<T> {
+declare class SourceApplied<T, R> implements SourceObjectType<R> {
     private baseSource;
+    private applier;
+    constructor(baseSource: SourceType<T>, applier: (v: T) => R);
+    value(g: GuestType<R>): this;
+}
+
+/**
+ * @url https://kosukhin.github.io/patron.site/#/source/source-executor-applied
+ */
+declare class SourceExecutorApplied<T> implements SourceObjectType<T> {
+    value: SourceExecutorType<T>;
+    constructor(source: SourceType<T>, applier: (executor: SourceExecutorType<T>) => SourceExecutorType<T>);
+}
+
+/**
+ * @url https://kosukhin.github.io/patron.site/#/source/source-once
+ */
+declare class SourceOnce<T> implements SourceWithPoolType<T> {
+    private source;
+    constructor(initialValue?: T);
     value(guest: GuestType<T>): this;
     give(value: T): this;
     pool(): PatronPool<T>;
@@ -297,4 +362,4 @@ declare class PrivateClass<T> implements PrivateType<T> {
     get<R extends unknown[], CT = null>(...args: R): CT extends null ? T : CT;
 }
 
-export { type ActionType, type GiveOptions, Guest, GuestAware, type GuestAwareAcitveType, GuestAwareActive, GuestAwareAll, type GuestAwareAllType, type GuestAwareExecutorType, GuestAwareMap, type GuestAwareObjectType, GuestAwareRace, GuestAwareSequence, type GuestAwareType, GuestCast, GuestDisposable, type GuestDisposableType, type GuestExecutorType, GuestObject, type GuestObjectType, GuestPool, GuestSync, type GuestType, type GuestValueType, type MaybeDisposableType, Patron, PatronOnce, PatronPool, type PoolAware, type PoolAwareOptions, type PoolType, Private, PrivateClass, type PrivateType, Source, SourceDynamic, SourceEmpty, type SourceType, give, isGuest, isGuestAware, isPatronInPools, removePatronFromPools, value };
+export { type ActionType, Guest, GuestApplied, GuestCast, GuestDisposable, type GuestDisposableType, GuestExecutorApplied, type GuestExecutorType, GuestObject, type GuestObjectType, GuestPool, GuestSync, type GuestType, type GuestValueType, type MaybeDisposableType, Patron, PatronApplied, PatronExecutorApplied, PatronOnce, PatronPool, type PoolAwareType, type PoolType, Private, PrivateClass, type PrivateType, Source, type SourceAcitveType, SourceActive, SourceAll, type SourceAllType, SourceApplied, SourceDynamic, SourceExecutorApplied, type SourceExecutorType, SourceMap, type SourceObjectType, SourceOnce, SourceRace, SourceSequence, type SourceType, SourceWithPool, type SourceWithPoolType, give, isGuest, isPatron, isPatronInPools, isSource, patronPools, removePatronFromPools, sourceOf, value };