@almadar/std 3.0.3 → 3.0.5

package/dist/behaviors/functions/index.d.ts

@@ -302,6 +302,8 @@ interface StdModalParams {
     /** If provided, adds a save transition: open → closed with these effects */
     saveEvent?: string;
     saveEffects?: unknown[];
+    /** Event to emit after save succeeds. Browse traits listen for this instead of raw SAVE. */
+    emitOnSave?: string;
     /** When false, INIT renders nothing to main (used inside molecules). Default true. */
     standalone?: boolean;
     pageName?: string;
@@ -342,6 +344,8 @@ interface StdConfirmationParams {
     confirmEvent?: string;
     /** Additional effects to run on confirm (e.g., persist delete) */
     confirmEffects?: unknown[];
+    /** Event to emit after confirm succeeds. Browse traits listen for this. */
+    emitOnConfirm?: string;
     /** When false, INIT renders nothing to main (used inside molecules). Default true. */
     standalone?: boolean;
     pageName?: string;

package/dist/behaviors/functions/index.js

@@ -102,10 +102,12 @@ function buildTrait(c) {
       return needsId ? { key: e, name: e, payload: [{ name: "id", type: "string", required: true }] } : { key: e, name: e };
     })
   ];
+  const listensDecl = c.refreshEvents.length > 0 ? c.refreshEvents.map((evt) => ({ event: evt, triggers: evt })) : void 0;
   return {
     name: c.traitName,
     linkedEntity: entityName,
     category: "interaction",
+    ...listensDecl ? { listens: listensDecl } : {},
     stateMachine: {
       states: [{ name: "browsing", isInitial: true }],
       events,
@@ -220,6 +222,7 @@ function resolve2(params) {
     openEffects: params.openEffects ?? [],
     saveEvent: params.saveEvent ?? null,
     saveEffects: params.saveEffects ?? [],
+    emitOnSave: params.emitOnSave ?? null,
     standalone: params.standalone ?? true,
     pageName: params.pageName ?? `${entityName}ModalPage`,
     pagePath: params.pagePath ?? `/${p.toLowerCase()}/modal`,
@@ -274,13 +277,19 @@ function buildTrait2(c) {
       from: "open",
       to: "closed",
       event: c.saveEvent,
-      effects: [...c.saveEffects, ["render-ui", "modal", null]]
+      effects: [
+        ...c.saveEffects,
+        ["render-ui", "modal", null],
+        // Emit after persist succeeds so browse traits can fetch fresh data
+        ...c.emitOnSave ? [["emit", c.emitOnSave]] : []
+      ]
     });
   }
   return {
     name: c.traitName,
     linkedEntity: c.entityName,
     category: "interaction",
+    ...c.emitOnSave ? { emits: [{ event: c.emitOnSave }] } : {},
     stateMachine: {
       states: [{ name: "closed", isInitial: true }, { name: "open" }],
       events,
@@ -304,176 +313,9 @@ function stdModal(params) {
   const c = resolve2(params);
   return makeOrbital(`${c.entityName}Orbital`, buildEntity2(c), [buildTrait2(c)], [buildPage2(c)]);
 }
-function resolve3(params) {
-  const { entityName } = params;
-  const fields = ensureIdField(params.fields);
-  const nonIdFields = fields.filter((f) => f.name !== "id");
-  const p = plural(entityName);
-  return {
-    entityName,
-    fields,
-    displayField: nonIdFields[0]?.name ?? "id",
-    persistence: params.persistence ?? "runtime",
-    traitName: params.traitName ?? `${entityName}Confirmation`,
-    pluralName: p,
-    confirmTitle: params.confirmTitle ?? "Confirm Action",
-    confirmMessage: params.confirmMessage ?? "Are you sure?",
-    confirmLabel: params.confirmLabel ?? "Confirm",
-    cancelLabel: params.cancelLabel ?? "Cancel",
-    headerIcon: params.headerIcon ?? "alert-triangle",
-    requestEvent: params.requestEvent ?? "REQUEST",
-    confirmEvent: params.confirmEvent ?? "CONFIRM",
-    confirmEffects: params.confirmEffects ?? [],
-    standalone: params.standalone ?? true,
-    pageName: params.pageName ?? `${entityName}ConfirmPage`,
-    pagePath: params.pagePath ?? `/${p.toLowerCase()}/confirm`,
-    isInitial: params.isInitial ?? false
-  };
-}
-function buildEntity3(c) {
-  return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
-}
-function buildTrait3(c) {
-  const { entityName, displayField, pluralName, confirmTitle, confirmMessage, confirmLabel, cancelLabel, headerIcon } = c;
-  return {
-    name: c.traitName,
-    linkedEntity: entityName,
-    category: "interaction",
-    stateMachine: {
-      states: [
-        { name: "idle", isInitial: true },
-        { name: "confirming" }
-      ],
-      events: [
-        { key: "INIT", name: "Initialize" },
-        { key: c.requestEvent, name: "Request Confirmation", payload: [{ name: "id", type: "string", required: true }] },
-        { key: c.confirmEvent, name: "Confirm", payload: [{ name: "id", type: "string", required: true }] },
-        { key: "CANCEL", name: "Cancel" },
-        { key: "CLOSE", name: "Close" }
-      ],
-      transitions: [
-        // INIT: idle -> idle
-        {
-          from: "idle",
-          to: "idle",
-          event: "INIT",
-          effects: c.standalone ? [["fetch", entityName], ["render-ui", "main", {
-            type: "stack",
-            direction: "vertical",
-            gap: "lg",
-            children: [
-              { type: "stack", direction: "horizontal", gap: "md", align: "center", children: [
-                { type: "icon", name: headerIcon, size: "lg" },
-                { type: "typography", content: pluralName, variant: "h2" }
-              ] },
-              { type: "divider" },
-              {
-                type: "data-grid",
-                entity: entityName,
-                emptyIcon: "inbox",
-                emptyTitle: `No ${pluralName.toLowerCase()} yet`,
-                emptyDescription: "Items will appear here.",
-                itemActions: [{ label: confirmTitle, event: c.requestEvent, variant: "danger" }],
-                children: [{ type: "stack", direction: "vertical", gap: "sm", children: [
-                  { type: "typography", variant: "h4", content: `@entity.${displayField}` }
-                ] }]
-              }
-            ]
-          }]] : [["fetch", entityName]]
-        },
-        // REQUEST: idle -> confirming
-        {
-          from: "idle",
-          to: "confirming",
-          event: c.requestEvent,
-          effects: [
-            ["render-ui", "modal", {
-              type: "stack",
-              direction: "vertical",
-              gap: "md",
-              children: [
-                {
-                  type: "stack",
-                  direction: "horizontal",
-                  gap: "sm",
-                  align: "center",
-                  children: [
-                    { type: "icon", name: headerIcon, size: "md" },
-                    { type: "typography", content: confirmTitle, variant: "h3" }
-                  ]
-                },
-                { type: "divider" },
-                { type: "typography", content: confirmMessage, variant: "body" },
-                {
-                  type: "stack",
-                  direction: "horizontal",
-                  gap: "sm",
-                  justify: "end",
-                  children: [
-                    { type: "button", label: cancelLabel, event: "CANCEL", variant: "ghost" },
-                    { type: "button", label: confirmLabel, event: c.confirmEvent, variant: "danger", icon: "check" }
-                  ]
-                }
-              ]
-            }]
-          ]
-        },
-        // CONFIRM: confirming -> idle (run injected effects, dismiss modal)
-        {
-          from: "confirming",
-          to: "idle",
-          event: c.confirmEvent,
-          effects: [
-            ...c.confirmEffects,
-            ["render-ui", "modal", null]
-          ]
-        },
-        // CANCEL: confirming -> idle (dismiss modal)
-        {
-          from: "confirming",
-          to: "idle",
-          event: "CANCEL",
-          effects: [
-            ["render-ui", "modal", null]
-          ]
-        },
-        // CLOSE: confirming -> idle (dismiss modal)
-        {
-          from: "confirming",
-          to: "idle",
-          event: "CLOSE",
-          effects: [
-            ["render-ui", "modal", null]
-          ]
-        }
-      ]
-    }
-  };
-}
-function buildPage3(c) {
-  return makePage({ name: c.pageName, path: c.pagePath, traitName: c.traitName, isInitial: c.isInitial });
-}
-function stdConfirmationEntity(params) {
-  return buildEntity3(resolve3(params));
-}
-function stdConfirmationTrait(params) {
-  return buildTrait3(resolve3(params));
-}
-function stdConfirmationPage(params) {
-  return buildPage3(resolve3(params));
-}
-function stdConfirmation(params) {
-  const c = resolve3(params);
-  return makeOrbital(
-    `${c.entityName}Orbital`,
-    buildEntity3(c),
-    [buildTrait3(c)],
-    [buildPage3(c)]
-  );
-}
 
 // behaviors/functions/std-list.ts
-function resolve4(params) {
+function resolve3(params) {
   const { entityName } = params;
   const fields = ensureIdField(params.fields);
   const nonIdFields = fields.filter((f) => f.name !== "id");
@@ -544,14 +386,14 @@ function detailContent(detailFields, closeEvent) {
   };
 }
 function stdListEntity(params) {
-  const c = resolve4(params);
+  const c = resolve3(params);
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence, collection: c.collection });
 }
 function stdListTrait(params) {
   return extractTrait(stdList(params));
 }
 function stdListPage(params) {
-  const c = resolve4(params);
+  const c = resolve3(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -566,7 +408,7 @@ function stdListPage(params) {
   };
 }
 function stdList(params) {
-  const c = resolve4(params);
+  const c = resolve3(params);
   const { entityName, fields, formFields, detailFields } = c;
   const browseTrait = extractTrait(stdBrowse({
     entityName,
@@ -583,7 +425,7 @@ function stdList(params) {
       { label: "Edit", event: "EDIT" },
       { label: "Delete", event: "DELETE", variant: "danger" }
     ],
-    refreshEvents: ["SAVE", "CONFIRM_DELETE"]
+    refreshEvents: ["ENTITY_SAVED"]
   }));
   const createTrait = extractTrait(stdModal({
     standalone: false,
@@ -597,7 +439,8 @@ function stdList(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName]],
     saveEvent: "SAVE",
-    saveEffects: [["persist", "create", entityName, "@payload.data"], ["fetch", entityName]]
+    saveEffects: [["persist", "create", entityName, "@payload.data"], ["fetch", entityName]],
+    emitOnSave: "ENTITY_SAVED"
   }));
   const editTrait = extractTrait(stdModal({
     standalone: false,
@@ -612,7 +455,8 @@ function stdList(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName, "@payload.id"]],
     saveEvent: "SAVE",
-    saveEffects: [["persist", "update", entityName, "@payload.data"], ["fetch", entityName]]
+    saveEffects: [["persist", "update", entityName, "@payload.data"], ["fetch", entityName]],
+    emitOnSave: "ENTITY_SAVED"
   }));
   const viewTrait = extractTrait(stdModal({
     standalone: false,
@@ -627,19 +471,44 @@ function stdList(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName, "@payload.id"]]
   }));
-  const deleteTrait = extractTrait(stdConfirmation({
-    standalone: false,
-    entityName,
-    fields,
-    traitName: `${entityName}Delete`,
-    confirmTitle: `Delete ${entityName}`,
-    confirmMessage: c.deleteMessage,
-    confirmLabel: "Delete",
-    headerIcon: "trash-2",
-    requestEvent: "DELETE",
-    confirmEvent: "CONFIRM_DELETE",
-    confirmEffects: [["persist", "delete", entityName, "@payload.id"], ["fetch", entityName]]
-  }));
+  const sm = browseTrait.stateMachine;
+  sm.states.push({ name: "deleting" });
+  const existingKeys = new Set(sm.events.map((e) => e.key));
+  if (!existingKeys.has("CONFIRM_DELETE")) sm.events.push({ key: "CONFIRM_DELETE", name: "Confirm Delete" });
+  if (!existingKeys.has("CANCEL")) sm.events.push({ key: "CANCEL", name: "Cancel" });
+  if (!existingKeys.has("CLOSE")) sm.events.push({ key: "CLOSE", name: "Close" });
+  sm.transitions.push(
+    // DELETE: browsing → deleting (fetch entity by ID, show confirmation modal)
+    { from: "browsing", to: "deleting", event: "DELETE", effects: [
+      ["fetch", entityName, "@payload.id"],
+      ["render-ui", "modal", {
+        type: "stack",
+        direction: "vertical",
+        gap: "md",
+        children: [
+          { type: "stack", direction: "horizontal", gap: "sm", children: [
+            { type: "icon", name: "trash-2", size: "md" },
+            { type: "typography", content: `Delete ${entityName}`, variant: "h3" }
+          ] },
+          { type: "divider" },
+          { type: "typography", content: c.deleteMessage, variant: "body" },
+          { type: "stack", direction: "horizontal", gap: "sm", justify: "end", children: [
+            { type: "button", label: "Cancel", event: "CANCEL", variant: "ghost" },
+            { type: "button", label: "Delete", event: "CONFIRM_DELETE", variant: "danger", icon: "trash" }
+          ] }
+        ]
+      }]
+    ] },
+    // CONFIRM_DELETE: deleting → browsing (persist delete using selected entity's ID)
+    { from: "deleting", to: "browsing", event: "CONFIRM_DELETE", effects: [
+      ["persist", "delete", entityName, "@entity.id"],
+      ["render-ui", "modal", null],
+      ["fetch", entityName]
+    ] },
+    // CANCEL/CLOSE from deleting
+    { from: "deleting", to: "browsing", event: "CANCEL", effects: [["render-ui", "modal", null]] },
+    { from: "deleting", to: "browsing", event: "CLOSE", effects: [["render-ui", "modal", null]] }
+  );
   const entity = makeEntity({ name: entityName, fields, persistence: c.persistence, collection: c.collection });
   const page = {
     name: c.pageName,
@@ -649,18 +518,17 @@ function stdList(params) {
       { ref: browseTrait.name },
       { ref: createTrait.name },
       { ref: editTrait.name },
-      { ref: viewTrait.name },
-      { ref: deleteTrait.name }
+      { ref: viewTrait.name }
     ]
   };
   return {
     name: `${entityName}Orbital`,
     entity,
-    traits: [browseTrait, createTrait, editTrait, viewTrait, deleteTrait],
+    traits: [browseTrait, createTrait, editTrait, viewTrait],
     pages: [page]
   };
 }
