@almadar/std 13.12.0 → 13.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (23) hide show
  1. package/behaviors/registry/core/atoms/std-browse.orb +58 -42
  2. package/behaviors/registry/core/atoms/std-display.orb +3 -3
  3. package/behaviors/registry/core/atoms/std-filter.orb +9 -9
  4. package/behaviors/registry/core/atoms/std-graphs.orb +38 -38
  5. package/behaviors/registry/core/atoms/std-pagination.orb +17 -17
  6. package/behaviors/registry/core/atoms/std-search.orb +9 -9
  7. package/behaviors/registry/core/atoms/std-stats.orb +75 -75
  8. package/behaviors/registry/core/atoms/std-tabs.orb +22 -22
  9. package/behaviors/registry/core/molecules/std-dashboard.orb +51 -51
  10. package/behaviors/registry/core/molecules/std-stack-layout.orb +230 -0
  11. package/behaviors/registry/core/molecules/std-tabs-layout.orb +252 -0
  12. package/dist/behaviors/registry/core/atoms/std-browse.orb +58 -42
  13. package/dist/behaviors/registry/core/atoms/std-display.orb +3 -3
  14. package/dist/behaviors/registry/core/atoms/std-filter.orb +9 -9
  15. package/dist/behaviors/registry/core/atoms/std-graphs.orb +38 -38
  16. package/dist/behaviors/registry/core/atoms/std-pagination.orb +17 -17
  17. package/dist/behaviors/registry/core/atoms/std-search.orb +9 -9
  18. package/dist/behaviors/registry/core/atoms/std-stats.orb +75 -75
  19. package/dist/behaviors/registry/core/atoms/std-tabs.orb +22 -22
  20. package/dist/behaviors/registry/core/molecules/std-dashboard.orb +51 -51
  21. package/dist/behaviors/registry/core/molecules/std-stack-layout.orb +230 -0
  22. package/dist/behaviors/registry/core/molecules/std-tabs-layout.orb +252 -0
  23. package/package.json +1 -1
package/behaviors/registry/core/atoms/std-stats.orb CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "std-stats",
3
3
  "version": "2.0.0",
