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