@trinityui/design-system 2.11.1 → 2.13.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +2155 -0
- package/CONTRIBUTING.md +180 -69
- package/LICENSE +21 -0
- package/MIGRATION.md +505 -28
- package/README.md +281 -120
- package/dist/IllustratedMessage.js +546 -1341
- package/dist/accessibility.d.ts +596 -18
- package/dist/accessibility.d.ts.map +1 -1
- package/dist/accessibility.js +458 -0
- package/dist/app-shell.js +18458 -10385
- package/dist/assets/index.d.ts +1 -1
- package/dist/charts.js +8507 -6059
- package/dist/color-contrast.d.ts +35 -0
- package/dist/color-contrast.d.ts.map +1 -0
- package/dist/commonjs-helpers.js +8 -0
- package/dist/component-color-references.d.ts +175 -0
- package/dist/component-color-references.d.ts.map +1 -0
- package/dist/components/AI/AIActions.d.ts +72 -12
- package/dist/components/AI/AIActions.d.ts.map +1 -1
- package/dist/components/AI/AIAvatar.d.ts +31 -3
- package/dist/components/AI/AIAvatar.d.ts.map +1 -1
- package/dist/components/AI/AIChainOfThought.d.ts +159 -77
- package/dist/components/AI/AIChainOfThought.d.ts.map +1 -1
- package/dist/components/AI/AIChainOfThought.types.d.ts +292 -40
- package/dist/components/AI/AIChainOfThought.types.d.ts.map +1 -1
- package/dist/components/AI/AIChainOfThought.utils.d.ts +25 -7
- package/dist/components/AI/AIChainOfThought.utils.d.ts.map +1 -1
- package/dist/components/AI/AIChat.d.ts +12 -0
- package/dist/components/AI/AIChat.d.ts.map +1 -1
- package/dist/components/AI/AIChatWelcome.d.ts +254 -0
- package/dist/components/AI/AIChatWelcome.d.ts.map +1 -0
- package/dist/components/AI/AIClarificationPrompt.d.ts +134 -0
- package/dist/components/AI/AIClarificationPrompt.d.ts.map +1 -0
- package/dist/components/AI/AIConfidenceBadge.d.ts +117 -0
- package/dist/components/AI/AIConfidenceBadge.d.ts.map +1 -0
- package/dist/components/AI/AIConfigContext.d.ts +100 -0
- package/dist/components/AI/AIConfigContext.d.ts.map +1 -0
- package/dist/components/AI/AIConfigProvider.d.ts +66 -0
- package/dist/components/AI/AIConfigProvider.d.ts.map +1 -0
- package/dist/components/AI/AIContainer.d.ts +80 -11
- package/dist/components/AI/AIContainer.d.ts.map +1 -1
- package/dist/components/AI/AIExplainability.d.ts +39 -5
- package/dist/components/AI/AIExplainability.d.ts.map +1 -1
- package/dist/components/AI/AIFeedbackControl.d.ts +113 -0
- package/dist/components/AI/AIFeedbackControl.d.ts.map +1 -0
- package/dist/components/AI/AIFeedbackForm.d.ts +117 -0
- package/dist/components/AI/AIFeedbackForm.d.ts.map +1 -0
- package/dist/components/AI/AIFeedbackHostContext.d.ts +16 -0
- package/dist/components/AI/AIFeedbackHostContext.d.ts.map +1 -0
- package/dist/components/AI/AILabel.d.ts +39 -6
- package/dist/components/AI/AILabel.d.ts.map +1 -1
- package/dist/components/AI/AIMessage.d.ts +337 -42
- package/dist/components/AI/AIMessage.d.ts.map +1 -1
- package/dist/components/AI/AIPlanReview.d.ts +194 -0
- package/dist/components/AI/AIPlanReview.d.ts.map +1 -0
- package/dist/components/AI/AIQueryDisclosure.d.ts +119 -0
- package/dist/components/AI/AIQueryDisclosure.d.ts.map +1 -0
- package/dist/components/AI/AIRelatedQuestions.d.ts +50 -11
- package/dist/components/AI/AIRelatedQuestions.d.ts.map +1 -1
- package/dist/components/AI/AIResponseRenderer.d.ts +133 -21
- package/dist/components/AI/AIResponseRenderer.d.ts.map +1 -1
- package/dist/components/AI/AIResponseSourcesContext.d.ts +83 -0
- package/dist/components/AI/AIResponseSourcesContext.d.ts.map +1 -0
- package/dist/components/AI/AIReviewItem.d.ts +142 -0
- package/dist/components/AI/AIReviewItem.d.ts.map +1 -0
- package/dist/components/AI/AISourceChip.d.ts +135 -0
- package/dist/components/AI/AISourceChip.d.ts.map +1 -0
- package/dist/components/AI/AISources.d.ts +81 -11
- package/dist/components/AI/AISources.d.ts.map +1 -1
- package/dist/components/AI/AISourcesPanel.d.ts +43 -7
- package/dist/components/AI/AISourcesPanel.d.ts.map +1 -1
- package/dist/components/AI/AITextBlock.d.ts +104 -16
- package/dist/components/AI/AITextBlock.d.ts.map +1 -1
- package/dist/components/AI/AITextBlock.parser.d.ts +153 -0
- package/dist/components/AI/AITextBlock.parser.d.ts.map +1 -0
- package/dist/components/AI/AIVerificationBadge.d.ts +94 -0
- package/dist/components/AI/AIVerificationBadge.d.ts.map +1 -0
- package/dist/components/AI/AIVisuals.d.ts +92 -23
- package/dist/components/AI/AIVisuals.d.ts.map +1 -1
- package/dist/components/AI/AIVoiceInput.d.ts +42 -11
- package/dist/components/AI/AIVoiceInput.d.ts.map +1 -1
- package/dist/components/AI/AIVoiceMode.d.ts +16 -2
- package/dist/components/AI/AIVoiceMode.d.ts.map +1 -1
- package/dist/components/AI/BlockErrorBoundary.d.ts +77 -0
- package/dist/components/AI/BlockErrorBoundary.d.ts.map +1 -0
- package/dist/components/AI/ChatHeader.d.ts +41 -4
- package/dist/components/AI/ChatHeader.d.ts.map +1 -1
- package/dist/components/AI/ChatHistoryList.d.ts +25 -12
- package/dist/components/AI/ChatHistoryList.d.ts.map +1 -1
- package/dist/components/AI/ChatThread.d.ts +263 -13
- package/dist/components/AI/ChatThread.d.ts.map +1 -1
- package/dist/components/AI/InThreadContext.d.ts +14 -0
- package/dist/components/AI/InThreadContext.d.ts.map +1 -0
- package/dist/components/AI/InsightEngine.d.ts +270 -46
- package/dist/components/AI/InsightEngine.d.ts.map +1 -1
- package/dist/components/AI/InsightEngineInput.d.ts +47 -4
- package/dist/components/AI/InsightEngineInput.d.ts.map +1 -1
- package/dist/components/AI/MessageActionButton.d.ts +72 -0
- package/dist/components/AI/MessageActionButton.d.ts.map +1 -0
- package/dist/components/AI/QueryInput.d.ts.map +1 -1
- package/dist/components/AI/UserAvatar.d.ts +50 -4
- package/dist/components/AI/UserAvatar.d.ts.map +1 -1
- package/dist/components/AI/UserMessage.d.ts +32 -3
- package/dist/components/AI/UserMessage.d.ts.map +1 -1
- package/dist/components/AI/blockRendererContext.d.ts +64 -0
- package/dist/components/AI/blockRendererContext.d.ts.map +1 -0
- package/dist/components/AI/hitlBlockRenderers.d.ts +48 -0
- package/dist/components/AI/hitlBlockRenderers.d.ts.map +1 -0
- package/dist/components/AI/index.d.ts +23 -6
- package/dist/components/AI/index.d.ts.map +1 -1
- package/dist/components/AI/moleculeBlockRenderers.d.ts +15 -0
- package/dist/components/AI/moleculeBlockRenderers.d.ts.map +1 -0
- package/dist/components/AI/planReviewBlockRenderer.d.ts +8 -0
- package/dist/components/AI/planReviewBlockRenderer.d.ts.map +1 -0
- package/dist/components/AI/strings/defaults.d.ts +31 -0
- package/dist/components/AI/strings/defaults.d.ts.map +1 -0
- package/dist/components/AI/tokens.d.ts +185 -20
- package/dist/components/AI/tokens.d.ts.map +1 -1
- package/dist/components/AI/types/hitl.d.ts +2294 -0
- package/dist/components/AI/types/hitl.d.ts.map +1 -0
- package/dist/components/AI/types/index.d.ts +2 -1
- package/dist/components/AI/types/index.d.ts.map +1 -1
- package/dist/components/AI/types/response.d.ts +428 -40
- package/dist/components/AI/types/response.d.ts.map +1 -1
- package/dist/components/AI/useBlockSources.d.ts +67 -0
- package/dist/components/AI/useBlockSources.d.ts.map +1 -0
- package/dist/components/AI/useBrowserVoiceMode.d.ts +31 -2
- package/dist/components/AI/useBrowserVoiceMode.d.ts.map +1 -1
- package/dist/components/AI/useWelcomeComposerHandoff.d.ts +30 -0
- package/dist/components/AI/useWelcomeComposerHandoff.d.ts.map +1 -0
- package/dist/components/AI/utils/alphaIndex.d.ts +19 -0
- package/dist/components/AI/utils/alphaIndex.d.ts.map +1 -0
- package/dist/components/AI/utils/blockReady.d.ts +54 -0
- package/dist/components/AI/utils/blockReady.d.ts.map +1 -0
- package/dist/components/AI/utils/blocks.d.ts +28 -0
- package/dist/components/AI/utils/blocks.d.ts.map +1 -0
- package/dist/components/AI/utils/confidence.d.ts +182 -0
- package/dist/components/AI/utils/confidence.d.ts.map +1 -0
- package/dist/components/AI/utils/filters.d.ts +31 -0
- package/dist/components/AI/utils/filters.d.ts.map +1 -0
- package/dist/components/AI/utils/responseText.d.ts +8 -0
- package/dist/components/AI/utils/responseText.d.ts.map +1 -0
- package/dist/components/AI/utils/sources.d.ts +110 -0
- package/dist/components/AI/utils/sources.d.ts.map +1 -0
- package/dist/components/AIDigestCard/AIDigestCard.d.ts.map +1 -1
- package/dist/components/AIDigestCard/types.d.ts +42 -5
- package/dist/components/AIDigestCard/types.d.ts.map +1 -1
- package/dist/components/AppLayout/AIFab.d.ts +33 -6
- package/dist/components/AppLayout/AIFab.d.ts.map +1 -1
- package/dist/components/AppLayout/AIFabLayout.deprecated.d.ts.map +1 -1
- package/dist/components/AppLayout/AppLayout.d.ts +135 -7
- package/dist/components/AppLayout/AppLayout.d.ts.map +1 -1
- package/dist/components/AppLayout/InsightEnginePanel.d.ts +315 -21
- package/dist/components/AppLayout/InsightEnginePanel.d.ts.map +1 -1
- package/dist/components/AppLayout/ResizablePanel.d.ts +145 -8
- package/dist/components/AppLayout/ResizablePanel.d.ts.map +1 -1
- package/dist/components/AppLayout/ThreadHistorySidebar.d.ts +6 -0
- package/dist/components/AppLayout/ThreadHistorySidebar.d.ts.map +1 -1
- package/dist/components/AppLayout/index.d.ts +3 -3
- package/dist/components/AppLayout/index.d.ts.map +1 -1
- package/dist/components/AppLayout/insightEnginePanel.demo.d.ts +32 -0
- package/dist/components/AppLayout/insightEnginePanel.demo.d.ts.map +1 -0
- package/dist/components/AppLayout/panelPropsPath.d.ts +26 -0
- package/dist/components/AppLayout/panelPropsPath.d.ts.map +1 -0
- package/dist/components/AppLayout/panelResizeTransition.d.ts +49 -0
- package/dist/components/AppLayout/panelResizeTransition.d.ts.map +1 -0
- package/dist/components/AppLayout/toChatThreadMessage.d.ts +40 -0
- package/dist/components/AppLayout/toChatThreadMessage.d.ts.map +1 -0
- package/dist/components/AssessmentDrawer/AssessmentDrawer.d.ts +5 -1
- package/dist/components/AssessmentDrawer/AssessmentDrawer.d.ts.map +1 -1
- package/dist/components/AuditDrawer/AuditDrawer.d.ts +4 -3
- package/dist/components/AuditDrawer/AuditDrawer.d.ts.map +1 -1
- package/dist/components/AuditDrawer/index.d.ts +1 -1
- package/dist/components/AuditDrawer/index.d.ts.map +1 -1
- package/dist/components/AuditDrawer/types.d.ts +39 -5
- package/dist/components/AuditDrawer/types.d.ts.map +1 -1
- package/dist/components/Autocomplete/Autocomplete.d.ts +6 -1
- package/dist/components/Autocomplete/Autocomplete.d.ts.map +1 -1
- package/dist/components/BulkActionDock/BulkActionDock.d.ts.map +1 -1
- package/dist/components/Carousel/Carousel.d.ts +10 -2
- package/dist/components/Carousel/Carousel.d.ts.map +1 -1
- package/dist/components/Charts/AreaChart.d.ts.map +1 -1
- package/dist/components/Charts/BarChart.d.ts.map +1 -1
- package/dist/components/Charts/ChartWrapper.d.ts.map +1 -1
- package/dist/components/Charts/ComposedChart.d.ts.map +1 -1
- package/dist/components/Charts/CustomLegend.d.ts +11 -2
- package/dist/components/Charts/CustomLegend.d.ts.map +1 -1
- package/dist/components/Charts/LineChart.d.ts.map +1 -1
- package/dist/components/Charts/PieChart.d.ts.map +1 -1
- package/dist/components/Charts/RadialChart.d.ts.map +1 -1
- package/dist/components/Charts/ScatterChart.d.ts.map +1 -1
- package/dist/components/Charts/Sparkline.d.ts.map +1 -1
- package/dist/components/Charts/gaugeGeometry.d.ts +35 -0
- package/dist/components/Charts/gaugeGeometry.d.ts.map +1 -0
- package/dist/components/Charts/highcharts.d.ts +23 -0
- package/dist/components/Charts/highcharts.d.ts.map +1 -0
- package/dist/components/Charts/highchartsUtils.d.ts +101 -6
- package/dist/components/Charts/highchartsUtils.d.ts.map +1 -1
- package/dist/components/Charts/index.d.ts +1 -1
- package/dist/components/Charts/index.d.ts.map +1 -1
- package/dist/components/Charts/tokens.d.ts +21 -0
- package/dist/components/Charts/tokens.d.ts.map +1 -1
- package/dist/components/Charts/types.d.ts +7 -7
- package/dist/components/Charts/types.d.ts.map +1 -1
- package/dist/components/ChipsInput/ChipsInput.d.ts.map +1 -1
- package/dist/components/ChoiceChips/ChoiceChips.d.ts +106 -0
- package/dist/components/ChoiceChips/ChoiceChips.d.ts.map +1 -0
- package/dist/components/ClearableTextField/ClearableTextField.d.ts +23 -2
- package/dist/components/ClearableTextField/ClearableTextField.d.ts.map +1 -1
- package/dist/components/CodeBlock/CodeBlock.d.ts +80 -0
- package/dist/components/CodeBlock/CodeBlock.d.ts.map +1 -0
- package/dist/components/Combobox/Combobox.d.ts +3 -2
- package/dist/components/Combobox/Combobox.d.ts.map +1 -1
- package/dist/components/CommandPalette/CommandPalette.d.ts +54 -3
- package/dist/components/CommandPalette/CommandPalette.d.ts.map +1 -1
- package/dist/components/CommandPalette/index.d.ts +1 -1
- package/dist/components/CommandPalette/index.d.ts.map +1 -1
- package/dist/components/CopyButton/CopyButton.d.ts +80 -0
- package/dist/components/CopyButton/CopyButton.d.ts.map +1 -0
- package/dist/components/DataCard/DataCard.d.ts +11 -1
- package/dist/components/DataCard/DataCard.d.ts.map +1 -1
- package/dist/components/DataTable/CellRenderers.d.ts +8 -11
- package/dist/components/DataTable/CellRenderers.d.ts.map +1 -1
- package/dist/components/DataTable/DataTable.d.ts +1 -1
- package/dist/components/DataTable/DataTable.d.ts.map +1 -1
- package/dist/components/DataTable/InlineAddRow.d.ts.map +1 -1
- package/dist/components/DataTable/columnContext.d.ts +8 -0
- package/dist/components/DataTable/columnContext.d.ts.map +1 -0
- package/dist/components/DataTable/index.d.ts +2 -2
- package/dist/components/DataTable/index.d.ts.map +1 -1
- package/dist/components/DataTable/labels.d.ts +13 -0
- package/dist/components/DataTable/labels.d.ts.map +1 -0
- package/dist/components/DataTable/types.d.ts +34 -0
- package/dist/components/DataTable/types.d.ts.map +1 -1
- package/dist/components/DateRangePicker/DateRangePicker.d.ts.map +1 -1
- package/dist/components/DetailsPopover/DetailsPopover.d.ts +185 -0
- package/dist/components/DetailsPopover/DetailsPopover.d.ts.map +1 -0
- package/dist/components/DiffViewer/DiffViewer.d.ts +3 -2
- package/dist/components/DiffViewer/DiffViewer.d.ts.map +1 -1
- package/dist/components/Disclosure/Disclosure.d.ts +83 -0
- package/dist/components/Disclosure/Disclosure.d.ts.map +1 -0
- package/dist/components/DockLayout/DockLayout.d.ts +58 -0
- package/dist/components/DockLayout/DockLayout.d.ts.map +1 -1
- package/dist/components/DockLayout/index.d.ts +1 -1
- package/dist/components/DockLayout/index.d.ts.map +1 -1
- package/dist/components/DocumentCard/DocumentCard.d.ts +5 -1
- package/dist/components/DocumentCard/DocumentCard.d.ts.map +1 -1
- package/dist/components/EntityDetailPanel/EntityDetailPanel.d.ts +6 -2
- package/dist/components/EntityDetailPanel/EntityDetailPanel.d.ts.map +1 -1
- package/dist/components/FileUpload/FileUpload.d.ts +141 -6
- package/dist/components/FileUpload/FileUpload.d.ts.map +1 -1
- package/dist/components/FileUpload/index.d.ts +1 -1
- package/dist/components/FileUpload/index.d.ts.map +1 -1
- package/dist/components/FilterBar/FilterBar.d.ts +27 -1
- package/dist/components/FilterBar/FilterBar.d.ts.map +1 -1
- package/dist/components/FilterBar/index.d.ts +1 -1
- package/dist/components/FilterBar/index.d.ts.map +1 -1
- package/dist/components/FlowAutoLayout/useFlowAutoLayout.d.ts.map +1 -1
- package/dist/components/GanttView/GanttView.d.ts +24 -0
- package/dist/components/GanttView/GanttView.d.ts.map +1 -1
- package/dist/components/GanttView/types.d.ts +33 -7
- package/dist/components/GanttView/types.d.ts.map +1 -1
- package/dist/components/GaugeCard/GaugeCard.d.ts +4 -3
- package/dist/components/GaugeCard/GaugeCard.d.ts.map +1 -1
- package/dist/components/GaugeCard/geometry.d.ts +59 -0
- package/dist/components/GaugeCard/geometry.d.ts.map +1 -0
- package/dist/components/GeoStatusMap/GeoStatusMap.d.ts.map +1 -1
- package/dist/components/GeoStatusMap/types.d.ts +8 -5
- package/dist/components/GeoStatusMap/types.d.ts.map +1 -1
- package/dist/components/GoToTop/GoToTop.d.ts +1 -1
- package/dist/components/GoToTop/GoToTop.d.ts.map +1 -1
- package/dist/components/HierarchicalDrillDown/HierarchicalDrillDown.d.ts.map +1 -1
- package/dist/components/HistoricalDataIndicator/HistoricalDataIndicator.d.ts.map +1 -1
- package/dist/components/HtmlToMui/HtmlToMui.d.ts.map +1 -1
- package/dist/components/Icon.d.ts +567 -10
- package/dist/components/Icon.d.ts.map +1 -1
- package/dist/components/IllustratedMessage.d.ts +52 -3
- package/dist/components/IllustratedMessage.d.ts.map +1 -1
- package/dist/components/InlineEditableText/InlineEditableText.d.ts +117 -0
- package/dist/components/InlineEditableText/InlineEditableText.d.ts.map +1 -0
- package/dist/components/InsightCard/InsightCard.d.ts.map +1 -1
- package/dist/components/InsightCard/types.d.ts +10 -3
- package/dist/components/InsightCard/types.d.ts.map +1 -1
- package/dist/components/KeyValueList/KeyValueList.d.ts +94 -0
- package/dist/components/KeyValueList/KeyValueList.d.ts.map +1 -0
- package/dist/components/LandingPage/FeatureCard.d.ts +4 -0
- package/dist/components/LandingPage/FeatureCard.d.ts.map +1 -1
- package/dist/components/LandingPage/LandingPage.d.ts +43 -4
- package/dist/components/LandingPage/LandingPage.d.ts.map +1 -1
- package/dist/components/LandingPage/heroTone.d.ts +54 -0
- package/dist/components/LandingPage/heroTone.d.ts.map +1 -0
- package/dist/components/MentionsInput/MentionsInput.d.ts.map +1 -1
- package/dist/components/MetaChip/MetaChip.d.ts +113 -0
- package/dist/components/MetaChip/MetaChip.d.ts.map +1 -0
- package/dist/components/Modal/Modal.d.ts +222 -20
- package/dist/components/Modal/Modal.d.ts.map +1 -1
- package/dist/components/Modal/index.d.ts +1 -1
- package/dist/components/Modal/index.d.ts.map +1 -1
- package/dist/components/NotificationCenter/NotificationCenter.d.ts.map +1 -1
- package/dist/components/OrgChart/OrgChart.d.ts +5 -0
- package/dist/components/OrgChart/OrgChart.d.ts.map +1 -1
- package/dist/components/OrgChart/types.d.ts +31 -7
- package/dist/components/OrgChart/types.d.ts.map +1 -1
- package/dist/components/OverflowTooltip/OverflowTooltip.d.ts +1 -1
- package/dist/components/OverflowTooltip/OverflowTooltip.d.ts.map +1 -1
- package/dist/components/PageHeader/PageHeader.d.ts.map +1 -1
- package/dist/components/PageTOC/PageTOC.d.ts +2 -1
- package/dist/components/PageTOC/PageTOC.d.ts.map +1 -1
- package/dist/components/Popper/Popper.d.ts +80 -9
- package/dist/components/Popper/Popper.d.ts.map +1 -1
- package/dist/components/Popper/index.d.ts +1 -1
- package/dist/components/Popper/index.d.ts.map +1 -1
- package/dist/components/PredictiveTextInput/PredictiveTextInput.d.ts +5 -1
- package/dist/components/PredictiveTextInput/PredictiveTextInput.d.ts.map +1 -1
- package/dist/components/SearchInput/SearchInput.d.ts +49 -0
- package/dist/components/SearchInput/SearchInput.d.ts.map +1 -1
- package/dist/components/SearchInput/index.d.ts +1 -1
- package/dist/components/SearchInput/index.d.ts.map +1 -1
- package/dist/components/SimpleTable/SimpleTable.d.ts +11 -2
- package/dist/components/SimpleTable/SimpleTable.d.ts.map +1 -1
- package/dist/components/SplitPane/SplitPane.d.ts +2 -1
- package/dist/components/SplitPane/SplitPane.d.ts.map +1 -1
- package/dist/components/StatusHero/StatusHero.d.ts.map +1 -1
- package/dist/components/StatusIndicator/Badge.d.ts +6 -1
- package/dist/components/StatusIndicator/Badge.d.ts.map +1 -1
- package/dist/components/StatusIndicator/Chip.d.ts +3 -1
- package/dist/components/StatusIndicator/Chip.d.ts.map +1 -1
- package/dist/components/StatusIndicator/Indicators.d.ts +5 -1
- package/dist/components/StatusIndicator/Indicators.d.ts.map +1 -1
- package/dist/components/StatusIndicator/Legend.d.ts.map +1 -1
- package/dist/components/StatusIndicator/StatusIndicator.d.ts +98 -4
- package/dist/components/StatusIndicator/StatusIndicator.d.ts.map +1 -1
- package/dist/components/StatusIndicator/index.d.ts +2 -2
- package/dist/components/StatusIndicator/index.d.ts.map +1 -1
- package/dist/components/StatusIndicator/types.d.ts +48 -1
- package/dist/components/StatusIndicator/types.d.ts.map +1 -1
- package/dist/components/StepList/StepList.d.ts +80 -0
- package/dist/components/StepList/StepList.d.ts.map +1 -0
- package/dist/components/StepList/StepStatusMarker.d.ts +39 -0
- package/dist/components/StepList/StepStatusMarker.d.ts.map +1 -0
- package/dist/components/StepList/stepStatus.d.ts +30 -0
- package/dist/components/StepList/stepStatus.d.ts.map +1 -0
- package/dist/components/SystemBanner/SystemBanner.d.ts.map +1 -1
- package/dist/components/Timeline/Timeline.d.ts +57 -3
- package/dist/components/Timeline/Timeline.d.ts.map +1 -1
- package/dist/components/Timeline/index.d.ts +1 -1
- package/dist/components/Timeline/index.d.ts.map +1 -1
- package/dist/components/Timeline/timelineLabels.d.ts +70 -0
- package/dist/components/Timeline/timelineLabels.d.ts.map +1 -0
- package/dist/components/Toast/Toast.d.ts.map +1 -1
- package/dist/components/TopNavHeader.d.ts +6 -0
- package/dist/components/TopNavHeader.d.ts.map +1 -1
- package/dist/components/TopNavWithSidebar.d.ts +49 -1
- package/dist/components/TopNavWithSidebar.d.ts.map +1 -1
- package/dist/components/Tour/Tour.d.ts +18 -1
- package/dist/components/Tour/Tour.d.ts.map +1 -1
- package/dist/components/TransferList/TransferList.d.ts +123 -4
- package/dist/components/TransferList/TransferList.d.ts.map +1 -1
- package/dist/components/TransferList/index.d.ts +1 -1
- package/dist/components/TransferList/index.d.ts.map +1 -1
- package/dist/components/TreeView/TreeView.d.ts +97 -8
- package/dist/components/TreeView/TreeView.d.ts.map +1 -1
- package/dist/components/TreeView/index.d.ts +1 -1
- package/dist/components/TreeView/index.d.ts.map +1 -1
- package/dist/components/TrinityLoader.d.ts.map +1 -1
- package/dist/components/icons/featherExtensions.d.ts +55 -0
- package/dist/components/icons/featherExtensions.d.ts.map +1 -0
- package/dist/components/icons/materialExtensions.d.ts +20 -0
- package/dist/components/icons/materialExtensions.d.ts.map +1 -0
- package/dist/components/internal/index.d.ts +87 -0
- package/dist/components/internal/index.d.ts.map +1 -1
- package/dist/components/navigation/MenuListWithHeading.d.ts +33 -0
- package/dist/components/navigation/MenuListWithHeading.d.ts.map +1 -0
- package/dist/components/navigation/clientSelectorLabels.d.ts +13 -0
- package/dist/components/navigation/clientSelectorLabels.d.ts.map +1 -0
- package/dist/components/navigation/components.d.ts +6 -0
- package/dist/components/navigation/components.d.ts.map +1 -1
- package/dist/components/shared/AsyncOutcomeAlert.d.ts +91 -0
- package/dist/components/shared/AsyncOutcomeAlert.d.ts.map +1 -0
- package/dist/components/shared/TrinityIconSvg.d.ts.map +1 -1
- package/dist/components/shared/TrinityLogoSvg.d.ts.map +1 -1
- package/dist/components/shared/bidi.d.ts +44 -0
- package/dist/components/shared/bidi.d.ts.map +1 -0
- package/dist/components/shared/bidiText.d.ts +25 -0
- package/dist/components/shared/bidiText.d.ts.map +1 -0
- package/dist/components/shared/containerQueries.d.ts +73 -0
- package/dist/components/shared/containerQueries.d.ts.map +1 -0
- package/dist/components/shared/createStringsContext.d.ts +69 -0
- package/dist/components/shared/createStringsContext.d.ts.map +1 -0
- package/dist/components/shared/direction.d.ts +46 -0
- package/dist/components/shared/direction.d.ts.map +1 -0
- package/dist/components/shared/focusTrap.d.ts +36 -0
- package/dist/components/shared/focusTrap.d.ts.map +1 -0
- package/dist/components/shared/getInitials.d.ts +29 -0
- package/dist/components/shared/getInitials.d.ts.map +1 -0
- package/dist/components/shared/headingLevel.d.ts +69 -0
- package/dist/components/shared/headingLevel.d.ts.map +1 -0
- package/dist/components/shared/mergeSlotProps.d.ts +50 -0
- package/dist/components/shared/mergeSlotProps.d.ts.map +1 -0
- package/dist/components/shared/mergeSx.d.ts +26 -0
- package/dist/components/shared/mergeSx.d.ts.map +1 -0
- package/dist/components/shared/motion.d.ts +110 -0
- package/dist/components/shared/motion.d.ts.map +1 -0
- package/dist/components/shared/occurrenceKeys.d.ts +23 -0
- package/dist/components/shared/occurrenceKeys.d.ts.map +1 -0
- package/dist/components/shared/primaryAction.d.ts +89 -0
- package/dist/components/shared/primaryAction.d.ts.map +1 -0
- package/dist/components/shared/resizeKeyboard.d.ts +68 -0
- package/dist/components/shared/resizeKeyboard.d.ts.map +1 -0
- package/dist/components/shared/rootProps.d.ts +117 -0
- package/dist/components/shared/rootProps.d.ts.map +1 -0
- package/dist/components/shared/safeContent.d.ts +9 -2
- package/dist/components/shared/safeContent.d.ts.map +1 -1
- package/dist/components/shared/targetSize.d.ts +64 -0
- package/dist/components/shared/targetSize.d.ts.map +1 -0
- package/dist/components/shared/useContainerInlineSize.d.ts +43 -0
- package/dist/components/shared/useContainerInlineSize.d.ts.map +1 -0
- package/dist/components/shared/useCopyAction.d.ts +35 -0
- package/dist/components/shared/useCopyAction.d.ts.map +1 -0
- package/dist/components/shared/useOverflow.d.ts +44 -0
- package/dist/components/shared/useOverflow.d.ts.map +1 -0
- package/dist/components/shared/useResizable.d.ts +106 -7
- package/dist/components/shared/useResizable.d.ts.map +1 -1
- package/dist/components/shared/warnDeprecated.d.ts +89 -15
- package/dist/components/shared/warnDeprecated.d.ts.map +1 -1
- package/dist/components/shared/zIndexRoles.d.ts +62 -0
- package/dist/components/shared/zIndexRoles.d.ts.map +1 -0
- package/dist/components/templates/AIReviewQueue/AIReviewQueueTemplate.d.ts +213 -0
- package/dist/components/templates/AIReviewQueue/AIReviewQueueTemplate.d.ts.map +1 -0
- package/dist/components/templates/AIReviewQueue/index.d.ts +2 -0
- package/dist/components/templates/AIReviewQueue/index.d.ts.map +1 -0
- package/dist/components/templates/Auth/AuthTemplate.d.ts.map +1 -1
- package/dist/components/templates/Auth/types.d.ts +4 -1
- package/dist/components/templates/Auth/types.d.ts.map +1 -1
- package/dist/components/templates/Catalog/CatalogTemplate.d.ts.map +1 -1
- package/dist/components/templates/ConnectorWizard/ConnectorWizardTemplate.d.ts.map +1 -1
- package/dist/components/templates/InsightsCenter/InsightsCenterTemplate.d.ts.map +1 -1
- package/dist/components/templates/IntegrationDetail/IntegrationDetailTemplate.d.ts.map +1 -1
- package/dist/components/templates/ListDetail/ListDetailTemplate.d.ts +168 -10
- package/dist/components/templates/ListDetail/ListDetailTemplate.d.ts.map +1 -1
- package/dist/components/templates/ListDetail/index.d.ts +1 -1
- package/dist/components/templates/ListDetail/index.d.ts.map +1 -1
- package/dist/components/templates/ListDetail/listDetailLabels.d.ts +106 -0
- package/dist/components/templates/ListDetail/listDetailLabels.d.ts.map +1 -0
- package/dist/components/templates/Onboarding/OnboardingTemplate.d.ts.map +1 -1
- package/dist/components/templates/Settings/SettingsTemplate.d.ts +0 -3
- package/dist/components/templates/Settings/SettingsTemplate.d.ts.map +1 -1
- package/dist/components/templates/Wizard/WizardTemplate.d.ts +4 -1
- package/dist/components/templates/Wizard/WizardTemplate.d.ts.map +1 -1
- package/dist/components/templates/index.d.ts +2 -1
- package/dist/components/templates/index.d.ts.map +1 -1
- package/dist/data-table.d.ts +1 -1
- package/dist/data-table.d.ts.map +1 -1
- package/dist/data-table.js +1 -0
- package/dist/data-table2.js +13522 -13465
- package/dist/data.js +213 -194
- package/dist/elk.bundled.js +47371 -0
- package/dist/essentials.d.ts +3 -3
- package/dist/essentials.d.ts.map +1 -1
- package/dist/essentials.js +179 -147
- package/dist/focus-on-replace.js +49 -0
- package/dist/form.d.ts +26 -4
- package/dist/form.d.ts.map +1 -1
- package/dist/forms.js +575 -483
- package/dist/foundation.js +3704 -0
- package/dist/hooks/storageStore.d.ts +51 -0
- package/dist/hooks/storageStore.d.ts.map +1 -0
- package/dist/hooks/useAsyncAction.d.ts +65 -0
- package/dist/hooks/useAsyncAction.d.ts.map +1 -0
- package/dist/hooks/useDisclosure.d.ts +190 -0
- package/dist/hooks/useDisclosure.d.ts.map +1 -0
- package/dist/hooks/useFocusOnReplace.d.ts +95 -0
- package/dist/hooks/useFocusOnReplace.d.ts.map +1 -0
- package/dist/hooks/useTrinityPalette.d.ts +38 -40
- package/dist/hooks/useTrinityPalette.d.ts.map +1 -1
- package/dist/hooks.d.ts +44 -6
- package/dist/hooks.d.ts.map +1 -1
- package/dist/hooks.js +301 -0
- package/dist/index.d.ts +71 -26
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +13923 -60619
- package/dist/patterns/AICopilotPattern/AICopilotPattern.d.ts +203 -0
- package/dist/patterns/AICopilotPattern/AICopilotPattern.d.ts.map +1 -0
- package/dist/patterns/AICopilotPattern/index.d.ts +3 -0
- package/dist/patterns/AICopilotPattern/index.d.ts.map +1 -0
- package/dist/patterns/index.d.ts +15 -0
- package/dist/patterns/index.d.ts.map +1 -0
- package/dist/presets/analytics.d.ts +8 -1
- package/dist/presets/analytics.d.ts.map +1 -1
- package/dist/presets/crm.d.ts +8 -1
- package/dist/presets/crm.d.ts.map +1 -1
- package/dist/presets/index.d.ts +1 -1
- package/dist/presets/portal.d.ts +8 -1
- package/dist/presets/portal.d.ts.map +1 -1
- package/dist/safe-content.js +69 -69
- package/dist/theme-augmentation.d.ts +388 -0
- package/dist/theme-augmentation.d.ts.map +1 -0
- package/dist/theme.d.ts +116 -30
- package/dist/theme.d.ts.map +1 -1
- package/dist/theme.js +891 -436
- package/dist/token-color.d.ts +14 -0
- package/dist/token-color.d.ts.map +1 -0
- package/dist/token-merge.d.ts +56 -0
- package/dist/token-merge.d.ts.map +1 -0
- package/dist/token-serialization.d.ts +65 -0
- package/dist/token-serialization.d.ts.map +1 -0
- package/dist/tokens.d.ts +882 -13
- package/dist/tokens.d.ts.map +1 -1
- package/dist/tokens.js +21 -19
- package/dist/trinity.css +1077 -414
- package/package.json +111 -90
- package/dist/components/index.d.ts +0 -145
- package/dist/components/index.d.ts.map +0 -1
- package/dist/components/shared.d.ts +0 -92
- package/dist/components/shared.d.ts.map +0 -1
|
@@ -0,0 +1,388 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MUI theme augmentation for the Trinity palette (ADR-26 (1)-(2), master plan E-01).
|
|
3
|
+
*
|
|
4
|
+
* This is a real module, not a `.d.ts` input, so `tsc` emits it with the declarations.
|
|
5
|
+
* `src/theme.ts` and `src/index.ts` import it for its side effect and re-export its types, so
|
|
6
|
+
* the root and `./theme` entries carry the augmentation to consumers.
|
|
7
|
+
*
|
|
8
|
+
* The Trinity palette types are top-level exports of this file. They are not members of MUI's
|
|
9
|
+
* module: `import type { TrinityPalette } from '@mui/material/styles'` does not compile.
|
|
10
|
+
*
|
|
11
|
+
* Group rules:
|
|
12
|
+
* - `interactive`, `status` and `border` are present on every Trinity theme and stay required.
|
|
13
|
+
* - The other groups are optional on {@link TrinityPalette}: a consumer may build
|
|
14
|
+
* `palette.trinity` through `PaletteOptions` or a plain `createTheme()` without them.
|
|
15
|
+
* - {@link ResolvedTrinityPalette} has every group. `getTrinityPalette(theme)` and
|
|
16
|
+
* `useTrinityPalette()` return it, with a fallback derived from the MUI palette.
|
|
17
|
+
*/
|
|
18
|
+
import '@mui/material/styles';
|
|
19
|
+
import type { PaletteColor, PaletteColorOptions } from '@mui/material/styles';
|
|
20
|
+
import type { TrinityIndicatorStatus, TrinityTokens } from './tokens.js';
|
|
21
|
+
/**
|
|
22
|
+
* Text, background and border colors of one status role.
|
|
23
|
+
*
|
|
24
|
+
* @since 2.13.0
|
|
25
|
+
*/
|
|
26
|
+
export interface TrinityStatusColor {
|
|
27
|
+
text: string;
|
|
28
|
+
background: string;
|
|
29
|
+
border: string;
|
|
30
|
+
}
|
|
31
|
+
/**
|
|
32
|
+
* Interactive state colors.
|
|
33
|
+
*
|
|
34
|
+
* @since 2.13.0
|
|
35
|
+
*/
|
|
36
|
+
export interface TrinityInteractive {
|
|
37
|
+
default: string;
|
|
38
|
+
hover: string;
|
|
39
|
+
active: string;
|
|
40
|
+
disabled: string;
|
|
41
|
+
focus: string;
|
|
42
|
+
}
|
|
43
|
+
/**
|
|
44
|
+
* Border colors. `focus` is set on every Trinity theme; it is optional here so a consumer's
|
|
45
|
+
* `palette.trinity.border` without it still compiles.
|
|
46
|
+
*
|
|
47
|
+
* @since 2.13.0
|
|
48
|
+
*/
|
|
49
|
+
export interface TrinityBorder {
|
|
50
|
+
default: string;
|
|
51
|
+
subtle: string;
|
|
52
|
+
strong: string;
|
|
53
|
+
/** Focus border. Set by Trinity themes; always present on {@link ResolvedTrinityPalette}. */
|
|
54
|
+
focus?: string;
|
|
55
|
+
}
|
|
56
|
+
/**
|
|
57
|
+
* A role that renders as text on a tinted background with a border, like a status badge.
|
|
58
|
+
* Confidence and verification roles use it. The border doubles as a bar fill.
|
|
59
|
+
*
|
|
60
|
+
* @since 2.13.0
|
|
61
|
+
*/
|
|
62
|
+
export interface TrinityRoleColor {
|
|
63
|
+
text: string;
|
|
64
|
+
background: string;
|
|
65
|
+
border: string;
|
|
66
|
+
}
|
|
67
|
+
/**
|
|
68
|
+
* The twelve AI color roles (ADR-03, amended by ADR-03-R15).
|
|
69
|
+
*
|
|
70
|
+
* - `primary` is AI text and accent lines. Fills under white content use `primaryFill` with
|
|
71
|
+
* `onPrimaryFill`.
|
|
72
|
+
* - `surface`, `surfaceHover`, `border` and `badgeBackground` are tints for AI containers.
|
|
73
|
+
* - `surfaceEmphasis` and `surfaceEmphasisHover` are resting emphasis tints and their hover.
|
|
74
|
+
*
|
|
75
|
+
* @since 2.13.0
|
|
76
|
+
*/
|
|
77
|
+
export interface TrinityAIRoles {
|
|
78
|
+
primary: string;
|
|
79
|
+
primaryFill: string;
|
|
80
|
+
onPrimaryFill: string;
|
|
81
|
+
accent: string;
|
|
82
|
+
surface: string;
|
|
83
|
+
surfaceHover: string;
|
|
84
|
+
surfaceEmphasis: string;
|
|
85
|
+
surfaceEmphasisHover: string;
|
|
86
|
+
border: string;
|
|
87
|
+
badgeBackground: string;
|
|
88
|
+
typingIndicator: string;
|
|
89
|
+
focusRing: string;
|
|
90
|
+
/** Decorative presence colors for the voice orb and composer glow (ADR-03-R11). */
|
|
91
|
+
presence?: TrinityAIPresenceRoles;
|
|
92
|
+
/**
|
|
93
|
+
* AIAvatar's brand gradient stops, top to bottom, under `onPrimaryFill` (owner decision
|
|
94
|
+
* 2026-10-08). Coral 800 to purple 700 in both modes; `gradient.avatar` is built from them.
|
|
95
|
+
* The dark `accent` and `primaryFill` are too light under a white icon (2.5-2.9:1).
|
|
96
|
+
*
|
|
97
|
+
* @since 2.13.0
|
|
98
|
+
*/
|
|
99
|
+
avatarFill?: {
|
|
100
|
+
start: string;
|
|
101
|
+
end: string;
|
|
102
|
+
};
|
|
103
|
+
/**
|
|
104
|
+
* The completed share of an AI progress graphic (AIChainOfThought's completed phase dots and
|
|
105
|
+
* insight confidence bar), 3:1 or more on the paper and the AI surface; never text. Light is
|
|
106
|
+
* the chart teal, dark the brighter teal of the owner's mockups (2026-10-08).
|
|
107
|
+
*
|
|
108
|
+
* @since 2.13.0
|
|
109
|
+
*/
|
|
110
|
+
progress?: string;
|
|
111
|
+
/**
|
|
112
|
+
* The AI start screen's canvas wash, lavender (`start`) to pink (`end`); `gradient.canvas` is
|
|
113
|
+
* built from them (AIChatWelcome). Decorative: text on the canvas keeps 4.5:1.
|
|
114
|
+
*
|
|
115
|
+
* @since 2.13.0
|
|
116
|
+
*/
|
|
117
|
+
canvasFill?: {
|
|
118
|
+
start: string;
|
|
119
|
+
end: string;
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
/**
|
|
123
|
+
* Decorative AI presence colors (ADR-03-R11). They carry no information, so no contrast
|
|
124
|
+
* requirement applies; text or icons placed on them follow the gradient text treatment.
|
|
125
|
+
*
|
|
126
|
+
* @since 2.13.0
|
|
127
|
+
*/
|
|
128
|
+
export interface TrinityAIPresenceRoles {
|
|
129
|
+
blue: string;
|
|
130
|
+
violet: string;
|
|
131
|
+
purple: string;
|
|
132
|
+
coral: string;
|
|
133
|
+
base: string;
|
|
134
|
+
}
|
|
135
|
+
/**
|
|
136
|
+
* AI gradients, derived from the resolved `ai.accent` and `ai.primaryFill` (OD-E7); `avatar`
|
|
137
|
+
* and `brandDiagonal` from `ai.avatarFill`; `canvas` from `ai.canvasFill`. The CSS package
|
|
138
|
+
* ships the same gradients as `--trinity-ai-gradient-*`.
|
|
139
|
+
*
|
|
140
|
+
* @since 2.13.0
|
|
141
|
+
*/
|
|
142
|
+
export interface TrinityAIGradients {
|
|
143
|
+
primary: string;
|
|
144
|
+
horizontal: string;
|
|
145
|
+
diagonal: string;
|
|
146
|
+
subtle: string;
|
|
147
|
+
text: string;
|
|
148
|
+
border: string;
|
|
149
|
+
/**
|
|
150
|
+
* AIAvatar's fill: `ai.avatarFill.start` to `.end`, 180deg (owner decision 2026-10-08).
|
|
151
|
+
*
|
|
152
|
+
* @since 2.13.0
|
|
153
|
+
*/
|
|
154
|
+
avatar: string;
|
|
155
|
+
/**
|
|
156
|
+
* The brand gradient at 135deg, `ai.avatarFill.start` (top left) to `.end` (bottom right): the
|
|
157
|
+
* fill of AIFab and of AICircularAction's `gradient` variant under a centred icon in
|
|
158
|
+
* `ai.onPrimaryFill`, the same in light and dark (owner decision 2026-10-09). The resolver's
|
|
159
|
+
* `diagonal` runs from the dark accent, too light under a white icon in dark mode.
|
|
160
|
+
*
|
|
161
|
+
* @since 2.13.0
|
|
162
|
+
*/
|
|
163
|
+
brandDiagonal: string;
|
|
164
|
+
/**
|
|
165
|
+
* The AI start screen's canvas (AIChatWelcome): transparent (the paper shows) to
|
|
166
|
+
* `ai.canvasFill.start` at 60% and `.end` at 100%, 135deg (toward the bottom right).
|
|
167
|
+
*
|
|
168
|
+
* @since 2.13.0
|
|
169
|
+
*/
|
|
170
|
+
canvas: string;
|
|
171
|
+
}
|
|
172
|
+
/**
|
|
173
|
+
* Confidence roles. Each references a status role (ADR-03-R1): high uses success, medium uses
|
|
174
|
+
* info and low uses warning.
|
|
175
|
+
*
|
|
176
|
+
* @since 2.13.0
|
|
177
|
+
*/
|
|
178
|
+
export interface TrinityConfidenceRoles {
|
|
179
|
+
high: TrinityRoleColor;
|
|
180
|
+
medium: TrinityRoleColor;
|
|
181
|
+
low: TrinityRoleColor;
|
|
182
|
+
}
|
|
183
|
+
/**
|
|
184
|
+
* Verification roles. Each references a status role (ADR-03-R1): verified and golden use
|
|
185
|
+
* success, pending uses info, flagged uses warning and rejected uses error.
|
|
186
|
+
*
|
|
187
|
+
* @since 2.13.0
|
|
188
|
+
*/
|
|
189
|
+
export interface TrinityVerificationRoles {
|
|
190
|
+
verified: TrinityRoleColor;
|
|
191
|
+
golden: TrinityRoleColor;
|
|
192
|
+
pending: TrinityRoleColor;
|
|
193
|
+
flagged: TrinityRoleColor;
|
|
194
|
+
rejected: TrinityRoleColor;
|
|
195
|
+
}
|
|
196
|
+
/**
|
|
197
|
+
* Neutral surfaces per mode (ADR-03-R3). `subtle` is the secondary background.
|
|
198
|
+
*
|
|
199
|
+
* @since 2.13.0
|
|
200
|
+
*/
|
|
201
|
+
export interface TrinitySurfaceRoles {
|
|
202
|
+
elevated: string;
|
|
203
|
+
sunken: string;
|
|
204
|
+
subtle: string;
|
|
205
|
+
/**
|
|
206
|
+
* A neutral fill under an icon, such as a user avatar's fallback disc (ADR-03-R9): light MUI
|
|
207
|
+
* grey[300], dark gray[600]. Always present on {@link ResolvedTrinityPalette}.
|
|
208
|
+
*
|
|
209
|
+
* @since 2.13.0
|
|
210
|
+
*/
|
|
211
|
+
neutralFill?: string;
|
|
212
|
+
}
|
|
213
|
+
/**
|
|
214
|
+
* Neutral overlay washes for interaction states, per mode (ADR-03-R3).
|
|
215
|
+
*
|
|
216
|
+
* @since 2.13.0
|
|
217
|
+
*/
|
|
218
|
+
export interface TrinityOverlayRoles {
|
|
219
|
+
hover: string;
|
|
220
|
+
hoverSubtle: string;
|
|
221
|
+
pressed: string;
|
|
222
|
+
selected: string;
|
|
223
|
+
}
|
|
224
|
+
/**
|
|
225
|
+
* Status washes (subtle fills) and emphasis borders, per mode (ADR-03-R3).
|
|
226
|
+
*
|
|
227
|
+
* @since 2.13.0
|
|
228
|
+
*/
|
|
229
|
+
export interface TrinityStateRoles {
|
|
230
|
+
errorSubtle: string;
|
|
231
|
+
errorEmphasis: string;
|
|
232
|
+
warningSubtle: string;
|
|
233
|
+
warningEmphasis: string;
|
|
234
|
+
successSubtle: string;
|
|
235
|
+
successEmphasis: string;
|
|
236
|
+
infoSubtle: string;
|
|
237
|
+
infoEmphasis: string;
|
|
238
|
+
}
|
|
239
|
+
/**
|
|
240
|
+
* One status indicator's colours (ADR-03-R6), per mode.
|
|
241
|
+
*
|
|
242
|
+
* - `fill` and `onFill`: the dot, badge or chip fill and the text or icon on it.
|
|
243
|
+
* - `outline`: a ring that keeps a light fill (the warning family) visible on light surfaces.
|
|
244
|
+
* - `onSurface`: the status colour as text or an icon straight on the page, paper or elevated
|
|
245
|
+
* surface. Light references the catalog (`outline ?? fill`); dark references an existing dark
|
|
246
|
+
* role (the status texts, `text.secondary`, `text.brand`, indigo[200]).
|
|
247
|
+
*
|
|
248
|
+
* @since 2.13.0
|
|
249
|
+
*/
|
|
250
|
+
export interface TrinityIndicatorColor {
|
|
251
|
+
fill: string;
|
|
252
|
+
onFill: string;
|
|
253
|
+
outline?: string;
|
|
254
|
+
onSurface: string;
|
|
255
|
+
}
|
|
256
|
+
/**
|
|
257
|
+
* The indicator group: one {@link TrinityIndicatorColor} per catalog status (ADR-03-R6).
|
|
258
|
+
*
|
|
259
|
+
* @since 2.13.0
|
|
260
|
+
*/
|
|
261
|
+
export type TrinityIndicatorRoles = Record<TrinityIndicatorStatus, TrinityIndicatorColor>;
|
|
262
|
+
/**
|
|
263
|
+
* The Trinity palette on `theme.palette.trinity`.
|
|
264
|
+
*
|
|
265
|
+
* Trinity themes set every group. The groups added in 2.13.0 are optional on this type, so a
|
|
266
|
+
* consumer-built palette without them compiles. Read colors in components through
|
|
267
|
+
* `getTrinityPalette(theme)` or `useTrinityPalette()`, which always return every group.
|
|
268
|
+
*
|
|
269
|
+
* @since 2.13.0
|
|
270
|
+
*/
|
|
271
|
+
export interface TrinityPalette {
|
|
272
|
+
interactive: TrinityInteractive;
|
|
273
|
+
status: {
|
|
274
|
+
success: TrinityStatusColor;
|
|
275
|
+
warning: TrinityStatusColor;
|
|
276
|
+
error: TrinityStatusColor;
|
|
277
|
+
info: TrinityStatusColor;
|
|
278
|
+
};
|
|
279
|
+
border: TrinityBorder;
|
|
280
|
+
ai?: TrinityAIRoles;
|
|
281
|
+
confidence?: TrinityConfidenceRoles;
|
|
282
|
+
verification?: TrinityVerificationRoles;
|
|
283
|
+
surface?: TrinitySurfaceRoles;
|
|
284
|
+
overlay?: TrinityOverlayRoles;
|
|
285
|
+
state?: TrinityStateRoles;
|
|
286
|
+
/** StatusIndicator colours (ADR-03-R6). @since 2.13.0 */
|
|
287
|
+
indicator?: TrinityIndicatorRoles;
|
|
288
|
+
/**
|
|
289
|
+
* The favorite role (ADR-03-R10): a pinned or favorite mark, such as the filled star of a
|
|
290
|
+
* starred thread. References the mode's `status.warning.text`. @since 2.13.0
|
|
291
|
+
*/
|
|
292
|
+
favorite?: string;
|
|
293
|
+
}
|
|
294
|
+
/**
|
|
295
|
+
* The complete palette the resolver returns: every group is present, `border.focus` is set and
|
|
296
|
+
* `ai` carries its presence colors, avatar fill, progress colour, canvas fill and gradients.
|
|
297
|
+
*
|
|
298
|
+
* @since 2.13.0
|
|
299
|
+
*/
|
|
300
|
+
export interface ResolvedTrinityPalette {
|
|
301
|
+
interactive: TrinityInteractive;
|
|
302
|
+
status: TrinityPalette['status'];
|
|
303
|
+
border: Required<TrinityBorder>;
|
|
304
|
+
ai: Omit<TrinityAIRoles, 'presence' | 'avatarFill' | 'progress' | 'canvasFill'> & {
|
|
305
|
+
presence: TrinityAIPresenceRoles;
|
|
306
|
+
avatarFill: NonNullable<TrinityAIRoles['avatarFill']>;
|
|
307
|
+
progress: string;
|
|
308
|
+
canvasFill: NonNullable<TrinityAIRoles['canvasFill']>;
|
|
309
|
+
gradient: TrinityAIGradients;
|
|
310
|
+
};
|
|
311
|
+
confidence: TrinityConfidenceRoles;
|
|
312
|
+
verification: TrinityVerificationRoles;
|
|
313
|
+
surface: Required<TrinitySurfaceRoles>;
|
|
314
|
+
overlay: TrinityOverlayRoles;
|
|
315
|
+
state: TrinityStateRoles;
|
|
316
|
+
indicator: TrinityIndicatorRoles;
|
|
317
|
+
favorite: string;
|
|
318
|
+
}
|
|
319
|
+
declare module '@mui/material/styles' {
|
|
320
|
+
interface Palette {
|
|
321
|
+
trinity: TrinityPalette;
|
|
322
|
+
}
|
|
323
|
+
/**
|
|
324
|
+
* Named overlay layer roles (ADR-03-R12, E-46+), offsets on MUI's own scale: `aiPanel`
|
|
325
|
+
* (drawer - 1), `appChrome` and `aiFab` (drawer + 1), `popover` (modal), `toast` (snackbar),
|
|
326
|
+
* `skipLink` (tooltip + 1), `diagnostic` (tooltip + 2). Trinity themes carry them; they are
|
|
327
|
+
* optional because a plain `createTheme()` or a consumer theme does not, and components derive
|
|
328
|
+
* a missing role from the scale.
|
|
329
|
+
*
|
|
330
|
+
* @since 2.13.0
|
|
331
|
+
*/
|
|
332
|
+
interface ZIndex {
|
|
333
|
+
appChrome?: number;
|
|
334
|
+
aiPanel?: number;
|
|
335
|
+
aiFab?: number;
|
|
336
|
+
popover?: number;
|
|
337
|
+
toast?: number;
|
|
338
|
+
skipLink?: number;
|
|
339
|
+
diagnostic?: number;
|
|
340
|
+
}
|
|
341
|
+
interface PaletteOptions {
|
|
342
|
+
trinity?: Partial<TrinityPalette>;
|
|
343
|
+
}
|
|
344
|
+
interface Theme {
|
|
345
|
+
/**
|
|
346
|
+
* The resolved Trinity token set this theme was built from: the defaults with the
|
|
347
|
+
* theme's token overrides merged in. Set by every Trinity theme factory; absent on a
|
|
348
|
+
* plain MUI theme. Pass it to `injectTrinityCssVariables` so runtime CSS matches the
|
|
349
|
+
* theme.
|
|
350
|
+
*
|
|
351
|
+
* @since 2.13.0
|
|
352
|
+
*/
|
|
353
|
+
trinityTokens?: TrinityTokens;
|
|
354
|
+
}
|
|
355
|
+
interface ThemeOptions {
|
|
356
|
+
/** @since 2.13.0 */
|
|
357
|
+
trinityTokens?: TrinityTokens;
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
declare module '@mui/material/styles' {
|
|
361
|
+
interface Palette {
|
|
362
|
+
/**
|
|
363
|
+
* The button colour for navy brand surfaces (a hero, the header, the sidebar): `main` is the
|
|
364
|
+
* white fill, `dark` its pressed shade, `contrastText` the navy label. The same in light and
|
|
365
|
+
* dark mode. Trinity themes set it; it is optional because a plain `createTheme()` does not.
|
|
366
|
+
*
|
|
367
|
+
* @since 2.13.0
|
|
368
|
+
*/
|
|
369
|
+
onBrand?: PaletteColor;
|
|
370
|
+
}
|
|
371
|
+
interface PaletteOptions {
|
|
372
|
+
/** @since 2.13.0 */
|
|
373
|
+
onBrand?: PaletteColorOptions;
|
|
374
|
+
}
|
|
375
|
+
}
|
|
376
|
+
declare module '@mui/material/Button' {
|
|
377
|
+
interface ButtonPropsColorOverrides {
|
|
378
|
+
/**
|
|
379
|
+
* `<Button variant="contained" color="onBrand">` (white fill, navy label) and
|
|
380
|
+
* `<Button variant="outlined" color="onBrand">` (white border and label), for buttons on a
|
|
381
|
+
* navy brand surface, where the navy primary button disappears. Both turn coral on hover.
|
|
382
|
+
*
|
|
383
|
+
* @since 2.13.0
|
|
384
|
+
*/
|
|
385
|
+
onBrand: true;
|
|
386
|
+
}
|
|
387
|
+
}
|
|
388
|
+
//# sourceMappingURL=theme-augmentation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"theme-augmentation.d.ts","sourceRoot":"","sources":["../src/theme-augmentation.ts"],"names":[],"mappings":"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"}
|
package/dist/theme.d.ts
CHANGED
|
@@ -1,38 +1,66 @@
|
|
|
1
|
-
import { createTheme, type ThemeOptions } from '@mui/material/styles';
|
|
2
|
-
import
|
|
1
|
+
import { createTheme, type Theme, type ThemeOptions } from '@mui/material/styles';
|
|
2
|
+
import './theme-augmentation.js';
|
|
3
|
+
import { TrinityTokens, darkModeShadows, darkModeEffects } from './tokens';
|
|
4
|
+
import { type TrinityTokenOverrides } from './token-merge';
|
|
3
5
|
/**
|
|
4
|
-
* Generate all CSS custom properties from tokens
|
|
5
|
-
* Returns a CSS string that can be injected into :root
|
|
6
|
+
* Generate all CSS custom properties from tokens.
|
|
7
|
+
* Returns a CSS string that can be injected into :root.
|
|
8
|
+
*
|
|
9
|
+
* Takes token overrides or a complete token set and resolves it first, as
|
|
10
|
+
* `createTrinityTheme` does (see {@link resolveTrinityTokens}): pass the same overrides, or a
|
|
11
|
+
* theme's `trinityTokens`, and the CSS matches the theme. A component member that equals its
|
|
12
|
+
* semantic source is emitted as `var(source)`; one that differs on purpose keeps its value.
|
|
6
13
|
*/
|
|
7
|
-
export declare function generateCssVariables(
|
|
14
|
+
export declare function generateCssVariables(input?: TrinityTokenOverrides | TrinityTokens): string;
|
|
8
15
|
/**
|
|
9
|
-
* Generate CSS variables string for dark mode overrides
|
|
16
|
+
* Generate CSS variables string for dark mode overrides.
|
|
17
|
+
* Takes token overrides or a complete token set and resolves it first, like
|
|
18
|
+
* {@link generateCssVariables}.
|
|
10
19
|
*/
|
|
11
|
-
export declare function generateDarkModeCssVariables(
|
|
20
|
+
export declare function generateDarkModeCssVariables(input?: TrinityTokenOverrides | TrinityTokens): string;
|
|
12
21
|
/**
|
|
13
22
|
* Returns a set of CSS custom properties for key Trinity tokens.
|
|
14
23
|
* Call this at runtime to inject variables into :root.
|
|
24
|
+
*
|
|
25
|
+
* Takes token overrides or a complete token set. Pass `theme.trinityTokens` (or the overrides
|
|
26
|
+
* you gave `createTrinityTheme`) so the CSS variables match the theme.
|
|
15
27
|
*/
|
|
16
|
-
export declare function injectTrinityCssVariables(tokenSet?: TrinityTokens): void;
|
|
28
|
+
export declare function injectTrinityCssVariables(tokenSet?: TrinityTokenOverrides | TrinityTokens): void;
|
|
17
29
|
/**
|
|
18
30
|
* Inject dark mode CSS variables
|
|
19
|
-
* Adds a style block that applies dark mode overrides when [data-theme="dark"] or .dark-mode is present
|
|
31
|
+
* Adds a style block that applies dark mode overrides when [data-theme="dark"] or .dark-mode is present,
|
|
32
|
+
* on <html> or on any element, and a [data-theme="light"] block that restores the light values
|
|
33
|
+
* inside a dark page or subtree.
|
|
34
|
+
* Takes token overrides or a complete token set, like {@link injectTrinityCssVariables}.
|
|
20
35
|
*/
|
|
21
|
-
export declare function injectDarkModeCssVariables(tokenSet?: TrinityTokens): void;
|
|
36
|
+
export declare function injectDarkModeCssVariables(tokenSet?: TrinityTokenOverrides | TrinityTokens): void;
|
|
22
37
|
/**
|
|
23
|
-
* Calculate contrast ratio
|
|
24
|
-
*
|
|
25
|
-
*
|
|
26
|
-
*
|
|
38
|
+
* Calculate the WCAG 2.x contrast ratio of a foreground color on a background color.
|
|
39
|
+
*
|
|
40
|
+
* Reads hex (3, 4, 6 or 8 digits), rgb(), rgba(), hsl() and hsla(). A translucent background is
|
|
41
|
+
* composited over `options.over` (default white, the light paper; pass the dark surface for a
|
|
42
|
+
* dark-mode wash), and a translucent foreground over the result. Returns NaN, with a one-time
|
|
43
|
+
* development warning, for a color it cannot read (for example a named color or `var()`).
|
|
44
|
+
*
|
|
45
|
+
* @param fg - Foreground color
|
|
46
|
+
* @param bg - Background color
|
|
47
|
+
* @param options - `over`: the opaque surface under a translucent background
|
|
48
|
+
* @returns Contrast ratio, or NaN
|
|
27
49
|
*/
|
|
28
|
-
export declare function getContrastRatio(fg: string, bg: string
|
|
50
|
+
export declare function getContrastRatio(fg: string, bg: string, options?: {
|
|
51
|
+
over?: string;
|
|
52
|
+
}): number;
|
|
29
53
|
/**
|
|
30
54
|
* Validate accessible color pairs and warn if not WCAG AA compliant.
|
|
31
|
-
*
|
|
32
|
-
* @param
|
|
55
|
+
* Returns false when a color cannot be read (the ratio is NaN).
|
|
56
|
+
* @param fg - Foreground color
|
|
57
|
+
* @param bg - Background color
|
|
33
58
|
* @param minRatio - Minimum contrast ratio (default 4.5)
|
|
59
|
+
* @param options - `over`: the opaque surface under a translucent background
|
|
34
60
|
*/
|
|
35
|
-
export declare function validateAccessibility(fg: string, bg: string, minRatio?: number
|
|
61
|
+
export declare function validateAccessibility(fg: string, bg: string, minRatio?: number, options?: {
|
|
62
|
+
over?: string;
|
|
63
|
+
}): boolean;
|
|
36
64
|
/**
|
|
37
65
|
* Configuration options for creating a Trinity theme preset
|
|
38
66
|
*/
|
|
@@ -43,8 +71,18 @@ export interface TrinityThemePresetOptions {
|
|
|
43
71
|
direction?: 'ltr' | 'rtl';
|
|
44
72
|
/** Optional name for the preset (for debugging) */
|
|
45
73
|
name?: string;
|
|
46
|
-
/**
|
|
47
|
-
|
|
74
|
+
/**
|
|
75
|
+
* Token overrides: any part of the token set, at any depth (remediation §5.1). They are
|
|
76
|
+
* deep-merged over the defaults, so `{ semantic: { colors: { status: { success: { text } } } } }`
|
|
77
|
+
* changes one role and keeps every other default.
|
|
78
|
+
*
|
|
79
|
+
* Overrides reach every palette value the builder reads (status, interactive, border,
|
|
80
|
+
* surfaces and the other palette.trinity groups), the typography colors and the component
|
|
81
|
+
* overrides. Font families, sizes and weights of the typography variants come from the
|
|
82
|
+
* typographic hierarchy, not from token overrides: set brand typography with the
|
|
83
|
+
* `typography` option.
|
|
84
|
+
*/
|
|
85
|
+
tokens?: TrinityTokenOverrides;
|
|
48
86
|
/** MUI Palette overrides - extend or modify the color palette */
|
|
49
87
|
palette?: ThemeOptions['palette'];
|
|
50
88
|
/** MUI Component overrides - customize component styles/defaults */
|
|
@@ -103,13 +141,31 @@ export declare function createTrinityThemePreset(options: TrinityThemePresetOpti
|
|
|
103
141
|
* For simple theme creation, use this function.
|
|
104
142
|
* For full preset customization, use createTrinityThemePreset instead.
|
|
105
143
|
*
|
|
144
|
+
* Token overrides are deep-merged over the defaults (remediation §5.1): plain objects merge key
|
|
145
|
+
* by key, arrays and single values replace, and every key you leave out keeps its default.
|
|
146
|
+
* In development, an unknown path, a value of the wrong type or an explicit `undefined` warns
|
|
147
|
+
* once.
|
|
148
|
+
*
|
|
149
|
+
* Overrides reach every palette value the builder reads (palette.trinity and the MUI palette
|
|
150
|
+
* roles built from tokens), the typography colors and the component overrides. Font families,
|
|
151
|
+
* sizes and weights of the typography variants do not come from token overrides; set them with
|
|
152
|
+
* `createTrinityThemePreset({ typography })`.
|
|
153
|
+
*
|
|
106
154
|
* @param mode 'light' | 'dark'
|
|
107
|
-
* @param overrides Optional token overrides
|
|
155
|
+
* @param overrides Optional token overrides: any part of the token set, at any depth
|
|
108
156
|
* @param direction Text direction — 'ltr' (default) or 'rtl' for right-to-left languages
|
|
109
157
|
*/
|
|
110
|
-
export declare function createTrinityTheme(mode: 'light' | 'dark', overrides?:
|
|
111
|
-
export {
|
|
158
|
+
export declare function createTrinityTheme(mode: 'light' | 'dark', overrides?: TrinityTokenOverrides, direction?: 'ltr' | 'rtl'): ReturnType<typeof createTheme>;
|
|
159
|
+
export { resolveTrinityTokens } from './token-merge';
|
|
160
|
+
export { baseTokens, semanticTokens, componentTokens, darkModeTokens, darkModeShadows, darkModeEffects, tokens } from './tokens';
|
|
112
161
|
export { hierarchy, elevationHierarchy, typographicHierarchy, attentionHierarchy, scaleHierarchy, contrastHierarchy, interactiveHierarchy, spacingHierarchy, getElevation, getTypography, getAttentionColor, getHierarchySpacing, } from './tokens';
|
|
162
|
+
/**
|
|
163
|
+
* Brand colour constants, read from the design tokens: each entry references the same
|
|
164
|
+
* baseTokens primitive as `brandColors` in tokens.ts (src/__tests__/brand-colors-facade.test.ts
|
|
165
|
+
* keeps the two equal). Editing this object changes nothing in the theme. To rebrand, pass token
|
|
166
|
+
* overrides to `createTrinityTheme` or `createTrinityThemePreset` (the `tokens` option);
|
|
167
|
+
* `resolveTrinityTokens` shows the result.
|
|
168
|
+
*/
|
|
113
169
|
export declare const brandColors: {
|
|
114
170
|
primary: {
|
|
115
171
|
main: string;
|
|
@@ -128,7 +184,15 @@ export declare const brandColors: {
|
|
|
128
184
|
gray400: string;
|
|
129
185
|
gray500: string;
|
|
130
186
|
gray600: string;
|
|
187
|
+
/**
|
|
188
|
+
* @deprecated Not the dark theme's page colour. Use `theme.palette.background.default`
|
|
189
|
+
* (or `palette.trinity.surface`). Removed in v3.0.
|
|
190
|
+
*/
|
|
131
191
|
darkBg: string;
|
|
192
|
+
/**
|
|
193
|
+
* @deprecated Not the dark theme's paper colour. Use `theme.palette.background.paper`
|
|
194
|
+
* (or `palette.trinity.surface.elevated`). Removed in v3.0.
|
|
195
|
+
*/
|
|
132
196
|
darkPaper: string;
|
|
133
197
|
};
|
|
134
198
|
};
|
|
@@ -170,14 +234,14 @@ export declare const accessibleCombinations: {
|
|
|
170
234
|
* Trinity light theme (MUI Theme)
|
|
171
235
|
* @see createTrinityTheme
|
|
172
236
|
*/
|
|
173
|
-
export declare const lightTheme:
|
|
237
|
+
export declare const lightTheme: Theme;
|
|
174
238
|
/**
|
|
175
239
|
* Trinity dark theme (MUI Theme)
|
|
176
240
|
* @see createTrinityTheme
|
|
177
241
|
*/
|
|
178
|
-
export declare const darkTheme:
|
|
242
|
+
export declare const darkTheme: Theme;
|
|
179
243
|
export interface UseTrinityTokensResult {
|
|
180
|
-
/**
|
|
244
|
+
/** The resolved token set of the current theme (`theme.trinityTokens`, or the defaults) */
|
|
181
245
|
tokens: TrinityTokens;
|
|
182
246
|
/** Base primitive tokens */
|
|
183
247
|
base: TrinityTokens['base'];
|
|
@@ -191,9 +255,17 @@ export interface UseTrinityTokensResult {
|
|
|
191
255
|
mode: 'light' | 'dark';
|
|
192
256
|
/** Whether dark mode is active */
|
|
193
257
|
isDarkMode: boolean;
|
|
194
|
-
/**
|
|
258
|
+
/**
|
|
259
|
+
* Pick a light or dark value by the current mode. An app-level escape hatch: Trinity
|
|
260
|
+
* components read colors through `useTrinityPalette()` / `getTrinityPalette(theme)`, never
|
|
261
|
+
* through a mode branch (OD-E15).
|
|
262
|
+
*/
|
|
195
263
|
getColor: <T extends string>(lightColor: T, darkColor?: T) => T;
|
|
196
|
-
/**
|
|
264
|
+
/**
|
|
265
|
+
* Get a semantic color for the current mode: the dark value when the theme is dark and the
|
|
266
|
+
* token exists, else the light value. `name` may be a dotted path (`'success.text'`). Returns
|
|
267
|
+
* '' for a path that does not exist, with a one-time development warning.
|
|
268
|
+
*/
|
|
197
269
|
getSemanticColor: (category: keyof TrinityTokens['semantic']['colors'], name: string) => string;
|
|
198
270
|
/** Helper to get spacing value in pixels */
|
|
199
271
|
spacing: (size: keyof TrinityTokens['base']['spacing']) => number;
|
|
@@ -203,22 +275,36 @@ export interface UseTrinityTokensResult {
|
|
|
203
275
|
radius: (size: keyof TrinityTokens['base']['borderRadius']) => number;
|
|
204
276
|
/** Helper to get shadow */
|
|
205
277
|
shadow: (size: keyof TrinityTokens['base']['shadows']) => string;
|
|
278
|
+
/** Get a brand glow shadow. */
|
|
279
|
+
glow: (variant: keyof typeof darkModeShadows.glow) => string;
|
|
280
|
+
/** Resolve a semantic effect for the active mode. */
|
|
281
|
+
effect: (category: keyof typeof darkModeEffects, name: string) => string;
|
|
206
282
|
}
|
|
207
283
|
/**
|
|
208
284
|
* React hook to access Trinity design tokens with theme awareness.
|
|
209
285
|
* Provides typed access to all token layers and utility functions.
|
|
210
286
|
*
|
|
287
|
+
* It reads the theme's resolved token set (`theme.trinityTokens`), so token overrides given to
|
|
288
|
+
* `createTrinityTheme` reach `semantic`, `getSemanticColor`, `effect` and `shadow`. Under a
|
|
289
|
+
* plain MUI theme it reads the default tokens.
|
|
290
|
+
*
|
|
291
|
+
* For component colors use `useTrinityPalette()`: it is the mode-aware color resolver and
|
|
292
|
+
* works under any MUI theme. Use this hook for non-color tokens (spacing, radius, motion) and
|
|
293
|
+
* for app code.
|
|
294
|
+
*
|
|
211
295
|
* @example
|
|
212
296
|
* ```tsx
|
|
213
|
-
* const {
|
|
297
|
+
* const { spacingCss, radius, getSemanticColor } = useTrinityTokens();
|
|
214
298
|
*
|
|
215
299
|
* <Box sx={{
|
|
216
|
-
* backgroundColor: getColor(semantic.colors.background.primary),
|
|
217
300
|
* padding: spacingCss(4),
|
|
218
301
|
* borderRadius: radius('md'),
|
|
302
|
+
* color: getSemanticColor('status', 'success.text'),
|
|
219
303
|
* }} />
|
|
220
304
|
* ```
|
|
221
305
|
*/
|
|
222
306
|
export declare function useTrinityTokens(): UseTrinityTokensResult;
|
|
223
307
|
export type { TrinityTokens } from './tokens';
|
|
308
|
+
export type { TrinityTokenOverrides } from './token-merge';
|
|
309
|
+
export type { TrinityPalette, TrinityStatusColor, TrinityInteractive, TrinityBorder, TrinityRoleColor, TrinityAIRoles, TrinityAIPresenceRoles, TrinityAIGradients, TrinityConfidenceRoles, TrinityVerificationRoles, TrinitySurfaceRoles, TrinityOverlayRoles, TrinityStateRoles, ResolvedTrinityPalette, } from './theme-augmentation.js';
|
|
224
310
|
//# sourceMappingURL=theme.d.ts.map
|
package/dist/theme.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}
|