@f-ewald/components 1.35.0 → 1.37.3
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.
- package/custom-elements.json +138 -3
- package/dist/app-shell.d.ts +8 -0
- package/dist/app-shell.d.ts.map +1 -1
- package/dist/app-shell.js +54 -22
- package/dist/app-shell.js.map +1 -1
- package/dist/copy-link-button.js +2 -2
- package/dist/copy-link-button.js.map +1 -1
- package/dist/dropdown-button.d.ts +8 -1
- package/dist/dropdown-button.d.ts.map +1 -1
- package/dist/dropdown-button.js +25 -1
- package/dist/dropdown-button.js.map +1 -1
- package/dist/icons.d.ts +11 -1
- package/dist/icons.d.ts.map +1 -1
- package/dist/icons.js +11 -1
- package/dist/icons.js.map +1 -1
- package/docs/app-shell.md +7 -0
- package/docs/dropdown-button.md +5 -1
- package/docs/icons.md +6 -1
- package/llms.txt +18 -4
- package/package.json +1 -1
package/llms.txt
CHANGED
|
@@ -40,6 +40,7 @@ table to pick the icon matching a use case, for consistency across apps:
|
|
|
40
40
|
| `iconChevronLeft` | 16px | "Previous" navigation, e.g. pagination or carousel back controls. |
|
|
41
41
|
| `iconChevronRight` | 16px | "Next" navigation, or a collapsed disclosure/submenu indicator. |
|
|
42
42
|
| `iconChevronUp` | 16px | "Scroll to top", or an expanded/upward disclosure control. |
|
|
43
|
+
| `iconClipboard` | 18px | Copy-to-clipboard actions, e.g. copy-link-button. |
|
|
43
44
|
| `iconClipboardDocumentList` | 18px | Task lists, checklists, or clipboard/notes content. |
|
|
44
45
|
| `iconClock` | 16px | Timestamps, durations, or time-related metadata. |
|
|
45
46
|
| `iconCodeBracketSquare` | 16px | Code snippets, developer tools, or technical/API content. |
|
|
@@ -54,12 +55,15 @@ table to pick the icon matching a use case, for consistency across apps:
|
|
|
54
55
|
| `iconEye` | 16px | "Show"/"preview" actions or a visible/reviewed state, e.g. password visibility or a review status. |
|
|
55
56
|
| `iconEyeSlash` | 16px | "Hide" actions or a hidden/masked state; pair with iconEye for the visible state. |
|
|
56
57
|
| `iconFolder` | 18px | Folders, directories, or grouped file content. |
|
|
58
|
+
| `iconGlobeAlt` | 16px | A generic globe/satellite-view toggle, or international/worldwide content. |
|
|
59
|
+
| `iconGlobeAmericas` | 16px | Terrain/outdoors content, or a Americas-centric globe/region selector. |
|
|
57
60
|
| `iconHeart` | 16px | "Like"/"favorite" actions in their unselected state. |
|
|
58
61
|
| `iconHeartSolid` | 16px | "Like"/"favorite" actions in their selected/active state; pair with iconHeart for the unselected state. |
|
|
59
62
|
| `iconHome` | 16px | A primary navigation link to the app's home or dashboard. |
|
|
60
63
|
| `iconInfo` | 20px | Neutral informational messages, e.g. an info toast or status banner. |
|
|
61
|
-
| `iconLink` | 16px |
|
|
64
|
+
| `iconLink` | 16px | Hyperlink-related actions or a linked/associated-item indicator. |
|
|
62
65
|
| `iconListBullet` | 18px | A list-view toggle, or to represent list-type content. |
|
|
66
|
+
| `iconMagnifyingGlass` | 16px | Search inputs or search-triggering actions. |
|
|
63
67
|
| `iconMap` | 16px | A map-view toggle, or to represent map/geographic content. |
|
|
64
68
|
| `iconMapPin` | 16px | A location, address, or map marker. |
|
|
65
69
|
| `iconMoon` | 16px | A dark-theme toggle, or to represent night/dark mode. |
|
|
@@ -72,6 +76,7 @@ table to pick the icon matching a use case, for consistency across apps:
|
|
|
72
76
|
| `iconQueueList` | 16px | Queues, backlogs, or ordered work-item lists. |
|
|
73
77
|
| `iconShieldCheck` | 16px | Verified, secure, or trusted states. |
|
|
74
78
|
| `iconShieldExclamation` | 16px | Security warnings, or at-risk/compromised states. |
|
|
79
|
+
| `iconSignal` | 16px | Live/real-time data, connectivity strength, or a traffic-conditions toggle. |
|
|
75
80
|
| `iconSparkles` | 16px | An AI-powered action (pairs with ui-button's `ai` ring), a gradient-theme toggle, or a decorative/enhanced visual style. |
|
|
76
81
|
| `iconSpeakerWave` | 18px | An unmuted volume control, e.g. audio-player/video-player's mute toggle. |
|
|
77
82
|
| `iconSpeakerXMark` | 18px | A muted volume state; pair with iconSpeakerWave for the unmuted state. |
|
|
@@ -202,9 +207,15 @@ Hovering or keyboard-focusing the toggle reveals a tooltip naming the
|
|
|
202
207
|
action and its `[` shortcut — the shortcut is not shown as permanent
|
|
203
208
|
chrome.
|
|
204
209
|
|
|
210
|
+
Consumers with their own external top bar can set `no-topbar` to skip
|
|
211
|
+
rendering the built-in topbar row and toggle button entirely (the grid
|
|
212
|
+
drops that row rather than leaving dead space). The `[`/Escape shortcuts
|
|
213
|
+
stay fully active either way — drive `sidebar-open` from your own UI and
|
|
214
|
+
listen for `sidebar-toggle` to stay in sync with keyboard-driven changes.
|
|
215
|
+
|
|
205
216
|
Import: `import "@f-ewald/components/app-shell.js";`
|
|
206
217
|
|
|
207
|
-
Properties: `sidebarOpen` (attribute `sidebar-open`) : boolean, default false; `sidebarMode` (attribute `sidebar-mode`) : "overlay" | "push", default "overlay"; `sidebarWidth` (attribute `sidebar-width`) : "full" | "icon", default "full"; `detailOpen` (attribute `detail-open`) : boolean, default false; `detailWidth` (attribute `detail-width`) : "compact" | "comfortable", default "compact"
|
|
218
|
+
Properties: `sidebarOpen` (attribute `sidebar-open`) : boolean, default false; `sidebarMode` (attribute `sidebar-mode`) : "overlay" | "push", default "overlay"; `sidebarWidth` (attribute `sidebar-width`) : "full" | "icon", default "full"; `detailOpen` (attribute `detail-open`) : boolean, default false; `detailWidth` (attribute `detail-width`) : "compact" | "comfortable", default "compact"; `noTopbar` (attribute `no-topbar`) : boolean, default false
|
|
208
219
|
Events: `sidebar-toggle`, `detail-close`
|
|
209
220
|
CSS custom properties: `--ui-border`, `--ui-focus-ring`, `--ui-font-size-sm`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-overlay`, `--ui-radius-sm`, `--ui-shadow`, `--ui-shadow-lg`, `--ui-surface`, `--ui-surface-muted`, `--ui-text-muted`, `--ui-tooltip`
|
|
210
221
|
|
|
@@ -903,11 +914,14 @@ primary-filled button with a label and a rotating chevron), `text-icon`
|
|
|
903
914
|
square, low-emphasis icon target in the style of `icon-button` — the
|
|
904
915
|
classic "three-dot"/overflow menu, where `label` becomes the accessible
|
|
905
916
|
name rather than visible text). Set `size="sm"` for a compact trigger one
|
|
906
|
-
step below the default, matching `ui-button`'s `sm` size.
|
|
917
|
+
step below the default, matching `ui-button`'s `sm` size. Set `circular`
|
|
918
|
+
on the `icon` variant when the trigger wraps an inherently circular
|
|
919
|
+
element (e.g. an avatar) so the hover/focus highlight matches its shape
|
|
920
|
+
instead of the default rounded-square icon-button footprint.
|
|
907
921
|
|
|
908
922
|
Import: `import "@f-ewald/components/dropdown-button.js";`
|
|
909
923
|
|
|
910
|
-
Properties: `label` (attribute `label`) : string, default ""; `options` (JS property only) : DropdownOption[], default []; `disabled` (attribute `disabled`) : boolean, default false; `variant` (attribute `variant`) : DropdownButtonVariant, default "text"; `icon` (JS property only) : TemplateResult | null, default null; `size` (attribute `size`) : "sm" | "md", default "md"
|
|
924
|
+
Properties: `label` (attribute `label`) : string, default ""; `options` (JS property only) : DropdownOption[], default []; `disabled` (attribute `disabled`) : boolean, default false; `variant` (attribute `variant`) : DropdownButtonVariant, default "text"; `icon` (JS property only) : TemplateResult | null, default null; `size` (attribute `size`) : "sm" | "md", default "md"; `circular` (attribute `circular`) : boolean, default false
|
|
911
925
|
Events: `select`
|
|
912
926
|
CSS custom properties: `--ui-border`, `--ui-button-background`, `--ui-button-background-active`, `--ui-button-background-hover`, `--ui-button-border`, `--ui-button-highlight`, `--ui-button-text-shadow`, `--ui-danger`, `--ui-danger-hover`, `--ui-focus-ring`, `--ui-font`, `--ui-font-size-sm`, `--ui-font-size-xs`, `--ui-font-weight-medium`, `--ui-line-height-tight`, `--ui-on-accent`, `--ui-primary`, `--ui-primary-hover`, `--ui-radius-sm`, `--ui-shadow`, `--ui-surface`, `--ui-surface-muted`, `--ui-text`, `--ui-text-muted`
|
|
913
927
|
|