4
- "description": "std-stats — embeddable analytics-card atom. Drop into a dashboard\nmolecule alongside std-browse / std-search / std-filter; wire its\nITEMS_LOADED listener to the upstream collection's success emit, then\nconfigure `metrics` per call-site to declare WHICH aggregations to\nshow.\n\nAggregation runs in the lolo state machine (no custom React component\nbeyond stat-display): the ITEMS_LOADED transition uses array/map over\n@config.metrics, applies the per-metric `filter` predicate to\n@payload.data, then dispatches the chosen aggregation kind. Cards\ndrop into a data-list whose renderItem maps each card to a\nstat-display pattern. The atom owns an auxiliary entity (StatsItem)\nfor UI state — explicit-binding rule applies: every @entity.X is set\nexplicitly via (set @entity.X ...) on each transition.\n\nEach entry in `metrics` (all but `label` optional):\n- label string! card title\n- aggregation count|sum|avg|min|max default count what to compute\n- field string numeric entity field for sum/avg/min/max\n- filter SExpression row predicate (e.g. fn-form testing @row.status). Drops non-matching\n rows BEFORE aggregation. Omitted = all rows. Compiler statically\n unrolls array/map over @config.metrics so the fn-form is fully\n specialized into pure TS at codegen time.\n- format number|currency|percent default number value formatting\n- variant default|primary|success|warning|error|info color\n- icon string lucide icon name\n- prefix string prepended to displayed value (e.g. \"≈ \")\n- suffix string appended (e.g. \" /mo\", \" ms\")\n- max number optional denominator. >0 renders \"value / max\".\n- target number optional progress target. >0 renders a progress bar.\n- trend number signed delta vs previous period. >0 ↑ green, <0 ↓ red.\n\nFor dynamic max/target/trend (computed against @payload.data),\nschema authors today must precompute and pass literal numbers; an\nSExpression-evaluating slot is a future extension.",
4
+ "description": "std-stats — embeddable analytics-card atom. ITEMS_LOADED aggregates @payload.data per @config.metrics (count|sum|avg|min|max with optional filter, format, icon, max, target, trend) and renders one stat-display per entry. Drop into a dashboard alongside std-browse / std-search / std-filter.",
5
5
  "orbitals": [
6
6
  {
7
7
  "name": "StatsItemOrbital",
@@ -21,35 +21,6 @@
21
21
  "items": {
22
22
  "type": "object",
23
23
  "properties": {
24
- "format": {
25
- "name": "format",
26
- "type": "string",
27
- "values": [
28
- "number",
29
- "currency",
30
- "percent"
31
- ]
32
- },
33
- "value": {
34
- "name": "value",
35
- "type": "number"
36
- },
37
- "suffix": {
38
- "name": "suffix",
39
- "type": "string"
40
- },
41
- "prefix": {
42
- "name": "prefix",
43
- "type": "string"
44
- },
45
- "trend": {
46
- "name": "trend",
47
- "type": "number"
48
- },
49
- "max": {
50
- "name": "max",
51
- "type": "number"
52
- },
53
24
  "label": {
54
25
  "name": "label",
55
26
  "type": "string"
@@ -70,9 +41,38 @@
70
41
  "info"
71
42
  ]
72
43
  },
44
+ "trend": {
45
+ "name": "trend",
46
+ "type": "number"
47
+ },
48
+ "suffix": {
49
+ "name": "suffix",
50
+ "type": "string"
51
+ },
52
+ "max": {
53
+ "name": "max",
54
+ "type": "number"
55
+ },
73
56
  "target": {
74
57
  "name": "target",
75
58
  "type": "number"
59
+ },
60
+ "value": {
61
+ "name": "value",
62
+ "type": "number"
63
+ },
64
+ "format": {
65
+ "name": "format",
66
+ "type": "string",
67
+ "values": [
68
+ "number",
69
+ "currency",
70
+ "percent"
71
+ ]
72
+ },
73
+ "prefix": {
74
+ "name": "prefix",
75
+ "type": "string"
76
76
  }
77
77
  }
78
78
  }
@@ -126,22 +126,22 @@
126
126
  "render-ui",
127
127
  "main",
128
128
  {
129
- "entity": "@entity.cards",
130
- "type": "data-grid",
131
- "fields": [],
132
129
  "renderItem": [
133
130
  "fn",
134
131
  "card",
135
132
  {
136
- "label": "@card.label",
137
- "format": "@card.format",
138
- "variant": "@card.variant",
139
- "max": "@card.max",
140
133
  "type": "stat-display",
141
134
  "value": "@card.value",
142
- "icon": "@card.icon"
135
+ "label": "@card.label",
136
+ "max": "@card.max",
137
+ "icon": "@card.icon",
138
+ "variant": "@card.variant",
139
+ "format": "@card.format"
143
140
  }
144
- ]
141
+ ],
142
+ "entity": "@entity.cards",
143
+ "fields": [],
144
+ "type": "data-grid"
145
145
  }
146
146
  ]
147
147
  ]
@@ -161,23 +161,10 @@
161
161
  "fn",
162
162
  "metric",
