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

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 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
+
+* **platform:** provision object stores from the fields that declare them ([b5e2a1e](https://github.com/ReventlessDev/reventless-core/commit/b5e2a1ec88099941c113e4963f9c4b346b96b0d6))
+
+
 # 3.0.0-alpha.82 (2026-07-28)
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-spec",
-  "version": "3.0.0-alpha.82",
+  "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
@@ -374,6 +394,21 @@ type pluginStructure = {
   // read as []). js_nullable keeps it JSON-safe inside union variant payloads.
   extensionPoints: @s.matches(extensionPointDefArrayOptionSchema)
   option<array<extensionPointDef>>,
+  /**
+   The object stores this plugin's fields declare they need, deduplicated and
+   fully qualified as `{plugin}.{store}`.
+
+   A field typed as a storage ref states a *requirement*: the deployment needs
+   that store to exist. Collecting the requirement here is what lets it be read
+   without re-walking every component's schema — the same reason
+   `producedEventTypes` is carried rather than recomputed.
+
+   Qualified even for the common same-plugin case, so one entry has one shape
+   and the string is directly the store's identity. Optional and js_nullable for
+   the same reason as `extensionPoints`: definitions persisted before this field
+   existed still decode (absent → None, read as []).
+   */
+  requiredStores: @s.matches(stringArrayOptionSchema) option<array<string>>,
 }
 
 let pluginStructureOptionSchema = _jsNullable(pluginStructureSchema, ())

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)
@@ -186,7 +187,8 @@ let pluginStructureSchema = S.schema(s => ({
   outboundTranslationSlices: s.m(S.array(outboundTranslationSliceDefSchema)),
   inboundTranslationSlices: s.m(S.array(inboundTranslationSliceDefSchema)),
   extensions: s.m(S.array(extensionDefSchema)),
-  extensionPoints: s.m(extensionPointDefArrayOptionSchema)
+  extensionPoints: s.m(extensionPointDefArrayOptionSchema),
+  requiredStores: s.m(stringArrayOptionSchema)
 }));
 
 let pluginStructureOptionSchema = SuryResMjs.js_nullable(pluginStructureSchema);