silentium 0.0.2 → 0.0.3

package/src/Patron/Patron.ts

@@ -2,7 +2,7 @@ import { give, GuestType } from "../Guest/Guest";
 import { GuestDisposableType } from "../Guest/GuestDisposable";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/patron
+ * @url https://silentium-lab.github.io/silentium/#/patron
  */
 export class Patron<T> implements GuestDisposableType<T> {
   public constructor(private willBePatron: GuestType<T>) {
@@ -27,7 +27,7 @@ export class Patron<T> implements GuestDisposableType<T> {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/is-patron
+ * @url https://silentium-lab.github.io/silentium/#/utils/is-patron
  */
 export const isPatron = (guest: GuestType): guest is Patron<unknown> =>
   typeof guest === "object" &&

package/src/Patron/PatronApplied.ts

@@ -2,7 +2,7 @@ import { GuestObjectType, GuestType } from "../Guest/Guest";
 import { GuestApplied } from "../Guest/GuestApplied";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/patron/patron-applied
+ * @url https://silentium-lab.github.io/silentium/#/patron/patron-applied
  */
 export class PatronApplied<T, R> implements GuestObjectType<T> {
   private guestApplied: GuestApplied<T, R>;

package/src/Patron/PatronExecutorApplied.ts

@@ -2,7 +2,7 @@ import { GuestExecutorType, GuestObjectType, GuestType } from "../Guest/Guest";
 import { GuestExecutorApplied } from "../Guest/GuestExecutorApplied";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/patron/patron-executor-applied
+ * @url https://silentium-lab.github.io/silentium/#/patron/patron-executor-applied
  */
 export class PatronExecutorApplied<T> implements GuestObjectType<T> {
   private guestApplied: GuestExecutorApplied<T>;

package/src/Patron/PatronOnce.ts

@@ -5,7 +5,7 @@ import {
 } from "../Guest/GuestDisposable";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/patron/patron-once
+ * @url https://silentium-lab.github.io/silentium/#/patron/patron-once
  */
 export class PatronOnce<T> implements GuestDisposableType<T> {
   private received = false;

package/src/Patron/PatronPool.ts

@@ -4,7 +4,7 @@ import { GuestDisposableType } from "../Guest/GuestDisposable";
 const poolSets = new Map<PoolType, Set<GuestObjectType>>();
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/patron-pools
+ * @url https://silentium-lab.github.io/silentium/#/utils/patron-pools
  */
 export const patronPools = (patron: GuestObjectType) => {
   const pools: PoolType[] = [];
@@ -17,7 +17,7 @@ export const patronPools = (patron: GuestObjectType) => {
 };
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/remove-patron-from-pools
+ * @url https://silentium-lab.github.io/silentium/#/utils/remove-patron-from-pools
  */
 export const removePatronFromPools = (patron: GuestObjectType) => {
   if (patron === undefined) {
@@ -29,7 +29,7 @@ export const removePatronFromPools = (patron: GuestObjectType) => {
 };
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/is-patron-in-pools
+ * @url https://silentium-lab.github.io/silentium/#/utils/is-patron-in-pools
  */
 export const isPatronInPools = (patron: GuestObjectType) => {
   if (patron === undefined) {
@@ -52,7 +52,7 @@ export interface PoolType<T = any> extends GuestObjectType<T> {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/patron/patron-pool
+ * @url https://silentium-lab.github.io/silentium/#/patron/patron-pool
  */
 export class PatronPool<T> implements PoolType<T> {
   private patrons: Set<GuestObjectType<T>>;

package/src/Private/Private.ts

@@ -1,5 +1,5 @@
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/private
+ * @url https://silentium-lab.github.io/silentium/#/utils/private
  */
 export interface PrivateType<T> {
   get<R extends unknown[], CT = null>(...args: R): CT extends null ? T : CT;

package/src/Source/Source.ts

@@ -9,7 +9,7 @@ export interface SourceObjectType<T> {
 export type SourceType<T = any> = SourceExecutorType<T> | SourceObjectType<T>;
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/value
+ * @url https://silentium-lab.github.io/silentium/#/utils/value
  */
 export function value<T>(source: SourceType<T>, guest: GuestType<T>) {
   if (source === undefined) {
@@ -26,7 +26,7 @@ export function value<T>(source: SourceType<T>, guest: GuestType<T>) {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/is-source
+ * @url https://silentium-lab.github.io/silentium/#/utils/is-source
  */
 export function isSource(mbSource: any): mbSource is SourceType {
   if (mbSource === undefined) {
@@ -38,7 +38,7 @@ export function isSource(mbSource: any): mbSource is SourceType {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/source
+ * @url https://silentium-lab.github.io/silentium/#/guest/source
  */
 export class Source<T = any> implements SourceObjectType<T> {
   public constructor(private source: SourceType<T>) {
@@ -54,6 +54,6 @@ export class Source<T = any> implements SourceObjectType<T> {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/utils/source-of
+ * @url https://silentium-lab.github.io/silentium/#/utils/source-of
  */
 export const sourceOf = <T>(value: T) => new Source<T>((g) => give(value, g));

package/src/Source/SourceAll.ts

@@ -11,7 +11,7 @@ export interface SourceAllType<T = any> extends SourceObjectType<T> {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/source-all
+ * @url https://silentium-lab.github.io/silentium/#/guest/source-all
  */
 export class SourceAll<T> implements SourceAllType<T> {
   private theAll: SourceWithPool<Record<string, unknown>>;

package/src/Source/SourceApplied.ts

@@ -3,7 +3,7 @@ import { GuestCast } from "../Guest/GuestCast";
 import { SourceObjectType, SourceType, value } from "../Source/Source";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/source/source-applied
+ * @url https://silentium-lab.github.io/silentium/#/source/source-applied
  */
 export class SourceApplied<T, R> implements SourceObjectType<R> {
   public constructor(

package/src/Source/SourceDynamic.ts

@@ -4,7 +4,7 @@ import { PatronPool } from "../Patron/PatronPool";
 import { SourceWithPoolType } from "./SourceWithPool";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/source-dynamic
+ * @url https://silentium-lab.github.io/silentium/#/source-dynamic
  */
 export class SourceDynamic<T = unknown> implements SourceWithPoolType<T> {
   public constructor(

package/src/Source/SourceExecutorApplied.ts

@@ -6,7 +6,7 @@ import {
 } from "../Source/Source";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/source/source-executor-applied
+ * @url https://silentium-lab.github.io/silentium/#/source/source-executor-applied
  */
 export class SourceExecutorApplied<T> implements SourceObjectType<T> {
   public value: SourceExecutorType<T>;

package/src/Source/SourceMap.ts

@@ -11,7 +11,7 @@ import { SourceAll } from "./SourceAll";
 import { GuestCast } from "../Guest/GuestCast";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/source-map
+ * @url https://silentium-lab.github.io/silentium/#/guest/source-map
  */
 export class SourceMap<T, TG> implements SourceObjectType<TG[]> {
   public constructor(

package/src/Source/SourceOnce.ts

@@ -4,7 +4,7 @@ import { value } from "./Source";
 import { SourceWithPool, SourceWithPoolType } from "./SourceWithPool";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/source/source-once
+ * @url https://silentium-lab.github.io/silentium/#/source/source-once
  */
 export class SourceOnce<T> implements SourceWithPoolType<T> {
   private source: SourceWithPool<T>;

package/src/Source/SourceRace.ts

@@ -3,7 +3,7 @@ import { SourceObjectType, SourceType, value } from "./Source";
 import { GuestCast } from "../Guest/GuestCast";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/source-race
+ * @url https://silentium-lab.github.io/silentium/#/guest/source-race
  */
 export class SourceRace<T> implements SourceObjectType<T> {
   public constructor(private sources: SourceType<T>[]) {

package/src/Source/SourceSequence.ts

@@ -7,7 +7,7 @@ import { isSource, SourceObjectType, SourceType, value } from "./Source";
 import { SourceAll } from "./SourceAll";
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/guest/source-sequence
+ * @url https://silentium-lab.github.io/silentium/#/guest/source-sequence
  */
 export class SourceSequence<T, TG> implements SourceObjectType<TG[]> {
   public constructor(

package/src/Source/SourceWithPool.ts

@@ -8,7 +8,7 @@ export interface PoolAwareType<T = any> {
 }
 
 /**
- * @url https://kosukhin.github.io/patron.site/#/source-with-pool
+ * @url https://silentium-lab.github.io/silentium/#/source-with-pool
  */
 export type SourceWithPoolType<T = any> = SourceObjectType<T> &
   GuestObjectType<T> &

package/src/index.ts

@@ -16,7 +16,6 @@ export * from "./Source/Source";
 export * from "./Source/SourceSequence";
 export * from "./Source/SourceMap";
 export * from "./Source/SourceRace";
-export * from "./Source/SourceActive";
 export * from "./Source/SourceWithPool";
 export * from "./Source/SourceDynamic";
 export * from "./Source/SourceApplied";

package/docs/pages/source/source-active.html

@@ -1,120 +0,0 @@
-<h1 class="pb-3 text-xl font-semibold text-gray-600">Класс SourceActive</h1>
-
-<a
-  href="https://github.com/kosukhin/patron/blob/main/src/Source/SourceActive.ts"
-  target="_blank"
-  class="inline-flex gap-1 items-center bg-gray-100 border-0 py-1 px-3 focus:outline-none hover:bg-gray-200 rounded text-base mt-4 md:mt-0 mb-4"
->
-  <img
-    src="./assets/img/github_16.jpg"
-    width="16"
-    height="16"
-  />
-  SourceActive на GitHub
-</a>
-
-<p class="text-gray-600 text-lg mb-4">
-  Планируется убрать этот класс из библиотеке, и вместе с ним ActionType.
-  Потому что можно добиться того же эффекта с использованием источника, который ожидает другой источник.
-  Например источник FetchResopnse может ожидать источник FetchRequest и когда в FetchRequest появится значение запроса
-  FetchResopnse с использованием своего внутреннего посетителя сделает fetch и получив ответ отдаст ответ своим посетителям.
-</p>
-
-<p class="text-gray-600 text-lg mb-4">
-  Класс
-  <link-dynamic href="/source">Source</link-dynamic> можно
-  назвать пассивным
-  <link-dynamic href="/terminology/the-source">источником данных</link-dynamic>,
-  потому что мы только вызываем его метод <b>value</b> и надеемся получить
-  данные, либо говорим что нас нужно уведомлять о новых данных. При этом никаких
-  активных действий совершать не требуется
-</p>
-
-<p class="text-gray-600 text-lg mb-4">
-  Класс <b>SourceActive</b> можно назвать активным источником данных. Чтобы
-  значение было рассчитано мы должны явно вызывать метод <b>do</b>. Подобные
-  классы полезны в случаях, когда вычисление нужно выполнить не сразу а по
-  событию
-</p>
-
-<p class="text-gray-600 text-lg mb-4">
-  Также можно отдельно использовать
-  <link-reloadable
-    target-blank
-    href="https://github.com/kosukhin/patron/blob/main/src/Guest/SourceActive.ts#L9"
-    >ActionType</link-reloadable
-  >
-  интерфейс для объявления своих собственных классов - активных источников
-  данных, имеющих метод do
-</p>
-
-<p class="text-gray-600 text-lg mb-0 font-bold">Пример 1.</p>
-<pre
-  class="mb-4"
-><code class="language-js">import { SourceActive, Patron } from "patron-oop";
-
-const eur = new SourceActive((_, source) => {
-    source.give("Loading...");
-    fetch("https://www.cbr.ru/scripts/XML_daily.asp")
-    .then((r) => r.text())
-    .then((r) => {
-        const parser = new DOMParser();
-        const doc = parser.parseFromString(r, "application/xml");
-        const eurNode = doc.querySelector('[ID="R01239"] Value');
-        source.give(eurNode.textContent);
-    });
-});
-
-eur.value(
-    new Patron((val) => {
-        document.querySelector(".guest-result").textContent = `EUR/RUB = ${val}`;
-    })
-);
-
-document
-    .getElementById("get-eur")
-    .addEventListener("click", eur.do.bind(eur));
-</code></pre>
-
-<p class="text-gray-600 text-lg mb-1 font-bold">Результат 1.</p>
-<button
-  class="inline-flex gap-1 items-center bg-gray-100 border-0 py-1 px-3 focus:outline-none hover:bg-gray-200 rounded text-base mt-4 md:mt-0 mb-4"
-  id="get-eur"
->
-  Get EUR
-</button>
-<div class="example mb-4">
-  <span class="guest-result"> Нажмите кнопку "Get EUR" </span>
-</div>
-
-<script type="module">
-  import { SourceActive, Patron } from "patron-oop";
-
-  const eur = new SourceActive((_, source) => {
-    source.give("Loading...");
-    fetch("https://www.cbr.ru/scripts/XML_daily.asp")
-      .then((r) => r.text())
-      .then((r) => {
-        const parser = new DOMParser();
-        const doc = parser.parseFromString(r, "application/xml");
-        const eurNode = doc.querySelector('[ID="R01239"] Value');
-        source.give(eurNode.textContent);
-      });
-  });
-
-  eur.value(
-    new Patron((val) => {
-      document.querySelector(".guest-result").textContent = `EUR/RUB = ${val}`;
-    })
-  );
-
-  document
-    .getElementById("get-eur")
-    .addEventListener("click", eur.do.bind(eur));
-</script>
-
-<div class="font-bold mt-8">Смотрите также</div>
-
-<p class="text-gray-600 text-lg mb-4 dynamic-navigation">
-  <link-dynamic href="/source">Source</link-dynamic>
-</p>

package/src/Source/SourceActive.test.ts

@@ -1,13 +0,0 @@
-import { SourceActive } from "./SourceActive";
-import { expect, test, vitest } from "vitest";
-
-test("SourceActive.test", () => {
-  const active = new SourceActive<number, number>((config, source) => {
-    source.give(config * 3);
-  });
-
-  const guest = vitest.fn();
-  active.do(4).value(guest);
-
-  expect(guest).toBeCalledWith(12);
-});

package/src/Source/SourceActive.ts

@@ -1,41 +0,0 @@
-import { GuestType } from "../Guest/Guest";
-import { SourceObjectType } from "./Source";
-import { SourceWithPool, SourceWithPoolType } from "./SourceWithPool";
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/utils/action-type
- */
-export interface ActionType<P = any> {
-  do(config: P): this;
-}
-
-export interface SourceAcitveType<R = unknown, T = unknown>
-  extends SourceObjectType<T>,
-    ActionType<R> {}
-
-/**
- * @url https://kosukhin.github.io/patron.site/#/guest/source-active
- */
-export class SourceActive<R, T> implements SourceAcitveType<R, T> {
-  private source = new SourceWithPool<T>();
-
-  public constructor(
-    private configExecutor: (config: R, source: SourceWithPoolType<T>) => void,
-  ) {
-    if (configExecutor === undefined) {
-      throw new Error(
-        "SourceActive constructor didnt receive executor function",
-      );
-    }
-  }
-
-  public do(config: R): this {
-    this.configExecutor(config, this.source);
-    return this;
-  }
-
-  public value(guest: GuestType<T>): this {
-    this.source.value(guest);
-    return this;
-  }
-}