163
163
  {
164
- "format": [
165
- "object/get",
166
- "@metric",
167
- "format",
168
- "number"
169
- ],
170
- "variant": [
171
- "object/get",
172
- "@metric",
173
- "variant",
174
- "default"
175
- ],
176
- "target": [
164
+ "label": [
177
165
  "object/get",
178
166
  "@metric",
179
- "target",
180
- 0.0
167
+ "label"
181
168
  ],
182
169
  "max": [
183
170
  "object/get",
@@ -191,17 +178,17 @@
191
178
  "trend",
192
179
  0.0
193
180
  ],
194
- "icon": [
181
+ "prefix": [
195
182
  "object/get",
196
183
  "@metric",
197
- "icon",
184
+ "prefix",
198
185
  ""
199
186
  ],
200
- "prefix": [
187
+ "format": [
201
188
  "object/get",
202
189
  "@metric",
203
- "prefix",
204
- ""
190
+ "format",
191
+ "number"
205
192
  ],
206
193
  "suffix": [
207
194
  "object/get",
@@ -209,10 +196,23 @@
209
196
  "suffix",
210
197
  ""
211
198
  ],
212
- "label": [
199
+ "variant": [
213
200
  "object/get",
214
201
  "@metric",
215
- "label"
202
+ "variant",
203
+ "default"
204
+ ],
205
+ "icon": [
206
+ "object/get",
207
+ "@metric",
208
+ "icon",
209
+ ""
210
+ ],
211
+ "target": [
212
+ "object/get",
213
+ "@metric",
214
+ "target",
215
+ 0.0
216
216
  ],
217
217
  "value": [
218
218
  "if",
@@ -363,26 +363,26 @@
363
363
  "render-ui",
364
364
  "main",
365
365
  {
366
+ "fields": [],
367
+ "type": "data-list",
368
+ "entity": "@entity.cards",
366
369
  "renderItem": [
367
370
  "fn",
368
371
  "card",
369
372
  {
370
- "max": "@card.max",
371
- "label": "@card.label",
372
- "prefix": "@card.prefix",
373
+ "suffix": "@card.suffix",
373
374
  "type": "stat-display",
374
375
  "target": "@card.target",
376
+ "trend": "@card.trend",
377
+ "variant": "@card.variant",
375
378
  "icon": "@card.icon",
376
379
  "format": "@card.format",
380
+ "max": "@card.max",
381
+ "label": "@card.label",
377
382
  "value": "@card.value",
378
- "trend": "@card.trend",
379
- "variant": "@card.variant",
380
- "suffix": "@card.suffix"
383
+ "prefix": "@card.prefix"
381
384
  }
382
- ],
383
- "entity": "@entity.cards",
384
- "fields": [],
385
- "type": "data-list"
385
+ ]
386
386
  }
387
387
  ]
388
388
  ]
@@ -390,13 +390,13 @@
390
390
  ]
391
391
  },
392
392
  "config": {
393
- "title": {
394
- "type": "string",
395
- "default": ""
396
- },
397
393
  "metrics": {
398
394
  "type": "[object]",
399
395
  "default": []
396
+ },
397
+ "title": {
398
+ "type": "string",
399
+ "default": ""
400
400
  }
401
401
  },
402
402
  "scope": "instance"
package/behaviors/registry/core/atoms/std-tabs.orb CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "std-tabs",
3
3
  "version": "2.0.0",
4
- "description": "std-tabs — embeddable tab-navigation atom. Drop into a layout\nmolecule to give the user a tabs strip that swaps which trait fills\nthe active tab's slot. Each tab points at a sibling trait via a\n@trait.X content reference; clicking a tab updates the atom's own\n@entity.activeTab and re-renders so only the matching trait's\noutput shows. Events remap at the call site (TAB_CHANGED -> Y) so\nthe host molecule can listen for routing, persistence, analytics.\n\nEach entry in `tabs` (all but `id` and `label` optional):\n- id string! stable tab id (used as activeTab key)\n- label string! visible tab text\n- icon string lucide icon name\n- badge string small badge in the tab strip (e.g. unread count)\n- content string @trait.X reference for the panel body. The host\n molecule binds a sibling trait there; only the\n active tab's content renders at any time. Omit\n to leave the panel empty.\n\nConfig:\n- tabs [TabSpec] = []\n- defaultTab string = '' id of the initial active tab.\n Falls back to tabs[0].id if blank.\n- variant default|pills|underline = default visual style\n- orientation horizontal|vertical = horizontal tab strip orientation\n\nCompiler statically unrolls array/map over @config.tabs so every\nTabSpec field is fully baked into the emitted props at codegen\ntime.",
4
+ "description": "std-tabs — embeddable tab-navigation atom. Renders a tabs strip from @config.tabs ([{id, label, icon?, badge?, content?}]); clicking a tab updates @entity.activeTab so only the matching @trait.X content shows. Events remap at the call site for routing, persistence, analytics.",
5
5
  "orbitals": [
6
6
  {
7
7
  "name": "TabsItemOrbital",
@@ -26,8 +26,8 @@
26
26
  "items": {
27
27
  "type": "object",
28
28
  "properties": {
29
- "label": {
30
- "name": "label",
29
+ "content": {
30
+ "name": "content",
31
31
  "type": "string"
32
32
  },
33
33
  "icon": {
@@ -38,13 +38,13 @@
38
38
  "name": "badge",
39
39
  "type": "string"
40
40
  },
41
- "content": {
42
- "name": "content",
43
- "type": "string"
44
- },
45
41
  "id": {
46
42
  "name": "id",
47
43
  "type": "string"
44
+ },
45
+ "label": {
46
+ "name": "label",
47
+ "type": "string"
48
48
  }
49
49
  }
50
50
  }
@@ -113,12 +113,12 @@
113
113
  "render-ui",
114
114
  "main",
115
115
  {
116
- "tabChangeEvent": "TAB_CHANGED",
117
116
  "orientation": "@config.orientation",
118
- "type": "tabs",
119
117
  "activeTab": "@entity.activeTab",
120
- "items": "@entity.items",
121
- "variant": "@config.variant"
118
+ "variant": "@config.variant",
119
+ "tabChangeEvent": "TAB_CHANGED",
120
+ "type": "tabs",
121
+ "items": "@entity.items"
122
122
  }
123
123
  ]
124
124
  ]
@@ -138,8 +138,8 @@
138
138
  "main",
139
139
  {
140
140
  "tabChangeEvent": "TAB_CHANGED",
141
- "orientation": "@config.orientation",
142
141
  "variant": "@config.variant",
142
+ "orientation": "@config.orientation",
143
143
  "items": "@entity.items",
144
144
  "activeTab": "@entity.activeTab",
145
145
  "type": "tabs"
@@ -150,14 +150,18 @@
150
150
  ]
151
151
  },
152
152
  "config": {
153
- "defaultTab": {
154
- "type": "string",
155
- "default": ""
156
- },
157
153
  "tabs": {
158
154
  "type": "[object]",
159
155
  "default": []
160
156
  },
157
+ "orientation": {
158
+ "type": "string",
159
+ "default": "horizontal",
160
+ "values": [
161
+ "horizontal",
162
+ "vertical"
163
+ ]
164
+ },
161
165
  "variant": {
162
166
  "type": "string",
163
167
  "default": "default",
@@ -167,13 +171,9 @@
167
171
  "underline"
168
172
  ]
169
173
  },
170
- "orientation": {
174
+ "defaultTab": {
171
175
  "type": "string",
172
- "default": "horizontal",
173
- "values": [
174
- "horizontal",
175
- "vertical"
176
- ]
176
+ "default": ""
177
177
  }
178
178
  },
179
179
  "scope": "instance"
package/behaviors/registry/core/molecules/std-dashboard.orb CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "std-dashboard",
3
3
  "version": "1.0.0",
4
- "description": "std-dashboard — molecule composing std-stats + std-graphs + std-browse\ninto a typical dashboard view: stat cards across the top, two charts\nin the middle, data list at the bottom. Browse is the data hub — it\nfetches the rows, emits BrowseItemLoaded; Stats and Graphs both listen\nfor it via cross-trait `Browse.BrowseItemLoaded -> ITEMS_LOADED`. All\nthree atoms render into the layout's `main` slot via `@trait.X`\nplacement.",
4
+ "description": "std-dashboard — molecule composing std-stats + std-graphs + std-browse (stat cards top, charts middle, data list bottom). Browse is the data hub; Stats and Graphs listen for `BrowseItemLoaded -> ITEMS_LOADED`.",
5
5
  "orbitals": [
6
6
  {
7
7
  "name": "DashboardItemOrbital",
@@ -64,20 +64,20 @@
64
64
  "ref": "Stats.traits.StatsItemStats",
65
65
  "name": "DashboardSummary",
66
66
  "config": {
67
- "title": "Summary",
68
67
  "metrics": [
69
68
  {
70
69
  "aggregation": "count",
71
- "label": "Total Items",
72
70
  "icon": "list",
71
+ "label": "Total Items",
73
72
  "variant": "primary",
74
73
  "format": "number"
75
74
  },
76
75
  {
77
- "aggregation": "count",
78
- "icon": "check-circle",
79
- "variant": "success",
80
76
  "label": "Active",
77
+ "variant": "success",
78
+ "icon": "check-circle",
79
+ "aggregation": "count",
80
+ "format": "number",
81
81
  "filter": [
82
82
  "fn",
83
83
  "row",
@@ -86,28 +86,28 @@
86
86
  "@row.status",
87
87
  "active"
88
88
  ]
89
- ],
90
- "format": "number"
89
+ ]
91
90
  },
92
91
  {
93
- "variant": "info",
94
- "field": "amount",
95
92
  "aggregation": "sum",
96
93
  "target": 10000.0,
94
+ "label": "Total Revenue",
95
+ "variant": "info",
97
96
  "icon": "dollar-sign",
98
97
  "format": "currency",
99
- "label": "Total Revenue"
98
+ "field": "amount"
100
99
  },
101
100
  {
102
- "variant": "default",
103
- "label": "Avg Units",
104
101
  "format": "number",
105
- "suffix": " units",
102
+ "label": "Avg Units",
106
103
  "icon": "trending-up",
104
+ "suffix": " units",
107
105
  "field": "units",
108
- "aggregation": "avg"
106
+ "aggregation": "avg",
107
+ "variant": "default"
109
108
  }
110
- ]
109
+ ],
110
+ "title": "Summary"
111
111
  },
