@almadar/std 2.1.0 → 2.4.1

package/dist/behaviors/domain/finance.js

@@ -0,0 +1,660 @@
+// behaviors/domain/finance.ts
+var FINANCE_THEME = {
+  name: "finance-emerald",
+  tokens: {
+    colors: {
+      primary: "#059669",
+      "primary-hover": "#047857",
+      "primary-foreground": "#ffffff",
+      accent: "#10b981",
+      "accent-foreground": "#ffffff",
+      success: "#22c55e",
+      warning: "#f59e0b",
+      error: "#ef4444"
+    }
+  }
+};
+var ledgerMainEffects = [
+  ["fetch", "LedgerEntry"],
+  ["render-ui", "main", { type: "stack", direction: "vertical", gap: "lg", children: [
+    // Header zone: landmark icon + title + new entry button
+    { type: "stack", direction: "horizontal", justify: "space-between", children: [
+      { type: "stack", direction: "horizontal", gap: "sm", children: [
+        { type: "icon", name: "landmark", size: "lg" },
+        { type: "typography", variant: "h2", content: "Ledger" }
+      ] },
+      { type: "button", label: "New Entry", icon: "plus", variant: "primary", action: "NEW_ENTRY" }
+    ] },
+    { type: "divider" },
+    // Stats zone: debit total, credit total, balance
+    { type: "stack", direction: "horizontal", gap: "md", children: [
+      { type: "stats", label: "Total Debit", icon: "trending-down", entity: "LedgerEntry" },
+      { type: "stats", label: "Total Credit", icon: "trending-up", entity: "LedgerEntry" },
+      { type: "stats", label: "Balance", icon: "wallet", entity: "LedgerEntry" }
+    ] },
+    // Balance trend chart
+    { type: "line-chart", entity: "LedgerEntry" },
+    { type: "divider" },
+    // Data zone: ledger entries as card list
+    {
+      type: "data-list",
+      entity: "LedgerEntry",
+      variant: "card",
+      fields: [
+        { name: "description", label: "Description", icon: "file-text", variant: "h4" },
+        { name: "date", label: "Date", icon: "calendar", variant: "caption", format: "date" },
+        { name: "debit", label: "Debit", icon: "trending-down", variant: "body", format: "currency" },
+        { name: "credit", label: "Credit", icon: "trending-up", variant: "body", format: "currency" },
+        { name: "balance", label: "Balance", icon: "wallet", variant: "body", format: "currency" }
+      ],
+      itemActions: [
+        { label: "View", event: "VIEW", icon: "eye" }
+      ]
+    }
+  ] }]
+];
+var transactionMainEffects = [
+  ["fetch", "Transaction"],
+  ["render-ui", "main", { type: "stack", direction: "vertical", gap: "lg", children: [
+    // Header zone: receipt icon + title + new button + search
+    { type: "stack", direction: "horizontal", justify: "space-between", children: [
+      { type: "stack", direction: "horizontal", gap: "sm", children: [
+        { type: "icon", name: "receipt", size: "lg" },
+        { type: "typography", variant: "h2", content: "Transactions" }
+      ] },
+      { type: "stack", direction: "horizontal", gap: "sm", children: [
+        { type: "search-input", placeholder: "Search transactions...", entity: "Transaction" },
+        { type: "button", label: "New", icon: "plus", variant: "primary", action: "CREATE" }
+      ] }
+    ] },
+    { type: "divider" },
+    // Stats row + line chart
+    { type: "stack", direction: "horizontal", gap: "md", children: [
+      { type: "stats", label: "Total Amount", icon: "dollar-sign", entity: "Transaction" },
+      { type: "stats", label: "Transactions", icon: "hash", entity: "Transaction" },
+      { type: "stats", label: "Avg Amount", icon: "bar-chart-2", entity: "Transaction" }
+    ] },
+    { type: "line-chart", entity: "Transaction" },
+    { type: "divider" },
+    // Data zone: transaction list with badges
+    {
+      type: "data-list",
+      entity: "Transaction",
+      variant: "card",
+      fields: [
+        { name: "amount", label: "Amount", icon: "dollar-sign", variant: "h4", format: "currency" },
+        { name: "type", label: "Type", icon: "tag", variant: "badge" },
+        { name: "category", label: "Category", icon: "folder", variant: "body" },
+        { name: "date", label: "Date", icon: "calendar", variant: "caption", format: "date" },
+        { name: "status", label: "Status", icon: "circle-dot", variant: "badge" }
+      ],
+      itemActions: [
+        { label: "View", event: "VIEW", icon: "eye" }
+      ]
+    }
+  ] }]
+];
+var portfolioMainEffects = [
+  ["fetch", "Holding"],
+  ["render-ui", "main", { type: "stack", direction: "vertical", gap: "lg", children: [
+    // Header zone: trending-up icon + title
+    { type: "stack", direction: "horizontal", justify: "space-between", children: [
+      { type: "stack", direction: "horizontal", gap: "sm", children: [
+        { type: "icon", name: "trending-up", size: "lg" },
+        { type: "typography", variant: "h2", content: "Portfolio" }
+      ] }
+    ] },
+    { type: "divider" },
+    // Stats zone: total holdings, total value
+    { type: "stack", direction: "horizontal", gap: "md", children: [
+      { type: "stats", label: "Total Holdings", icon: "coins", entity: "Holding" },
+      { type: "stats", label: "Total Value", icon: "dollar-sign", entity: "Holding" }
+    ] },
+    // Performance chart
+    { type: "line-chart", entity: "Holding" },
+    { type: "divider" },
+    // Data zone: holdings in a 3-column grid
+    {
+      type: "data-grid",
+      entity: "Holding",
+      cols: 3,
+      gap: "md",
+      fields: [
+        { name: "symbol", label: "Symbol", icon: "coins", variant: "h4" },
+        { name: "shares", label: "Shares", icon: "layers", variant: "body", format: "number" },
+        { name: "purchasePrice", label: "Purchase Price", icon: "credit-card", variant: "body", format: "currency" },
+        { name: "currentPrice", label: "Current Price", icon: "dollar-sign", variant: "body", format: "currency" }
+      ],
+      itemActions: [
+        { label: "View", event: "VIEW", icon: "eye" }
+      ]
+    }
+  ] }]
+];
+var LEDGER_BEHAVIOR = {
+  name: "std-ledger",
+  version: "1.0.0",
+  description: "Financial ledger with debit and credit entries",
+  orbitals: [
+    {
+      name: "LedgerOrbital",
+      theme: FINANCE_THEME,
+      entity: {
+        name: "LedgerEntry",
+        persistence: "persistent",
+        collection: "ledger_entries",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "date", type: "string", default: "" },
+          { name: "description", type: "string", default: "" },
+          { name: "debit", type: "number", default: 0 },
+          { name: "credit", type: "number", default: 0 },
+          { name: "balance", type: "number", default: 0 }
+        ]
+      },
+      traits: [
+        {
+          name: "LedgerControl",
+          linkedEntity: "LedgerEntry",
+          category: "interaction",
+          stateMachine: {
+            states: [
+              { name: "browsing", isInitial: true },
+              { name: "creating" },
+              { name: "viewing" }
+            ],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "NEW_ENTRY", name: "New Entry" },
+              { key: "SAVE", name: "Save Entry", payloadSchema: [{ name: "description", type: "string", required: true }, { name: "debit", type: "number", required: true }, { name: "credit", type: "number", required: true }] },
+              { key: "VIEW", name: "View Entry", payloadSchema: [{ name: "id", type: "string", required: true }] },
+              { key: "CLOSE", name: "Close" },
+              { key: "CANCEL", name: "Cancel" }
+            ],
+            transitions: [
+              {
+                from: "browsing",
+                to: "browsing",
+                event: "INIT",
+                effects: [
+                  ...ledgerMainEffects
+                ]
+              },
+              {
+                from: "browsing",
+                to: "creating",
+                event: "NEW_ENTRY",
+                effects: [
+                  ["fetch", "LedgerEntry"],
+                  ["render-ui", "modal", { type: "stack", direction: "vertical", gap: "md", children: [
+                    { type: "stack", direction: "horizontal", gap: "sm", children: [
+                      { type: "icon", name: "plus-circle", size: "md" },
+                      { type: "typography", variant: "h3", content: "New Ledger Entry" }
+                    ] },
+                    { type: "divider" },
+                    {
+                      type: "form-section",
+                      entity: "LedgerEntry",
+                      submitEvent: "SAVE",
+                      cancelEvent: "CANCEL"
+                    }
+                  ] }]
+                ]
+              },
+              {
+                from: "creating",
+                to: "browsing",
+                event: "SAVE",
+                effects: [
+                  ["set", "@entity.description", "@payload.description"],
+                  ["set", "@entity.debit", "@payload.debit"],
+                  ["set", "@entity.credit", "@payload.credit"],
+                  ["render-ui", "modal", null],
+                  ...ledgerMainEffects
+                ]
+              },
+              {
+                from: "creating",
+                to: "browsing",
+                event: "CLOSE",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "creating",
+                to: "browsing",
+                event: "CANCEL",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "browsing",
+                to: "viewing",
+                event: "VIEW",
+                effects: [
+                  ["fetch", "LedgerEntry"],
+                  ["render-ui", "modal", { type: "stack", direction: "vertical", gap: "md", children: [
+                    // Header
+                    { type: "stack", direction: "horizontal", gap: "sm", children: [
+                      { type: "icon", name: "landmark", size: "md" },
+                      { type: "typography", variant: "h3", content: "Entry Detail" }
+                    ] },
+                    { type: "divider" },
+                    // Balance meter
+                    { type: "meter", value: "@entity.balance", label: "Current Balance", icon: "wallet" },
+                    // Detail fields
+                    { type: "stack", direction: "vertical", gap: "sm", children: [
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "file-text", size: "sm" },
+                        { type: "typography", variant: "label", content: "Description" },
+                        { type: "typography", variant: "body", content: "@entity.description" }
+                      ] },
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "calendar", size: "sm" },
+                        { type: "typography", variant: "label", content: "Date" },
+                        { type: "typography", variant: "body", content: "@entity.date" }
+                      ] },
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "trending-down", size: "sm" },
+                        { type: "typography", variant: "label", content: "Debit" },
+                        { type: "typography", variant: "body", content: "@entity.debit" }
+                      ] },
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "trending-up", size: "sm" },
+                        { type: "typography", variant: "label", content: "Credit" },
+                        { type: "typography", variant: "body", content: "@entity.credit" }
+                      ] }
+                    ] },
+                    { type: "divider" },
+                    // Close action
+                    { type: "stack", direction: "horizontal", justify: "flex-end", children: [
+                      { type: "button", label: "Close", icon: "x", variant: "secondary", action: "CLOSE" }
+                    ] }
+                  ] }]
+                ]
+              },
+              {
+                from: "viewing",
+                to: "browsing",
+                event: "CLOSE",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "viewing",
+                to: "browsing",
+                event: "CANCEL",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      pages: [
+        {
+          name: "LedgerPage",
+          path: "/ledger",
+          isInitial: true,
+          traits: [{ ref: "LedgerControl" }]
+        }
+      ]
+    }
+  ]
+};
+var TRANSACTION_BEHAVIOR = {
+  name: "std-transaction",
+  version: "1.0.0",
+  description: "Transaction tracking with categories and status",
+  orbitals: [
+    {
+      name: "TransactionOrbital",
+      theme: FINANCE_THEME,
+      entity: {
+        name: "Transaction",
+        persistence: "persistent",
+        collection: "transactions",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "amount", type: "number", default: 0 },
+          { name: "type", type: "string", default: "expense" },
+          { name: "category", type: "string", default: "" },
+          { name: "date", type: "string", default: "" },
+          { name: "status", type: "string", default: "pending" }
+        ]
+      },
+      traits: [
+        {
+          name: "TransactionControl",
+          linkedEntity: "Transaction",
+          category: "interaction",
+          stateMachine: {
+            states: [
+              { name: "browsing", isInitial: true },
+              { name: "viewing" },
+              { name: "creating" }
+            ],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "VIEW", name: "View Transaction", payloadSchema: [{ name: "id", type: "string", required: true }] },
+              { key: "CREATE", name: "New Transaction" },
+              { key: "SAVE", name: "Save Transaction", payloadSchema: [{ name: "amount", type: "number", required: true }, { name: "category", type: "string", required: true }] },
+              { key: "CLOSE", name: "Close" },
+              { key: "CANCEL", name: "Cancel" }
+            ],
+            transitions: [
+              {
+                from: "browsing",
+                to: "browsing",
+                event: "INIT",
+                effects: [
+                  ...transactionMainEffects
+                ]
+              },
+              {
+                from: "browsing",
+                to: "viewing",
+                event: "VIEW",
+                effects: [
+                  ["fetch", "Transaction"],
+                  ["render-ui", "modal", { type: "stack", direction: "vertical", gap: "md", children: [
+                    // Header
+                    { type: "stack", direction: "horizontal", gap: "sm", children: [
+                      { type: "icon", name: "receipt", size: "md" },
+                      { type: "typography", variant: "h3", content: "Transaction Detail" }
+                    ] },
+                    { type: "divider" },
+                    // Amount + type row
+                    { type: "stack", direction: "horizontal", justify: "space-between", children: [
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "dollar-sign", size: "md" },
+                        { type: "typography", variant: "h4", content: "@entity.amount" }
+                      ] },
+                      { type: "badge", content: "@entity.type", icon: "tag" }
+                    ] },
+                    // Detail fields
+                    { type: "stack", direction: "vertical", gap: "sm", children: [
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "folder", size: "sm" },
+                        { type: "typography", variant: "label", content: "Category" },
+                        { type: "typography", variant: "body", content: "@entity.category" }
+                      ] },
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "calendar", size: "sm" },
+                        { type: "typography", variant: "label", content: "Date" },
+                        { type: "typography", variant: "body", content: "@entity.date" }
+                      ] },
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "circle-dot", size: "sm" },
+                        { type: "typography", variant: "label", content: "Status" },
+                        { type: "badge", content: "@entity.status" }
+                      ] }
+                    ] },
+                    { type: "divider" },
+                    // Close action
+                    { type: "stack", direction: "horizontal", justify: "flex-end", children: [
+                      { type: "button", label: "Close", icon: "x", variant: "secondary", action: "CLOSE" }
+                    ] }
+                  ] }]
+                ]
+              },
+              {
+                from: "viewing",
+                to: "browsing",
+                event: "CLOSE",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "viewing",
+                to: "browsing",
+                event: "CANCEL",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "browsing",
+                to: "creating",
+                event: "CREATE",
+                effects: [
+                  ["fetch", "Transaction"],
+                  ["render-ui", "modal", { type: "stack", direction: "vertical", gap: "md", children: [
+                    { type: "stack", direction: "horizontal", gap: "sm", children: [
+                      { type: "icon", name: "plus-circle", size: "md" },
+                      { type: "typography", variant: "h3", content: "New Transaction" }
+                    ] },
+                    { type: "divider" },
+                    {
+                      type: "form-section",
+                      entity: "Transaction",
+                      submitEvent: "SAVE",
+                      cancelEvent: "CANCEL"
+                    }
+                  ] }]
+                ]
+              },
+              {
+                from: "creating",
+                to: "browsing",
+                event: "SAVE",
+                effects: [
+                  ["set", "@entity.amount", "@payload.amount"],
+                  ["set", "@entity.category", "@payload.category"],
+                  ["render-ui", "modal", null],
+                  ...transactionMainEffects
+                ]
+              },
+              {
+                from: "creating",
+                to: "browsing",
+                event: "CLOSE",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "creating",
+                to: "browsing",
+                event: "CANCEL",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      pages: [
+        {
+          name: "TransactionsPage",
+          path: "/transactions",
+          isInitial: true,
+          traits: [{ ref: "TransactionControl" }]
+        }
+      ]
+    }
+  ]
+};
+var PORTFOLIO_BEHAVIOR = {
+  name: "std-portfolio",
+  version: "1.0.0",
+  description: "Investment portfolio tracking with holdings",
+  orbitals: [
+    {
+      name: "PortfolioOrbital",
+      theme: FINANCE_THEME,
+      entity: {
+        name: "Holding",
+        persistence: "persistent",
+        collection: "holdings",
+        fields: [
+          { name: "id", type: "string", required: true },
+          { name: "symbol", type: "string", default: "" },
+          { name: "shares", type: "number", default: 0 },
+          { name: "purchasePrice", type: "number", default: 0 },
+          { name: "currentPrice", type: "number", default: 0 }
+        ]
+      },
+      traits: [
+        {
+          name: "PortfolioControl",
+          linkedEntity: "Holding",
+          category: "interaction",
+          stateMachine: {
+            states: [
+              { name: "browsing", isInitial: true },
+              { name: "viewing" },
+              { name: "trading" }
+            ],
+            events: [
+              { key: "INIT", name: "Initialize" },
+              { key: "VIEW", name: "View Holding", payloadSchema: [{ name: "id", type: "string", required: true }] },
+              { key: "TRADE", name: "Start Trade" },
+              { key: "EXECUTE", name: "Execute Trade", payloadSchema: [{ name: "shares", type: "number", required: true }] },
+              { key: "CLOSE", name: "Close" },
+              { key: "CANCEL", name: "Cancel" }
+            ],
+            transitions: [
+              {
+                from: "browsing",
+                to: "browsing",
+                event: "INIT",
+                effects: [
+                  ...portfolioMainEffects
+                ]
+              },
+              {
+                from: "browsing",
+                to: "viewing",
+                event: "VIEW",
+                effects: [
+                  ["fetch", "Holding"],
+                  ["render-ui", "modal", { type: "stack", direction: "vertical", gap: "md", children: [
+                    // Header
+                    { type: "stack", direction: "horizontal", gap: "sm", children: [
+                      { type: "icon", name: "coins", size: "md" },
+                      { type: "typography", variant: "h3", content: "Holding Detail" }
+                    ] },
+                    { type: "divider" },
+                    // Symbol + shares headline
+                    { type: "stack", direction: "horizontal", justify: "space-between", children: [
+                      { type: "typography", variant: "h4", content: "@entity.symbol" },
+                      { type: "badge", content: "@entity.shares", icon: "layers" }
+                    ] },
+                    // Price detail fields
+                    { type: "stack", direction: "vertical", gap: "sm", children: [
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "credit-card", size: "sm" },
+                        { type: "typography", variant: "label", content: "Purchase Price" },
+                        { type: "typography", variant: "body", content: "@entity.purchasePrice" }
+                      ] },
+                      { type: "stack", direction: "horizontal", gap: "sm", children: [
+                        { type: "icon", name: "dollar-sign", size: "sm" },
+                        { type: "typography", variant: "label", content: "Current Price" },
+                        { type: "typography", variant: "body", content: "@entity.currentPrice" }
+                      ] }
+                    ] },
+                    // Gain/loss meter
+                    { type: "meter", value: "@entity.currentPrice", label: "Gain / Loss", icon: "bar-chart-2" },
+                    { type: "divider" },
+                    // Actions: trade + close
+                    { type: "stack", direction: "horizontal", justify: "flex-end", gap: "sm", children: [
+                      { type: "button", label: "Trade", icon: "arrow-right-left", variant: "primary", action: "TRADE" },
+                      { type: "button", label: "Close", icon: "x", variant: "secondary", action: "CLOSE" }
+                    ] }
+                  ] }]
+                ]
+              },
+              {
+                from: "viewing",
+                to: "trading",
+                event: "TRADE",
+                effects: [
+                  ["fetch", "Holding"],
+                  ["render-ui", "modal", { type: "stack", direction: "vertical", gap: "md", children: [
+                    { type: "stack", direction: "horizontal", gap: "sm", children: [
+                      { type: "icon", name: "arrow-right-left", size: "md" },
+                      { type: "typography", variant: "h3", content: "Execute Trade" }
+                    ] },
+                    { type: "divider" },
+                    {
+                      type: "form-section",
+                      entity: "Holding",
+                      submitEvent: "EXECUTE",
+                      cancelEvent: "CANCEL"
+                    }
+                  ] }]
+                ]
+              },
+              {
+                from: "trading",
+                to: "browsing",
+                event: "EXECUTE",
+                effects: [
+                  ["set", "@entity.shares", "@payload.shares"],
+                  ["render-ui", "modal", null],
+                  ...portfolioMainEffects
+                ]
+              },
+              {
+                from: "viewing",
+                to: "browsing",
+                event: "CLOSE",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "viewing",
+                to: "browsing",
+                event: "CANCEL",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "trading",
+                to: "browsing",
+                event: "CLOSE",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              },
+              {
+                from: "trading",
+                to: "browsing",
+                event: "CANCEL",
+                effects: [
+                  ["render-ui", "modal", null]
+                ]
+              }
+            ]
+          }
+        }
+      ],
+      pages: [
+        {
+          name: "PortfolioPage",
+          path: "/portfolio",
+          isInitial: true,
+          traits: [{ ref: "PortfolioControl" }]
+        }
+      ]
+    }
+  ]
+};
+var FINANCE_BEHAVIORS = [
+  LEDGER_BEHAVIOR,
+  TRANSACTION_BEHAVIOR,
+  PORTFOLIO_BEHAVIOR
+];
+
+export { FINANCE_BEHAVIORS, LEDGER_BEHAVIOR, PORTFOLIO_BEHAVIOR, TRANSACTION_BEHAVIOR };
+//# sourceMappingURL=finance.js.map
+//# sourceMappingURL=finance.js.map