@f-ewald/components 1.2.0 → 1.3.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 (63) hide show
  1. package/README.md +15 -2
  2. package/custom-elements.json +1020 -76
  3. package/dist/action-bar.d.ts +24 -0
  4. package/dist/action-bar.d.ts.map +1 -0
  5. package/dist/action-bar.js +67 -0
  6. package/dist/action-bar.js.map +1 -0
  7. package/dist/app-shell.d.ts +86 -0
  8. package/dist/app-shell.d.ts.map +1 -0
  9. package/dist/app-shell.js +460 -0
  10. package/dist/app-shell.js.map +1 -0
  11. package/dist/app-sidebar.d.ts +44 -0
  12. package/dist/app-sidebar.d.ts.map +1 -0
  13. package/dist/app-sidebar.js +211 -0
  14. package/dist/app-sidebar.js.map +1 -0
  15. package/dist/form-actions.d.ts +27 -0
  16. package/dist/form-actions.d.ts.map +1 -0
  17. package/dist/form-actions.js +65 -0
  18. package/dist/form-actions.js.map +1 -0
  19. package/dist/icons.d.ts +1 -0
  20. package/dist/icons.d.ts.map +1 -1
  21. package/dist/icons.js +1 -0
  22. package/dist/icons.js.map +1 -1
  23. package/dist/index.d.ts +8 -0
  24. package/dist/index.d.ts.map +1 -1
  25. package/dist/index.js +8 -0
  26. package/dist/index.js.map +1 -1
  27. package/dist/mcp-server.js +82 -5
  28. package/dist/mcp-server.js.map +1 -1
  29. package/dist/page-header.d.ts +27 -0
  30. package/dist/page-header.d.ts.map +1 -0
  31. package/dist/page-header.js +106 -0
  32. package/dist/page-header.js.map +1 -0
  33. package/dist/pagination-nav.d.ts +34 -0
  34. package/dist/pagination-nav.d.ts.map +1 -0
  35. package/dist/pagination-nav.js +144 -0
  36. package/dist/pagination-nav.js.map +1 -0
  37. package/dist/popover-panel.js +1 -1
  38. package/dist/popover-panel.js.map +1 -1
  39. package/dist/timeline-container.d.ts +22 -0
  40. package/dist/timeline-container.d.ts.map +1 -0
  41. package/dist/timeline-container.js +42 -0
  42. package/dist/timeline-container.js.map +1 -0
  43. package/dist/timeline-entry.d.ts +31 -0
  44. package/dist/timeline-entry.d.ts.map +1 -0
  45. package/dist/timeline-entry.js +170 -0
  46. package/dist/timeline-entry.js.map +1 -0
  47. package/docs/action-bar.md +41 -0
  48. package/docs/app-shell.md +85 -0
  49. package/docs/app-sidebar.md +69 -0
  50. package/docs/design-language.md +74 -1
  51. package/docs/form-actions.md +43 -0
  52. package/docs/layouts/detail-only.md +52 -0
  53. package/docs/layouts/form-page.md +52 -0
  54. package/docs/layouts/list-detail.md +52 -0
  55. package/docs/layouts/list-only.md +50 -0
  56. package/docs/layouts/record-detail.md +88 -0
  57. package/docs/mcp-evaluation.md +21 -0
  58. package/docs/page-header.md +47 -0
  59. package/docs/pagination-nav.md +54 -0
  60. package/docs/timeline-container.md +44 -0
  61. package/docs/timeline-entry.md +52 -0
  62. package/llms.txt +229 -0
  63. package/package.json +1 -1
package/README.md CHANGED
@@ -44,8 +44,11 @@ import "@f-ewald/components/roman-numeral.js";
44
44
 
45
45
  | Component | Docs |
46
46
  | --- | --- |
