@moskva/runtime 0.1.1 → 0.1.3

package/changes.md

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

package/package.json

@@ -1,8 +1,45 @@
 {
  "name": "@moskva/runtime",
- "version": "0.1.1",
+ "version": "0.1.3",
+ "description": "JavaScript-рантайм «Москва» с Java-подобной моделью выполнения: вызываемые Runnable-экземпляры, изоляция памяти и предсказуемая инициализация.",
  "scripts": {
   "t": "git tag @javish/base-v$(node -p \"require('./package.json').version\") && git push --tags"
  },
- "homepage": "рантайм.москва"
+ "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,9 +1,81 @@
-# Runtime Moskva
+# Рантайм Москва
 
 <p>
-<img src=./MOCKBA-500.png>
+<img src="https://media-743523.gitlab.io/img/mockba3-500.jpg" alt="РАНТАЙМ МОСКВА СПЛЕШ СКРИН">
 </p>
 
+Этот рантайм предоставляет вызываемые экземпляры функциональных интерфейсов
+`Runnable`. `Runnable` — это экземпляр класса, который можно вызывать как
+функцию.
+
+```js
+interface IRunnable {
+ run() {}
+}
+```
+
+## Использование
+
+Пример ниже показывает, что несмотря на то, что `runner` является экземпляром класса, его всё равно можно вызывать как функцию:
+
+```js
+var{Runnable}=require('@moskva/runtime')
+
+var runner=new class extends Runnable {
+ const(){
+  this.test=[]
+  this.test.push(new Date)
+  // или this.test=['test']
+ }
+ test2(){
+  return this.test
+ }
+ run(){
+  console.log(' < Hello runner; test =',this.test2())
+ }
+}
+
+console.log('calling runner:')
+runner()
+```
+
+```sh
+created new functional [class Runnable]
+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.
 
@@ -13,6 +85,8 @@ interface IRunnable {
 }
 ```
 
+</summary>
+
 <!-- Instances are allocated memory and can request compute via the event loop. -->
 
 ## Usage
@@ -70,6 +144,9 @@ initialisers.
 
 Unless a viable solution is found, this limitation will remain.
 
+</details>
+
+
 ---
 
 (c) 2026