silentium 0.0.35 → 0.0.37

package/.github/workflows/node.js.yml

@@ -0,0 +1,31 @@
+# This workflow will do a clean installation of node dependencies, cache/restore them, build the source code and run tests across different versions of node
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-nodejs
+
+name: Node.js CI
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    branches: [ "main" ]
+
+jobs:
+  build:
+
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x, 22.x]
+        # See supported Node.js release schedule at https://nodejs.org/en/about/releases/
+
+    steps:
+    - uses: actions/checkout@v4
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    - run: npm ci
+    - run: npm run build --if-present
+    - run: npm test

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.0.37](https://github.com/silentium-lab/silentium/compare/v0.0.36...v0.0.37) (2025-05-31)
+
+
+### Features
+
+* **49-sourcedetached:** firstVisit done and applied ([d596990](https://github.com/silentium-lab/silentium/commit/d596990daf05b0136e3860bbc6793950fb6ccaf2))
+
+
+### Bug Fixes
+
+* **49-sourcedetached:** fix tests ([e054cd6](https://github.com/silentium-lab/silentium/commit/e054cd6c63caa9b436212fc1e1e2db5e82622197))
+
+### [0.0.36](https://github.com/silentium-lab/silentium/compare/v0.0.35...v0.0.36) (2025-05-31)
+
+
+### Features
+
+* **47-sourcelazy-component:** source lazy done ([ed97056](https://github.com/silentium-lab/silentium/commit/ed9705603913451e22ed6994005f6a5b656dacde))
+
 ### [0.0.35](https://github.com/silentium-lab/silentium/compare/v0.0.34...v0.0.35) (2025-05-25)
 
 

package/README.md

@@ -1,3 +1,33 @@
-# Silentium
+<p align="center">
+  <a href="https://silentium-lab.github.io/silentium/#/en/" target="_blank" rel="noopener noreferrer" style="display:flex">
+      <img width="180" src="https://silentium-lab.github.io/silentium/assets/img/logo.svg" alt="logo">  
+  </a>
+</p>
+<h1 align="center">Silentium</h1>
+<br/>
+<p align="center">
+  <a href="https://npmjs.com/package/silentium"><img src="https://img.shields.io/npm/v/silentium.svg" alt="npm package"></a>
+  <a href="https://github.com/silentium-lab/silentium/actions/workflows/node.js.yml"><img src="https://github.com/silentium-lab/silentium/actions/workflows/node.js.yml/badge.svg?branch=main" alt="build status"></a>
+</p>
+<br/>
 
-[Документация](https://github.com/silentium-lab/)
+[Documentation](https://silentium-lab.github.io/silentium/#/en/)
+
+To install the library you can use the command.
+
+```bash
+npm install silentium
+```
+
+The library helps you create abstractions for information in your system. Instead of working with data abstractions and operations abstractions, you can combine them into a common information abstraction. The approach in which we combine data and operations under information abstractions is object-oriented programming.
+
+The idea for the project was born from the ideas of eolang and was inspired by this paper, 𝜑-calculus:
+https://arxiv.org/pdf/2111.13384
+
+## Difference from eolang
+
+Unlike eolang, where the program starts working at the moment when some method receives data, which is called dataization, Silentium starts executing the program at the moment when a guest comes to the information source, requesting data, this difference allows the Silentium library to work on top of JavaScript events, creating abstractions of information around some event models.
+
+## Is silentium reactive?
+
+Silentium is not a reactive programming library, chains of objects only interact with each other through message passing, but due to the fact that Silentium is developed with the idea of ​​working on top of events, it allows for easy integration with any reactive library or framework, transferring event sources to the reactive mechanisms of the required frameworks.

package/dist/silentium.cjs

@@ -63,6 +63,15 @@ const guest = (receiver) => {
   };
   return result;
 };
+const firstVisit = (afterFirstVisit) => {
+  let isVisited = false;
+  return () => {
+    if (!isVisited) {
+      afterFirstVisit();
+    }
+    isVisited = true;
+  };
+};
 
 const guestCast = (sourceGuest, targetGuest) => {
   if (sourceGuest === void 0) {
@@ -448,26 +457,29 @@ const sourceAll = (sources) => {
   };
   const theAll = sourceOf({});
   const patrons = [];
-  Object.entries(sources).forEach(([key, source]) => {
-    subSource(theAll, source);
-    keysKnown.add(key);
-    const keyPatron = patron((v) => {
-      theAll.value(
-        guest((all) => {
-          keysFilled.add(key);
-          const lastAll = {
-            ...all,
-            [key]: v
-          };
-          theAll.give(lastAll);
-        })
-      );
+  const visited = firstVisit(() => {
+    Object.entries(sources).forEach(([key, source]) => {
+      subSource(theAll, source);
+      keysKnown.add(key);
+      const keyPatron = patron((v) => {
+        theAll.value(
+          guest((all) => {
+            keysFilled.add(key);
+            const lastAll = {
+              ...all,
+              [key]: v
+            };
+            theAll.give(lastAll);
+          })
+        );
+      });
+      patrons.push(keyPatron);
+      value(source, keyPatron);
     });
-    patrons.push(keyPatron);
-    value(source, keyPatron);
   });
   return {
     value(guest2) {
+      visited();
       const mbPatron = guestCast(guest2, (value2) => {
         if (isAllFilled()) {
           give(Object.values(value2), guest2);
@@ -545,25 +557,30 @@ const sourceMap = (baseSource, targetSource) => {
     throw new Error("SourceMap didn't receive targetSource argument");
   }
   const result = sourceOf();
-  value(
-    baseSource,
-    patron((theValue) => {
-      const sources = [];
-      theValue.forEach((val) => {
-        const source = targetSource.get(val);
-        subSource(source, baseSource);
-        sources.push(source);
-      });
-      value(
-        sourceAll(sources),
-        patronOnce((v) => {
-          destroy(...sources);
-          give(v, result);
-        })
-      );
-    })
-  );
-  return result.value;
+  const visited = firstVisit(() => {
+    value(
+      baseSource,
+      patron((theValue) => {
+        const sources = [];
+        theValue.forEach((val) => {
+          const source = targetSource.get(val);
+          subSource(source, baseSource);
+          sources.push(source);
+        });
+        value(
+          sourceAll(sources),
+          patronOnce((v) => {
+            destroy(...sources);
+            give(v, result);
+          })
+        );
+      })
+    );
+  });
+  return (g) => {
+    visited();
+    result.value(g);
+  };
 };
 
 const sourceRace = (sources) => {
@@ -590,21 +607,26 @@ const sourceChain = (...sources) => {
   const resultSrc = sourceOf();
   const respondedSources = /* @__PURE__ */ new Set();
   let lastSourceValue = null;
-  sources.forEach((source, index) => {
-    value(
-      source,
-      patron((value2) => {
-        respondedSources.add(index);
-        if (index === sources.length - 1) {
-          lastSourceValue = value2;
-        }
-        if (respondedSources.size === sources.length && lastSourceValue !== null) {
-          resultSrc.give(lastSourceValue);
-        }
-      })
-    );
+  const visited = firstVisit(() => {
+    sources.forEach((source, index) => {
+      value(
+        source,
+        patron((value2) => {
+          respondedSources.add(index);
+          if (index === sources.length - 1) {
+            lastSourceValue = value2;
+          }
+          if (respondedSources.size === sources.length && lastSourceValue !== null) {
+            resultSrc.give(lastSourceValue);
+          }
+        })
+      );
+    });
   });
-  return resultSrc.value;
+  return (g) => {
+    visited();
+    resultSrc.value(g);
+  };
 };
 
 const sourceDynamic = (baseGuest, baseSource) => {
@@ -691,48 +713,68 @@ const sourceCombined = (...sources) => (source) => {
 
 const sourceResettable = (baseSrc, resettableSrc) => {
   const result = sourceOf();
-  value(
-    resettableSrc,
-    patron(() => {
-      give(null, result);
-    })
-  );
-  value(baseSrc, patron(result));
-  subSource(result, baseSrc);
-  return result;
+  const visited = firstVisit(() => {
+    value(
+      resettableSrc,
+      patron(() => {
+        give(null, result);
+      })
+    );
+    value(baseSrc, patron(result));
+    subSource(result, baseSrc);
+  });
+  return (g) => {
+    visited();
+    result.value(g);
+  };
 };
 
 const sourceAny = (sources) => {
   const lastSrc = sourceOf();
-  sources.forEach((source) => {
-    value(source, patron(lastSrc));
+  const visited = firstVisit(() => {
+    sources.forEach((source) => {
+      value(source, patron(lastSrc));
+    });
   });
-  return lastSrc;
+  return (g) => {
+    visited();
+    lastSrc.value(g);
+  };
 };
 
-const sourceLazy = (lazySrc, args, resetSrc) => {
+const sourceLazy = (lazySrc, args, destroySrc) => {
   let instance = null;
   const result = sourceOf();
-  const resultResettable = sourceResettable(result, resetSrc ?? sourceOf());
-  value(
-    sourceAll(args),
-    patron(() => {
-      if (!instance) {
-        instance = lazySrc.get(...args);
-        value(instance, patron(result));
-      }
-    })
-  );
-  if (resetSrc) {
+  const resultResettable = sourceResettable(result, destroySrc ?? sourceOf());
+  let wasInstantiated = false;
+  const instantiate = () => {
+    if (wasInstantiated) {
+      return;
+    }
+    wasInstantiated = true;
     value(
-      resetSrc,
+      sourceAll(args),
+      patron(() => {
+        if (!instance) {
+          instance = lazySrc.get(...args);
+          value(instance, patron(result));
+        }
+      })
+    );
+  };
+  if (destroySrc) {
+    value(
+      destroySrc,
       patron(() => {
         destroy(instance);
         instance = null;
       })
     );
   }
-  return resultResettable;
+  return (g) => {
+    instantiate();
+    value(resultResettable, g);
+  };
 };
 
 const sourceDestroyable = (source) => {
@@ -778,6 +820,7 @@ const lazy = (buildingFn) => {
 
 exports.PatronPool = PatronPool;
 exports.destroy = destroy;
+exports.firstVisit = firstVisit;
 exports.give = give;
 exports.guest = guest;
 exports.guestApplied = guestApplied;