@simai-studio/ui 5.20261023.16 → 5.20261023.214

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

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-save-may-name-an-area-the-record-does-not-carry.json

@@ -0,0 +1,49 @@
+{
+  "id": "view-save-may-name-an-area-the-record-does-not-carry",
+  "intent": "view.save",
+  "capability": "view-settings",
+  "summary": "A layer may name an area or a section the record does not carry. The host keeps it and returns it in the next read, or refuses with its reason.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.save",
+    "payload": {
+      "record_id": null,
+      "collection": "pages",
+      "target": {
+        "kind": "personal",
+        "revision": "v7"
+      },
+      "view": {
+        "schema_version": 1,
+        "sections": {
+          "view-section-m1": {
+            "label": "Договоры",
+            "order": 2,
+            "hidden": false
+          }
+        },
+        "groups": {
+          "view-group-m1": {
+            "label": "Договор",
+            "section": "view-section-m1",
+            "order": 1,
+            "columns": 1,
+            "hidden": false
+          }
+        },
+        "fields": {}
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "answer_must_include": [
+      "revision"
+    ],
+    "note": "This is the one act of arranging that does not rearrange what the host sent: it names something new. The component draws it at once from the layer, so a person sees what they made, but it survives the next record.load only if the host returns it. A host that will not keep a new area answers refused with a reason rather than applied, and the component reads the record again."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/cases/view-save-rejects-entries-by-kind.json

@@ -0,0 +1,36 @@
+{
+  "id": "view-save-rejects-entries-by-kind",
+  "intent": "view.save",
+  "capability": "view-settings",
+  "summary": "A layer naming an entry the host does not know is refused, with the reason under the entry that caused it, keyed by kind and key.",
+  "given": {
+    "capabilities": [
+      "view-settings"
+    ]
+  },
+  "when": {
+    "intent": "view.save",
+    "payload": {
+      "record_id": null,
+      "collection": "pages",
+      "target": {
+        "kind": "personal",
+        "revision": "v7"
+      },
+      "view": {
+        "schema_version": 1,
+        "sections": {
+          "ghost": {
+            "order": 1
+          }
+        },
+        "groups": {},
+        "fields": {}
+      }
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "note": "Keyed by kind -- section:ghost -- because a section and a field may share a key. A bare key could name two different entries, and the error would be shown under the wrong one, which is worse than no error at all: it accuses something that is fine."
+  }
+}

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

@@ -0,0 +1,30 @@
+{
+  "id": "view-settings-without-the-capability",
+  "intent": "view.save",
+  "capability": "view-settings",
+  "summary": "A host that does not declare view-settings is never asked to save a view, and the component shows nothing that would lead there.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "view.save",
+    "payload": {
+      "record_id": null,
+      "collection": "pages",
+      "target": {
+        "kind": "personal",
+        "revision": null
+      },
+      "view": {
+        "schema_version": 1,
+        "sections": {},
+        "groups": {},
+        "fields": {}
+      }
+    }
+  },
+  "then": {
+    "answer": "unavailable",
+    "note": "The control is absent rather than present and failing. A person offered a way to rearrange a view that cannot be stored would lose the arrangement on the next load and have no way to know why."
+  }
+}

package/distr/core/contracts/ports/simai.property-view-port/1.14.0/kit/manifest.json

@@ -0,0 +1,66 @@
+{
+  "schema": "simai.composite.host-port.conformance.v1",
+  "port": "simai.property-view-port",
+  "version": "1.14.0",
+  "transport": "neutral",
+  "summary": "The cases of 1.13.0's kit, unchanged, and nine of 1.14.0: a lookup field and its candidates by source and limit, a save confirmed with a digest, and fields that arrive with their conditions.",
+  "answers": [
+    "applied",
+    "conflict",
+    "refused",
+    "unavailable"
+  ],
+  "cases": [
+    "load-applied-carries-the-object",
+    "load-refused-is-explained",
+    "load-unavailable-is-honest",
+    "load-late-answer-is-dropped",
+    "rare-fields-arrive-declared",
+    "group-save-applied-is-one-revision",
+    "group-save-stale-revision-is-a-conflict",
+    "group-save-field-errors-are-refused",
+    "options-page-carries-a-cursor",
+    "options-search-reaches-the-host",
+    "options-without-the-capability",
+    "options-refused-is-explained",
+    "the-address-is-the-hosts",
+    "upload-answers-with-the-stored-file",
+    "upload-refused-is-explained",
+    "removing-a-file-is-a-save",
+    "opening-a-reference-is-the-hosts-decision",
+    "field-presentation-keys-are-declared",
+    "view-save-is-one-layer-one-revision",
+    "view-save-against-a-stale-revision-is-a-conflict",
+    "view-save-rejects-entries-by-kind",
+    "view-reset-answers-with-what-now-resolves",
+    "view-settings-without-the-capability",
+    "a-related-group-is-a-list-not-fields",
+    "a-field-says-what-it-falls-back-to",
+    "view-save-may-name-an-area-the-record-does-not-carry",
+    "a-field-taken-out-of-an-area-is-unplaced",
+    "opening-the-record-as-a-page-is-offered-only-where-it-leads-somewhere",
+    "view-profile-applied-carries-the-record-through-it",
+    "view-profile-refused-is-explained",
+    "view-profile-unavailable-without-the-capability",
+    "view-create-answers-with-the-record-through-the-new-view",
+    "view-create-shared-may-be-refused",
+    "view-rename-changes-the-label-only",
+    "view-delete-the-last-shared-one-is-refused",
+    "view-delete-applied-answers-with-what-is-left",
+    "load-for-create-is-an-empty-object",
+    "a-reader-is-offered-nothing-to-change",
+    "create-applied-answers-with-the-id",
+    "create-field-errors-are-refused",
+    "save-applied-is-one-revision",
+    "save-stale-revision-is-a-conflict",
+    "lookup-arrives-with-its-label",
+    "options-carry-the-source-and-a-limit",
+    "options-search-by-source-reaches-the-host",
+    "group-save-may-ask-for-a-confirmation",
+    "group-save-confirmed-with-the-digest-is-applied",
+    "a-stale-confirmation-is-asked-again",
+    "save-may-ask-for-a-confirmation",
+    "conditions-arrive-declared",
+    "a-field-hidden-by-its-condition-is-not-saved"
+  ]
+}