@simai-studio/ui 5.20261023.126 → 5.20261023.212

package/README.md

@@ -1,11 +1,11 @@
 # @simai-studio/ui
 
-SIMAI Framework, release `ui-22d6367046c5` (commit 22d6367046c5240c5b4ffbd7f7853dffc3207396 of [simai/ui](https://github.com/simai/ui)).
+SIMAI Framework, release `ui-720203c5b5e5` (commit 720203c5b5e5186e2d44f6e1f8d9c23a0e410cc1 of [simai/ui](https://github.com/simai/ui)).
 
 ```html
-<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@simai-studio/ui@5.20261023.126/distr/core/css/core.css">
-<script>window.sfPath = 'https://cdn.jsdelivr.net/npm/@simai-studio/ui@5.20261023.126/distr/';</script>
-<script src="https://cdn.jsdelivr.net/npm/@simai-studio/ui@5.20261023.126/distr/core/js/core.js"></script>
+<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@simai-studio/ui@5.20261023.212/distr/core/css/core.css">
+<script>window.sfPath = 'https://cdn.jsdelivr.net/npm/@simai-studio/ui@5.20261023.212/distr/';</script>
+<script src="https://cdn.jsdelivr.net/npm/@simai-studio/ui@5.20261023.212/distr/core/js/core.js"></script>
 ```
 
 Components, utilities and Smart Components ship in their minified form (the Loader asks for it); Core in both forms. Documentation: https://ui.simai.io/

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/a-field-hidden-by-its-condition-is-not-saved.json

@@ -0,0 +1,45 @@
+{
+  "id": "a-field-hidden-by-its-condition-is-not-saved",
+  "intent": "group.save",
+  "summary": "A field its condition hides is absent from the save, and the host keeps what it holds.",
+  "given": {
+    "capabilities": [],
+    "fields": [
+      {
+        "key": "type",
+        "value": "framework"
+      },
+      {
+        "key": "valid_until",
+        "value": "2027-01-01",
+        "when": {
+          "visible": {
+            "field": "type",
+            "op": "eq",
+            "value": "framework"
+          }
+        }
+      }
+    ]
+  },
+  "when": {
+    "intent": "group.save",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "section": "main",
+      "group": "terms",
+      "values": {
+        "type": "single"
+      },
+      "revision": "7"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "valid_until is hidden once the type is single, so it is not in values -- and it is not emptied: the record answered still holds 2027-01-01. Hidden by a condition is not the same as cleared."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/a-field-says-what-it-falls-back-to.json

@@ -0,0 +1,12 @@
+{
+  "id": "a-field-says-what-it-falls-back-to",
+  "intent": "record.load",
+  "summary": "A field that holds nothing and falls back to something says what it falls back to, so a person can tell «not set» from «set to the same value».",
+  "given": {"capabilities": []},
+  "when": {"intent": "record.load", "payload": {"record_id": "record-1", "collection": "pages", "reason": "connected"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["record"],
+    "note": "`inherited` says that a value comes from somewhere else; `inheritedValue` says what it is. Both are needed: a colour inherited from the theme and a colour chosen to match the theme look identical on screen, and only the first follows the theme when the theme moves. A running Larena site inherits fourteen colours this way, which is why the pair exists."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/a-field-taken-out-of-an-area-is-unplaced.json

@@ -0,0 +1,40 @@
+{
+  "id": "a-field-taken-out-of-an-area-is-unplaced",
+  "intent": "view.save",
+  "capability": "view-settings",
+  "summary": "A field removed from an area is written with a null group and comes back in `unplaced`, not as a hidden field.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.save",
+    "payload": {
+      "record_id": null,
+      "collection": "pages",
+      "target": {
+        "kind": "personal",
+        "revision": "v7"
+      },
+      "view": {
+        "schema_version": 1,
+        "sections": {},
+        "groups": {},
+        "fields": {
+          "code": {
+            "group": null,
+            "order": 1
+          }
+        }
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "revision"
+    ],
+    "note": "Hiding and taking out are different things and the port has both. A hidden field is one the layer above may have hidden for everyone; an unplaced field belongs to no area and is offered back where areas take fields. Answering a null group with a hidden field would make removal look permanent."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/a-reader-is-offered-nothing-to-change.json

@@ -0,0 +1,23 @@
+{
+  "id": "a-reader-is-offered-nothing-to-change",
+  "intent": "record.load",
+  "summary": "A person who may only read gets the record with no record.edit and no lifecycle act among its actions.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "record.load",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "reason": "connected"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "actions is [] or names only what this person may do; the component draws no edit, no footer and no delete for it."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/a-related-group-is-a-list-not-fields.json

@@ -0,0 +1,23 @@
+{
+  "id": "a-related-group-is-a-list-not-fields",
+  "intent": "record.load",
+  "summary": "A group marked «related» holds other records rather than fields. The component composes a data view in it, and that view asks the host for its own port.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "record.load",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "reason": "connected"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "The records themselves never travel through this port. A related list asks for a data-view port by raising sf-host-port-request with the owner, the record and the group, and the host answers with the port it already implements for collections. Routing rows, columns, sorting and paging through the property-view seam instead would duplicate a whole vocabulary and make the property view a relay for one it does not speak."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/a-stale-confirmation-is-asked-again.json

@@ -0,0 +1,39 @@
+{
+  "id": "a-stale-confirmation-is-asked-again",
+  "intent": "group.save",
+  "summary": "A digest that no longer matches the save -- the values or the object moved since it was issued -- is answered with a new confirmation, not applied.",
+  "given": {
+    "capabilities": [],
+    "confirms": [
+      "group.save"
+    ]
+  },
+  "when": {
+    "intent": "group.save",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "section": "main",
+      "group": "terms",
+      "values": {
+        "type": {
+          "value": "single",
+          "label": "Разовый"
+        }
+      },
+      "revision": "7",
+      "confirm": "c0ffee"
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason",
+      "confirm"
+    ],
+    "data_must_include": [
+      "confirm"
+    ],
+    "note": "reason is confirm_required again, with a new summary and digest. The component shows the new summary; a person confirms what will actually happen."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/conditions-arrive-declared.json

@@ -0,0 +1,82 @@
+{
+  "id": "conditions-arrive-declared",
+  "intent": "record.load",
+  "summary": "A field may carry when: the conditions under which it is shown, required and enabled, over the other fields' values.",
+  "given": {
+    "capabilities": [],
+    "fields": [
+      {
+        "key": "type",
+        "propertyType": "choice",
+        "options": [
+          {
+            "value": "single",
+            "label": "Разовый"
+          },
+          {
+            "value": "framework",
+            "label": "Рамочный"
+          }
+        ],
+        "value": "single"
+      },
+      {
+        "key": "valid_until",
+        "propertyType": "date",
+        "value": "2027-01-01",
+        "when": {
+          "visible": {
+            "field": "type",
+            "op": "eq",
+            "value": "framework"
+          },
+          "required": {
+            "all": [
+              {
+                "field": "type",
+                "op": "eq",
+                "value": "framework"
+              },
+              {
+                "field": "valid_until",
+                "op": "empty"
+              }
+            ]
+          }
+        }
+      },
+      {
+        "key": "amount",
+        "propertyType": "number",
+        "value": 1000,
+        "when": {
+          "enabled": {
+            "not": {
+              "field": "status",
+              "op": "in",
+              "value": [
+                "signed",
+                "closed"
+              ]
+            }
+          }
+        }
+      }
+    ]
+  },
+  "when": {
+    "intent": "record.load",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "reason": "connected"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "The component evaluates the conditions as the person edits. valid_until is hidden while the type is single, and keeps 2027-01-01."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/create-applied-answers-with-the-id.json

@@ -0,0 +1,24 @@
+{
+  "id": "create-applied-answers-with-the-id",
+  "intent": "record.create",
+  "summary": "Pressing create sends the filled fields once; the host answers with the new object's id.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "record.create",
+    "payload": {
+      "collection": "pages",
+      "values": {
+        "title": "Новая страница"
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record_id"
+    ],
+    "note": "With the record too, when the host has it at hand; the component reads it otherwise."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/create-field-errors-are-refused.json

@@ -0,0 +1,22 @@
+{
+  "id": "create-field-errors-are-refused",
+  "intent": "record.create",
+  "summary": "A create the host will not make comes back refused with errors keyed by field.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "record.create",
+    "payload": {
+      "collection": "pages",
+      "values": {}
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "errors"
+    ],
+    "note": "Each error stands under its own field; what the person typed stays."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/field-presentation-keys-are-declared.json

@@ -0,0 +1,12 @@
+{
+  "id": "field-presentation-keys-are-declared",
+  "intent": "record.load",
+  "summary": "A field carries the words and limits its control needs -- the call to action and the readable formats of a file field, the accept list its dialog filters by, a placeholder, a search placeholder, a badge appearance, a readonly mark. All of them are the host's, and an answer carrying them is applied.",
+  "given": {"capabilities": ["field-upload"]},
+  "when": {"intent": "record.load", "payload": {"record_id": "record-1", "collection": "pages", "reason": "connected"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["record"],
+    "note": "This case exists because the field schema is closed. A host that validates its own answers against this port was refused for sending uploadText, formats and accept -- keys the renderer set has always read but the port never declared, which is the port lying about the seam rather than the host getting it wrong. A field control with no words of its own falls back to the component's default, and a file control's default names image formats, which is wrong for a field that takes any file."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/group-save-applied-is-one-revision.json

@@ -0,0 +1,16 @@
+{
+  "id": "group-save-applied-is-one-revision",
+  "intent": "group.save",
+  "summary": "Pressing save sends one intent carrying only the changed fields, and the host answers with the object at its new revision.",
+  "given": {"capabilities": []},
+  "when": {
+    "intent": "group.save",
+    "payload": {"record_id": "record-1", "collection": "pages", "section": "main", "group": "about",
+                "values": {"title": "Новое название"}, "revision": "7"}
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["record"],
+    "note": "One press, one intent, one revision. A field the person did not touch is absent from values, so a save cannot overwrite what another save changed meanwhile."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/group-save-confirmed-with-the-digest-is-applied.json

@@ -0,0 +1,35 @@
+{
+  "id": "group-save-confirmed-with-the-digest-is-applied",
+  "intent": "group.save",
+  "summary": "The same save raised again with confirm set to the digest is applied as one revision.",
+  "given": {
+    "capabilities": [],
+    "confirms": [
+      "group.save"
+    ]
+  },
+  "when": {
+    "intent": "group.save",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "section": "main",
+      "group": "terms",
+      "values": {
+        "type": {
+          "value": "framework",
+          "label": "Рамочный"
+        }
+      },
+      "revision": "7",
+      "confirm": "c0ffee"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "c0ffee stands for the digest the host answered the first raise with. The values are the same ones; a digest the host did not issue for this save is not applied."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/group-save-field-errors-are-refused.json

@@ -0,0 +1,16 @@
+{
+  "id": "group-save-field-errors-are-refused",
+  "intent": "group.save",
+  "summary": "Values the host will not accept come back refused with errors keyed by field, and each error is shown under its own field.",
+  "given": {"capabilities": []},
+  "when": {
+    "intent": "group.save",
+    "payload": {"record_id": "record-1", "collection": "pages", "section": "main", "group": "about",
+                "values": {"title": "", "count": "many"}, "revision": "7"}
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": ["errors"],
+    "note": "errors is keyed by field key, so the component can place each message under the field it belongs to. A single sentence for the whole group leaves a person hunting for which field is wrong."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/group-save-may-ask-for-a-confirmation.json

@@ -0,0 +1,38 @@
+{
+  "id": "group-save-may-ask-for-a-confirmation",
+  "intent": "group.save",
+  "summary": "A save the host will make only once confirmed is refused with confirm_required and says what it will do, with a digest.",
+  "given": {
+    "capabilities": [],
+    "confirms": [
+      "group.save"
+    ]
+  },
+  "when": {
+    "intent": "group.save",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "section": "main",
+      "group": "terms",
+      "values": {
+        "type": {
+          "value": "framework",
+          "label": "Рамочный"
+        }
+      },
+      "revision": "7"
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason",
+      "confirm"
+    ],
+    "data_must_include": [
+      "confirm"
+    ],
+    "note": "reason is confirm_required; confirm is {summary, digest}. Nothing is written yet. The component shows the summary and keeps what the person entered."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/group-save-stale-revision-is-a-conflict.json

@@ -0,0 +1,16 @@
+{
+  "id": "group-save-stale-revision-is-a-conflict",
+  "intent": "group.save",
+  "summary": "A save against a revision the host has moved past is a conflict, never a silent overwrite.",
+  "given": {"capabilities": []},
+  "when": {
+    "intent": "group.save",
+    "payload": {"record_id": "record-1", "collection": "pages", "section": "main", "group": "about",
+                "values": {"title": "Новое название"}, "revision": "6"}
+  },
+  "then": {
+    "answer": "conflict",
+    "answer_must_include": ["reason"],
+    "note": "The component keeps what the person typed and says the object moved. Answering applied here would lose somebody else's save without anyone being told."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/load-applied-carries-the-object.json

@@ -0,0 +1,12 @@
+{
+  "id": "load-applied-carries-the-object",
+  "intent": "record.load",
+  "summary": "An applied read carries the object with its sections, groups and fields, and the revision a later write will be compared against.",
+  "given": {"capabilities": []},
+  "when": {"intent": "record.load", "payload": {"record_id": "record-1", "collection": "pages", "reason": "connected"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["record"],
+    "note": "record.sections is required even when there is one section: the arrangement is the host's, and a flat list of values would make the component invent one."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/load-for-create-is-an-empty-object.json

@@ -0,0 +1,24 @@
+{
+  "id": "load-for-create-is-an-empty-object",
+  "intent": "record.load",
+  "summary": "A create surface reads an empty object of the collection: no record_id, no revision, the collection's arrangement, defaults filled.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "record.load",
+    "payload": {
+      "record_id": null,
+      "collection": "pages",
+      "reason": "connected",
+      "mode": "create"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "The same sections and groups a record of the collection is shown in, so arranging the view once arranges creating too."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/load-late-answer-is-dropped.json

@@ -0,0 +1,15 @@
+{
+  "id": "load-late-answer-is-dropped",
+  "intent": "record.load",
+  "summary": "Two reads in flight: the answer to the earlier one is dropped and never drawn over the later object.",
+  "given": {"capabilities": []},
+  "when": {
+    "intent": "record.load",
+    "payload": {"record_id": "record-2", "collection": "pages", "reason": "record-id-changed"},
+    "after": {"intent": "record.load", "payload": {"record_id": "record-1", "collection": "pages", "reason": "connected"}}
+  },
+  "then": {
+    "answer": "applied",
+    "note": "The host may answer in either order. The component counts its own asks and renders only the newest, so a slow first answer cannot replace the object a person is now looking at."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/load-refused-is-explained.json

@@ -0,0 +1,12 @@
+{
+  "id": "load-refused-is-explained",
+  "intent": "record.load",
+  "summary": "A read the host will not serve is refused with a reason, and the component shows the refusal rather than an empty object.",
+  "given": {"capabilities": []},
+  "when": {"intent": "record.load", "payload": {"record_id": "record-forbidden", "collection": "pages", "reason": "requested"}},
+  "then": {
+    "answer": "refused",
+    "answer_must_include": ["reason"],
+    "note": "An empty arrangement and a refused read look identical on screen unless the refusal is said out loud, and the second is the one a person can act on."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/load-unavailable-is-honest.json

@@ -0,0 +1,12 @@
+{
+  "id": "load-unavailable-is-honest",
+  "intent": "record.load",
+  "summary": "A host that cannot answer right now says unavailable; it never answers applied with an empty object.",
+  "given": {"capabilities": []},
+  "when": {"intent": "record.load", "payload": {"record_id": "record-1", "collection": "pages", "reason": "requested"}},
+  "then": {
+    "answer": "unavailable",
+    "answer_must_include": ["reason"],
+    "note": "applied with no sections would be read as an object that genuinely has no fields."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/lookup-arrives-with-its-label.json

@@ -0,0 +1,70 @@
+{
+  "id": "lookup-arrives-with-its-label",
+  "intent": "record.load",
+  "summary": "A lookup field carries its value as {value, label} -- a list of them when it is multiple -- and names the reference list it is chosen from.",
+  "given": {
+    "capabilities": [
+      "field-options"
+    ],
+    "fields": [
+      {
+        "key": "country",
+        "propertyType": "lookup",
+        "source": "countries",
+        "value": {
+          "value": "RU",
+          "label": "Россия"
+        }
+      },
+      {
+        "key": "regions",
+        "propertyType": "lookup",
+        "source": "regions",
+        "multiple": true,
+        "value": [
+          {
+            "value": 77,
+            "label": "Москва"
+          },
+          {
+            "value": 78,
+            "label": "Санкт-Петербург"
+          }
+        ]
+      },
+      {
+        "key": "status",
+        "propertyType": "lookup",
+        "options": [
+          {
+            "value": "draft",
+            "label": "Черновик"
+          },
+          {
+            "value": "signed",
+            "label": "Подписан"
+          }
+        ],
+        "value": {
+          "value": "draft",
+          "label": "Черновик"
+        }
+      }
+    ]
+  },
+  "when": {
+    "intent": "record.load",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "reason": "connected"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "The label travels with the value, so the view shows «Россия» without a second read. A short list arrives as options and is chosen from in place; a long one is named by source and paged by field.options."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/opening-a-reference-is-the-hosts-decision.json

@@ -0,0 +1,12 @@
+{
+  "id": "opening-a-reference-is-the-hosts-decision",
+  "intent": "record.open",
+  "summary": "Activating a reference value asks the host what to open; the component follows no link and opens no window by itself.",
+  "given": {"capabilities": []},
+  "when": {"intent": "record.open", "payload": {"record_id": "record-1", "collection": "pages",
+            "field": "section", "value": {"value": "record-0317", "label": "Платежи", "href": "/admin/cms/record-0317"}}},
+  "then": {
+    "answer": "applied",
+    "note": "The host may push another panel, route to a full page, or refuse. Two decisions it must keep: following the href would be the component routing for the consumer, and opening a window itself would be the component deciding whether a half-edited window may be covered. Each window is its own element, so one left mid-edit underneath another keeps its unsaved changes."
+  }
+}