@metamorph-labs/polymorph-react-ui 0.0.0-stage → 1.0.16
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/CHANGELOG.md +1759 -0
- package/LICENSE +21 -0
- package/README.md +193 -2
- package/dist/ai/ApprovalCard.js +89 -0
- package/dist/ai/ApprovalCard.js.map +1 -0
- package/dist/ai/ArtifactPane.js +134 -0
- package/dist/ai/ArtifactPane.js.map +1 -0
- package/dist/ai/AttachmentChip.js +84 -0
- package/dist/ai/AttachmentChip.js.map +1 -0
- package/dist/ai/ChatMessage.js +67 -0
- package/dist/ai/ChatMessage.js.map +1 -0
- package/dist/ai/ChatThread.js +62 -0
- package/dist/ai/ChatThread.js.map +1 -0
- package/dist/ai/Citation.js +39 -0
- package/dist/ai/Citation.js.map +1 -0
- package/dist/ai/Markdown.js +113 -0
- package/dist/ai/Markdown.js.map +1 -0
- package/dist/ai/Plan.js +74 -0
- package/dist/ai/Plan.js.map +1 -0
- package/dist/ai/PromptInput.js +347 -0
- package/dist/ai/PromptInput.js.map +1 -0
- package/dist/ai/ReasoningDisclosure.js +71 -0
- package/dist/ai/ReasoningDisclosure.js.map +1 -0
- package/dist/ai/SourceList.js +58 -0
- package/dist/ai/SourceList.js.map +1 -0
- package/dist/ai/StreamingText.js +31 -0
- package/dist/ai/StreamingText.js.map +1 -0
- package/dist/ai/ToolCall.js +144 -0
- package/dist/ai/ToolCall.js.map +1 -0
- package/dist/ai/approval-card.css +1 -0
- package/dist/ai/approval-card.module.js +19 -0
- package/dist/ai/approval-card.module.js.map +1 -0
- package/dist/ai/approval-card.states.js +93 -0
- package/dist/ai/approval-card.states.js.map +1 -0
- package/dist/ai/artifact-pane.css +1 -0
- package/dist/ai/artifact-pane.module.js +21 -0
- package/dist/ai/artifact-pane.module.js.map +1 -0
- package/dist/ai/artifact-pane.states.js +99 -0
- package/dist/ai/artifact-pane.states.js.map +1 -0
- package/dist/ai/attachment-chip.css +1 -0
- package/dist/ai/attachment-chip.module.js +15 -0
- package/dist/ai/attachment-chip.module.js.map +1 -0
- package/dist/ai/attachment-chip.states.js +72 -0
- package/dist/ai/attachment-chip.states.js.map +1 -0
- package/dist/ai/chat-message.css +1 -0
- package/dist/ai/chat-message.module.js +20 -0
- package/dist/ai/chat-message.module.js.map +1 -0
- package/dist/ai/chat-message.states.js +167 -0
- package/dist/ai/chat-message.states.js.map +1 -0
- package/dist/ai/chat-thread.css +1 -0
- package/dist/ai/chat-thread.module.js +16 -0
- package/dist/ai/chat-thread.module.js.map +1 -0
- package/dist/ai/chat-thread.states.js +106 -0
- package/dist/ai/chat-thread.states.js.map +1 -0
- package/dist/ai/citation.css +1 -0
- package/dist/ai/citation.module.js +14 -0
- package/dist/ai/citation.module.js.map +1 -0
- package/dist/ai/citation.states.js +52 -0
- package/dist/ai/citation.states.js.map +1 -0
- package/dist/ai/markdown.css +1 -0
- package/dist/ai/markdown.module.js +15 -0
- package/dist/ai/markdown.module.js.map +1 -0
- package/dist/ai/markdown.states.js +84 -0
- package/dist/ai/markdown.states.js.map +1 -0
- package/dist/ai/plan.css +1 -0
- package/dist/ai/plan.module.js +21 -0
- package/dist/ai/plan.module.js.map +1 -0
- package/dist/ai/plan.states.js +146 -0
- package/dist/ai/plan.states.js.map +1 -0
- package/dist/ai/prompt-input.css +1 -0
- package/dist/ai/prompt-input.module.js +28 -0
- package/dist/ai/prompt-input.module.js.map +1 -0
- package/dist/ai/prompt-input.states.js +187 -0
- package/dist/ai/prompt-input.states.js.map +1 -0
- package/dist/ai/reasoning-disclosure.css +1 -0
- package/dist/ai/reasoning-disclosure.module.js +21 -0
- package/dist/ai/reasoning-disclosure.module.js.map +1 -0
- package/dist/ai/reasoning-disclosure.states.js +78 -0
- package/dist/ai/reasoning-disclosure.states.js.map +1 -0
- package/dist/ai/source-list.css +1 -0
- package/dist/ai/source-list.module.js +19 -0
- package/dist/ai/source-list.module.js.map +1 -0
- package/dist/ai/source-list.states.js +61 -0
- package/dist/ai/source-list.states.js.map +1 -0
- package/dist/ai/streaming-text.css +1 -0
- package/dist/ai/streaming-text.module.js +12 -0
- package/dist/ai/streaming-text.module.js.map +1 -0
- package/dist/ai/streaming-text.states.js +58 -0
- package/dist/ai/streaming-text.states.js.map +1 -0
- package/dist/ai/tool-call.css +1 -0
- package/dist/ai/tool-call.module.js +28 -0
- package/dist/ai/tool-call.module.js.map +1 -0
- package/dist/ai/tool-call.states.js +136 -0
- package/dist/ai/tool-call.states.js.map +1 -0
- package/dist/archetypes/AppShell.js +11 -0
- package/dist/archetypes/AppShell.js.map +1 -0
- package/dist/archetypes/AuthPage.js +88 -0
- package/dist/archetypes/AuthPage.js.map +1 -0
- package/dist/archetypes/ConversationPage.js +84 -0
- package/dist/archetypes/ConversationPage.js.map +1 -0
- package/dist/archetypes/Dashboard.js +48 -0
- package/dist/archetypes/Dashboard.js.map +1 -0
- package/dist/archetypes/DetailPage.js +66 -0
- package/dist/archetypes/DetailPage.js.map +1 -0
- package/dist/archetypes/FormPage.js +45 -0
- package/dist/archetypes/FormPage.js.map +1 -0
- package/dist/archetypes/ListPage.js +41 -0
- package/dist/archetypes/ListPage.js.map +1 -0
- package/dist/archetypes/MasterDetailPage.js +96 -0
- package/dist/archetypes/MasterDetailPage.js.map +1 -0
- package/dist/archetypes/SearchPage.js +55 -0
- package/dist/archetypes/SearchPage.js.map +1 -0
- package/dist/archetypes/SettingsPage.js +19 -0
- package/dist/archetypes/SettingsPage.js.map +1 -0
- package/dist/archetypes/app-shell-parts.js +245 -0
- package/dist/archetypes/app-shell-parts.js.map +1 -0
- package/dist/archetypes/app-shell.css +1 -0
- package/dist/archetypes/app-shell.module.js +37 -0
- package/dist/archetypes/app-shell.module.js.map +1 -0
- package/dist/archetypes/app-shell.states.js +519 -0
- package/dist/archetypes/app-shell.states.js.map +1 -0
- package/dist/archetypes/auth-page.css +1 -0
- package/dist/archetypes/auth-page.module.js +29 -0
- package/dist/archetypes/auth-page.module.js.map +1 -0
- package/dist/archetypes/auth-page.states.js +185 -0
- package/dist/archetypes/auth-page.states.js.map +1 -0
- package/dist/archetypes/conversation-page.css +1 -0
- package/dist/archetypes/conversation-page.module.js +17 -0
- package/dist/archetypes/conversation-page.module.js.map +1 -0
- package/dist/archetypes/conversation-page.states.js +88 -0
- package/dist/archetypes/conversation-page.states.js.map +1 -0
- package/dist/archetypes/dashboard.css +1 -0
- package/dist/archetypes/dashboard.module.js +14 -0
- package/dist/archetypes/dashboard.module.js.map +1 -0
- package/dist/archetypes/dashboard.states.js +171 -0
- package/dist/archetypes/dashboard.states.js.map +1 -0
- package/dist/archetypes/detail-page.css +1 -0
- package/dist/archetypes/detail-page.module.js +21 -0
- package/dist/archetypes/detail-page.module.js.map +1 -0
- package/dist/archetypes/detail-page.states.js +199 -0
- package/dist/archetypes/detail-page.states.js.map +1 -0
- package/dist/archetypes/form-page.css +1 -0
- package/dist/archetypes/form-page.module.js +12 -0
- package/dist/archetypes/form-page.module.js.map +1 -0
- package/dist/archetypes/form-page.states.js +155 -0
- package/dist/archetypes/form-page.states.js.map +1 -0
- package/dist/archetypes/list-page.css +1 -0
- package/dist/archetypes/list-page.module.js +12 -0
- package/dist/archetypes/list-page.module.js.map +1 -0
- package/dist/archetypes/list-page.states.js +266 -0
- package/dist/archetypes/list-page.states.js.map +1 -0
- package/dist/archetypes/master-detail-page.css +1 -0
- package/dist/archetypes/master-detail-page.module.js +18 -0
- package/dist/archetypes/master-detail-page.module.js.map +1 -0
- package/dist/archetypes/master-detail-page.states.js +183 -0
- package/dist/archetypes/master-detail-page.states.js.map +1 -0
- package/dist/archetypes/search-page.css +1 -0
- package/dist/archetypes/search-page.module.js +12 -0
- package/dist/archetypes/search-page.module.js.map +1 -0
- package/dist/archetypes/search-page.states.js +215 -0
- package/dist/archetypes/search-page.states.js.map +1 -0
- package/dist/archetypes/settings-page.css +1 -0
- package/dist/archetypes/settings-page.module.js +8 -0
- package/dist/archetypes/settings-page.module.js.map +1 -0
- package/dist/archetypes/settings-page.states.js +81 -0
- package/dist/archetypes/settings-page.states.js.map +1 -0
- package/dist/base.css +1 -0
- package/dist/charts/AreaChart.js +262 -0
- package/dist/charts/AreaChart.js.map +1 -0
- package/dist/charts/BarChart.js +233 -0
- package/dist/charts/BarChart.js.map +1 -0
- package/dist/charts/DonutChart.js +153 -0
- package/dist/charts/DonutChart.js.map +1 -0
- package/dist/charts/FunnelChart.js +169 -0
- package/dist/charts/FunnelChart.js.map +1 -0
- package/dist/charts/Heatmap.js +169 -0
- package/dist/charts/Heatmap.js.map +1 -0
- package/dist/charts/Histogram.js +165 -0
- package/dist/charts/Histogram.js.map +1 -0
- package/dist/charts/LineChart.js +286 -0
- package/dist/charts/LineChart.js.map +1 -0
- package/dist/charts/RadarChart.js +203 -0
- package/dist/charts/RadarChart.js.map +1 -0
- package/dist/charts/ScatterChart.js +207 -0
- package/dist/charts/ScatterChart.js.map +1 -0
- package/dist/charts/Sparkline.js +36 -0
- package/dist/charts/Sparkline.js.map +1 -0
- package/dist/charts/Treemap.js +160 -0
- package/dist/charts/Treemap.js.map +1 -0
- package/dist/charts/area-chart.css +1 -0
- package/dist/charts/area-chart.module.js +18 -0
- package/dist/charts/area-chart.module.js.map +1 -0
- package/dist/charts/area-chart.states.js +233 -0
- package/dist/charts/area-chart.states.js.map +1 -0
- package/dist/charts/bar-chart.css +1 -0
- package/dist/charts/bar-chart.module.js +23 -0
- package/dist/charts/bar-chart.module.js.map +1 -0
- package/dist/charts/bar-chart.states.js +674 -0
- package/dist/charts/bar-chart.states.js.map +1 -0
- package/dist/charts/donut-chart.css +1 -0
- package/dist/charts/donut-chart.module.js +16 -0
- package/dist/charts/donut-chart.module.js.map +1 -0
- package/dist/charts/donut-chart.states.js +224 -0
- package/dist/charts/donut-chart.states.js.map +1 -0
- package/dist/charts/frame/ChartAnnotations.js +48 -0
- package/dist/charts/frame/ChartAnnotations.js.map +1 -0
- package/dist/charts/frame/ChartAxis.js +23 -0
- package/dist/charts/frame/ChartAxis.js.map +1 -0
- package/dist/charts/frame/ChartBrush.js +31 -0
- package/dist/charts/frame/ChartBrush.js.map +1 -0
- package/dist/charts/frame/ChartFrame.js +53 -0
- package/dist/charts/frame/ChartFrame.js.map +1 -0
- package/dist/charts/frame/ChartLegend.js +46 -0
- package/dist/charts/frame/ChartLegend.js.map +1 -0
- package/dist/charts/frame/ChartScaleLegend.js +58 -0
- package/dist/charts/frame/ChartScaleLegend.js.map +1 -0
- package/dist/charts/frame/ChartTooltip.js +42 -0
- package/dist/charts/frame/ChartTooltip.js.map +1 -0
- package/dist/charts/frame/ChartTwin.js +43 -0
- package/dist/charts/frame/ChartTwin.js.map +1 -0
- package/dist/charts/frame/chart-annotations.css +1 -0
- package/dist/charts/frame/chart-annotations.module.js +16 -0
- package/dist/charts/frame/chart-annotations.module.js.map +1 -0
- package/dist/charts/frame/chart-axis.css +1 -0
- package/dist/charts/frame/chart-axis.module.js +12 -0
- package/dist/charts/frame/chart-axis.module.js.map +1 -0
- package/dist/charts/frame/chart-brush.css +1 -0
- package/dist/charts/frame/chart-brush.module.js +11 -0
- package/dist/charts/frame/chart-brush.module.js.map +1 -0
- package/dist/charts/frame/chart-frame.css +1 -0
- package/dist/charts/frame/chart-frame.module.js +17 -0
- package/dist/charts/frame/chart-frame.module.js.map +1 -0
- package/dist/charts/frame/chart-legend.css +1 -0
- package/dist/charts/frame/chart-legend.module.js +15 -0
- package/dist/charts/frame/chart-legend.module.js.map +1 -0
- package/dist/charts/frame/chart-scale-legend.css +1 -0
- package/dist/charts/frame/chart-scale-legend.module.js +15 -0
- package/dist/charts/frame/chart-scale-legend.module.js.map +1 -0
- package/dist/charts/frame/chart-tooltip.css +1 -0
- package/dist/charts/frame/chart-tooltip.module.js +16 -0
- package/dist/charts/frame/chart-tooltip.module.js.map +1 -0
- package/dist/charts/frame/chart-twin.css +1 -0
- package/dist/charts/frame/chart-twin.module.js +12 -0
- package/dist/charts/frame/chart-twin.module.js.map +1 -0
- package/dist/charts/frame/use-brush.js +46 -0
- package/dist/charts/frame/use-brush.js.map +1 -0
- package/dist/charts/frame/use-chart-cap.js +17 -0
- package/dist/charts/frame/use-chart-cap.js.map +1 -0
- package/dist/charts/frame/use-measured-box.js +19 -0
- package/dist/charts/frame/use-measured-box.js.map +1 -0
- package/dist/charts/frame/use-reading.js +49 -0
- package/dist/charts/frame/use-reading.js.map +1 -0
- package/dist/charts/frame/use-sync.js +21 -0
- package/dist/charts/frame/use-sync.js.map +1 -0
- package/dist/charts/funnel-chart.css +1 -0
- package/dist/charts/funnel-chart.module.js +19 -0
- package/dist/charts/funnel-chart.module.js.map +1 -0
- package/dist/charts/funnel-chart.states.js +282 -0
- package/dist/charts/funnel-chart.states.js.map +1 -0
- package/dist/charts/heatmap.css +1 -0
- package/dist/charts/heatmap.module.js +13 -0
- package/dist/charts/heatmap.module.js.map +1 -0
- package/dist/charts/heatmap.states.js +300 -0
- package/dist/charts/heatmap.states.js.map +1 -0
- package/dist/charts/histogram.css +1 -0
- package/dist/charts/histogram.module.js +17 -0
- package/dist/charts/histogram.module.js.map +1 -0
- package/dist/charts/histogram.states.js +117 -0
- package/dist/charts/histogram.states.js.map +1 -0
- package/dist/charts/line-chart.css +1 -0
- package/dist/charts/line-chart.module.js +21 -0
- package/dist/charts/line-chart.module.js.map +1 -0
- package/dist/charts/line-chart.states.js +369 -0
- package/dist/charts/line-chart.states.js.map +1 -0
- package/dist/charts/radar-chart.css +1 -0
- package/dist/charts/radar-chart.module.js +19 -0
- package/dist/charts/radar-chart.module.js.map +1 -0
- package/dist/charts/radar-chart.states.js +264 -0
- package/dist/charts/radar-chart.states.js.map +1 -0
- package/dist/charts/scatter-chart.css +1 -0
- package/dist/charts/scatter-chart.module.js +17 -0
- package/dist/charts/scatter-chart.module.js.map +1 -0
- package/dist/charts/scatter-chart.states.js +230 -0
- package/dist/charts/scatter-chart.states.js.map +1 -0
- package/dist/charts/sparkline.css +1 -0
- package/dist/charts/sparkline.module.js +13 -0
- package/dist/charts/sparkline.module.js.map +1 -0
- package/dist/charts/sparkline.states.js +120 -0
- package/dist/charts/sparkline.states.js.map +1 -0
- package/dist/charts/treemap.css +1 -0
- package/dist/charts/treemap.module.js +18 -0
- package/dist/charts/treemap.module.js.map +1 -0
- package/dist/charts/treemap.states.js +312 -0
- package/dist/charts/treemap.states.js.map +1 -0
- package/dist/controls/AvatarButton.js +55 -0
- package/dist/controls/AvatarButton.js.map +1 -0
- package/dist/controls/Button.js +98 -0
- package/dist/controls/Button.js.map +1 -0
- package/dist/controls/Calendar.js +180 -0
- package/dist/controls/Calendar.js.map +1 -0
- package/dist/controls/Checkbox.js +70 -0
- package/dist/controls/Checkbox.js.map +1 -0
- package/dist/controls/CheckboxGroup.js +91 -0
- package/dist/controls/CheckboxGroup.js.map +1 -0
- package/dist/controls/ChoiceCard.js +132 -0
- package/dist/controls/ChoiceCard.js.map +1 -0
- package/dist/controls/ColorInput.js +224 -0
- package/dist/controls/ColorInput.js.map +1 -0
- package/dist/controls/Combobox.js +277 -0
- package/dist/controls/Combobox.js.map +1 -0
- package/dist/controls/CopyButton.js +59 -0
- package/dist/controls/CopyButton.js.map +1 -0
- package/dist/controls/DatePicker.js +229 -0
- package/dist/controls/DatePicker.js.map +1 -0
- package/dist/controls/DateRangePicker.js +325 -0
- package/dist/controls/DateRangePicker.js.map +1 -0
- package/dist/controls/DurationInput.js +183 -0
- package/dist/controls/DurationInput.js.map +1 -0
- package/dist/controls/FileUpload.js +202 -0
- package/dist/controls/FileUpload.js.map +1 -0
- package/dist/controls/FormField.js +73 -0
- package/dist/controls/FormField.js.map +1 -0
- package/dist/controls/ImageEditor.js +370 -0
- package/dist/controls/ImageEditor.js.map +1 -0
- package/dist/controls/InlineEdit.js +184 -0
- package/dist/controls/InlineEdit.js.map +1 -0
- package/dist/controls/Input.js +124 -0
- package/dist/controls/Input.js.map +1 -0
- package/dist/controls/Link.js +63 -0
- package/dist/controls/Link.js.map +1 -0
- package/dist/controls/ModeSwitch.js +61 -0
- package/dist/controls/ModeSwitch.js.map +1 -0
- package/dist/controls/MonthInput.js +169 -0
- package/dist/controls/MonthInput.js.map +1 -0
- package/dist/controls/MultiSelect.js +458 -0
- package/dist/controls/MultiSelect.js.map +1 -0
- package/dist/controls/NumberInput.js +132 -0
- package/dist/controls/NumberInput.js.map +1 -0
- package/dist/controls/OTPInput.js +99 -0
- package/dist/controls/OTPInput.js.map +1 -0
- package/dist/controls/PasswordInput.js +90 -0
- package/dist/controls/PasswordInput.js.map +1 -0
- package/dist/controls/PhoneInput.js +169 -0
- package/dist/controls/PhoneInput.js.map +1 -0
- package/dist/controls/ProviderButton.js +55 -0
- package/dist/controls/ProviderButton.js.map +1 -0
- package/dist/controls/Radio.js +68 -0
- package/dist/controls/Radio.js.map +1 -0
- package/dist/controls/Rating.js +125 -0
- package/dist/controls/Rating.js.map +1 -0
- package/dist/controls/RecordButton.js +60 -0
- package/dist/controls/RecordButton.js.map +1 -0
- package/dist/controls/SearchInput.js +63 -0
- package/dist/controls/SearchInput.js.map +1 -0
- package/dist/controls/SegmentedControl.js +77 -0
- package/dist/controls/SegmentedControl.js.map +1 -0
- package/dist/controls/Select.js +299 -0
- package/dist/controls/Select.js.map +1 -0
- package/dist/controls/Slider.js +122 -0
- package/dist/controls/Slider.js.map +1 -0
- package/dist/controls/SplitButton.js +179 -0
- package/dist/controls/SplitButton.js.map +1 -0
- package/dist/controls/Switch.js +62 -0
- package/dist/controls/Switch.js.map +1 -0
- package/dist/controls/TagInput.js +200 -0
- package/dist/controls/TagInput.js.map +1 -0
- package/dist/controls/Textarea.js +74 -0
- package/dist/controls/Textarea.js.map +1 -0
- package/dist/controls/TimeInput.js +92 -0
- package/dist/controls/TimeInput.js.map +1 -0
- package/dist/controls/TreeSelect.js +223 -0
- package/dist/controls/TreeSelect.js.map +1 -0
- package/dist/controls/avatar-button.css +1 -0
- package/dist/controls/avatar-button.module.js +12 -0
- package/dist/controls/avatar-button.module.js.map +1 -0
- package/dist/controls/avatar-button.states.js +138 -0
- package/dist/controls/avatar-button.states.js.map +1 -0
- package/dist/controls/button.css +1 -0
- package/dist/controls/button.module.js +14 -0
- package/dist/controls/button.module.js.map +1 -0
- package/dist/controls/button.states.js +287 -0
- package/dist/controls/button.states.js.map +1 -0
- package/dist/controls/calendar.css +1 -0
- package/dist/controls/calendar.module.js +17 -0
- package/dist/controls/calendar.module.js.map +1 -0
- package/dist/controls/calendar.states.js +83 -0
- package/dist/controls/calendar.states.js.map +1 -0
- package/dist/controls/checkbox-group.css +1 -0
- package/dist/controls/checkbox-group.module.js +16 -0
- package/dist/controls/checkbox-group.module.js.map +1 -0
- package/dist/controls/checkbox-group.states.js +141 -0
- package/dist/controls/checkbox-group.states.js.map +1 -0
- package/dist/controls/checkbox.css +1 -0
- package/dist/controls/checkbox.module.js +14 -0
- package/dist/controls/checkbox.module.js.map +1 -0
- package/dist/controls/checkbox.states.js +102 -0
- package/dist/controls/checkbox.states.js.map +1 -0
- package/dist/controls/choice-card.css +1 -0
- package/dist/controls/choice-card.module.js +17 -0
- package/dist/controls/choice-card.module.js.map +1 -0
- package/dist/controls/choice-card.states.js +125 -0
- package/dist/controls/choice-card.states.js.map +1 -0
- package/dist/controls/color-input.css +1 -0
- package/dist/controls/color-input.module.js +18 -0
- package/dist/controls/color-input.module.js.map +1 -0
- package/dist/controls/color-input.states.js +100 -0
- package/dist/controls/color-input.states.js.map +1 -0
- package/dist/controls/combobox.css +1 -0
- package/dist/controls/combobox.module.js +30 -0
- package/dist/controls/combobox.module.js.map +1 -0
- package/dist/controls/combobox.states.js +259 -0
- package/dist/controls/combobox.states.js.map +1 -0
- package/dist/controls/copy-button.css +1 -0
- package/dist/controls/copy-button.module.js +15 -0
- package/dist/controls/copy-button.module.js.map +1 -0
- package/dist/controls/copy-button.states.js +52 -0
- package/dist/controls/copy-button.states.js.map +1 -0
- package/dist/controls/date-picker.css +1 -0
- package/dist/controls/date-picker.module.js +19 -0
- package/dist/controls/date-picker.module.js.map +1 -0
- package/dist/controls/date-picker.states.js +120 -0
- package/dist/controls/date-picker.states.js.map +1 -0
- package/dist/controls/date-range-picker.css +1 -0
- package/dist/controls/date-range-picker.module.js +29 -0
- package/dist/controls/date-range-picker.module.js.map +1 -0
- package/dist/controls/date-range-picker.states.js +121 -0
- package/dist/controls/date-range-picker.states.js.map +1 -0
- package/dist/controls/date-segments.js +47 -0
- package/dist/controls/date-segments.js.map +1 -0
- package/dist/controls/duration-input.css +1 -0
- package/dist/controls/duration-input.module.js +14 -0
- package/dist/controls/duration-input.module.js.map +1 -0
- package/dist/controls/duration-input.states.js +109 -0
- package/dist/controls/duration-input.states.js.map +1 -0
- package/dist/controls/file-upload.css +1 -0
- package/dist/controls/file-upload.module.js +26 -0
- package/dist/controls/file-upload.module.js.map +1 -0
- package/dist/controls/file-upload.states.js +107 -0
- package/dist/controls/file-upload.states.js.map +1 -0
- package/dist/controls/form-field.css +1 -0
- package/dist/controls/form-field.module.js +18 -0
- package/dist/controls/form-field.module.js.map +1 -0
- package/dist/controls/form-field.states.js +184 -0
- package/dist/controls/form-field.states.js.map +1 -0
- package/dist/controls/image-editor.css +1 -0
- package/dist/controls/image-editor.geometry.js +51 -0
- package/dist/controls/image-editor.geometry.js.map +1 -0
- package/dist/controls/image-editor.module.js +22 -0
- package/dist/controls/image-editor.module.js.map +1 -0
- package/dist/controls/image-editor.states.js +112 -0
- package/dist/controls/image-editor.states.js.map +1 -0
- package/dist/controls/inline-edit.css +1 -0
- package/dist/controls/inline-edit.module.js +16 -0
- package/dist/controls/inline-edit.module.js.map +1 -0
- package/dist/controls/inline-edit.states.js +124 -0
- package/dist/controls/inline-edit.states.js.map +1 -0
- package/dist/controls/input.css +1 -0
- package/dist/controls/input.module.js +16 -0
- package/dist/controls/input.module.js.map +1 -0
- package/dist/controls/input.states.js +163 -0
- package/dist/controls/input.states.js.map +1 -0
- package/dist/controls/link.css +1 -0
- package/dist/controls/link.module.js +13 -0
- package/dist/controls/link.module.js.map +1 -0
- package/dist/controls/link.states.js +130 -0
- package/dist/controls/link.states.js.map +1 -0
- package/dist/controls/mode-switch.states.js +72 -0
- package/dist/controls/mode-switch.states.js.map +1 -0
- package/dist/controls/month-input.css +1 -0
- package/dist/controls/month-input.module.js +13 -0
- package/dist/controls/month-input.module.js.map +1 -0
- package/dist/controls/month-input.states.js +125 -0
- package/dist/controls/month-input.states.js.map +1 -0
- package/dist/controls/multi-select.css +1 -0
- package/dist/controls/multi-select.module.js +34 -0
- package/dist/controls/multi-select.module.js.map +1 -0
- package/dist/controls/multi-select.states.js +223 -0
- package/dist/controls/multi-select.states.js.map +1 -0
- package/dist/controls/navigate.js +15 -0
- package/dist/controls/navigate.js.map +1 -0
- package/dist/controls/number-input.css +1 -0
- package/dist/controls/number-input.module.js +14 -0
- package/dist/controls/number-input.module.js.map +1 -0
- package/dist/controls/number-input.states.js +108 -0
- package/dist/controls/number-input.states.js.map +1 -0
- package/dist/controls/otp-input.css +1 -0
- package/dist/controls/otp-input.module.js +14 -0
- package/dist/controls/otp-input.module.js.map +1 -0
- package/dist/controls/otp-input.states.js +75 -0
- package/dist/controls/otp-input.states.js.map +1 -0
- package/dist/controls/password-input.css +1 -0
- package/dist/controls/password-input.module.js +12 -0
- package/dist/controls/password-input.module.js.map +1 -0
- package/dist/controls/password-input.states.js +92 -0
- package/dist/controls/password-input.states.js.map +1 -0
- package/dist/controls/phone-input.css +1 -0
- package/dist/controls/phone-input.module.js +12 -0
- package/dist/controls/phone-input.module.js.map +1 -0
- package/dist/controls/phone-input.states.js +144 -0
- package/dist/controls/phone-input.states.js.map +1 -0
- package/dist/controls/provider-button.css +1 -0
- package/dist/controls/provider-button.module.js +13 -0
- package/dist/controls/provider-button.module.js.map +1 -0
- package/dist/controls/provider-button.states.js +116 -0
- package/dist/controls/provider-button.states.js.map +1 -0
- package/dist/controls/radio-arrows.js +27 -0
- package/dist/controls/radio-arrows.js.map +1 -0
- package/dist/controls/radio-group.css +1 -0
- package/dist/controls/radio-group.module.js +15 -0
- package/dist/controls/radio-group.module.js.map +1 -0
- package/dist/controls/radio.states.js +127 -0
- package/dist/controls/radio.states.js.map +1 -0
- package/dist/controls/rating.css +1 -0
- package/dist/controls/rating.module.js +13 -0
- package/dist/controls/rating.module.js.map +1 -0
- package/dist/controls/rating.states.js +149 -0
- package/dist/controls/rating.states.js.map +1 -0
- package/dist/controls/record-button.css +1 -0
- package/dist/controls/record-button.module.js +13 -0
- package/dist/controls/record-button.module.js.map +1 -0
- package/dist/controls/record-button.states.js +72 -0
- package/dist/controls/record-button.states.js.map +1 -0
- package/dist/controls/search-input.css +1 -0
- package/dist/controls/search-input.module.js +11 -0
- package/dist/controls/search-input.module.js.map +1 -0
- package/dist/controls/search-input.states.js +62 -0
- package/dist/controls/search-input.states.js.map +1 -0
- package/dist/controls/segmented-control.css +1 -0
- package/dist/controls/segmented-control.module.js +14 -0
- package/dist/controls/segmented-control.module.js.map +1 -0
- package/dist/controls/segmented-control.states.js +117 -0
- package/dist/controls/segmented-control.states.js.map +1 -0
- package/dist/controls/select.css +1 -0
- package/dist/controls/select.module.js +23 -0
- package/dist/controls/select.module.js.map +1 -0
- package/dist/controls/select.states.js +232 -0
- package/dist/controls/select.states.js.map +1 -0
- package/dist/controls/slider.css +1 -0
- package/dist/controls/slider.module.js +15 -0
- package/dist/controls/slider.module.js.map +1 -0
- package/dist/controls/slider.states.js +105 -0
- package/dist/controls/slider.states.js.map +1 -0
- package/dist/controls/split-button.css +1 -0
- package/dist/controls/split-button.module.js +29 -0
- package/dist/controls/split-button.module.js.map +1 -0
- package/dist/controls/split-button.states.js +158 -0
- package/dist/controls/split-button.states.js.map +1 -0
- package/dist/controls/switch.css +1 -0
- package/dist/controls/switch.module.js +13 -0
- package/dist/controls/switch.module.js.map +1 -0
- package/dist/controls/switch.states.js +90 -0
- package/dist/controls/switch.states.js.map +1 -0
- package/dist/controls/tag-input.css +1 -0
- package/dist/controls/tag-input.module.js +18 -0
- package/dist/controls/tag-input.module.js.map +1 -0
- package/dist/controls/tag-input.states.js +115 -0
- package/dist/controls/tag-input.states.js.map +1 -0
- package/dist/controls/textarea.css +1 -0
- package/dist/controls/textarea.module.js +8 -0
- package/dist/controls/textarea.module.js.map +1 -0
- package/dist/controls/textarea.states.js +120 -0
- package/dist/controls/textarea.states.js.map +1 -0
- package/dist/controls/time-input.css +1 -0
- package/dist/controls/time-input.module.js +13 -0
- package/dist/controls/time-input.module.js.map +1 -0
- package/dist/controls/time-input.states.js +84 -0
- package/dist/controls/time-input.states.js.map +1 -0
- package/dist/controls/tree-select.css +1 -0
- package/dist/controls/tree-select.module.js +17 -0
- package/dist/controls/tree-select.module.js.map +1 -0
- package/dist/controls/tree-select.states.js +269 -0
- package/dist/controls/tree-select.states.js.map +1 -0
- package/dist/conventions/FixtureBox.js +14 -0
- package/dist/conventions/FixtureBox.js.map +1 -0
- package/dist/conventions/PageTransitions.js +97 -0
- package/dist/conventions/PageTransitions.js.map +1 -0
- package/dist/conventions/fixture-box.css +1 -0
- package/dist/conventions/fixture-box.module.js +8 -0
- package/dist/conventions/fixture-box.module.js.map +1 -0
- package/dist/conventions/icon.states.js +115 -0
- package/dist/conventions/icon.states.js.map +1 -0
- package/dist/conventions/page-transitions.css +1 -0
- package/dist/conventions/page-transitions.module.js +14 -0
- package/dist/conventions/page-transitions.module.js.map +1 -0
- package/dist/exceptions/Bespoke.js +14 -0
- package/dist/exceptions/Bespoke.js.map +1 -0
- package/dist/exceptions/Scopes.js +13 -0
- package/dist/exceptions/Scopes.js.map +1 -0
- package/dist/exceptions/ThirdParty.js +15 -0
- package/dist/exceptions/ThirdParty.js.map +1 -0
- package/dist/exceptions/bespoke.css +1 -0
- package/dist/exceptions/bespoke.module.js +8 -0
- package/dist/exceptions/bespoke.module.js.map +1 -0
- package/dist/exceptions/third-party.css +1 -0
- package/dist/exceptions/third-party.module.js +8 -0
- package/dist/exceptions/third-party.module.js.map +1 -0
- package/dist/galleries.js +289 -0
- package/dist/galleries.js.map +1 -0
- package/dist/identity-signup.js +4 -0
- package/dist/identity.js +15 -0
- package/dist/index.js +148 -0
- package/dist/layout/Grid.js +17 -0
- package/dist/layout/Grid.js.map +1 -0
- package/dist/layout/Inline.js +18 -0
- package/dist/layout/Inline.js.map +1 -0
- package/dist/layout/SplitPane.js +147 -0
- package/dist/layout/SplitPane.js.map +1 -0
- package/dist/layout/Stack.js +17 -0
- package/dist/layout/Stack.js.map +1 -0
- package/dist/layout/grid.states.js +59 -0
- package/dist/layout/grid.states.js.map +1 -0
- package/dist/layout/inline.states.js +74 -0
- package/dist/layout/inline.states.js.map +1 -0
- package/dist/layout/layout.css +1 -0
- package/dist/layout/layout.module.js +13 -0
- package/dist/layout/layout.module.js.map +1 -0
- package/dist/layout/split-pane.css +1 -0
- package/dist/layout/split-pane.module.js +13 -0
- package/dist/layout/split-pane.module.js.map +1 -0
- package/dist/layout/split-pane.states.js +72 -0
- package/dist/layout/split-pane.states.js.map +1 -0
- package/dist/layout/stack.states.js +86 -0
- package/dist/layout/stack.states.js.map +1 -0
- package/dist/no-stylesheet.js +1 -0
- package/dist/overlays/Command.js +292 -0
- package/dist/overlays/Command.js.map +1 -0
- package/dist/overlays/ConfirmDialog.js +91 -0
- package/dist/overlays/ConfirmDialog.js.map +1 -0
- package/dist/overlays/ContextMenu.js +97 -0
- package/dist/overlays/ContextMenu.js.map +1 -0
- package/dist/overlays/Dialog.js +120 -0
- package/dist/overlays/Dialog.js.map +1 -0
- package/dist/overlays/Drawer.js +104 -0
- package/dist/overlays/Drawer.js.map +1 -0
- package/dist/overlays/HoverCard.js +52 -0
- package/dist/overlays/HoverCard.js.map +1 -0
- package/dist/overlays/Lightbox.js +165 -0
- package/dist/overlays/Lightbox.js.map +1 -0
- package/dist/overlays/Menu.js +110 -0
- package/dist/overlays/Menu.js.map +1 -0
- package/dist/overlays/Menubar.js +139 -0
- package/dist/overlays/Menubar.js.map +1 -0
- package/dist/overlays/Popover.js +79 -0
- package/dist/overlays/Popover.js.map +1 -0
- package/dist/overlays/Tabs.js +11 -0
- package/dist/overlays/Tabs.js.map +1 -0
- package/dist/overlays/ToastNotice.js +97 -0
- package/dist/overlays/ToastNotice.js.map +1 -0
- package/dist/overlays/Toaster.js +157 -0
- package/dist/overlays/Toaster.js.map +1 -0
- package/dist/overlays/Tooltip.js +58 -0
- package/dist/overlays/Tooltip.js.map +1 -0
- package/dist/overlays/Tour.js +11 -0
- package/dist/overlays/Tour.js.map +1 -0
- package/dist/overlays/command.css +1 -0
- package/dist/overlays/command.module.js +28 -0
- package/dist/overlays/command.module.js.map +1 -0
- package/dist/overlays/command.states.js +233 -0
- package/dist/overlays/command.states.js.map +1 -0
- package/dist/overlays/confirm-dialog.states.js +126 -0
- package/dist/overlays/confirm-dialog.states.js.map +1 -0
- package/dist/overlays/context-menu.css +1 -0
- package/dist/overlays/context-menu.module.js +23 -0
- package/dist/overlays/context-menu.module.js.map +1 -0
- package/dist/overlays/context-menu.states.js +112 -0
- package/dist/overlays/context-menu.states.js.map +1 -0
- package/dist/overlays/dialog.css +1 -0
- package/dist/overlays/dialog.module.js +19 -0
- package/dist/overlays/dialog.module.js.map +1 -0
- package/dist/overlays/dialog.states.js +158 -0
- package/dist/overlays/dialog.states.js.map +1 -0
- package/dist/overlays/drawer.css +1 -0
- package/dist/overlays/drawer.module.js +19 -0
- package/dist/overlays/drawer.module.js.map +1 -0
- package/dist/overlays/drawer.states.js +138 -0
- package/dist/overlays/drawer.states.js.map +1 -0
- package/dist/overlays/hover-card.css +1 -0
- package/dist/overlays/hover-card.module.js +13 -0
- package/dist/overlays/hover-card.module.js.map +1 -0
- package/dist/overlays/hover-card.states.js +96 -0
- package/dist/overlays/hover-card.states.js.map +1 -0
- package/dist/overlays/lightbox.css +1 -0
- package/dist/overlays/lightbox.module.js +18 -0
- package/dist/overlays/lightbox.module.js.map +1 -0
- package/dist/overlays/lightbox.states.js +118 -0
- package/dist/overlays/lightbox.states.js.map +1 -0
- package/dist/overlays/menu-rows.js +88 -0
- package/dist/overlays/menu-rows.js.map +1 -0
- package/dist/overlays/menu.css +1 -0
- package/dist/overlays/menu.module.js +22 -0
- package/dist/overlays/menu.module.js.map +1 -0
- package/dist/overlays/menu.states.js +195 -0
- package/dist/overlays/menu.states.js.map +1 -0
- package/dist/overlays/menubar.css +1 -0
- package/dist/overlays/menubar.module.js +22 -0
- package/dist/overlays/menubar.module.js.map +1 -0
- package/dist/overlays/menubar.states.js +234 -0
- package/dist/overlays/menubar.states.js.map +1 -0
- package/dist/overlays/modal-focus.js +21 -0
- package/dist/overlays/modal-focus.js.map +1 -0
- package/dist/overlays/popover.css +1 -0
- package/dist/overlays/popover.module.js +13 -0
- package/dist/overlays/popover.module.js.map +1 -0
- package/dist/overlays/popover.states.js +96 -0
- package/dist/overlays/popover.states.js.map +1 -0
- package/dist/overlays/sheet-menu.js +124 -0
- package/dist/overlays/sheet-menu.js.map +1 -0
- package/dist/overlays/sheet.css +1 -0
- package/dist/overlays/sheet.js +80 -0
- package/dist/overlays/sheet.js.map +1 -0
- package/dist/overlays/sheet.module.js +12 -0
- package/dist/overlays/sheet.module.js.map +1 -0
- package/dist/overlays/tabs-parts.js +141 -0
- package/dist/overlays/tabs-parts.js.map +1 -0
- package/dist/overlays/tabs.css +1 -0
- package/dist/overlays/tabs.module.js +21 -0
- package/dist/overlays/tabs.module.js.map +1 -0
- package/dist/overlays/tabs.states.js +185 -0
- package/dist/overlays/tabs.states.js.map +1 -0
- package/dist/overlays/toast-store.js +7 -0
- package/dist/overlays/toast-store.js.map +1 -0
- package/dist/overlays/toast.css +1 -0
- package/dist/overlays/toast.module.js +19 -0
- package/dist/overlays/toast.module.js.map +1 -0
- package/dist/overlays/toast.states.js +211 -0
- package/dist/overlays/toast.states.js.map +1 -0
- package/dist/overlays/tooltip.css +1 -0
- package/dist/overlays/tooltip.module.js +11 -0
- package/dist/overlays/tooltip.module.js.map +1 -0
- package/dist/overlays/tooltip.states.js +107 -0
- package/dist/overlays/tooltip.states.js.map +1 -0
- package/dist/overlays/tour-parts.js +201 -0
- package/dist/overlays/tour-parts.js.map +1 -0
- package/dist/overlays/tour.css +1 -0
- package/dist/overlays/tour.module.js +20 -0
- package/dist/overlays/tour.module.js.map +1 -0
- package/dist/overlays/tour.states.js +130 -0
- package/dist/overlays/tour.states.js.map +1 -0
- package/dist/overlays/trigger-anchor.css +1 -0
- package/dist/overlays/trigger-anchor.js +53 -0
- package/dist/overlays/trigger-anchor.js.map +1 -0
- package/dist/overlays/trigger-anchor.module.js +8 -0
- package/dist/overlays/trigger-anchor.module.js.map +1 -0
- package/dist/structure/Accordion.js +96 -0
- package/dist/structure/Accordion.js.map +1 -0
- package/dist/structure/Alert.js +105 -0
- package/dist/structure/Alert.js.map +1 -0
- package/dist/structure/AudioPlayer.js +127 -0
- package/dist/structure/AudioPlayer.js.map +1 -0
- package/dist/structure/Avatar.js +12 -0
- package/dist/structure/Avatar.js.map +1 -0
- package/dist/structure/Badge.js +58 -0
- package/dist/structure/Badge.js.map +1 -0
- package/dist/structure/Banner.js +72 -0
- package/dist/structure/Banner.js.map +1 -0
- package/dist/structure/Breadcrumbs.js +126 -0
- package/dist/structure/Breadcrumbs.js.map +1 -0
- package/dist/structure/Card.js +51 -0
- package/dist/structure/Card.js.map +1 -0
- package/dist/structure/Carousel.js +132 -0
- package/dist/structure/Carousel.js.map +1 -0
- package/dist/structure/Code.js +15 -0
- package/dist/structure/Code.js.map +1 -0
- package/dist/structure/CodeBlock.js +63 -0
- package/dist/structure/CodeBlock.js.map +1 -0
- package/dist/structure/Collapsible.js +56 -0
- package/dist/structure/Collapsible.js.map +1 -0
- package/dist/structure/CommentThread.js +11 -0
- package/dist/structure/CommentThread.js.map +1 -0
- package/dist/structure/Countdown.js +70 -0
- package/dist/structure/Countdown.js.map +1 -0
- package/dist/structure/CursorPagination.js +111 -0
- package/dist/structure/CursorPagination.js.map +1 -0
- package/dist/structure/DataTable.js +231 -0
- package/dist/structure/DataTable.js.map +1 -0
- package/dist/structure/DescriptionList.js +25 -0
- package/dist/structure/DescriptionList.js.map +1 -0
- package/dist/structure/Diff.js +158 -0
- package/dist/structure/Diff.js.map +1 -0
- package/dist/structure/EmptyState.js +42 -0
- package/dist/structure/EmptyState.js.map +1 -0
- package/dist/structure/ErrorSummary.js +54 -0
- package/dist/structure/ErrorSummary.js.map +1 -0
- package/dist/structure/FilterBar.js +63 -0
- package/dist/structure/FilterBar.js.map +1 -0
- package/dist/structure/Heading.js +17 -0
- package/dist/structure/Heading.js.map +1 -0
- package/dist/structure/Hero.js +32 -0
- package/dist/structure/Hero.js.map +1 -0
- package/dist/structure/Highlight.js +24 -0
- package/dist/structure/Highlight.js.map +1 -0
- package/dist/structure/Image.js +50 -0
- package/dist/structure/Image.js.map +1 -0
- package/dist/structure/JsonTree.js +140 -0
- package/dist/structure/JsonTree.js.map +1 -0
- package/dist/structure/Kbd.js +15 -0
- package/dist/structure/Kbd.js.map +1 -0
- package/dist/structure/List.js +11 -0
- package/dist/structure/List.js.map +1 -0
- package/dist/structure/LogView.js +95 -0
- package/dist/structure/LogView.js.map +1 -0
- package/dist/structure/Meter.js +53 -0
- package/dist/structure/Meter.js.map +1 -0
- package/dist/structure/PageHeader.js +37 -0
- package/dist/structure/PageHeader.js.map +1 -0
- package/dist/structure/Pagination.js +95 -0
- package/dist/structure/Pagination.js.map +1 -0
- package/dist/structure/Progress.js +51 -0
- package/dist/structure/Progress.js.map +1 -0
- package/dist/structure/QRCode.js +33 -0
- package/dist/structure/QRCode.js.map +1 -0
- package/dist/structure/RelativeTime.js +21 -0
- package/dist/structure/RelativeTime.js.map +1 -0
- package/dist/structure/ScrollArea.js +55 -0
- package/dist/structure/ScrollArea.js.map +1 -0
- package/dist/structure/SectionNav.js +69 -0
- package/dist/structure/SectionNav.js.map +1 -0
- package/dist/structure/Separator.js +28 -0
- package/dist/structure/Separator.js.map +1 -0
- package/dist/structure/SettingsRow.js +11 -0
- package/dist/structure/SettingsRow.js.map +1 -0
- package/dist/structure/Skeleton.js +22 -0
- package/dist/structure/Skeleton.js.map +1 -0
- package/dist/structure/Spinner.js +26 -0
- package/dist/structure/Spinner.js.map +1 -0
- package/dist/structure/Stat.js +89 -0
- package/dist/structure/Stat.js.map +1 -0
- package/dist/structure/Stepper.js +100 -0
- package/dist/structure/Stepper.js.map +1 -0
- package/dist/structure/Table.js +11 -0
- package/dist/structure/Table.js.map +1 -0
- package/dist/structure/TableOfContents.js +80 -0
- package/dist/structure/TableOfContents.js.map +1 -0
- package/dist/structure/Text.js +20 -0
- package/dist/structure/Text.js.map +1 -0
- package/dist/structure/Timeline.js +47 -0
- package/dist/structure/Timeline.js.map +1 -0
- package/dist/structure/Tree.js +187 -0
- package/dist/structure/Tree.js.map +1 -0
- package/dist/structure/accordion.css +1 -0
- package/dist/structure/accordion.module.js +21 -0
- package/dist/structure/accordion.module.js.map +1 -0
- package/dist/structure/accordion.states.js +88 -0
- package/dist/structure/accordion.states.js.map +1 -0
- package/dist/structure/alert.css +1 -0
- package/dist/structure/alert.module.js +17 -0
- package/dist/structure/alert.module.js.map +1 -0
- package/dist/structure/alert.states.js +138 -0
- package/dist/structure/alert.states.js.map +1 -0
- package/dist/structure/audio-player.css +1 -0
- package/dist/structure/audio-player.module.js +15 -0
- package/dist/structure/audio-player.module.js.map +1 -0
- package/dist/structure/audio-player.states.js +81 -0
- package/dist/structure/audio-player.states.js.map +1 -0
- package/dist/structure/avatar-parts.js +52 -0
- package/dist/structure/avatar-parts.js.map +1 -0
- package/dist/structure/avatar.css +1 -0
- package/dist/structure/avatar.module.js +14 -0
- package/dist/structure/avatar.module.js.map +1 -0
- package/dist/structure/avatar.states.js +121 -0
- package/dist/structure/avatar.states.js.map +1 -0
- package/dist/structure/badge.css +1 -0
- package/dist/structure/badge.module.js +12 -0
- package/dist/structure/badge.module.js.map +1 -0
- package/dist/structure/badge.states.js +100 -0
- package/dist/structure/badge.states.js.map +1 -0
- package/dist/structure/banner.css +1 -0
- package/dist/structure/banner.module.js +15 -0
- package/dist/structure/banner.module.js.map +1 -0
- package/dist/structure/banner.states.js +95 -0
- package/dist/structure/banner.states.js.map +1 -0
- package/dist/structure/breadcrumbs.css +1 -0
- package/dist/structure/breadcrumbs.module.js +14 -0
- package/dist/structure/breadcrumbs.module.js.map +1 -0
- package/dist/structure/breadcrumbs.states.js +98 -0
- package/dist/structure/breadcrumbs.states.js.map +1 -0
- package/dist/structure/card.css +1 -0
- package/dist/structure/card.module.js +12 -0
- package/dist/structure/card.module.js.map +1 -0
- package/dist/structure/card.states.js +89 -0
- package/dist/structure/card.states.js.map +1 -0
- package/dist/structure/carousel.css +1 -0
- package/dist/structure/carousel.module.js +14 -0
- package/dist/structure/carousel.module.js.map +1 -0
- package/dist/structure/carousel.states.js +99 -0
- package/dist/structure/carousel.states.js.map +1 -0
- package/dist/structure/code-block.css +1 -0
- package/dist/structure/code-block.module.js +14 -0
- package/dist/structure/code-block.module.js.map +1 -0
- package/dist/structure/code-block.states.js +35 -0
- package/dist/structure/code-block.states.js.map +1 -0
- package/dist/structure/code.css +1 -0
- package/dist/structure/code.module.js +8 -0
- package/dist/structure/code.module.js.map +1 -0
- package/dist/structure/code.states.js +52 -0
- package/dist/structure/code.states.js.map +1 -0
- package/dist/structure/collapsible.css +1 -0
- package/dist/structure/collapsible.module.js +19 -0
- package/dist/structure/collapsible.module.js.map +1 -0
- package/dist/structure/collapsible.states.js +55 -0
- package/dist/structure/collapsible.states.js.map +1 -0
- package/dist/structure/comment-thread-parts.js +80 -0
- package/dist/structure/comment-thread-parts.js.map +1 -0
- package/dist/structure/comment-thread.css +1 -0
- package/dist/structure/comment-thread.module.js +23 -0
- package/dist/structure/comment-thread.module.js.map +1 -0
- package/dist/structure/comment-thread.states.js +223 -0
- package/dist/structure/comment-thread.states.js.map +1 -0
- package/dist/structure/countdown.css +1 -0
- package/dist/structure/countdown.module.js +12 -0
- package/dist/structure/countdown.module.js.map +1 -0
- package/dist/structure/countdown.states.js +93 -0
- package/dist/structure/countdown.states.js.map +1 -0
- package/dist/structure/cursor-pagination.css +1 -0
- package/dist/structure/cursor-pagination.module.js +12 -0
- package/dist/structure/cursor-pagination.module.js.map +1 -0
- package/dist/structure/cursor-pagination.states.js +180 -0
- package/dist/structure/cursor-pagination.states.js.map +1 -0
- package/dist/structure/data-table.css +1 -0
- package/dist/structure/data-table.module.js +19 -0
- package/dist/structure/data-table.module.js.map +1 -0
- package/dist/structure/data-table.states.js +219 -0
- package/dist/structure/data-table.states.js.map +1 -0
- package/dist/structure/description-list.css +1 -0
- package/dist/structure/description-list.module.js +13 -0
- package/dist/structure/description-list.module.js.map +1 -0
- package/dist/structure/description-list.states.js +70 -0
- package/dist/structure/description-list.states.js.map +1 -0
- package/dist/structure/diff.css +1 -0
- package/dist/structure/diff.module.js +23 -0
- package/dist/structure/diff.module.js.map +1 -0
- package/dist/structure/diff.states.js +190 -0
- package/dist/structure/diff.states.js.map +1 -0
- package/dist/structure/empty-state.css +1 -0
- package/dist/structure/empty-state.module.js +14 -0
- package/dist/structure/empty-state.module.js.map +1 -0
- package/dist/structure/empty-state.states.js +68 -0
- package/dist/structure/empty-state.states.js.map +1 -0
- package/dist/structure/error-summary.css +1 -0
- package/dist/structure/error-summary.module.js +15 -0
- package/dist/structure/error-summary.module.js.map +1 -0
- package/dist/structure/error-summary.states.js +60 -0
- package/dist/structure/error-summary.states.js.map +1 -0
- package/dist/structure/filter-bar.css +1 -0
- package/dist/structure/filter-bar.module.js +13 -0
- package/dist/structure/filter-bar.module.js.map +1 -0
- package/dist/structure/filter-bar.states.js +140 -0
- package/dist/structure/filter-bar.states.js.map +1 -0
- package/dist/structure/grid-keyboard.js +196 -0
- package/dist/structure/grid-keyboard.js.map +1 -0
- package/dist/structure/heading.css +1 -0
- package/dist/structure/heading.module.js +8 -0
- package/dist/structure/heading.module.js.map +1 -0
- package/dist/structure/heading.states.js +56 -0
- package/dist/structure/heading.states.js.map +1 -0
- package/dist/structure/hero.css +1 -0
- package/dist/structure/hero.module.js +12 -0
- package/dist/structure/hero.module.js.map +1 -0
- package/dist/structure/hero.states.js +51 -0
- package/dist/structure/hero.states.js.map +1 -0
- package/dist/structure/highlight.css +1 -0
- package/dist/structure/highlight.module.js +11 -0
- package/dist/structure/highlight.module.js.map +1 -0
- package/dist/structure/highlight.states.js +102 -0
- package/dist/structure/highlight.states.js.map +1 -0
- package/dist/structure/image.css +1 -0
- package/dist/structure/image.module.js +13 -0
- package/dist/structure/image.module.js.map +1 -0
- package/dist/structure/image.states.js +140 -0
- package/dist/structure/image.states.js.map +1 -0
- package/dist/structure/json-tree.css +1 -0
- package/dist/structure/json-tree.module.js +18 -0
- package/dist/structure/json-tree.module.js.map +1 -0
- package/dist/structure/json-tree.states.js +88 -0
- package/dist/structure/json-tree.states.js.map +1 -0
- package/dist/structure/kbd.css +1 -0
- package/dist/structure/kbd.module.js +8 -0
- package/dist/structure/kbd.module.js.map +1 -0
- package/dist/structure/kbd.states.js +60 -0
- package/dist/structure/kbd.states.js.map +1 -0
- package/dist/structure/list-parts.js +79 -0
- package/dist/structure/list-parts.js.map +1 -0
- package/dist/structure/list.css +1 -0
- package/dist/structure/list.module.js +18 -0
- package/dist/structure/list.module.js.map +1 -0
- package/dist/structure/list.states.js +127 -0
- package/dist/structure/list.states.js.map +1 -0
- package/dist/structure/log-view.css +1 -0
- package/dist/structure/log-view.module.js +24 -0
- package/dist/structure/log-view.module.js.map +1 -0
- package/dist/structure/log-view.states.js +182 -0
- package/dist/structure/log-view.states.js.map +1 -0
- package/dist/structure/meter.css +1 -0
- package/dist/structure/meter.module.js +15 -0
- package/dist/structure/meter.module.js.map +1 -0
- package/dist/structure/meter.states.js +118 -0
- package/dist/structure/meter.states.js.map +1 -0
- package/dist/structure/page-header.css +1 -0
- package/dist/structure/page-header.module.js +15 -0
- package/dist/structure/page-header.module.js.map +1 -0
- package/dist/structure/page-header.states.js +88 -0
- package/dist/structure/page-header.states.js.map +1 -0
- package/dist/structure/pager-focus.js +33 -0
- package/dist/structure/pager-focus.js.map +1 -0
- package/dist/structure/pagination.css +1 -0
- package/dist/structure/pagination.module.js +11 -0
- package/dist/structure/pagination.module.js.map +1 -0
- package/dist/structure/pagination.states.js +83 -0
- package/dist/structure/pagination.states.js.map +1 -0
- package/dist/structure/progress.css +1 -0
- package/dist/structure/progress.module.js +15 -0
- package/dist/structure/progress.module.js.map +1 -0
- package/dist/structure/progress.states.js +137 -0
- package/dist/structure/progress.states.js.map +1 -0
- package/dist/structure/qr-code.css +1 -0
- package/dist/structure/qr-code.module.js +12 -0
- package/dist/structure/qr-code.module.js.map +1 -0
- package/dist/structure/qr-code.states.js +59 -0
- package/dist/structure/qr-code.states.js.map +1 -0
- package/dist/structure/relative-time.states.js +77 -0
- package/dist/structure/relative-time.states.js.map +1 -0
- package/dist/structure/scroll-area.css +1 -0
- package/dist/structure/scroll-area.module.js +21 -0
- package/dist/structure/scroll-area.module.js.map +1 -0
- package/dist/structure/scroll-area.states.js +107 -0
- package/dist/structure/scroll-area.states.js.map +1 -0
- package/dist/structure/section-nav.css +1 -0
- package/dist/structure/section-nav.module.js +14 -0
- package/dist/structure/section-nav.module.js.map +1 -0
- package/dist/structure/section-nav.states.js +103 -0
- package/dist/structure/section-nav.states.js.map +1 -0
- package/dist/structure/separator.css +1 -0
- package/dist/structure/separator.module.js +13 -0
- package/dist/structure/separator.module.js.map +1 -0
- package/dist/structure/separator.states.js +69 -0
- package/dist/structure/separator.states.js.map +1 -0
- package/dist/structure/settings-row-parts.js +48 -0
- package/dist/structure/settings-row-parts.js.map +1 -0
- package/dist/structure/settings-row.css +1 -0
- package/dist/structure/settings-row.module.js +17 -0
- package/dist/structure/settings-row.module.js.map +1 -0
- package/dist/structure/settings-row.states.js +91 -0
- package/dist/structure/settings-row.states.js.map +1 -0
- package/dist/structure/skeleton.css +1 -0
- package/dist/structure/skeleton.module.js +8 -0
- package/dist/structure/skeleton.module.js.map +1 -0
- package/dist/structure/skeleton.states.js +85 -0
- package/dist/structure/skeleton.states.js.map +1 -0
- package/dist/structure/spinner.css +1 -0
- package/dist/structure/spinner.module.js +12 -0
- package/dist/structure/spinner.module.js.map +1 -0
- package/dist/structure/spinner.states.js +68 -0
- package/dist/structure/spinner.states.js.map +1 -0
- package/dist/structure/stat.css +1 -0
- package/dist/structure/stat.module.js +24 -0
- package/dist/structure/stat.module.js.map +1 -0
- package/dist/structure/stat.states.js +143 -0
- package/dist/structure/stat.states.js.map +1 -0
- package/dist/structure/stepper.css +1 -0
- package/dist/structure/stepper.module.js +20 -0
- package/dist/structure/stepper.module.js.map +1 -0
- package/dist/structure/stepper.states.js +104 -0
- package/dist/structure/stepper.states.js.map +1 -0
- package/dist/structure/table-of-contents.css +1 -0
- package/dist/structure/table-of-contents.module.js +19 -0
- package/dist/structure/table-of-contents.module.js.map +1 -0
- package/dist/structure/table-of-contents.states.js +178 -0
- package/dist/structure/table-of-contents.states.js.map +1 -0
- package/dist/structure/table-parts.js +136 -0
- package/dist/structure/table-parts.js.map +1 -0
- package/dist/structure/table.css +1 -0
- package/dist/structure/table.module.js +20 -0
- package/dist/structure/table.module.js.map +1 -0
- package/dist/structure/table.states.js +160 -0
- package/dist/structure/table.states.js.map +1 -0
- package/dist/structure/text.css +1 -0
- package/dist/structure/text.module.js +8 -0
- package/dist/structure/text.module.js.map +1 -0
- package/dist/structure/text.states.js +102 -0
- package/dist/structure/text.states.js.map +1 -0
- package/dist/structure/timeline.css +1 -0
- package/dist/structure/timeline.module.js +17 -0
- package/dist/structure/timeline.module.js.map +1 -0
- package/dist/structure/timeline.states.js +108 -0
- package/dist/structure/timeline.states.js.map +1 -0
- package/dist/structure/tree-keyboard.js +120 -0
- package/dist/structure/tree-keyboard.js.map +1 -0
- package/dist/structure/tree.css +1 -0
- package/dist/structure/tree.module.js +22 -0
- package/dist/structure/tree.module.js.map +1 -0
- package/dist/structure/tree.states.js +167 -0
- package/dist/structure/tree.states.js.map +1 -0
- package/dist/types/ai/ApprovalCard.d.ts +50 -0
- package/dist/types/ai/ArtifactPane.d.ts +55 -0
- package/dist/types/ai/AttachmentChip.d.ts +41 -0
- package/dist/types/ai/ChatMessage.d.ts +45 -0
- package/dist/types/ai/ChatThread.d.ts +44 -0
- package/dist/types/ai/Citation.d.ts +28 -0
- package/dist/types/ai/Markdown.d.ts +43 -0
- package/dist/types/ai/Plan.d.ts +43 -0
- package/dist/types/ai/PromptInput.d.ts +150 -0
- package/dist/types/ai/ReasoningDisclosure.d.ts +35 -0
- package/dist/types/ai/SourceList.d.ts +26 -0
- package/dist/types/ai/StreamingText.d.ts +34 -0
- package/dist/types/ai/ToolCall.d.ts +54 -0
- package/dist/types/ai/approval-card.states.d.ts +2 -0
- package/dist/types/ai/artifact-pane.states.d.ts +2 -0
- package/dist/types/ai/attachment-chip.states.d.ts +3 -0
- package/dist/types/ai/chat-message.states.d.ts +4 -0
- package/dist/types/ai/chat-thread.states.d.ts +11 -0
- package/dist/types/ai/citation.states.d.ts +5 -0
- package/dist/types/ai/markdown.states.d.ts +9 -0
- package/dist/types/ai/plan.states.d.ts +2 -0
- package/dist/types/ai/prompt-input.states.d.ts +5 -0
- package/dist/types/ai/reasoning-disclosure.states.d.ts +2 -0
- package/dist/types/ai/source-list.states.d.ts +5 -0
- package/dist/types/ai/sources.d.ts +21 -0
- package/dist/types/ai/streaming-text.states.d.ts +2 -0
- package/dist/types/ai/tool-call.states.d.ts +2 -0
- package/dist/types/archetypes/AppShell.d.ts +29 -0
- package/dist/types/archetypes/AuthPage.d.ts +52 -0
- package/dist/types/archetypes/ConversationPage.d.ts +49 -0
- package/dist/types/archetypes/Dashboard.d.ts +48 -0
- package/dist/types/archetypes/DetailPage.d.ts +50 -0
- package/dist/types/archetypes/FormPage.d.ts +22 -0
- package/dist/types/archetypes/ListPage.d.ts +40 -0
- package/dist/types/archetypes/MasterDetailPage.d.ts +47 -0
- package/dist/types/archetypes/SearchPage.d.ts +45 -0
- package/dist/types/archetypes/SettingsPage.d.ts +19 -0
- package/dist/types/archetypes/app-shell-parts.d.ts +181 -0
- package/dist/types/archetypes/app-shell.states.d.ts +2 -0
- package/dist/types/archetypes/auth-page.states.d.ts +2 -0
- package/dist/types/archetypes/conversation-page.states.d.ts +2 -0
- package/dist/types/archetypes/dashboard.states.d.ts +2 -0
- package/dist/types/archetypes/detail-page.states.d.ts +2 -0
- package/dist/types/archetypes/form-page.states.d.ts +2 -0
- package/dist/types/archetypes/list-page.states.d.ts +2 -0
- package/dist/types/archetypes/master-detail-page.states.d.ts +2 -0
- package/dist/types/archetypes/search-page.states.d.ts +2 -0
- package/dist/types/archetypes/settings-page.states.d.ts +2 -0
- package/dist/types/charts/AreaChart.d.ts +35 -0
- package/dist/types/charts/BarChart.d.ts +45 -0
- package/dist/types/charts/DonutChart.d.ts +43 -0
- package/dist/types/charts/FunnelChart.d.ts +39 -0
- package/dist/types/charts/Heatmap.d.ts +49 -0
- package/dist/types/charts/Histogram.d.ts +65 -0
- package/dist/types/charts/LineChart.d.ts +47 -0
- package/dist/types/charts/RadarChart.d.ts +73 -0
- package/dist/types/charts/ScatterChart.d.ts +68 -0
- package/dist/types/charts/Sparkline.d.ts +34 -0
- package/dist/types/charts/Treemap.d.ts +35 -0
- package/dist/types/charts/area-chart.states.d.ts +2 -0
- package/dist/types/charts/bar-chart.states.d.ts +2 -0
- package/dist/types/charts/donut-chart.states.d.ts +2 -0
- package/dist/types/charts/frame/ChartAnnotations.d.ts +26 -0
- package/dist/types/charts/frame/ChartAxis.d.ts +29 -0
- package/dist/types/charts/frame/ChartBrush.d.ts +17 -0
- package/dist/types/charts/frame/ChartFrame.d.ts +91 -0
- package/dist/types/charts/frame/ChartLegend.d.ts +51 -0
- package/dist/types/charts/frame/ChartScaleLegend.d.ts +33 -0
- package/dist/types/charts/frame/ChartTooltip.d.ts +36 -0
- package/dist/types/charts/frame/ChartTwin.d.ts +38 -0
- package/dist/types/charts/frame/use-brush.d.ts +36 -0
- package/dist/types/charts/frame/use-chart-cap.d.ts +10 -0
- package/dist/types/charts/frame/use-measured-box.d.ts +18 -0
- package/dist/types/charts/frame/use-reading.d.ts +33 -0
- package/dist/types/charts/frame/use-sync.d.ts +16 -0
- package/dist/types/charts/funnel-chart.states.d.ts +2 -0
- package/dist/types/charts/heatmap.states.d.ts +2 -0
- package/dist/types/charts/histogram.states.d.ts +2 -0
- package/dist/types/charts/line-chart.states.d.ts +2 -0
- package/dist/types/charts/radar-chart.states.d.ts +2 -0
- package/dist/types/charts/scatter-chart.states.d.ts +2 -0
- package/dist/types/charts/sparkline.states.d.ts +3 -0
- package/dist/types/charts/treemap.states.d.ts +2 -0
- package/dist/types/controls/AvatarButton.d.ts +44 -0
- package/dist/types/controls/Button.d.ts +93 -0
- package/dist/types/controls/Calendar.d.ts +51 -0
- package/dist/types/controls/Checkbox.d.ts +38 -0
- package/dist/types/controls/CheckboxGroup.d.ts +47 -0
- package/dist/types/controls/ChoiceCard.d.ts +45 -0
- package/dist/types/controls/ColorInput.d.ts +41 -0
- package/dist/types/controls/Combobox.d.ts +110 -0
- package/dist/types/controls/CopyButton.d.ts +16 -0
- package/dist/types/controls/DatePicker.d.ts +135 -0
- package/dist/types/controls/DateRangePicker.d.ts +92 -0
- package/dist/types/controls/DurationInput.d.ts +60 -0
- package/dist/types/controls/FileUpload.d.ts +85 -0
- package/dist/types/controls/FormField.d.ts +47 -0
- package/dist/types/controls/ImageEditor.d.ts +61 -0
- package/dist/types/controls/InlineEdit.d.ts +71 -0
- package/dist/types/controls/Input.d.ts +107 -0
- package/dist/types/controls/Link.d.ts +70 -0
- package/dist/types/controls/ModeSwitch.d.ts +45 -0
- package/dist/types/controls/MonthInput.d.ts +56 -0
- package/dist/types/controls/MultiSelect.d.ts +148 -0
- package/dist/types/controls/NumberInput.d.ts +80 -0
- package/dist/types/controls/OTPInput.d.ts +54 -0
- package/dist/types/controls/PasswordInput.d.ts +43 -0
- package/dist/types/controls/PhoneInput.d.ts +67 -0
- package/dist/types/controls/ProviderButton.d.ts +43 -0
- package/dist/types/controls/Radio.d.ts +38 -0
- package/dist/types/controls/Rating.d.ts +67 -0
- package/dist/types/controls/RecordButton.d.ts +48 -0
- package/dist/types/controls/SearchInput.d.ts +37 -0
- package/dist/types/controls/SegmentedControl.d.ts +48 -0
- package/dist/types/controls/Select.d.ts +70 -0
- package/dist/types/controls/Slider.d.ts +42 -0
- package/dist/types/controls/SplitButton.d.ts +76 -0
- package/dist/types/controls/Switch.d.ts +35 -0
- package/dist/types/controls/TagInput.d.ts +47 -0
- package/dist/types/controls/Textarea.d.ts +87 -0
- package/dist/types/controls/TimeInput.d.ts +62 -0
- package/dist/types/controls/TreeSelect.d.ts +83 -0
- package/dist/types/controls/avatar-button.states.d.ts +2 -0
- package/dist/types/controls/button.states.d.ts +2 -0
- package/dist/types/controls/calendar.states.d.ts +2 -0
- package/dist/types/controls/checkbox-group.states.d.ts +2 -0
- package/dist/types/controls/checkbox.states.d.ts +9 -0
- package/dist/types/controls/choice-card.states.d.ts +2 -0
- package/dist/types/controls/color-input.states.d.ts +3 -0
- package/dist/types/controls/combobox.states.d.ts +2 -0
- package/dist/types/controls/copy-button.states.d.ts +3 -0
- package/dist/types/controls/date-picker.states.d.ts +2 -0
- package/dist/types/controls/date-range-picker.states.d.ts +2 -0
- package/dist/types/controls/date-segments.d.ts +54 -0
- package/dist/types/controls/duration-input.states.d.ts +2 -0
- package/dist/types/controls/file-upload.states.d.ts +2 -0
- package/dist/types/controls/form-field.states.d.ts +2 -0
- package/dist/types/controls/image-editor.geometry.d.ts +58 -0
- package/dist/types/controls/image-editor.states.d.ts +2 -0
- package/dist/types/controls/inline-edit.states.d.ts +2 -0
- package/dist/types/controls/input.states.d.ts +3 -0
- package/dist/types/controls/link.states.d.ts +3 -0
- package/dist/types/controls/mode-switch.states.d.ts +2 -0
- package/dist/types/controls/month-input.states.d.ts +2 -0
- package/dist/types/controls/multi-select.states.d.ts +2 -0
- package/dist/types/controls/navigate.d.ts +24 -0
- package/dist/types/controls/number-input.states.d.ts +10 -0
- package/dist/types/controls/otp-input.states.d.ts +8 -0
- package/dist/types/controls/password-input.states.d.ts +3 -0
- package/dist/types/controls/phone-input.states.d.ts +2 -0
- package/dist/types/controls/provider-button.states.d.ts +3 -0
- package/dist/types/controls/radio-arrows.d.ts +27 -0
- package/dist/types/controls/radio.states.d.ts +2 -0
- package/dist/types/controls/rating.states.d.ts +2 -0
- package/dist/types/controls/record-button.states.d.ts +2 -0
- package/dist/types/controls/search-input.states.d.ts +3 -0
- package/dist/types/controls/segmented-control.states.d.ts +2 -0
- package/dist/types/controls/select.states.d.ts +2 -0
- package/dist/types/controls/slider.states.d.ts +3 -0
- package/dist/types/controls/split-button.states.d.ts +2 -0
- package/dist/types/controls/switch.states.d.ts +3 -0
- package/dist/types/controls/tag-input.states.d.ts +2 -0
- package/dist/types/controls/textarea.states.d.ts +2 -0
- package/dist/types/controls/time-input.states.d.ts +2 -0
- package/dist/types/controls/token-probe.d.ts +16 -0
- package/dist/types/controls/tree-select.states.d.ts +2 -0
- package/dist/types/conventions/FixtureBox.d.ts +15 -0
- package/dist/types/conventions/PageTransitions.d.ts +14 -0
- package/dist/types/conventions/icon.states.d.ts +2 -0
- package/dist/types/exceptions/Bespoke.d.ts +25 -0
- package/dist/types/exceptions/Scopes.d.ts +38 -0
- package/dist/types/exceptions/ThirdParty.d.ts +35 -0
- package/dist/types/galleries.d.ts +12 -0
- package/dist/types/identity-signup.d.ts +4 -0
- package/dist/types/identity.d.ts +15 -0
- package/dist/types/index.d.ts +344 -0
- package/dist/types/layout/Grid.d.ts +24 -0
- package/dist/types/layout/Inline.d.ts +27 -0
- package/dist/types/layout/SplitPane.d.ts +43 -0
- package/dist/types/layout/Stack.d.ts +27 -0
- package/dist/types/layout/grid.states.d.ts +2 -0
- package/dist/types/layout/inline.states.d.ts +3 -0
- package/dist/types/layout/split-pane.states.d.ts +2 -0
- package/dist/types/layout/stack.states.d.ts +2 -0
- package/dist/types/overlays/Command.d.ts +50 -0
- package/dist/types/overlays/ConfirmDialog.d.ts +58 -0
- package/dist/types/overlays/ContextMenu.d.ts +57 -0
- package/dist/types/overlays/Dialog.d.ts +71 -0
- package/dist/types/overlays/Drawer.d.ts +52 -0
- package/dist/types/overlays/HoverCard.d.ts +43 -0
- package/dist/types/overlays/Lightbox.d.ts +62 -0
- package/dist/types/overlays/Menu.d.ts +83 -0
- package/dist/types/overlays/Menubar.d.ts +32 -0
- package/dist/types/overlays/Popover.d.ts +49 -0
- package/dist/types/overlays/Tabs.d.ts +34 -0
- package/dist/types/overlays/ToastNotice.d.ts +24 -0
- package/dist/types/overlays/Toaster.d.ts +9 -0
- package/dist/types/overlays/Tooltip.d.ts +44 -0
- package/dist/types/overlays/Tour.d.ts +30 -0
- package/dist/types/overlays/command.states.d.ts +2 -0
- package/dist/types/overlays/confirm-dialog.states.d.ts +2 -0
- package/dist/types/overlays/context-menu.states.d.ts +2 -0
- package/dist/types/overlays/dialog.states.d.ts +2 -0
- package/dist/types/overlays/drawer.states.d.ts +2 -0
- package/dist/types/overlays/hover-card.states.d.ts +2 -0
- package/dist/types/overlays/lightbox.states.d.ts +2 -0
- package/dist/types/overlays/menu-rows.d.ts +86 -0
- package/dist/types/overlays/menu.states.d.ts +2 -0
- package/dist/types/overlays/menubar.states.d.ts +2 -0
- package/dist/types/overlays/modal-focus.d.ts +39 -0
- package/dist/types/overlays/popover.states.d.ts +2 -0
- package/dist/types/overlays/sheet-menu.d.ts +93 -0
- package/dist/types/overlays/sheet.d.ts +37 -0
- package/dist/types/overlays/tabs-parts.d.ts +42 -0
- package/dist/types/overlays/tabs.states.d.ts +2 -0
- package/dist/types/overlays/toast-store.d.ts +33 -0
- package/dist/types/overlays/toast.states.d.ts +2 -0
- package/dist/types/overlays/tooltip.states.d.ts +2 -0
- package/dist/types/overlays/tour-parts.d.ts +66 -0
- package/dist/types/overlays/tour.states.d.ts +2 -0
- package/dist/types/overlays/trigger-anchor.d.ts +17 -0
- package/dist/types/structure/Accordion.d.ts +52 -0
- package/dist/types/structure/Alert.d.ts +23 -0
- package/dist/types/structure/AudioPlayer.d.ts +54 -0
- package/dist/types/structure/Avatar.d.ts +36 -0
- package/dist/types/structure/Badge.d.ts +42 -0
- package/dist/types/structure/Banner.d.ts +28 -0
- package/dist/types/structure/Breadcrumbs.d.ts +42 -0
- package/dist/types/structure/Card.d.ts +71 -0
- package/dist/types/structure/Carousel.d.ts +44 -0
- package/dist/types/structure/Code.d.ts +13 -0
- package/dist/types/structure/CodeBlock.d.ts +14 -0
- package/dist/types/structure/Collapsible.d.ts +30 -0
- package/dist/types/structure/CommentThread.d.ts +31 -0
- package/dist/types/structure/Countdown.d.ts +39 -0
- package/dist/types/structure/CursorPagination.d.ts +78 -0
- package/dist/types/structure/DataTable.d.ts +124 -0
- package/dist/types/structure/DescriptionList.d.ts +32 -0
- package/dist/types/structure/Diff.d.ts +56 -0
- package/dist/types/structure/EmptyState.d.ts +23 -0
- package/dist/types/structure/ErrorSummary.d.ts +30 -0
- package/dist/types/structure/FilterBar.d.ts +38 -0
- package/dist/types/structure/Heading.d.ts +29 -0
- package/dist/types/structure/Hero.d.ts +25 -0
- package/dist/types/structure/Highlight.d.ts +33 -0
- package/dist/types/structure/Image.d.ts +61 -0
- package/dist/types/structure/JsonTree.d.ts +28 -0
- package/dist/types/structure/Kbd.d.ts +12 -0
- package/dist/types/structure/List.d.ts +29 -0
- package/dist/types/structure/LogView.d.ts +58 -0
- package/dist/types/structure/Meter.d.ts +26 -0
- package/dist/types/structure/PageHeader.d.ts +32 -0
- package/dist/types/structure/Pagination.d.ts +43 -0
- package/dist/types/structure/Progress.d.ts +29 -0
- package/dist/types/structure/QRCode.d.ts +37 -0
- package/dist/types/structure/RelativeTime.d.ts +41 -0
- package/dist/types/structure/ScrollArea.d.ts +37 -0
- package/dist/types/structure/SectionNav.d.ts +39 -0
- package/dist/types/structure/Separator.d.ts +21 -0
- package/dist/types/structure/SettingsRow.d.ts +27 -0
- package/dist/types/structure/Skeleton.d.ts +42 -0
- package/dist/types/structure/Spinner.d.ts +16 -0
- package/dist/types/structure/Stat.d.ts +72 -0
- package/dist/types/structure/Stepper.d.ts +49 -0
- package/dist/types/structure/Table.d.ts +29 -0
- package/dist/types/structure/TableOfContents.d.ts +38 -0
- package/dist/types/structure/Text.d.ts +37 -0
- package/dist/types/structure/Timeline.d.ts +32 -0
- package/dist/types/structure/Tree.d.ts +75 -0
- package/dist/types/structure/accordion.states.d.ts +2 -0
- package/dist/types/structure/alert.states.d.ts +2 -0
- package/dist/types/structure/audio-player.states.d.ts +2 -0
- package/dist/types/structure/avatar-parts.d.ts +33 -0
- package/dist/types/structure/avatar.states.d.ts +2 -0
- package/dist/types/structure/badge.states.d.ts +8 -0
- package/dist/types/structure/banner.states.d.ts +2 -0
- package/dist/types/structure/breadcrumbs.states.d.ts +2 -0
- package/dist/types/structure/card.states.d.ts +2 -0
- package/dist/types/structure/carousel.states.d.ts +2 -0
- package/dist/types/structure/code-block.states.d.ts +2 -0
- package/dist/types/structure/code.states.d.ts +2 -0
- package/dist/types/structure/collapsible.states.d.ts +2 -0
- package/dist/types/structure/comment-thread-parts.d.ts +42 -0
- package/dist/types/structure/comment-thread.states.d.ts +2 -0
- package/dist/types/structure/countdown.states.d.ts +2 -0
- package/dist/types/structure/cursor-pagination.states.d.ts +2 -0
- package/dist/types/structure/data-table.states.d.ts +2 -0
- package/dist/types/structure/description-list.states.d.ts +2 -0
- package/dist/types/structure/diff.states.d.ts +2 -0
- package/dist/types/structure/empty-state.states.d.ts +3 -0
- package/dist/types/structure/error-summary.states.d.ts +3 -0
- package/dist/types/structure/filter-bar.states.d.ts +2 -0
- package/dist/types/structure/grid-keyboard.d.ts +2 -0
- package/dist/types/structure/heading.states.d.ts +8 -0
- package/dist/types/structure/hero.states.d.ts +2 -0
- package/dist/types/structure/highlight.states.d.ts +2 -0
- package/dist/types/structure/image.states.d.ts +2 -0
- package/dist/types/structure/json-tree.states.d.ts +2 -0
- package/dist/types/structure/kbd.states.d.ts +3 -0
- package/dist/types/structure/list-parts.d.ts +48 -0
- package/dist/types/structure/list.states.d.ts +2 -0
- package/dist/types/structure/log-view.states.d.ts +18 -0
- package/dist/types/structure/meter.states.d.ts +3 -0
- package/dist/types/structure/page-header.states.d.ts +2 -0
- package/dist/types/structure/pager-focus.d.ts +44 -0
- package/dist/types/structure/pagination.states.d.ts +2 -0
- package/dist/types/structure/progress.states.d.ts +3 -0
- package/dist/types/structure/qr-code.states.d.ts +2 -0
- package/dist/types/structure/relative-time.states.d.ts +2 -0
- package/dist/types/structure/scroll-area.states.d.ts +2 -0
- package/dist/types/structure/section-nav.states.d.ts +2 -0
- package/dist/types/structure/separator.states.d.ts +3 -0
- package/dist/types/structure/settings-row-parts.d.ts +22 -0
- package/dist/types/structure/settings-row.states.d.ts +2 -0
- package/dist/types/structure/skeleton.states.d.ts +3 -0
- package/dist/types/structure/spinner.states.d.ts +3 -0
- package/dist/types/structure/stat.states.d.ts +3 -0
- package/dist/types/structure/stepper.states.d.ts +2 -0
- package/dist/types/structure/table-of-contents.states.d.ts +2 -0
- package/dist/types/structure/table-parts.d.ts +96 -0
- package/dist/types/structure/table.states.d.ts +2 -0
- package/dist/types/structure/text.states.d.ts +3 -0
- package/dist/types/structure/timeline.states.d.ts +2 -0
- package/dist/types/structure/tree-keyboard.d.ts +15 -0
- package/dist/types/structure/tree.states.d.ts +2 -0
- package/package.json +75 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,1759 @@
|
|
|
1
|
+
# @polymorph/react-ui
|
|
2
|
+
|
|
3
|
+
## 1.0.16
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- @polymorph/react@1.0.16
|
|
8
|
+
- @polymorph/recipes@1.0.16
|
|
9
|
+
|
|
10
|
+
## 1.0.15
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- 57db696: **An `Alert` with nothing to say draws nothing.** An Alert given no title and no content drew an
|
|
15
|
+
empty tinted panel with its tone's glyph. It now renders nothing: no root, no panel and no glyph,
|
|
16
|
+
in every web framework, as an element, in SwiftUI and in Compose. A screen can therefore draw an
|
|
17
|
+
Alert always and bind its `title` to a message that is empty while there is none, as an
|
|
18
|
+
`ErrorSummary` with no errors already renders nothing.
|
|
19
|
+
|
|
20
|
+
- A title counts when it is not absent and not empty. An empty title with content draws the
|
|
21
|
+
content alone, where before it drew an empty title line above it.
|
|
22
|
+
- Content counts in React when `children` is a value React draws: not `undefined`, `null`, a
|
|
23
|
+
boolean or `''`. In Vue, Svelte, Solid, Angular and the elements it counts when the default
|
|
24
|
+
slot has content. In SwiftUI and Compose it counts when `children` is not `nil` or `null`.
|
|
25
|
+
- `action`, `secondaryAction` and `onDismiss` are not content: an Alert with only those renders
|
|
26
|
+
nothing too.
|
|
27
|
+
- `children` is optional: `AlertProps.children` in every web framework, and `PMAlertProps.children`
|
|
28
|
+
in the Swift and Kotlin contracts, which now default to `nil` and `null`. A title with no
|
|
29
|
+
content draws the title alone, with no gap under it.
|
|
30
|
+
- An Alert that draws nothing is not listed for an agent. Once its title or content arrives it is
|
|
31
|
+
drawn with its role on its root from that first render, so it is announced as an Alert mounted
|
|
32
|
+
in response to an event is, and it is listed.
|
|
33
|
+
|
|
34
|
+
An Alert with content, and a title that is absent or not empty, draws as before.
|
|
35
|
+
- @polymorph/react@1.0.15
|
|
36
|
+
- @polymorph/recipes@1.0.15
|
|
37
|
+
|
|
38
|
+
## 1.0.14
|
|
39
|
+
|
|
40
|
+
### Patch Changes
|
|
41
|
+
|
|
42
|
+
- 9b60a94: **`ScatterChart` reports nothing where it draws no point.** A row whose x, y or bubble value is
|
|
43
|
+
`null` draws no point for that series. The arrow keys still reach that position, and the live
|
|
44
|
+
region still says it, but Enter, Space and a click there no longer call `onSelect`. Before, they
|
|
45
|
+
called it with `{ index, key, datum }` for a point the plot did not draw. An agent does not list
|
|
46
|
+
such a position among the chart's `items`, and its `choose` refuses one. The engine's
|
|
47
|
+
`scatterChartSelection` returns `null` there, as `heatmapSelection` does at an absent cell.
|
|
48
|
+
|
|
49
|
+
**`BarChart` reports nothing at a walked bar that is not drawn.** With the reading walked to one
|
|
50
|
+
series (Up and Down) at a band where that series' value is `null`, Enter, Space or a click called
|
|
51
|
+
`onSelect` for a bar the plot does not draw. `barChartSelection` returns `null` there. A whole-band
|
|
52
|
+
reading reports the band as before.
|
|
53
|
+
|
|
54
|
+
**An agent action names the list it chooses among.** The agent fence's grammar has an optional
|
|
55
|
+
clause, `action <name> <id|ids> among <state> …`, which names the `choices` state whose choices
|
|
56
|
+
the argument names. A handle's action may carry it (`{ argument: 'id', among: 'series', run }`),
|
|
57
|
+
and so may a description's `agent` block, which every renderer hands to `agentMember` as written.
|
|
58
|
+
With `among`, the bridge checks the value, and whether a choice is marked destructive, against
|
|
59
|
+
that state's choices only, and refuses an id of another list with `invalid-value`. The snapshot
|
|
60
|
+
lists it beside the argument (`{ name: 'toggle', argument: 'id', among: 'series' }`). Without it
|
|
61
|
+
nothing changes, and no existing fence, handle or description changes meaning.
|
|
62
|
+
|
|
63
|
+
- `pnpm registry` fails on `among` on an action that takes no id, on `among` naming a state that
|
|
64
|
+
is not one of the fence's `choices` states, and on an `id` or `ids` action with no `among` in a
|
|
65
|
+
fence that declares more than one `choices` state.
|
|
66
|
+
- The staleness law holds the React member's and the description's `among` to the fence's.
|
|
67
|
+
- The agent conformance law draws an action's probe from the state it chooses among, checks that
|
|
68
|
+
the snapshot lists the same `among`, and checks that an id of another `choices` state is
|
|
69
|
+
refused and changes nothing.
|
|
70
|
+
|
|
71
|
+
**An agent hides and shows a chart's series with its legend.** `AreaChart`, `BarChart`,
|
|
72
|
+
`LineChart`, `RadarChart` and `ScatterChart` draw a legend whose keys hide and show a series. An
|
|
73
|
+
agent now reads them as two states and runs one action, in every web framework:
|
|
74
|
+
|
|
75
|
+
- `series` lists the legend's keys in the legend's order, each `{ id, label }`: the id is the
|
|
76
|
+
series' `key`, and the label is what its key says. `hidden` lists the ids of the series now
|
|
77
|
+
hidden. A chart with one series draws no legend, so both are empty there.
|
|
78
|
+
- `toggle` takes the id of one of `series` (`among series`) and presses its key with the key's own
|
|
79
|
+
click, as a person does, so the chart refits its domains as it does for a person.
|
|
80
|
+
- `choose` takes the id of one of `items` (`among items`), so a series' id is refused there, and
|
|
81
|
+
a mark's id is refused by `toggle`.
|
|
82
|
+
- Such a chart is listed for an agent while a person has something to operate in it: `onSelect`,
|
|
83
|
+
or a legend. A chart with a legend and no `onSelect` is listed now, with `items` empty and
|
|
84
|
+
`choose` refused, where before it registered nothing. `DonutChart` and `Treemap` draw a legend
|
|
85
|
+
that only labels, so nothing changes for them.
|
|
86
|
+
|
|
87
|
+
The engine exports `chartSeries`, `chartHiddenSeries` and `toggleChartSeries`, which read a
|
|
88
|
+
chart's legend keys from its element and press one, for every renderer, and the types
|
|
89
|
+
`ChartSeriesChoice` and `ChartLegendSeries`; each web framework's foundation re-exports them.
|
|
90
|
+
|
|
91
|
+
**An agent brushes a range on a `LineChart` or an `AreaChart`.** A chart with `onBrushEnd` on an
|
|
92
|
+
x it brushes (`time` or `linear` for `LineChart`, `time` for `AreaChart`) has a brush, and an agent
|
|
93
|
+
now reads and uses it through the machine a person's keys drive:
|
|
94
|
+
|
|
95
|
+
- `range-start` and `range-end` are the range a person sees drawn, in rows, the unit `position`
|
|
96
|
+
uses: the row the range was begun on and the row it ends on, or `null` while there is none.
|
|
97
|
+
- `brush` takes the row the range ends on, presses Shift and the arrow toward it once per row,
|
|
98
|
+
as a person does, and commits with Enter, so `onBrushEnd` receives what a person's committed
|
|
99
|
+
range reports. The range starts where a person's would: at the start of a range a person has
|
|
100
|
+
begun, else at the reading position, which `read` sets, else at an end of the chart.
|
|
101
|
+
- A chart without a brush lists both states as `null`, and `brush` throws, saying why. A number
|
|
102
|
+
that is not a row, and a range of one row, are refused too.
|
|
103
|
+
- A chart with a brush is listed for an agent with no `onSelect` and no legend.
|
|
104
|
+
|
|
105
|
+
The engine exports `chartRange` and `brushChartRange`, and the types `ChartRange` and
|
|
106
|
+
`ChartRangeSource`; each web framework's foundation re-exports them. `LineChart` and `AreaChart`
|
|
107
|
+
have a states fixture entry `brushable`.
|
|
108
|
+
|
|
109
|
+
- Updated dependencies [9b60a94]
|
|
110
|
+
- @polymorph/react@1.0.14
|
|
111
|
+
- @polymorph/recipes@1.0.14
|
|
112
|
+
|
|
113
|
+
## 1.0.13
|
|
114
|
+
|
|
115
|
+
### Patch Changes
|
|
116
|
+
|
|
117
|
+
- d84171d: An agent on a running page can read and operate the mounted members through an API, instead of
|
|
118
|
+
clicking or reading screenshots. A member's spec declares what an agent may read and do in an
|
|
119
|
+
`## Agent` section, and nothing else grants access. The bridge is opt-in: a page that does not
|
|
120
|
+
import `@polymorph/engine/agent` does not ship it. `docs/agents.md` describes the bridge for an
|
|
121
|
+
application and the section for a member's author.
|
|
122
|
+
|
|
123
|
+
**The bridge.**
|
|
124
|
+
|
|
125
|
+
`@polymorph/engine/agent` is a new entry point. `createAgentBridge({ confirm, policy, settleMs })`
|
|
126
|
+
returns a bridge with `snapshot()`, `query({ name, text, member })`, `act(steps)`,
|
|
127
|
+
`subscribe(listener)`, `acting` and `dispose()`.
|
|
128
|
+
|
|
129
|
+
- An action the spec does not declare is refused, and the error lists the actions that are
|
|
130
|
+
allowed.
|
|
131
|
+
- A secret value is reported as `{ secret: true }`, and so is any value that holds the text of a
|
|
132
|
+
password field.
|
|
133
|
+
- An action of a destructive instance runs only after `confirm` resolves true. Without a
|
|
134
|
+
`confirm`, it is refused.
|
|
135
|
+
- A policy can hide a member or deny an action. It cannot add either.
|
|
136
|
+
- A member is listed only while its element is in the document, so a closed Dialog, Drawer,
|
|
137
|
+
Popover or ConfirmDialog is not listed, and a step on it answers `unknown-member`. A member in
|
|
138
|
+
content marked `hidden` is not listed either, so a closed panel a renderer keeps in the
|
|
139
|
+
document gives an agent what a removed one does. A step that removes its member's element
|
|
140
|
+
still reports what changed.
|
|
141
|
+
- Each member carries `description`, the text of the elements its control names with
|
|
142
|
+
`aria-describedby`, such as a field's hint and error, when there is any. `query`'s `text`
|
|
143
|
+
matches it. A member that holds a secret, or a password field, gives none.
|
|
144
|
+
- A step that succeeds dispatches `polymorph:agentchange`, bubbling, on the element its member
|
|
145
|
+
names after the step, else on the one it named before if that is still in the document, else
|
|
146
|
+
on the document, with `detail: { id, member, action, changed, source: 'agent' }`, and
|
|
147
|
+
`bridge.acting` is true while its action runs, so a handler can tell an agent's change from a
|
|
148
|
+
person's.
|
|
149
|
+
- `agentTools(bridge)` returns the bridge as three tools, `polymorph_snapshot`,
|
|
150
|
+
`polymorph_query` and `polymorph_act`, for an application's own agent.
|
|
151
|
+
`registerWebMCP(bridge)` registers them with the browser's WebMCP API on
|
|
152
|
+
`document.modelContext` or `navigator.modelContext` and returns the function that unregisters
|
|
153
|
+
them. Where the API is absent it does nothing.
|
|
154
|
+
|
|
155
|
+
**Registration.**
|
|
156
|
+
|
|
157
|
+
`agentMember(handle)`, `agentFill(element, text)` and `agentPress(element)` are new exports of
|
|
158
|
+
`@polymorph/engine` and of every foundation, with the types `AgentHandle`, `AgentAction`,
|
|
159
|
+
`AgentArgumentType` and `AgentArgumentValues`. A member registers a handle while it is mounted.
|
|
160
|
+
`useAgentMember(handle)` in `@polymorph/react` registers a React member on mount, removes it on
|
|
161
|
+
unmount and calls the latest render's closures; `useAgentMember(handle, { unless })` registers
|
|
162
|
+
nothing while `unless` is true. The engine and every foundation also export
|
|
163
|
+
what several renderers share: `menuChoices`, `chooseMenuEntry`, `menubarChoices` and
|
|
164
|
+
`chooseMenubarEntry`; `railDestinations`, `currentRailDestination` and `goToRailDestination`,
|
|
165
|
+
which read an AppShell's destinations from its navigation in the document and press one, with
|
|
166
|
+
the types `RailClasses` and `RailDestination`; `listItems`, `currentListItem` and
|
|
167
|
+
`chooseListItem`, which read a List's items from its list in the document and press one, with
|
|
168
|
+
the type `ListItemChoice`; `jsonTreeBranches`, `jsonTreeExpanded` and `setJsonTreeBranch`, which
|
|
169
|
+
read a JsonTree's branches from its toggles by their JSON Pointer and press one, with the type
|
|
170
|
+
`JsonTreeBranch`; `chartMarks`, `chartPosition`, `readChartPosition` and `chooseChartMark`,
|
|
171
|
+
which read a window of at most `CHART_MARK_CAP` of a chart's marks through its reading, read and
|
|
172
|
+
move the reading's position, and pick a mark as Enter does, with the types `ChartMarkChoice`,
|
|
173
|
+
`ChartMarkReading` and `ChartMarkSource`; a
|
|
174
|
+
Table's sortable headers and its sort
|
|
175
|
+
(`tableSortColumns`, `tableSort`, `pressTableSort`); the notices of the toast store and an answer to
|
|
176
|
+
one (`toastNotices`, `toastDetails`, `dismissToastNotice`, `actOnToastNotice`); and the readers of
|
|
177
|
+
the text an agent sets on a date or duration field (`agentDate`, `agentDateTime`, `agentTime`,
|
|
178
|
+
`agentMonth`, `agentDateRange`, `agentDuration`).
|
|
179
|
+
|
|
180
|
+
A handle may give `withholds`, the element or elements whose registered members are not an
|
|
181
|
+
agent's. The bridge lists, matches and runs none of them, the policy cannot list them, and the
|
|
182
|
+
member is listed in their place. A member that holds a secret withholds its own element.
|
|
183
|
+
|
|
184
|
+
A custom element of `@polymorph/elements-ui` renders its Solid member, so the member inside it
|
|
185
|
+
registers too, and a page that builds the elements with a bundler creates a bridge as any
|
|
186
|
+
application does. A page with no build loads the bridge with `loadAgentBridge`, which
|
|
187
|
+
`polymorph.js` and `polymorph-all.js` export: it resolves to `@polymorph/engine/agent`, built with
|
|
188
|
+
the elements so it reads the registry they write to, and `polymorph.js` fetches it as a chunk of
|
|
189
|
+
its own on the first call.
|
|
190
|
+
|
|
191
|
+
**Registering before the bridge loads.**
|
|
192
|
+
|
|
193
|
+
`@polymorph/engine/webmcp` is a new entry point, an addition that changes no existing one, and
|
|
194
|
+
holds none of the bridge. `registerWebMCPOnCall(load, options)` registers the three tools with the
|
|
195
|
+
browser's WebMCP API at once, and on the first call of any of them calls `load`, a dynamic import
|
|
196
|
+
of `@polymorph/engine/agent`, once, and creates the bridge with `options`. A load that fails
|
|
197
|
+
resolves the call to `{ error: { code: 'failed', message } }`, and the next call loads again.
|
|
198
|
+
`applyAgentSetting(value)` and `AGENT_ATTRIBUTE` (`data-agent`) do what a page's agent setting
|
|
199
|
+
says: nothing without one, `on-call` as `registerWebMCPOnCall`, and `eager`, which loads the
|
|
200
|
+
bridge at once; another value warns, and without a WebMCP API neither registers nor loads
|
|
201
|
+
anything. `agentTools` and the new registration read one list of the tools' names, titles,
|
|
202
|
+
descriptions, schemas and hints.
|
|
203
|
+
|
|
204
|
+
One registration of the tools stands on a page at a time. While one does, a second
|
|
205
|
+
`registerWebMCP`, a `registerWebMCPOnCall` or a page's setting registers nothing and warns in the
|
|
206
|
+
console, where before the browser refused the second registration's names without a word.
|
|
207
|
+
|
|
208
|
+
A page with no build states `<html data-agent="on-call">` or `data-agent="eager"` and writes no
|
|
209
|
+
script: `polymorph.js` and `polymorph-all.js` read it as they load. `polymorph init --framework
|
|
210
|
+
elements` names the setting in the app's `AGENTS.md`, and its example page states none.
|
|
211
|
+
|
|
212
|
+
**The members.**
|
|
213
|
+
|
|
214
|
+
These members register, in every web vocabulary. Their props, markup and defaults are
|
|
215
|
+
unchanged. The system card lists each one's actions and states.
|
|
216
|
+
|
|
217
|
+
- Controls: Button, AvatarButton, ProviderButton, RecordButton, SplitButton, Link, Input,
|
|
218
|
+
Textarea, SearchInput, NumberInput, PhoneInput, PasswordInput, OTPInput, TagInput, InlineEdit,
|
|
219
|
+
ColorInput, Select, Combobox, MultiSelect, TreeSelect, Checkbox, CheckboxGroup, RadioGroup,
|
|
220
|
+
ChoiceCard, SegmentedControl, ModeSwitch, Switch, Slider, Rating, Calendar, DatePicker,
|
|
221
|
+
DateRangePicker, MonthInput, TimeInput, DurationInput, FileUpload and ImageEditor. A Button
|
|
222
|
+
reads `pressed` as `aria-pressed` says it, and as `null` on a Button that is not a toggle, and
|
|
223
|
+
`expanded` as `aria-expanded` says it, and as `null` on a Button that discloses nothing.
|
|
224
|
+
- Overlays: Dialog, ConfirmDialog, Drawer, Popover, Lightbox, Tour, Menu, ContextMenu, Menubar,
|
|
225
|
+
Command, Tabs and Toast. Toast registers on its viewport, which reads the notices on screen
|
|
226
|
+
and dismisses one or runs its action through the toast store.
|
|
227
|
+
- Structure: Accordion, Collapsible, Alert, Banner, Pagination, CursorPagination, Table,
|
|
228
|
+
DataTable, Tree, Stepper, Carousel, FilterBar, SectionNav, TableOfContents, Breadcrumbs, List
|
|
229
|
+
and AudioPlayer. A Table reads its own sortable headers, and its `sort` presses a header's
|
|
230
|
+
control once, so its caller decides the order; the Table a DataTable draws registers nothing. A
|
|
231
|
+
List reads the items that navigate or are picked from its list, with the current one, and its
|
|
232
|
+
`choose` presses an item's link or button, so `onSelect`, `onNavigate` or the browser takes it
|
|
233
|
+
as a person's press; an item that is only read is not a choice.
|
|
234
|
+
A Card with `href` registers its stretched link, which an agent presses as a person clicks
|
|
235
|
+
it, and ErrorSummary lists its errors and follows one to its field with `choose`, reading its
|
|
236
|
+
links with List's `listItems`. A JsonTree reads its open branches and the branches a reader can
|
|
237
|
+
see, each by the JSON Pointer of its value, and its `expand` and `collapse` press a branch's
|
|
238
|
+
toggle.
|
|
239
|
+
- Layout: SplitPane reads its divider's position in percent, as `aria-valuenow` reports it, and
|
|
240
|
+
its `set` moves the divider within the bounds its floors give and commits, as a key press does.
|
|
241
|
+
- Charts: AreaChart, BarChart, DonutChart, FunnelChart, Heatmap, Histogram, LineChart,
|
|
242
|
+
RadarChart, ScatterChart and Treemap, while they have `onSelect`. `items` lists the marks the
|
|
243
|
+
keys reach, labelled with what the live region says there, at most `CHART_MARK_CAP` of them:
|
|
244
|
+
the whole positions around the reading position. `position`, which the figure shows as
|
|
245
|
+
`data-position`, and `count` say where the reading is and how many positions the chart has,
|
|
246
|
+
`read` moves the reading as Left and Right do, and `choose` moves it to a listed mark and
|
|
247
|
+
activates it as Enter does, so `onSelect` receives a person's payload. A chart without
|
|
248
|
+
`onSelect` registers nothing, and Sparkline, which takes none, never does.
|
|
249
|
+
- Conversation: PromptInput, ChatThread, ToolCall, ReasoningDisclosure, AttachmentChip,
|
|
250
|
+
ArtifactPane and ApprovalCard. AppShell registers too: an agent collapses and expands its rail,
|
|
251
|
+
opens and closes its drawer below the breakpoint, reads the application's destinations from
|
|
252
|
+
its navigation, with the current one, and goes to one by pressing its NavItem, so `onNavigate`
|
|
253
|
+
or the browser takes it as a person's press.
|
|
254
|
+
|
|
255
|
+
What an agent is not given:
|
|
256
|
+
|
|
257
|
+
- A password and a one-time code are secret, and no action writes them. PasswordInput's reveal
|
|
258
|
+
toggle is not an agent's.
|
|
259
|
+
- No action confirms for a person. ConfirmDialog declares `cancel` only and withholds its
|
|
260
|
+
confirm Button, its phrase field and the Dialog it draws. ApprovalCard declares no action and
|
|
261
|
+
withholds its Buttons.
|
|
262
|
+
- A Button with `tone="danger"`, and a `danger`-toned entry of a Menu, ContextMenu, Menubar or
|
|
263
|
+
SplitButton, asks a person to confirm.
|
|
264
|
+
- RecordButton lets an agent stop a recording and never start one. FileUpload lets an agent
|
|
265
|
+
remove or retry a file and never add one. AudioPlayer and ImageEditor are read only.
|
|
266
|
+
- CopyButton, Tooltip, HoverCard and FormField give an agent nothing, and each spec says why.
|
|
267
|
+
Plan and ChatMessage are not registered, so they stay server components.
|
|
268
|
+
Citation and SourceList are not registered either: each of their links opens a new tab,
|
|
269
|
+
which an agent's press cannot open, and their words are on the page.
|
|
270
|
+
- The Popover ColorInput draws for its picker registers nothing, and ColorInput withholds its
|
|
271
|
+
panel, so an agent sees one ColorInput.
|
|
272
|
+
|
|
273
|
+
A React member that passed `value` or `defaultValue` straight to its substrate now holds the
|
|
274
|
+
value itself and keeps the substrate controlled, controlled when the prop is given, so an
|
|
275
|
+
agent's action and a person's reach the same handler in both forms: Checkbox, Switch,
|
|
276
|
+
RadioGroup, SegmentedControl, ChoiceCard, Select, Slider, Tabs, ReasoningDisclosure and
|
|
277
|
+
ToolCall. A native `form.reset()` now resets a Checkbox row's state attribute too.
|
|
278
|
+
|
|
279
|
+
**The tooling.**
|
|
280
|
+
|
|
281
|
+
- `@polymorph/registry`: each member carries an `agent` field, the statements of its spec's
|
|
282
|
+
`agent` fence, or `null` for a member agents cannot see. `@polymorph/registry/agent` exports
|
|
283
|
+
the grammar, in which a `number` state reads `null` while the member holds none, as an `id`
|
|
284
|
+
state does, and an action may say `presses <part>`, the part whose element it presses with the
|
|
285
|
+
element's own click. The coverage law fails on a control or an overlay whose spec has no decided
|
|
286
|
+
`## Agent` section, and the staleness law on a fence the code does not match.
|
|
287
|
+
- `@polymorph/shells`: a description takes an `agent` block (`on` or `element`, `state`,
|
|
288
|
+
`actions`, `secret`, `destructive`, `withholds`), which each renderer writes as a mount effect
|
|
289
|
+
that registers the instance. A compound part may give the block instead, which registers under
|
|
290
|
+
its member's name (Toast's viewport). A member that lends its identity reads the element the member it
|
|
291
|
+
lends to hands back, as `borrowed`; the Solid foundation exports `BORROWED` and
|
|
292
|
+
`BorrowedHolder`, and the Angular foundation `BORROWED`, `BorrowedHolder`, `handBack`,
|
|
293
|
+
`borrowedHolder`, `lenderHolder` and `KEEPS_HOLDER`.
|
|
294
|
+
- `@polymorph/conformance`: the runner executes every statement of an agent fence against every
|
|
295
|
+
renderer, with a bridge installed; `agentConformanceLaw` holds a shell's fences, and
|
|
296
|
+
`conformanceLaw` calls it. `WINDOW_SIZES` lists the fixture entries the runner mounts at a
|
|
297
|
+
window size other than the default, through the harness's new `viewport`, so an action that
|
|
298
|
+
exists only below a breakpoint is checked there.
|
|
299
|
+
- `@polymorph/engine/testing` exports `agentRegistrations()`, every registered member's id, name
|
|
300
|
+
and elements, withheld ones included.
|
|
301
|
+
- `pnpm new:member` writes the `## Agent` section with a placeholder the coverage law refuses.
|
|
302
|
+
|
|
303
|
+
- afc001e: `AuthPage`'s `children` is optional. A page that only reports a status, such as a link that has
|
|
304
|
+
expired, takes a `title` and a `description` and nothing else. The SwiftUI and Compose
|
|
305
|
+
`AuthPage` take the same optional `children`.
|
|
306
|
+
|
|
307
|
+
`AuthPage` is the archetype for a whole-page status outside the shell (nothing at this address,
|
|
308
|
+
the workspace could not be loaded) and for each step of a flow that runs before the shell
|
|
309
|
+
(creating an account, naming a workspace). A flow of steps inside the shell is a `FormPage` with
|
|
310
|
+
a `Stepper` as its first child. `design/archetypes/auth-page.md` and
|
|
311
|
+
`design/archetypes/form-page.md` say how each is composed, and both states fixtures hold an
|
|
312
|
+
entry for it. Nothing changes for a page that already passes `children`.
|
|
313
|
+
|
|
314
|
+
- 508275a: No chart draws an x-axis label past its own box. A label is centred on its tick, and the labels
|
|
315
|
+
on a tick at either end of the plot were drawn half outside the chart: the last value label of a
|
|
316
|
+
horizontal or diverging `BarChart`, the last x label of `LineChart`, `AreaChart`, `ScatterChart`
|
|
317
|
+
and `Histogram`, and in a right-to-left document the first. A band label wider than the room
|
|
318
|
+
beside its band did the same on `BarChart` and `Heatmap`. Such a label is now anchored at its end
|
|
319
|
+
of the plot: its start sits on a tick at the plot's start and its end on a tick at the plot's
|
|
320
|
+
end. Ticks, gridlines and marks do not move. The label beside an anchored one gives way when the
|
|
321
|
+
two would come nearer than the gap that keeps two labels from reading as one. On an axis that
|
|
322
|
+
drops whole labels to keep them apart (a band axis, `Histogram`'s edges) its tick is dropped with
|
|
323
|
+
it. On a value or a time axis the tick and its gridline stay, and the tick draws no label.
|
|
324
|
+
|
|
325
|
+
The engine's `AxisTick` has an optional `align` (`'start' | 'end'`), which the chart frame of
|
|
326
|
+
every web framework renders as `data-align` on the tick, and the chart axis recipe anchors the
|
|
327
|
+
label from it.
|
|
328
|
+
|
|
329
|
+
Band labels thinned to fit no longer put the last label one band after the label before it, where
|
|
330
|
+
the two touched or overlapped. The last label takes the place of the one before it instead.
|
|
331
|
+
|
|
332
|
+
- 5334be0: `DetailPage` takes `stickyAside`, which keeps the aside in view while the main column scrolls. A
|
|
333
|
+
TableOfContents beside a long page goes in the aside with it. From a `44rem` page, where the aside
|
|
334
|
+
is beside the main column, it stays the page's top inset below the top of the box that scrolls,
|
|
335
|
+
is never taller than that box, and scrolls inside itself when it is longer. Below `44rem` the
|
|
336
|
+
aside is under the main column and scrolls with the page, as before. A DetailPage without the prop
|
|
337
|
+
is unchanged.
|
|
338
|
+
|
|
339
|
+
AppShell's content region declares `container-type: size` in place of `inline-size`, so a page
|
|
340
|
+
reads its visible height as `100cqb`. Its height comes from the frame's grid, so nothing it draws
|
|
341
|
+
moves.
|
|
342
|
+
SwiftUI and Compose take `stickyAside` and draw nothing for it: their aside scrolls with the page.
|
|
343
|
+
|
|
344
|
+
- 189ef43: `Heading` takes `id`, the heading element's id. A link to `#id` and a `TableOfContents` item with
|
|
345
|
+
that `id` go to the heading, so an app names a section without an element of its own around it:
|
|
346
|
+
`<Heading id="install">Install</Heading>` in place of `<div id="install"><Heading>Install</Heading>…</div>`.
|
|
347
|
+
A TableOfContents moves focus to the heading, which a screen reader announces by its name and
|
|
348
|
+
level. A Heading takes no `scroll-margin`, because nothing the vocabulary draws covers the top of
|
|
349
|
+
the page's box. SwiftUI and Compose take the prop and draw nothing for it. A Heading without `id`
|
|
350
|
+
is unchanged.
|
|
351
|
+
- 73837b5: `MasterDetailPage` is a new page archetype: a list of items of one kind beside the detail of the
|
|
352
|
+
selected one, for an inbox, a notifications page, an audit log or a file browser. It takes
|
|
353
|
+
`title`, `description` and `actions` as PageHeader does, the `list` (a List, Table or Tree with its
|
|
354
|
+
FilterBar and pagination, the selected item marked `current`) named by `listLabel`, the selected
|
|
355
|
+
item's `detail`, an `emptyState` for the detail pane while nothing is selected, and `backLabel`
|
|
356
|
+
and `onBack` for the way back on a phone. It fills AppShell's content region, as ConversationPage
|
|
357
|
+
does, and the list and the detail scroll on their own. At or above a 48rem page the two sit side
|
|
358
|
+
by side in a SplitPane; below it the page draws the list, or the detail under the way back, and
|
|
359
|
+
`onBack` is where the application clears its selection. Focus moves only when the element that
|
|
360
|
+
held it is no longer drawn. A page that draws the selected item under a table can move to it.
|
|
361
|
+
|
|
362
|
+
The engine and every foundation export `masterDetailFocus`, `masterDetailHolds` and
|
|
363
|
+
`MASTER_DETAIL_PART`, the focus rule every renderer's MasterDetailPage shares. The SwiftUI and
|
|
364
|
+
Compose contracts gain `PMMasterDetailPageProps` and its rendering protocol, and both platforms
|
|
365
|
+
draw the page: two panes from a 48rem page, and below it the list, or the detail under the way
|
|
366
|
+
back. On iOS the way back is the page's own button and no system gesture. The elements vocabulary
|
|
367
|
+
has it as `<poly-master-detail-page>`.
|
|
368
|
+
|
|
369
|
+
- a4dc653: `PageHeader`, `DetailPage` and `Dashboard` take `titleEdit`, an `InlineEdit` the app writes, so a
|
|
370
|
+
reader renames the page's subject in its title instead of in a Dialog. The page draws it beside
|
|
371
|
+
the `<h1>` and hands it `valueHidden`. The app gives it the page's `title` as its `value`,
|
|
372
|
+
`size="lg"`, its `label` and handlers and, for a save that waits for a server, `editing`,
|
|
373
|
+
`pending` and `error`:
|
|
374
|
+
|
|
375
|
+
```tsx
|
|
376
|
+
<DetailPage
|
|
377
|
+
title={application.name}
|
|
378
|
+
titleEdit={
|
|
379
|
+
<InlineEdit
|
|
380
|
+
label="Application name"
|
|
381
|
+
value={application.name}
|
|
382
|
+
size="lg"
|
|
383
|
+
editing={renaming}
|
|
384
|
+
onEditingChange={setRenaming}
|
|
385
|
+
pending={saving}
|
|
386
|
+
error={renameError}
|
|
387
|
+
onCommit={rename}
|
|
388
|
+
/>
|
|
389
|
+
}
|
|
390
|
+
…
|
|
391
|
+
/>
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
The page keeps one `<h1>` named by the saved title: beside the edit control while reading, and
|
|
395
|
+
visually hidden while the field is open in its place. The header keeps its height and the actions
|
|
396
|
+
their place when the field opens. A Vue, Svelte, Solid or Angular page takes the InlineEdit in its
|
|
397
|
+
`titleEdit` slot. `InlineEdit` takes `valueHidden`: another element draws the value, and the value
|
|
398
|
+
element stays hidden so it still describes the edit control. SwiftUI and Compose take `titleEdit`
|
|
399
|
+
and draw nothing for it, because InlineEdit has no SwiftUI or Compose rendering. A page without
|
|
400
|
+
`titleEdit` and an InlineEdit without `valueHidden` are unchanged.
|
|
401
|
+
|
|
402
|
+
- 2da1598: `SearchPage` is a new page archetype in every web vocabulary: the page whose subject is a query,
|
|
403
|
+
with the field, the filters under it, and what the query found. It takes `title`,
|
|
404
|
+
`description` and `actions` as PageHeader does, the `search` slot for the field, `searchLabel`
|
|
405
|
+
to name its search landmark, `filters`, `empty` with the required `emptyState`, `pending`, and
|
|
406
|
+
the results as `children`. A page that searches as the reader types passes no `onSubmit`. A page
|
|
407
|
+
that submits passes `onSubmit`, and the landmark is then a real form: Enter in the field calls
|
|
408
|
+
it once and the browser does not navigate.
|
|
409
|
+
|
|
410
|
+
The results flow down the page with no panel, one group under each Heading. While `pending` the
|
|
411
|
+
results region is `aria-busy` and keeps the last results; while `empty` it holds the EmptyState
|
|
412
|
+
drawn from `emptyState`. The swap moves no focus and plays no motion. The page's measure is nine
|
|
413
|
+
of `--pm-space-10`, between FormPage's and ListPage's.
|
|
414
|
+
|
|
415
|
+
`one-opener` knows SearchPage, so a module that renders one and also composes a PageHeader and a
|
|
416
|
+
Hero is told to keep the archetype's title.
|
|
417
|
+
|
|
418
|
+
The elements vocabulary has it as `<poly-search-page>`.
|
|
419
|
+
|
|
420
|
+
On iOS and Android `SearchPage` is native, drawn in SwiftUI and Compose: the header, the field
|
|
421
|
+
with its filters under it, and the results, with `loadStatus` and `onRetry` as every native page
|
|
422
|
+
takes them.
|
|
423
|
+
|
|
424
|
+
- Updated dependencies [d84171d]
|
|
425
|
+
- Updated dependencies [508275a]
|
|
426
|
+
- Updated dependencies [5334be0]
|
|
427
|
+
- Updated dependencies [73837b5]
|
|
428
|
+
- Updated dependencies [4dc0747]
|
|
429
|
+
- Updated dependencies [a4dc653]
|
|
430
|
+
- Updated dependencies [bcbaa92]
|
|
431
|
+
- Updated dependencies [2da1598]
|
|
432
|
+
- Updated dependencies [ac64e4c]
|
|
433
|
+
- @polymorph/react@1.0.13
|
|
434
|
+
- @polymorph/recipes@1.0.13
|
|
435
|
+
|
|
436
|
+
## 1.0.12
|
|
437
|
+
|
|
438
|
+
### Patch Changes
|
|
439
|
+
|
|
440
|
+
- 358158d: `AppShell` takes `navigation`, `'rail'` by default or `'top'`. With `'top'` the frame draws the
|
|
441
|
+
navigation it already has, `sidebar` with its NavItems and NavGroups, as a row along its top at
|
|
442
|
+
frame widths: the brand, then the items, and the topbar continues the row with its `leading` and
|
|
443
|
+
`trailing` slots on the same surface. The content region takes the whole width. Below the drawer
|
|
444
|
+
breakpoint the row is the same drawer the rail becomes. The root carries `data-navigation="top"`.
|
|
445
|
+
|
|
446
|
+
The same parts go in `sidebar` in either layout. Put them in `sidebar` directly: the shell lays
|
|
447
|
+
out its own parts in the row, and a Stack around them keeps its column. A NavGroup's items join
|
|
448
|
+
the row, its overline is removed, and a rule divides it from the group before it. It keeps
|
|
449
|
+
`role="group"` and its name. A row wider than the frame wraps onto a further line, so every
|
|
450
|
+
destination stays on screen.
|
|
451
|
+
|
|
452
|
+
A row has no rail to narrow, so `collapsed` is not drawn there: there is no collapse toggle, no
|
|
453
|
+
`data-collapsed` and no tooltip. The value is kept for a return to the rail. `sidebarFooter`
|
|
454
|
+
follows the last item in the row and is the drawer's foot. An account belongs in
|
|
455
|
+
`topbar.trailing`, as a Menu behind an AvatarButton.
|
|
456
|
+
|
|
457
|
+
There is still one navigation landmark, the same `<nav>` named by `messages.primaryNavigation`,
|
|
458
|
+
before the topbar in the document. SwiftUI and Compose take the prop and draw their own frame
|
|
459
|
+
whatever it says. A frame without `navigation` is unchanged.
|
|
460
|
+
|
|
461
|
+
- 69c3d82: `AudioPlayer` is a new member in every web vocabulary: it plays one recording, such as a voice
|
|
462
|
+
message in a conversation or a recorded call in a ticket. It takes `src`, the recording's URL,
|
|
463
|
+
and `label`, which names the player as a group ("Voice message from Ada"). It is a play Button,
|
|
464
|
+
a Slider that moves through the recording, and the elapsed and total time, over a native
|
|
465
|
+
`<audio>` element without `controls`. It replaces `<audio controls>`, which the browser draws
|
|
466
|
+
and no theme reaches.
|
|
467
|
+
|
|
468
|
+
`duration` is the length in seconds, shown before the file gives its own. A file's finite length
|
|
469
|
+
replaces it, and a file that gives none, as a recording `MediaRecorder` wrote, keeps it.
|
|
470
|
+
`locale` writes the clock's numerals and the spoken lengths through `Intl`. `messages` holds the
|
|
471
|
+
five strings the player says (`play`, `pause`, `scrubber`, `position`, `failed`), with English
|
|
472
|
+
defaults. `onPlay` reports that the recording started, and `onEnded` that it played to its end.
|
|
473
|
+
|
|
474
|
+
The Button's name says what a press does: "Play", then "Pause". The scrubber's spoken value is
|
|
475
|
+
the elapsed and total length in words, "5 seconds of 18 seconds", and it moves in whole seconds.
|
|
476
|
+
The time is hidden from assistive technology and is not a live region. When one player starts,
|
|
477
|
+
every other AudioPlayer on the page pauses. A file that cannot be loaded replaces the scrubber
|
|
478
|
+
with the words `messages.failed`, and a press on the Button asks for the file again. An empty
|
|
479
|
+
`src` is that state from the first render.
|
|
480
|
+
|
|
481
|
+
It has no volume, playback speed, download, waveform or transcript.
|
|
482
|
+
|
|
483
|
+
The SwiftUI and Compose renderings are not written yet. `AudioPlayer` is in both platforms'
|
|
484
|
+
pending lists, and both contracts are generated, with `AudioPlayerMessages` given its shape.
|
|
485
|
+
|
|
486
|
+
- bda0b87: `Banner` is a new member in every web vocabulary: the notice that belongs to the application
|
|
487
|
+
frame and stays until its cause ends, such as an outage, a trial that is running out, a member of
|
|
488
|
+
staff acting inside a customer's account, or a page showing a stale snapshot. It is not Alert,
|
|
489
|
+
which is a callout inside one page's content, and it is not Toast, which reports an event and
|
|
490
|
+
leaves.
|
|
491
|
+
|
|
492
|
+
`Banner` takes `tone` (`neutral`, `info`, `warning` or `danger`; `neutral` is the default and
|
|
493
|
+
states a fact about the session), the message as its children, `action` (one small Button or one
|
|
494
|
+
Link, the way out of the condition), and `onDismiss` with `dismissLabel` for a reminder the
|
|
495
|
+
reader may hide. Only `danger` has `role="alert"`. The other tones have `role="status"`, because a
|
|
496
|
+
warning Banner is on screen for days and should not interrupt on every load. On a narrow frame
|
|
497
|
+
the action moves under the message, and the tone icon and the dismiss button stay beside its
|
|
498
|
+
first line.
|
|
499
|
+
|
|
500
|
+
`AppShell` takes a new optional `banner` slot for it. The banner has a row of its own across the
|
|
501
|
+
whole frame, above the rail and the topbar, so the rail and the content region shorten by its
|
|
502
|
+
height and nothing scrolls under it. An AppShell without a banner is unchanged.
|
|
503
|
+
|
|
504
|
+
The SwiftUI and Compose renderings of `Banner` are not written yet. `Banner` is in both
|
|
505
|
+
platforms' pending lists, and both contracts are generated. The SwiftUI and Compose `AppShell`
|
|
506
|
+
draw the `banner` slot: the view the app passes is a row of its own across the frame, above the
|
|
507
|
+
navigation and the content, inside the top safe area. Until `Banner` has a native rendering, a
|
|
508
|
+
native app composes its notice from the members that have one.
|
|
509
|
+
|
|
510
|
+
- 28aeda0: `BarChart` takes `lines`: series drawn as lines over the bars, on the bars' value axis and in
|
|
511
|
+
their unit, such as a moving average of the bars' own measure that the app computes. Each line
|
|
512
|
+
is LineChart's 2px stroke through the categories' centres, with a ringed point at every value,
|
|
513
|
+
drawn over the bars and the annotation ink. A `null` breaks the line.
|
|
514
|
+
|
|
515
|
+
The lines take the slots after the bars' and count toward the eight. They join the legend with a
|
|
516
|
+
line key, the tooltip, the live region, the Up/Down walk after the bar series, `onSelect`, the
|
|
517
|
+
table twin and the summary, all in the chart's `y.format`. `mode` stacks the bars only, and a
|
|
518
|
+
line reads against the stack's total. A horizontal chart draws no lines and warns.
|
|
519
|
+
|
|
520
|
+
A chart has one value axis. A second measure in another unit, such as a rate beside counts, is a
|
|
521
|
+
second chart over the same rows (`docs/charts.md`). A constant target is still `baseline`.
|
|
522
|
+
|
|
523
|
+
A chart without `lines` draws exactly what it drew before. The engine exports `barLinePoints`,
|
|
524
|
+
the line's points over the band axis, and the `BarLine` and `BarLinePoint` types. The SwiftUI
|
|
525
|
+
`PMBarChart` draws the lines with Swift Charts. Android has no chart rendering, as before.
|
|
526
|
+
|
|
527
|
+
- aec76ec: `Button` takes `expanded` and `aria-controls`, for a button that shows and hides a region.
|
|
528
|
+
`expanded` sets `aria-expanded`, and `aria-controls` names the region while it is shown. The
|
|
529
|
+
button draws no state of its own for it: the caller passes the icon that shows the state. It is
|
|
530
|
+
not `pressed`, which says the button itself is on. The SwiftUI and Compose members take
|
|
531
|
+
`expanded` too and announce the button as expanded or collapsed.
|
|
532
|
+
|
|
533
|
+
A button without `expanded` is unchanged and renders neither attribute.
|
|
534
|
+
|
|
535
|
+
- 9153bdd: `Code` breaks a string with no break in it. A URI or a key set in a `Code` chip used to widen
|
|
536
|
+
the column that held it, and on a phone the page. The chip now wraps where it would overflow. A
|
|
537
|
+
chip that fits is unchanged.
|
|
538
|
+
- 96a3846: `CommentThread` is a new member in every web vocabulary: the comments people leave on a record,
|
|
539
|
+
such as a ticket, an artifact or a document, with their replies. `CommentThread` takes `label`,
|
|
540
|
+
the list's name, and `messages`, the words it writes itself (`edited`, `replies`).
|
|
541
|
+
`CommentThread.Comment` takes `author`, `avatar` (an Avatar), `time` (a RelativeTime or the
|
|
542
|
+
app's text), `edited`, `meta` (Badges such as "Internal note" or "Resolved"), `actions` (the
|
|
543
|
+
app's Buttons or a Menu) and `replies` (more comments). Its children are the body: Text,
|
|
544
|
+
Markdown or the app's own nodes with mentions, and a row of AttachmentChips.
|
|
545
|
+
|
|
546
|
+
The thread is an `<ol>` named by its label, and each comment is a list item holding an
|
|
547
|
+
`<article>` named by its author and its time. A comment's replies are a second list inside its
|
|
548
|
+
item, drawn indented under it. A comment nested deeper is drawn at the second level, so a long
|
|
549
|
+
exchange never narrows the column, and its markup still nests. Nothing in the thread is a live
|
|
550
|
+
region: a comment that arrives is the app's to announce. The composer is the app's: a Textarea
|
|
551
|
+
with a Button, or a PromptInput, after the thread.
|
|
552
|
+
|
|
553
|
+
It replaces comments built from Text, Badge and Buttons in a Stack, a Card or a DataTable row. It
|
|
554
|
+
is not ChatThread, which is a conversation with a model that scrolls inside itself and follows
|
|
555
|
+
the newest turn.
|
|
556
|
+
|
|
557
|
+
The SwiftUI and Compose renderings are not written yet. `CommentThread` is in both platforms'
|
|
558
|
+
pending lists, and both contracts are generated.
|
|
559
|
+
|
|
560
|
+
- b209e98: `Countdown` is a new member in every web vocabulary: the time left until a moment, ticking each
|
|
561
|
+
second, for a code that expires, a session that ends, or a retry or a resend that unlocks. It
|
|
562
|
+
writes `4:59`, then `1:02:05` from an hour, in tabular figures and the locale's numerals, until
|
|
563
|
+
`0:00`, and calls `onEnd` once when the moment is reached, or once after mount when the moment
|
|
564
|
+
has already passed. It is not RelativeTime, which writes a moment as words and never refreshes.
|
|
565
|
+
|
|
566
|
+
`Countdown` takes `until` (an ISO-8601 instant, not a number of seconds), `label` (what it counts
|
|
567
|
+
to, the timer's accessible name), `onEnd`, `announce`, `locale` and `messages`. The timer is
|
|
568
|
+
`role="timer"` and says the time in words, so a screen reader does not hear every second. With
|
|
569
|
+
`announce`, a polite line says the time left at one minute and at ten seconds. The member holds
|
|
570
|
+
no button: the control that waits for the end is the application's, enabled from `onEnd`.
|
|
571
|
+
|
|
572
|
+
Every Countdown on a page shares one clock with one timer, which wakes on the second of each
|
|
573
|
+
countdown's time left, waits only for an end while the document is hidden, and reads the time
|
|
574
|
+
again when the document is shown. The engine exports what the members use: `countdownMoment`,
|
|
575
|
+
`countdownLeft`, `countdownClock`, `countdownSpoken` and `followCountdown`.
|
|
576
|
+
|
|
577
|
+
The SwiftUI and Compose renderings of `Countdown` are not written yet. `Countdown` is in both
|
|
578
|
+
platforms' pending lists, and both contracts are generated.
|
|
579
|
+
|
|
580
|
+
- e584e0a: `CursorPagination` takes `disabled`, the app's hold on the pager while it does something else to
|
|
581
|
+
the list, such as a bulk action or a save. Every control is disabled and none shows busy, the
|
|
582
|
+
root carries `data-disabled`, and the pager is still drawn, so the page does not move when the
|
|
583
|
+
hold ends. It is not `pending`, which says the pager's own request is in flight: with both set,
|
|
584
|
+
the pressed direction stays busy and keeps its focus. The append form's "Load more" is held the
|
|
585
|
+
same way. The SwiftUI and Compose members take the prop too.
|
|
586
|
+
|
|
587
|
+
A hold keeps the reader's place. A browser takes focus from a button as it is disabled: the page
|
|
588
|
+
has it, and no control does. So when a hold disables the button that has focus, the pager moves
|
|
589
|
+
focus to its root, the `<nav>`. The root carries `tabindex="-1"`, which makes it no tab stop, and
|
|
590
|
+
draws the shared focus ring. The next Tab goes on to what follows the pager. A hold that begins
|
|
591
|
+
while focus is elsewhere moves nothing. A direction that is busy is not disabled, so it keeps focus
|
|
592
|
+
until its window arrives.
|
|
593
|
+
|
|
594
|
+
When the hold ends and focus is still on the root, focus returns to the control it was taken
|
|
595
|
+
from: previous, next, or the append form's action. A control that is still disabled, or is no
|
|
596
|
+
longer drawn, takes no focus, and focus stays on the root. If the reader moved focus during the
|
|
597
|
+
hold, nothing moves.
|
|
598
|
+
|
|
599
|
+
A pager without `disabled` is unchanged, but for the `tabindex="-1"` on its root.
|
|
600
|
+
|
|
601
|
+
- aec76ec: `DataTable` takes `rowDetail`, which lets a row show more under itself. Passing it adds an
|
|
602
|
+
expansion column after the selection column. Each row gets a disclosure button, and an open
|
|
603
|
+
row draws what `rowDetail` returns for it in a full-width row below. Any number of rows can be
|
|
604
|
+
open. The table holds the open rows itself, starting with the rows `defaultExpanded` names, or
|
|
605
|
+
the app holds them with `expanded`, a set of row ids. `onExpandedChange` is called with the next
|
|
606
|
+
set in both cases.
|
|
607
|
+
|
|
608
|
+
`rowDetail` is called with one object, `{ row, close }`. `row` is the caller's own row. `close`
|
|
609
|
+
closes that row's detail and returns focus to the row's disclosure when focus was inside the
|
|
610
|
+
detail, so a detail's Save or Done calls it. In Vue `rowDetail` is a scoped slot
|
|
611
|
+
(`#rowDetail="{ row, close }"`), in Svelte a snippet that takes the object, in Solid a function
|
|
612
|
+
prop, and in Angular an input that takes an `ng-template`
|
|
613
|
+
(`<ng-template #detail let-row="row" let-close="close">`).
|
|
614
|
+
|
|
615
|
+
`isRowExpandable` says whether a row has a detail. A row it refuses has an empty cell in the
|
|
616
|
+
expansion column and never draws a detail.
|
|
617
|
+
|
|
618
|
+
`getRowName` returns a row's own name, "Invoice 12". `messages` gains an optional
|
|
619
|
+
`detailsLabel`, which names each row's disclosure from it, "Details for Invoice 12", and names
|
|
620
|
+
the expansion column's header. A localized app that passes `rowDetail` passes it as well.
|
|
621
|
+
`getRowLabel` keeps its meaning, the whole name of the row's checkbox, and the disclosure does
|
|
622
|
+
not read it.
|
|
623
|
+
|
|
624
|
+
In a narrow container the table pans, and the detail stays as wide as the part of the table
|
|
625
|
+
a reader sees.
|
|
626
|
+
|
|
627
|
+
The grid's arrow keys reach a detail. ArrowDown from a cell of an open row moves to the
|
|
628
|
+
row's detail cell, and ArrowDown again to the next row, in the column the reader was in.
|
|
629
|
+
ArrowUp is the reverse. ArrowLeft, ArrowRight, Home and End do nothing in a detail cell. What
|
|
630
|
+
a detail holds stays in the page's tab order, so Tab from the detail cell goes into it. The
|
|
631
|
+
expansion column's header draws nothing and is never the grid's first tab stop. In a table
|
|
632
|
+
without selection the first stop is the first data column's header.
|
|
633
|
+
|
|
634
|
+
The detail adds content and hides no column. Choosing which columns to show stays with the
|
|
635
|
+
app, which filters the `columns` it passes.
|
|
636
|
+
|
|
637
|
+
A table without `rowDetail` is unchanged.
|
|
638
|
+
|
|
639
|
+
The SwiftUI and Compose members draw the detail too, in the list and in the table. Each row's
|
|
640
|
+
disclosure is an icon-only Button after the row's Checkbox, with the platform's expanded or
|
|
641
|
+
collapsed state, named by `detailsLabel` from `getRowName`. An open row's detail is a row of its
|
|
642
|
+
own under it. `expanded`, `defaultExpanded`, `onExpandedChange` and `isRowExpandable` behave as
|
|
643
|
+
on the web. The expansion column has no header on either platform. `close` closes the row. In
|
|
644
|
+
Compose it moves keyboard focus that is inside the detail to the disclosure, and in SwiftUI it
|
|
645
|
+
leaves focus to the system.
|
|
646
|
+
|
|
647
|
+
On both platforms `getRowName` also names the row itself, so VoiceOver and TalkBack announce
|
|
648
|
+
"Invoice 12" for a row that opens and the row's Checkbox stays "Select Invoice 12". A table
|
|
649
|
+
without `getRowName` names its rows as before: by `getRowLabel` when the app passes it, else by
|
|
650
|
+
each column's header and value.
|
|
651
|
+
|
|
652
|
+
`@polymorph/angular` gains `bindSlot`, which binds a scoped slot's template to the slot's
|
|
653
|
+
props and gives the template each prop as a variable of that name. A generated Angular member
|
|
654
|
+
calls it for a slot outlet that has `props`.
|
|
655
|
+
|
|
656
|
+
- a35c79a: `Diff` is a new member in every web vocabulary: a changed value or text, shown as old and new.
|
|
657
|
+
It takes `before` and `after`, both strings. A side that is missing, `null` or empty did not
|
|
658
|
+
exist, so only an `after` is an addition and only a `before` is a removal. Equal sides are no
|
|
659
|
+
change.
|
|
660
|
+
|
|
661
|
+
`display="inline"`, the default, is a short value inside a sentence, an Alert or a table cell.
|
|
662
|
+
The old value is a `<del>`, struck through, and the new one an `<ins>`, with an arrow between
|
|
663
|
+
them. A value that is only new has a `+` before it. Visually hidden words say the change, so it reads "from Draft to Active", "added Ada
|
|
664
|
+
Okonkwo" or "removed Ada Okonkwo". It takes the font, size and colour of the text around it and
|
|
665
|
+
wraps as that text does.
|
|
666
|
+
|
|
667
|
+
`display="lines"` compares two texts line by line, in a region that `label` names. Each row has
|
|
668
|
+
a marker (`+`, `−` or none), hidden words and the line in the mono face. Long lines wrap. Runs of
|
|
669
|
+
unchanged lines away from a change collapse to one row, a Button that says how many lines it
|
|
670
|
+
holds and shows them when pressed. `context` is the number of unchanged lines kept beside each
|
|
671
|
+
change (3 by default; `Infinity` keeps every line). A list of ids is compared with one id on
|
|
672
|
+
each line.
|
|
673
|
+
|
|
674
|
+
`messages` holds the hidden words and the collapsed row's text, with English defaults.
|
|
675
|
+
|
|
676
|
+
It replaces `old → new` written into a string, where a screen reader reads an arrow and colour is
|
|
677
|
+
the only mark. It is not CodeBlock or JsonTree, which each show one value. It has no side-by-side
|
|
678
|
+
form, no highlighting inside a line, no syntax colours and no editing.
|
|
679
|
+
|
|
680
|
+
The SwiftUI and Compose renderings are not written yet. `Diff` is in both platforms' pending
|
|
681
|
+
lists, and both contracts are generated.
|
|
682
|
+
|
|
683
|
+
- e708348: `DurationInput` is a new member in every web vocabulary: a field for a length of time, such as
|
|
684
|
+
a session lifetime, a retention period or a timeout. It holds whole seconds and shows them as
|
|
685
|
+
counts of days, hours, minutes or seconds, each a spinbutton with its unit's word beside it,
|
|
686
|
+
so a reader sees "7 days" where a number field labelled "(seconds)" shows 604800.
|
|
687
|
+
|
|
688
|
+
`value`, `defaultValue` and `onChange` are whole seconds, and `null` is the empty field.
|
|
689
|
+
`onChange` reports committed values, as NumberInput's does: an arrow key commits at once, and
|
|
690
|
+
typed digits commit when focus leaves the field or on Enter. `min` (0 by default) and `max`
|
|
691
|
+
hold every commit, and the arrows stop at them. `units` chooses the counts, days, hours and
|
|
692
|
+
minutes by default. The largest count shown has no ceiling, so 36 hours is lawful when hours
|
|
693
|
+
are the largest. An arrow carries into the next count: one minute more than 59 minutes is an
|
|
694
|
+
hour. A typed count stays under the next unit: 90 cannot be typed into the minutes while hours
|
|
695
|
+
show. A value the counts cannot write exactly is drawn rounded to the smallest unit and kept
|
|
696
|
+
as it was until the reader changes it. `name` posts whole seconds as a decimal string. The
|
|
697
|
+
unit words, the digits and each count's name come from `Intl` in `locale`, and the one word
|
|
698
|
+
the member writes itself, what an empty count says, is `messages.empty`. The label, the
|
|
699
|
+
description and the error are FormField's.
|
|
700
|
+
|
|
701
|
+
It is not TimeInput, which holds a time of day, and it has no presets: a screen that offers a
|
|
702
|
+
few fixed lengths uses `Select` or `RadioGroup`.
|
|
703
|
+
|
|
704
|
+
The arithmetic is new in the engine, and so in every foundation, which re-exports it:
|
|
705
|
+
`durationKey` (what a key does in a count), `durationSegments` (the counts a draft draws),
|
|
706
|
+
`durationDraft` (seconds as counts), `typeIntoDuration` and `commitDuration`, with the types
|
|
707
|
+
`DurationUnit`, `DurationDraft`, `DurationFieldOptions`, `DurationSegment`, `DurationKey`,
|
|
708
|
+
`DurationKeyResult` and `DurationMessages`.
|
|
709
|
+
|
|
710
|
+
The SwiftUI and Compose renderings are not written yet. `DurationInput` is in both platforms'
|
|
711
|
+
pending lists, and both contracts are generated.
|
|
712
|
+
|
|
713
|
+
- f69f55e: `followEnd(region, content, report)` and `jumpToEnd(region)` are new exports of the engine, and
|
|
714
|
+
of every foundation, which re-exports the engine. `ChatThread` follows its newest turn with them
|
|
715
|
+
in every web vocabulary, and `LogView` follows its newest line with them.
|
|
716
|
+
|
|
717
|
+
`followEnd` keeps a scroll container at its end while the element inside it grows, for as long
|
|
718
|
+
as the reader is at the end: within `FOLLOW_SLACK_PX` (24) of it. A reader who scrolls away is
|
|
719
|
+
left where they scrolled. `report` receives `{ detached, overflowing }` once at the start and
|
|
720
|
+
again each time either changes, and `overflowing` counts both axes. It returns the function that
|
|
721
|
+
stops following. Without a container, without content or without `ResizeObserver` it does
|
|
722
|
+
nothing. `jumpToEnd` moves the container to its end and follows again from that call, which is
|
|
723
|
+
what a "Jump to latest" control does.
|
|
724
|
+
|
|
725
|
+
`ChatThread`'s jump control now follows from the press, so a turn that grows in the frame
|
|
726
|
+
before the browser reports the jump's scroll is followed too. A thread that is wider than its
|
|
727
|
+
box is a tab stop, as a taller one already was.
|
|
728
|
+
|
|
729
|
+
- 766b5fd: `FunnelChart` is a new chart member in every web vocabulary: the count that survives each stage
|
|
730
|
+
of an ordered process, such as a signup, a checkout or a ticket from opened to resolved. It
|
|
731
|
+
takes `label` and `stages`, where a `FunnelStage` is `{ key, label, value }`, and the tier's
|
|
732
|
+
`format`, `size`, `locale`, `tooltip`, `onSelect`, `loading` and `messages`.
|
|
733
|
+
|
|
734
|
+
Each stage is one horizontal bar from the inline start, its length its value against the
|
|
735
|
+
largest stage, with its label in a column before it and its value and share of the first stage
|
|
736
|
+
after it. Between two bars it writes the share of the stage above that reached the stage below:
|
|
737
|
+
"62% continued". Stages are drawn as given. A stage larger than the one before it dev-warns and
|
|
738
|
+
is not clamped or reordered. A first stage of zero has no shares, and a stage of zero has no
|
|
739
|
+
step after it. The tooltip, the live region and the table twin (stage, value, share,
|
|
740
|
+
continued) state every number the plot has no room for. It is one series, so it has one colour
|
|
741
|
+
and no legend.
|
|
742
|
+
|
|
743
|
+
`funnelChartModel`, `funnelChartReadout` and `funnelChartSelection` are new exports of
|
|
744
|
+
`@polymorph/engine/charts`, and of every foundation, which re-exports it, with the types
|
|
745
|
+
`FunnelStage`, `FunnelChartInput`, `FunnelChartModel`, `FunnelPlot`, `FunnelBar` and
|
|
746
|
+
`FunnelText`.
|
|
747
|
+
|
|
748
|
+
`ChartMessages` has four new keys, with English defaults in `DEFAULT_CHART_MESSAGES`:
|
|
749
|
+
`funnelSummary`, `stageColumn`, `continuedColumn` and `continued`. A host that spreads the
|
|
750
|
+
defaults is unaffected. A host that writes its own whole catalog adds the four keys, because the
|
|
751
|
+
catalog takes all keys or none.
|
|
752
|
+
|
|
753
|
+
On iOS, `PMChartMessages` takes the same four, and `PMSpecDefault.chartMessages` gives their
|
|
754
|
+
English. `FunnelChart` is native on iOS and its SwiftUI rendering is not written yet: it is in
|
|
755
|
+
the pending list, and its contract is generated. Android marks it absent, with `Table`, as it
|
|
756
|
+
does every chart member.
|
|
757
|
+
|
|
758
|
+
- 982e684: `Highlight` is a new member: the parts of a text that match a search, marked. It is phrasing
|
|
759
|
+
content, so it sits inside a Text, a table cell or a description's detail and takes the font
|
|
760
|
+
around it. The app passes `text` and either `query`, one term or several, matched as written and
|
|
761
|
+
never as a pattern, with case folded by `locale`, or `ranges`, the `[start, end]` offsets its
|
|
762
|
+
search engine returned, which take the query's place. Marks that overlap or touch are one mark,
|
|
763
|
+
and a range is cut at the text's end. An app that printed its search engine's highlight data as
|
|
764
|
+
JSON, because nothing drew it, passes it here.
|
|
765
|
+
|
|
766
|
+
A mark is a `<mark>` in `warning.text` on `warning.subtle`, a pair the contrast law measures in
|
|
767
|
+
every pairing, at the emphasis weight, so it is marked by more than colour. A screen reader reads
|
|
768
|
+
the text once, as it is, and hears no mark.
|
|
769
|
+
|
|
770
|
+
`highlightRuns(text, { query, ranges, locale })` is a new export of the engine, and of every
|
|
771
|
+
foundation, which re-exports the engine. It returns the text as runs, `{ text, marked }`, which
|
|
772
|
+
every framework's Highlight draws.
|
|
773
|
+
|
|
774
|
+
The SwiftUI and Compose renderings are pending.
|
|
775
|
+
|
|
776
|
+
- 54a113e: `InlineEdit` is a new member in every web vocabulary: a short value, such as a project's,
|
|
777
|
+
team's or device's name, shown as text with an edit control beside it, which becomes a field
|
|
778
|
+
where it stands. It takes `value`, the saved value, `label`, which names the field and the edit
|
|
779
|
+
control ("Edit Project name"), and `onCommit`, called with the field's text as it was typed when
|
|
780
|
+
the reader saves a changed value.
|
|
781
|
+
|
|
782
|
+
The edit control opens the field with all of its text selected and focus in it. Enter and the
|
|
783
|
+
save control save, Escape and the cancel control cancel, and either way focus returns to the
|
|
784
|
+
edit control. An unchanged text reports nothing. Leaving the field neither saves nor cancels.
|
|
785
|
+
`required` refuses a blank text, `maxLength` limits it, `placeholder` stands in for an empty
|
|
786
|
+
value, and `size` sets the control height and the text step of both forms, which keep the same
|
|
787
|
+
height.
|
|
788
|
+
|
|
789
|
+
An uncontrolled field closes as soon as it saves. An app whose save waits for a server holds
|
|
790
|
+
the field with `editing` and `onEditingChange` (and `defaultEditing` for an uncontrolled first
|
|
791
|
+
state), sets `pending` while the save is in flight, which makes the field read-only and the save
|
|
792
|
+
control busy, and closes the field when the save succeeds. When the save fails, the app passes
|
|
793
|
+
`error`, which is drawn under the field as FormField draws an error, tied to the field and
|
|
794
|
+
announced, and focus moves to the field. The three strings the member says for itself are in
|
|
795
|
+
`messages` (`edit`, `save`, `cancel`), with English defaults.
|
|
796
|
+
|
|
797
|
+
It is not a form, a rich text editor or a table's edit mode: a change that needs a second field
|
|
798
|
+
or a confirmation stays in a Dialog.
|
|
799
|
+
|
|
800
|
+
The SwiftUI and Compose renderings are not written yet. `InlineEdit` is in both platforms'
|
|
801
|
+
pending lists, and both contracts are generated.
|
|
802
|
+
|
|
803
|
+
- c68a872: `Lightbox` is a new member in every web vocabulary: a picture opened large over the page, fitted
|
|
804
|
+
inside the window with nothing cropped, with previous and next when there are several.
|
|
805
|
+
|
|
806
|
+
It takes `images`, each a `src` and an `alt`, and `label`, the dialog's accessible name. It opens
|
|
807
|
+
from a `trigger`, as Dialog does, or from `open` and `defaultOpen`. `index`, `defaultIndex` and
|
|
808
|
+
`onIndexChange` hold the picture shown. `messages` holds the close, previous and next names and
|
|
809
|
+
the position line ("2 of 5"), with English defaults.
|
|
810
|
+
|
|
811
|
+
It is Dialog's machinery with a panel of its own: Dialog's scrim, focus trap, focus return,
|
|
812
|
+
Escape, scroll lock and presence motion. The panel fills the window and draws no card, so a tall
|
|
813
|
+
or wide picture is drawn whole, where a picture inside a Dialog is held to the card's width and
|
|
814
|
+
scrolls in its body. Each picture is an Image, with Image's loading and failed states. The
|
|
815
|
+
controls sit on backings, so they keep their contrast over any picture.
|
|
816
|
+
|
|
817
|
+
ArrowLeft and ArrowRight move one picture, by the page's direction. Previous and next are
|
|
818
|
+
disabled at the ends, and focus moves to the other one when the one that has it is disabled.
|
|
819
|
+
The position line is a polite status. A press beside the picture closes the lightbox. There is
|
|
820
|
+
no zoom, no swipe and no caption: the reader zooms with the browser, and a picture's words are
|
|
821
|
+
its `alt`.
|
|
822
|
+
|
|
823
|
+
The SwiftUI and Compose renderings are not written yet. `Lightbox` is in both platforms' pending
|
|
824
|
+
lists, and both contracts are generated.
|
|
825
|
+
|
|
826
|
+
- 7e3d878: `List` is a new member in every web vocabulary: a column of items of one kind, such as
|
|
827
|
+
notifications, search results or the records beside a detail pane. `List` takes `label`, the
|
|
828
|
+
list's name. `List.Item` takes `title`, `description`, `meta` (a short trailing fact the app has
|
|
829
|
+
formatted), `leading` (an Avatar, an Icon or an Image) and `trailing` (a Badge, a Button, a Menu
|
|
830
|
+
or a Switch).
|
|
831
|
+
|
|
832
|
+
An item is read, or it navigates, or it is picked. With `href` the title is a real `<a href>`
|
|
833
|
+
and `onNavigate` is the routing seam Link takes. With `onSelect` and no `href` the title is a
|
|
834
|
+
`<button>`. In both, the title's target covers the row, so an item is one tab stop with one name,
|
|
835
|
+
and a trailing control stays reachable above it. A trailing mark that is not a control, such
|
|
836
|
+
as a Badge, leaves its press to the row. A trailing box that holds a control takes every press
|
|
837
|
+
inside it, so a press on a Button that is loading or disabled never follows the row. `current` marks the item whose page or detail is open,
|
|
838
|
+
with `aria-current` and the selected surface, on which its text keeps its colours. It has no effect on an item that is only read,
|
|
839
|
+
which has no link or button to carry `aria-current`.
|
|
840
|
+
|
|
841
|
+
It replaces rows built from a `Stack`, an `Inline` and `Text`, where the fields were often joined
|
|
842
|
+
into one string. It is not Table: a table compares the same fields down its columns, and a List
|
|
843
|
+
is the form those rows take where there is no width for columns. A grouped list is several Lists,
|
|
844
|
+
each under its own `Heading`.
|
|
845
|
+
|
|
846
|
+
The SwiftUI and Compose renderings are not written yet. `List` is in both platforms' pending
|
|
847
|
+
lists, and both contracts are generated.
|
|
848
|
+
|
|
849
|
+
- b097e69: `LogView` is a new member in every web vocabulary: lines of output that arrive over time, such
|
|
850
|
+
as a build's output, an agent's console or an audit stream, with the view held at the newest
|
|
851
|
+
line while the reader is there. It takes `label`, the log's name, and `lines`, oldest first,
|
|
852
|
+
where a `LogLine` is `{ id, text, level?, time?, source? }`. `level` is `'info'`, `'warning'` or
|
|
853
|
+
`'error'`. `time` is text the application has formatted, as Timeline's is. `source` names what
|
|
854
|
+
wrote the line, such as a service or a build step.
|
|
855
|
+
|
|
856
|
+
It follows as ChatThread does, by the engine's `followEnd`: while the reader is at the end, a new
|
|
857
|
+
line keeps the end in view, and when they scroll up it stays where they put it and shows a
|
|
858
|
+
"Jump to latest" control. `streaming` draws a caret after the last line and sets `aria-busy`.
|
|
859
|
+
`wrap` is on by default, so a long line wraps; `wrap={false}` keeps each line on one row and
|
|
860
|
+
scrolls the log sideways. The words it says for itself are in `messages` (`jumpToLatest`,
|
|
861
|
+
`info`, `warning`, `error`), with English defaults.
|
|
862
|
+
|
|
863
|
+
A level is drawn as an icon in a marker cell and read as a hidden word, so colour is never the
|
|
864
|
+
only mark. The log is a `log` region that announces nothing on its own (`aria-live="off"`),
|
|
865
|
+
because a fast stream would flood a screen reader: the application announces what a stream
|
|
866
|
+
came to. It is a tab stop while it overflows, and it fills the box its container gives it.
|
|
867
|
+
|
|
868
|
+
The application owns the window: it passes the lines it wants shown and trims the old ones.
|
|
869
|
+
LogView draws every line it is passed, up to 5,000 without a visible stall. It does not
|
|
870
|
+
virtualise, parse ANSI colour codes, search or filter.
|
|
871
|
+
|
|
872
|
+
It replaces output pasted into a `CodeBlock`, which does not follow and marks no line, and log
|
|
873
|
+
lines drawn by hand. The SwiftUI and Compose renderings are not written yet. `LogView` is in
|
|
874
|
+
both platforms' pending lists, and both contracts are generated.
|
|
875
|
+
|
|
876
|
+
- 53ed1e2: Every type a member's props are written with is exported from the package root, so an
|
|
877
|
+
application can name the type of a value it builds before it passes it: an item of `items`, a
|
|
878
|
+
tone, an orientation.
|
|
879
|
+
|
|
880
|
+
`@polymorph/react-ui` now exports `BannerTone`, `CarouselSlide`, `CheckboxGroupOption`,
|
|
881
|
+
`CheckboxGroupOrientation`, `ChoiceCardOption`, `CursorPaginationMessages`,
|
|
882
|
+
`DescriptionListItem`, `DescriptionListOrientation`, `ErrorSummaryError`, `FirstDayOfWeek`,
|
|
883
|
+
`HoverCardAlign`, `HoverCardSide`, `MenuLabelEntry`, `MenuPresentation`, `MenuSeparatorEntry`,
|
|
884
|
+
`MultiSelectOption`, `OTPLength`, `ProviderButtonProvider`, `QRCodeErrorCorrection`,
|
|
885
|
+
`QRCodeSize`, `ScrollAreaOrientation`, `ScrollAreaType`, `SectionNavItem`,
|
|
886
|
+
`SegmentedControlOption`, `SegmentedControlSize`, `SplitButtonAppearance`, `SplitButtonGrid`
|
|
887
|
+
and `SplitPaneOrientation`. Each was already exported by its member's module, which an
|
|
888
|
+
application cannot import.
|
|
889
|
+
|
|
890
|
+
The Vue, Svelte, Solid and Angular vocabularies export the ones they did not have, under the
|
|
891
|
+
same names: `BannerTone`, `CheckboxGroupOrientation`, `DescriptionListOrientation`,
|
|
892
|
+
`FirstDayOfWeek`, `HoverCardAlign`, `HoverCardSide`, `MenuPresentation`, `OTPLength`,
|
|
893
|
+
`ProviderButtonProvider`, `QRCodeErrorCorrection`, `QRCodeSize`, `ScrollAreaOrientation`,
|
|
894
|
+
`ScrollAreaType`, `SegmentedControlSize`, `SplitButtonAppearance`, `SplitButtonGrid` and
|
|
895
|
+
`SplitPaneOrientation`.
|
|
896
|
+
|
|
897
|
+
Nothing is renamed or removed.
|
|
898
|
+
|
|
899
|
+
- 2ffb66b: `Menubar` is a new member in every web vocabulary: an application's command menus in one row, as
|
|
900
|
+
a desktop application's File, Edit and View. It is for an editor, a canvas or a document tool
|
|
901
|
+
whose commands are too many for one Menu. It is not navigation: a title never links.
|
|
902
|
+
|
|
903
|
+
`Menubar` takes `label`, which names the bar, `menus`, each a `MenubarMenu` with a `label`, Menu's
|
|
904
|
+
`entries` and an optional `disabled`, and `defaultOpen`, the title whose menu is open on mount.
|
|
905
|
+
Each menu is Menu's panel with Menu's entries, and each entry reports through its own handler, as
|
|
906
|
+
in Menu. The bar is one tab stop. ArrowRight and ArrowLeft move along the row in the reading
|
|
907
|
+
direction and stop at the ends, Home and End go to the first and the last title, and a letter
|
|
908
|
+
goes to the title that starts with it. ArrowDown, Enter and Space open a menu on its first entry
|
|
909
|
+
and ArrowUp on its last. In an open menu, ArrowRight and ArrowLeft open the neighbour's menu.
|
|
910
|
+
While a menu is open, the title a mouse moves onto opens its own. A long row scrolls inside its
|
|
911
|
+
box. Below `30rem` the bar is one Menu behind one overflow Button named by `label`, each menu a
|
|
912
|
+
group under its title. The member is absent on iOS and Android, where the substitute is Menu.
|
|
913
|
+
|
|
914
|
+
The engine exports the model every framework's Menubar runs: `menubarStep`, `menubarStop`,
|
|
915
|
+
`menubarOpens`, `menubarHandOff`, `menubarEntries`, `roveMenubar`, `menubarNeighbour` and
|
|
916
|
+
`menubarEdge`, with their types. Each foundation re-exports them.
|
|
917
|
+
|
|
918
|
+
In the Vue, Svelte, Solid and Angular vocabularies, a Menu's, a ContextMenu's and a SplitButton's
|
|
919
|
+
submenu row now takes focus when the keys highlight it, as every other row does, and closing the
|
|
920
|
+
submenu returns focus to its row when focus is still in the submenu, as Radix's submenu does.
|
|
921
|
+
|
|
922
|
+
- 1dad4be: `Meter` is a new member in every web vocabulary: a measured value in a known range, such as
|
|
923
|
+
storage used of a quota, money spent of a budget or seats taken of a plan. It has
|
|
924
|
+
`role="meter"`, named by `label`, with `min` (0) and `max` (100).
|
|
925
|
+
|
|
926
|
+
`warning` and `danger` are thresholds in the range's units. From each one up, the fill takes
|
|
927
|
+
that band's colour, so a screen passes the rule as numbers and does not compare at each site:
|
|
928
|
+
`<Progress tone={ratio > 0.85 ? 'danger' : 'accent'} />` becomes
|
|
929
|
+
`<Meter value={used} max={limit} danger={limit * 0.85} />`. A value outside the range is drawn
|
|
930
|
+
at the end it passed, and keeps the band of the value it was given.
|
|
931
|
+
|
|
932
|
+
`valueText` is the value in the application's words ("42 GB of 50 GB"). It is shown under the
|
|
933
|
+
bar and is the meter's `aria-valuetext`. In a band, a `warning` or `error` glyph sits before
|
|
934
|
+
it, named by `messages` ("High", "Critical" in English), so the band is never colour alone.
|
|
935
|
+
|
|
936
|
+
The bar is Progress's. Use Progress for a task moving towards done, and Meter for a value that
|
|
937
|
+
can go down as well as up. Meter draws no ring, and there is no gauge: no consumer draws one
|
|
938
|
+
yet.
|
|
939
|
+
|
|
940
|
+
The SwiftUI and Compose renderings are not written yet. `Meter` is in both platforms' pending
|
|
941
|
+
lists, and both contracts are generated.
|
|
942
|
+
|
|
943
|
+
- 773b373: `ModeSwitch` is a new member in every web vocabulary: the choice of light, dark or the system's
|
|
944
|
+
mode. It is a SegmentedControl preset with three segments, Light, Dark and System, in that order,
|
|
945
|
+
each with its mode glyph. It takes `label`, the group's accessible name, and optionally `value`,
|
|
946
|
+
`onChange`, `messages` (`{ light, dark, system }`), `size` (`sm` or `md`) and `disabled`.
|
|
947
|
+
|
|
948
|
+
Without `value`, it shows the document's preference and applies a press with the runtime's
|
|
949
|
+
`setMode`, then calls `onChange`. It follows a mode set anywhere else: another ModeSwitch, a Menu
|
|
950
|
+
entry or a command. While `system` is chosen and the operating system's mode changes, System
|
|
951
|
+
stays checked and the page follows. With `value`, it shows `value` and only calls `onChange`, so
|
|
952
|
+
an application that saves the choice on its server applies it with `setMode`, and passes the old
|
|
953
|
+
value back if the save fails.
|
|
954
|
+
|
|
955
|
+
A server render shows System, because a server stores no preference. In React, Vue and Solid the
|
|
956
|
+
render that hydrates the server's markup shows the same, so nothing mismatches, and the switch
|
|
957
|
+
shows the stored choice once it has hydrated. The page's colours are right from the first paint,
|
|
958
|
+
because the pre-paint script applies the stored mode.
|
|
959
|
+
|
|
960
|
+
The member has no stylesheet of its own. It wears SegmentedControl's recipe, and its track
|
|
961
|
+
carries `data-member="mode-switch"`. A SegmentedControl elsewhere is unchanged.
|
|
962
|
+
|
|
963
|
+
- 846f5bf: `MonthInput` is a new member in every web vocabulary: a month and a year with no day, such as a
|
|
964
|
+
card's expiry or a billing month, entered in two segments with no popup. It is DatePicker's
|
|
965
|
+
segmented entry with the month and the year segments only, in the locale's order (`7/2026` in
|
|
966
|
+
`en-US`, `2026/7` in `ja-JP`).
|
|
967
|
+
|
|
968
|
+
Its value is a `YYYY-MM` string, the form `<input type="month">` reports, with a four-digit
|
|
969
|
+
year. `onChange` reports it once both segments are filled, on each digit that changes it after
|
|
970
|
+
that, and `null` once a filled segment is erased. `min` and `max` are `YYYY-MM` too: a month
|
|
971
|
+
outside them marks the field invalid and stays in it. `name` submits the `YYYY-MM` text. It
|
|
972
|
+
takes `locale`, `size`, `disabled`, `readOnly`, `invalid` and `id` as TimeInput does, and
|
|
973
|
+
`messages` holds the one word it says that `Intl` cannot, what an empty segment says (`Empty`).
|
|
974
|
+
A filled month says its number and its name as its value (`7 – July`).
|
|
975
|
+
|
|
976
|
+
It replaces two number Inputs for a month and a year, which have two names, no order and no wrap
|
|
977
|
+
at the twelfth month. It is not DatePicker at another granularity: DatePicker's value is a day.
|
|
978
|
+
It has no month grid, no year-only form and no range.
|
|
979
|
+
|
|
980
|
+
The SwiftUI and Compose renderings are not written yet. `MonthInput` is in both platforms'
|
|
981
|
+
pending lists, and both contracts are generated.
|
|
982
|
+
|
|
983
|
+
- 49ab024: The React packages render on a server and run in Next.js's App Router, built by Turbopack or by webpack. `docs/consuming.md` has a section for a Next.js application, and `pnpm gate:next` builds one from the published builds as the last step of `pnpm gate`.
|
|
984
|
+
|
|
985
|
+
- **Each module is built once.** `@polymorph/react-ui` no longer ships a second copy of its modules without their stylesheet imports under `dist/node/`, and its `exports` have no `node` condition. A built module imports its stylesheet through the package's `imports` map (`#stylesheet/controls/button.css`), which hands a bundler the stylesheet and Node an empty module. Before, Next.js resolved a client component by the `node` condition while it built its server and carried that copy to the browser. A page whose members only server components imported then shipped no member CSS, and a page could hold two copies of a member and of its context. Vitest, jsdom and a plain server render load the package as they did, with no configuration.
|
|
986
|
+
- **An entry point has no side effect.** Each member's stylesheet module imports the base layer, and `Icon` imports its own stylesheet, so no entry point imports one and a bundler that follows a name to its module loads nothing else. No application needs to import `@polymorph/react/style.css`. The entry stays, and an application that imports it loads the same file once.
|
|
987
|
+
- **Every state of every member renders on a server.** The presence components behind the overlays read the theme from the document during render, and `MultiSelect` read its list's elements. The presence components now render without motion on a server and for the hydration of that markup, and read the theme once mounted, and `MultiSelect` reads its list in an effect. `@polymorph/engine/motion` exports `stillMotionEnvironment`, the environment they render with, and `readMotionEnvironment` returns it where there is no document.
|
|
988
|
+
- **A server component reads a compound member's parts.** `Tabs.Content`, `Table.Row` and Table's other parts, `Avatar.Group`, `SettingsRow.Group` and AppShell's parts were `undefined` in a server component, because the member attached them in a client module. Each of these members is now two modules: the member, which a server component can read, and its parts (`overlays/tabs-parts.tsx`), which carry `'use client'`. A vendored install receives the parts modules on `polymorph update`.
|
|
989
|
+
- **A member reads an element a server component passed it.** A FormField's control, a Dialog's `trigger` and a SettingsRow's `control` arrive in a client member as a reference React may still be loading. Reading one threw in Next.js's development server, and could in production while a client module loaded. `@polymorph/react` exports `useSupplied`, which returns the element once it has loaded. A member of your own that reads or clones an element it is passed calls it first.
|
|
990
|
+
|
|
991
|
+
A Next.js application that builds with webpack lists the vocabulary in `experimental.optimizePackageImports`. Without it the pages render correctly and each loads the whole vocabulary.
|
|
992
|
+
|
|
993
|
+
- 617eb16: `Pagination` takes `disabled`, the app's hold on the pager while it does something else to the
|
|
994
|
+
list, such as a bulk action or a save. It is `CursorPagination`'s `disabled`, so a `DataTable`
|
|
995
|
+
held during that work holds whichever pager its `pagination` slot has. Every control is disabled,
|
|
996
|
+
the current page too, the root carries `data-disabled`, and no page is asked for. The current
|
|
997
|
+
page keeps `aria-current`, and the pager is still drawn, so the page does not move when the hold
|
|
998
|
+
ends. The SwiftUI and Compose members take the prop too.
|
|
999
|
+
|
|
1000
|
+
A hold keeps the reader's place. A browser takes focus from a button as it is disabled: the page
|
|
1001
|
+
has it, and no control does. So when a hold disables the button that has focus, the pager moves
|
|
1002
|
+
focus to its root, the `<nav>`. The root carries `tabindex="-1"`, which makes it no tab stop, and
|
|
1003
|
+
draws the shared focus ring. The next Tab goes on to what follows the pager. A hold that begins
|
|
1004
|
+
while focus is elsewhere moves nothing.
|
|
1005
|
+
|
|
1006
|
+
When the hold ends and focus is still on the root, focus returns to the control it was taken
|
|
1007
|
+
from: previous, next, or the page of that number. So when an app holds the pager while each
|
|
1008
|
+
page loads, a keyboard reader does not have to move back to the button after every page. A
|
|
1009
|
+
control that is no longer drawn, or is still disabled, takes no focus, and focus stays on the
|
|
1010
|
+
root. If the reader moved focus during the hold, nothing moves.
|
|
1011
|
+
|
|
1012
|
+
In Vue, Svelte, Solid and Angular a page's button is the same element when it becomes the
|
|
1013
|
+
current page, as it is in React. A page the reader presses keeps focus there. Before, those four
|
|
1014
|
+
drew the current page as a new button, and the pressed one, which had focus, left the document.
|
|
1015
|
+
|
|
1016
|
+
A pager without `disabled` is otherwise unchanged, but for the `tabindex="-1"` on its root.
|
|
1017
|
+
|
|
1018
|
+
- b9e5208: `PhoneInput` is a new member in every web vocabulary: a phone number, entered as a country and
|
|
1019
|
+
a national number and reported as one E.164 string (`+442079460958`). It takes `value`,
|
|
1020
|
+
`defaultValue` and `onChange`, `defaultCountry` (ISO 3166-1 alpha-2), `countries` to restrict
|
|
1021
|
+
and order the list, `locale` for the country names, and Input's `size`, `disabled`,
|
|
1022
|
+
`readOnly`, `invalid`, `name` and `id`. FormField names, describes and marks it, as it does
|
|
1023
|
+
TimeInput. The words it writes itself are in `messages` (`country`, `showCountries`,
|
|
1024
|
+
`countriesShown`, `noCountry`), with English defaults.
|
|
1025
|
+
|
|
1026
|
+
`onChange` reports commits, never drafts, as NumberInput does: the reader leaving the number or
|
|
1027
|
+
pressing Enter in it, choosing a country, or pasting a number written with its calling code. It
|
|
1028
|
+
reports the empty string while the national number has no digits. The national field keeps
|
|
1029
|
+
digits within the E.164 limit of fifteen, and one leading trunk zero is dropped in a region
|
|
1030
|
+
that dials one, so "020 7946 0958" in the United Kingdom is `+442079460958`. A pasted
|
|
1031
|
+
`+44 20 7946 0958` sets the country and the number. A calling code that several regions share
|
|
1032
|
+
keeps the field's country when it has the code, else takes the first of `countries` with it,
|
|
1033
|
+
else the code's main region. `name` serializes the E.164 value, and the number carries
|
|
1034
|
+
`autocomplete="tel-national"`.
|
|
1035
|
+
|
|
1036
|
+
The country is a Combobox of every region's calling code and name, in `locale`, from
|
|
1037
|
+
`Intl.DisplayNames`; no flag is drawn. PhoneInput checks the form of a number only: whether it
|
|
1038
|
+
exists, and its length in its country, are the application's to check.
|
|
1039
|
+
|
|
1040
|
+
`@polymorph/engine` exports the model every framework's PhoneInput calls: `phoneCallingCode`,
|
|
1041
|
+
`phoneCountries`, `phoneCountryOptions`, `phoneDefaultCountry`, `phoneDraft`, `phoneNational`,
|
|
1042
|
+
`phoneValue`, `splitPhone`, `readPhone`, `commitPhone`, `isPhoneValue` and
|
|
1043
|
+
`PHONE_MAX_DIGITS`. An application can call `splitPhone` and `phoneValue` to read and build an
|
|
1044
|
+
E.164 string the way the member does.
|
|
1045
|
+
|
|
1046
|
+
The SwiftUI and Compose renderings are not written yet. `PhoneInput` is in both platforms'
|
|
1047
|
+
pending lists, and both contracts are generated.
|
|
1048
|
+
|
|
1049
|
+
- ee6e63c: `Plan` is a new member in every web vocabulary: the steps of one agent run, each with its
|
|
1050
|
+
status, read at a glance while the run goes on. It takes `label`, the list's name, and `steps`,
|
|
1051
|
+
where a `PlanStep` is `{ id, title, description?, status }` and the status is `pending`,
|
|
1052
|
+
`running`, `done`, `error` or `skipped`. The app passes the whole list again on every change.
|
|
1053
|
+
|
|
1054
|
+
Each step draws a glyph for its status, ToolCall's glyph where the two share a status, beside
|
|
1055
|
+
its title and an optional description. A pending or skipped step is drawn in quieter text
|
|
1056
|
+
roles. A long title wraps, and the list never widens its container. An empty list renders
|
|
1057
|
+
nothing.
|
|
1058
|
+
|
|
1059
|
+
The status is never the glyph alone. Each step reads as its title and its status words, which
|
|
1060
|
+
come from `messages.status` with English defaults. The first running step is the current step
|
|
1061
|
+
(`aria-current="step"`) and every running step is `aria-busy`. One polite status line names
|
|
1062
|
+
the step at the front of the run: the first running step, else the first failed one, else the
|
|
1063
|
+
last one done or skipped. It changes once for each step the run reaches, and a description the
|
|
1064
|
+
app updates while a step runs is not announced.
|
|
1065
|
+
|
|
1066
|
+
It is not Stepper, which is the reader's own flow, not Timeline, whose events are over, and
|
|
1067
|
+
not ToolCall, which is one invocation. It has no nested steps, nothing to press and nothing to
|
|
1068
|
+
open.
|
|
1069
|
+
|
|
1070
|
+
The SwiftUI and Compose renderings are not written yet. `Plan` is in both platforms' pending
|
|
1071
|
+
lists, and both contracts are generated.
|
|
1072
|
+
|
|
1073
|
+
- cb335db: `Progress` takes `shape="ring"`, which draws the same value as a ring at Spinner's sizes
|
|
1074
|
+
(`size`: `sm`, `md` or `lg`, the icon box). It is for the place a Spinner sits, such as a file
|
|
1075
|
+
row, a chip or a line of text, once the task knows how far it has got. The ring is named and
|
|
1076
|
+
valued as the bar is, renders no text, starts at the top and fills clockwise in either reading
|
|
1077
|
+
direction. Its arc is the solid accent, or the danger solid. A ring with no value is a Spinner,
|
|
1078
|
+
so `value` stays required.
|
|
1079
|
+
|
|
1080
|
+
A Progress that passes no `shape` renders as before, with one change: in a right-to-left
|
|
1081
|
+
document the bar now fills from the right, as SwiftUI's and Compose's already did.
|
|
1082
|
+
|
|
1083
|
+
The ring is drawn in SwiftUI and Compose too.
|
|
1084
|
+
|
|
1085
|
+
- 3dc5f0f: `PromptInput` takes `triggers`, in every web vocabulary: characters that open a list of the app's
|
|
1086
|
+
suggestions, such as `@` for people and `/` for commands. A composer without `triggers` is
|
|
1087
|
+
unchanged.
|
|
1088
|
+
|
|
1089
|
+
```tsx
|
|
1090
|
+
<PromptInput
|
|
1091
|
+
label="Message"
|
|
1092
|
+
onSubmit={send}
|
|
1093
|
+
triggers={[
|
|
1094
|
+
{
|
|
1095
|
+
char: '@',
|
|
1096
|
+
label: 'People',
|
|
1097
|
+
options: people,
|
|
1098
|
+
onSelect: (person) => mention(person.id),
|
|
1099
|
+
},
|
|
1100
|
+
{ char: '/', label: 'Commands', at: 'start', options: commands },
|
|
1101
|
+
]}
|
|
1102
|
+
/>
|
|
1103
|
+
```
|
|
1104
|
+
|
|
1105
|
+
A trigger is `{ char, label, options, at?, filter?, loading?, onQueryChange?, onSelect? }`, and
|
|
1106
|
+
an option `{ id, label, description?, icon?, insert? }`. The list opens while the caret is in a
|
|
1107
|
+
token: the character at the start of the prompt or after whitespace (`at: 'word'`, the default),
|
|
1108
|
+
or only as the prompt's first character (`at: 'start'`), followed by the query, which holds no
|
|
1109
|
+
whitespace. The member filters the options by the query as Combobox does; `filter: false` shows
|
|
1110
|
+
the app's own results, which it loads from `onQueryChange` while `loading` is set.
|
|
1111
|
+
|
|
1112
|
+
The prompt stays plain text. Enter, Tab or a press picks the active option: the typed token is
|
|
1113
|
+
replaced by the option's `insert`, or by the character and the label (`@Ada Lovelace`), and a
|
|
1114
|
+
space, and the trigger's `onSelect` is called with the option. `insert: ''` removes the token and
|
|
1115
|
+
writes nothing, for a command the app runs at once. The composer reports picks only: an app that
|
|
1116
|
+
sends mentions checks, when the prompt is sent, which picked options' text is still in it.
|
|
1117
|
+
|
|
1118
|
+
While the list is open, ArrowUp and ArrowDown move the active option. Enter does nothing while the
|
|
1119
|
+
trigger is `loading` with no option shown, and sends the prompt when nothing matches, as with the
|
|
1120
|
+
list closed. Escape closes the list and keeps the text; inside a Dialog the dialog stays open until
|
|
1121
|
+
the next Escape. Focus stays in the field, which carries
|
|
1122
|
+
`aria-autocomplete="list"`, `aria-haspopup="listbox"`, and, while the list is open,
|
|
1123
|
+
`aria-controls` and `aria-activedescendant`. A polite live region says how many options there
|
|
1124
|
+
are. `PromptInputMessages` gains three optional strings: `suggestions(count)`,
|
|
1125
|
+
`loadingSuggestions` and `noSuggestions`. The list opens above the composer, or below it when the
|
|
1126
|
+
viewport has more room below, at the composer's width at every width. It is drawn in the
|
|
1127
|
+
composer's root, so the composer's container must not clip it. The types are `PromptTrigger` and
|
|
1128
|
+
`PromptTriggerOption`.
|
|
1129
|
+
|
|
1130
|
+
A composer focused on mount by `autoFocus` now has its caret at the end of its prompt in React,
|
|
1131
|
+
as it already had in the other vocabularies.
|
|
1132
|
+
|
|
1133
|
+
`promptToken(text, caret, triggers)` and `promptPick(text, token, caret, insertion)` are new
|
|
1134
|
+
exports of the engine, and of every foundation, which re-exports the engine: the token the caret
|
|
1135
|
+
is in, and the text and caret a pick leaves. The types are `PromptToken` and
|
|
1136
|
+
`PromptTokenTrigger`.
|
|
1137
|
+
|
|
1138
|
+
The SwiftUI and Compose contracts carry `triggers`, `PMPromptTrigger` and
|
|
1139
|
+
`PMPromptTriggerOption`, and neither rendering draws a list: an `@` or a `/` stays text in the
|
|
1140
|
+
prompt on iOS and Android.
|
|
1141
|
+
|
|
1142
|
+
- 9f8c97f: `Rating` is a new member in every web vocabulary: a score out of a few marks, five stars by
|
|
1143
|
+
default, that a reader sets ("Rate this answer") or reads ("Average rating: 4.3 out of 5").
|
|
1144
|
+
|
|
1145
|
+
Set, it is a radio group with one radio per mark, named for the value it sets ("3 stars").
|
|
1146
|
+
`value`, `defaultValue` and `onChange` are a whole number from 1 to `max`, and `null` for no
|
|
1147
|
+
rating. A press on the chosen mark clears it, unless the rating is required (`aria-required`,
|
|
1148
|
+
which FormField sets). The arrows move and choose, following the document's direction, Home
|
|
1149
|
+
and End choose the first and the last mark, and the arrows stop at the ends. `name` posts the
|
|
1150
|
+
value. Shown (`readOnly`), it is one image named by a sentence, and it draws any value to one
|
|
1151
|
+
decimal place, with the mark the fraction lands in part filled. `max` is 2 to 10, `size` is the
|
|
1152
|
+
marks' icon size, and `messages` with `locale` writes the marks' names and the sentence. Filled
|
|
1153
|
+
and empty marks differ in shape, a solid star against an outline.
|
|
1154
|
+
|
|
1155
|
+
It is not RadioGroup, whose options are labelled rows, and not Meter, which measures against a
|
|
1156
|
+
limit. Thumbs up and down under a reply are two pressed Buttons.
|
|
1157
|
+
|
|
1158
|
+
Its model is new in the engine, and so in every foundation, which re-exports it: `ratingModel`
|
|
1159
|
+
(the marks, their fills and names, and the shown sentence), `ratingPress` (the clear rule),
|
|
1160
|
+
`ratingStep` and `roveRating` (the keys), `ratingMax` and `RATING_DEFAULT_MAX`, with the types
|
|
1161
|
+
`RatingModel`, `RatingMark`, `RatingFill`, `RatingOptions`, `RatingWords` and
|
|
1162
|
+
`RatingKeyEvent`.
|
|
1163
|
+
|
|
1164
|
+
The SwiftUI and Compose renderings are not written yet. `Rating` is in both platforms' pending
|
|
1165
|
+
lists, and both contracts are generated.
|
|
1166
|
+
|
|
1167
|
+
- 2f47e9e: `RecordButton` is a new member in every web vocabulary: a Button preset that starts and stops a
|
|
1168
|
+
recording the application makes, such as voice input in `PromptInput`'s `trailing` slot. It
|
|
1169
|
+
takes `label`, the Button's name while not recording ("Record a voice message"), and
|
|
1170
|
+
`stopLabel`, its name while recording ("Stop recording").
|
|
1171
|
+
|
|
1172
|
+
The application owns the microphone. It calls `getUserMedia` and `MediaRecorder` itself and
|
|
1173
|
+
passes `recording`, `elapsed` (the seconds recorded) and `level` (the input level from 0 to 1).
|
|
1174
|
+
A press calls `onStart` while not recording and `onStop` while recording, and changes nothing
|
|
1175
|
+
until the application passes `recording`. `locale` writes the time's numerals, `disabled` and
|
|
1176
|
+
`size` (`sm` or `md`) are Button's.
|
|
1177
|
+
|
|
1178
|
+
At rest it is a ghost Button with the new `record` glyph, a microphone. While recording it is an
|
|
1179
|
+
outline Button with the `stop` glyph, and before it a meter: a red dot with a halo sized by the
|
|
1180
|
+
level, and the time as m:ss. The Button's name changes with the state and it carries no
|
|
1181
|
+
`aria-pressed`. The time is text a reader can reach and is not a live region. Under reduced
|
|
1182
|
+
motion the halo does not grow, and the level is its opacity.
|
|
1183
|
+
|
|
1184
|
+
The SwiftUI and Compose renderings are not written yet. `RecordButton` is in both platforms'
|
|
1185
|
+
pending lists, and both contracts are generated.
|
|
1186
|
+
|
|
1187
|
+
- f0d907c: `SectionNav` is a new member in every web vocabulary: the row of links between the sibling pages
|
|
1188
|
+
of one section, with the page the reader is on marked. It takes `label` (the landmark's name),
|
|
1189
|
+
`items` (`{ label, href }`), `current` (the `href` of the current item) and `onNavigate`, the
|
|
1190
|
+
routing seam Link and Breadcrumbs take. Each item is a real `<a href>`; the current one carries
|
|
1191
|
+
`aria-current="page"` and the selection treatment the AppShell rail gives its current item. The
|
|
1192
|
+
row wraps on a narrow screen.
|
|
1193
|
+
|
|
1194
|
+
`current` is compared with each `href` as the page it names: a trailing slash, a query and a
|
|
1195
|
+
hash on either side do not stop the match, and neither does an origin on `current`, so a router's
|
|
1196
|
+
location or `location.href` can be passed as it is. An item written with an origin matches only a
|
|
1197
|
+
`current` with the same one. An item whose `href` is exactly `current` comes first, and at most
|
|
1198
|
+
one item is current.
|
|
1199
|
+
|
|
1200
|
+
It replaces a `<nav>` of `Link`s in an `Inline`, where each app drew the current item its own
|
|
1201
|
+
way and most left out `aria-current`. It is not Tabs: a tab shows a panel of the same page and
|
|
1202
|
+
has no address.
|
|
1203
|
+
|
|
1204
|
+
The SwiftUI and Compose renderings are not written yet. `SectionNav` is in both platforms'
|
|
1205
|
+
pending lists, and both contracts are generated.
|
|
1206
|
+
|
|
1207
|
+
- 0936316: `TableOfContents` is a new member in every web vocabulary: the list of links to the sections of
|
|
1208
|
+
one long page ("On this page"), with the section the reader is in marked. It takes `label` (the
|
|
1209
|
+
landmark's name, drawn above the list), `items` (`{ id, label, level? }`, where `id` is the id of
|
|
1210
|
+
the section's element in the document and `level: 2` draws a subsection one step in, in a list
|
|
1211
|
+
inside its section's item) and `onCurrentChange`, called with the current section's id or
|
|
1212
|
+
`null`. Each item is a real `<a href="#id">`; the current one carries `aria-current="location"`
|
|
1213
|
+
and the selection treatment SectionNav gives its current item.
|
|
1214
|
+
|
|
1215
|
+
The current section is the last one whose top has reached a line a quarter of the way down the
|
|
1216
|
+
page that scrolls around the sections, or the last section when the page is scrolled to its end.
|
|
1217
|
+
A click marks its item at once, holds the mark while the browser scrolls to the section, and
|
|
1218
|
+
moves focus to the section, which takes `tabindex="-1"` only while it has focus. An item whose
|
|
1219
|
+
section is not in the document is drawn and never marked. The member does not scroll and does
|
|
1220
|
+
not stay in view on its own: the page's CSS owns `scroll-behavior`, and the app places the list.
|
|
1221
|
+
|
|
1222
|
+
It is not SectionNav, whose items are pages the router marks.
|
|
1223
|
+
|
|
1224
|
+
`watchSections(owner, ids, report)` and `jumpToSection(owner, id, event)` are new exports of the
|
|
1225
|
+
engine, and of every foundation, which re-exports the engine, with `SECTION_LINE` (0.25), the
|
|
1226
|
+
line's place as a fraction of the page's height. Every framework's TableOfContents follows the
|
|
1227
|
+
page with them.
|
|
1228
|
+
|
|
1229
|
+
The SwiftUI and Compose renderings are not written yet. `TableOfContents` is in both platforms'
|
|
1230
|
+
pending lists, and both contracts are generated, with the item's shape.
|
|
1231
|
+
|
|
1232
|
+
- f870095: `Text` takes `lines`, the most lines a paragraph draws: `1` for a name, an address or an id in a
|
|
1233
|
+
row, or more for a description. The last line ends with an ellipsis, and a word longer than the
|
|
1234
|
+
line breaks, so a long id is cut at the last line and never widens what holds it. Only the drawing
|
|
1235
|
+
is cut: a screen reader, a search in the page and a copy get the whole text. The spec's rule is
|
|
1236
|
+
that a Text with `lines` holds text whose whole a sighted reader can reach another way, such as the
|
|
1237
|
+
page the row opens; the member opens no tooltip. An app that wrote ellipsis CSS, or cut a string
|
|
1238
|
+
with `slice(0, n) + '…'`, passes `lines` instead. SwiftUI draws it as the text's line limit;
|
|
1239
|
+
Compose's Text cannot set a limit on the text an app passes, so an app there sets `maxLines` on
|
|
1240
|
+
its own `Text`.
|
|
1241
|
+
|
|
1242
|
+
A Text without `lines` is unchanged.
|
|
1243
|
+
|
|
1244
|
+
- 6119b46: Another library's component has a declared boundary. `ThirdParty` is a rung-4 primitive beside
|
|
1245
|
+
`Bespoke`, in every web vocabulary (`<pm-third-party>` in an Angular template): it wraps a map, a
|
|
1246
|
+
rich-text editor, a data grid or any component the vocabulary does not draw, and takes the
|
|
1247
|
+
package's name as `library` and a `reason`. It draws nothing.
|
|
1248
|
+
|
|
1249
|
+
The red rules read it. A boundary hosts its library only in a file that imports a binding from the
|
|
1250
|
+
package it names: a default, a name or a namespace, from that specifier or a path inside it, an
|
|
1251
|
+
`import()` of one, or `import L = require('…')`. A side-effect import, a type import and a
|
|
1252
|
+
stylesheet import bring no binding. `no-raw-styles` reports a boundary that hosts nothing, on its
|
|
1253
|
+
own tag: one with no `library` written out, one whose `library` is not spelled as a package, one
|
|
1254
|
+
whose `library` is a polymorph package or a framework's own runtime (`react`, `vue`, `svelte`,
|
|
1255
|
+
`solid-js`, `@angular/core` and the other packages each framework ships as its runtime), and one
|
|
1256
|
+
whose package the file imports no binding from.
|
|
1257
|
+
|
|
1258
|
+
Inside a boundary that hosts, a plain element and the library's own component take `style` and a
|
|
1259
|
+
class, and a raw length is allowed. The file may import that library's stylesheet, which
|
|
1260
|
+
`no-app-css` banned with no rung to answer it. It may import a package `no-external-dataviz` or
|
|
1261
|
+
`no-external-motion` bans when `library` is that package's name as the rule lists it. Another
|
|
1262
|
+
package of the same npm scope is not lifted. Everything else stays red: a raw control, an inline
|
|
1263
|
+
`<svg>`, and a class or a `style` on a member or on a part of one (`<Table.Row>`). A colour stays
|
|
1264
|
+
red in every syntax. In a `style` the boundary lifts, a property that takes a colour takes a
|
|
1265
|
+
custom property read (`var(--pm-…)`), a keyword that names no colour, or a value computed where
|
|
1266
|
+
it is written, and a named colour or `color-mix()` is reported. The `style` is read through a
|
|
1267
|
+
cast, a conditional, a spread of an object, Vue's array of styles and CSS text with values
|
|
1268
|
+
computed inside it, and one whose property names are not written out (`style={styles}`) is
|
|
1269
|
+
reported, because its colours cannot be read. A disable comment inside the boundary is still
|
|
1270
|
+
undeclared.
|
|
1271
|
+
|
|
1272
|
+
`pnpm inventory` lists each boundary at rung 4 with its library, and `hostedLibraries` in
|
|
1273
|
+
`@polymorph/rules/inventory` returns the libraries an application hosts. `Exception` gains an
|
|
1274
|
+
optional `library`. A boundary that writes no `library` out is listed with no rung, with the kind
|
|
1275
|
+
`NAMELESS_BOUNDARY` exports, and `pnpm inventory` exits 1 on it. In a Vue template the inventory
|
|
1276
|
+
reads a tag by the name Vue resolves it to, as lint does, so `<third-party>`, `<bespoke>` and
|
|
1277
|
+
`<density-scope>` are listed and a disable inside a `<bespoke>` zone is accounted for.
|
|
1278
|
+
|
|
1279
|
+
Reports change in these cases. A stylesheet imported from a package names the boundary that hosts
|
|
1280
|
+
it where the file imports a binding from that package, and says why no boundary lifts it where
|
|
1281
|
+
the file does not. A chart library no chart member replaces names the boundary. A file that hosts
|
|
1282
|
+
a library is told to read a colour from `useThemeValues()`. No lawful code becomes a violation,
|
|
1283
|
+
and nothing is renamed or removed.
|
|
1284
|
+
|
|
1285
|
+
- 00bce31: `Tour` is a new member in every web vocabulary: a short walk through the parts of a page, one
|
|
1286
|
+
step at a time, that a reader goes through once and can leave at any step. It takes `steps`,
|
|
1287
|
+
where a `TourStep` is `{ id, target?, title, body, side? }`. A step names the part it points at
|
|
1288
|
+
by the `name` of a `Tour.Target`, which the application puts around that part and which adds no
|
|
1289
|
+
box (`display: contents`). A step with no `target`, or whose target is not drawn when it opens,
|
|
1290
|
+
is drawn centred.
|
|
1291
|
+
|
|
1292
|
+
The application opens the tour (`open`, `defaultOpen`) and records that it was seen: the member
|
|
1293
|
+
stores nothing, and `onEnd(reason)` says why the reader ended it, `finished` from the last
|
|
1294
|
+
step's Done or `dismissed` from Escape or the close control. The step is `step`, `defaultStep`
|
|
1295
|
+
and `onStepChange`. The words it writes itself are in `messages` (`next`, `previous`, `done`,
|
|
1296
|
+
`close`, `position`), with English defaults.
|
|
1297
|
+
|
|
1298
|
+
Each step's panel is a modal dialog, named by the step's title and described by its body and
|
|
1299
|
+
its position ("Step 2 of 3"). Focus moves to the panel when each step opens and returns to where
|
|
1300
|
+
it was when the tour ends. The rest of the page is hidden from assistive technology and takes no
|
|
1301
|
+
presses, and the target is cut out of the scrim. The page keeps its scroll: the target is
|
|
1302
|
+
scrolled into view when its step opens, and the panel and the cut-out follow it.
|
|
1303
|
+
|
|
1304
|
+
The engine, and every foundation, which re-exports it, has five new exports for it:
|
|
1305
|
+
`tourTarget(name)` finds a step's target, `tourTargetRect(element)` measures the boxes inside
|
|
1306
|
+
it, `revealTourTarget(element)` scrolls it into view, `tourViewport()` is the window's size, and
|
|
1307
|
+
`tourPlacement(target, box, viewport, side)` places a panel beside a rectangle and inside the
|
|
1308
|
+
window. The types are `TourPlacement`, `TourRect`, `TourSide` and `TourSize`, and the attribute
|
|
1309
|
+
a target carries is `TOUR_TARGET_ATTRIBUTE`.
|
|
1310
|
+
|
|
1311
|
+
- fadf225: `TreeSelect` is a new member in every web vocabulary: a field that picks one node of a hierarchy,
|
|
1312
|
+
such as the unit a unit moves under, the folder a file goes into or the category an item belongs
|
|
1313
|
+
to. It is Select's trigger with the Tree member in its popup. It replaces a flat Select whose
|
|
1314
|
+
option labels carry each node's depth or path.
|
|
1315
|
+
|
|
1316
|
+
It takes Tree's data unchanged: `items`, `expanded`, `defaultExpanded`, `onExpandedChange`,
|
|
1317
|
+
`loading`, `hasMore` and `onLoadMore`, and a required `label` that names the tree in the popup, as
|
|
1318
|
+
Tree's does. The value is one node's id: `value`, `defaultValue` and `onChange(id | null)`.
|
|
1319
|
+
`emptyOption` draws a first top-level item, such as "Top level", that reports `null`, as Select's
|
|
1320
|
+
empty choice does. `valueLabel` is what the trigger shows while the chosen node's level is not
|
|
1321
|
+
loaded. `placeholder`, `size`, `invalid`, `disabled`, `name`, `id`, `defaultOpen`, `presentation`
|
|
1322
|
+
and the ARIA props are Select's, and `messages` is Tree's.
|
|
1323
|
+
|
|
1324
|
+
Opening the popup opens the branches above the chosen node and puts focus on it. Enter, Space or
|
|
1325
|
+
a press on a node's row chooses it, closes the popup and returns focus to the trigger. ArrowRight
|
|
1326
|
+
and the chevron open a branch without choosing it. Below `30rem` the popup is the shared bottom
|
|
1327
|
+
sheet. It has no search: an application with a searchable flat list uses Combobox.
|
|
1328
|
+
|
|
1329
|
+
The SwiftUI and Compose renderings are not written yet. `TreeSelect` is in both platforms'
|
|
1330
|
+
pending lists, and both contracts are generated.
|
|
1331
|
+
|
|
1332
|
+
- 40e1bf4: `Tree` is a new member in every web vocabulary: a hierarchy of items of one kind, such as
|
|
1333
|
+
organization units, folders or categories, which a reader opens level by level and picks one
|
|
1334
|
+
item from. It takes `label`, the tree's name, and `items`, where a `TreeItem` is
|
|
1335
|
+
`{ id, label, description?, children?, hasChildren?, loading?, hasMore?, disabled? }`.
|
|
1336
|
+
|
|
1337
|
+
The open branches are `expanded`, `defaultExpanded` and `onExpandedChange`, with DataTable's
|
|
1338
|
+
types: the tree holds the set unless `expanded` is passed. The selection is `value`,
|
|
1339
|
+
`defaultValue` and `onChange`, and `value={null}` selects nothing. A press on a chevron opens
|
|
1340
|
+
or closes a branch and selects nothing. A press on the rest of a row selects it and opens
|
|
1341
|
+
nothing. Selection does not follow focus.
|
|
1342
|
+
|
|
1343
|
+
The application loads a level. A branch with `hasChildren` and no `children` opens onto
|
|
1344
|
+
nothing: `onExpandedChange` reports it, and the application sets `loading` on the item and
|
|
1345
|
+
then passes its `children`. `hasMore` on an item, or on the tree for the top level, draws a
|
|
1346
|
+
last row that asks for more, and `onLoadMore` is called with the branch's id, or with `null`
|
|
1347
|
+
for the top level. `loading` on the tree says the top level is loading. The two strings the
|
|
1348
|
+
tree says for itself are in `messages` (`loading`, `loadMore`), with English defaults.
|
|
1349
|
+
|
|
1350
|
+
It is `role="tree"` with one tab stop. ArrowDown and ArrowUp move through the rows that are
|
|
1351
|
+
drawn, ArrowRight opens a branch and then moves into it, ArrowLeft closes one or moves to the
|
|
1352
|
+
branch above, Home and End go to the first and last row, and Enter and Space select. ArrowLeft
|
|
1353
|
+
and ArrowRight swap where the page reads right to left. A disabled item takes no focus and no
|
|
1354
|
+
press, and a disabled branch is drawn closed. When a level arrives, focus stays where it was.
|
|
1355
|
+
When the reader asked for more of a level, focus moves to the first new row.
|
|
1356
|
+
|
|
1357
|
+
It replaces a hierarchy drawn one level at a time from Buttons, with a control to go back,
|
|
1358
|
+
which had no tree roles and no arrow keys. It is not JsonTree, which shows one JSON value and
|
|
1359
|
+
selects nothing. It has no multiple selection, no drag and drop, no rename in place, no
|
|
1360
|
+
actions on a row and no type-ahead, and it draws every row it is given.
|
|
1361
|
+
|
|
1362
|
+
The SwiftUI and Compose renderings are not written yet. `Tree` is in both platforms' pending
|
|
1363
|
+
lists, and both contracts are generated.
|
|
1364
|
+
|
|
1365
|
+
- 59658db: `Treemap` is a new chart member in every web vocabulary: parts of a whole as rectangles that
|
|
1366
|
+
tile the plot, each with an area proportional to its value, such as storage by kind or tickets
|
|
1367
|
+
by team and channel. It takes `label` and `items`, where a `TreemapItem` is
|
|
1368
|
+
`{ key, label, value, children? }`, and the tier's `format`, `size`, `locale`, `tooltip`,
|
|
1369
|
+
`onSelect`, `loading` and `messages`.
|
|
1370
|
+
|
|
1371
|
+
The layout is squarified, largest first from the inline start, and the same items and size
|
|
1372
|
+
always give the same tiles. An item with `children` is a group, drawn as the sum of its
|
|
1373
|
+
children; two levels are drawn, and deeper items are summed into the second with a dev
|
|
1374
|
+
warning. With groups, each group takes a chart slot and its items its colour, with a legend of
|
|
1375
|
+
the groups and a wider gap between them; with one level every tile is one colour. An item with
|
|
1376
|
+
no positive value takes no area: the twin lists it and the summary counts it. A tile shows its
|
|
1377
|
+
label and value on a plate of the surface colour, and only where both fit; the tooltip, the
|
|
1378
|
+
live region and the twin name every item.
|
|
1379
|
+
|
|
1380
|
+
`squarify`, `treemapModel`, `treemapReadout` and `treemapSelection` are new exports of
|
|
1381
|
+
`@polymorph/engine/charts`, and of every foundation, which re-exports it, with the types
|
|
1382
|
+
`TreemapItem`, `TreemapInput`, `TreemapModel`, `TreemapPlot`, `TreemapTile`, `TreemapPlate`,
|
|
1383
|
+
`TreemapLeaf` and `TreemapRect`.
|
|
1384
|
+
|
|
1385
|
+
`ChartMessages` has three new keys, with English defaults in `DEFAULT_CHART_MESSAGES`:
|
|
1386
|
+
`treemapSummary`, `groupColumn` and `itemColumn`. A host that spreads the defaults is
|
|
1387
|
+
unaffected. A host that writes its own whole catalog adds the three keys.
|
|
1388
|
+
|
|
1389
|
+
On iOS, `PMChartMessages` takes the same three, and `PMSpecDefault.chartMessages` gives their
|
|
1390
|
+
English. `Treemap` is adapted on iOS, drawn with SwiftUI shapes because Swift Charts has no mark
|
|
1391
|
+
that tiles a box by area; its rendering is not written yet, so it is in the pending list, and
|
|
1392
|
+
its contract is generated. Android marks it absent, with `Table`, as it does every chart member.
|
|
1393
|
+
|
|
1394
|
+
- d9059ea: `Badge` takes `count`, `max` and `dot`. `count` draws a number in the text's place, as `99+` past
|
|
1395
|
+
`max` (99 by default), and draws nothing at zero. `dot` draws a round mark with no text, for
|
|
1396
|
+
"something is new", and keeps `children` as the words a screen reader hears; a dot with no
|
|
1397
|
+
`children` is hidden from assistive technology. `children` is now optional, because a count has no
|
|
1398
|
+
text of its own.
|
|
1399
|
+
|
|
1400
|
+
`Button` takes `count: { value, label }`, for the unread items behind a bell. Above zero, a count
|
|
1401
|
+
Badge sits on the corner of an icon-only button, or after the label of any other, and `count.label`
|
|
1402
|
+
is the button's accessible name, in the app's words ("Notifications, 3 unread"). At zero neither
|
|
1403
|
+
shows. An app that capped a Badge at "99+" by hand beside an icon-only Button, and repeated the
|
|
1404
|
+
count in the button's `label`, passes `count` instead. The SwiftUI and Compose members draw both.
|
|
1405
|
+
|
|
1406
|
+
A Badge or a Button without the new props is unchanged.
|
|
1407
|
+
|
|
1408
|
+
- Updated dependencies [358158d]
|
|
1409
|
+
- Updated dependencies [69c3d82]
|
|
1410
|
+
- Updated dependencies [6d714a7]
|
|
1411
|
+
- Updated dependencies [bda0b87]
|
|
1412
|
+
- Updated dependencies [28aeda0]
|
|
1413
|
+
- Updated dependencies [9153bdd]
|
|
1414
|
+
- Updated dependencies [96a3846]
|
|
1415
|
+
- Updated dependencies [b209e98]
|
|
1416
|
+
- Updated dependencies [e584e0a]
|
|
1417
|
+
- Updated dependencies [aec76ec]
|
|
1418
|
+
- Updated dependencies [51e8566]
|
|
1419
|
+
- Updated dependencies [a35c79a]
|
|
1420
|
+
- Updated dependencies [e708348]
|
|
1421
|
+
- Updated dependencies [f69f55e]
|
|
1422
|
+
- Updated dependencies [766b5fd]
|
|
1423
|
+
- Updated dependencies [982e684]
|
|
1424
|
+
- Updated dependencies [54a113e]
|
|
1425
|
+
- Updated dependencies [6ffbb00]
|
|
1426
|
+
- Updated dependencies [c68a872]
|
|
1427
|
+
- Updated dependencies [7e3d878]
|
|
1428
|
+
- Updated dependencies [b097e69]
|
|
1429
|
+
- Updated dependencies [2ffb66b]
|
|
1430
|
+
- Updated dependencies [1dad4be]
|
|
1431
|
+
- Updated dependencies [d9713d4]
|
|
1432
|
+
- Updated dependencies [846f5bf]
|
|
1433
|
+
- Updated dependencies [49ab024]
|
|
1434
|
+
- Updated dependencies [617eb16]
|
|
1435
|
+
- Updated dependencies [b9e5208]
|
|
1436
|
+
- Updated dependencies [ee6e63c]
|
|
1437
|
+
- Updated dependencies [cb335db]
|
|
1438
|
+
- Updated dependencies [3dc5f0f]
|
|
1439
|
+
- Updated dependencies [9f8c97f]
|
|
1440
|
+
- Updated dependencies [9f8c97f]
|
|
1441
|
+
- Updated dependencies [2f47e9e]
|
|
1442
|
+
- Updated dependencies [96daa65]
|
|
1443
|
+
- Updated dependencies [f0d907c]
|
|
1444
|
+
- Updated dependencies [3b0b47f]
|
|
1445
|
+
- Updated dependencies [0936316]
|
|
1446
|
+
- Updated dependencies [f870095]
|
|
1447
|
+
- Updated dependencies [b88e331]
|
|
1448
|
+
- Updated dependencies [6119b46]
|
|
1449
|
+
- Updated dependencies [303bb18]
|
|
1450
|
+
- Updated dependencies [fc7f5cd]
|
|
1451
|
+
- Updated dependencies [b2a20ff]
|
|
1452
|
+
- Updated dependencies [00bce31]
|
|
1453
|
+
- Updated dependencies [fadf225]
|
|
1454
|
+
- Updated dependencies [40e1bf4]
|
|
1455
|
+
- Updated dependencies [59658db]
|
|
1456
|
+
- Updated dependencies [d9059ea]
|
|
1457
|
+
- Updated dependencies [4902f58]
|
|
1458
|
+
- @polymorph/recipes@1.0.12
|
|
1459
|
+
- @polymorph/react@1.0.12
|
|
1460
|
+
|
|
1461
|
+
## 1.0.10
|
|
1462
|
+
|
|
1463
|
+
### Patch Changes
|
|
1464
|
+
|
|
1465
|
+
- cb0d0a3: Members follow a right-to-left document. With `dir="rtl"` on `<html>` or `<body>`, every member built on Radix or Zag now takes that direction: its root says `dir="rtl"`, and the arrow keys, a Slider's track, a submenu's side and a Tabs strip turn with the page. Before, those members wrote `dir="ltr"` on their root and ran left to right inside a right-to-left page. A member already on the page follows a change to the attribute. There is no new prop, and a left-to-right page renders as it did.
|
|
1466
|
+
|
|
1467
|
+
Each foundation exports `useDirection`, which returns the document's direction and keeps it current, and `@polymorph/engine` exports `readDirection` and `watchDirection` beneath it.
|
|
1468
|
+
|
|
1469
|
+
The page-transition indicator's right-to-left rule now reads `dir` instead of `:dir()`, which the published build's minifier had rewritten as a list of languages.
|
|
1470
|
+
|
|
1471
|
+
- Updated dependencies [cb0d0a3]
|
|
1472
|
+
- @polymorph/recipes@1.0.10
|
|
1473
|
+
- @polymorph/react@1.0.10
|
|
1474
|
+
|
|
1475
|
+
## 1.0.9
|
|
1476
|
+
|
|
1477
|
+
### Patch Changes
|
|
1478
|
+
|
|
1479
|
+
- @polymorph/react@1.0.9
|
|
1480
|
+
- @polymorph/recipes@1.0.9
|
|
1481
|
+
|
|
1482
|
+
## 1.0.8
|
|
1483
|
+
|
|
1484
|
+
### Patch Changes
|
|
1485
|
+
|
|
1486
|
+
- 2bccb19: `AvatarButton` is a new member: a Button preset whose face is an Avatar. Use it wherever a
|
|
1487
|
+
person's or a workspace's mark is pressed to do something, most often as the `trigger` of an
|
|
1488
|
+
account `Menu` or `Popover`. It takes Avatar's `name` and `src`, a required `label` that names
|
|
1489
|
+
the action ("Account menu", not the person's name), and Button's `size`, `disabled`, `loading`,
|
|
1490
|
+
`pressed`, `current` and `onClick`. It keeps Button's ghost/neutral states, focus ring and
|
|
1491
|
+
minimum target, with a round box around the face, and an overlay's `aria-haspopup` and
|
|
1492
|
+
`aria-expanded` land on it as they do on a Button.
|
|
1493
|
+
|
|
1494
|
+
It replaces the workaround of stacking an invisible `Button` over an `Avatar` inside a `Bespoke`
|
|
1495
|
+
zone. Replace that zone with `<AvatarButton name={…} src={…} label="Account menu" />` and delete
|
|
1496
|
+
the zone's declared exception. `Button` still takes no children, and `Avatar` is still not
|
|
1497
|
+
interactive.
|
|
1498
|
+
|
|
1499
|
+
It ships in every renderer: the React, Vue, Svelte, Solid and Angular vocabularies from this
|
|
1500
|
+
release of each package and of `@polymorph/recipes`, and SwiftUI (`PMAvatarButton`) and Compose
|
|
1501
|
+
(`PMAvatarButton`) at this release's tag.
|
|
1502
|
+
|
|
1503
|
+
- 2bccb19: `Image` is a new member: a read-only picture, such as a photograph, a brand mark, artwork or a
|
|
1504
|
+
preview of a file. It replaces a bare `<img>` in application code, and the application CSS that
|
|
1505
|
+
sized it.
|
|
1506
|
+
|
|
1507
|
+
```tsx
|
|
1508
|
+
<Image src={logo} alt="Relay" width={90} height={32} loading="eager" />
|
|
1509
|
+
<Image src={artwork} alt="" crossOrigin="anonymous" referrerPolicy="no-referrer" />
|
|
1510
|
+
<Image src={preview} alt={description} width={widthPx} height={heightPx} />
|
|
1511
|
+
```
|
|
1512
|
+
|
|
1513
|
+
- `alt` is required. A non-empty `alt` names the picture, and an empty one declares it decorative
|
|
1514
|
+
and hides it from assistive technology.
|
|
1515
|
+
- `width` and `height` are the picture's size in pixels, as numbers. They hold its box before it
|
|
1516
|
+
loads, and the picture is never wider than its container, so `max-width: 100%` and
|
|
1517
|
+
`height: auto` go. `aspectRatio` holds a frame of a ratio instead, for a source whose size is
|
|
1518
|
+
unknown, and `fit` (`contain`, the default, or `cover`) says how the picture sits in a frame of
|
|
1519
|
+
another ratio. No prop takes a CSS length.
|
|
1520
|
+
- While the picture loads, the box shows the placeholder Skeleton draws. When it cannot load, the
|
|
1521
|
+
box shows a fallback of the member's own in place of the browser's broken-image glyph, and a
|
|
1522
|
+
meaningful picture keeps its `alt` as the fallback's name.
|
|
1523
|
+
- `loading` is `lazy` by default; pass `eager` for a picture in the first view. `crossOrigin` and
|
|
1524
|
+
`referrerPolicy` reach the element unchanged.
|
|
1525
|
+
|
|
1526
|
+
It is not `Avatar`, which is a round identity mark with initials, not `ImageEditor`, which crops,
|
|
1527
|
+
and not `Icon`, which draws an icon role. It has no caption, zoom or gallery.
|
|
1528
|
+
|
|
1529
|
+
In a module that imports the member, `Image` is the member, and the DOM's constructor of the same
|
|
1530
|
+
name is `window.Image`.
|
|
1531
|
+
|
|
1532
|
+
Every web framework's vocabulary ships it, drawn by the new recipe
|
|
1533
|
+
`@polymorph/recipes/structure/image.module.css`. The SwiftUI member (`PMImage`) loads through
|
|
1534
|
+
`AsyncImage`, and the Compose member through the app's `LocalPMImageLoader`, as Avatar does; both
|
|
1535
|
+
ship at the release tag. On both, `loading`, `crossOrigin` and `referrerPolicy` are not honoured,
|
|
1536
|
+
and the placeholder is still. On Android a URL that fails stays in the loading state, because a
|
|
1537
|
+
Compose painter reports no failure.
|
|
1538
|
+
|
|
1539
|
+
- 820c836: Every package now carries the release's version, and the release tag is `v` and that version.
|
|
1540
|
+
Until this release each package kept its own number, so one release installed the engine at one
|
|
1541
|
+
version, the foundations at another and the tag named a third. From this release on, pin every
|
|
1542
|
+
`@polymorph/*` package you install at the same version, and check the native packages out at the
|
|
1543
|
+
tag of that version.
|
|
1544
|
+
|
|
1545
|
+
This package's version jumps to the release's number. The jump carries no change of its own: the
|
|
1546
|
+
versions it skips were never published.
|
|
1547
|
+
|
|
1548
|
+
- 0038e59: The React `Tabs` now draws the active indicator under its tab, on the strip's baseline rule, as the spec says and as the Vue, Svelte, Solid and Angular members do. It drew it along the top edge of the tab. The fix is in the recipe, so a vendored `Tabs` takes it with `polymorph update`. The Tabs overflow law now checks the indicator's edge in every web renderer.
|
|
1549
|
+
- e1c80b3: A horizontal `Tabs` list wider than its container now scrolls inside it instead of running past it. There is no new prop, and a list that fits looks as it did.
|
|
1550
|
+
|
|
1551
|
+
- An edge with more tabs beyond it fades out, and an edge with nothing beyond it does not. A browser without scroll-driven animations shows a thin scrollbar instead.
|
|
1552
|
+
- The current tab is scrolled inside the list when the list is laid out, when its box changes size and when the value changes. Only the list scrolls, never the page. The move for a new value is smooth unless the motion temperament is `none` or the reader asked for reduced motion.
|
|
1553
|
+
- A tab that takes keyboard focus is scrolled into view, clear of the fade, and its focus ring is not clipped.
|
|
1554
|
+
- The indicator stays under its tab while the list is scrolled. In React it now also follows a `value` the caller changes without a press.
|
|
1555
|
+
|
|
1556
|
+
Remove any workaround that sets `overflow` on the tablist, such as a `Bespoke` zone around the member. The baseline rule is now drawn by the root, not by the list's border, so a stylesheet that restyled that border no longer reaches it.
|
|
1557
|
+
|
|
1558
|
+
`@polymorph/engine` exports `revealInline`, which every framework's `Tabs` calls, and each foundation re-exports it. A vendored `Tabs` gets the scrolling, the fade and the focus room from the recipe alone, and the scroll to the current tab after `polymorph update`.
|
|
1559
|
+
|
|
1560
|
+
- Updated dependencies [2bccb19]
|
|
1561
|
+
- Updated dependencies [2bccb19]
|
|
1562
|
+
- Updated dependencies [820c836]
|
|
1563
|
+
- Updated dependencies [7c0e29b]
|
|
1564
|
+
- Updated dependencies [0038e59]
|
|
1565
|
+
- Updated dependencies [e1c80b3]
|
|
1566
|
+
- @polymorph/recipes@1.0.8
|
|
1567
|
+
- @polymorph/react@1.0.8
|
|
1568
|
+
|
|
1569
|
+
## 1.0.6
|
|
1570
|
+
|
|
1571
|
+
### Patch Changes
|
|
1572
|
+
|
|
1573
|
+
- Updated dependencies [22f607b]
|
|
1574
|
+
- @polymorph/recipes@1.0.3
|
|
1575
|
+
- @polymorph/react@1.0.3
|
|
1576
|
+
|
|
1577
|
+
## 1.0.5
|
|
1578
|
+
|
|
1579
|
+
### Patch Changes
|
|
1580
|
+
|
|
1581
|
+
- 1b900d8: Alert takes a second action, Card takes a title, and ConfirmDialog takes a typed confirmation. Every new prop is optional, so existing screens render as before.
|
|
1582
|
+
|
|
1583
|
+
**Alert's `secondaryAction`** is a second `ghost` `sm` Button after `action`, for a review the reader answers in place: `action={<Button variant="soft" tone="accent" size="sm" label="Apply" />}` with `secondaryAction={<Button variant="ghost" tone="neutral" size="sm" label="Discard" />}`. The two sit in one row that wraps, and Tab reaches both before the dismiss button. Replace a hand-built "apply or discard" block beside an Alert with the two props. Two actions are the most an Alert takes; content that needs more is a Card.
|
|
1584
|
+
|
|
1585
|
+
**Card's `title` and `headingLevel`** draw the card's heading before its content, in the section-heading recipe Dashboard.Panel uses, as an `<h2>` by default or an `<h3>` or `<h4>`. A titled Card with `as="section"` or `as="article"` is named by its title. Replace a `Dashboard.Panel` used outside a Dashboard with `<Card title="…">`, and remove any heading you put inside the card to name it.
|
|
1586
|
+
|
|
1587
|
+
**ConfirmDialog's `confirmWith`** is the phrase a person types before the confirm enables, such as the name of the project being deleted. The dialog draws the field with its label (`confirmWithLabel`, default `Type {phrase} to confirm`) and its error (`confirmWithError`, default `The text does not match`). It compares the text with the spaces around it removed and letter case ignored, starts focus in the field, and empties the field each time it opens. Localized apps pass both strings. Replace a typed-phrase confirmation built inline with `confirmWith`. ConfirmDialog still has no body slot: content beyond the phrase belongs in a Dialog.
|
|
1588
|
+
|
|
1589
|
+
**`@polymorph/recipes`**: Alert's `action` class is a wrapping row with a gap, which holds one action or two, and Card's recipe has a `title` class. `Dashboard.Panel` draws its title as Card's `title`, so `archetypes/dashboard.module.css` no longer has a `panelTitle` class; a vendored Dashboard takes the new `Dashboard.tsx` with the recipe.
|
|
1590
|
+
|
|
1591
|
+
**In Vue, Svelte, Solid and Angular**, `secondaryAction` takes content as `action` does, and the other props are the same props.
|
|
1592
|
+
|
|
1593
|
+
**On iOS and Android**, `PMAlertProps.secondaryAction`, `PMCardProps.title` and `headingLevel` (`PMCardHeadingLevel`), and `PMConfirmDialogProps.confirmWith`, `confirmWithLabel` and `confirmWithError` are new, with their defaults in `PMStrings` (`confirmWithLabel(phrase:)` and `confirmWithError`). On iOS a ConfirmDialog with `confirmWith` is a content-high sheet that holds the field, because the confirmation action sheet holds none. On iOS a text field inside a FormField keeps focus when its error appears or goes while the person types.
|
|
1594
|
+
|
|
1595
|
+
- 1b900d8: Input takes `exact`, for text that must be typed letter for letter, and ConfirmDialog's phrase field sets it.
|
|
1596
|
+
|
|
1597
|
+
**`exact` on Input** means the text is typed exactly: nothing corrects it, capitalises it or checks its spelling. The inner `<input>` takes `autocorrect="off"`, `autocapitalize="off"` and `spellcheck="false"`, so a phone browser's keyboard leaves a phrase such as `acme-billing` as the person types it. Set it on a field whose text must match what the person meant to type, such as a slug or a name they repeat back; a field without it behaves as before. Vue, Svelte, Solid and Angular take the same prop.
|
|
1598
|
+
|
|
1599
|
+
**ConfirmDialog's typed confirmation** sets `exact` on its phrase field in every web framework. A phone browser no longer corrects the phrase while the person types it, which left the confirm disabled with "The text does not match" under a phrase they typed correctly.
|
|
1600
|
+
|
|
1601
|
+
**On iOS and Android**, `PMInputProps` gains `exact`. A SwiftUI Input with it is neither capitalised nor corrected, and a Compose Input asks the keyboard for no correction, as each platform already treats an email or URL field. ConfirmDialog's phrase field sets it.
|
|
1602
|
+
|
|
1603
|
+
- 1b900d8: CursorPagination has a "Load more" form, and RelativeTime writes the moment itself as well as the distance from now.
|
|
1604
|
+
|
|
1605
|
+
**`CursorPagination mode="append"` is "Load more".** It draws one `outline` Button, "Load more", that calls `onNext`; the app adds the window it fetches below the ones on screen. While `pending` the Button is busy and ignores presses. When `hasNext` turns false after a press, the list has run out: the Button leaves and an end line says "No more to load" through a status region, so a screen reader hears it. The form remembers that it asked for a window and does not read `hasPrevious`, so pass your query library's flags as they are. A list with no next window that the reader has not paged renders nothing, as one window does in the default form. `position` is what is on screen in your words ("50 shown"). In a DataTable, set the pager's `pending` while the next rows load, not the table's `loading`, which replaces the rows with skeletons. A hand-built "Load more" can be replaced with `<CursorPagination mode="append" hasPrevious={false} hasNext={hasNextPage} pending={isFetchingNextPage} onNext={fetchNextPage} />`; a list started again under a new query takes a new pager (`key={query}`).
|
|
1606
|
+
|
|
1607
|
+
In React the props are a union on `mode`: the default form still requires `onPrevious`, so every pager written before stays valid, and the append form takes none, because it has no previous direction. In Vue, Svelte, Solid and Angular `onPrevious` is an optional event, and the default form warns in development when `hasPrevious` has no `onPrevious`.
|
|
1608
|
+
|
|
1609
|
+
`CursorPaginationMessages` takes two optional words, `more` and `end`; an app that localizes the pager passes them, and the append form warns in development when `messages` leaves them out. Every web framework's CursorPagination takes `mode`, and so do `PMCursorPagination` on iOS and Android.
|
|
1610
|
+
|
|
1611
|
+
The Svelte foundation's `Held` takes `presses`, and the Angular foundation exports `pressOnce`: a states fixture entry presses a control once it is in the document, as the append form's "the list ran out" entry presses "Load more". An app has no use for either.
|
|
1612
|
+
|
|
1613
|
+
`@polymorph/recipes`' `structure/cursor-pagination.module.css` lays `.pagination` out as a column (`display: inline-flex; flex-direction: column`), so the append form's end line takes a line of its own under the row; the default form's one row looks as it did. It adds `.end`, the end line, in the position's type and colour. A vendored CursorPagination takes both with the recipe.
|
|
1614
|
+
|
|
1615
|
+
**`RelativeTime mode="absolute"` and `mode="both"`.** `absolute` writes the moment with `Intl.DateTimeFormat` in the member's `locale`: the medium date and the short time ("Aug 4, 2026, 2:05 PM"), or with `format="long"` the long date. An instant is written in the time zone of whatever renders the member: the reader's in a browser, the server's under server rendering or in a React server component. An app that renders on a server and must show the reader's zone renders the absolute forms in the browser, from a client component once it has mounted. A calendar date (`2026-08-04`) is the date alone, the same day everywhere. `both` writes the moment and the distance joined by `messages.both`, by default the moment, then the distance in parentheses ("Aug 4, 2026, 2:05 PM (2h ago)"); a localized app passes `messages={{ both: (moment, distance) => … }}` from its catalog, so its locale orders and punctuates the two. The default stays `relative`. Replace a hand-formatted timestamp in JSX with the member, which also writes the moment in `dateTime`.
|
|
1616
|
+
|
|
1617
|
+
**`relativeTimePhrase` takes `mode` and `messages`.** `relativeTimePhrase(value, { locale, numeric, format, mode, messages })` from `@polymorph/engine`, which every foundation re-exports, returns the text RelativeTime renders for those props, or `null` for a value that is not a moment. Use it where a member takes app-formatted text, such as Timeline's `time`, so the words match RelativeTime's ([design/components/relative-time.md](../design/components/relative-time.md)).
|
|
1618
|
+
|
|
1619
|
+
**On iOS and Android**, `PMRelativeTimeProps` gains `messages`, the same `both`. **On Android**, `PMRelativeTimeWords` gains `absolute(moment, long, locale)`, which an app implements to write the moment with the platform's formatter in the reader's zone. Without it the member writes Material 3's medium date and an instant's 24-hour time in UTC, said as UTC, because the member module reaches no time zone. The words are `PMStrings.relativeUtc`, a default only Android's `PMStrings` declares, so iOS's string catalog does not carry it; an app translates it through `LocalPMStrings`.
|
|
1620
|
+
|
|
1621
|
+
- 1b900d8: Link, `AppShell.NavItem`, Breadcrumbs and a linked Card take an optional `onNavigate(href)`, the seam for an app's own router (`design/components/link.md` §Routing).
|
|
1622
|
+
|
|
1623
|
+
**To route without reloading the page**, pass your router's navigate function as `onNavigate` to every Link, NavItem, Breadcrumbs and Card with an `href`. A click that would navigate the current tab calls `onNavigate(href)` with the `href` you wrote. The member has already stopped the browser's navigation, so the handler only routes: `(href) => void navigate({ href })` with TanStack Router, `(href) => void navigate(href)` with React Router. A click with Meta, Control, Shift or Alt held, a click with another button, and a click on an `external` Link stay the browser's, so a reader can still open a link in a new tab. Breadcrumbs also routes a crumb chosen from its overflow menu, and a Card routes the click on its stretched link. Without `onNavigate`, every link behaves as before. `docs/consuming.md` has the TanStack Router and React Router forms, and `design/archetypes/app-shell.md` has the root route that renders AppShell once, with a page archetype for each route.
|
|
1624
|
+
|
|
1625
|
+
**Link is now a client module.** Link and the routing helper it shares with NavItem, Breadcrumbs and Card are marked `'use client'`, because the seam is a click handler. Under React Server Components, a server component that renders a Link ships Link's code to the browser, where it shipped none before.
|
|
1626
|
+
|
|
1627
|
+
**NavItem's `onSelect` is unchanged.** It still fires on every click of a row, including a click that opens a new tab. An app that routes through `onSelect` on rows with an `href` moves that call to `onNavigate`, which leaves those clicks to the browser.
|
|
1628
|
+
|
|
1629
|
+
**AppShell closes its small-viewport drawer when `transitionKey` changes**, as the iOS and Android shells already do. Under a client-side router the shell stays mounted, so the drawer stayed open over the page the reader had chosen from it.
|
|
1630
|
+
|
|
1631
|
+
**In Vue, Svelte, Solid and Angular** the prop is the framework's event, each with the `href`: `@navigate` in Vue, `onNavigate` in Svelte and Solid, and `(navigate)` in Angular.
|
|
1632
|
+
|
|
1633
|
+
**On iOS and Android**, `PMLinkProps` and `PMBreadcrumbsProps` gain `onNavigate`. When it is set, a press on a Link that is not `external`, or on a crumb with an `href`, calls it in place of the environment's `openURL` or `LocalUriHandler`. `PMCardProps` gains `onNavigate` too, and a press on a linked native Card calls it in the same place.
|
|
1634
|
+
|
|
1635
|
+
- 1b900d8: A toast tells its owner when it leaves, its tone sets how long it stays, a success notice leaves on its own, and the registry publishes Toast as each framework ships it.
|
|
1636
|
+
|
|
1637
|
+
**`onDismiss` on a toast.** `toast()` takes `onDismiss`, called once when the toast leaves for a reason other than its owner's: the reader dismissed it, its time ran out, `toast.dismiss` closed it, or newer toasts evicted it. Removing a toast and updating it in place do not call it. Every framework's `toast()` takes it, because every foundation's store is the engine's. A declared Toast in Vue, Svelte, Solid and Angular emits `dismiss` (`@dismiss`, `onDismiss`, `(dismiss)`), and `PMToast` on iOS and Android calls `onDismiss` when its card leaves by its close button, a swipe, the escape gesture or its time.
|
|
1638
|
+
|
|
1639
|
+
**A toast takes its lifetime from its tone.** The store every web framework shares gives a toast whose call sets neither `retained` nor `durationMs` its tone's lifetime. A `danger` or `warning` toast is retained and pinned: it stays until it is dismissed or removed, and newer toasts do not evict it. A `success`, `info` or `neutral` toast leaves after `TOAST_DEFAULT_DURATION_MS` and may be evicted, as every toast did before. So `toast.danger(…)`, `toast.warning(…)` and `toast.promise`'s error face now stay until the reader dismisses them; a call that wants the old five seconds passes `durationMs: TOAST_DEFAULT_DURATION_MS`. A call that sets either option keeps what it sets. `ToastNotice` and a declared `Toast` in Vue, Svelte, Solid and Angular follow the same rule, so a `danger` or `warning` notice stays until it is resolved or dismissed, as every notice did before, and a `success`, `info` or `neutral` notice now leaves on its own. A screen that kept a success notice on screen with a button whose only job was to dismiss it can delete the button. `ToastNotice` also takes `onDismiss`, so a screen can clear the state that renders a notice once the notice has left; unmounting a notice does not call it. A notice that must stay whatever its tone takes `dismissible={false}`. `PMToast` on iOS and Android takes the same lifetime from its tone when its props set neither `retained` nor `durationMs`: a native danger or warning toast now stays until it is dismissed, and one that should leave passes `durationMs: 5000`.
|
|
1640
|
+
|
|
1641
|
+
**A notice with nowhere to show warns in development.** A `ToastNotice` rendered while no `ToastHost` or `Toaster` is mounted logs a warning naming it, because nothing draws its toast. A declared `Toast` in Vue, Svelte, Solid and Angular logs the same warning when no `Toast.Viewport` is in the document once it has mounted. The usual cause is an error boundary whose fallback renders outside the viewport: mount `ToastHost`, or `Toast.Viewport`, outside the boundary.
|
|
1642
|
+
|
|
1643
|
+
**The registry and the system card publish Toast's real API and every compound part.** Each component carries `parts`, every compound part its export carries with the part's props (`AppShell.NavItem`, `AppShell.NavGroup`, `AppShell.UserCard`, `Dashboard.Panel`, `Avatar.Group`, `Table.Head`, `Table.Body` and `Table.Foot` among them, which the card left out), and `exports`, the member's other callable exports (Toast's `toast`, `ToastHost`, `ToastNotice` and `ToastViewportTarget`; Tooltip's `TooltipProvider`; FormField's `ToastFormField`). The React card lists Toast as `toast()` with its options and shorthands beside the components a screen mounts, rather than as a `<Toast>` with props; another framework's card lists the parts its shell ships, `Toast.Viewport` included. Toast's purpose reads "Notifications that report the outcome of an action" in place of "The toast viewport". A card rendered for `ios` or `android` lists a member's props and the parts its native contract carries, and none of React's exports: SwiftUI's and Compose's Toast is a member whose props are the options.
|
|
1644
|
+
|
|
1645
|
+
**The spec-staleness law reads every compound part.** `@polymorph/rules/spec-api` compares each part a member's export carries with its spec, reading the parts with `compoundParts`, the function the registry's `parts` come from, in place of the hand list `COMPOUND_PARTS`, which is removed. A part's props table goes in `## API` under a `Component` column, or under a heading with the part's name (`## AppShell.NavItem`).
|
|
1646
|
+
|
|
1647
|
+
- Updated dependencies [1b900d8]
|
|
1648
|
+
- Updated dependencies [1b900d8]
|
|
1649
|
+
- Updated dependencies [1b900d8]
|
|
1650
|
+
- @polymorph/recipes@1.0.2
|
|
1651
|
+
- @polymorph/react@1.0.2
|
|
1652
|
+
|
|
1653
|
+
## 1.0.4
|
|
1654
|
+
|
|
1655
|
+
### Patch Changes
|
|
1656
|
+
|
|
1657
|
+
- 700e130: `@polymorph/ui` is renamed `@polymorph/react-ui`, published as `@metamorph-labs/polymorph-react-ui`. The members, their props and the subpaths `./galleries`, `./identity` and `./identity-signup` are unchanged. It depends on `@polymorph/react` in place of `@polymorph/core`.
|
|
1658
|
+
|
|
1659
|
+
**To upgrade**, install `@polymorph/react-ui` in place of `@polymorph/ui` and replace `@polymorph/ui` with `@polymorph/react-ui` in imports.
|
|
1660
|
+
|
|
1661
|
+
**The recipes are a package of their own.** Every member's recipe (its `*.module.css`) and the base layer are in `@polymorph/recipes`, published as `@metamorph-labs/polymorph-recipes`, because every web framework's members import the same files. `@polymorph/react-ui` depends on it, and its build still contains every recipe, compiled, with each member importing its own stylesheet, so an app that imports members ships the same CSS. `@polymorph/react-ui/base.css` is removed: import `@polymorph/recipes/base.css` instead, and add `@polymorph/recipes` to your dependencies if you import it yourself. The entry points of `@polymorph/react-ui` still import the base layer, so most apps import neither. A vendored install copies each member's recipe beside it and rewrites the member's import to the relative path (`./button.module.css`), so a vendoring app does not install `@polymorph/recipes`; a recipe's path in `polymorph.json` names its home, `packages/recipes/src/…`, and `polymorph update` records it.
|
|
1662
|
+
|
|
1663
|
+
**Node needs no configuration.** The `exports` map has a `node` condition, pointing at `dist/node/`, a copy of every module without its stylesheet import. Node, Vitest and Vite's server render match it, so a test suite or a server render that imports the package needs no `server.deps.inline` or `ssr.noExternal` entry for it, and you can remove those entries. A browser bundle still gets each member's stylesheet with the member. Under the `node` condition no member stylesheet loads, so a test that asserts a computed style needs Vitest's browser mode. One case is untested: a framework that bundles its server code with the `node` condition and then carries the resolved paths into its client references may load the stylesheet-free copies in the browser. Next.js's App Router is the likely one; if its client build holds no vocabulary CSS (no rules for Button, say), that has happened. The `./identity`, `./identity-signup` and `./galleries` entry points are declared as having side effects, as the root entry is, so a production bundle that imports only from one of them keeps `@polymorph/react`'s stylesheet.
|
|
1664
|
+
|
|
1665
|
+
**Fixes and additions:**
|
|
1666
|
+
|
|
1667
|
+
- A row checkbox in `DataTable` selects its row from the keyboard and the pointer. The wrapper that keeps a checkbox click from also opening the row stopped the event in the capture phase, before it reached the checkbox.
|
|
1668
|
+
- `DatePicker` and `DateRangePicker` open their calendar on Enter and Space from the trigger button, not only on a pointer press; the clear button answers the same keys, and clearing moves focus to the first segment instead of leaving it on the page.
|
|
1669
|
+
- Members whose parts a test or a screen reader script needs to find carry a `data-<member>-part` attribute on those parts (`Tabs`, `Accordion`, `Carousel`, `ImageEditor`, `SplitPane`, `ChatThread`, `Calendar`, `DateRangePicker`, the menu rows and `Toaster`'s list). The behaviour conformance law reads them.
|
|
1670
|
+
- `SplitButton`'s module exports `SPLIT_BUTTON_GRID`, its lawful variant × tone cells as data, as Button's exports `BUTTON_GRID`. The system card lists SplitButton's lawful cells from it.
|
|
1671
|
+
- The chart members draw from `@polymorph/engine/charts`. The package exports the chart types and `DEFAULT_CHART_MESSAGES` under the same names, and the members render the same DOM. A vendored chart member imports the engine through `@polymorph/react` and no longer copies `charts/engine/` or the frame's pure modules; `polymorph update` reports those files as removed. A chart inside an overlay that enters scaled (Popover, HoverCard) is laid out at its full size.
|
|
1672
|
+
- The package no longer declares `d3-array`, `d3-scale` and `d3-shape`, which the engine depends on.
|
|
1673
|
+
- A member whose trigger is a governed control (`Popover`, `Menu`, `SplitButton`, `ContextMenu`, and `DatePicker`'s and `DateRangePicker`'s calendar buttons) returns focus to it on close only from inside its panel or from nowhere, so a control the reader moved to while a non-modal `Popover` closed keeps focus.
|
|
1674
|
+
- `Combobox`'s status region is heard while its list is open. `useComboBox` hides the page outside the field and the list from assistive technology, and the region, beside the input, was hidden with it, so "Loading options" and "No results" were never said.
|
|
1675
|
+
- `Carousel`'s dots and `ScrollArea`'s thumb keep the 24px hit target at compact density, where they were 20px.
|
|
1676
|
+
- `ToastNotice` takes an optional `description`, and `FormField`'s toast mode raises its error as the toast's description rather than its content, as the generated vocabularies do.
|
|
1677
|
+
|
|
1678
|
+
- Updated dependencies [700e130]
|
|
1679
|
+
- Updated dependencies [700e130]
|
|
1680
|
+
- @polymorph/react@1.0.1
|
|
1681
|
+
- @polymorph/recipes@1.0.1
|
|
1682
|
+
|
|
1683
|
+
## 1.0.3
|
|
1684
|
+
|
|
1685
|
+
### Patch Changes
|
|
1686
|
+
|
|
1687
|
+
- de7af02: Add the `ai` tier — the conversation vocabulary for AI products — and the `ConversationPage` archetype.
|
|
1688
|
+
|
|
1689
|
+
New members in `@polymorph/ui`: `ChatThread`, `ChatMessage`, `PromptInput`, `AttachmentChip`, `StreamingText`, `Markdown`, `ToolCall`, `ApprovalCard`, `Citation`, `SourceList`, `ReasoningDisclosure`, `ArtifactPane`, and the `ConversationPage` archetype. `docs/conversation.md` is the tier's model; every member has a spec under `design/components/`.
|
|
1690
|
+
|
|
1691
|
+
New icon roles in `@polymorph/core`: `send`, `stop`, `attach`, `helpful`, `unhelpful`, `reasoning`, `cite`, `artifact`. New motion bindings: `chat.message`, `streaming.pending`, `toolcall.status`. `StateName` gains `streaming` and `detached`.
|
|
1692
|
+
|
|
1693
|
+
Additive only: no existing export, prop or token changes.
|
|
1694
|
+
|
|
1695
|
+
- Updated dependencies [de7af02]
|
|
1696
|
+
- @polymorph/core@1.0.3
|
|
1697
|
+
|
|
1698
|
+
## 1.0.2
|
|
1699
|
+
|
|
1700
|
+
### Patch Changes
|
|
1701
|
+
|
|
1702
|
+
- 9ad1cfe: Themes compile at build time, and what an application ships is smaller.
|
|
1703
|
+
|
|
1704
|
+
**Build-time theming.** `@polymorph/core/vite` exports `polymorphTheme`, a Vite plugin (`vite`
|
|
1705
|
+
`>=6`, an optional peer) that admits your systems and palettes when the application builds — a
|
|
1706
|
+
law fault fails the build, with the law's own sentence — and serves them as CSS. Each system with
|
|
1707
|
+
its own default palette goes into the main stylesheet; every other pairing compiles to its own
|
|
1708
|
+
small sheet. `@polymorph/core/runtime` is the theme runtime without the engine (`setSystem`,
|
|
1709
|
+
`setPalette`, `setMode`, `hydrateTheme`, `PREPAINT_SCRIPT`, `DATA_ATTRS` and the rest), and
|
|
1710
|
+
`@polymorph/core/vite-env` types the virtual module. To move an application from runtime
|
|
1711
|
+
admission:
|
|
1712
|
+
|
|
1713
|
+
1. Add the plugin to `vite.config.ts`:
|
|
1714
|
+
`polymorphTheme({ systems: ['design/system.json'], palettes: ['design/palette.json'] })`.
|
|
1715
|
+
2. Replace the `admitTheme(...)` and `installThemeCSS(...)` calls at your entry with
|
|
1716
|
+
`import 'virtual:polymorph/theme'`, which imports the stylesheet and the pairings' fonts and
|
|
1717
|
+
applies the stored choice.
|
|
1718
|
+
3. Drop any pre-paint script you inline yourself: the plugin inlines `PREPAINT_SCRIPT` and writes
|
|
1719
|
+
the default `data-system` and `data-palette` on `<html>`.
|
|
1720
|
+
4. Import the setters from `@polymorph/core/runtime`, and before switching to a pairing that is
|
|
1721
|
+
not a system's own default, `await ensurePairing(system, palette)` from
|
|
1722
|
+
`virtual:polymorph/theme`.
|
|
1723
|
+
5. Reference the types once from a `.d.ts`: `/// <reference types="@polymorph/core/vite-env" />`.
|
|
1724
|
+
|
|
1725
|
+
`admitTheme` and `installThemeCSS` are unchanged and remain the way to install a theme known only
|
|
1726
|
+
at run time, such as one per tenant; that path ships the theme engine to the browser.
|
|
1727
|
+
|
|
1728
|
+
**Motion runs on the Web Animations API.** `@polymorph/core/motion` no longer depends on the
|
|
1729
|
+
`motion` package: springs are simulated and played as `linear()` easings, every animation starts
|
|
1730
|
+
from the value on screen, and an interrupted spring keeps its velocity. The exports and props are
|
|
1731
|
+
the same, so nothing in your code changes.
|
|
1732
|
+
|
|
1733
|
+
**Icons are drawn from glyph data.** `@polymorph/core` depends on `lucide` (glyph data only) in
|
|
1734
|
+
place of `lucide-react`, and draws each glyph's SVG itself. `Icon`'s props are the same.
|
|
1735
|
+
|
|
1736
|
+
**Vendored themes are compiled at install time.** `polymorph add theme:…` and `palette:…` write
|
|
1737
|
+
`themes/theme.css`, and for every other pairing `themes/pairings/<system>--<palette>.css` with a
|
|
1738
|
+
small loader module beside it. `themes/index.ts` uses only `@polymorph/core/runtime`, and its
|
|
1739
|
+
`ensurePairing()` now returns a Promise: await it before `setSystem` or `setPalette`. Run
|
|
1740
|
+
`polymorph update` once to regenerate an existing install, and again after editing a vendored
|
|
1741
|
+
system or palette JSON. The output works with any bundler.
|
|
1742
|
+
|
|
1743
|
+
**Measured** by `pnpm size` (gzipped JavaScript, theme compiled at build time): React alone
|
|
1744
|
+
57.5 kB; a `Button` 63.7 kB; a `ListPage` with a `Table` 73.1 kB; a `Dialog` 83.8 kB — each with
|
|
1745
|
+
4.5–6.1 kB of CSS. Admitting a theme in the browser costs 49.4 kB of JavaScript on its own.
|
|
1746
|
+
|
|
1747
|
+
- Updated dependencies [9ad1cfe]
|
|
1748
|
+
- @polymorph/core@1.0.2
|
|
1749
|
+
|
|
1750
|
+
## 1.0.1
|
|
1751
|
+
|
|
1752
|
+
### Patch Changes
|
|
1753
|
+
|
|
1754
|
+
- Updated dependencies [9b7ea37]
|
|
1755
|
+
- @polymorph/core@1.0.1
|
|
1756
|
+
|
|
1757
|
+
## 1.0.0
|
|
1758
|
+
|
|
1759
|
+
The first versioned release. Earlier history is in git.
|