@reventlessdev/reventless-spec 3.0.0-alpha.83 → 3.0.0-alpha.84

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# 3.0.0-alpha.84 (2026-07-29)
+
+### Features
+
+* **plugin:** why a read model is named by that field ([699ef8e](https://github.com/ReventlessDev/reventless-core/commit/699ef8e72f1b1d82fb04672739e5e4a8db61ae9a))
+
+
 # 3.0.0-alpha.83 (2026-07-28)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-spec",
-  "version": "3.0.0-alpha.83",
+  "version": "3.0.0-alpha.84",
   "description": "Specifications for Reventless",
   "license": "Apache-2.0",
   "bin": {

package/src/components/Plugin.res

@@ -218,6 +218,26 @@ type queryableDef = {
   */
   searchableFields: array<string>,
   /**
+  Which rung of the `labelField` ladder produced it, so a consumer with a name
+  rule of its own can tell a declaration from a guess before ranking the two:
+
+  - `"annotation"` — a `@displayName` spec. The author said which field names the
+    record; nothing a client infers locally outranks it.
+  - `"convention"` — a field literally named `name`/`title`/`label`/`displayName`.
+    A guess, and the one guess a client can independently arrive at.
+  - `"position"` — the first candidate in declaration order. A guess, and a fact
+    only this side knows; a client's own conventional-name rule is the better
+    answer where the two differ.
+  - `"fallback"` — no candidate at all, so `labelField` is `"id"`. The state
+    saying it has no human-readable field.
+
+  `None` means not stated — defs persisted before this field existed, and
+  hand-rolled defs that decline to say. Distinct from `Some("fallback")`, which
+  is this side stating that it looked. js_nullable for the same JSON-safety
+  reason as `statusField`.
+  */
+  labelFieldSource: @s.matches(stringOptionSchema) option<string>,
+  /**
   Name of the state field whose value identifies the row's lifecycle status, used
   by AutoUI together with `commandDef.allowedStates` to filter the per-row command
   menu. Resolution order (codegen): (1) field annotated `@status`; (2) a field

package/src/components/Plugin.res.mjs

@@ -114,6 +114,7 @@ let queryableDefSchema = S.schema(s => ({
   linkedWriteSide: s.m(S.array(S.string)),
   labelField: s.m(S.string),
   searchableFields: s.m(S.array(S.string)),
+  labelFieldSource: s.m(stringOptionSchema),
   statusField: s.m(stringOptionSchema),
   visibility: s.m(stringOptionSchema),
   chapter: s.m(stringOptionSchema)