@simai-studio/ui 0.0.0-stage → 5.20261019.1710

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/bulk-selected-all-or-nothing.json

@@ -0,0 +1,45 @@
+{
+  "id": "bulk-selected-all-or-nothing",
+  "intent": "bulk.apply_selected",
+  "capability": null,
+  "summary": "A batch with one stale revision is refused as a whole; nothing is written.",
+  "given": {
+    "records": [
+      {
+        "id": 1,
+        "revision": "r1",
+        "actions": [
+          "archive"
+        ]
+      },
+      {
+        "id": 2,
+        "revision": "r3",
+        "actions": [
+          "archive"
+        ]
+      }
+    ]
+  },
+  "when": {
+    "intent": "bulk.apply_selected",
+    "payload": {
+      "action_id": "archive",
+      "record_ids": [
+        1,
+        2
+      ],
+      "revisions": {
+        "1": "r1",
+        "2": "r2"
+      }
+    }
+  },
+  "then": {
+    "answer": "conflict",
+    "answer_must_include": [
+      "conflicts"
+    ],
+    "note": "Record 1 is not archived either. The kit checks the store afterwards."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/bulk-under-filter-count-confirmed.json

@@ -0,0 +1,28 @@
+{
+  "id": "bulk-under-filter-count-confirmed",
+  "intent": "bulk.apply_under_filter",
+  "capability": "bulk-under-filter",
+  "summary": "Acting on everything under a filter carries the count the person confirmed; a changed count is a conflict.",
+  "given": {
+    "total_under_filter": 41
+  },
+  "when": {
+    "intent": "bulk.apply_under_filter",
+    "payload": {
+      "action_id": "archive",
+      "filters": {
+        "status": [
+          "draft"
+        ]
+      },
+      "confirmed_total": 40
+    }
+  },
+  "then": {
+    "answer": "conflict",
+    "answer_must_include": [
+      "current_total"
+    ],
+    "note": "The host does not act on 41 records when the person confirmed 40."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/capability-absent-is-explained.json

@@ -0,0 +1,22 @@
+{
+  "id": "capability-absent-is-explained",
+  "intent": "view.open",
+  "capability": "saved-views",
+  "summary": "A host that does not announce saved views gets no stored-view intents at all.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "view.open",
+    "payload": {
+      "key": "mine"
+    }
+  },
+  "then": {
+    "answer": "unavailable",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "The view shows no template control; the kit checks that the intent is never raised."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/create-intent-names-kind.json

@@ -0,0 +1,24 @@
+{
+  "id": "create-intent-names-kind",
+  "intent": "view.create_record",
+  "capability": null,
+  "summary": "The create request carries the chosen kind, or null when there is only one.",
+  "given": {
+    "create_items": [
+      {
+        "key": "order",
+        "label": "Order"
+      }
+    ]
+  },
+  "when": {
+    "intent": "view.create_record",
+    "payload": {
+      "item": "order"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "note": "The host opens its own form; the component does not build one."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/data-states-declared.json

@@ -0,0 +1,23 @@
+{
+  "id": "data-states-declared",
+  "intent": "query.change",
+  "capability": null,
+  "summary": "Loading, empty, error and ready are declared states of the view, readable from the outside.",
+  "given": {
+    "store": "slow"
+  },
+  "when": {
+    "intent": "query.change",
+    "payload": {
+      "sequence": 10,
+      "query": {
+        "page": 1,
+        "per_page": 25
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "note": "While waiting the region carries data-state=loading and aria-busy; an empty answer is the empty state, not a blank table."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/query-echoes-applied.json

@@ -0,0 +1,67 @@
+{
+  "id": "query-echoes-applied",
+  "intent": "query.change",
+  "capability": null,
+  "summary": "The host answers a search and filter request and echoes what it actually applied.",
+  "given": {
+    "records": [
+      {
+        "id": 1,
+        "revision": "r1",
+        "actions": [
+          "view"
+        ]
+      }
+    ],
+    "filters_supported": [
+      "status"
+    ]
+  },
+  "when": {
+    "intent": "query.change",
+    "payload": {
+      "sequence": 1,
+      "query": {
+        "search": "ann",
+        "filters": {
+          "status": [
+            "active"
+          ]
+        },
+        "sort": [
+          {
+            "key": "name",
+            "direction": "asc"
+          }
+        ],
+        "page": 1,
+        "per_page": 25
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "data_must_include": [
+      "records",
+      "total",
+      "echo"
+    ],
+    "echo_must_equal": {
+      "search": "ann",
+      "filters": {
+        "status": [
+          "active"
+        ]
+      },
+      "sort": [
+        {
+          "key": "name",
+          "direction": "asc"
+        }
+      ],
+      "page": 1,
+      "per_page": 25
+    },
+    "note": "filters_chosen equals what was asked; filters equals what was applied; filters_rejected is empty."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/query-rejects-unknown-filter.json

@@ -0,0 +1,38 @@
+{
+  "id": "query-rejects-unknown-filter",
+  "intent": "query.change",
+  "capability": null,
+  "summary": "A filter the host does not support is named as rejected, not applied silently.",
+  "given": {
+    "filters_supported": [
+      "status"
+    ]
+  },
+  "when": {
+    "intent": "query.change",
+    "payload": {
+      "sequence": 2,
+      "query": {
+        "filters": {
+          "status": [
+            "active"
+          ],
+          "secret_flag": [
+            true
+          ]
+        },
+        "page": 1,
+        "per_page": 25
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "echo_must_include": {
+      "filters_rejected": [
+        "secret_flag"
+      ]
+    },
+    "note": "filters_chosen carries both keys, filters carries only status."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/query-stale-sequence-dropped.json

@@ -0,0 +1,29 @@
+{
+  "id": "query-stale-sequence-dropped",
+  "intent": "query.change",
+  "capability": null,
+  "summary": "An answer to an older sequence is dropped; the view keeps the newest answer.",
+  "given": {
+    "in_flight": [
+      3,
+      4
+    ]
+  },
+  "when": {
+    "intent": "query.change",
+    "payload": {
+      "sequence": 4,
+      "query": {
+        "page": 2,
+        "per_page": 25
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "echo_must_include": {
+      "page": 2
+    },
+    "note": "The host answers both; the component keeps sequence 4 and drops 3."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/query-unavailable-is-honest.json

@@ -0,0 +1,26 @@
+{
+  "id": "query-unavailable-is-honest",
+  "intent": "query.change",
+  "capability": null,
+  "summary": "When the store cannot answer, the view shows the failure and the retry, not an empty list.",
+  "given": {
+    "store": "down"
+  },
+  "when": {
+    "intent": "query.change",
+    "payload": {
+      "sequence": 5,
+      "query": {
+        "page": 1,
+        "per_page": 25
+      }
+    }
+  },
+  "then": {
+    "answer": "unavailable",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "The previous records stay on screen or the error state is shown; total is not reset to zero."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/record-mutate-conflict.json

@@ -0,0 +1,37 @@
+{
+  "id": "record-mutate-conflict",
+  "intent": "record.mutate",
+  "capability": "row-actions",
+  "summary": "A stale revision is answered with a conflict and the current revision, not a silent overwrite.",
+  "given": {
+    "records": [
+      {
+        "id": 1,
+        "revision": "r2",
+        "actions": [
+          "view",
+          "edit"
+        ]
+      }
+    ]
+  },
+  "when": {
+    "intent": "record.mutate",
+    "payload": {
+      "action_id": "edit",
+      "record_ids": [
+        1
+      ],
+      "revisions": {
+        "1": "r1"
+      }
+    }
+  },
+  "then": {
+    "answer": "conflict",
+    "answer_must_include": [
+      "current_revision"
+    ],
+    "note": "The host re-reads the stored bytes; it does not trust the revision in the request."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/record-mutate-refused.json

@@ -0,0 +1,36 @@
+{
+  "id": "record-mutate-refused",
+  "intent": "record.mutate",
+  "capability": "row-actions",
+  "summary": "An action the record does not allow is refused with a reason.",
+  "given": {
+    "records": [
+      {
+        "id": 2,
+        "revision": "r1",
+        "actions": [
+          "view"
+        ]
+      }
+    ]
+  },
+  "when": {
+    "intent": "record.mutate",
+    "payload": {
+      "action_id": "delete",
+      "record_ids": [
+        2
+      ],
+      "revisions": {
+        "2": "r1"
+      }
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "Refusal is checked on the host even when the view never offered the button."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/records-carry-permissions.json

@@ -0,0 +1,42 @@
+{
+  "id": "records-carry-permissions",
+  "intent": "query.change",
+  "capability": "row-actions",
+  "summary": "Each record carries the actions the host allows; the view offers only those.",
+  "given": {
+    "records": [
+      {
+        "id": 1,
+        "revision": "r1",
+        "actions": [
+          "view",
+          "edit"
+        ]
+      },
+      {
+        "id": 2,
+        "revision": "r1",
+        "actions": [
+          "view"
+        ]
+      }
+    ]
+  },
+  "when": {
+    "intent": "query.change",
+    "payload": {
+      "sequence": 6,
+      "query": {
+        "page": 1,
+        "per_page": 25
+      }
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "data_must_include": [
+      "records"
+    ],
+    "note": "Record 2 offers no edit. The view does not infer the right from a field value or a role name."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/settings-personal-compare-and-set.json

@@ -0,0 +1,33 @@
+{
+  "id": "settings-personal-compare-and-set",
+  "intent": "settings.save_personal",
+  "capability": null,
+  "summary": "Personal column settings are written against the layer revision.",
+  "given": {
+    "column_settings": {
+      "layers": {
+        "personal": {
+          "revision": "s2"
+        }
+      }
+    }
+  },
+  "when": {
+    "intent": "settings.save_personal",
+    "payload": {
+      "columnSettings": {
+        "name": {
+          "visible": false
+        }
+      },
+      "base_revision": "s1"
+    }
+  },
+  "then": {
+    "answer": "conflict",
+    "answer_must_include": [
+      "current_revision"
+    ],
+    "note": "A save is never a blind replace; a reset is the same write with the package layer as its value."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/settings-shared-needs-permission.json

@@ -0,0 +1,28 @@
+{
+  "id": "settings-shared-needs-permission",
+  "intent": "settings.save_shared",
+  "capability": "shared-column-settings",
+  "summary": "Saving for everyone is a separate permission: a host that does not announce it never receives the intent.",
+  "given": {
+    "capabilities": []
+  },
+  "when": {
+    "intent": "settings.save_shared",
+    "payload": {
+      "columnSettings": {
+        "name": {
+          "visible": false
+        }
+      },
+      "base_revision": "s1",
+      "target": "shared"
+    }
+  },
+  "then": {
+    "answer": "unavailable",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "Without the capability the view explains that saving for everyone is not connected here; it does not show a button that fails."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/settings-shared-only-field.json

@@ -0,0 +1,29 @@
+{
+  "id": "settings-shared-only-field",
+  "intent": "settings.save_personal",
+  "capability": null,
+  "summary": "A field that only the shared layer owns is refused in a personal save.",
+  "given": {
+    "shared_only_fields": [
+      "pinned"
+    ]
+  },
+  "when": {
+    "intent": "settings.save_personal",
+    "payload": {
+      "columnSettings": {
+        "name": {
+          "pinned": true
+        }
+      },
+      "base_revision": "s1"
+    }
+  },
+  "then": {
+    "answer": "refused",
+    "answer_must_include": [
+      "reason"
+    ],
+    "note": "The personal layer cannot pin a column for everyone by writing its own layer."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/view-open-carries-everything.json

@@ -0,0 +1,44 @@
+{
+  "id": "view-open-carries-everything",
+  "intent": "view.open",
+  "capability": "saved-views",
+  "summary": "Opening a stored view restores its query, roles, layout and settings together with its revision.",
+  "given": {
+    "saved_views": [
+      {
+        "key": "mine",
+        "label": "Mine",
+        "revision": "v4",
+        "query": {
+          "filters": {
+            "owner": [
+              "me"
+            ]
+          }
+        },
+        "layout": {
+          "columns": [
+            {
+              "key": "name",
+              "visible": true
+            }
+          ]
+        }
+      }
+    ]
+  },
+  "when": {
+    "intent": "view.open",
+    "payload": {
+      "key": "mine"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "data_must_include": [
+      "column_settings",
+      "echo"
+    ],
+    "note": "The settings target becomes {kind: saved_view, key: mine, revision: v4}."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/view-save-conflict.json

@@ -0,0 +1,28 @@
+{
+  "id": "view-save-conflict",
+  "intent": "view.save",
+  "capability": "saved-views",
+  "summary": "Saving a stored view someone else changed is a conflict.",
+  "given": {
+    "saved_views": [
+      {
+        "key": "mine",
+        "revision": "v5"
+      }
+    ]
+  },
+  "when": {
+    "intent": "view.save",
+    "payload": {
+      "key": "mine",
+      "revision": "v4"
+    }
+  },
+  "then": {
+    "answer": "conflict",
+    "answer_must_include": [
+      "current_revision"
+    ],
+    "note": "The view is one object; its parts are not saved separately."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/cases/view-switch-reports-dropped.json

@@ -0,0 +1,50 @@
+{
+  "id": "view-switch-reports-dropped",
+  "intent": "query.change",
+  "capability": null,
+  "summary": "Switching to another view reports what carried over and what was dropped.",
+  "given": {
+    "switch_from": "list",
+    "switch_to": "board"
+  },
+  "when": {
+    "intent": "query.change",
+    "payload": {
+      "sequence": 9,
+      "query": {
+        "filters": {
+          "status": [
+            "active"
+          ]
+        },
+        "sort": [
+          {
+            "key": "name",
+            "direction": "asc"
+          }
+        ],
+        "page": 1,
+        "per_page": 25
+      },
+      "reason": "view-switch"
+    }
+  },
+  "then": {
+    "answer": "applied",
+    "echo_must_include": {
+      "switch": {
+        "query": {
+          "filters": {
+            "status": [
+              "active"
+            ]
+          }
+        },
+        "dropped": [
+          "sort"
+        ]
+      }
+    },
+    "note": "The person sees that sorting did not carry over instead of guessing."
+  }
+}

package/distr/core/contracts/ports/simai.dataview-port/1.0.0/kit/manifest.json

@@ -0,0 +1,33 @@
+{
+  "schema": "simai.composite.host-port.conformance.v1",
+  "port": "simai.dataview-port",
+  "version": "1.0.0",
+  "transport": "neutral",
+  "summary": "Cases a host passes before it claims this port. Each case names the host state, the intent the component raises and the answer the host owes. Addresses, formats and languages are not part of a case.",
+  "answers": [
+    "applied",
+    "conflict",
+    "refused",
+    "unavailable"
+  ],
+  "cases": [
+    "query-echoes-applied",
+    "query-rejects-unknown-filter",
+    "query-stale-sequence-dropped",
+    "query-unavailable-is-honest",
+    "records-carry-permissions",
+    "record-mutate-conflict",
+    "record-mutate-refused",
+    "bulk-selected-all-or-nothing",
+    "bulk-under-filter-count-confirmed",
+    "settings-personal-compare-and-set",
+    "settings-shared-needs-permission",
+    "settings-shared-only-field",
+    "view-open-carries-everything",
+    "view-save-conflict",
+    "view-switch-reports-dropped",
+    "capability-absent-is-explained",
+    "create-intent-names-kind",
+    "data-states-declared"
+  ]
+}