@almadar/core 10.101.0 → 10.103.0

package/dist/{types-Ug92oza4.d.ts → types-DK29MMOQ.d.ts}

@@ -1,5 +1,5 @@
-import { E as EntityField, a as EntityPersistence, R as RelationConfig } from './effect-Hm_QDaSI.js';
-import { T as TraitEventListener, a as TraitReference } from './trait-YlNXc4H3.js';
+import { E as EntityField, a as EntityPersistence, R as RelationConfig } from './effect-Xn3LIyL7.js';
+import { T as TraitEventListener, a as TraitReference } from './trait-BSe6oDBd.js';
 import { J as JsonValue } from './json-D8gmyK3l.js';
 
 /**

package/fixtures/events-wire/client-effects-provenance/request.json

@@ -0,0 +1,5 @@
+{
+  "clientId": "tab-1",
+  "event": "SAVE",
+  "targetTrait": "NoteForm"
+}

package/fixtures/events-wire/client-effects-provenance/response.json

@@ -0,0 +1,57 @@
+{
+  "clientEffects": [
+    [
+      "render-ui",
+      "main",
+      {
+        "message": "Saved",
+        "type": "alert"
+      }
+    ],
+    [
+      "render-ui",
+      "sidebar",
+      {
+        "entity": "Note",
+        "type": "data-list"
+      }
+    ]
+  ],
+  "clientEffectsByTrait": [
+    {
+      "effect": [
+        "render-ui",
+        "main",
+        {
+          "message": "Saved",
+          "type": "alert"
+        }
+      ],
+      "event": "SAVE",
+      "fromState": "editing",
+      "traitName": "NoteForm"
+    },
+    {
+      "effect": [
+        "render-ui",
+        "sidebar",
+        {
+          "entity": "Note",
+          "type": "data-list"
+        }
+      ],
+      "event": "REFRESH",
+      "fromState": "idle",
+      "traitName": "NoteCatalog"
+    }
+  ],
+  "emittedEvents": [],
+  "states": {
+    "InlineButtonRender3": "idle",
+    "NoteCatalog": "browsing",
+    "NoteForm": "saved",
+    "NotePersistor": "idle"
+  },
+  "success": true,
+  "transitioned": true
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/core",
-  "version": "10.101.0",
+  "version": "10.103.0",
   "description": "Core schema types and definitions for Almadar",
   "type": "module",
   "main": "./dist/index.js",
@@ -27,6 +27,11 @@
       "import": "./dist/factory-runtime/index.js",
       "require": "./dist/factory-runtime/index.js"
     },
+    "./lolo-document": {
+      "types": "./dist/lolo-document/index.d.ts",
+      "import": "./dist/lolo-document/index.js",
+      "require": "./dist/lolo-document/index.js"
+    },
     "./state-machine": {
       "types": "./dist/state-machine/index.d.ts",
       "import": "./dist/state-machine/index.js",

package/src/types/bindings.ts

@@ -118,6 +118,31 @@ export const BINDING_DOCS = {
     examples: ['@currentTheme'],
     requiresPath: false,
   },
+  event: {
+    description: 'The delivery being processed: { event, payload, source } — for a listens delivery the source emit, with its BusEventSource envelope (Runtime Spec Clause 5.5)',
+    examples: ['@event.event', '@event.payload.n', '@event.source.trait', '@event.source.tick'],
+    requiresPath: false,
+  },
+  prevEvents: {
+    description: 'The deliveries this trait already received in this dispatch, in order, each shaped like @event',
+    examples: ['@prevEvents'],
+    requiresPath: false,
+  },
+  prevStates: {
+    description: 'The states this trait left in this dispatch, in order',
+    examples: ['@prevStates'],
+    requiresPath: false,
+  },
+  fromState: {
+    description: "The transition's source state",
+    examples: ['@fromState'],
+    requiresPath: false,
+  },
+  toState: {
+    description: "The transition's target state (null in a listens `when`, where no transition is chosen yet)",
+    examples: ['@toState'],
+    requiresPath: false,
+  },
 } as const;
 
 /**
@@ -125,12 +150,12 @@ export const BINDING_DOCS = {
  */
 export const BINDING_CONTEXT_RULES = {
   guard: {
-    allowed: ['entity', 'payload', 'state', 'now', 'config', 'user'] as const,
+    allowed: ['entity', 'payload', 'state', 'now', 'config', 'user', 'event', 'prevEvents', 'prevStates', 'fromState', 'toState'] as const,
     description:
-      'Guards can access entity fields, event payload, current state, time, the call-site trait config (@config.X), and the authenticated user context (@user.id, @user.role) for ownership / role gates. Config access lets atoms write mode-aware guards — e.g. std-modal\'s OPEN can require @payload.row only when @config.mode equals "edit", letting create-mode legitimately fire OPEN with no row. Like effects, @config.X is substituted at molecule/organism inline time with the literal call-site value; at atom-scope validate, @config is allowed-but-unresolved.',
+      'Guards can read the delivery being processed and this dispatch\'s log (@event, @prevEvents, @prevStates) and the transition\'s ends (@fromState, @toState; Runtime Spec Clause 5.5). Guards can access entity fields, event payload, current state, time, the call-site trait config (@config.X), and the authenticated user context (@user.id, @user.role) for ownership / role gates. Config access lets atoms write mode-aware guards — e.g. std-modal\'s OPEN can require @payload.row only when @config.mode equals "edit", letting create-mode legitimately fire OPEN with no row. Like effects, @config.X is substituted at molecule/organism inline time with the literal call-site value; at atom-scope validate, @config is allowed-but-unresolved.',
   },
   effect: {
-    allowed: ['entity', 'payload', 'state', 'now', 'trait', 'config', 'user', 'callsitePayload', 'pages', 'currentTheme'] as const,
+    allowed: ['entity', 'payload', 'state', 'now', 'trait', 'config', 'user', 'callsitePayload', 'pages', 'currentTheme', 'event', 'prevEvents', 'prevStates', 'fromState', 'toState'] as const,
     description:
       'Effects can access and modify entity fields, use payload data, embed another trait\'s live frame via @trait.X inside render-ui children, read trait config values (@config.X) for atoms parameterized by their call-site, and read the authenticated user context (@user.id, @user.role). At molecule/organism inline time, @config.X is substituted with the literal value from the call-site config block; at atom-scope validate, @config is allowed-but-unresolved. @callsitePayload.X is the call-site-captured event payload emitted by the compiler\'s inline-trait hoisting (a hoisted render block that captured @payload); it is resolved at the composing effect by the runtime BindingResolver.',
   },