@simai-studio/ui 5.20261023.126 → 5.20261023.212

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

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

@@ -0,0 +1,26 @@
+{
+  "id": "save-applied-is-one-revision",
+  "intent": "record.save",
+  "summary": "A whole-object save is one revision carrying only the changed fields.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "record.save",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "values": {
+        "title": "Другое название",
+        "slug": "other"
+      },
+      "revision": "7"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ]
+  }
+}

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

@@ -0,0 +1,36 @@
+{
+  "id": "save-may-ask-for-a-confirmation",
+  "intent": "record.save",
+  "summary": "A whole-object save may be confirmed first, the same way as a group save.",
+  "given": {
+    "capabilities": [],
+    "confirms": [
+      "record.save"
+    ]
+  },
+  "when": {
+    "intent": "record.save",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "contracts",
+      "values": {
+        "type": {
+          "value": "framework",
+          "label": "Рамочный"
+        }
+      },
+      "revision": "7"
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason",
+      "confirm"
+    ],
+    "data_must_include": [
+      "confirm"
+    ],
+    "note": "reason is confirm_required. Raised again with confirm set to the digest, the same payload is applied."
+  }
+}

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

@@ -0,0 +1,23 @@
+{
+  "id": "save-stale-revision-is-a-conflict",
+  "intent": "record.save",
+  "summary": "A whole-object save against a moved revision is a conflict, never an overwrite.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "record.save",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "values": {
+        "title": "Другое название"
+      },
+      "revision": "6"
+    }
+  },
+  "then": {
+    "answer": "conflict",
+    "note": "The person's values stay on screen with the conflict said."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/the-address-is-the-hosts.json

@@ -0,0 +1,12 @@
+{
+  "id": "the-address-is-the-hosts",
+  "intent": "record.load",
+  "summary": "A window's address comes with the object, and a host that sends none gets no copy or open controls rather than an invented link.",
+  "given": {"capabilities": []},
+  "when": {"intent": "record.load", "payload": {"record_id": "record-1", "collection": "pages", "reason": "connected"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["record"],
+    "note": "record.address is optional. The component copies it and opens it and constructs nothing: a composite that guessed at a URL would be guessing at the consumer's routing, and would be wrong first in whichever consumer did not match the guess."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/upload-answers-with-the-stored-file.json

@@ -0,0 +1,14 @@
+{
+  "id": "upload-answers-with-the-stored-file",
+  "intent": "field.upload",
+  "capability": "field-upload",
+  "summary": "A file the person chose is stored by the host, which answers with it in the shape the field reads.",
+  "given": {"capabilities": ["field-upload"]},
+  "when": {"intent": "field.upload", "payload": {"record_id": "record-1", "collection": "pages",
+            "field": "document", "file": "<the File the person chose>"}},
+  "then": {
+    "answer": "applied",
+    "answer_must_include": ["file"],
+    "note": "The answer carries {value, label, mime?, href?} -- the same shape the field already reads -- so the view shows the stored file without a second read. The File is passed as it is: a component that encoded it to base64 would double the bytes of every upload for nothing."
+  }
+}

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

@@ -0,0 +1,14 @@
+{
+  "id": "upload-refused-is-explained",
+  "intent": "field.upload",
+  "capability": "field-upload",
+  "summary": "A file the host will not take is refused with a reason the field shows, and nothing is added to the value.",
+  "given": {"capabilities": ["field-upload"]},
+  "when": {"intent": "field.upload", "payload": {"record_id": "record-1", "collection": "pages",
+            "field": "document", "file": "<a file too large, or of a kind the host rejects>"}},
+  "then": {
+    "answer": "refused",
+    "answer_must_include": ["reason"],
+    "note": "The reason is shown under the field. A silent failure leaves a person looking at a field that did not change and no way to know why."
+  }
+}

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

@@ -0,0 +1,32 @@
+{
+  "intent": "view.create",
+  "summary": "Making a view answers with the record through it: a person who has just made one is looking at it.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.create",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "label": "Для продаж",
+      "shared": true,
+      "view": {
+        "schema_version": 1,
+        "sections": {},
+        "groups": {},
+        "fields": {}
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "The answer carries the record and its view, so the new view's id and its place in the list come from the host rather than being guessed at here."
+  },
+  "id": "view-create-answers-with-the-record-through-the-new-view"
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-create-shared-may-be-refused.json

@@ -0,0 +1,27 @@
+{
+  "intent": "view.create",
+  "summary": "A person who may not write the shared layer may not make a shared view either.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.create",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "label": "Для всех",
+      "shared": true,
+      "view": {}
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "The same right that governs the shared layer governs a shared view; saying so is what stops a person making one and losing it on the next read."
+  },
+  "id": "view-create-shared-may-be-refused"
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-delete-applied-answers-with-what-is-left.json

@@ -0,0 +1,25 @@
+{
+  "intent": "view.delete",
+  "summary": "Removing a view answers with the record through whichever view is now current.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.delete",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "profile": "mine"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "Deleting the view a person was looking at leaves them looking at something; which one is the host's to decide and is said in the answer."
+  },
+  "id": "view-delete-applied-answers-with-what-is-left"
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-delete-the-last-shared-one-is-refused.json

@@ -0,0 +1,25 @@
+{
+  "intent": "view.delete",
+  "summary": "The last shared view cannot be removed: a scope with none has nothing for a person who has made none of their own.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.delete",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "profile": "default"
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "The component does not offer the control in that case either, so this refusal is a guard rather than the way a person finds out."
+  },
+  "id": "view-delete-the-last-shared-one-is-refused"
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-profile-applied-carries-the-record-through-it.json

@@ -0,0 +1,25 @@
+{
+  "id": "view-profile-applied-carries-the-record-through-it",
+  "intent": "view.profile",
+  "summary": "Choosing a view answers with the record read through it, because a view is a whole arrangement rather than a filter over the one already on screen.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.profile",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "profile": "expert"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "Answering applied with nothing else would leave the component holding the old arrangement under a new name."
+  }
+}

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

@@ -0,0 +1,25 @@
+{
+  "id": "view-profile-refused-is-explained",
+  "intent": "view.profile",
+  "summary": "A view this person may not open is refused with a reason, not silently ignored.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.profile",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "profile": "profile-forbidden"
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "Without the reason a chooser that snaps back looks broken rather than guarded."
+  }
+}

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

@@ -0,0 +1,23 @@
+{
+  "id": "view-profile-unavailable-without-the-capability",
+  "intent": "view.profile",
+  "summary": "A host that does not configure views cannot switch between them either.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "view.profile",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "profile": "expert"
+    }
+  },
+  "then": {
+    "answer": "unavailable",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "The component draws no chooser without the capability; this is what a host answers if one is asked for anyway."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-rename-changes-the-label-only.json

@@ -0,0 +1,26 @@
+{
+  "intent": "view.rename",
+  "summary": "A rename changes the label. The id is permanent, so anything pointing at the view keeps pointing at it.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.rename",
+    "payload": {
+      "record_id": "record-1",
+      "collection": "pages",
+      "profile": "expert",
+      "label": "Экспертный режим"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "record"
+    ],
+    "note": "Answering with the record is how the list of views comes back renamed without a second read."
+  },
+  "id": "view-rename-changes-the-label-only"
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-reset-answers-with-what-now-resolves.json

@@ -0,0 +1,30 @@
+{
+  "id": "view-reset-answers-with-what-now-resolves",
+  "intent": "view.reset",
+  "capability": "view-settings",
+  "summary": "Clearing a layer answers with the arrangement that resolves after it is gone, so the panel redraws without reading the record again.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.reset",
+    "payload": {
+      "record_id": null,
+      "collection": "pages",
+      "target": {
+        "kind": "personal",
+        "revision": "v7"
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "revision",
+      "view"
+    ],
+    "note": "A reset is a write against the revision, not a deletion, and the component never sends its own idea of the defaults -- the host owns those, and writing them would overwrite them with a guess. The answer carries what now resolves because a second read would show the person a reload for a change they already made."
+  }
+}

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

@@ -0,0 +1,36 @@
+{
+  "id": "view-save-against-a-stale-revision-is-a-conflict",
+  "intent": "view.save",
+  "capability": "view-settings",
+  "summary": "A save against a revision someone else has moved past is a conflict carrying the layer as it now stands.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.save",
+    "payload": {
+      "record_id": null,
+      "collection": "pages",
+      "target": {
+        "kind": "shared",
+        "revision": "v2"
+      },
+      "view": {
+        "schema_version": 1,
+        "sections": {},
+        "groups": {},
+        "fields": {}
+      }
+    }
+  },
+  "then": {
+    "answer": "conflict",
+    "answer_must_include": [
+      "revision",
+      "view"
+    ],
+    "note": "The conflict carries the stored layer, not only the revision. Without it the component would be left drawing an arrangement nobody stored, and the person would go on dragging fields in a view that no longer exists."
+  }
+}

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

@@ -0,0 +1,35 @@
+{
+  "id": "view-save-is-one-layer-one-revision",
+  "intent": "view.save",
+  "capability": "view-settings",
+  "summary": "A change to the arrangement writes the whole layer against its revision and answers with the revision the layer now has.",
+  "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": {}
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "revision"
+    ],
+    "note": "The layer is sent whole, never as a patch of the entry that changed. Two people reordering the same view with per-entry writes would interleave into an arrangement neither of them chose; whole-layer compare-and-set makes them collide, which is the same reason a group saves as one revision."
+  }
+}