@reventlessdev/reventless-core 3.0.0-alpha.149 → 3.0.0-alpha.150

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.150 (2026-07-10)
+
+### Features
+
+* **reventless-ppx:** add [@group](https://github.com/group)By state-field annotation → x-reventless-group-by ([9e7a7b2](https://github.com/ReventlessDev/reventless-core/commit/9e7a7b29e54fb4eda1c6a145c0e7b6dcf26940ee))
+
+
 # 3.0.0-alpha.149 (2026-07-09)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-core",
-  "version": "3.0.0-alpha.149",
+  "version": "3.0.0-alpha.150",
   "description": "Core package for Reventless framework",
   "license": "Apache-2.0",
   "jest": {
@@ -29,21 +29,21 @@
     "sury": "11.0.0-alpha.4",
     "uuid": "^13.0.0",
     "@reventlessdev/rescript-effect": "0.1.0-alpha.25",
+    "@reventlessdev/rescript-fast-csv": "1.2.0-alpha.11",
     "@reventlessdev/rescript-hash-object": "1.2.0-alpha.10",
     "@reventlessdev/rescript-jest": "1.0.0-alpha.6",
-    "@reventlessdev/rescript-fast-csv": "1.2.0-alpha.11",
     "@reventlessdev/rescript-node-streams": "1.1.0-alpha.10",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.14",
     "@reventlessdev/rescript-ssh2": "1.1.0-alpha.11",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.91",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.69",
     "@reventlessdev/rescript-uuid": "1.1.0-alpha.14",
-    "@reventlessdev/reventless-interop": "3.0.0-alpha.24"
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.92",
+    "@reventlessdev/reventless-interop": "3.0.0-alpha.24",
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.70"
   },
   "devDependencies": {
     "rescript": "^12.3.0",
     "sury-ppx": "11.0.0-alpha.2",
-    "@reventlessdev/reventless-ppx": "1.0.0-alpha.51"
+    "@reventlessdev/reventless-ppx": "1.0.0-alpha.52"
   },
   "peerDependencies": {
     "rescript": "^12.3.0"

package/src/components/Api/SuryToJsonSchema.res

@@ -44,6 +44,11 @@ let mergeAnnotations = (
     if spec.summary->Array.includes(fieldName) {
       obj->Dict.set("x-reventless-summary", JSON.Encode.bool(true))
     }
+    switch spec.groupBy {
+    | Some(name) if name === fieldName =>
+      obj->Dict.set("x-reventless-group-by", JSON.Encode.bool(true))
+    | _ => ()
+    }
     switch spec.drillTargets->Array.find(((field, _)) => field === fieldName) {
     | Some((_, sliceName)) =>
       obj->Dict.set("x-reventless-drillTarget", JSON.Encode.string(sliceName))

package/src/components/Api/SuryToJsonSchema.res.mjs

@@ -41,6 +41,10 @@ function mergeAnnotations(fieldSchema, fieldName, spec) {
   if (spec.summary.includes(fieldName)) {
     obj["x-reventless-summary"] = true;
   }
+  let name = spec.groupBy;
+  if (name !== undefined && name === fieldName) {
+    obj["x-reventless-group-by"] = true;
+  }
   let match$1 = spec.drillTargets.find(param => param[0] === fieldName);
   if (match$1 !== undefined) {
     obj["x-reventless-drillTarget"] = match$1[1];

package/src/plugin/lifecycle/PluginsReadModelSpec.res

@@ -42,7 +42,9 @@ type state = {
   // @scan opts the field into server-side equality filtering so the connection gains
   // a `kindEq` filter — the panel split (main list vs System/Infrastructure) pages
   // correctly server-side rather than filtering a page client-side.
-  @scan kind: Reventless.Plugin.pluginKind,
+  // @groupBy tags this field as the list view's section key (emitted as
+  // `x-reventless-group-by`); AutoUI sections the admin Plugins view by kind.
+  @scan @groupBy kind: Reventless.Plugin.pluginKind,
   // Other versions of this name that are currently **Connected** — excludes this
   // row's own `version` (whose status is the `status` field above). Lets the
   // projection recompute which version is current (highest Connected) during a

package/src/plugin/lifecycle/PluginsReadModelSpec.res.mjs

@@ -48,6 +48,7 @@ let stateSchema$1 = S.Metadata.set(stateSchema, StateAnnotations$Reventless.stat
   scan: ["kind"],
   scanSort: [],
   status: undefined,
+  groupBy: "kind",
   visibility: undefined
 });
 

package/tests/api/SuryToJsonSchemaTest.res

@@ -30,6 +30,7 @@ let emptySpec: Reventless.StateAnnotations.stateAnnotationSpec = {
   scan: [],
   scanSort: [],
   status: None,
+  groupBy: None,
   visibility: None,
 }
 
@@ -305,6 +306,25 @@ describe("SuryToJsonSchema:", () => {
       ))->toEqual((Some(true), None))
     })
 
+    testSync("emits x-reventless-group-by on the field named by groupBy", () => {
+      let schema = S.schema(s =>
+        {
+          "id": s.matches(S.string),
+          "kind": s.matches(S.string),
+        }
+      )->S.castToUnknown
+      let schema' = schema->withSpec({...emptySpec, groupBy: Some("kind")})
+      let json = SuryToJsonSchema.deriveObjectSchema(schema')
+      let kindSchema = getPropertyOf(json, "kind")
+      let idSchema = getPropertyOf(json, "id")
+      expect((
+        kindSchema
+        ->Option.flatMap(s => getProperty(s, "x-reventless-group-by"))
+        ->Option.flatMap(JSON.Decode.bool),
+        idSchema->Option.flatMap(s => getProperty(s, "x-reventless-group-by")),
+      ))->toEqual((Some(true), None))
+    })
+
     testSync("emits x-reventless-collapsed on field listed in collapsed", () => {
       let schema = S.schema(s =>
         {

package/tests/api/SuryToJsonSchemaTest.res.mjs

@@ -64,6 +64,7 @@ let emptySpec = {
   scan: emptySpec_scan,
   scanSort: emptySpec_scanSort,
   status: undefined,
+  groupBy: undefined,
   visibility: undefined
 };
 
@@ -100,6 +101,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -129,6 +131,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -161,6 +164,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -189,6 +193,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -217,6 +222,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -242,6 +248,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -267,6 +274,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -299,6 +307,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -334,6 +343,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -372,6 +382,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -400,6 +411,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -425,6 +437,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: ["status"],
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -457,6 +470,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: ["name"],
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -470,6 +484,39 @@ globalThis.describe("SuryToJsonSchema:", () => {
         undefined
       ]);
     });
+    globalThis.test("emits x-reventless-group-by on the field named by groupBy", () => {
+      let schema = S.schema(s => ({
+        id: s.m(S.string),
+        kind: s.m(S.string)
+      }));
+      let schema$p = withSpec(schema, {
+        ids: emptySpec_ids,
+        compositeIds: emptySpec_compositeIds,
+        subIds: emptySpec_subIds,
+        compositeSubIds: emptySpec_compositeSubIds,
+        indexes: emptySpec_indexes,
+        hidden: emptySpec_hidden,
+        summary: emptySpec_summary,
+        drillTargets: emptySpec_drillTargets,
+        drillTargetKeys: emptySpec_drillTargetKeys,
+        collapsed: emptySpec_collapsed,
+        scan: emptySpec_scan,
+        scanSort: emptySpec_scanSort,
+        status: undefined,
+        groupBy: "kind",
+        visibility: undefined
+      });
+      let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
+      let kindSchema = getPropertyOf(json, "kind");
+      let idSchema = getPropertyOf(json, "id");
+      globalThis.expect([
+        Stdlib_Option.flatMap(Stdlib_Option.flatMap(kindSchema, s => getProperty(s, "x-reventless-group-by")), Stdlib_JSON.Decode.bool),
+        Stdlib_Option.flatMap(idSchema, s => getProperty(s, "x-reventless-group-by"))
+      ]).toEqual([
+        true,
+        undefined
+      ]);
+    });
     globalThis.test("emits x-reventless-collapsed on field listed in collapsed", () => {
       let schema = S.schema(s => ({
         id: s.m(S.string),
@@ -489,6 +536,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -520,6 +568,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: "Internal"
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -543,6 +592,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let json = SuryToJsonSchema$ReventlessCore.deriveObjectSchema(schema$p);
@@ -606,6 +656,7 @@ globalThis.describe("SuryToJsonSchema:", () => {
         scan: emptySpec_scan,
         scanSort: emptySpec_scanSort,
         status: undefined,
+        groupBy: undefined,
         visibility: undefined
       });
       let native = S.toJSONSchema(schema$p);

package/tests/plugin/StateViewSlice/PsAnnotatedView.res.mjs

@@ -65,6 +65,7 @@ let stateSchema$1 = S.Metadata.set(stateSchema, StateAnnotations$Reventless.stat
   scan: [],
   scanSort: [],
   status: undefined,
+  groupBy: undefined,
   visibility: undefined
 });