-function resolve5(params) {
+function resolve4(params) {
   const { entityName } = params;
   const fields = ensureIdField(params.fields);
   const nonIdFields = fields.filter((f) => f.name !== "id");
@@ -794,14 +662,14 @@ function buildCartTrait(c) {
   };
 }
 function stdCartEntity(params) {
-  const c = resolve5(params);
+  const c = resolve4(params);
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence, collection: c.collection });
 }
 function stdCartTrait(params) {
-  return buildCartTrait(resolve5(params));
+  return buildCartTrait(resolve4(params));
 }
 function stdCartPage(params) {
-  const c = resolve5(params);
+  const c = resolve4(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -810,7 +678,7 @@ function stdCartPage(params) {
   };
 }
 function stdCart(params) {
-  const c = resolve5(params);
+  const c = resolve4(params);
   const { entityName, fields, formFields } = c;
   const cartTrait = buildCartTrait(c);
   const addTrait = extractTrait(stdModal({
@@ -853,7 +721,7 @@ function stdCart(params) {
     pages: [page]
   };
 }
-function resolve6(params) {
+function resolve5(params) {
   const { entityName } = params;
   const fields = ensureIdField(params.fields);
   const nonIdFields = fields.filter((f) => f.name !== "id");
@@ -879,14 +747,14 @@ function resolve6(params) {
   };
 }
 function stdDetailEntity(params) {
-  const c = resolve6(params);
+  const c = resolve5(params);
   return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence, collection: c.collection });
 }
 function stdDetailTrait(params) {
   return extractTrait(stdDetail(params));
 }
 function stdDetailPage(params) {
-  const c = resolve6(params);
+  const c = resolve5(params);
   return {
     name: c.pageName,
     path: c.pagePath,
@@ -895,7 +763,7 @@ function stdDetailPage(params) {
   };
 }
 function stdDetail(params) {
-  const c = resolve6(params);
+  const c = resolve5(params);
   const { entityName, fields, formFields, detailFields } = c;
   const browseTrait = extractTrait(stdBrowse({
     entityName,
@@ -987,6 +855,184 @@ function stdDetail(params) {
     pages: [page]
   };
 }
+function resolve6(params) {
+  const { entityName } = params;
+  const fields = ensureIdField(params.fields);
+  const nonIdFields = fields.filter((f) => f.name !== "id");
+  const p = plural(entityName);
+  return {
+    entityName,
+    fields,
+    displayField: nonIdFields[0]?.name ?? "id",
+    persistence: params.persistence ?? "runtime",
+    traitName: params.traitName ?? `${entityName}Confirmation`,
+    pluralName: p,
+    confirmTitle: params.confirmTitle ?? "Confirm Action",
+    confirmMessage: params.confirmMessage ?? "Are you sure?",
+    confirmLabel: params.confirmLabel ?? "Confirm",
+    cancelLabel: params.cancelLabel ?? "Cancel",
+    headerIcon: params.headerIcon ?? "alert-triangle",
+    requestEvent: params.requestEvent ?? "REQUEST",
+    confirmEvent: params.confirmEvent ?? "CONFIRM",
+    confirmEffects: params.confirmEffects ?? [],
+    emitOnConfirm: params.emitOnConfirm ?? null,
+    standalone: params.standalone ?? true,
+    pageName: params.pageName ?? `${entityName}ConfirmPage`,
+    pagePath: params.pagePath ?? `/${p.toLowerCase()}/confirm`,
+    isInitial: params.isInitial ?? false
+  };
+}
+function buildEntity3(c) {
+  const fields = [
+    ...c.fields.filter((f) => f.name !== "pendingId"),
+    { name: "pendingId", type: "string", default: "" }
+  ];
+  return makeEntity({ name: c.entityName, fields, persistence: c.persistence });
+}
+function buildTrait3(c) {
+  const { entityName, displayField, pluralName, confirmTitle, confirmMessage, confirmLabel, cancelLabel, headerIcon } = c;
+  return {
+    name: c.traitName,
+    linkedEntity: entityName,
+    category: "interaction",
+    ...c.emitOnConfirm ? { emits: [{ event: c.emitOnConfirm }] } : {},
+    stateMachine: {
+      states: [
+        { name: "idle", isInitial: true },
+        { name: "confirming" }
+      ],
+      events: [
+        { key: "INIT", name: "Initialize" },
+        { key: c.requestEvent, name: "Request Confirmation", payload: [{ name: "id", type: "string", required: true }] },
+        { key: c.confirmEvent, name: "Confirm" },
+        { key: "CANCEL", name: "Cancel" },
+        { key: "CLOSE", name: "Close" }
+      ],
+      transitions: [
+        // INIT: idle -> idle
+        {
+          from: "idle",
+          to: "idle",
+          event: "INIT",
+          effects: c.standalone ? [["fetch", entityName], ["render-ui", "main", {
+            type: "stack",
+            direction: "vertical",
+            gap: "lg",
+            children: [
+              { type: "stack", direction: "horizontal", gap: "md", align: "center", children: [
+                { type: "icon", name: headerIcon, size: "lg" },
+                { type: "typography", content: pluralName, variant: "h2" }
+              ] },
+              { type: "divider" },
+              {
+                type: "data-grid",
+                entity: entityName,
+                emptyIcon: "inbox",
+                emptyTitle: `No ${pluralName.toLowerCase()} yet`,
+                emptyDescription: "Items will appear here.",
+                itemActions: [{ label: confirmTitle, event: c.requestEvent, variant: "danger" }],
+                children: [{ type: "stack", direction: "vertical", gap: "sm", children: [
+                  { type: "typography", variant: "h4", content: `@entity.${displayField}` }
+                ] }]
+              }
+            ]
+          }]] : [["fetch", entityName]]
+        },
+        // REQUEST: idle -> confirming (fetch entity by ID so server has context)
+        {
+          from: "idle",
+          to: "confirming",
+          event: c.requestEvent,
+          effects: [
+            ["set", "@entity.pendingId", "@payload.id"],
+            ["fetch", entityName, "@payload.id"],
+            ["render-ui", "modal", {
+              type: "stack",
+              direction: "vertical",
+              gap: "md",
+              children: [
+                {
+                  type: "stack",
+                  direction: "horizontal",
+                  gap: "sm",
+                  align: "center",
+                  children: [
+                    { type: "icon", name: headerIcon, size: "md" },
+                    { type: "typography", content: confirmTitle, variant: "h3" }
+                  ]
+                },
+                { type: "divider" },
+                { type: "typography", content: confirmMessage, variant: "body" },
+                {
+                  type: "stack",
+                  direction: "horizontal",
+                  gap: "sm",
+                  justify: "end",
+                  children: [
+                    { type: "button", label: cancelLabel, event: "CANCEL", variant: "ghost" },
+                    { type: "button", label: confirmLabel, event: c.confirmEvent, variant: "danger", icon: "check" }
+                  ]
+                }
+              ]
+            }]
+          ]
+        },
+        // CONFIRM: confirming -> idle (run injected effects, dismiss modal)
+        {
+          from: "confirming",
+          to: "idle",
+          event: c.confirmEvent,
+          effects: [
+            ...c.confirmEffects,
+            ["render-ui", "modal", null],
+            ...c.emitOnConfirm ? [["emit", c.emitOnConfirm]] : []
+          ]
+        },
+        // CANCEL: confirming -> idle (dismiss modal)
+        {
+          from: "confirming",
+          to: "idle",
+          event: "CANCEL",
+          effects: [
+            ["render-ui", "modal", null]
+          ]
+        },
+        // CLOSE: confirming -> idle (dismiss modal)
+        {
+          from: "confirming",
+          to: "idle",
+          event: "CLOSE",
+          effects: [
+            ["render-ui", "modal", null]
+          ]
+        }
+      ]
+    }
+  };
+}
+function buildPage3(c) {
+  return makePage({ name: c.pageName, path: c.pagePath, traitName: c.traitName, isInitial: c.isInitial });
+}
+function stdConfirmationEntity(params) {
+  return buildEntity3(resolve6(params));
+}
+function stdConfirmationTrait(params) {
+  return buildTrait3(resolve6(params));
+}
+function stdConfirmationPage(params) {
+  return buildPage3(resolve6(params));
+}
+function stdConfirmation(params) {
+  const c = resolve6(params);
+  return makeOrbital(
+    `${c.entityName}Orbital`,
+    buildEntity3(c),
+    [buildTrait3(c)],
+    [buildPage3(c)]
+  );
+}
+
+// behaviors/functions/std-inventory.ts
 function resolve7(params) {
   const { entityName } = params;
   const fields = ensureIdField(params.fields);