@reventlessdev/reventless-local 3.0.0-alpha.246 → 3.0.0-alpha.248

package/CHANGELOG.md

@@ -3,6 +3,21 @@
 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.248 (2026-09-08)
+
+### Features
+
+* a slice folder is named for its kind, without the Slice ([a400555](https://github.com/ReventlessDev/reventless-core/commit/a400555121b023823983ebe846e99cda27063c1f))
+* **core:** a reference names a row and shows its picture ([2b40d04](https://github.com/ReventlessDev/reventless-core/commit/2b40d0418bba2bf83463f446e94e372ea0c9898c))
+
+
+# 3.0.0-alpha.247 (2026-09-07)
+
+### Bug Fixes
+
+* **core:** a state view slice composes its [@display](https://github.com/display)Name like a read model ([851aa1d](https://github.com/ReventlessDev/reventless-core/commit/851aa1d12ddae9dd39f91084f5719cd98fe1cbd4))
+
+
 # 3.0.0-alpha.246 (2026-09-07)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reventlessdev/reventless-local",
-  "version": "3.0.0-alpha.246",
+  "version": "3.0.0-alpha.248",
   "description": "Local platform for Reventless (in-memory or SQLite backend, for development and testing without AWS)",
   "license": "Apache-2.0",
   "bin": {
@@ -36,17 +36,17 @@
     "ws": "^8.18.0",
     "@reventlessdev/rescript-effect": "0.1.0-alpha.32",
     "@reventlessdev/rescript-graphql-yoga": "1.0.0-alpha.27",
-    "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
-    "@reventlessdev/rescript-node": "2.0.0-alpha.9",
     "@reventlessdev/rescript-mcp-sdk": "1.0.0-alpha.21",
+    "@reventlessdev/rescript-node": "2.0.0-alpha.9",
+    "@reventlessdev/rescript-jest": "1.0.0-alpha.10",
     "@reventlessdev/rescript-pulumi-pulumi": "2.3.0-alpha.19",
-    "@reventlessdev/reventless-core": "3.0.0-alpha.257",
-    "@reventlessdev/reventless-graphql-server": "1.0.0-alpha.105",
-    "@reventlessdev/reventless-infra": "3.0.0-alpha.158",
-    "@reventlessdev/reventless-postgres": "3.0.0-alpha.121",
-    "@reventlessdev/reventless-gwt": "1.0.0-alpha.204",
+    "@reventlessdev/reventless-core": "3.0.0-alpha.259",
+    "@reventlessdev/reventless-gwt": "1.0.0-alpha.206",
+    "@reventlessdev/reventless-graphql-server": "1.0.0-alpha.107",
     "@reventlessdev/reventless-seed": "1.0.0-alpha.19",
-    "@reventlessdev/reventless-spec": "3.0.0-alpha.130"
+    "@reventlessdev/reventless-spec": "3.0.0-alpha.132",
+    "@reventlessdev/reventless-infra": "3.0.0-alpha.160",
+    "@reventlessdev/reventless-postgres": "3.0.0-alpha.123"
   },
   "devDependencies": {
     "rescript": "12.3.0",

package/src/Platform.res.mjs

@@ -28,7 +28,7 @@ import * as Api_Naming$ReventlessCore from "@reventlessdev/reventless-core/src/c
 import * as PluginSpec$ReventlessCore from "@reventlessdev/reventless-core/src/plugin/lifecycle/PluginSpec.res.mjs";
 import * as UserStore$ReventlessLocal from "./adapter/Auth/UserStore.res.mjs";
 import * as TestRunner$ReventlessLocal from "./test/TestRunner.res.mjs";
-import * as UiFragments$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateViewSlice/UiFragments.res.mjs";
+import * as UiFragments$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateView/UiFragments.res.mjs";
 import * as CommandTopic$ReventlessCore from "@reventlessdev/reventless-core/src/components/CommandTopic/CommandTopic.res.mjs";
 import * as EffectLogger$ReventlessCore from "@reventlessdev/reventless-core/src/util/EffectLogger.res.mjs";
 import * as ShellConfig$ReventlessLocal from "./ShellConfig.res.mjs";
@@ -60,7 +60,7 @@ import * as LocalClonerRunner$ReventlessLocal from "./adapter/Cloner/LocalCloner
 import * as PluginBaseFragment$ReventlessCore from "@reventlessdev/reventless-core/src/plugin/api/PluginBaseFragment.res.mjs";
 import * as ProjectionPending$ReventlessLocal from "./adapter/ProjectionPending.res.mjs";
 import * as ReadModel_Builder$ReventlessLocal from "./components/ReadModel_Builder.res.mjs";
-import * as UiFragmentRegistry$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChangeSlice/UiFragmentRegistry.res.mjs";
+import * as UiFragmentRegistry$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChange/UiFragmentRegistry.res.mjs";
 import * as LocalEvents_Server$ReventlessLocal from "./adapter/Api/LocalEvents_Server.res.mjs";
 import * as LocalPlatformStart$ReventlessLocal from "./LocalPlatformStart.res.mjs";
 import * as PlatformMCP_Server$ReventlessLocal from "./adapter/PlatformMCP_Server.res.mjs";
@@ -76,7 +76,7 @@ import * as ProjectionCheckpoint$ReventlessLocal from "./adapter/ProjectionCheck
 import * as ExtensionPointMapping$ReventlessInfra from "@reventlessdev/reventless-infra/src/types/ExtensionPointMapping.res.mjs";
 import * as LocalGeocodeResolvers$ReventlessLocal from "./adapter/LocalGeocodeResolvers.res.mjs";
 import * as LocalPlatformRegistry$ReventlessLocal from "./LocalPlatformRegistry.res.mjs";
-import * as UiFragments_Projection$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateViewSlice/UiFragments_Projection.res.mjs";
+import * as UiFragments_Projection$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateView/UiFragments_Projection.res.mjs";
 import * as EventLogStorage_Sqlite$ReventlessLocal from "./adapter/EventLog/EventLogStorage_Sqlite.res.mjs";
 import * as ExtensionPoint_Builder$ReventlessLocal from "./components/ExtensionPoint_Builder.res.mjs";
 import * as PlatformGraphQL_Server$ReventlessLocal from "./adapter/PlatformGraphQL_Server.res.mjs";
@@ -94,7 +94,7 @@ import * as StateChangeSlice_Builder$ReventlessLocal from "./components/StateCha
 import * as DcbEventLogStorage_Sqlite$ReventlessLocal from "./adapter/DcbEventLog/DcbEventLogStorage_Sqlite.res.mjs";
 import * as LocalEventCollectorChannel$ReventlessLocal from "./adapter/EventCollector/LocalEventCollectorChannel.res.mjs";
 import * as PluginRuntime_Builder_Micro$ReventlessCore from "@reventlessdev/reventless-core/src/adapter/Runtime/PluginRuntime_Builder_Micro.res.mjs";
-import * as UiFragmentRegistry_Behavior$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChangeSlice/UiFragmentRegistry_Behavior.res.mjs";
+import * as UiFragmentRegistry_Behavior$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChange/UiFragmentRegistry_Behavior.res.mjs";
 import * as Platform_PluginStructuresApi$ReventlessCore from "@reventlessdev/reventless-core/src/admin/Platform_PluginStructuresApi.res.mjs";
 import * as EventHistoryResolvers_GraphQL$ReventlessLocal from "./adapter/EventHistory/EventHistoryResolvers_GraphQL.res.mjs";
 import * as InboundTranslationSlice_Builder$ReventlessLocal from "./components/InboundTranslationSlice_Builder.res.mjs";

package/src/adapter/QueryDb/QueryDbResolvers_GraphQL.res

@@ -190,6 +190,14 @@ module Make = (Bus: LocalBus.T) => {
       ->Option.flatMap(Reventless.StateAnnotations.getSpec)
       ->Option.flatMap(spec => spec.retired)
 
+    // The picture a reference to one of these rows shows it by, derived once for
+    // every backend in `Reventless.RowImage`. Read per request for the same
+    // reason the two above are.
+    let imageSourceOf = () =>
+      Plugin_Helpers.stateSchemaRegistry
+      ->Dict.get(name)
+      ->Option.flatMap(Reventless.RowImage.sourceFrom)
+
     // `includeRetired` is the caller asking; `decideRetired` decides whether the
     // asking counts. Read here rather than inside the decision so the argument
     // stays an argument — the door reports what was asked, the classifier says
@@ -500,10 +508,19 @@ module Make = (Bus: LocalBus.T) => {
                       // A view with no label field resolves to its id, which is
                       // what `labelField`'s own fallback already decided.
                       ->Option.getOr(id)
+                    // The picture travels with the name, so a retired row that
+                    // keeps one keeps the other: an archived product reads as
+                    // itself on the order that bought it.
+                    let image =
+                      switch (imageSourceOf(), item->JSON.Decode.object) {
+                      | (Some(source), Some(d)) => d->Reventless.RowImage.refFrom(source)
+                      | _ => None
+                      }
                     Some(
                       Dict.fromArray([
                         ("id", JSON.Encode.string(id)),
                         ("label", JSON.Encode.string(label)),
+                        ("image", image->Option.mapOr(JSON.Encode.null, JSON.Encode.string)),
                         ("retired", JSON.Encode.bool(retired)),
                         (
                           "retiredState",

package/src/adapter/QueryDb/QueryDbResolvers_GraphQL.res.mjs

@@ -10,6 +10,7 @@ import * as Stdlib_Nullable from "@rescript/runtime/lib/es6/Stdlib_Nullable.js";
 import * as Owner$Reventless from "@reventlessdev/reventless-spec/src/components/Owner.res.mjs";
 import * as Primitive_object from "@rescript/runtime/lib/es6/Primitive_object.js";
 import * as Identity$Reventless from "@reventlessdev/reventless-spec/src/types/Identity.res.mjs";
+import * as RowImage$Reventless from "@reventlessdev/reventless-spec/src/semantic/RowImage.res.mjs";
 import * as ReadModel$Reventless from "@reventlessdev/reventless-spec/src/components/ReadModel.res.mjs";
 import * as OwnerScope$Reventless from "@reventlessdev/reventless-spec/src/types/OwnerScope.res.mjs";
 import * as Api_Ids$ReventlessCore from "@reventlessdev/reventless-core/src/components/Api/Api_Ids.res.mjs";
@@ -106,6 +107,7 @@ function Make(Bus) {
       return Stdlib_Option.mapOr(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(item), d => d[field]), Stdlib_JSON.Decode.string), false, v => v === required);
     };
     let retiredSpecOf = () => Stdlib_Option.flatMap(Stdlib_Option.flatMap(Plugin_Helpers$ReventlessCore.stateSchemaRegistry[name], StateAnnotations$Reventless.getSpec), spec => spec.retired);
+    let imageSourceOf = () => Stdlib_Option.flatMap(Plugin_Helpers$ReventlessCore.stateSchemaRegistry[name], RowImage$Reventless.sourceFrom);
     let askedForRetired = args => Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(args), d => d["includeRetired"]), Stdlib_JSON.Decode.bool), false);
     let retiredDecision = (ctx, args) => OwnerScope$Reventless.decideRetired(extractIdentity(ctx), Stdlib_Option.map(retiredSpecOf(), r => r.field), Stdlib_Option.flatMap(retiredSpecOf(), r => r.values), askedForRetired(args), undefined);
     let retiredAllows = (ctx, args, item) => {
@@ -289,6 +291,9 @@ function Make(Bus) {
               return;
             }
             let label = Stdlib_Option.getOr(Stdlib_Option.flatMap(Stdlib_Option.flatMap(Stdlib_JSON.Decode.object(item), d => d[labelField]), Stdlib_JSON.Decode.string), id);
+            let match$1 = imageSourceOf();
+            let match$2 = Stdlib_JSON.Decode.object(item);
+            let image = match$1 !== undefined && match$2 !== undefined ? RowImage$Reventless.refFrom(match$2, match$1) : undefined;
             return Object.fromEntries([
               [
                 "id",
@@ -298,6 +303,10 @@ function Make(Bus) {
                 "label",
                 label
               ],
+              [
+                "image",
+                Stdlib_Option.mapOr(image, null, prim => prim)
+              ],
               [
                 "retired",
                 retired

package/src/reset/LocalSeedReset.res.mjs

@@ -8,7 +8,7 @@ import * as Offload$Reventless from "@reventlessdev/reventless-spec/src/semantic
 import * as Backend$ReventlessLocal from "../adapter/Backend.res.mjs";
 import * as PluginSpec$ReventlessCore from "@reventlessdev/reventless-core/src/plugin/lifecycle/PluginSpec.res.mjs";
 import * as Seed_Prompt$ReventlessSeed from "@reventlessdev/reventless-seed/src/Seed_Prompt.res.mjs";
-import * as UiFragments$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateViewSlice/UiFragments.res.mjs";
+import * as UiFragments$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateView/UiFragments.res.mjs";
 import * as ComponentType$ReventlessCore from "@reventlessdev/reventless-core/src/ComponentType.res.mjs";
 import * as SqliteDriver$ReventlessLocal from "../adapter/SqliteDriver.res.mjs";
 import * as LocalSeedTarget$ReventlessLocal from "../LocalSeedTarget.res.mjs";

package/tests/PluginEventDecodeTest.res.mjs

@@ -7,7 +7,7 @@ import * as PluginSpec$ReventlessCore from "@reventlessdev/reventless-core/src/p
 import * as TestRunner$ReventlessLocal from "../src/test/TestRunner.res.mjs";
 import * as ComponentType$ReventlessCore from "@reventlessdev/reventless-core/src/ComponentType.res.mjs";
 import * as Plugin_Fixtures$ReventlessLocal from "./plugin/Plugin_Fixtures.res.mjs";
-import * as UiFragmentRegistry$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChangeSlice/UiFragmentRegistry.res.mjs";
+import * as UiFragmentRegistry$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChange/UiFragmentRegistry.res.mjs";
 import * as Platform_Admin_Structure$ReventlessCore from "@reventlessdev/reventless-core/src/admin/Platform_Admin_Structure.res.mjs";
 
 TestRunner$ReventlessLocal.setup();

package/tests/components/stateviewslice/StateViewSliceDisplayNameFixtures.res

@@ -0,0 +1,98 @@
+// E2E fixtures for the @displayName overlay on a StateViewSlice.
+// A slice's state carries the same synthetic `displayName` a read model's does;
+// this builds one by hand (the ppx writes the field and the metadata) so the
+// projection path can be asserted to compose it.
+
+open Reventless.Projection
+
+module OrderEventLog = {
+  @schema
+  type event =
+    | OrderPlaced({id: @s.matches(Reventless.DcbTag.string) string, placedAt: string})
+    | OrderShipped({id: @s.matches(Reventless.DcbTag.string) string, shippedAt: string})
+}
+
+module OrdersViewSpec = {
+  let name = "DnOrdersView"
+  let moduleUrl: string = %raw(`import.meta.url`)
+
+  @schema
+  type consumedEvent =
+    | OrderPlaced({id: string, placedAt: string})
+    | OrderShipped({id: string, shippedAt: string})
+
+  @schema
+  type state = {
+    id: string,
+    placedAt: string,
+    shippedAt: string,
+    displayName: option<string>,
+  }
+
+  // What the ppx emits for `@displayName placedAt`.
+  let stateSchema =
+    stateSchema->S.Metadata.set(
+      ~id=Reventless.DisplayName.displayNameId,
+      {Reventless.DisplayName.fields: ["placedAt"], separator: " "},
+    )
+
+  let config = Reventless.ReadModel.config()
+  let subIdConfig = None
+}
+
+module OrdersViewProjection = {
+  module Spec = OrdersViewSpec
+  open OrdersViewSpec
+
+  let moduleUrl: string = %raw(`import.meta.url`)
+
+  let project = ({event}: Reventless.StateViewSlice.consumed<consumedEvent>) =>
+    switch event {
+    | OrderPlaced({id, placedAt}) =>
+      [Set(id, {id, placedAt, shippedAt: "", displayName: None})]
+    | OrderShipped({id, shippedAt}) => [Update(id, s => {...s, shippedAt})]
+    }
+}
+
+module Bus = LocalBus.Make()
+
+let _ = TestRunner.setup()
+
+module OrderEventLogMaker = DcbEventLog_Builder.Make(Bus)
+let eventLog = OrderEventLogMaker.make(
+  ~name="DnOrderEventLog",
+  ~partitionTag=Reventless.DcbTag.Simple({key: "id"}),
+)
+
+module SVMaker = StateViewSlice_Builder.Make(Bus)
+module OrdersViewMaker = SVMaker.Make(OrdersViewSpec, OrdersViewProjection)
+let sv = OrdersViewMaker.make(~dcbEventLog=eventLog)
+
+let dcbEventTopicResource =
+  (eventLog->ReventlessCore.Component.outputs).eventTopic.resources->Array.getUnsafe(0)
+
+let encodeEvent = (event: OrderEventLog.event): ReventlessInfra.DcbEventLog.rawEvent => {
+  let json = event->Reventless.Util_Sury.toJson(OrderEventLog.eventSchema)
+  let (eventType, data) = json->ReventlessCore.Message.splitMessage
+  let tags = Reventless.DcbTag.extractTags(OrderEventLog.eventSchema, event)
+  let meta = ReventlessCore.Message.generateMeta(~service="test")
+  {eventType, data: JSON.Object(data), tags, meta}
+}
+
+let appendEvent = async event => {
+  let ops = await eventLog->OrderEventLogMaker.operations->TestRunner.resolve
+  let _ = await ops.append([encodeEvent(event)])
+}
+
+let loadState = async id => {
+  switch Bus.getQueryDb("DnOrdersView") {
+  | None => []
+  | Some(ops) =>
+    let states =
+      await ops.loadStream(id)
+      ->Stream.runCollect
+      ->Effect.catchAll(_ => Effect.succeed([]))
+      ->Effect.runPromise
+    states->Array.map(json => json->Reventless.Util_Sury.fromJson(OrdersViewSpec.stateSchema))
+  }
+}

package/tests/components/stateviewslice/StateViewSliceDisplayNameFixtures.res.mjs

@@ -0,0 +1,187 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as Sury from "sury";
+import * as Stream from "@reventlessdev/rescript-effect/src/Stream.res.mjs";
+import * as Effect from "effect/Effect";
+import * as DcbTag$Reventless from "@reventlessdev/reventless-spec/src/components/DcbTag.res.mjs";
+import * as ReadModel$Reventless from "@reventlessdev/reventless-spec/src/components/ReadModel.res.mjs";
+import * as Util_Sury$Reventless from "@reventlessdev/reventless-spec/src/util/Util_Sury.res.mjs";
+import * as DisplayName$Reventless from "@reventlessdev/reventless-spec/src/components/DisplayName.res.mjs";
+import * as Message$ReventlessCore from "@reventlessdev/reventless-core/src/Message.res.mjs";
+import * as Component$ReventlessCore from "@reventlessdev/reventless-core/src/components/Component.res.mjs";
+import * as LocalBus$ReventlessLocal from "../../../src/adapter/LocalBus.res.mjs";
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as DcbEventLog_Builder$ReventlessLocal from "../../../src/components/DcbEventLog_Builder.res.mjs";
+import * as StateViewSlice_Builder$ReventlessLocal from "../../../src/components/StateViewSlice_Builder.res.mjs";
+
+let eventSchema = Sury.union([
+  Sury.$schema(s => ({
+    TAG: "OrderPlaced",
+    id: s.m(DcbTag$Reventless.string),
+    placedAt: s.m(Sury.string)
+  })),
+  Sury.$schema(s => ({
+    TAG: "OrderShipped",
+    id: s.m(DcbTag$Reventless.string),
+    shippedAt: s.m(Sury.string)
+  }))
+]);
+
+let OrderEventLog = {
+  eventSchema: eventSchema
+};
+
+let name = "DnOrdersView";
+
+let moduleUrl = import.meta.url;
+
+let consumedEventSchema = Sury.union([
+  Sury.$schema(s => ({
+    TAG: "OrderPlaced",
+    id: s.m(Sury.string),
+    placedAt: s.m(Sury.string)
+  })),
+  Sury.$schema(s => ({
+    TAG: "OrderShipped",
+    id: s.m(Sury.string),
+    shippedAt: s.m(Sury.string)
+  }))
+]);
+
+let stateSchema = Sury.$schema(s => ({
+  id: s.m(Sury.string),
+  placedAt: s.m(Sury.string),
+  shippedAt: s.m(Sury.string),
+  displayName: s.m(Sury.$option(Sury.string))
+}));
+
+let stateSchema$1 = Sury.$Metadata_set(stateSchema, DisplayName$Reventless.displayNameId, {
+  fields: ["placedAt"],
+  separator: " "
+});
+
+let config = ReadModel$Reventless.config(undefined, undefined, undefined);
+
+let OrdersViewSpec = {
+  name: name,
+  moduleUrl: moduleUrl,
+  consumedEventSchema: consumedEventSchema,
+  stateSchema: stateSchema$1,
+  config: config,
+  subIdConfig: undefined,
+  authorization: "AllowAuthenticated",
+  visibility: "Public"
+};
+
+let moduleUrl$1 = import.meta.url;
+
+function project(param) {
+  let event = param.event;
+  if (event.TAG === "OrderPlaced") {
+    let id = event.id;
+    return [{
+        TAG: "Set",
+        _0: id,
+        _1: {
+          id: id,
+          placedAt: event.placedAt,
+          shippedAt: "",
+          displayName: undefined
+        }
+      }];
+  }
+  let shippedAt = event.shippedAt;
+  return [{
+      TAG: "Update",
+      _0: event.id,
+      _1: s => ({
+        id: s.id,
+        placedAt: s.placedAt,
+        shippedAt: shippedAt,
+        displayName: s.displayName
+      })
+    }];
+}
+
+let OrdersViewProjection = {
+  Spec: undefined,
+  moduleUrl: moduleUrl$1,
+  project: project
+};
+
+let Bus = LocalBus$ReventlessLocal.Make({});
+
+TestRunner$ReventlessLocal.setup();
+
+let OrderEventLogMaker = DcbEventLog_Builder$ReventlessLocal.Make(Bus);
+
+let eventLog = OrderEventLogMaker.make("DnOrderEventLog", undefined, {
+  TAG: "Simple",
+  _0: {
+    key: "id"
+  }
+}, undefined);
+
+let SVMaker = StateViewSlice_Builder$ReventlessLocal.Make(Bus);
+
+let OrdersViewMaker = SVMaker.Make({
+  name: name,
+  moduleUrl: moduleUrl,
+  stateSchema: stateSchema$1,
+  consumedEventSchema: consumedEventSchema,
+  config: config,
+  subIdConfig: undefined,
+  authorization: "AllowAuthenticated",
+  visibility: "Public"
+})({
+  project: project,
+  moduleUrl: moduleUrl$1
+});
+
+let sv = OrdersViewMaker.make(eventLog, undefined, undefined);
+
+let dcbEventTopicResource = Component$ReventlessCore.outputs(eventLog).eventTopic.resources[0];
+
+function encodeEvent(event) {
+  let json = Util_Sury$Reventless.toJson(event, eventSchema);
+  let match = Message$ReventlessCore.splitMessage(json);
+  let tags = DcbTag$Reventless.extractTags(eventSchema, event);
+  let meta = Message$ReventlessCore.generateMeta("test", undefined, undefined, undefined, undefined, undefined, undefined, undefined);
+  return {
+    eventType: match[0],
+    data: match[1],
+    tags: tags,
+    meta: meta
+  };
+}
+
+async function appendEvent(event) {
+  let ops = await TestRunner$ReventlessLocal.resolve(OrderEventLogMaker.operations(eventLog));
+  await ops.append([encodeEvent(event)], undefined);
+}
+
+async function loadState(id) {
+  let ops = Bus.getQueryDb("DnOrdersView");
+  if (ops === undefined) {
+    return [];
+  }
+  let states = await Effect.runPromise(Effect.catchAll(Stream.runCollect(ops.loadStream(id)), param => Effect.succeed([])));
+  return states.map(json => Util_Sury$Reventless.fromJson(json, stateSchema$1));
+}
+
+export {
+  OrderEventLog,
+  OrdersViewSpec,
+  OrdersViewProjection,
+  Bus,
+  OrderEventLogMaker,
+  eventLog,
+  SVMaker,
+  OrdersViewMaker,
+  sv,
+  dcbEventTopicResource,
+  encodeEvent,
+  appendEvent,
+  loadState,
+}
+/* eventSchema Not a pure module */

package/tests/components/stateviewslice/StateViewSliceDisplayNameTest.res

@@ -0,0 +1,32 @@
+// The @displayName overlay on the StateViewSlice projection path.
+// Without it the column stays null and every surface names the row by its id.
+
+open JestGlobals
+open StateViewSliceDisplayNameFixtures
+
+describe("StateViewSlice @displayName", () => {
+  let _ = beforeAllAsync(async () => {
+    let _ = await sv->OrdersViewMaker.operations->TestRunner.resolve
+    let _ = await dcbEventTopicResource.name->TestRunner.resolve
+  })
+
+  testPromise("a projected state carries the composed label", async () => {
+    let _ = await appendEvent(
+      OrderEventLog.OrderPlaced({id: "order-1", placedAt: "2026-09-01T10:00:00.000Z"}),
+    )
+    let states = await loadState("order-1")
+    expect(states->Array.length)->toBe(1)
+    let s = states->Array.getUnsafe(0)
+    expect(s.displayName)->toEqual(Some("2026-09-01T10:00:00.000Z"))
+  })
+
+  testPromise("an update recomposes it from the state it wrote", async () => {
+    let _ = await appendEvent(
+      OrderEventLog.OrderShipped({id: "order-1", shippedAt: "2026-09-02T10:00:00.000Z"}),
+    )
+    let states = await loadState("order-1")
+    let s = states->Array.getUnsafe(0)
+    expect(s.shippedAt)->toBe("2026-09-02T10:00:00.000Z")
+    expect(s.displayName)->toEqual(Some("2026-09-01T10:00:00.000Z"))
+  })
+})

package/tests/components/stateviewslice/StateViewSliceDisplayNameTest.res.mjs

@@ -0,0 +1,35 @@
+// Generated by ReScript, PLEASE EDIT WITH CARE
+
+import * as TestRunner$ReventlessLocal from "../../../src/test/TestRunner.res.mjs";
+import * as StateViewSliceDisplayNameFixtures$ReventlessLocal from "./StateViewSliceDisplayNameFixtures.res.mjs";
+
+globalThis.describe("StateViewSlice @displayName", () => {
+  globalThis.beforeAll(async () => {
+    await TestRunner$ReventlessLocal.resolve(StateViewSliceDisplayNameFixtures$ReventlessLocal.OrdersViewMaker.operations(StateViewSliceDisplayNameFixtures$ReventlessLocal.sv));
+    await TestRunner$ReventlessLocal.resolve(StateViewSliceDisplayNameFixtures$ReventlessLocal.dcbEventTopicResource.name);
+  });
+  globalThis.test("a projected state carries the composed label", async () => {
+    await StateViewSliceDisplayNameFixtures$ReventlessLocal.appendEvent({
+      TAG: "OrderPlaced",
+      id: "order-1",
+      placedAt: "2026-09-01T10:00:00.000Z"
+    });
+    let states = await StateViewSliceDisplayNameFixtures$ReventlessLocal.loadState("order-1");
+    globalThis.expect(states.length).toBe(1);
+    let s = states[0];
+    globalThis.expect(s.displayName).toEqual("2026-09-01T10:00:00.000Z");
+  });
+  globalThis.test("an update recomposes it from the state it wrote", async () => {
+    await StateViewSliceDisplayNameFixtures$ReventlessLocal.appendEvent({
+      TAG: "OrderShipped",
+      id: "order-1",
+      shippedAt: "2026-09-02T10:00:00.000Z"
+    });
+    let states = await StateViewSliceDisplayNameFixtures$ReventlessLocal.loadState("order-1");
+    let s = states[0];
+    globalThis.expect(s.shippedAt).toBe("2026-09-02T10:00:00.000Z");
+    globalThis.expect(s.displayName).toEqual("2026-09-01T10:00:00.000Z");
+  });
+});
+
+/*  Not a pure module */

package/tests/plugin/UiFragmentRegistry_GWT.res.mjs

@@ -2,8 +2,8 @@
 
 import * as Behavior_GWT$ReventlessGwt from "@reventlessdev/reventless-gwt/src/Behavior_GWT.res.mjs";
 import * as Plugin_Fixtures$ReventlessLocal from "./Plugin_Fixtures.res.mjs";
-import * as UiFragmentRegistry$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChangeSlice/UiFragmentRegistry.res.mjs";
-import * as UiFragmentRegistry_Behavior$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChangeSlice/UiFragmentRegistry_Behavior.res.mjs";
+import * as UiFragmentRegistry$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChange/UiFragmentRegistry.res.mjs";
+import * as UiFragmentRegistry_Behavior$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateChange/UiFragmentRegistry_Behavior.res.mjs";
 
 let Test = Behavior_GWT$ReventlessGwt.Make({
   name: UiFragmentRegistry$ReventlessCore.name,

package/tests/plugin/UiFragments_GWT.res.mjs

@@ -1,9 +1,9 @@
 // Generated by ReScript, PLEASE EDIT WITH CARE
 
-import * as UiFragments$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateViewSlice/UiFragments.res.mjs";
+import * as UiFragments$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateView/UiFragments.res.mjs";
 import * as Projection_GWT$ReventlessGwt from "@reventlessdev/reventless-gwt/src/Projection_GWT.res.mjs";
 import * as Plugin_Fixtures$ReventlessLocal from "./Plugin_Fixtures.res.mjs";
-import * as UiFragments_Projection$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateViewSlice/UiFragments_Projection.res.mjs";
+import * as UiFragments_Projection$ReventlessCore from "@reventlessdev/reventless-core/src/admin/UiFragmentRegistry/StateView/UiFragments_Projection.res.mjs";
 
 let Test = Projection_GWT$ReventlessGwt.Make({
   name: UiFragments$ReventlessCore.name,