47
+ | `<action-bar>` | [API reference](https://f-ewald.github.io/components/docs/action-bar.html) |
47
48
  | `<address-autocomplete>` | [API reference](https://f-ewald.github.io/components/docs/address-autocomplete.html) |
48
49
  | `<animate-confetti>` | [API reference](https://f-ewald.github.io/components/docs/animate-confetti.html) |
50
+ | `<app-shell>` | [API reference](https://f-ewald.github.io/components/docs/app-shell.html) |
51
+ | `<app-sidebar>` | [API reference](https://f-ewald.github.io/components/docs/app-sidebar.html) |
49
52
  | `<autocomplete-input>` | [API reference](https://f-ewald.github.io/components/docs/autocomplete-input.html) |
50
53
  | `<calendar-entry>` | [API reference](https://f-ewald.github.io/components/docs/calendar-entry.html) |
51
54
  | `<calendar-month>` | [API reference](https://f-ewald.github.io/components/docs/calendar-month.html) |
@@ -58,6 +61,7 @@ import "@f-ewald/components/roman-numeral.js";
58
61
  | `<distribution-chart>` | [API reference](https://f-ewald.github.io/components/docs/distribution-chart.html) |
59
62
  | `<dropdown-button>` | [API reference](https://f-ewald.github.io/components/docs/dropdown-button.html) |
60
63
  | `<editable-text>` | [API reference](https://f-ewald.github.io/components/docs/editable-text.html) |
64
+ | `<form-actions>` | [API reference](https://f-ewald.github.io/components/docs/form-actions.html) |
61
65
  | `<form-select>` | [API reference](https://f-ewald.github.io/components/docs/form-select.html) |
62
66
  | `<frame-box>` | [API reference](https://f-ewald.github.io/components/docs/frame-box.html) |
63
67
  | `<gallery-item>` | [API reference](https://f-ewald.github.io/components/docs/gallery-item.html) |
@@ -71,6 +75,8 @@ import "@f-ewald/components/roman-numeral.js";
71
75
  | `<map-circle>` | [API reference](https://f-ewald.github.io/components/docs/map-circle.html) |
72
76
  | `<map-pin>` | [API reference](https://f-ewald.github.io/components/docs/map-pin.html) |
73
77
  | `<multi-select>` | [API reference](https://f-ewald.github.io/components/docs/multi-select.html) |
78
+ | `<page-header>` | [API reference](https://f-ewald.github.io/components/docs/page-header.html) |
79
+ | `<pagination-nav>` | [API reference](https://f-ewald.github.io/components/docs/pagination-nav.html) |
74
80
  | `<percent-bar-chart>` | [API reference](https://f-ewald.github.io/components/docs/percent-bar-chart.html) |
75
81
  | `<photo-gallery>` | [API reference](https://f-ewald.github.io/components/docs/photo-gallery.html) |
76
82
  | `<popover-panel>` | [API reference](https://f-ewald.github.io/components/docs/popover-panel.html) |
@@ -84,6 +90,8 @@ import "@f-ewald/components/roman-numeral.js";
84
90
  | `<stat-meter>` | [API reference](https://f-ewald.github.io/components/docs/stat-meter.html) |
85
91
  | `<status-pill>` | [API reference](https://f-ewald.github.io/components/docs/status-pill.html) |
86
92
  | `<tile-grid>` | [API reference](https://f-ewald.github.io/components/docs/tile-grid.html) |
93
+ | `<timeline-container>` | [API reference](https://f-ewald.github.io/components/docs/timeline-container.html) |
94
+ | `<timeline-entry>` | [API reference](https://f-ewald.github.io/components/docs/timeline-entry.html) |
87
95
  | `<toast-notification>` | [API reference](https://f-ewald.github.io/components/docs/toast-notification.html) |
88
96
  | `<ui-button>` | [API reference](https://f-ewald.github.io/components/docs/ui-button.html) |
89
97
  | `<user-avatar>` | [API reference](https://f-ewald.github.io/components/docs/user-avatar.html) |
@@ -141,15 +149,20 @@ by `npm run test:design`.
141
149
 
142
150
  `npm run mcp` (or `node dist/mcp-server.js` after `npm run build`) starts a
143
151
  stdio [MCP](https://modelcontextprotocol.io) server exposing the component
144
- catalog to AI coding assistants, with two tools:
152
+ catalog to AI coding assistants, with four tools:
145
153
 
146
154
  - `list_components` — every tag + one-line description.
147
155
  - `get_component_docs(tag)` — the full generated Markdown doc for one tag
148
156
  (install snippet, usage example, attributes/properties, events, slots,
149
157
  CSS custom properties).
158
+ - `list_layouts` — every dashboard page template (layout recipe) + a one-line
159
+ summary.
160
+ - `get_layout(name)` — the full recipe for one page template (which components
161
+ fill which `app-shell` slots, markup, and notes).
150
162
 
151
163
  It's read-only over the same `custom-elements.json`/`docs/*.md` this package
152
- already generates via `npm run docs` — no separate data source to maintain.
164
+ already generates via `npm run docs`, plus the authored `docs/layouts/*.md`
165
+ recipes — no separate data source to maintain.
153
166
  A consuming project wires it up with a `.mcp.json` at its repo root:
154
167
 
155
168
  ```json