silentium 0.0.2 → 0.0.3

package/docs/pages/index.html

@@ -6,67 +6,39 @@
       <h1
         class="title-font sm:text-4xl text-3xl mb-4 font-medium text-gray-600"
       >
-        Patron: responsibility, respect, result
+        Silentium = молчание
       </h1>
+      <p class="mb-4 leading-relaxed">
+        С латинского языка <a class="link" href="https://en.wiktionary.org/wiki/silentium" target="_blank">silentium переводится как молчание</a>. Основная особенность библиотеки
+        silentium заключается в том, что объект, если у него нет хорошего ответа на вопрос
+        может не давать плохой ответ, например - null. Такой подход позволяет объектам лучше контроллировать
+        свою часть работы, а тем объектам которые полагаются на работу других объектов позволяет доверять
+        полученным значениям, не размазывая множество условий проверки значений по всему приложению.
+      </p>
+
       <p class="mb-8 leading-relaxed">
-        Библиотека предназначена для того, чтобы дать пользователю возможность
-        сконцентрироваться на разработке внутренней надёжной логики класса.
-        Классы, использующие библиотеку, становятся ответственными за те
-        результаты которые представляют и уважительно относятся к объектам с
-        которыми взаимодействуют
+        Основа реализации в том, что объекты разделяются на две категории: Источники и Посетители.<br>
+        <b>Источники</b> - это объекты с методом <b>.value</b> или функции ожидающие в первом аргументе посетителя.<br>
+        <b>Посетители</b> - это объекты с методом <b>.give</b> или функции ожидающие в первом аргументе значение.<br>
       </p>
-    </div>
-    <div class="lg:w-2/3 w-full mb-14">
+
       <h1
-        class="text-center title-font sm:text-4xl text-3xl mb-4 font-medium text-gray-600"
+        class="title-font sm:text-4xl text-3xl mb-4 font-medium text-gray-600"
       >
-        Patron - это протокол для общения между объектами
+        Начало работы
       </h1>
+
       <p class="mb-8 leading-relaxed">
-        В программе использующей Patron библиотеку есть объекты совместимые с
-        SourceType - это источники данных, такие объекты могу отдавать
-        данные. Есть объекты совместимые с GuestType - это потребители данных,
-        они могут принять данные
+        Чтобы установить библиотеку воспользуйтесь пакетным менеджером npm или другим более предпочтительным для вашего приложения.
       </p>
-      <div class="mb-4">
-        <h3 class="pb-3 text-xl font-semibold text-gray-600">
-          Сценарий 1. Диалог
-        </h3>
-        <p>
-          Объект А - источник данных, объект B - потребитель. Если объекту B
-          нужны какие-то данные, то B обращается к А через метод A.value
-          запрашивая данные. Когда А посчитает нужным, то А вернет B значение,
-          вызывая B.give
-        </p>
-      </div>
-      <div class="mb-4">
-        <h3 class="pb-3 text-xl font-semibold text-gray-600">
-          Сценарий 2. Расширение
-        </h3>
-        <p class="mb-2">
-          Объект А - источник данных запрашивающий случайное слово в интернете,
-          объект B - источник изменяющий в базовом источнике первым символ на
-          верхний регистр. Объект C - источник добавляющий в конец значения из
-          базового источника знак восклицания "!". Объект D - потребитель
-          результата, выводящий значение на экран
-        </p>
-        <p>
-          Получаем следующую композицию с = new C(new B(new A)), далее выражение
-          c.value(new D()) - Выводит результат на экран
-        </p>
-      </div>
+      <pre class="text-left mb-4"><code>$ npm install silentium</code></pre>
 
-      <div class="mb-4">
-        <h3 class="pb-3 text-xl font-semibold text-gray-600">
-          Сценарий 3. Постоянный потребитель
-        </h3>
-        <p class="mb-2">
-          Объект А - источник данных, объект B - потребитель данных. Объект B
-          может представиться как 'patron', благодаря этому, объект А в случае,
-          если у него появится новое значение, будет знать что B нужно
-          оповестить о новом значении
-        </p>
-      </div>
+      <p class="mb-8 leading-relaxed">
+        После установки библиотеки вы сможете использовать все наработки из разделов<br>
+        <link-dynamic href="/guest">Guest</link-dynamic>,
+        <link-dynamic href="/patron">Patron</link-dynamic> и
+        <link-dynamic href="/source">Source</link-dynamic> в своем проекте
+      </p>
     </div>
   </div>
 </section>