112
112
  "listens": [
113
113
  {
@@ -124,13 +124,13 @@
124
124
  "ref": "Graphs.traits.GraphItemGraph",
125
125
  "name": "DashboardCategoryChart",
126
126
  "config": {
127
+ "subtitle": "Count across categories",
128
+ "aggregation": "count",
127
129
  "showLegend": false,
128
- "title": "Items by Category",
129
130
  "chartType": "bar",
130
- "aggregation": "count",
131
- "subtitle": "Count across categories",
132
131
  "categoryField": "category",
133
- "height": 280.0
132
+ "height": 280.0,
133
+ "title": "Items by Category"
134
134
  },
135
135
  "listens": [
136
136
  {
@@ -147,12 +147,12 @@
147
147
  "ref": "Graphs.traits.GraphItemGraph",
148
148
  "name": "DashboardStatusChart",
149
149
  "config": {
150
+ "aggregation": "count",
150
151
  "categoryField": "status",
151
- "showLegend": true,
152
- "chartType": "donut",
153
- "height": 280.0,
154
152
  "title": "Status Mix",
155
- "aggregation": "count"
153
+ "chartType": "donut",
154
+ "showLegend": true,
155
+ "height": 280.0
156
156
  },
157
157
  "listens": [
158
158
  {
@@ -172,28 +172,28 @@
172
172
  "config": {
173
173
  "fields": [
174
174
  {
175
- "label": "Name",
175
+ "name": "name",
176
176
  "variant": "h4",
177
- "name": "name"
177
+ "label": "Name"
178
178
  },
179
179
  {
180
+ "variant": "caption",
180
181
  "name": "category",
181
- "label": "Category",
182
- "variant": "caption"
182
+ "label": "Category"
183
183
  },
184
184
  {
185
- "name": "status",
186
185
  "variant": "badge",
187
- "label": "Status"
186
+ "label": "Status",
187
+ "name": "status"
188
188
  },
189
189
  {
190
- "label": "Amount",
190
+ "variant": "caption",
191
191
  "name": "amount",
192
- "variant": "caption"
192
+ "label": "Amount"
193
193
  }
194
194
  ],
195
- "pageSize": 100.0,
196
- "displayPageSize": 5.0
195
+ "displayPageSize": 5.0,
196
+ "pageSize": 100.0
197
197
  }
198
198
  },
199
199
  {
@@ -274,8 +274,8 @@
274
274
  "DashboardItem",
275
275
  {
276
276
  "emit": {
277
- "failure": "DashboardItemLoadFailed",
278
- "success": "DashboardItemLoaded"
277
+ "success": "DashboardItemLoaded",
278
+ "failure": "DashboardItemLoadFailed"
279
279
  }
280
280
  }
281
281
  ],
@@ -283,51 +283,51 @@
283
283
  "render-ui",
284
284
  "main",
285
285
  {
286
- "direction": "vertical",
287
- "gap": "lg",
288
286
  "children": [
289
287
  {
290
288
  "children": [
291
289
  {
292
- "name": "bar-chart-2",
293
- "type": "icon"
290
+ "type": "icon",
291
+ "name": "bar-chart-2"
294
292
  },
295
293
  {
296
- "type": "typography",
294
+ "content": "Dashboard",
297
295
  "variant": "h2",
298
- "content": "Dashboard"
296
+ "type": "typography"
299
297
  }
300
298
  ],
301
299
  "type": "stack",
300
+ "direction": "horizontal",
302
301
  "gap": "sm",
303
- "align": "center",
304
- "direction": "horizontal"
302
+ "align": "center"
305
303
  },
306
304
  {
307
305
  "type": "divider"
308
306
  },
309
307
  "@trait.DashboardSummary",
310
308
  {
309
+ "gap": "md",
310
+ "cols": 2.0,
311
+ "type": "simple-grid",
311
312
  "children": [
312
313
  "@trait.DashboardCategoryChart",
313
314
  "@trait.DashboardStatusChart"
314
- ],
315
- "type": "simple-grid",
316
- "gap": "md",
317
- "cols": 2.0
315
+ ]
318
316
  },
319
317
  {
320
318
  "type": "divider"
321
319
  },
322
320
  {
323
- "content": "Recent Items",
321
+ "variant": "h3",
324
322
  "type": "typography",
325
- "variant": "h3"
323
+ "content": "Recent Items"
326
324
  },
327
325
  "@trait.DashboardItemBrowse"
328
326
  ],
327
+ "className": "max-w-6xl mx-auto w-full p-4",
329
328
  "type": "stack",
330
- "className": "max-w-6xl mx-auto w-full p-4"
329
+ "direction": "vertical",
330
+ "gap": "lg"
331
331
  }
332
332
  ]
333
333
  ]