@almadar/std 3.4.3 → 3.5.0

package/dist/index.js

@@ -3824,7 +3824,19 @@ function buildDisplayPattern(c, entityName, emptyTitle, emptyDescription, defaul
   return { ...base, ...c.displayProps };
 }
 function buildEntity(c) {
-  return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence, collection: c.collection });
+  const instances = [
+    { id: "bi-1", name: "Terry Schultz", description: "Senior product designer with 8 years of experience", status: "active", createdAt: "2026-01-15" },
+    { id: "bi-2", name: "Dale Franey", description: "Full-stack developer specializing in React and Node.js", status: "active", createdAt: "2026-01-18" },
+    { id: "bi-3", name: "Lorena Mayer", description: "Data analyst focused on business intelligence", status: "pending", createdAt: "2026-01-20" },
+    { id: "bi-4", name: "Andrea Paucek", description: "Project manager with PMP certification", status: "active", createdAt: "2026-02-01" },
+    { id: "bi-5", name: "Geneva Durgan", description: "UX researcher conducting user interviews", status: "inactive", createdAt: "2026-02-05" },
+    { id: "bi-6", name: "Samantha Okuneva", description: "DevOps engineer managing cloud infrastructure", status: "active", createdAt: "2026-02-10" },
+    { id: "bi-7", name: "Nelson Halby", description: "Technical writer documenting APIs", status: "active", createdAt: "2026-02-15" },
+    { id: "bi-8", name: "Tanya Hand", description: "QA lead overseeing test automation", status: "pending", createdAt: "2026-02-20" },
+    { id: "bi-9", name: "Rosemary Lind", description: "Marketing analyst tracking campaign performance", status: "active", createdAt: "2026-03-01" },
+    { id: "bi-10", name: "Bernadette Anderson", description: "Security engineer conducting penetration tests", status: "active", createdAt: "2026-03-05" }
+  ];
+  return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence, collection: c.collection, instances });
 }
 function buildTrait(c) {
   const { entityName, listFields, headerIcon, pageTitle, emptyTitle, emptyDescription } = c;
@@ -3946,7 +3958,7 @@ function buildTrait(c) {
           to: "browsing",
           event: "INIT",
           effects: [
-            ["fetch", entityName],
+            ["ref", entityName],
             ["render-ui", "main", {
               type: "stack",
               direction: "vertical",
@@ -3974,7 +3986,7 @@ function buildTrait(c) {
           from: "browsing",
           to: "browsing",
           event: evt,
-          effects: [["fetch", entityName]]
+          effects: [["ref", entityName]]
         }))
       ]
     }
@@ -4073,7 +4085,7 @@ function buildTrait2(c) {
       from: "closed",
       to: "closed",
       event: "INIT",
-      effects: c.standalone ? [["fetch", c.entityName], ["render-ui", "main", {
+      effects: c.standalone ? [["ref", c.entityName], ["render-ui", "main", {
         type: "stack",
         direction: "vertical",
         gap: "lg",
@@ -4088,7 +4100,7 @@ function buildTrait2(c) {
           { type: "divider" },
           { type: "empty-state", icon: c.headerIcon, title: "Nothing open", description: "Click Open to view details in a modal overlay." }
         ]
-      }]] : [["fetch", c.entityName]]
+      }]] : [["ref", c.entityName]]
     },
     // OPEN: closed → open (Modal component in CompiledPortal provides backdrop)
     {
@@ -4101,7 +4113,7 @@ function buildTrait2(c) {
     { from: "open", to: "closed", event: c.closeEvent, effects: [
       ["render-ui", "modal", null],
       ["notify", "Cancelled", "info"],
-      ...c.standalone ? [["fetch", c.entityName], ["render-ui", "main", {
+      ...c.standalone ? [["ref", c.entityName], ["render-ui", "main", {
         type: "stack",
         direction: "vertical",
         gap: "lg",
@@ -4254,7 +4266,7 @@ function buildTrait3(c) {
   };
   const dismissAndRefresh = [
     ["render-ui", "modal", null],
-    ...c.standalone ? [["fetch", entityName], ["render-ui", "main", idleMainView]] : [["fetch", entityName]]
+    ...c.standalone ? [["ref", entityName], ["render-ui", "main", idleMainView]] : [["ref", entityName]]
   ];
   return {
     name: c.traitName,
@@ -4278,7 +4290,7 @@ function buildTrait3(c) {
           from: "idle",
           to: "idle",
           event: "INIT",
-          effects: c.standalone ? [["fetch", entityName], ["render-ui", "main", idleMainView]] : [["fetch", entityName]]
+          effects: c.standalone ? [["ref", entityName], ["render-ui", "main", idleMainView]] : [["ref", entityName]]
         },
         {
           from: "idle",
@@ -8452,7 +8464,10 @@ function buildEntity23(c) {
     { name: "successCount", type: "number", default: 0 },
     { name: "threshold", type: "number", default: 5 }
   ];
-  return makeEntity({ name: c.entityName, fields, persistence: c.persistence, collection: c.collection });
+  const instances = [
+    { id: "sn-1", name: "ServiceNode", description: "Primary API gateway", status: "active", createdAt: "2026-01-10", failureCount: 783, successCount: 603, threshold: 5 }
+  ];
+  return makeEntity({ name: c.entityName, fields, persistence: c.persistence, collection: c.collection, instances });
 }
 var ef9 = (field) => ["object/get", ["array/first", "@entity"], field];
 function buildTrait24(c) {
@@ -11247,7 +11262,24 @@ function resolve44(params) {
   };
 }
 function buildEntity42(c) {
-  return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
+  const fields = [
+    ...c.fields.filter((f) => !["type", "message", "timestamp", "actorName", "targetName", "value", "turn"].includes(f.name)),
+    { name: "type", type: "string", default: "attack", values: ["attack", "defend", "heal", "move", "special", "death", "spawn"] },
+    { name: "message", type: "string" },
+    { name: "timestamp", type: "number", default: 0 },
+    { name: "actorName", type: "string" },
+    { name: "targetName", type: "string" },
+    { name: "value", type: "number", default: 0 },
+    { name: "turn", type: "number", default: 1 }
+  ];
+  const instances = [
+    { id: "cl-1", name: "Attack log", description: "Warrior attacks Goblin", status: "active", createdAt: "2026-01-01", type: "attack", message: "Warrior strikes Goblin for 25 damage", timestamp: 1e3, actorName: "Warrior", targetName: "Goblin", value: 25, turn: 1 },
+    { id: "cl-2", name: "Defend log", description: "Paladin raises shield", status: "active", createdAt: "2026-01-01", type: "defend", message: "Paladin raises shield, blocking 15 damage", timestamp: 2e3, actorName: "Paladin", targetName: "Paladin", value: 15, turn: 1 },
+    { id: "cl-3", name: "Heal log", description: "Cleric heals Warrior", status: "active", createdAt: "2026-01-01", type: "heal", message: "Cleric heals Warrior for 30 HP", timestamp: 3e3, actorName: "Cleric", targetName: "Warrior", value: 30, turn: 2 },
+    { id: "cl-4", name: "Special log", description: "Mage casts fireball", status: "active", createdAt: "2026-01-01", type: "special", message: "Mage casts Fireball dealing 40 AoE damage", timestamp: 4e3, actorName: "Mage", targetName: "Goblin", value: 40, turn: 2 },
+    { id: "cl-5", name: "Move log", description: "Rogue moves to flank", status: "active", createdAt: "2026-01-01", type: "move", message: "Rogue moves to flanking position", timestamp: 5e3, actorName: "Rogue", value: 0, turn: 3 }
+  ];
+  return makeEntity({ name: c.entityName, fields, persistence: c.persistence, instances });
 }
 function buildTrait43(c) {
   const { entityName, title, maxVisible, autoScroll, showTimestamps } = c;
@@ -11954,15 +11986,38 @@ function resolve51(params) {
   };
 }
 function buildEntity49(c) {
-  return makeEntity({ name: c.entityName, fields: c.fields, persistence: c.persistence });
+  const fields = [
+    ...c.fields.filter((f) => !["tiles", "units", "features"].includes(f.name)),
+    { name: "tiles", type: "array", default: [] },
+    { name: "units", type: "array", default: [] },
+    { name: "features", type: "array", default: [] }
+  ];
+  const instances = [
+    {
+      id: "scene-1",
+      name: "Battle Arena",
+      description: "A 3D battle arena",
+      status: "active",
+      createdAt: "2026-01-01",
+      tiles: [
+        { x: 0, y: 0, z: 0, type: "grass" },
+        { x: 1, y: 0, z: 0, type: "grass" },
+        { x: 0, y: 0, z: 1, type: "stone" },
+        { x: 1, y: 0, z: 1, type: "water" }
+      ],
+      units: [],
+      features: []
+    }
+  ];
+  return makeEntity({ name: c.entityName, fields, persistence: c.persistence, instances });
 }
 function buildTrait50(c) {
   const { entityName, orientation, cameraMode, showGrid, shadows, backgroundColor } = c;
   const canvasView = {
     type: "game-canvas3-d",
-    tiles: `@${entityName}`,
-    units: `@${entityName}`,
-    features: `@${entityName}`,
+    tiles: ["object/get", ["array/first", `@${entityName}`], "tiles"],
+    units: ["object/get", ["array/first", `@${entityName}`], "units"],
+    features: ["object/get", ["array/first", `@${entityName}`], "features"],
     orientation,
     cameraMode,
     showGrid,
@@ -12150,7 +12205,7 @@ function stdList(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName]],
     saveEvent: "SAVE",
-    saveEffects: [["persist", "create", entityName, "@payload.data"], ["fetch", entityName]],
+    saveEffects: [["persist", "create", entityName, "@payload.data"]],
     emitOnSave: CREATED
   }));
   const editTrait = extractTrait(stdModal({
@@ -12166,7 +12221,7 @@ 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"]],
     emitOnSave: UPDATED
   }));
   const viewTrait = extractTrait(stdModal({
@@ -12219,7 +12274,6 @@ function stdList(params) {
     { from: "deleting", to: "browsing", event: "CONFIRM_DELETE", effects: [
       ["persist", "delete", entityName, "@entity.id"],
       ["render-ui", "modal", null],
-      ["fetch", entityName],
       ["render-ui", "main", browseMainView]
     ] },
     // CANCEL/CLOSE from deleting (dismiss modal, re-render main)
@@ -12314,7 +12368,6 @@ function buildCartTrait(c) {
     name: `${entityName}CartBrowse`,
     linkedEntity: entityName,
     category: "interaction",
-    listens: [{ event: "CONFIRM_REMOVE", triggers: "CONFIRM_REMOVE" }],
     stateMachine: {
       states: [
         { name: "browsing", isInitial: true },
@@ -12323,9 +12376,7 @@ function buildCartTrait(c) {
       events: [
         { key: "INIT", name: "Initialize" },
         { key: "ADD_ITEM", name: "Add Item" },
-        { key: "SAVE", name: "Save", payload: [{ name: "data", type: "object", required: true }] },
         { key: "REQUEST_REMOVE", name: "Request Remove", payload: [{ name: "id", type: "string", required: true }] },
-        { key: "CONFIRM_REMOVE", name: "Confirm Remove", payload: [{ name: "data", type: "object", required: true }] },
         { key: "PROCEED_CHECKOUT", name: "Proceed to Checkout" },
         { key: "BACK_TO_CART", name: "Back to Cart" },
         { key: "CONFIRM_ORDER", name: "Confirm Order" }
@@ -12333,7 +12384,7 @@ function buildCartTrait(c) {
       transitions: [
         // browsing + INIT (data-grid handles empty vs populated automatically)
         { from: "browsing", to: "browsing", event: "INIT", effects: [
-          ["fetch", entityName],
+          ["ref", entityName],
           ["render-ui", "main", { type: "stack", direction: "vertical", gap: "lg", children: [
             headerBar,
             { type: "divider" },
@@ -12352,13 +12403,9 @@ function buildCartTrait(c) {
             { type: "button", label: checkoutButtonLabel, event: "PROCEED_CHECKOUT", variant: "primary", icon: "arrow-right" }
           ] }]
         ] },
-        // SAVE: re-fetch after modal adds an item (shared event bus)
-        { from: "browsing", to: "browsing", event: "SAVE", effects: [["fetch", entityName]] },
-        // CONFIRM_REMOVE: re-fetch after confirmation trait deletes item
-        { from: "browsing", to: "browsing", event: "CONFIRM_REMOVE", effects: [["fetch", entityName]] },
         // PROCEED_CHECKOUT
         { from: "browsing", to: "checkout", event: "PROCEED_CHECKOUT", effects: [
-          ["fetch", entityName],
+          ["ref", entityName],
           ["render-ui", "main", { type: "stack", direction: "vertical", gap: "lg", children: [
             { type: "stack", direction: "horizontal", gap: "sm", children: [
               { type: "icon", name: "clipboard", size: "lg" },
@@ -12373,10 +12420,10 @@ function buildCartTrait(c) {
           ] }]
         ] },
         // BACK_TO_CART
-        { from: "checkout", to: "browsing", event: "BACK_TO_CART", effects: [["fetch", entityName]] },
+        { from: "checkout", to: "browsing", event: "BACK_TO_CART", effects: [["ref", entityName]] },
         // CONFIRM_ORDER
         { from: "checkout", to: "browsing", event: "CONFIRM_ORDER", effects: [
-          ["fetch", entityName],
+          ["ref", entityName],
           ["render-ui", "main", { type: "stack", direction: "vertical", gap: "lg", align: "center", children: [
             { type: "icon", name: "check-circle", size: "lg" },
             { type: "typography", content: "Order Confirmed", variant: "h2" },
@@ -12432,7 +12479,7 @@ function stdCart(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName]],
     saveEvent: "SAVE",
-    saveEffects: [["persist", "create", entityName, "@payload.data"], ["fetch", entityName]]
+    saveEffects: [["persist", "create", entityName, "@payload.data"]]
   }));
   const removeTrait = extractTrait(stdConfirmation({
     standalone: false,
@@ -12445,8 +12492,7 @@ function stdCart(params) {
     headerIcon: "trash-2",
     requestEvent: "REQUEST_REMOVE",
     confirmEvent: "CONFIRM_REMOVE",
-    confirmEffects: [["persist", "delete", entityName, "@payload.id"], ["fetch", entityName]],
-    emitOnConfirm: "CONFIRM_REMOVE"
+    confirmEffects: [["persist", "delete", entityName, "@payload.id"]]
   }));
   const removeSm = removeTrait.stateMachine;
   if (removeSm && "events" in removeSm) {
@@ -12556,7 +12602,7 @@ function stdDetail(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName]],
     saveEvent: "SAVE",
-    saveEffects: [["persist", "create", entityName, "@payload.data"], ["fetch", entityName]],
+    saveEffects: [["persist", "create", entityName, "@payload.data"]],
     emitOnSave: "SAVE"
   }));
   const viewTrait = extractTrait(stdModal({
@@ -12723,7 +12769,7 @@ function stdInventory(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName]],
     saveEvent: "SAVE",
-    saveEffects: [["persist", "create", entityName, "@payload.data"], ["fetch", entityName]],
+    saveEffects: [["persist", "create", entityName, "@payload.data"]],
     emitOnSave: "ITEM_ADDED"
   }));
   const useTrait = extractTrait(stdModal({
@@ -12739,7 +12785,7 @@ function stdInventory(params) {
     closeEvent: "CLOSE",
     openEffects: [["fetch", entityName, "@payload.id"]],
     saveEvent: "SAVE",
-    saveEffects: [["persist", "update", entityName, "@payload.data"], ["fetch", entityName]],
+    saveEffects: [["persist", "update", entityName, "@payload.data"]],
     emitOnSave: "ITEM_USED"
   }));
   const dropTrait = extractTrait(stdConfirmation({
@@ -12753,7 +12799,7 @@ function stdInventory(params) {
     headerIcon: "trash-2",
     requestEvent: "DROP",
     confirmEvent: "CONFIRM_DROP",
-    confirmEffects: [["persist", "delete", entityName, "@payload.id"], ["fetch", entityName]],
+    confirmEffects: [["persist", "delete", entityName, "@payload.id"]],
     emitOnConfirm: "CONFIRM_DROP"
   }));
   const dropSm = dropTrait.stateMachine;
@@ -12909,7 +12955,7 @@ function stdMessaging(params) {
     openEvent: "COMPOSE",
     closeEvent: "CLOSE",
     saveEvent: "SEND",
-    saveEffects: [["persist", "create", entityName, "@payload.data"], ["fetch", entityName]],
+    saveEffects: [["persist", "create", entityName, "@payload.data"]],
     emitOnSave: "SEND"
   }));
   const viewTrait = extractTrait(stdModal({