package/docs/pages/integrations/vue.html

@@ -2,14 +2,11 @@
 
 <p class="text-gray-600 text-lg mb-4">
   Библиотека Patron интегрируется в Vue без каких-либо проблем. Например, чтобы
-  <span class="dynamic-navigation">
-    <a
-      class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-source"
-    >
-      источник данных
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/source"
+  >
+    источник данных
+  </link-dynamic>
   привязать к ref можно использовать такой класс (Листинг 1).
 </p>
 

package/docs/pages/patron/index.html

@@ -8,30 +8,24 @@
 
 <p class="text-gray-600 text-lg mb-4">
   Предназначен для динамического превращения
-  <span class="dynamic-navigation">
-    <a class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-guest">
-      гостя
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/guest">
+    гостя
+  </link-dynamic>
   в
-  <span class="dynamic-navigation">
-    <a class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-patron">
-      патрона
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/patron">
+    патрона
+  </link-dynamic>
 </p>
 
 <p class="text-gray-600 text-lg mb-4">
   Это поведение полезно в случаях, когда нужно из просто посетителя(гостя)
   сделать постоянного посетиеля(патрона). Это будет означать что если у
-  <span class="dynamic-navigation">
-    <a class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-source">
-      источника данных
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/source">
+    источника данных
+  </link-dynamic>
   есть новые данные, то источник отдаст эту новую порцию данных всем своим
   постоянным посетителям(патронам)
 </p>
@@ -43,7 +37,7 @@
   Source,
   GuestDisposable,
   isPatronInPools,
