@moskva/runtime 0.1.0 → 0.1.2

package/changes.md

@@ -1,3 +1,10 @@
+## 28 jan 2026
+
+### v0.1.1-0.1.2
+
+- add splash screen and readme change; add homepage.
+- add translation to readme.
+
 ## 27 jan 2026
 
 ### 0.1.0

package/package.json

@@ -1,4 +1,45 @@
 {
  "name": "@moskva/runtime",
- "version": "0.1.0"
+ "version": "0.1.2",
+ "description": "JavaScript-рантайм «Москва» с Java-подобной моделью выполнения: вызываемые Runnable-экземпляры, изоляция памяти и предсказуемая инициализация.",
+ "scripts": {
+  "t": "git tag @javish/base-v$(node -p \"require('./package.json').version\") && git push --tags"
+ },
+ "homepage": "рантайм.москва",
+ "keywords": [
+  "runtime",
+  "execution-environment",
+  "functional-interfaces",
+  "runnable",
+  "callable-instances",
+  "proxy",
+  "vm",
+  "virtual-machine",
+  "isolation",
+  "high-performance",
+  "javascript",
+  "java-interop",
+  "java-style",
+  "moskva",
+  "memory-management",
+  "low-level",
+  "advanced",
+  "рантайм",
+  "среда-исполнения",
+  "функциональные-интерфейсы",
+  "runnable",
+  "вызываемые-экземпляры",
+  "прокси",
+  "вм",
+  "виртуальная-машина",
+  "изоляция",
+  "высокая-производительность",
+  "javascript",
+  "интероп-java",
+  "java-стиль",
+  "москва",
+  "управление-памятью",
+  "низкоуровневый",
+  "продвинутый"
+ ]
 }

package/readme.md

@@ -1,7 +1,12 @@
-# Runtime Moskva
+# Рантайм Москва
 
-This runtime provides callable instances of `Runnable` functional interfaces. A
-`Runnable` is a class instance that can be invoked like a function.
+<p>
+<img src="https://media-743523.gitlab.io/img/img/mockba3-500.jpg" alt="РАНТАЙМ МОСКВА СПЛЕШ СКРИН">
+</p>
+
+Этот рантайм предоставляет вызываемые экземпляры функциональных интерфейсов
+`Runnable`. `Runnable` — это экземпляр класса, который можно вызывать как
+функцию.
 
 ```js
 interface IRunnable {
@@ -9,12 +14,9 @@ interface IRunnable {
 }
 ```
 
-<!-- Instances are allocated memory and can request compute via the event loop. -->
+## Использование
 
-## Usage
-
-An example below shows that even though `runner` is an instance, it can still be
-invoked as a function:
+Пример ниже показывает, что несмотря на то, что `runner` является экземпляром класса, его всё равно можно вызывать как функцию:
 
 ```js
 var{Runnable}=require('@moskva/runtime')
@@ -23,6 +25,7 @@ var runner=new class extends Runnable {
  const(){
   this.test=[]
   this.test.push(new Date)
+  // или this.test=['test']
  }
  test2(){
   return this.test
@@ -42,30 +45,87 @@ calling runner:
  < Hello runner; test = [ 2026-01-27T23:19:34.106Z ]
 ```
 
+### Назначение
+
+Экземпляры стандартных, не-runnable классов нельзя вызывать. Такое поведение
+доступно только при наследовании от `Runnable` и предназначено для эмуляции
+функциональных интерфейсов Java, которые предполагают реализацию одного метода.
+
+## Требования к реализации
+
+* Метод `run` **обязан** быть реализован. Он является точкой входа, которая
+  вызывается при обращении к экземпляру как к функции.
+* Реализация может получать доступ к дополнительным внутренним API через `this`.
+
+## Правила инициализации
+
+Поля экземпляра должны инициализироваться внутри метода `const`.
+
+Синтаксис полей класса не поддерживается. Реализация основана на proxy, и
+создание `Runnable` с инициализаторами полей приведёт к бесконечной рекурсии. В
+настоящее время не существует безопасного способа перехватить или извлечь
+инициализаторы полей.
+
+Пока не будет найдено жизнеспособное решение, это ограничение сохранится.
+
 ---
 
+<details>
+
+<summary>
+
+# Runtime Moskva
+
+This runtime provides callable instances of `Runnable` functional interfaces. A
+`Runnable` is a class instance that can be invoked like a function.
+
+```js
+interface IRunnable {
+ run() {}
+}
+```
+
+</summary>
+
+<!-- Instances are allocated memory and can request compute via the event loop. -->
+
+## Usage
+
+An example below shows that even though `runner` is an instance, it can still be
+invoked as a function:
+
 ```js
-var runner2 = new class extends Runnable {
- // can't use fieldss / constructor
- // new_field = []
- const() {
-  this.test=['test']
+var{Runnable}=require('@moskva/runtime')
+
+var runner=new class extends Runnable {
+ const(){
+  this.test=[]
+  this.test.push(new Date)
+  // or this.test=['test']
  }
- run() {
-  console.log(' < Hello runner2; test =',this.test)
+ test2(){
+  return this.test
+ }
+ run(){
+  console.log(' < Hello runner; test =',this.test2())
  }
 }
 
-console.log('calling runner2:')
-runner2()
+console.log('calling runner:')
+runner()
 ```
+
 ```sh
-calling runner2:
- < Hello runner2; test = [ 'test' ]
+created new functional [class Runnable]
+calling runner:
+ < Hello runner; test = [ 2026-01-27T23:19:34.106Z ]
 ```
 
-Instances of standard, non-runnable classes cannot be invoked. This behaviour is
-only available when extending `Runnable`.
+### Purpose
+
+Since instances of standard, non-runnable classes cannot be invoked. This
+behaviour is only available when extending `Runnable`, to enable emulation of
+Java's functional interfaces that are supposed to implement 1 method.
 
 ## Implementation requirements
 
@@ -84,6 +144,9 @@ initialisers.
 
 Unless a viable solution is found, this limitation will remain.
 
+</details>
+
+
 ---
 
 (c) 2026