@reventlessdev/reventless-core 3.0.0-alpha.300 → 3.0.0-alpha.302

package/tests/plugin/PluginStructureTest.res

@@ -18,7 +18,7 @@ type svsComponent = Component.t<
 
 module PsPlaceOrderSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsPlaceOrder
-  module Behavior = {
+  module Decision = {
     type state = PsPlaceOrder.state
     let initialState = PsPlaceOrder.initialState
     let evolve = PsPlaceOrder.evolve
@@ -39,7 +39,7 @@ module PsPlaceOrderSlice: ReventlessInfra.StateChangeSlice.T = {
 }
 module PsShipOrderSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsShipOrder
-  module Behavior = {
+  module Decision = {
     type state = PsShipOrder.state
     let initialState = PsShipOrder.initialState
     let evolve = PsShipOrder.evolve
@@ -106,7 +106,7 @@ module PsCategoriesViewSlice: ReventlessInfra.StateViewSlice.T = {
 
 module PsAttachInvoiceSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsAttachInvoice
-  module Behavior = {
+  module Decision = {
     type state = PsAttachInvoice.state
     let initialState = PsAttachInvoice.initialState
     let evolve = PsAttachInvoice.evolve
@@ -128,7 +128,7 @@ module PsAttachInvoiceSlice: ReventlessInfra.StateChangeSlice.T = {
 
 module PsUploadAvatarSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsUploadAvatar
-  module Behavior = {
+  module Decision = {
     type state = PsUploadAvatar.state
     let initialState = PsUploadAvatar.initialState
     let evolve = PsUploadAvatar.evolve
@@ -150,7 +150,7 @@ module PsUploadAvatarSlice: ReventlessInfra.StateChangeSlice.T = {
 
 module PsUploadImagesSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsUploadImages
-  module Behavior = {
+  module Decision = {
     type state = PsUploadImages.state
     let initialState = PsUploadImages.initialState
     let evolve = PsUploadImages.evolve
@@ -172,7 +172,7 @@ module PsUploadImagesSlice: ReventlessInfra.StateChangeSlice.T = {
 
 module PsTypoStoreSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsTypoStore
-  module Behavior = {
+  module Decision = {
     type state = PsTypoStore.state
     let initialState = PsTypoStore.initialState
     let evolve = PsTypoStore.evolve
@@ -194,7 +194,7 @@ module PsTypoStoreSlice: ReventlessInfra.StateChangeSlice.T = {
 
 module PsChangePhotoSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsChangePhoto
-  module Behavior = {
+  module Decision = {
     type state = PsChangePhoto.state
     let initialState = PsChangePhoto.initialState
     let evolve = PsChangePhoto.evolve
@@ -216,7 +216,7 @@ module PsChangePhotoSlice: ReventlessInfra.StateChangeSlice.T = {
 
 module PsReserveStockSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsReserveStock
-  module Behavior = {
+  module Decision = {
     type state = PsReserveStock.state
     let initialState = PsReserveStock.initialState
     let evolve = PsReserveStock.evolve
@@ -238,7 +238,7 @@ module PsReserveStockSlice: ReventlessInfra.StateChangeSlice.T = {
 
 module PsDispatchShipmentSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsDispatchShipment
-  module Behavior = {
+  module Decision = {
     type state = PsDispatchShipment.state
     let initialState = PsDispatchShipment.initialState
     let evolve = PsDispatchShipment.evolve
@@ -259,7 +259,7 @@ module PsDispatchShipmentSlice: ReventlessInfra.StateChangeSlice.T = {
 }
 module PsTransitionSwitchSlice: ReventlessInfra.StateChangeSlice.T = {
   module Spec = PsTransitionSwitch
-  module Behavior = {
+  module Decision = {
     type state = PsTransitionSwitch.state
     let initialState = PsTransitionSwitch.initialState
     let evolve = PsTransitionSwitch.evolve
@@ -301,7 +301,7 @@ let structure = Plugin_Structure.make(
 
 describe("lifecycle topology", () => {
   let ordersStates = Dict.fromArray([("Orders", ["Placed", "Shipped", "Cancelled"])])
-  let writableWith = (commands): Reventless.Plugin.writableDef => {
+  let writableWith = (commands): Reventless.Plugin.writeSideDef => {
     name: "Ordering",
     commands,
     producedEventTypes: [],
@@ -330,7 +330,7 @@ describe("lifecycle topology", () => {
   testSync("names a state no command can reach", () => {
     // `Cancelled` is in the enum and nothing declares an edge into it.
     let findings = Plugin_Structure.lifecycleTopologyFindings(
-      ~writables=[
+      ~writeSides=[
         writableWith([
           command(~name="Ship", ~allowedStates=["Placed"], ~targetState="Shipped", ()),
         ]),
@@ -342,7 +342,7 @@ describe("lifecycle topology", () => {
 
   testSync("says nothing when every state is reachable", () => {
     let findings = Plugin_Structure.lifecycleTopologyFindings(
-      ~writables=[
+      ~writeSides=[
         writableWith([
           command(~name="Ship", ~allowedStates=["Placed"], ~targetState="Shipped", ()),
           command(~name="Cancel", ~allowedStates=["Placed"], ~targetState="Cancelled", ()),
@@ -357,7 +357,7 @@ describe("lifecycle topology", () => {
   // expected rather than suspicious.
   testSync("does not call the initial state unreachable", () => {
     let findings = Plugin_Structure.lifecycleTopologyFindings(
-      ~writables=[
+      ~writeSides=[
         writableWith([
           command(~name="Ship", ~allowedStates=["Placed"], ~targetState="Shipped", ()),
           command(~name="Cancel", ~allowedStates=["Placed"], ~targetState="Cancelled", ()),
@@ -374,7 +374,7 @@ describe("lifecycle topology", () => {
   // silenced. See the comment in Plugin_Structure.
   testSync("does not report a state with no way out", () => {
     let findings = Plugin_Structure.lifecycleTopologyFindings(
-      ~writables=[
+      ~writeSides=[
         writableWith([
           command(~name="Ship", ~allowedStates=["Placed"], ~targetState="Shipped", ()),
           command(~name="Cancel", ~allowedStates=["Placed"], ~targetState="Cancelled", ()),
@@ -410,7 +410,7 @@ describe("commandTransition — the edge as a switch", () => {
   testSync("a guard declares its from-set and no target", () => {
     // A positive claim rather than an omission: legal in these states, and it
     // moves the row nowhere. Distinguishable on the wire from both fields being
-    // None, and consumers are expected to honour it.
+    // None, and consumers are expected to honor it.
     expect((
       byName("Rebook")->Option.flatMap(c => c.allowedStates),
       byName("Rebook")->Option.flatMap(c => c.targetState),
@@ -1310,7 +1310,7 @@ describe("Plugin_Structure.make — Phase 2 graph fields", () => {
   // worked it out — the same declaration-vs-guess distinction `labelFieldSource`
   // publishes, for the field the generated filter and order-by are built from.
   describe("idField / idFieldSource — the key and its provenance", () => {
-    let keyOf = (q: Reventless.Plugin.queryableDef) => (q.idField, q.idFieldSource)
+    let keyOf = (q: Reventless.Plugin.readSideDef) => (q.idField, q.idFieldSource)
     let withCategories = Plugin_Structure.make(
       ~name="TestPlugin",
       ~stateChangeSlices=[],
@@ -1431,7 +1431,7 @@ describe("Plugin_Structure.make — Phase 2 graph fields", () => {
       },
     )
 
-    // The one behaviour the rename deliberately changes, so it is asserted rather
+    // The one behavior the rename deliberately changes, so it is asserted rather
     // than assumed. `status` is a promiscuous name — geocoding progress, todo-queue
     // progress, translation audit outcome — and a convention keyed on it guessed
     // often. A record whose lifecycle really does live in a field called `status`
@@ -1700,7 +1700,7 @@ describe("Plugin_Structure.make — Phase 2 graph fields", () => {
     )
 
     // The second rule stays a warning: retirement still works, and which field
-    // carries it is a modelling judgement rather than a name that is wrong.
+    // carries it is a modeling judgement rather than a name that is wrong.
     testSync(
       "a state on a non-lifecycle field is not a failure",
       () => {
@@ -1738,11 +1738,11 @@ describe("Plugin_Structure.make — Phase 2 graph fields", () => {
     | None => None
     }
 
-  // Phase 4: queryableDef.schema must carry x-reventless-* extension keys for
+  // Phase 4: readSideDef.schema must carry x-reventless-* extension keys for
   // annotated state types. Plugin_Structure now uses SuryToJsonSchema.deriveObjectSchema
   // (annotation-aware) instead of S.toInputJSONSchemaOrThrow (metadata-blind).
-  describe("queryableDef.schema propagates x-reventless-* annotations", () => {
-    let parseSchema = (svs: Reventless.Plugin.queryableDef): JSON.t => svs.schema->JSON.parseOrThrow
+  describe("readSideDef.schema propagates x-reventless-* annotations", () => {
+    let parseSchema = (svs: Reventless.Plugin.readSideDef): JSON.t => svs.schema->JSON.parseOrThrow
 
     let annotatedSchema = structure.stateViewSlices->Array.getUnsafe(3)->parseSchema
 
@@ -2174,7 +2174,7 @@ describe("Plugin_Structure.make — Phase 2 graph fields", () => {
     testSync("nothing else is collected", () => expect(stores->Array.length)->toBe(4))
 
     // The event field derives the same store as the command field of the same
-    // name, so the two collapse to one declaration site — the behaviour the
+    // name, so the two collapse to one declaration site — the behavior the
     // annotation form already had, reached without an annotation.
     testSync(
       "each requirement keeps its declaring sites",
@@ -2480,7 +2480,7 @@ describe("Plugin_Structure.make — Phase 2 graph fields", () => {
   // the marker where `Reference.to_` returns it: on the element schema, one level
   // inside the array. Reading the field's own schema therefore answers "no
   // reference" for every `@ref` array — and the consuming side treats a missing
-  // declaration as licence to guess, so the field resolves to whatever its name
+  // declaration as license to guess, so the field resolves to whatever its name
   // suggests instead of what the author wrote.
   describe("plural references reach the manifest", () => {
     let withPluralRefs = Plugin_Structure.make(

package/tests/plugin/PluginStructureTest.res.mjs

@@ -35,7 +35,7 @@ import * as PsTransitionSwitch$ReventlessCore from "./StateChange/PsTransitionSw
 import * as Capability_Inference$ReventlessCore from "../../src/plugin/component/Capability_Inference.res.mjs";
 import * as PsAvailableProductsView$ReventlessCore from "./StateView/PsAvailableProductsView.res.mjs";
 
-let Behavior = {
+let Decision = {
   initialState: false,
   evolve: PsPlaceOrder$ReventlessCore.evolve,
   decide: PsPlaceOrder$ReventlessCore.decide,
@@ -61,12 +61,12 @@ let PsPlaceOrderSlice_Spec = {
 
 let PsPlaceOrderSlice = {
   Spec: PsPlaceOrderSlice_Spec,
-  Behavior: Behavior,
+  Decision: Decision,
   isAsync: false,
   make: make
 };
 
-let Behavior$1 = {
+let Decision$1 = {
   initialState: false,
   evolve: PsShipOrder$ReventlessCore.evolve,
   decide: PsShipOrder$ReventlessCore.decide,
@@ -92,7 +92,7 @@ let PsShipOrderSlice_Spec = {
 
 let PsShipOrderSlice = {
   Spec: PsShipOrderSlice_Spec,
-  Behavior: Behavior$1,
+  Decision: Decision$1,
   isAsync: false,
   make: make$1
 };
@@ -110,7 +110,7 @@ let PsOrdersViewSlice_Spec = {
   name: PsOrdersView$ReventlessCore.name,
   moduleUrl: PsOrdersView$ReventlessCore.moduleUrl,
   stateSchema: PsOrdersView$ReventlessCore.stateSchema,
-  Key: {
+  Id: {
     schema: Id$Reventless.StringPure.schema,
     make: prim => prim,
     makeFromString: prim => prim,
@@ -143,7 +143,7 @@ let PsAvailableProductsViewSlice_Spec = {
   name: PsAvailableProductsView$ReventlessCore.name,
   moduleUrl: PsAvailableProductsView$ReventlessCore.moduleUrl,
   stateSchema: PsAvailableProductsView$ReventlessCore.stateSchema,
-  Key: {
+  Id: {
     schema: Id$Reventless.StringPure.schema,
     make: prim => prim,
     makeFromString: prim => prim,
@@ -176,7 +176,7 @@ let PsCustomersViewSlice_Spec = {
   name: PsCustomersView$ReventlessCore.name,
   moduleUrl: PsCustomersView$ReventlessCore.moduleUrl,
   stateSchema: PsCustomersView$ReventlessCore.stateSchema,
-  Key: {
+  Id: {
     schema: Id$Reventless.StringPure.schema,
     make: prim => prim,
     makeFromString: prim => prim,
@@ -209,7 +209,7 @@ let PsAnnotatedViewSlice_Spec = {
   name: PsAnnotatedView$ReventlessCore.name,
   moduleUrl: PsAnnotatedView$ReventlessCore.moduleUrl,
   stateSchema: PsAnnotatedView$ReventlessCore.stateSchema,
-  Key: {
+  Id: {
     schema: Id$Reventless.StringPure.schema,
     make: prim => prim,
     makeFromString: prim => prim,
@@ -242,7 +242,7 @@ let PsCategoriesViewSlice_Spec = {
   name: PsCategoriesView$ReventlessCore.name,
   moduleUrl: PsCategoriesView$ReventlessCore.moduleUrl,
   stateSchema: PsCategoriesView$ReventlessCore.stateSchema,
-  Key: {
+  Id: {
     schema: Id$Reventless.StringPure.schema,
     make: prim => prim,
     makeFromString: prim => prim,
@@ -262,7 +262,7 @@ let PsCategoriesViewSlice = {
   make: make$6
 };
 
-let Behavior$2 = {
+let Decision$2 = {
   initialState: false,
   evolve: PsAttachInvoice$ReventlessCore.evolve,
   decide: PsAttachInvoice$ReventlessCore.decide,
@@ -288,12 +288,12 @@ let PsAttachInvoiceSlice_Spec = {
 
 let PsAttachInvoiceSlice = {
   Spec: PsAttachInvoiceSlice_Spec,
-  Behavior: Behavior$2,
+  Decision: Decision$2,
   isAsync: false,
   make: make$7
 };
 
-let Behavior$3 = {
+let Decision$3 = {
   initialState: false,
   evolve: PsUploadAvatar$ReventlessCore.evolve,
   decide: PsUploadAvatar$ReventlessCore.decide,
@@ -319,12 +319,12 @@ let PsUploadAvatarSlice_Spec = {
 
 let PsUploadAvatarSlice = {
   Spec: PsUploadAvatarSlice_Spec,
-  Behavior: Behavior$3,
+  Decision: Decision$3,
   isAsync: false,
   make: make$8
 };
 
-let Behavior$4 = {
+let Decision$4 = {
   initialState: false,
   evolve: PsUploadImages$ReventlessCore.evolve,
   decide: PsUploadImages$ReventlessCore.decide,
@@ -350,12 +350,12 @@ let PsUploadImagesSlice_Spec = {
 
 let PsUploadImagesSlice = {
   Spec: PsUploadImagesSlice_Spec,
-  Behavior: Behavior$4,
+  Decision: Decision$4,
   isAsync: false,
   make: make$9
 };
 
-let Behavior$5 = {
+let Decision$5 = {
   initialState: false,
   evolve: PsTypoStore$ReventlessCore.evolve,
   decide: PsTypoStore$ReventlessCore.decide,
@@ -381,12 +381,12 @@ let PsTypoStoreSlice_Spec = {
 
 let PsTypoStoreSlice = {
   Spec: PsTypoStoreSlice_Spec,
-  Behavior: Behavior$5,
+  Decision: Decision$5,
   isAsync: false,
   make: make$10
 };
 
-let Behavior$6 = {
+let Decision$6 = {
   initialState: false,
   evolve: PsChangePhoto$ReventlessCore.evolve,
   decide: PsChangePhoto$ReventlessCore.decide,
@@ -412,12 +412,12 @@ let PsChangePhotoSlice_Spec = {
 
 let PsChangePhotoSlice = {
   Spec: PsChangePhotoSlice_Spec,
-  Behavior: Behavior$6,
+  Decision: Decision$6,
   isAsync: false,
   make: make$11
 };
 
-let Behavior$7 = {
+let Decision$7 = {
   initialState: false,
   evolve: PsReserveStock$ReventlessCore.evolve,
   decide: PsReserveStock$ReventlessCore.decide,
@@ -443,12 +443,12 @@ let PsReserveStockSlice_Spec = {
 
 let PsReserveStockSlice = {
   Spec: PsReserveStockSlice_Spec,
-  Behavior: Behavior$7,
+  Decision: Decision$7,
   isAsync: false,
   make: make$12
 };
 
-let Behavior$8 = {
+let Decision$8 = {
   initialState: false,
   evolve: PsDispatchShipment$ReventlessCore.evolve,
   decide: PsDispatchShipment$ReventlessCore.decide,
@@ -474,12 +474,12 @@ let PsDispatchShipmentSlice_Spec = {
 
 let PsDispatchShipmentSlice = {
   Spec: PsDispatchShipmentSlice_Spec,
-  Behavior: Behavior$8,
+  Decision: Decision$8,
   isAsync: false,
   make: make$13
 };
 
-let Behavior$9 = {
+let Decision$9 = {
   initialState: false,
   evolve: PsTransitionSwitch$ReventlessCore.evolve,
   decide: PsTransitionSwitch$ReventlessCore.decide,
@@ -505,7 +505,7 @@ let PsTransitionSwitchSlice_Spec = {
 
 let PsTransitionSwitchSlice = {
   Spec: PsTransitionSwitchSlice_Spec,
-  Behavior: Behavior$9,
+  Decision: Decision$9,
   isAsync: false,
   make: make$14
 };
@@ -523,7 +523,7 @@ let PsShipmentsViewSlice_Spec = {
   name: PsShipmentsView$ReventlessCore.name,
   moduleUrl: PsShipmentsView$ReventlessCore.moduleUrl,
   stateSchema: PsShipmentsView$ReventlessCore.stateSchema,
-  Key: {
+  Id: {
     schema: Id$Reventless.StringPure.schema,
     make: prim => prim,
     makeFromString: prim => prim,
@@ -1567,7 +1567,7 @@ globalThis.describe("Plugin_Structure.make — Phase 2 graph fields", () => {
       return obj[fieldName];
     }
   };
-  globalThis.describe("queryableDef.schema propagates x-reventless-* annotations", () => {
+  globalThis.describe("readSideDef.schema propagates x-reventless-* annotations", () => {
     let annotatedSchema = JSON.parse(structure.stateViewSlices[3].schema);
     globalThis.test("itemId carries x-reventless-id", () => {
       globalThis.expect(Stdlib_Option.flatMap(Stdlib_Option.flatMap(getPropertyOf(annotatedSchema, "itemId"), s => getProperty(s, "x-reventless-id")), Stdlib_JSON.Decode.bool)).toBe(true);

package/tests/plugin/StateView/PsAnnotatedView.res

@@ -1,6 +1,6 @@
 // Phase 4 fixture: state-view slice with structural annotations.
 // Used to verify Plugin_Structure.make ships x-reventless-* extension
-// properties through queryableDef.schema after swapping S.toInputJSONSchemaOrThrow
+// properties through readSideDef.schema after swapping S.toInputJSONSchemaOrThrow
 // for SuryToJsonSchema.deriveObjectSchema.
 
 @@reventless.spec("AnnotatedView")

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

@@ -99,8 +99,6 @@ let name = "AnnotatedView";
 
 let Id;
 
-let Key;
-
 let moduleUrl = "@reventlessdev/reventless-core/tests/plugin/StateView/PsAnnotatedView.res.mjs";
 
 let authorization = "AllowAuthenticated";
@@ -109,11 +107,10 @@ let visibility = "Public";
 
 export {
   name,
-  Id,
   consumedEventSchema,
   project,
   config,
-  Key,
+  Id,
   subIdConfig,
   makeId,
   stateSchema$1 as stateSchema,

package/tests/plugin/StateView/PsAvailableProductsView.res.mjs

@@ -47,8 +47,6 @@ let name = "AvailableProducts";
 
 let Id;
 
-let Key;
-
 let subIdConfig;
 
 let moduleUrl = "@reventlessdev/reventless-core/tests/plugin/StateView/PsAvailableProductsView.res.mjs";
@@ -59,12 +57,11 @@ let visibility = "Public";
 
 export {
   name,
-  Id,
   consumedEventSchema,
   stateSchema,
   project,
   config,
-  Key,
+  Id,
   subIdConfig,
   moduleUrl,
   authorization,

package/tests/plugin/StateView/PsCategoriesView.res.mjs

@@ -34,8 +34,6 @@ let name = "Categories";
 
 let Id;
 
-let Key;
-
 let subIdConfig;
 
 let moduleUrl = "@reventlessdev/reventless-core/tests/plugin/StateView/PsCategoriesView.res.mjs";
@@ -46,12 +44,11 @@ let visibility = "Public";
 
 export {
   name,
-  Id,
   consumedEventSchema,
   stateSchema,
   project,
   config,
-  Key,
+  Id,
   subIdConfig,
   moduleUrl,
   authorization,

package/tests/plugin/StateView/PsCustomersView.res.mjs

@@ -47,8 +47,6 @@ let name = "Customers";
 
 let Id;
 
-let Key;
-
 let subIdConfig;
 
 let moduleUrl = "@reventlessdev/reventless-core/tests/plugin/StateView/PsCustomersView.res.mjs";
@@ -59,12 +57,11 @@ let visibility = "Public";
 
 export {
   name,
-  Id,
   consumedEventSchema,
   stateSchema$1 as stateSchema,
   project,
   config,
-  Key,
+  Id,
   subIdConfig,
   moduleUrl,
   authorization,

package/tests/plugin/StateView/PsGatedView.res.mjs

@@ -39,8 +39,6 @@ let name = "GatedView";
 
 let Id;
 
-let Key;
-
 let subIdConfig;
 
 let moduleUrl = "@reventlessdev/reventless-core/tests/plugin/StateView/PsGatedView.res.mjs";
@@ -49,12 +47,11 @@ let visibility = "Public";
 
 export {
   name,
-  Id,
   consumedEventSchema,
   stateSchema,
   project,
   config,
-  Key,
+  Id,
   subIdConfig,
   moduleUrl,
   authorization,

package/tests/plugin/StateView/PsOrdersView.res.mjs

@@ -59,8 +59,6 @@ let name = "Orders";
 
 let Id;
 
-let Key;
-
 let subIdConfig;
 
 let moduleUrl = "@reventlessdev/reventless-core/tests/plugin/StateView/PsOrdersView.res.mjs";
@@ -71,12 +69,11 @@ let visibility = "Public";
 
 export {
   name,
-  Id,
   consumedEventSchema,
   stateSchema,
   project,
   config,
-  Key,
+  Id,
   subIdConfig,
   moduleUrl,
   authorization,

package/tests/plugin/StateView/PsShipmentsView.res.mjs

@@ -78,8 +78,6 @@ let name = "Shipments";
 
 let Id;
 
-let Key;
-
 let subIdConfig;
 
 let moduleUrl = "@reventlessdev/reventless-core/tests/plugin/StateView/PsShipmentsView.res.mjs";
@@ -90,12 +88,11 @@ let visibility = "Public";
 
 export {
   name,
-  Id,
   consumedEventSchema,
   shipmentStatusSchema,
   project,
   config,
-  Key,
+  Id,
   subIdConfig,
   stateSchema$1 as stateSchema,
   moduleUrl,

package/tests/projection/LifecycleTrailTest.res

@@ -91,7 +91,7 @@ describe("the lifecycle trail:", () => {
     expect(run(events)->statesOf)->toEqual(run(events)->statesOf)
   })
 
-  // The marker is what makes a trail recognisable to a consumer holding only the
+  // The marker is what makes a trail recognizable to a consumer holding only the
   // schema. `SchemaType.trailShape` walks the entries by shape, which skips the
   // semantic dispatch `fromSury` does, so this is the assertion that catches it
   // being dropped there — the field would still emit as a plain array of objects.