@simai-studio/ui 5.20261023.16 → 5.20261023.212

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."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/opening-the-record-as-a-page-is-offered-only-where-it-leads-somewhere.json

@@ -0,0 +1,28 @@
+{
+  "id": "opening-the-record-as-a-page-is-offered-only-where-it-leads-somewhere",
+  "intent": "record.open",
+  "capability": "record-open",
+  "summary": "The control that opens the record away from the panel is drawn only where the host declares it can open one.",
+  "given": {
+    "capabilities": [
+      "record-open"
+    ]
+  },
+  "when": {
+    "intent": "record.open",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "field": null,
+      "value": {
+        "value": "record-1",
+        "label": "Платежи",
+        "href": "/admin/cms/record-1"
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "note": "A host without this capability is not broken: the panel is the whole of the record, and the control is not drawn at all. An address is not enough to promise a page -- a host may have one to copy and nowhere to go, which is how a control that did nothing came to stand in every panel's strip."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/options-carry-the-source-and-a-limit.json

@@ -0,0 +1,33 @@
+{
+  "id": "options-carry-the-source-and-a-limit",
+  "intent": "field.options",
+  "capability": "field-options",
+  "summary": "The candidates of a lookup are asked for by its source, at most limit at a time, and answered as a page with a cursor.",
+  "given": {
+    "capabilities": [
+      "field-options"
+    ]
+  },
+  "when": {
+    "intent": "field.options",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "field": "country",
+      "cursor": null,
+      "search": "",
+      "source": "countries",
+      "limit": 20
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "options_page"
+    ],
+    "data_must_include": [
+      "options_page"
+    ],
+    "note": "items are {value, label}. A page holds no more than limit items; next_cursor null or absent says it is the last, whatever its length. total is optional."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/options-page-carries-a-cursor.json

@@ -0,0 +1,15 @@
+{
+  "id": "options-page-carries-a-cursor",
+  "intent": "field.options",
+  "capability": "field-options",
+  "summary": "Candidates arrive a page at a time with the cursor for the next page, never as the whole set.",
+  "given": {"capabilities": ["field-options"]},
+  "when": {"intent": "field.options", "payload": {"record_id": "record-1", "collection": "pages",
+            "field": "section", "cursor": null, "search": ""}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["options_page"],
+    "data_must_include": ["options_page"],
+    "note": "A host that answers with every candidate makes the component's paging meaningless and its own query unbounded. next_cursor absent or null means this was the last page."
+  }
+}

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

@@ -0,0 +1,14 @@
+{
+  "id": "options-refused-is-explained",
+  "intent": "field.options",
+  "capability": "field-options",
+  "summary": "A field whose candidates the host will not serve is refused with a reason, and the field falls back to its value rather than to an empty list.",
+  "given": {"capabilities": ["field-options"]},
+  "when": {"intent": "field.options", "payload": {"record_id": "record-1", "collection": "pages",
+            "field": "forbidden", "cursor": null, "search": ""}},
+  "then": {
+    "answer": "refused",
+    "answer_must_include": ["reason"],
+    "note": "An empty page and a refusal look identical in a list, and only one of them is something a person can act on."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/options-search-by-source-reaches-the-host.json

@@ -0,0 +1,30 @@
+{
+  "id": "options-search-by-source-reaches-the-host",
+  "intent": "field.options",
+  "capability": "field-options",
+  "summary": "A search inside a lookup is the host's, over the whole reference list, case-insensitively.",
+  "given": {
+    "capabilities": [
+      "field-options"
+    ]
+  },
+  "when": {
+    "intent": "field.options",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "field": "country",
+      "cursor": null,
+      "search": "рос",
+      "source": "countries",
+      "limit": 20
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "options_page"
+    ],
+    "note": "«рос» finds «Россия» and «Белоруссия» wherever they are in the list. The component never filters a page it holds: the page is not the whole list."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/options-search-reaches-the-host.json

@@ -0,0 +1,14 @@
+{
+  "id": "options-search-reaches-the-host",
+  "intent": "field.options",
+  "capability": "field-options",
+  "summary": "What the person typed is answered by the host, not by filtering the page the component already holds.",
+  "given": {"capabilities": ["field-options"]},
+  "when": {"intent": "field.options", "payload": {"record_id": "record-1", "collection": "pages",
+            "field": "section", "cursor": null, "search": "платеж"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["options_page"],
+    "note": "The page is not the whole set, so filtering it locally would hide every match that is not on it. A search resets the paging: the cursor is null again."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/options-without-the-capability.json

@@ -0,0 +1,14 @@
+{
+  "id": "options-without-the-capability",
+  "intent": "field.options",
+  "capability": "field-options",
+  "summary": "A host that does not announce the capability is never asked, and the field shows its value read-only.",
+  "given": {"capabilities": []},
+  "when": {"intent": "field.options", "payload": {"record_id": "record-1", "collection": "pages",
+            "field": "section", "cursor": null, "search": ""}},
+  "then": {
+    "answer": "unavailable",
+    "answer_must_include": ["reason"],
+    "note": "This is not a degraded state to apologise for: a reference field with no picker shows the value it has, which is strictly better than an empty control over a value that exists."
+  }
+}

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

@@ -0,0 +1,12 @@
+{
+  "id": "rare-fields-arrive-declared",
+  "intent": "record.load",
+  "summary": "Rare sections, groups and fields are marked by the host and sent every time; the component hides them until asked and changes no value by doing so.",
+  "given": {"capabilities": []},
+  "when": {"intent": "record.load", "payload": {"record_id": "record-1", "collection": "pages", "reason": "connected"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["record"],
+    "note": "A host that filters rare fields out of the answer makes «Показать редкие поля» a second read, and a person toggling a view twice would see two different objects. Marking them is the host's job; hiding them is the component's."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/removing-a-file-is-a-save.json

@@ -0,0 +1,13 @@
+{
+  "id": "removing-a-file-is-a-save",
+  "intent": "group.save",
+  "summary": "Removing a stored file is a value change like any other: it travels in group.save and nothing is deleted until the button is pressed.",
+  "given": {"capabilities": ["field-upload"]},
+  "when": {"intent": "group.save", "payload": {"record_id": "record-1", "collection": "pages",
+            "section": "main", "group": "files", "values": {"document": []}, "revision": "7"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["record"],
+    "note": "There is deliberately no remove intent. A file that disappeared from storage the moment someone pressed a cross, before saving, would be the one edit in this component that could not be cancelled -- and cancelling is the whole promise of saving by the button."
+  }
+}