@peerproblem/sw3-ui 0.0.0-stage → 0.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.
- package/LICENSE +21 -0
- package/README.md +109 -2
- package/agent/components/accordion.md +95 -0
- package/agent/components/action-square.md +106 -0
- package/agent/components/agent-bridge.md +87 -0
- package/agent/components/agent-console.md +123 -0
- package/agent/components/alert-dialog.md +82 -0
- package/agent/components/app-shell.md +105 -0
- package/agent/components/area-chart.md +56 -0
- package/agent/components/async-options.md +47 -0
- package/agent/components/autocomplete.md +69 -0
- package/agent/components/avatar.md +88 -0
- package/agent/components/badge.md +51 -0
- package/agent/components/bar-chart.md +56 -0
- package/agent/components/bar-list.md +49 -0
- package/agent/components/breadcrumbs.md +43 -0
- package/agent/components/button.md +109 -0
- package/agent/components/calendar.md +114 -0
- package/agent/components/canvas.md +105 -0
- package/agent/components/card.md +78 -0
- package/agent/components/carousel.md +113 -0
- package/agent/components/chart-card.md +41 -0
- package/agent/components/chart-surface.md +56 -0
- package/agent/components/checkbox.md +88 -0
- package/agent/components/citation-chip.md +61 -0
- package/agent/components/collapsible.md +69 -0
- package/agent/components/color-picker.md +82 -0
- package/agent/components/combobox.md +104 -0
- package/agent/components/command.md +92 -0
- package/agent/components/dashboard-grid.md +73 -0
- package/agent/components/date-input.md +87 -0
- package/agent/components/date-picker.md +122 -0
- package/agent/components/dialog.md +97 -0
- package/agent/components/donut-chart.md +50 -0
- package/agent/components/drawer.md +101 -0
- package/agent/components/empty-state.md +52 -0
- package/agent/components/field.md +80 -0
- package/agent/components/file-input.md +84 -0
- package/agent/components/hover-card.md +64 -0
- package/agent/components/image-cropper.md +77 -0
- package/agent/components/input.md +49 -0
- package/agent/components/label.md +53 -0
- package/agent/components/line-chart.md +60 -0
- package/agent/components/listbox.md +84 -0
- package/agent/components/map-view.md +104 -0
- package/agent/components/menu.md +117 -0
- package/agent/components/menubar.md +67 -0
- package/agent/components/meter.md +59 -0
- package/agent/components/navigation-menu.md +98 -0
- package/agent/components/number-input.md +81 -0
- package/agent/components/otp-input.md +67 -0
- package/agent/components/pagination.md +80 -0
- package/agent/components/password-input.md +67 -0
- package/agent/components/pill-button.md +116 -0
- package/agent/components/popover.md +85 -0
- package/agent/components/poster-card.md +61 -0
- package/agent/components/preferences.md +92 -0
- package/agent/components/progress.md +63 -0
- package/agent/components/provider.md +47 -0
- package/agent/components/radio.md +91 -0
- package/agent/components/rating.md +66 -0
- package/agent/components/reorder.md +61 -0
- package/agent/components/resizable.md +87 -0
- package/agent/components/scatter-chart.md +49 -0
- package/agent/components/scroll-area.md +81 -0
- package/agent/components/segmented-control.md +56 -0
- package/agent/components/select.md +130 -0
- package/agent/components/separator.md +60 -0
- package/agent/components/shortcuts.md +50 -0
- package/agent/components/sidebar-nav.md +68 -0
- package/agent/components/skeleton.md +58 -0
- package/agent/components/slider.md +79 -0
- package/agent/components/sparkline.md +39 -0
- package/agent/components/squircle.md +58 -0
- package/agent/components/stat.md +58 -0
- package/agent/components/switch.md +48 -0
- package/agent/components/table.md +58 -0
- package/agent/components/tabs.md +108 -0
- package/agent/components/textarea.md +68 -0
- package/agent/components/time-input.md +84 -0
- package/agent/components/timeline.md +91 -0
- package/agent/components/toast.md +85 -0
- package/agent/components/toggle.md +76 -0
- package/agent/components/token-input.md +66 -0
- package/agent/components/toolbar.md +76 -0
- package/agent/components/tooltip.md +83 -0
- package/agent/components/tracker.md +47 -0
- package/agent/components/tree.md +87 -0
- package/agent/components/treemap.md +72 -0
- package/agent/components/trend-chart.md +80 -0
- package/agent/components/trigger-menu.md +67 -0
- package/agent/components/typography.md +51 -0
- package/agent/components/waterfall.md +78 -0
- package/agent/components/week-schedule.md +113 -0
- package/agent/llms/actions-and-layout.txt +1749 -0
- package/agent/llms/agents.txt +505 -0
- package/agent/llms/charts.txt +778 -0
- package/agent/llms/dashboards.txt +457 -0
- package/agent/llms/extend.txt +132 -0
- package/agent/llms/extras.txt +527 -0
- package/agent/llms/forms.txt +2152 -0
- package/agent/llms/foundations.txt +674 -0
- package/agent/llms/hooks.txt +178 -0
- package/agent/llms/maps.txt +229 -0
- package/agent/llms/overlays-and-navigation.txt +1167 -0
- package/agent/llms-full.txt +8717 -0
- package/agent/llms.txt +145 -0
- package/agent/registry.json +11289 -0
- package/agent/tokens.md +66 -0
- package/dist/agent/index.d.ts +235 -0
- package/dist/agent/index.js +21 -0
- package/dist/card-Ipm-Cj5f.d.ts +490 -0
- package/dist/charts/index.d.ts +289 -0
- package/dist/charts/index.js +815 -0
- package/dist/check/cli.d.ts +1 -0
- package/dist/check/cli.js +48 -0
- package/dist/check/rendered.d.ts +11 -0
- package/dist/check/rendered.js +77 -0
- package/dist/check/source.d.ts +13 -0
- package/dist/check/source.js +182 -0
- package/dist/chunk-3DXBM65D.js +65 -0
- package/dist/chunk-3H5X4ZP6.js +55 -0
- package/dist/chunk-6XC4BC5C.js +92 -0
- package/dist/chunk-7H6TEAWD.js +507 -0
- package/dist/chunk-I63ZTJOI.js +1089 -0
- package/dist/chunk-JCIRUM4W.js +33 -0
- package/dist/chunk-LTBEHZ3P.js +25 -0
- package/dist/chunk-QDPPLO4U.js +60 -0
- package/dist/chunk-U2XFBPU4.js +56 -0
- package/dist/chunk-UY2WH5AY.js +681 -0
- package/dist/extras.d.ts +203 -0
- package/dist/extras.js +904 -0
- package/dist/icons-BJiGEAnU.d.ts +68 -0
- package/dist/index.d.ts +3737 -0
- package/dist/index.js +14477 -0
- package/dist/map/index.d.ts +115 -0
- package/dist/map/index.js +394 -0
- package/dist/meta/index.d.ts +3314 -0
- package/dist/meta/index.js +5106 -0
- package/dist/rules-1RIZ_JZr.d.ts +38 -0
- package/dist/styles.css +4037 -0
- package/dist/themes/calm.css +42 -0
- package/dist/themes/frost.css +40 -0
- package/package.json +142 -4
package/agent/llms.txt
ADDED
|
@@ -0,0 +1,145 @@
|
|
|
1
|
+
# SW3 UI SDK (@peerproblem/sw3-ui)
|
|
2
|
+
|
|
3
|
+
> An agentic design system: React components, design rules and tokens that agents can read, build with and operate. Squircle surfaces, motion presets, Unovis charts and MapLibre maps.
|
|
4
|
+
|
|
5
|
+
Setup: `import "@peerproblem/sw3-ui/styles.css"` once, wrap the app in `<SwProvider>`, add `className="sw-root"` to the page. Charts: `@peerproblem/sw3-ui/charts`. Maps: `@peerproblem/sw3-ui/map`.
|
|
6
|
+
Optional peers: install `@unovis/react@~1.8.1 @unovis/ts@~1.8.1 d3-hierarchy@^3.1.0` for charts or `maplibre-gl@^6.18.0` for maps.
|
|
7
|
+
Every rendered component has `data-sw="<slug>"` with state in data-*/ARIA attributes.
|
|
8
|
+
Design check: `npx --no-install sw3-check src` for source diagnostics, `checkDesign(viewRoot)` from `@peerproblem/sw3-ui/check` for a rendered view.
|
|
9
|
+
|
|
10
|
+
## How to read these docs
|
|
11
|
+
|
|
12
|
+
1. Read `llms/foundations.txt` once. It separates structure rules (always) from the default look (change it with tokens).
|
|
13
|
+
2. Read the topic file for what you are building. A settings form needs `forms`; a dashboard needs `dashboards`, then `charts`.
|
|
14
|
+
3. For a single component, read `components/<slug>.md`.
|
|
15
|
+
4. `registry.json` has the same data as JSON. `llms-full.txt` has everything in one file, for tools that cannot follow links.
|
|
16
|
+
|
|
17
|
+
## Topics
|
|
18
|
+
|
|
19
|
+
- [Foundations](llms/foundations.txt) (35 KB): Design principles (structure vs. look), color, type, corners, motion, layout, dark mode, tokens, SwProvider. Read once per task.
|
|
20
|
+
- [Actions, layout and display](llms/actions-and-layout.txt) (71 KB): Buttons, toolbars, cards, accordions, scroll areas, badges, stats, tables, progress, toasts and other building blocks.
|
|
21
|
+
- [Inputs, selection and dates](llms/forms.txt) (95 KB): Text fields, Field wiring, switches, sliders; Select, Combobox, Autocomplete, Listbox, RadioGroup; date and time pickers.
|
|
22
|
+
- [Overlays and navigation](llms/overlays-and-navigation.txt) (53 KB): Dialogs, drawers, popovers, menus, tooltips; tabs, command palette, pagination, breadcrumbs, navigation menus.
|
|
23
|
+
- [Dashboards](llms/dashboards.txt) (32 KB): AppShell, SidebarNav, DashboardGrid: dashboard frame, density, list interactions and chart choice per tile.
|
|
24
|
+
- [Charts](llms/charts.txt) (30 KB): @peerproblem/sw3-ui/charts: which chart answers which question, ChartCard, labeling, raw Unovis inside ChartSurface.
|
|
25
|
+
- [Maps](llms/maps.txt) (11 KB): @peerproblem/sw3-ui/map: MapLibre maps with routes, pins and areas, bundler setup.
|
|
26
|
+
- [Agents](llms/agents.txt) (25 KB): Design check, operating rendered pages, the agent bridge (snapshot / query / act, WebMCP), AgentConsole and CitationChip.
|
|
27
|
+
- [Hooks and utilities](llms/hooks.txt) (7 KB): useReorder, useAsyncOptions, useShortcut and other hooks for building with SW3.
|
|
28
|
+
- [Extras](llms/extras.txt) (24 KB): @peerproblem/sw3-ui/extras: PosterCard, ActionSquare, PillButton, Canvas, WeekSchedule. Use only when the request names the pattern.
|
|
29
|
+
- [Build and contribute components](llms/extend.txt) (6 KB): Build a new component from SW3 primitives and add it to the SDK.
|
|
30
|
+
- [Tokens](tokens.md): Every CSS variable with light and dark values.
|
|
31
|
+
|
|
32
|
+
## Components
|
|
33
|
+
|
|
34
|
+
### Foundations
|
|
35
|
+
- [SwProvider](components/provider.md): Sets the theme and motion defaults for all SW3 components. Wrap the app once.
|
|
36
|
+
- [Squircle](components/squircle.md): Smoothed corners for any element. Use <Squircle> or combine useSquircle() with <SquircleLayers>.
|
|
37
|
+
- [Typography](components/typography.md): Display, Outline, Heading, Text, Link, Caption and Kbd: the type scale for pages, panels and inline text.
|
|
38
|
+
- [Preferences](components/preferences.md): Applies user preferences (theme, reduced motion, contrast, density, font size) as data-* attributes on <html>, saves them to localStorage and a cookie, and ships a ready-made settings panel.
|
|
39
|
+
|
|
40
|
+
### Actions, layout and display
|
|
41
|
+
- [Button](components/button.md): A squircle button with press motion. Ink, app-brandable accent and quiet variants.
|
|
42
|
+
- [Card](components/card.md): A squircle surface with a 1px frame. Plain by design: no background patterns, no hover movement.
|
|
43
|
+
- [Badge](components/badge.md): A small pill label for status, counts and tags.
|
|
44
|
+
- [Stat](components/stat.md): A KPI: mono label, big tabular number, colored delta, optional sparkline.
|
|
45
|
+
- [Toggle / ToggleGroup](components/toggle.md): A button that stays pressed (aria-pressed). ToggleGroup is a row of them for toolbars and filters: several on at once, or one that can be cleared. One tab stop, arrow-key focus.
|
|
46
|
+
- [Separator](components/separator.md): A 1px hairline between groups of content, horizontal or vertical, optionally with a mono caption ("OR").
|
|
47
|
+
- [Meter](components/meter.md): A value in a known range (storage, quota, score), coloured good / so-so / bad from low, high and optimum like a native <meter>.
|
|
48
|
+
- [Progress](components/progress.md): Task progress: a bar that fills as work completes (determinate) or slides while the amount is unknown (`value={null}`).
|
|
49
|
+
- [Skeleton](components/skeleton.md): A static squircle placeholder that reserves space while content loads.
|
|
50
|
+
- [EmptyState](components/empty-state.md): A heading and optional action for a view with no content to display.
|
|
51
|
+
- [Toast](components/toast.md): Imperative notifications — `toast("Saved")` — stacked in a <Toaster/> host: actions, promise states, pause on hover, swipe to dismiss, announced politely.
|
|
52
|
+
- [Accordion](components/accordion.md): Stacked sections whose headings expand and collapse their panels, with an animated height.
|
|
53
|
+
- [Collapsible](components/collapsible.md): One trigger that shows and hides one panel, with an animated height.
|
|
54
|
+
- [Toolbar](components/toolbar.md): A row of buttons, toggles, links and fields with a single tab stop; arrow keys move between them.
|
|
55
|
+
- [Tree](components/tree.md): A hierarchy with expandable branches, folder/file icons and single or multiple selection (APG tree view).
|
|
56
|
+
- [ScrollArea](components/scroll-area.md): Native scrolling with slim overlay scrollbars, edge fades, and an optional stick-to-bottom mode for chat logs.
|
|
57
|
+
- [Resizable](components/resizable.md): Panel groups split by draggable, keyboard-operable handles, with min/max, collapsible panels and saved layouts.
|
|
58
|
+
- [Carousel](components/carousel.md): Slides on native scroll-snap with Previous / Next, page dots, keyboard paging and optional autoplay with a pause control.
|
|
59
|
+
- [Table](components/table.md): Read structured rows and columns with sortable headers and keyboard-accessible horizontal scrolling.
|
|
60
|
+
- [Avatar](components/avatar.md): A person or team picture that shows initials (or an icon) while the image loads and if it fails; AvatarGroup overlaps several with a "+N" count.
|
|
61
|
+
- [Timeline](components/timeline.md): Dated events in order — activity feeds, changelogs, run or order progress — with complete/current/upcoming markers and one tab stop that arrow keys move.
|
|
62
|
+
- [Waterfall](components/waterfall.md): Trace or network spans as bars on one shared time axis; nested spans expand and collapse (treegrid), bars are colored by kind with the chart palette, and hover shows details.
|
|
63
|
+
|
|
64
|
+
### Inputs, selection and dates
|
|
65
|
+
- [Switch](components/switch.md): An on/off toggle with a spring-animated thumb, optionally with label and description.
|
|
66
|
+
- [SegmentedControl](components/segmented-control.md): Pick one of 2–5 options; the active pill glides between segments (motion layout animation).
|
|
67
|
+
- [Input](components/input.md): A text field with label, hint, error and optional prefix/suffix, in a squircle frame.
|
|
68
|
+
- [Field](components/field.md): Connects one form control to its label, description and error (ids, for, aria-describedby, aria-invalid, required, disabled).
|
|
69
|
+
- [Label](components/label.md): Names any control; pressing it focuses or activates the control, even groups a native label cannot reach.
|
|
70
|
+
- [Textarea](components/textarea.md): Multi-line text field that grows with its content between minRows and maxRows, with an optional character count.
|
|
71
|
+
- [Checkbox / CheckboxGroup](components/checkbox.md): A squircle box with an animated check: checked, unchecked or indeterminate. CheckboxGroup shares one array value and supports a select-all parent.
|
|
72
|
+
- [RadioGroup / Radio](components/radio.md): One choice out of a few, all visible: radio dots, or card rows with icons (`variant="card"`). Arrow keys move and check; submits natively with `name`.
|
|
73
|
+
- [Slider](components/slider.md): Pick a number or a range by dragging or with the keyboard. Steps, marks, Intl-formatted value and onValueCommit for saving.
|
|
74
|
+
- [NumberInput](components/number-input.md): A number field with − / + steppers, min/max/step snapping, Intl formatting (currency, percent, units) and spinbutton keys.
|
|
75
|
+
- [PasswordInput](components/password-input.md): A password field with an eye / eye-off reveal toggle and a Caps Lock hint. Hides again when its form submits.
|
|
76
|
+
- [OTPInput](components/otp-input.md): One-time-code entry: N squircle boxes backed by one real input, so paste fills every box and phones autofill the code from a message.
|
|
77
|
+
- [Rating](components/rating.md): Star rating: a radio group of scores with hover preview, half steps, keyboard, and a read-only mode that shows any fraction.
|
|
78
|
+
- [Select](components/select.md): Pick one or several options from a popup list, with groups, optional search inside the dropdown, and a native form value.
|
|
79
|
+
- [Listbox](components/listbox.md): An always-visible framed list to pick one or several options, with one tab stop and full keyboard support.
|
|
80
|
+
- [Combobox](components/combobox.md): A searchable select: type to filter a popup list and pick one value, or several shown as chips. Async-friendly.
|
|
81
|
+
- [Autocomplete](components/autocomplete.md): A text field with suggestions: the value is whatever is typed, and picking a suggestion fills it in.
|
|
82
|
+
- [Trigger Menu](components/trigger-menu.md): Suggestions at the caret when a trigger like @, / or # is typed in a textarea, input or Token Input; inserts the chosen item.
|
|
83
|
+
- [Token Input](components/token-input.md): A text field that mixes editable text with tokens (people, files, tags) shown as chips; tokens come from Enter/comma, a Trigger Menu or code.
|
|
84
|
+
- [Calendar](components/calendar.md): An inline month grid for picking one date, several dates or a range, with full grid keyboard support. Values are ISO date strings.
|
|
85
|
+
- [DateInput](components/date-input.md): Segmented date entry: month, day and year are spinbuttons in the order and with the separators of the user's locale. Value is ISO "YYYY-MM-DD".
|
|
86
|
+
- [DatePicker](components/date-picker.md): DateInput plus Calendar in a popup: type a date or pick it from the month grid. Single date or a range, optional presets; submits ISO.
|
|
87
|
+
- [TimeInput](components/time-input.md): Segmented time entry — hour, minute, optional second and AM/PM on 12-hour locales. Value is 24-hour ISO "HH:mm".
|
|
88
|
+
- [ColorPicker](components/color-picker.md): Pick a color with a saturation/brightness area, hue and alpha sliders, a text field that accepts any CSS color, and preset swatches. The value is a CSS color string.
|
|
89
|
+
- [FileInput](components/file-input.md): Choose, drop or paste files; validate type, size and count; list them with remove; submit them with a form through a real file input.
|
|
90
|
+
- [ImageCropper](components/image-cropper.md): Move and resize a crop over an image (or pan and zoom the image under a fixed frame) with pointer and keyboard; the crop is {x, y, width, height} in image pixels, and cropImage() turns it into a Blob.
|
|
91
|
+
|
|
92
|
+
### Overlays and navigation
|
|
93
|
+
- [Popover](components/popover.md): A small non-modal dialog anchored to its trigger for a quick task with form content: share a link, rename, filter with fields.
|
|
94
|
+
- [Tooltip](components/tooltip.md): A short plain-text hint that names or describes a control on hover and keyboard focus.
|
|
95
|
+
- [HoverCard](components/hover-card.md): A preview card for a link (person, repo, doc) on hover or keyboard focus; the link still navigates.
|
|
96
|
+
- [Dialog](components/dialog.md): A modal squircle panel over a dimmed page for a focused task, with focus trap, scroll lock, Escape and backdrop dismissal.
|
|
97
|
+
- [AlertDialog](components/alert-dialog.md): A modal question that needs an explicit answer — Cancel or the action — plus an imperative `await confirm({...})`.
|
|
98
|
+
- [Drawer](components/drawer.md): A sheet that slides in from an edge (bottom by default); drag it toward its edge to dismiss, with optional snap points.
|
|
99
|
+
- [Menu](components/menu.md): A popup list of actions opened from a button, or at the pointer on right-click (ContextMenu), with groups, checkboxes, radios, submenus and shortcut hints.
|
|
100
|
+
- [Menubar](components/menubar.md): A horizontal bar of menus (File, Edit, View) with one tab stop, arrow keys between menus and hover-switching while one is open.
|
|
101
|
+
- [Command](components/command.md): A command palette: a search field over grouped commands with shortcuts and nested pages; `CommandDialog` opens it with ⌘K.
|
|
102
|
+
- [Tabs](components/tabs.md): A list of tabs with a sliding indicator, each showing one panel. Automatic or manual activation, horizontal or vertical.
|
|
103
|
+
- [NavigationMenu](components/navigation-menu.md): Site navigation: a row of triggers that open panels of links on hover or press, plus plain top-level links.
|
|
104
|
+
- [Pagination](components/pagination.md): Numbered pages with ellipses and Previous / Next, as buttons (onPageChange) or links (getHref).
|
|
105
|
+
- [Breadcrumbs](components/breadcrumbs.md): Where you are in the hierarchy ("Acme / API / Incidents") for the shell header. Middle items shrink first.
|
|
106
|
+
|
|
107
|
+
### Dashboards
|
|
108
|
+
- [AppShell](components/app-shell.md): The frame of a dashboard: a header, a sidebar that folds to a rail, a main region and an inspector, all joined by 1px lines.
|
|
109
|
+
- [SidebarNav](components/sidebar-nav.md): Dense sidebar navigation: 28px rows with icons, counts and hover actions, plus groups that fold. In the rail it becomes icon buttons with tooltips.
|
|
110
|
+
- [DashboardGrid](components/dashboard-grid.md): A 12-column grid of DashboardTiles that share 1px lines in one frame, or sit apart as separate cards. Tiles reorder by their header grip, and DashboardSection folds a row.
|
|
111
|
+
|
|
112
|
+
### Charts
|
|
113
|
+
- [TrendChart](components/trend-chart.md): A small time-series chart for dashboard tiles and KPI cells. The fill fades to nothing, the line is 2px, the latest value gets a dot, a crosshair scrubs, and there are options for a previous period, a threshold, event markers and an unfinished last bucket.
|
|
114
|
+
- [BarList](components/bar-list.md): Ranked rows with a bar behind each label: top endpoints, traffic by country, spend by team. The bar is the row background.
|
|
115
|
+
- [Tracker](components/tracker.md): Status ticks over time, one per day or run (uptime, checks, job runs). Hover or use ←/→ to read a tick.
|
|
116
|
+
- [ChartCard](components/chart-card.md): A Card laid out for a chart: title, description, headline value, actions, chart, legend.
|
|
117
|
+
- [ChartSurface](components/chart-surface.md): Themes any raw @unovis/react chart with SW3 tokens — for Sankey, Graph, Timeline, Chord, Heatmap, maps and every other Unovis type.
|
|
118
|
+
- [LineChart](components/line-chart.md): Trends over time for 1–5 series. Built on Unovis VisLine.
|
|
119
|
+
- [AreaChart](components/area-chart.md): Volume over time; overlapping translucent areas or stacked part-to-whole. Built on Unovis VisArea.
|
|
120
|
+
- [BarChart](components/bar-chart.md): Compare categories, grouped or stacked, vertical or horizontal. Built on Unovis VisGroupedBar / VisStackedBar.
|
|
121
|
+
- [ScatterChart](components/scatter-chart.md): Correlation between two numeric fields, optional size field. Built on Unovis VisScatter.
|
|
122
|
+
- [DonutChart](components/donut-chart.md): Part-to-whole for 2–6 slices with a central label. Built on Unovis VisDonut.
|
|
123
|
+
- [Sparkline](components/sparkline.md): A tiny axis-less trend line for Stats and table cells.
|
|
124
|
+
- [Treemap](components/treemap.md): Part-to-whole for many items, optionally grouped one level deep. Squircle tiles with concentric inner corners and HTML labels that fit the tile.
|
|
125
|
+
|
|
126
|
+
### Maps
|
|
127
|
+
- [MapView](components/map-view.md): A MapLibre GL map in a squircle Card with routes, pins, categorized locations, and highlighted areas.
|
|
128
|
+
|
|
129
|
+
### Agents
|
|
130
|
+
- [CitationChip](components/citation-chip.md): An inline source reference that opens citation details and a link to the original source.
|
|
131
|
+
- [Agent bridge](components/agent-bridge.md): Lets an AI agent list the SW3 components on a page and change them through their APIs: snapshot, query, act, subscribe, WebMCP.
|
|
132
|
+
- [AgentConsole](components/agent-console.md): A chat panel that turns a request into agent-bridge steps and runs them one at a time: it marks each field it changes, logs the exact agent.act() call and its result, then sums up.
|
|
133
|
+
|
|
134
|
+
### Hooks and utilities
|
|
135
|
+
- [useReorder](components/reorder.md): The headless drag-and-drop and keyboard reordering behind Listbox and DashboardGrid. Use it for your own sortable rows, chips or columns.
|
|
136
|
+
- [useAsyncOptions](components/async-options.md): Hook that loads list items as someone types: debounced, cancels stale requests, keeps old results while loading, pages with loadMore.
|
|
137
|
+
- [useShortcut](components/shortcuts.md): Keyboard shortcuts with platform-aware hints. `mod` is ⌘ on Apple and Ctrl elsewhere. `shortcuts.list()` exposes them to agents.
|
|
138
|
+
|
|
139
|
+
### Extras
|
|
140
|
+
- [PosterCard](components/poster-card.md): A gallery tile: tight display words (outlined + solid) top-left, a mono caption under them, and a live component below. Height follows content.
|
|
141
|
+
- [ActionSquare](components/action-square.md): A text label paired with a squircle icon tile ("Learn more [+]", "Close [−]").
|
|
142
|
+
- [PillButton](components/pill-button.md): A fully rounded button with an optional leading icon ("Export", "View tasks").
|
|
143
|
+
- [WeekSchedule](components/week-schedule.md): A week board — day columns × hour rows with meeting, focus and away blocks you drag to move, drag by the bottom edge to resize, or nudge with arrow keys; shows the hours booked.
|
|
144
|
+
- [Canvas](components/canvas.md): A small design artboard of rectangles, ellipses and display text: click to select, drag to move, corner handles to resize, with a built-in layers / X·Y·W·H / fill / opacity inspector.
|
|
145
|
+
|