@opetope/runtime 0.1.1 → 0.2.0

package/docs/spec.ru.md

@@ -55,8 +55,8 @@ const catalogCatalogFeature = defineFeature({
     ...calls(imports.platform, ['resolveItem']), // методы хоста как Call, один к одному
   }),
   exports: ({ own }) => ({ resolveItem: own.resolveItem }), // для фич, импортирующих это определение
-  provides: ({ port, own }) => ({
-    resolve: port(resolveItemPort, own.resolveItem), // порт для тех, кто его требует
+  provides: ({ port }) => ({
+    resolve: port(resolveItemPort, ({ own }) => own.resolveItem), // порт для тех, кто его требует
   }),
 });
 ```
@@ -103,17 +103,18 @@ const createFormFeature = defineFeature({
     order: model(OrderModel, { platform: imports.platform }, (ctx, { platform }) => createOrderModel(ctx, platform)),
     lookup: requires.resolveItem, // в `own` порт остаётся ref-ом
   }),
-  // здесь `own` уже материализован: и порт, и поле модели пришли живыми `Call`
-  exports: ({ own }) => ({ lookup: own.lookup, submit: own.order.submit }),
+  // потребители получают публичный Call lookup; submit остаётся внутри этой фичи
+  exports: ({ own }) => ({ lookup: own.lookup }),
   provides: ({ slot, pipe }) => ({
     // вклад это значение, фабрика экземпляра или дескриптор pipe; `priority` и `when` в опциях третьим
-    content: slot(orderFormContentSlot, ({ exports, model }) => ({
+    content: slot(orderFormContentSlot, ({ own, model }) => ({
       Component: CreateForm,
       // UI-модель вклада: создаётся на каждое монтирование и видит `props` именно этого монтирования
       models: [
         model(OrderActions, (ctx, props: Readable<OrderFormProps>) => ({
           submit: ctx.call({
-            run: (amount: number, { invoke }) => invoke(exports.submit, { amount, itemId: props.getSnapshot().itemId }),
+            run: (amount: number, { invoke }) =>
+              invoke(own.order.submit, { amount, itemId: props.getSnapshot().itemId }),
           }),
         })),
       ],
@@ -179,7 +180,7 @@ publication barrier. Всё это принадлежит runtime и его inte
 | `id`        | Как фича называется                         | `'feature.entity'`, только точки, без суффиксов                                                                                                                        |
 | `imports`   | Что мне дадут снаружи                       | запись из `defineHostContract` контрактов и определений других фич; `optional(x)` это слабое ребро, `onDemand(hostContract)` откладывает подключение до первого вызова |
 | `requires`  | Какой порт мне нужен                        | запись `port` или `optional(port)`; каждое `requires.x` это ref, а `Call` появляется у экземпляра                                                                      |
-| ref vs Call | Что видно в какой стадии                    | `own` и внешняя фабрика `provides` видят refs; `exports` и вложенные фабрики вкладов видят материализованные значения экземпляра                                       |
+| ref vs Call | Что видно в какой стадии                    | builder `own` видит refs зависимостей; `provides` видит только builders; `exports`, селекторы портов и фабрики вкладов видят готовые значения экземпляра               |
 | `own`       | Чем я владею                                | builder: `model`, `call`, `calls`, `lane`, `effect`, `event`, `resource`, `stream`, `scope`, `attach`                                                                  |
 | `exports`   | Что я отдаю фичам, которые меня импортируют | `({ own }) => запись Call, Readable и Resource` на открытии экземпляра                                                                                                 |
 | `provides`  | Что я предлагаю точкам расширения           | `({ port, slot, pipe, register, own }) => ...`                                                                                                                         |
@@ -267,13 +268,17 @@ input, а не автоматически переданным токеном о
 используется та же запись, без зависимостей — `model(Decl, create)`. Принимаются только подлинные импорты и call
 refs текущей фичи; optional-импорты сохраняют `Readable<Lookup<…>>`. Сырые объекты хоста, декларации портов,
 чужие refs и refs моделей не являются элементами зависимостей. Именованная фабрика может объявить свой интерфейс
-зависимостей, не видя контекста фичи. `provides.port(SubmitPort, { from: own.order, select: order => order.submit })`
-один раз выбирает подлинный вызов из готовой модели до публикации и добавляет фенс провайдера, включая
-переданные напрямую вызовы. Локальный call ref по-прежнему использует `port(SubmitPort, own.submit)` (D169).
+зависимостей, не видя контекста фичи. `port(SubmitPort, ({ own }) => own.order.submit)` один раз выбирает подлинный
+вызов из `own` текущего экземпляра при подготовке, до readiness и публикации вкладов, и добавляет фенс провайдера,
+включая переданные напрямую вызовы. `port(SubmitPort, ({ own }) => own.submit)` выбирает вызов, объявленный прямо
+в `own`. Селектор получает только `{ own }`; результатом должен быть подлинный Call из значения, выбранного им
+в этом `own`, в том числе из поля модели. Чужие Calls и обычные функции отвергаются. Прямые refs и дескрипторы
+`{ from, select }` не принимаются. Retirement внутри селектора прекращает запуск следующих селекторов и дренирует
+уже владеемую работу (D255).
 
 Моделей у вклада два вида, и обе объявлены одним `defineModel`. Модели `own` живут с экземпляром фичи и служатся
 монтированию автоматически. UI-модель вклада живёт с монтированием: она перечислена в `models` вклада, её фабрика
-получает вторым аргументом `Readable` пропсов этого монтирования и берёт поля как есть (`submit: exports.submit`)
+получает вторым аргументом `Readable` пропсов этого монтирования и берёт поля как есть (`submit: own.order.submit`)
 или оборачивает их в `ctx.call`, когда контракт UI отличается входом, формой результата или числом фичевых вызовов.
 Отдельного понятия View нет.
 
@@ -437,17 +442,26 @@ scope: отдельный концепт, а не второе имя фичи.
 `event`, `resource`, `stream`, `scope.while`, `scope.switch`, `scope.keyed`, `attach`. У `resource`,
 `stream` и `event` источник и носитель вывода типа позиционные: `resource(from, target, {…})`,
 `stream(from, target, {…})`, `event(from, subscribe, {…})`; порядок ключей в объекте опций свободен. Одна опция
-несёт для обоих одно слово: `stream` требует `backpressure: latest()`, а `event` его допускает. Методы `provides`:
-`port`, `slot`, `pipe`, `register`; у вкладов цель первым аргументом, значение или фабрика экземпляра вторым, опции
+несёт для обоих одно слово: `stream` требует `backpressure: latest()`, а `event` его допускает. Внешняя фабрика
+`provides` получает ровно `{ port, slot, pipe, register }`: только builders, без `own` и других значений экземпляра.
+`port(Port, ({ own }) => own.model.call)` записывает цель при объявлении, а Call выбирает при подготовке экземпляра.
+У вкладов цель первым аргументом, значение или фабрика экземпляра вторым, опции
 третьим: `slot(target, contribution, { priority, when })`, `pipe(target, { fold }, { priority, when })`,
 `register(target, entry, { priority, when })`, причём у `pipe` второй аргумент это дескриптор, потому что голую
-функцию было бы не отличить от фабрики экземпляра. Контекст фабрики вклада это `{ exports, imports, instance, model, own }`, и его
-`model(Decl, create)` строит UI-модель монтирования, где `create` получает `(ctx, props)`. `when` это
-`Readable<boolean>` или предикат экземпляра — `({ exports, imports, own, read }) => boolean`, — чей `read`
+функцию было бы не отличить от фабрики экземпляра. Фабрика `register` получает `{ own, imports }`, а фабрика
+`slot` — `{ own, imports, model }`, где `model(Decl, create)` строит UI-модель монтирования и `create` получает
+`(ctx, props)`. Контексты содержат только перечисленные поля: `exports` и `instance` отсутствуют, а у `register`
+нет построителя моделей (D255). В обеих вложенных фабриках `own` содержит материализованные модели, вызовы и
+ресурсы этого экземпляра, как в `exports`. `register(target, ({ own }) => ({ key: 'submit', value: own.order.submit }))`
+публикует вызов внутренней модели без секции `exports`. Селекторы портов и фабрики вкладов выбирают готовые
+значения через собственный контекст колбэка. У вложений, scopes,
+effects и events нет доступной для чтения формы значения; невыбранные поля не мешают обращаться к соседней
+модели или вызову. `when` это
+`Readable<boolean>` или предикат экземпляра — `({ own, imports, read }) => boolean`, — чей `read`
 записывает, от чего зависит ответ: пока ответ `false`, вклад не входит в `entries` цели. В этом контексте
 вычисления `own` дан в материализованной форме, которую видит `exports`: поле модели это `Readable`, а не ref из
-контекста фабрики. `fold` дескриптора `pipe` получает третьим аргументом тот же контекст вычисления —
-`(value, meta, { exports, imports, own, read }) => …`, — связанный с экземпляром один раз при публикации вклада и
+builder `own`. `fold` дескриптора `pipe` получает третьим аргументом тот же контекст вычисления —
+`(value, meta, { own, imports, read }) => …`, — связанный с экземпляром один раз при публикации вклада и
 вызываемый только сверткой, а не при объявлении или предзагрузке; а `target.fold(value, meta, read?)` принимает
 читателя третьим параметром, поэтому `computed({ read: read => target.fold(0, undefined, read) })` подписывается и
 на `entries`, и на всё, что прочитали обработчики; без читателя обработчики читают текущий snapshot. Контексты:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opetope/runtime",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "engines": {
     "node": ">=20.19.0"
   },
@@ -52,10 +52,10 @@
     }
   ],
   "devDependencies": {
-    "@opetope/core": "0.1.1"
+    "@opetope/core": "0.2.0"
   },
   "peerDependencies": {
-    "@opetope/core": "0.1.1"
+    "@opetope/core": "0.2.0"
   },
   "sideEffects": false,
   "description": "Feature composition and owned lifecycles for Opetope.",