-} from "patron-oop";
+} from "silentium";
 
 const source = new SourceWithPool(1);
 const timer = new Source((guest) => {
@@ -90,7 +84,7 @@ timer.value(
     Source,
     GuestDisposable,
     isPatronInPools,
-  } from "patron-oop";
+  } from "silentium";
 
   const source = new SourceWithPool(1);
   const timer = new Source((guest) => {

package/docs/pages/patron/patron-applied.html

@@ -18,7 +18,7 @@
 <p class="text-gray-600 text-lg mb-0 font-bold">Пример 1.</p>
 <pre
   class="mb-4"
-><code class="language-js">import { Guest, PatronApplied, SourceWithPool } from "patron-oop";
+><code class="language-js">import { Guest, PatronApplied, SourceWithPool } from "silentium";
 
 window.source = new SourceWithPool(20);
 
@@ -50,7 +50,7 @@ window.source.value(
   Дать источнику значение 25
 </button>
 <script type="module">
-  import { Guest, PatronApplied, SourceWithPool } from "patron-oop";
+  import { Guest, PatronApplied, SourceWithPool } from "silentium";
 
   window.source = new SourceWithPool(20);
 

package/docs/pages/patron/patron-executor-applied.html

@@ -24,7 +24,7 @@
 <p class="text-gray-600 text-lg mb-0 font-bold">Пример 1.</p>
 <pre
   class="mb-4"
-><code class="language-js">import { Guest, PatronExecutorApplied, Patron, SourceWithPool } from "patron-oop";
+><code class="language-js">import { Guest, PatronExecutorApplied, Patron, SourceWithPool } from "silentium";
 
 window.source = new SourceWithPool(20);
 
@@ -67,7 +67,7 @@ window.source.value(
   Дать источнику значение 25
 </button>
 <script type="module">
-  import { Guest, PatronExecutorApplied, Patron, SourceWithPool } from "patron-oop";
+  import { Guest, PatronExecutorApplied, Patron, SourceWithPool } from "silentium";
 
   window.source = new SourceWithPool(20);
 

package/docs/pages/patron/patron-once.html

@@ -15,14 +15,11 @@
 
 <p class="text-gray-600 text-lg mb-4">
   Предназначен для создания
-  <span class="dynamic-navigation">
-    <a
-      class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-patron"
-    >
-      патрона
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/patron"
+  >
+    патрона
+  </link-dynamic>
   , который будет выполнен только один раз и удалит себя после получения первого
   значения
 </p>
@@ -30,14 +27,11 @@
 <p class="text-gray-600 text-lg mb-4">
   Такое поведение полезно, когда нужно получить значение, которое возможно еще
   не установлено в
-  <span class="dynamic-navigation">
-    <a
-      class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-source"
-    >
-      источнике данных
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/source"
+  >
+    источнике данных
+  </link-dynamic>
 </p>
 
 <p class="text-gray-600 text-lg mb-4">
@@ -46,7 +40,7 @@
 </p>
 
 <p class="text-gray-600 text-lg mb-0 font-bold">Пример 1.</p>
-<pre class="mb-4"><code class="language-js">import { SourceWithPool, PatronOnce } from "patron-oop";
+<pre class="mb-4"><code class="language-js">import { SourceWithPool, PatronOnce } from "silentium";
 
 const source = new SourceWithPool("один раз");
 source.value(
@@ -70,7 +64,7 @@ setTimeout(() => {
   <span class="patron-once-result">Нет результата!</span>
 </div>
 <script type="module">
-  import { SourceWithPool, PatronOnce } from "patron-oop";
+  import { SourceWithPool, PatronOnce } from "silentium";
 
   const source = new SourceWithPool("один раз");
   source.value(

package/docs/pages/patron/patron-pool.html

@@ -15,27 +15,21 @@
 
 <p class="text-gray-600 text-lg mb-4">
   Предназначен для хранения списка
-  <span class="dynamic-navigation">
-    <a
-      class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-patron"
-    >
-      патронов
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/patron"
+  >
+    патронов
+  </link-dynamic>
   , которым нужно передавать значения
 </p>
 
 <p class="text-gray-600 text-lg mb-4">
   Полезно для организации списка подписчиков на обновление данных какого-то
-  <span class="dynamic-navigation">
-    <a
-      class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-      href="/terminology/the-source"
-    >
-      источника
-    </a>
-  </span>
+  <link-dynamic
+    href="/terminology/source"
+  >
+    источника
+  </link-dynamic>
   . Сам по себе класс PatronPool - достаточно низкоуровневый и желательно
   использовать класс Source, который именно является источником значений (у
   Source под капотом работает PatornPool)
@@ -45,7 +39,7 @@
 <pre class="mb-4"><code class="language-js">import {
     PatronPool,
     Patron
-} from 'patron-oop';
+} from 'silentium';
 
 const pool = new PatronPool();
 
@@ -65,7 +59,7 @@ pool.give('Значение из пула');
   <div class="patron-pool-result2">Нет результата 2!</div>
 </div>
 <script type="module">
-  import { PatronPool, Patron } from "patron-oop";
+  import { PatronPool, Patron } from "silentium";
 
   const pool = new PatronPool();
 

package/docs/pages/patron.html

@@ -12,16 +12,16 @@
             <div class="w-12 h-1 bg-indigo-500 rounded mt-2 mb-4"></div>
             <ul class="text-gray-900">
               <li class="w-full border-b-2 border-neutral-100 py-4">
-                <a href="/patron/patron-once"> PatronOnce </a>
+                <a class="dynamic-navigation" href="/patron/patron-once"> PatronOnce </a>
               </li>
               <li class="w-full border-b-2 border-neutral-100 py-4">
-                <a href="/patron/patron-pool"> PatronPool </a>
+                <a class="dynamic-navigation" href="/patron/patron-pool"> PatronPool </a>
               </li>
               <li class="w-full border-b-2 border-neutral-100 py-4">
-                <a href="/patron/patron-applied"> PatronApplied </a>
+                <a class="dynamic-navigation" href="/patron/patron-applied"> PatronApplied </a>
               </li>
               <li class="w-full border-b-2 border-neutral-100 py-4">
-                <a href="/patron/patron-executor-applied"> PatronExecutorApplied </a>
+                <a class="dynamic-navigation" href="/patron/patron-executor-applied"> PatronExecutorApplied </a>
               </li>
             </ul>
           </div>
@@ -29,19 +29,140 @@
         <div
           class="sm:w-2/3 sm:pl-8 sm:border-l border-gray-200 sm:border-t-0 border-t mt-4 sm:mt-0"
         >
-          <div class="patron-loader">
-            <div class="w-full flex justify-center">
-              <div
-                class="inline-block h-8 w-8 animate-spin rounded-full border-4 border-solid border-current border-e-transparent align-[-0.125em] text-indigo-500 motion-reduce:animate-[spin_1.5s_linear_infinite]"
-                role="status"
-              >
-                <span
-                  class="!absolute !-m-px !h-px !w-px !overflow-hidden !whitespace-nowrap !border-0 !p-0 ![clip:rect(0,0,0,0)]"
-                  >Loading...</span
-                >
-              </div>
-            </div>
+          <h1 class="pb-3 text-xl font-semibold text-gray-600">Класс Patron</h1>
+
+          <a href="https://github.com/kosukhin/patron/blob/main/src/Patron/Patron.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" />
+            Patron на GitHub
+          </a>
+
+          <p class="text-gray-600 text-lg mb-4">
+            Предназначен для динамического превращения
+            <link-dynamic
+              href="/terminology/guest">
+              гостя
+            </link-dynamic>
+            в
+            <link-dynamic
+              href="/terminology/patron">
+              патрона
+            </link-dynamic>
+          </p>
+
+          <p class="text-gray-600 text-lg mb-4">
+            Это поведение полезно в случаях, когда нужно из просто посетителя(гостя)
+            сделать постоянного посетиеля(патрона). Это будет означать что если у
+            <link-dynamic
+              href="/terminology/source">
+              источника данных
+            </link-dynamic>
+            есть новые данные, то источник отдаст эту новую порцию данных всем своим
+            постоянным посетителям(патронам)
+          </p>
+
+          <p class="text-gray-600 text-lg mb-0 font-bold">Пример 1.</p>
+          <pre class="mb-4"><code class="language-js">import {
+  Patron,
+  SourceWithPool,
+  Source,
+  GuestDisposable,
+  isPatronInPools,
+} from "silentium";
+
+const source = new SourceWithPool(1);
+const timer = new Source((guest) => {
+  source.value(guest);
+  const repeat = () => {
+    if (!isPatronInPools(guest)) {
+      return;
+    }
+    source.value((value) => {
+      setTimeout(() => {
+        source.give(value + 1);
+        repeat();
+      }, 1000);
+    });
+  };
+  repeat();
+});
+
+timer.value(
+  new Patron(
+    new GuestDisposable(
+      (value) => {
+        const el = document.querySelector(".patron-result");
+        if (el) {
+          el.textContent = `Секунд прошло ${value}`;
+        }
+      },
+      () => {
+        return !document.querySelector(".patron-result");
+      }
+    )
+  )
+);</code></pre>
+
+          <p class="text-gray-600 text-lg mb-0 font-bold">Результат 1.</p>
+          <div class="example mb-4">
+            <span class="patron-result">Result here</span>
           </div>
+          <script type="module">
+            import {
+              Patron,
+              SourceWithPool,
+              Source,
+              GuestDisposable,
+              isPatronInPools,
+            } from "silentium";
+
+            const source = new SourceWithPool(1);
+            const timer = new Source((guest) => {
+              source.value(guest);
+              const repeat = () => {
+                if (!isPatronInPools(guest)) {
+                  return;
+                }
+                source.value((value) => {
+                  setTimeout(() => {
+                    source.give(value + 1);
+                    repeat();
+                  }, 1000);
+                });
+              };
+              repeat();
+            });
+
+            timer.value(
+              new Patron(
+                new GuestDisposable(
+                  (value) => {
+                    const el = document.querySelector(".patron-result");
+                    if (el) {
+                      el.textContent = `Секунд прошло ${value}`;
+                    }
+                  },
+                  () => {
+                    return !document.querySelector(".patron-result");
+                  }
+                )
+              )
+            );
+          </script>
+
+          <div class="font-bold mt-8">Смотрите также</div>
+
+          <p class="text-gray-600 text-lg mb-4 dynamic-navigation">
+            <a class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
+              href="/source">Source</a>
+            <a class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
+              href="/guest/guest-disposable">GuestDisposable</a>
+            <a class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
+              href="/source/source-with-pool">SourceWithPool</a>
+            <a class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
+              href="/utils/is-patron-in-pools">isPatronInPools</a>
+          </p>
+
           <div class="patron-page-area"></div>
         </div>
       </div>

package/docs/pages/philosofy.html

@@ -63,45 +63,32 @@
         ответственности за результат стала возможной - объект у которого
         результат есть должен видеть того, кому этот результат нужен, чтобы
         полностью контролировать отдачу результата своему
-        <span class="dynamic-navigation">
-          <a
-            class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-            href="/terminology/visitor"
-          >
-            посетителю
-          </a>
-        </span>
+        <link-dynamic
+          href="/terminology/visitor"
+        >
+          посетителю
+        </link-dynamic>
         Вокруг этой ключевой идеи и построена вся библиотека. Посетители объекта
         делятся на
-        <span class="dynamic-navigation">
-          <a
-            class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-            href="/terminology/the-guest"
-          >
-            гостей
-          </a>
-        </span>
+        <link-dynamic
+          href="/terminology/guest"
+        >
+          гостей
+        </link-dynamic>
         - те кому сообщить значение нужно один раз и забыть о нем пока он сам не
         вернется если захочет и
-
-        <span class="dynamic-navigation">
-          <a
-            class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-            href="/terminology/the-patron"
-          >
-            патроны
-          </a>
-        </span>
+        <link-dynamic
+          href="/terminology/patron"
+        >
+          патроны
+        </link-dynamic>
         - те кому нужно постоянно сообщать о новых значениях, пока они сами не
         решат удалиться из
-        <span class="dynamic-navigation">
-          <a
-            class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-            href="/patron/patron-pool"
-          >
-            пула патронов
-          </a>
-        </span>
+        <link-dynamic
+          href="/patron/patron-pool"
+        >
+          пула патронов
+        </link-dynamic>
       </p>
       <div class="clear-both"></div>
       <h2 class="pb-3 text-xl font-semibold text-gray-600">Result</h2>
@@ -116,14 +103,11 @@
         вывод что использование Библиотеки Patron накладывает на вас ограничение
         - не использовать return, а вместо этого возвращать данные посетителю
         вызывая его метод give, либо пользуясь отдельной функцией
-        <span class="dynamic-navigation">
-          <a
-            class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-            href="/utils/give"
-          >
-            give
-          </a>
-        </span>
+        <link-dynamic
+          href="/utils/give"
+        >
+          give
+        </link-dynamic>
       </p>
       <p class="text-gray-600 text-lg mb-4">
         Но в этом разделе(Result) хотелось бы отметить еще одну важную
@@ -160,14 +144,11 @@
         Посетитель. Объекты имеющие данные не отдают их неизвестно кому
         (оператором return), а вместо этого ждут посетителя и отдают данные
         вежливому посетителю который пришел и
-        <span class="dynamic-navigation">
-          <a
-            class="inline-block whitespace-nowrap rounded-[0.27rem] bg-primary-100 px-[0.65em] pb-[0.25em] pt-[0.35em] text-center align-baseline text-[0.75em] font-bold leading-none text-white bg-slate-900"
-            href="/terminology/introduction"
-          >
-            представился
-          </a>
-        </span>
+        <link-dynamic
+          href="/terminology/introduction"
+        >
+          представился
+        </link-dynamic>
         Посетитель может представиться патроном, что для объекта источника
         данных будет значить что в случае если у этого объекта будут новые
         данные, то патрону будет интересно об этих данных узнать. Общение между