This is page 85 of 188. Use http://codebase.md/xmlui-org/xmlui/tools/vscode/resources/%7Bsrc%7D?lines=true&page={x} to view the full context.
# Directory Structure
```
├── .changeset
│ ├── config.json
│ ├── cyan-tools-design.md
│ ├── every-moments-teach.md
│ ├── full-symbols-accept.md
│ └── tricky-zoos-crash.md
├── .eslintrc.cjs
├── .github
│ ├── build-checklist.png
│ ├── ISSUE_TEMPLATE
│ │ ├── bug_report.md
│ │ └── feature_request.md
│ └── workflows
│ ├── deploy-blog-optimized.yml
│ ├── deploy-blog-swa.yml
│ ├── deploy-blog.yml
│ ├── deploy-docs-optimized.yml
│ ├── deploy-docs-swa.yml
│ ├── deploy-docs.yml
│ ├── prepare-versions.yml
│ ├── release-packages.yml
│ ├── run-all-tests.yml
│ └── run-smoke-tests.yml
├── .gitignore
├── .prettierrc.js
├── .vscode
│ ├── launch.json
│ └── settings.json
├── blog
│ ├── .gitignore
│ ├── .gitkeep
│ ├── CHANGELOG.md
│ ├── extensions.ts
│ ├── index.html
│ ├── index.ts
│ ├── package.json
│ ├── public
│ │ ├── blog
│ │ │ ├── images
│ │ │ │ ├── an-advanced-codefence.gif
│ │ │ │ ├── an-advanced-codefence.mp4
│ │ │ │ ├── blog-page-component.png
│ │ │ │ ├── blog-scrabble.png
│ │ │ │ ├── codefence-runner.png
│ │ │ │ ├── integrated-blog-search.png
│ │ │ │ ├── lorem-ipsum.png
│ │ │ │ ├── playground-checkbox-source.png
│ │ │ │ ├── playground.png
│ │ │ │ ├── use-xmlui-mcp-to-find-a-howto.png
│ │ │ │ └── xmlui-demo-gallery.png
│ │ │ ├── introducing-xmlui.md
│ │ │ ├── lorem-ipsum.md
│ │ │ ├── newest-post.md
│ │ │ ├── older-post.md
│ │ │ ├── xmlui-playground.md
│ │ │ └── xmlui-powered-blog.md
│ │ ├── mockServiceWorker.js
│ │ ├── resources
│ │ │ ├── favicon.ico
│ │ │ ├── files
│ │ │ │ └── for-download
│ │ │ │ └── xmlui
│ │ │ │ └── xmlui-standalone.umd.js
│ │ │ ├── github.svg
│ │ │ ├── llms.txt
│ │ │ ├── logo-dark.svg
│ │ │ ├── logo.svg
│ │ │ ├── pg-popout.svg
│ │ │ ├── rss.svg
│ │ │ └── xmlui-logo.svg
│ │ ├── serve.json
│ │ ├── staticwebapp.config.json
│ │ └── web.config
│ ├── scripts
│ │ ├── download-latest-xmlui.js
│ │ ├── generate-rss.js
│ │ ├── get-releases.js
│ │ └── utils.js
│ ├── src
│ │ ├── components
│ │ │ ├── BlogOverview.xmlui
│ │ │ ├── BlogPage.xmlui
│ │ │ └── PageNotFound.xmlui
│ │ ├── config.ts
│ │ ├── Main.xmlui
│ │ └── themes
│ │ └── blog-theme.ts
│ └── tsconfig.json
├── CONTRIBUTING.md
├── docs
│ ├── .gitignore
│ ├── CHANGELOG.md
│ ├── ComponentRefLinks.txt
│ ├── content
│ │ ├── _meta.json
│ │ ├── components
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ ├── APICall.md
│ │ │ ├── App.md
│ │ │ ├── AppHeader.md
│ │ │ ├── AppState.md
│ │ │ ├── AutoComplete.md
│ │ │ ├── Avatar.md
│ │ │ ├── Backdrop.md
│ │ │ ├── Badge.md
│ │ │ ├── BarChart.md
│ │ │ ├── Bookmark.md
│ │ │ ├── Breakout.md
│ │ │ ├── Button.md
│ │ │ ├── Card.md
│ │ │ ├── Carousel.md
│ │ │ ├── ChangeListener.md
│ │ │ ├── Checkbox.md
│ │ │ ├── CHStack.md
│ │ │ ├── ColorPicker.md
│ │ │ ├── Column.md
│ │ │ ├── ContentSeparator.md
│ │ │ ├── CVStack.md
│ │ │ ├── DataSource.md
│ │ │ ├── DateInput.md
│ │ │ ├── DatePicker.md
│ │ │ ├── DonutChart.md
│ │ │ ├── DropdownMenu.md
│ │ │ ├── EmojiSelector.md
│ │ │ ├── ExpandableItem.md
│ │ │ ├── FileInput.md
│ │ │ ├── FileUploadDropZone.md
│ │ │ ├── FlowLayout.md
│ │ │ ├── Footer.md
│ │ │ ├── Form.md
│ │ │ ├── FormItem.md
│ │ │ ├── FormSection.md
│ │ │ ├── Fragment.md
│ │ │ ├── H1.md
│ │ │ ├── H2.md
│ │ │ ├── H3.md
│ │ │ ├── H4.md
│ │ │ ├── H5.md
│ │ │ ├── H6.md
│ │ │ ├── Heading.md
│ │ │ ├── HSplitter.md
│ │ │ ├── HStack.md
│ │ │ ├── Icon.md
│ │ │ ├── IFrame.md
│ │ │ ├── Image.md
│ │ │ ├── Items.md
│ │ │ ├── LabelList.md
│ │ │ ├── Legend.md
│ │ │ ├── LineChart.md
│ │ │ ├── Link.md
│ │ │ ├── List.md
│ │ │ ├── Logo.md
│ │ │ ├── Markdown.md
│ │ │ ├── MenuItem.md
│ │ │ ├── MenuSeparator.md
│ │ │ ├── ModalDialog.md
│ │ │ ├── NavGroup.md
│ │ │ ├── NavLink.md
│ │ │ ├── NavPanel.md
│ │ │ ├── NoResult.md
│ │ │ ├── NumberBox.md
│ │ │ ├── Option.md
│ │ │ ├── Page.md
│ │ │ ├── PageMetaTitle.md
│ │ │ ├── Pages.md
│ │ │ ├── Pagination.md
│ │ │ ├── PasswordInput.md
│ │ │ ├── PieChart.md
│ │ │ ├── ProgressBar.md
│ │ │ ├── Queue.md
│ │ │ ├── RadioGroup.md
│ │ │ ├── RealTimeAdapter.md
│ │ │ ├── Redirect.md
│ │ │ ├── Select.md
│ │ │ ├── Slider.md
│ │ │ ├── Slot.md
│ │ │ ├── SpaceFiller.md
│ │ │ ├── Spinner.md
│ │ │ ├── Splitter.md
│ │ │ ├── Stack.md
│ │ │ ├── StickyBox.md
│ │ │ ├── SubMenuItem.md
│ │ │ ├── Switch.md
│ │ │ ├── TabItem.md
│ │ │ ├── Table.md
│ │ │ ├── TableOfContents.md
│ │ │ ├── Tabs.md
│ │ │ ├── Text.md
│ │ │ ├── TextArea.md
│ │ │ ├── TextBox.md
│ │ │ ├── Theme.md
│ │ │ ├── TimeInput.md
│ │ │ ├── Timer.md
│ │ │ ├── ToneChangerButton.md
│ │ │ ├── ToneSwitch.md
│ │ │ ├── Tooltip.md
│ │ │ ├── Tree.md
│ │ │ ├── VSplitter.md
│ │ │ ├── VStack.md
│ │ │ ├── xmlui-animations
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ ├── Animation.md
│ │ │ │ ├── FadeAnimation.md
│ │ │ │ ├── FadeInAnimation.md
│ │ │ │ ├── FadeOutAnimation.md
│ │ │ │ ├── ScaleAnimation.md
│ │ │ │ └── SlideInAnimation.md
│ │ │ ├── xmlui-pdf
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ └── Pdf.md
│ │ │ ├── xmlui-spreadsheet
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ └── Spreadsheet.md
│ │ │ └── xmlui-website-blocks
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ ├── Carousel.md
│ │ │ ├── HelloMd.md
│ │ │ ├── HeroSection.md
│ │ │ └── ScrollToTop.md
│ │ └── extensions
│ │ ├── _meta.json
│ │ ├── xmlui-animations
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ ├── Animation.md
│ │ │ ├── FadeAnimation.md
│ │ │ ├── FadeInAnimation.md
│ │ │ ├── FadeOutAnimation.md
│ │ │ ├── ScaleAnimation.md
│ │ │ └── SlideInAnimation.md
│ │ └── xmlui-website-blocks
│ │ ├── _meta.json
│ │ ├── _overview.md
│ │ ├── Carousel.md
│ │ ├── HelloMd.md
│ │ ├── HeroSection.md
│ │ └── ScrollToTop.md
│ ├── extensions.ts
│ ├── index.html
│ ├── index.ts
│ ├── package.json
│ ├── public
│ │ ├── feed.rss
│ │ ├── mockServiceWorker.js
│ │ ├── pages
│ │ │ ├── _meta.json
│ │ │ ├── app-structure.md
│ │ │ ├── build-editor-component.md
│ │ │ ├── build-hello-world-component.md
│ │ │ ├── components-intro.md
│ │ │ ├── context-variables.md
│ │ │ ├── forms.md
│ │ │ ├── globals.md
│ │ │ ├── glossary.md
│ │ │ ├── helper-tags.md
│ │ │ ├── hosted-deployment.md
│ │ │ ├── howto
│ │ │ │ ├── assign-a-complex-json-literal-to-a-component-variable.md
│ │ │ │ ├── chain-a-refetch.md
│ │ │ │ ├── control-cache-invalidation.md
│ │ │ │ ├── debounce-user-input-for-api-calls.md
│ │ │ │ ├── debounce-with-changelistener.md
│ │ │ │ ├── debug-a-component.md
│ │ │ │ ├── delay-a-datasource-until-another-datasource-is-ready.md
│ │ │ │ ├── delegate-a-method.md
│ │ │ │ ├── do-custom-form-validation.md
│ │ │ │ ├── expose-a-method-from-a-component.md
│ │ │ │ ├── filter-and-transform-data-from-an-api.md
│ │ │ │ ├── group-items-in-list-by-a-property.md
│ │ │ │ ├── handle-background-operations.md
│ │ │ │ ├── hide-an-element-until-its-datasource-is-ready.md
│ │ │ │ ├── make-a-set-of-equal-width-cards.md
│ │ │ │ ├── make-a-table-responsive.md
│ │ │ │ ├── make-navpanel-width-responsive.md
│ │ │ │ ├── modify-a-value-reported-in-a-column.md
│ │ │ │ ├── paginate-a-list.md
│ │ │ │ ├── pass-data-to-a-modal-dialog.md
│ │ │ │ ├── react-to-button-click-not-keystrokes.md
│ │ │ │ ├── set-the-initial-value-of-a-select-from-fetched-data.md
│ │ │ │ ├── share-a-modaldialog-across-components.md
│ │ │ │ ├── sync-selections-between-table-and-list-views.md
│ │ │ │ ├── update-ui-optimistically.md
│ │ │ │ ├── use-built-in-form-validation.md
│ │ │ │ └── use-the-same-modaldialog-to-add-or-edit.md
│ │ │ ├── howto.md
│ │ │ ├── intro.md
│ │ │ ├── layout.md
│ │ │ ├── markup.md
│ │ │ ├── mcp.md
│ │ │ ├── modal-dialogs.md
│ │ │ ├── news-and-reviews.md
│ │ │ ├── reactive-intro.md
│ │ │ ├── refactoring.md
│ │ │ ├── routing-and-links.md
│ │ │ ├── samples
│ │ │ │ ├── color-palette.xmlui
│ │ │ │ ├── color-values.xmlui
│ │ │ │ ├── shadow-sizes.xmlui
│ │ │ │ ├── spacing-sizes.xmlui
│ │ │ │ ├── swatch.xmlui
│ │ │ │ ├── theme-gallery-brief.xmlui
│ │ │ │ └── theme-gallery.xmlui
│ │ │ ├── scoping.md
│ │ │ ├── scripting.md
│ │ │ ├── styles-and-themes
│ │ │ │ ├── common-units.md
│ │ │ │ ├── layout-props.md
│ │ │ │ ├── theme-variable-defaults.md
│ │ │ │ ├── theme-variables.md
│ │ │ │ └── themes.md
│ │ │ ├── template-properties.md
│ │ │ ├── test.md
│ │ │ ├── tutorial-01.md
│ │ │ ├── tutorial-02.md
│ │ │ ├── tutorial-03.md
│ │ │ ├── tutorial-04.md
│ │ │ ├── tutorial-05.md
│ │ │ ├── tutorial-06.md
│ │ │ ├── tutorial-07.md
│ │ │ ├── tutorial-08.md
│ │ │ ├── tutorial-09.md
│ │ │ ├── tutorial-10.md
│ │ │ ├── tutorial-11.md
│ │ │ ├── tutorial-12.md
│ │ │ ├── universal-properties.md
│ │ │ ├── user-defined-components.md
│ │ │ ├── vscode.md
│ │ │ ├── working-with-markdown.md
│ │ │ ├── working-with-text.md
│ │ │ ├── xmlui-animations
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ ├── Animation.md
│ │ │ │ ├── FadeAnimation.md
│ │ │ │ ├── FadeInAnimation.md
│ │ │ │ ├── FadeOutAnimation.md
│ │ │ │ ├── ScaleAnimation.md
│ │ │ │ └── SlideInAnimation.md
│ │ │ ├── xmlui-charts
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ ├── BarChart.md
│ │ │ │ ├── DonutChart.md
│ │ │ │ ├── LabelList.md
│ │ │ │ ├── Legend.md
│ │ │ │ ├── LineChart.md
│ │ │ │ └── PieChart.md
│ │ │ ├── xmlui-pdf
│ │ │ │ ├── _meta.json
│ │ │ │ ├── _overview.md
│ │ │ │ └── Pdf.md
│ │ │ └── xmlui-spreadsheet
│ │ │ ├── _meta.json
│ │ │ ├── _overview.md
│ │ │ └── Spreadsheet.md
│ │ ├── resources
│ │ │ ├── devdocs
│ │ │ │ ├── debug-proxy-object-2.png
│ │ │ │ ├── debug-proxy-object.png
│ │ │ │ ├── table_editor_01.png
│ │ │ │ ├── table_editor_02.png
│ │ │ │ ├── table_editor_03.png
│ │ │ │ ├── table_editor_04.png
│ │ │ │ ├── table_editor_05.png
│ │ │ │ ├── table_editor_06.png
│ │ │ │ ├── table_editor_07.png
│ │ │ │ ├── table_editor_08.png
│ │ │ │ ├── table_editor_09.png
│ │ │ │ ├── table_editor_10.png
│ │ │ │ ├── table_editor_11.png
│ │ │ │ ├── table-editor-01.png
│ │ │ │ ├── table-editor-02.png
│ │ │ │ ├── table-editor-03.png
│ │ │ │ ├── table-editor-04.png
│ │ │ │ ├── table-editor-06.png
│ │ │ │ ├── table-editor-07.png
│ │ │ │ ├── table-editor-08.png
│ │ │ │ ├── table-editor-09.png
│ │ │ │ └── xmlui-rendering-of-tiptap-markdown.png
│ │ │ ├── favicon.ico
│ │ │ ├── files
│ │ │ │ ├── clients.json
│ │ │ │ ├── daily-revenue.json
│ │ │ │ ├── dashboard-stats.json
│ │ │ │ ├── demo.xmlui
│ │ │ │ ├── demo.xmlui.xs
│ │ │ │ ├── downloads
│ │ │ │ │ └── downloads.json
│ │ │ │ ├── for-download
│ │ │ │ │ ├── index-with-api.html
│ │ │ │ │ ├── index.html
│ │ │ │ │ ├── mockApi.js
│ │ │ │ │ ├── start-darwin.sh
│ │ │ │ │ ├── start-linux.sh
│ │ │ │ │ ├── start.bat
│ │ │ │ │ └── xmlui
│ │ │ │ │ └── xmlui-standalone.umd.js
│ │ │ │ ├── getting-started
│ │ │ │ │ ├── cl-tutorial-final.zip
│ │ │ │ │ ├── cl-tutorial.zip
│ │ │ │ │ ├── cl-tutorial2.zip
│ │ │ │ │ ├── cl-tutorial3.zip
│ │ │ │ │ ├── cl-tutorial4.zip
│ │ │ │ │ ├── cl-tutorial5.zip
│ │ │ │ │ ├── cl-tutorial6.zip
│ │ │ │ │ ├── getting-started.zip
│ │ │ │ │ ├── hello-xmlui.zip
│ │ │ │ │ ├── xmlui-empty.zip
│ │ │ │ │ └── xmlui-starter.zip
│ │ │ │ ├── howto
│ │ │ │ │ └── component-icons
│ │ │ │ │ └── up-arrow.svg
│ │ │ │ ├── invoices.json
│ │ │ │ ├── monthly-status.json
│ │ │ │ ├── news-and-reviews.json
│ │ │ │ ├── products.json
│ │ │ │ ├── releases.json
│ │ │ │ ├── tutorials
│ │ │ │ │ ├── datasource
│ │ │ │ │ │ └── api.ts
│ │ │ │ │ └── p2do
│ │ │ │ │ ├── api.ts
│ │ │ │ │ └── todo-logo.svg
│ │ │ │ └── xmlui.json
│ │ │ ├── github.svg
│ │ │ ├── images
│ │ │ │ ├── apiaction-tutorial
│ │ │ │ │ ├── add-success.png
│ │ │ │ │ ├── apiaction-param.png
│ │ │ │ │ ├── change-completed.png
│ │ │ │ │ ├── change-in-progress.png
│ │ │ │ │ ├── confirm-delete.png
│ │ │ │ │ ├── data-error.png
│ │ │ │ │ ├── data-progress.png
│ │ │ │ │ ├── data-success.png
│ │ │ │ │ ├── display-1.png
│ │ │ │ │ ├── item-deleted.png
│ │ │ │ │ ├── item-updated.png
│ │ │ │ │ ├── missing-api-key.png
│ │ │ │ │ ├── new-item-added.png
│ │ │ │ │ └── test-message.png
│ │ │ │ ├── chat-api
│ │ │ │ │ └── domain-model.svg
│ │ │ │ ├── components
│ │ │ │ │ ├── image
│ │ │ │ │ │ └── breakfast.jpg
│ │ │ │ │ ├── markdown
│ │ │ │ │ │ └── colors.png
│ │ │ │ │ └── modal
│ │ │ │ │ ├── deep_link_dialog_1.jpg
│ │ │ │ │ └── deep_link_dialog_2.jpg
│ │ │ │ ├── create-apps
│ │ │ │ │ ├── collapsed-vertical.png
│ │ │ │ │ ├── using-forms-warning-dialog.png
│ │ │ │ │ └── using-forms.png
│ │ │ │ ├── datasource-tutorial
│ │ │ │ │ ├── data-with-header.png
│ │ │ │ │ ├── filtered-data.png
│ │ │ │ │ ├── filtered-items.png
│ │ │ │ │ ├── initial-page-items.png
│ │ │ │ │ ├── list-items.png
│ │ │ │ │ ├── next-page-items.png
│ │ │ │ │ ├── no-data.png
│ │ │ │ │ ├── pagination-1.jpg
│ │ │ │ │ ├── pagination-1.png
│ │ │ │ │ ├── polling-1.png
│ │ │ │ │ ├── refetch-data.png
│ │ │ │ │ ├── slow-loading.png
│ │ │ │ │ ├── test-message.png
│ │ │ │ │ ├── Thumbs.db
│ │ │ │ │ ├── unconventional-data.png
│ │ │ │ │ └── unfiltered-items.png
│ │ │ │ ├── flower.jpg
│ │ │ │ ├── get-started
│ │ │ │ │ ├── add-new-contact.png
│ │ │ │ │ ├── app-modified.png
│ │ │ │ │ ├── app-start.png
│ │ │ │ │ ├── app-with-boxes.png
│ │ │ │ │ ├── app-with-toast.png
│ │ │ │ │ ├── boilerplate-structure.png
│ │ │ │ │ ├── cl-initial.png
│ │ │ │ │ ├── cl-start.png
│ │ │ │ │ ├── contact-counts.png
│ │ │ │ │ ├── contact-dialog-title.png
│ │ │ │ │ ├── contact-dialog.png
│ │ │ │ │ ├── contact-menus.png
│ │ │ │ │ ├── contact-predicates.png
│ │ │ │ │ ├── context-menu.png
│ │ │ │ │ ├── dashboard-numbers.png
│ │ │ │ │ ├── default-contact-list.png
│ │ │ │ │ ├── delete-contact.png
│ │ │ │ │ ├── delete-task.png
│ │ │ │ │ ├── detailed-template.png
│ │ │ │ │ ├── edit-contact-details.png
│ │ │ │ │ ├── edited-contact-saved.png
│ │ │ │ │ ├── empty-sections.png
│ │ │ │ │ ├── filter-completed.png
│ │ │ │ │ ├── fullwidth-desktop.png
│ │ │ │ │ ├── fullwidth-mobile.png
│ │ │ │ │ ├── initial-table.png
│ │ │ │ │ ├── items-and-badges.png
│ │ │ │ │ ├── loading-message.png
│ │ │ │ │ ├── new-contact-button.png
│ │ │ │ │ ├── new-contact-saved.png
│ │ │ │ │ ├── no-empty-sections.png
│ │ │ │ │ ├── personal-todo-initial.png
│ │ │ │ │ ├── piechart.png
│ │ │ │ │ ├── review-today.png
│ │ │ │ │ ├── rudimentary-dashboard.png
│ │ │ │ │ ├── section-collapsed.png
│ │ │ │ │ ├── sectioned-items.png
│ │ │ │ │ ├── sections-ordered.png
│ │ │ │ │ ├── spacex-list-with-links.png
│ │ │ │ │ ├── spacex-list.png
│ │ │ │ │ ├── start-personal-todo-1.png
│ │ │ │ │ ├── submit-new-contact.png
│ │ │ │ │ ├── submit-new-task.png
│ │ │ │ │ ├── syntax-highlighting.png
│ │ │ │ │ ├── table-with-badge.png
│ │ │ │ │ ├── template-with-card.png
│ │ │ │ │ ├── test-emulated-api.png
│ │ │ │ │ ├── Thumbs.db
│ │ │ │ │ ├── todo-logo.png
│ │ │ │ │ └── xmlui-tools.png
│ │ │ │ ├── HelloApp.png
│ │ │ │ ├── HelloApp2.png
│ │ │ │ ├── logos
│ │ │ │ │ ├── xmlui1.svg
│ │ │ │ │ ├── xmlui2.svg
│ │ │ │ │ ├── xmlui3.svg
│ │ │ │ │ ├── xmlui4.svg
│ │ │ │ │ ├── xmlui5.svg
│ │ │ │ │ ├── xmlui6.svg
│ │ │ │ │ └── xmlui7.svg
│ │ │ │ ├── pdf
│ │ │ │ │ └── dummy-pdf.jpg
│ │ │ │ ├── rendering-engine
│ │ │ │ │ ├── AppEngine-flow.svg
│ │ │ │ │ ├── Component.svg
│ │ │ │ │ ├── CompoundComponent.svg
│ │ │ │ │ ├── RootComponent.svg
│ │ │ │ │ └── tree-with-containers.svg
│ │ │ │ ├── reviewers-guide
│ │ │ │ │ ├── AppEngine-flow.svg
│ │ │ │ │ └── incbutton-in-action.png
│ │ │ │ ├── tools
│ │ │ │ │ └── boilerplate-structure.png
│ │ │ │ ├── try.svg
│ │ │ │ ├── tutorial
│ │ │ │ │ ├── app-chat-history.png
│ │ │ │ │ ├── app-content-placeholder.png
│ │ │ │ │ ├── app-header-and-content.png
│ │ │ │ │ ├── app-links-channel-selected.png
│ │ │ │ │ ├── app-links-click.png
│ │ │ │ │ ├── app-navigation.png
│ │ │ │ │ ├── finished-ex01.png
│ │ │ │ │ ├── finished-ex02.png
│ │ │ │ │ ├── hello.png
│ │ │ │ │ ├── splash-screen-advanced.png
│ │ │ │ │ ├── splash-screen-after-click.png
│ │ │ │ │ ├── splash-screen-centered.png
│ │ │ │ │ ├── splash-screen-events.png
│ │ │ │ │ ├── splash-screen-expression.png
│ │ │ │ │ ├── splash-screen-reuse-after.png
│ │ │ │ │ ├── splash-screen-reuse-before.png
│ │ │ │ │ └── splash-screen.png
│ │ │ │ └── tutorial-01.png
│ │ │ ├── llms.txt
│ │ │ ├── logo-dark.svg
│ │ │ ├── logo.svg
│ │ │ ├── pg-popout.svg
│ │ │ └── xmlui-logo.svg
│ │ ├── serve.json
│ │ └── web.config
│ ├── scripts
│ │ ├── download-latest-xmlui.js
│ │ ├── generate-rss.js
│ │ ├── get-releases.js
│ │ └── utils.js
│ ├── src
│ │ ├── components
│ │ │ ├── BlogOverview.xmlui
│ │ │ ├── BlogPage.xmlui
│ │ │ ├── Boxes.xmlui
│ │ │ ├── Breadcrumb.xmlui
│ │ │ ├── ChangeLog.xmlui
│ │ │ ├── ColorPalette.xmlui
│ │ │ ├── DocumentLinks.xmlui
│ │ │ ├── DocumentPage.xmlui
│ │ │ ├── DocumentPageNoTOC.xmlui
│ │ │ ├── Icons.xmlui
│ │ │ ├── IncButton.xmlui
│ │ │ ├── IncButton2.xmlui
│ │ │ ├── NameValue.xmlui
│ │ │ ├── PageNotFound.xmlui
│ │ │ ├── PaletteItem.xmlui
│ │ │ ├── Palettes.xmlui
│ │ │ ├── SectionHeader.xmlui
│ │ │ ├── TBD.xmlui
│ │ │ ├── Test.xmlui
│ │ │ ├── ThemesIntro.xmlui
│ │ │ ├── ThousandThemes.xmlui
│ │ │ ├── TubeStops.xmlui
│ │ │ ├── TubeStops.xmlui.xs
│ │ │ └── TwoColumnCode.xmlui
│ │ ├── config.ts
│ │ ├── Main.xmlui
│ │ └── themes
│ │ ├── docs-theme.ts
│ │ ├── earthtone.ts
│ │ ├── xmlui-gray-on-default.ts
│ │ ├── xmlui-green-on-default.ts
│ │ └── xmlui-orange-on-default.ts
│ └── tsconfig.json
├── LICENSE
├── package-lock.json
├── package.json
├── packages
│ ├── tsconfig.json
│ ├── xmlui-animations
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── Animation.tsx
│ │ ├── AnimationNative.tsx
│ │ ├── FadeAnimation.tsx
│ │ ├── FadeInAnimation.tsx
│ │ ├── FadeOutAnimation.tsx
│ │ ├── index.tsx
│ │ ├── ScaleAnimation.tsx
│ │ └── SlideInAnimation.tsx
│ ├── xmlui-devtools
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ ├── src
│ │ │ ├── devtools
│ │ │ │ ├── DevTools.tsx
│ │ │ │ ├── DevToolsNative.module.scss
│ │ │ │ ├── DevToolsNative.tsx
│ │ │ │ ├── ModalDialog.module.scss
│ │ │ │ ├── ModalDialog.tsx
│ │ │ │ ├── ModalVisibilityContext.tsx
│ │ │ │ ├── Tooltip.module.scss
│ │ │ │ ├── Tooltip.tsx
│ │ │ │ └── utils.ts
│ │ │ ├── editor
│ │ │ │ └── Editor.tsx
│ │ │ └── index.tsx
│ │ └── vite.config-overrides.ts
│ ├── xmlui-hello-world
│ │ ├── .gitignore
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── HelloWorld.module.scss
│ │ ├── HelloWorld.tsx
│ │ ├── HelloWorldNative.tsx
│ │ └── index.tsx
│ ├── xmlui-os-frames
│ │ ├── .gitignore
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── IPhoneFrame.module.scss
│ │ ├── IPhoneFrame.tsx
│ │ ├── MacOSAppFrame.module.scss
│ │ ├── MacOSAppFrame.tsx
│ │ ├── WindowsAppFrame.module.scss
│ │ └── WindowsAppFrame.tsx
│ ├── xmlui-pdf
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ ├── components
│ │ │ │ └── Pdf.xmlui
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── LazyPdfNative.tsx
│ │ ├── Pdf.module.scss
│ │ └── Pdf.tsx
│ ├── xmlui-playground
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── hooks
│ │ │ ├── usePlayground.ts
│ │ │ └── useToast.ts
│ │ ├── index.tsx
│ │ ├── playground
│ │ │ ├── Box.module.scss
│ │ │ ├── Box.tsx
│ │ │ ├── CodeSelector.module.scss
│ │ │ ├── CodeSelector.tsx
│ │ │ ├── ConfirmationDialog.module.scss
│ │ │ ├── ConfirmationDialog.tsx
│ │ │ ├── Editor.tsx
│ │ │ ├── Header.module.scss
│ │ │ ├── Header.tsx
│ │ │ ├── Playground.tsx
│ │ │ ├── PlaygroundContent.module.scss
│ │ │ ├── PlaygroundContent.tsx
│ │ │ ├── PlaygroundNative.module.scss
│ │ │ ├── PlaygroundNative.tsx
│ │ │ ├── Preview.tsx
│ │ │ ├── StandalonePlayground.tsx
│ │ │ ├── StandalonePlaygroundNative.module.scss
│ │ │ ├── StandalonePlaygroundNative.tsx
│ │ │ ├── ThemeSwitcher.module.scss
│ │ │ ├── ThemeSwitcher.tsx
│ │ │ └── utils.ts
│ │ ├── providers
│ │ │ ├── Toast.module.scss
│ │ │ └── ToastProvider.tsx
│ │ ├── state
│ │ │ └── store.ts
│ │ ├── themes
│ │ │ └── theme.ts
│ │ └── utils
│ │ └── helpers.ts
│ ├── xmlui-search
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── Search.module.scss
│ │ └── Search.tsx
│ ├── xmlui-spreadsheet
│ │ ├── .gitignore
│ │ ├── demo
│ │ │ └── Main.xmlui
│ │ ├── index.html
│ │ ├── index.ts
│ │ ├── meta
│ │ │ └── componentsMetadata.ts
│ │ ├── package.json
│ │ └── src
│ │ ├── index.tsx
│ │ ├── Spreadsheet.tsx
│ │ └── SpreadsheetNative.tsx
│ └── xmlui-website-blocks
│ ├── .gitignore
│ ├── CHANGELOG.md
│ ├── demo
│ │ ├── components
│ │ │ ├── HeroBackgroundBreakoutPage.xmlui
│ │ │ ├── HeroBackgroundsPage.xmlui
│ │ │ ├── HeroContentsPage.xmlui
│ │ │ ├── HeroTextAlignPage.xmlui
│ │ │ ├── HeroTextPage.xmlui
│ │ │ └── HeroTonesPage.xmlui
│ │ ├── Main.xmlui
│ │ └── themes
│ │ └── default.ts
│ ├── index.html
│ ├── index.ts
│ ├── meta
│ │ └── componentsMetadata.ts
│ ├── package.json
│ ├── public
│ │ └── resources
│ │ ├── building.jpg
│ │ └── xmlui-logo.svg
│ └── src
│ ├── Carousel
│ │ ├── Carousel.module.scss
│ │ ├── Carousel.tsx
│ │ ├── CarouselContext.tsx
│ │ └── CarouselNative.tsx
│ ├── FancyButton
│ │ ├── FancyButton.module.scss
│ │ ├── FancyButton.tsx
│ │ └── FancyButton.xmlui
│ ├── Hello
│ │ ├── Hello.tsx
│ │ ├── Hello.xmlui
│ │ └── Hello.xmlui.xs
│ ├── HeroSection
│ │ ├── HeroSection.module.scss
│ │ ├── HeroSection.spec.ts
│ │ ├── HeroSection.tsx
│ │ └── HeroSectionNative.tsx
│ ├── index.tsx
│ ├── ScrollToTop
│ │ ├── ScrollToTop.module.scss
│ │ ├── ScrollToTop.tsx
│ │ └── ScrollToTopNative.tsx
│ └── vite-env.d.ts
├── playwright.config.ts
├── README.md
├── tools
│ ├── codefence
│ │ └── xmlui-code-fence-docs.md
│ ├── create-app
│ │ ├── .gitignore
│ │ ├── CHANGELOG.md
│ │ ├── create-app.ts
│ │ ├── helpers
│ │ │ ├── copy.ts
│ │ │ ├── get-pkg-manager.ts
│ │ │ ├── git.ts
│ │ │ ├── install.ts
│ │ │ ├── is-folder-empty.ts
│ │ │ ├── is-writeable.ts
│ │ │ ├── make-dir.ts
│ │ │ └── validate-pkg.ts
│ │ ├── index.ts
│ │ ├── package.json
│ │ ├── templates
│ │ │ ├── default
│ │ │ │ └── ts
│ │ │ │ ├── gitignore
│ │ │ │ ├── index.html
│ │ │ │ ├── index.ts
│ │ │ │ ├── public
│ │ │ │ │ ├── mockServiceWorker.js
│ │ │ │ │ ├── resources
│ │ │ │ │ │ ├── favicon.ico
│ │ │ │ │ │ └── xmlui-logo.svg
│ │ │ │ │ └── serve.json
│ │ │ │ └── src
│ │ │ │ ├── components
│ │ │ │ │ ├── ApiAware.xmlui
│ │ │ │ │ ├── Home.xmlui
│ │ │ │ │ ├── IncButton.xmlui
│ │ │ │ │ └── PagePanel.xmlui
│ │ │ │ ├── config.ts
│ │ │ │ └── Main.xmlui
│ │ │ ├── index.ts
│ │ │ └── types.ts
│ │ └── tsconfig.json
│ ├── create-xmlui-hello-world
│ │ ├── index.js
│ │ └── package.json
│ └── vscode
│ ├── .gitignore
│ ├── .vscode
│ │ ├── launch.json
│ │ └── tasks.json
│ ├── .vscodeignore
│ ├── build.sh
│ ├── CHANGELOG.md
│ ├── esbuild.js
│ ├── eslint.config.mjs
│ ├── formatter-docs.md
│ ├── generate-test-sample.sh
│ ├── LICENSE.md
│ ├── package-lock.json
│ ├── package.json
│ ├── README.md
│ ├── resources
│ │ ├── xmlui-logo.png
│ │ └── xmlui-markup-syntax-highlighting.png
│ ├── src
│ │ ├── extension.ts
│ │ └── server.ts
│ ├── syntaxes
│ │ └── xmlui.tmLanguage.json
│ ├── test-samples
│ │ └── sample.xmlui
│ ├── tsconfig.json
│ └── tsconfig.tsbuildinfo
├── turbo.json
└── xmlui
├── .gitignore
├── bin
│ ├── bootstrap.cjs
│ ├── bootstrap.js
│ ├── build-lib.ts
│ ├── build.ts
│ ├── index.ts
│ ├── preview.ts
│ ├── start.ts
│ ├── vite-xmlui-plugin.ts
│ └── viteConfig.ts
├── CHANGELOG.md
├── conventions
│ ├── component-qa-checklist.md
│ ├── copilot-conventions.md
│ ├── create-xmlui-components.md
│ ├── mermaid.md
│ ├── testing-conventions.md
│ └── xmlui-in-a-nutshell.md
├── dev-docs
│ ├── accessibility.md
│ ├── build-system.md
│ ├── build-xmlui.md
│ ├── component-behaviors.md
│ ├── component-metadata.md
│ ├── components-with-options.md
│ ├── containers.md
│ ├── data-operations.md
│ ├── glossary.md
│ ├── index.md
│ ├── next
│ │ ├── component-dev-guide.md
│ │ ├── configuration-management-enhancement-summary.md
│ │ ├── documentation-scripts-refactoring-complete-summary.md
│ │ ├── documentation-scripts-refactoring-plan.md
│ │ ├── duplicate-pattern-extraction-summary.md
│ │ ├── error-handling-standardization-summary.md
│ │ ├── generating-component-reference.md
│ │ ├── index.md
│ │ ├── logging-consistency-implementation-summary.md
│ │ ├── project-build.md
│ │ ├── project-structure.md
│ │ ├── theme-context.md
│ │ ├── tiptap-design-considerations.md
│ │ ├── working-with-code.md
│ │ ├── xmlui-runtime-architecture
│ │ └── xmlui-wcag-accessibility-report.md
│ ├── react-fundamentals.md
│ ├── release-method.md
│ ├── standalone-app.md
│ ├── theme-variables-refactoring.md
│ ├── ud-components.md
│ └── xmlui-repo.md
├── package.json
├── scripts
│ ├── coverage-only.js
│ ├── e2e-test-summary.js
│ ├── extract-component-metadata.js
│ ├── generate-docs
│ │ ├── build-downloads-map.mjs
│ │ ├── build-pages-map.mjs
│ │ ├── components-config.json
│ │ ├── configuration-management.mjs
│ │ ├── constants.mjs
│ │ ├── create-theme-files.mjs
│ │ ├── DocsGenerator.mjs
│ │ ├── error-handling.mjs
│ │ ├── extensions-config.json
│ │ ├── folders.mjs
│ │ ├── generate-summary-files.mjs
│ │ ├── get-docs.mjs
│ │ ├── input-handler.mjs
│ │ ├── logger.mjs
│ │ ├── logging-standards.mjs
│ │ ├── MetadataProcessor.mjs
│ │ ├── pattern-utilities.mjs
│ │ └── utils.mjs
│ ├── generate-metadata-markdown.js
│ ├── get-langserver-metadata.js
│ ├── inline-links.mjs
│ └── README-e2e-summary.md
├── src
│ ├── abstractions
│ │ ├── _conventions.md
│ │ ├── ActionDefs.ts
│ │ ├── AppContextDefs.ts
│ │ ├── ComponentDefs.ts
│ │ ├── ContainerDefs.ts
│ │ ├── ExtensionDefs.ts
│ │ ├── FunctionDefs.ts
│ │ ├── RendererDefs.ts
│ │ ├── scripting
│ │ │ ├── BlockScope.ts
│ │ │ ├── Compilation.ts
│ │ │ ├── LogicalThread.ts
│ │ │ ├── LoopScope.ts
│ │ │ ├── modules.ts
│ │ │ ├── ScriptParserError.ts
│ │ │ ├── Token.ts
│ │ │ ├── TryScope.ts
│ │ │ └── TryScopeExp.ts
│ │ └── ThemingDefs.ts
│ ├── components
│ │ ├── _conventions.md
│ │ ├── abstractions.ts
│ │ ├── Accordion
│ │ │ ├── Accordion.md
│ │ │ ├── Accordion.module.scss
│ │ │ ├── Accordion.spec.ts
│ │ │ ├── Accordion.tsx
│ │ │ ├── AccordionContext.tsx
│ │ │ ├── AccordionItem.tsx
│ │ │ ├── AccordionItemNative.tsx
│ │ │ └── AccordionNative.tsx
│ │ ├── Animation
│ │ │ └── AnimationNative.tsx
│ │ ├── APICall
│ │ │ ├── APICall.md
│ │ │ ├── APICall.spec.ts
│ │ │ ├── APICall.tsx
│ │ │ └── APICallNative.tsx
│ │ ├── App
│ │ │ ├── App.md
│ │ │ ├── App.module.scss
│ │ │ ├── App.spec.ts
│ │ │ ├── App.tsx
│ │ │ ├── AppLayoutContext.ts
│ │ │ ├── AppNative.tsx
│ │ │ ├── AppStateContext.ts
│ │ │ ├── doc-resources
│ │ │ │ ├── condensed-sticky.xmlui
│ │ │ │ ├── condensed.xmlui
│ │ │ │ ├── horizontal-sticky.xmlui
│ │ │ │ ├── horizontal.xmlui
│ │ │ │ ├── vertical-full-header.xmlui
│ │ │ │ ├── vertical-sticky.xmlui
│ │ │ │ └── vertical.xmlui
│ │ │ ├── IndexerContext.ts
│ │ │ ├── LinkInfoContext.ts
│ │ │ ├── SearchContext.tsx
│ │ │ ├── Sheet.module.scss
│ │ │ └── Sheet.tsx
│ │ ├── AppHeader
│ │ │ ├── AppHeader.md
│ │ │ ├── AppHeader.module.scss
│ │ │ ├── AppHeader.spec.ts
│ │ │ ├── AppHeader.tsx
│ │ │ └── AppHeaderNative.tsx
│ │ ├── AppState
│ │ │ ├── AppState.md
│ │ │ ├── AppState.spec.ts
│ │ │ ├── AppState.tsx
│ │ │ └── AppStateNative.tsx
│ │ ├── AutoComplete
│ │ │ ├── AutoComplete.md
│ │ │ ├── AutoComplete.module.scss
│ │ │ ├── AutoComplete.spec.ts
│ │ │ ├── AutoComplete.tsx
│ │ │ ├── AutoCompleteContext.tsx
│ │ │ └── AutoCompleteNative.tsx
│ │ ├── Avatar
│ │ │ ├── Avatar.md
│ │ │ ├── Avatar.module.scss
│ │ │ ├── Avatar.spec.ts
│ │ │ ├── Avatar.tsx
│ │ │ └── AvatarNative.tsx
│ │ ├── Backdrop
│ │ │ ├── Backdrop.md
│ │ │ ├── Backdrop.module.scss
│ │ │ ├── Backdrop.spec.ts
│ │ │ ├── Backdrop.tsx
│ │ │ └── BackdropNative.tsx
│ │ ├── Badge
│ │ │ ├── Badge.md
│ │ │ ├── Badge.module.scss
│ │ │ ├── Badge.spec.ts
│ │ │ ├── Badge.tsx
│ │ │ └── BadgeNative.tsx
│ │ ├── Bookmark
│ │ │ ├── Bookmark.md
│ │ │ ├── Bookmark.module.scss
│ │ │ ├── Bookmark.spec.ts
│ │ │ ├── Bookmark.tsx
│ │ │ └── BookmarkNative.tsx
│ │ ├── Breakout
│ │ │ ├── Breakout.module.scss
│ │ │ ├── Breakout.spec.ts
│ │ │ ├── Breakout.tsx
│ │ │ └── BreakoutNative.tsx
│ │ ├── Button
│ │ │ ├── Button-style.spec.ts
│ │ │ ├── Button.md
│ │ │ ├── Button.module.scss
│ │ │ ├── Button.spec.ts
│ │ │ ├── Button.tsx
│ │ │ └── ButtonNative.tsx
│ │ ├── Card
│ │ │ ├── Card.md
│ │ │ ├── Card.module.scss
│ │ │ ├── Card.spec.ts
│ │ │ ├── Card.tsx
│ │ │ └── CardNative.tsx
│ │ ├── Carousel
│ │ │ ├── Carousel.md
│ │ │ ├── Carousel.module.scss
│ │ │ ├── Carousel.spec.ts
│ │ │ ├── Carousel.tsx
│ │ │ ├── CarouselContext.tsx
│ │ │ ├── CarouselItem.tsx
│ │ │ ├── CarouselItemNative.tsx
│ │ │ └── CarouselNative.tsx
│ │ ├── ChangeListener
│ │ │ ├── ChangeListener.md
│ │ │ ├── ChangeListener.spec.ts
│ │ │ ├── ChangeListener.tsx
│ │ │ └── ChangeListenerNative.tsx
│ │ ├── chart-color-schemes.ts
│ │ ├── Charts
│ │ │ ├── AreaChart
│ │ │ │ ├── AreaChart.md
│ │ │ │ ├── AreaChart.spec.ts
│ │ │ │ ├── AreaChart.tsx
│ │ │ │ └── AreaChartNative.tsx
│ │ │ ├── BarChart
│ │ │ │ ├── BarChart.md
│ │ │ │ ├── BarChart.module.scss
│ │ │ │ ├── BarChart.spec.ts
│ │ │ │ ├── BarChart.tsx
│ │ │ │ └── BarChartNative.tsx
│ │ │ ├── DonutChart
│ │ │ │ ├── DonutChart.spec.ts
│ │ │ │ └── DonutChart.tsx
│ │ │ ├── LabelList
│ │ │ │ ├── LabelList.module.scss
│ │ │ │ ├── LabelList.spec.ts
│ │ │ │ ├── LabelList.tsx
│ │ │ │ └── LabelListNative.tsx
│ │ │ ├── Legend
│ │ │ │ ├── Legend.spec.ts
│ │ │ │ ├── Legend.tsx
│ │ │ │ └── LegendNative.tsx
│ │ │ ├── LineChart
│ │ │ │ ├── LineChart.md
│ │ │ │ ├── LineChart.module.scss
│ │ │ │ ├── LineChart.spec.ts
│ │ │ │ ├── LineChart.tsx
│ │ │ │ └── LineChartNative.tsx
│ │ │ ├── PieChart
│ │ │ │ ├── PieChart.md
│ │ │ │ ├── PieChart.spec.ts
│ │ │ │ ├── PieChart.tsx
│ │ │ │ ├── PieChartNative.module.scss
│ │ │ │ └── PieChartNative.tsx
│ │ │ ├── RadarChart
│ │ │ │ ├── RadarChart.md
│ │ │ │ ├── RadarChart.spec.ts
│ │ │ │ ├── RadarChart.tsx
│ │ │ │ └── RadarChartNative.tsx
│ │ │ ├── Tooltip
│ │ │ │ ├── TooltipContent.module.scss
│ │ │ │ ├── TooltipContent.spec.ts
│ │ │ │ └── TooltipContent.tsx
│ │ │ └── utils
│ │ │ ├── abstractions.ts
│ │ │ └── ChartProvider.tsx
│ │ ├── Checkbox
│ │ │ ├── Checkbox.md
│ │ │ ├── Checkbox.spec.ts
│ │ │ └── Checkbox.tsx
│ │ ├── CodeBlock
│ │ │ ├── CodeBlock.module.scss
│ │ │ ├── CodeBlock.spec.ts
│ │ │ ├── CodeBlock.tsx
│ │ │ ├── CodeBlockNative.tsx
│ │ │ └── highlight-code.ts
│ │ ├── collectedComponentMetadata.ts
│ │ ├── ColorPicker
│ │ │ ├── ColorPicker.md
│ │ │ ├── ColorPicker.module.scss
│ │ │ ├── ColorPicker.spec.ts
│ │ │ ├── ColorPicker.tsx
│ │ │ └── ColorPickerNative.tsx
│ │ ├── Column
│ │ │ ├── Column.md
│ │ │ ├── Column.tsx
│ │ │ ├── ColumnNative.tsx
│ │ │ ├── doc-resources
│ │ │ │ └── list-component-data.js
│ │ │ └── TableContext.tsx
│ │ ├── component-utils.ts
│ │ ├── ComponentProvider.tsx
│ │ ├── ComponentRegistryContext.tsx
│ │ ├── container-helpers.tsx
│ │ ├── ContentSeparator
│ │ │ ├── ContentSeparator.md
│ │ │ ├── ContentSeparator.module.scss
│ │ │ ├── ContentSeparator.spec.ts
│ │ │ ├── ContentSeparator.tsx
│ │ │ ├── ContentSeparatorNative.tsx
│ │ │ └── test-padding.xmlui
│ │ ├── DataSource
│ │ │ ├── DataSource.md
│ │ │ └── DataSource.tsx
│ │ ├── DateInput
│ │ │ ├── DateInput.md
│ │ │ ├── DateInput.module.scss
│ │ │ ├── DateInput.spec.ts
│ │ │ ├── DateInput.tsx
│ │ │ └── DateInputNative.tsx
│ │ ├── DatePicker
│ │ │ ├── DatePicker.md
│ │ │ ├── DatePicker.module.scss
│ │ │ ├── DatePicker.spec.ts
│ │ │ ├── DatePicker.tsx
│ │ │ └── DatePickerNative.tsx
│ │ ├── DropdownMenu
│ │ │ ├── DropdownMenu.md
│ │ │ ├── DropdownMenu.module.scss
│ │ │ ├── DropdownMenu.spec.ts
│ │ │ ├── DropdownMenu.tsx
│ │ │ ├── DropdownMenuNative.tsx
│ │ │ ├── MenuItem.md
│ │ │ └── SubMenuItem.md
│ │ ├── EmojiSelector
│ │ │ ├── EmojiSelector.md
│ │ │ ├── EmojiSelector.spec.ts
│ │ │ ├── EmojiSelector.tsx
│ │ │ └── EmojiSelectorNative.tsx
│ │ ├── ExpandableItem
│ │ │ ├── ExpandableItem.module.scss
│ │ │ ├── ExpandableItem.spec.ts
│ │ │ ├── ExpandableItem.tsx
│ │ │ └── ExpandableItemNative.tsx
│ │ ├── FileInput
│ │ │ ├── FileInput.md
│ │ │ ├── FileInput.module.scss
│ │ │ ├── FileInput.spec.ts
│ │ │ ├── FileInput.tsx
│ │ │ └── FileInputNative.tsx
│ │ ├── FileUploadDropZone
│ │ │ ├── FileUploadDropZone.md
│ │ │ ├── FileUploadDropZone.module.scss
│ │ │ ├── FileUploadDropZone.spec.ts
│ │ │ ├── FileUploadDropZone.tsx
│ │ │ └── FileUploadDropZoneNative.tsx
│ │ ├── FlowLayout
│ │ │ ├── FlowLayout.md
│ │ │ ├── FlowLayout.module.scss
│ │ │ ├── FlowLayout.spec.ts
│ │ │ ├── FlowLayout.spec.ts-snapshots
│ │ │ │ └── Edge-cases-boxShadow-is-not-clipped-1-non-smoke-darwin.png
│ │ │ ├── FlowLayout.tsx
│ │ │ └── FlowLayoutNative.tsx
│ │ ├── Footer
│ │ │ ├── Footer.md
│ │ │ ├── Footer.module.scss
│ │ │ ├── Footer.spec.ts
│ │ │ ├── Footer.tsx
│ │ │ └── FooterNative.tsx
│ │ ├── Form
│ │ │ ├── Form.md
│ │ │ ├── Form.module.scss
│ │ │ ├── Form.spec.ts
│ │ │ ├── Form.tsx
│ │ │ ├── formActions.ts
│ │ │ ├── FormContext.ts
│ │ │ └── FormNative.tsx
│ │ ├── FormItem
│ │ │ ├── FormItem.md
│ │ │ ├── FormItem.module.scss
│ │ │ ├── FormItem.spec.ts
│ │ │ ├── FormItem.tsx
│ │ │ ├── FormItemNative.tsx
│ │ │ ├── HelperText.module.scss
│ │ │ ├── HelperText.tsx
│ │ │ ├── ItemWithLabel.tsx
│ │ │ └── Validations.ts
│ │ ├── FormSection
│ │ │ ├── FormSection.md
│ │ │ ├── FormSection.ts
│ │ │ └── FormSection.xmlui
│ │ ├── Fragment
│ │ │ ├── Fragment.spec.ts
│ │ │ └── Fragment.tsx
│ │ ├── Heading
│ │ │ ├── abstractions.ts
│ │ │ ├── H1.md
│ │ │ ├── H1.spec.ts
│ │ │ ├── H2.md
│ │ │ ├── H2.spec.ts
│ │ │ ├── H3.md
│ │ │ ├── H3.spec.ts
│ │ │ ├── H4.md
│ │ │ ├── H4.spec.ts
│ │ │ ├── H5.md
│ │ │ ├── H5.spec.ts
│ │ │ ├── H6.md
│ │ │ ├── H6.spec.ts
│ │ │ ├── Heading.md
│ │ │ ├── Heading.module.scss
│ │ │ ├── Heading.spec.ts
│ │ │ ├── Heading.tsx
│ │ │ └── HeadingNative.tsx
│ │ ├── HoverCard
│ │ │ ├── HoverCard.tsx
│ │ │ └── HovercardNative.tsx
│ │ ├── HtmlTags
│ │ │ ├── HtmlTags.module.scss
│ │ │ ├── HtmlTags.spec.ts
│ │ │ └── HtmlTags.tsx
│ │ ├── Icon
│ │ │ ├── AdmonitionDanger.tsx
│ │ │ ├── AdmonitionInfo.tsx
│ │ │ ├── AdmonitionNote.tsx
│ │ │ ├── AdmonitionTip.tsx
│ │ │ ├── AdmonitionWarning.tsx
│ │ │ ├── ApiIcon.tsx
│ │ │ ├── ArrowDropDown.module.scss
│ │ │ ├── ArrowDropDown.tsx
│ │ │ ├── ArrowDropUp.module.scss
│ │ │ ├── ArrowDropUp.tsx
│ │ │ ├── ArrowLeft.module.scss
│ │ │ ├── ArrowLeft.tsx
│ │ │ ├── ArrowRight.module.scss
│ │ │ ├── ArrowRight.tsx
│ │ │ ├── Attach.tsx
│ │ │ ├── Binding.module.scss
│ │ │ ├── Binding.tsx
│ │ │ ├── BoardIcon.tsx
│ │ │ ├── BoxIcon.tsx
│ │ │ ├── CheckIcon.tsx
│ │ │ ├── ChevronDownIcon.tsx
│ │ │ ├── ChevronLeft.tsx
│ │ │ ├── ChevronRight.tsx
│ │ │ ├── ChevronUpIcon.tsx
│ │ │ ├── CodeFileIcon.tsx
│ │ │ ├── CodeSandbox.tsx
│ │ │ ├── CompactListIcon.tsx
│ │ │ ├── ContentCopyIcon.tsx
│ │ │ ├── DarkToLightIcon.tsx
│ │ │ ├── DatabaseIcon.module.scss
│ │ │ ├── DatabaseIcon.tsx
│ │ │ ├── DocFileIcon.tsx
│ │ │ ├── DocIcon.tsx
│ │ │ ├── DotMenuHorizontalIcon.tsx
│ │ │ ├── DotMenuIcon.tsx
│ │ │ ├── EmailIcon.tsx
│ │ │ ├── EmptyFolderIcon.tsx
│ │ │ ├── ErrorIcon.tsx
│ │ │ ├── ExpressionIcon.tsx
│ │ │ ├── FillPlusCricleIcon.tsx
│ │ │ ├── FilterIcon.tsx
│ │ │ ├── FolderIcon.tsx
│ │ │ ├── GlobeIcon.tsx
│ │ │ ├── HomeIcon.tsx
│ │ │ ├── HyperLinkIcon.tsx
│ │ │ ├── Icon.md
│ │ │ ├── Icon.module.scss
│ │ │ ├── Icon.spec.ts
│ │ │ ├── Icon.tsx
│ │ │ ├── IconNative.tsx
│ │ │ ├── ImageFileIcon.tsx
│ │ │ ├── Inspect.tsx
│ │ │ ├── LightToDark.tsx
│ │ │ ├── LinkIcon.tsx
│ │ │ ├── ListIcon.tsx
│ │ │ ├── LooseListIcon.tsx
│ │ │ ├── MoonIcon.tsx
│ │ │ ├── MoreOptionsIcon.tsx
│ │ │ ├── NoSortIcon.tsx
│ │ │ ├── PDFIcon.tsx
│ │ │ ├── PenIcon.tsx
│ │ │ ├── PhoneIcon.tsx
│ │ │ ├── PhotoIcon.tsx
│ │ │ ├── PlusIcon.tsx
│ │ │ ├── SearchIcon.tsx
│ │ │ ├── ShareIcon.tsx
│ │ │ ├── SortAscendingIcon.tsx
│ │ │ ├── SortDescendingIcon.tsx
│ │ │ ├── StarsIcon.tsx
│ │ │ ├── SunIcon.tsx
│ │ │ ├── svg
│ │ │ │ ├── admonition_danger.svg
│ │ │ │ ├── admonition_info.svg
│ │ │ │ ├── admonition_note.svg
│ │ │ │ ├── admonition_tip.svg
│ │ │ │ ├── admonition_warning.svg
│ │ │ │ ├── api.svg
│ │ │ │ ├── arrow-dropdown.svg
│ │ │ │ ├── arrow-left.svg
│ │ │ │ ├── arrow-right.svg
│ │ │ │ ├── arrow-up.svg
│ │ │ │ ├── attach.svg
│ │ │ │ ├── binding.svg
│ │ │ │ ├── box.svg
│ │ │ │ ├── bulb.svg
│ │ │ │ ├── code-file.svg
│ │ │ │ ├── code-sandbox.svg
│ │ │ │ ├── dark_to_light.svg
│ │ │ │ ├── database.svg
│ │ │ │ ├── doc.svg
│ │ │ │ ├── empty-folder.svg
│ │ │ │ ├── expression.svg
│ │ │ │ ├── eye-closed.svg
│ │ │ │ ├── eye-dark.svg
│ │ │ │ ├── eye.svg
│ │ │ │ ├── file-text.svg
│ │ │ │ ├── filter.svg
│ │ │ │ ├── folder.svg
│ │ │ │ ├── img.svg
│ │ │ │ ├── inspect.svg
│ │ │ │ ├── light_to_dark.svg
│ │ │ │ ├── moon.svg
│ │ │ │ ├── pdf.svg
│ │ │ │ ├── photo.svg
│ │ │ │ ├── share.svg
│ │ │ │ ├── stars.svg
│ │ │ │ ├── sun.svg
│ │ │ │ ├── trending-down.svg
│ │ │ │ ├── trending-level.svg
│ │ │ │ ├── trending-up.svg
│ │ │ │ ├── txt.svg
│ │ │ │ ├── unknown-file.svg
│ │ │ │ ├── unlink.svg
│ │ │ │ └── xls.svg
│ │ │ ├── TableDeleteColumnIcon.tsx
│ │ │ ├── TableDeleteRowIcon.tsx
│ │ │ ├── TableInsertColumnIcon.tsx
│ │ │ ├── TableInsertRowIcon.tsx
│ │ │ ├── TrashIcon.tsx
│ │ │ ├── TrendingDownIcon.tsx
│ │ │ ├── TrendingLevelIcon.tsx
│ │ │ ├── TrendingUpIcon.tsx
│ │ │ ├── TxtIcon.tsx
│ │ │ ├── UnknownFileIcon.tsx
│ │ │ ├── UnlinkIcon.tsx
│ │ │ ├── UserIcon.tsx
│ │ │ ├── WarningIcon.tsx
│ │ │ └── XlsIcon.tsx
│ │ ├── IconProvider.tsx
│ │ ├── IconRegistryContext.tsx
│ │ ├── IFrame
│ │ │ ├── IFrame.md
│ │ │ ├── IFrame.module.scss
│ │ │ ├── IFrame.spec.ts
│ │ │ ├── IFrame.tsx
│ │ │ └── IFrameNative.tsx
│ │ ├── Image
│ │ │ ├── Image.md
│ │ │ ├── Image.module.scss
│ │ │ ├── Image.spec.ts
│ │ │ ├── Image.tsx
│ │ │ └── ImageNative.tsx
│ │ ├── Input
│ │ │ ├── index.ts
│ │ │ ├── InputAdornment.module.scss
│ │ │ ├── InputAdornment.tsx
│ │ │ ├── InputDivider.module.scss
│ │ │ ├── InputDivider.tsx
│ │ │ ├── InputLabel.module.scss
│ │ │ ├── InputLabel.tsx
│ │ │ ├── PartialInput.module.scss
│ │ │ └── PartialInput.tsx
│ │ ├── InspectButton
│ │ │ ├── InspectButton.module.scss
│ │ │ └── InspectButton.tsx
│ │ ├── Items
│ │ │ ├── Items.md
│ │ │ ├── Items.spec.ts
│ │ │ ├── Items.tsx
│ │ │ └── ItemsNative.tsx
│ │ ├── Link
│ │ │ ├── Link.md
│ │ │ ├── Link.module.scss
│ │ │ ├── Link.spec.ts
│ │ │ ├── Link.tsx
│ │ │ └── LinkNative.tsx
│ │ ├── List
│ │ │ ├── doc-resources
│ │ │ │ └── list-component-data.js
│ │ │ ├── List.md
│ │ │ ├── List.module.scss
│ │ │ ├── List.spec.ts
│ │ │ ├── List.tsx
│ │ │ └── ListNative.tsx
│ │ ├── Logo
│ │ │ ├── doc-resources
│ │ │ │ └── xmlui-logo.svg
│ │ │ ├── Logo.md
│ │ │ ├── Logo.tsx
│ │ │ └── LogoNative.tsx
│ │ ├── Markdown
│ │ │ ├── CodeText.module.scss
│ │ │ ├── CodeText.tsx
│ │ │ ├── Markdown.md
│ │ │ ├── Markdown.module.scss
│ │ │ ├── Markdown.spec.ts
│ │ │ ├── Markdown.tsx
│ │ │ ├── MarkdownNative.tsx
│ │ │ ├── parse-binding-expr.ts
│ │ │ └── utils.ts
│ │ ├── metadata-helpers.ts
│ │ ├── ModalDialog
│ │ │ ├── ConfirmationModalContextProvider.tsx
│ │ │ ├── Dialog.module.scss
│ │ │ ├── Dialog.tsx
│ │ │ ├── ModalDialog.md
│ │ │ ├── ModalDialog.module.scss
│ │ │ ├── ModalDialog.spec.ts
│ │ │ ├── ModalDialog.tsx
│ │ │ ├── ModalDialogNative.tsx
│ │ │ └── ModalVisibilityContext.tsx
│ │ ├── NavGroup
│ │ │ ├── NavGroup.md
│ │ │ ├── NavGroup.module.scss
│ │ │ ├── NavGroup.spec.ts
│ │ │ ├── NavGroup.tsx
│ │ │ ├── NavGroupContext.ts
│ │ │ └── NavGroupNative.tsx
│ │ ├── NavLink
│ │ │ ├── NavLink.md
│ │ │ ├── NavLink.module.scss
│ │ │ ├── NavLink.spec.ts
│ │ │ ├── NavLink.tsx
│ │ │ └── NavLinkNative.tsx
│ │ ├── NavPanel
│ │ │ ├── NavPanel.md
│ │ │ ├── NavPanel.module.scss
│ │ │ ├── NavPanel.spec.ts
│ │ │ ├── NavPanel.tsx
│ │ │ └── NavPanelNative.tsx
│ │ ├── NestedApp
│ │ │ ├── AppWithCodeView.module.scss
│ │ │ ├── AppWithCodeView.tsx
│ │ │ ├── AppWithCodeViewNative.tsx
│ │ │ ├── defaultProps.tsx
│ │ │ ├── logo.svg
│ │ │ ├── NestedApp.module.scss
│ │ │ ├── NestedApp.tsx
│ │ │ ├── NestedAppNative.tsx
│ │ │ ├── Tooltip.module.scss
│ │ │ ├── Tooltip.tsx
│ │ │ └── utils.ts
│ │ ├── NoResult
│ │ │ ├── NoResult.md
│ │ │ ├── NoResult.module.scss
│ │ │ ├── NoResult.spec.ts
│ │ │ ├── NoResult.tsx
│ │ │ └── NoResultNative.tsx
│ │ ├── NumberBox
│ │ │ ├── numberbox-abstractions.ts
│ │ │ ├── NumberBox.md
│ │ │ ├── NumberBox.module.scss
│ │ │ ├── NumberBox.spec.ts
│ │ │ ├── NumberBox.tsx
│ │ │ └── NumberBoxNative.tsx
│ │ ├── Option
│ │ │ ├── Option.md
│ │ │ ├── Option.spec.ts
│ │ │ ├── Option.tsx
│ │ │ ├── OptionNative.tsx
│ │ │ └── OptionTypeProvider.tsx
│ │ ├── PageMetaTitle
│ │ │ ├── PageMetaTilteNative.tsx
│ │ │ ├── PageMetaTitle.md
│ │ │ ├── PageMetaTitle.spec.ts
│ │ │ └── PageMetaTitle.tsx
│ │ ├── Pages
│ │ │ ├── Page.md
│ │ │ ├── Pages.md
│ │ │ ├── Pages.module.scss
│ │ │ ├── Pages.tsx
│ │ │ └── PagesNative.tsx
│ │ ├── Pagination
│ │ │ ├── Pagination.md
│ │ │ ├── Pagination.module.scss
│ │ │ ├── Pagination.spec.ts
│ │ │ ├── Pagination.tsx
│ │ │ └── PaginationNative.tsx
│ │ ├── PositionedContainer
│ │ │ ├── PositionedContainer.module.scss
│ │ │ ├── PositionedContainer.tsx
│ │ │ └── PositionedContainerNative.tsx
│ │ ├── ProfileMenu
│ │ │ ├── ProfileMenu.module.scss
│ │ │ └── ProfileMenu.tsx
│ │ ├── ProgressBar
│ │ │ ├── ProgressBar.md
│ │ │ ├── ProgressBar.module.scss
│ │ │ ├── ProgressBar.spec.ts
│ │ │ ├── ProgressBar.tsx
│ │ │ └── ProgressBarNative.tsx
│ │ ├── Queue
│ │ │ ├── Queue.md
│ │ │ ├── Queue.spec.ts
│ │ │ ├── Queue.tsx
│ │ │ ├── queueActions.ts
│ │ │ └── QueueNative.tsx
│ │ ├── RadioGroup
│ │ │ ├── RadioGroup.md
│ │ │ ├── RadioGroup.module.scss
│ │ │ ├── RadioGroup.spec.ts
│ │ │ ├── RadioGroup.tsx
│ │ │ ├── RadioGroupNative.tsx
│ │ │ ├── RadioItem.tsx
│ │ │ └── RadioItemNative.tsx
│ │ ├── RealTimeAdapter
│ │ │ ├── RealTimeAdapter.tsx
│ │ │ └── RealTimeAdapterNative.tsx
│ │ ├── Redirect
│ │ │ ├── Redirect.md
│ │ │ ├── Redirect.spec.ts
│ │ │ └── Redirect.tsx
│ │ ├── ResponsiveBar
│ │ │ ├── README.md
│ │ │ ├── ResponsiveBar.md
│ │ │ ├── ResponsiveBar.module.scss
│ │ │ ├── ResponsiveBar.spec.ts
│ │ │ ├── ResponsiveBar.tsx
│ │ │ └── ResponsiveBarNative.tsx
│ │ ├── Select
│ │ │ ├── HiddenOption.tsx
│ │ │ ├── OptionContext.ts
│ │ │ ├── Select.md
│ │ │ ├── Select.module.scss
│ │ │ ├── Select.spec.ts
│ │ │ ├── Select.tsx
│ │ │ ├── SelectContext.tsx
│ │ │ └── SelectNative.tsx
│ │ ├── SelectionStore
│ │ │ ├── SelectionStore.md
│ │ │ ├── SelectionStore.tsx
│ │ │ └── SelectionStoreNative.tsx
│ │ ├── Slider
│ │ │ ├── Slider.md
│ │ │ ├── Slider.module.scss
│ │ │ ├── Slider.spec.ts
│ │ │ ├── Slider.tsx
│ │ │ └── SliderNative.tsx
│ │ ├── Slot
│ │ │ ├── Slot.md
│ │ │ ├── Slot.spec.ts
│ │ │ └── Slot.ts
│ │ ├── SlotItem.tsx
│ │ ├── SpaceFiller
│ │ │ ├── SpaceFiller.md
│ │ │ ├── SpaceFiller.module.scss
│ │ │ ├── SpaceFiller.spec.ts
│ │ │ ├── SpaceFiller.tsx
│ │ │ └── SpaceFillerNative.tsx
│ │ ├── Spinner
│ │ │ ├── Spinner.md
│ │ │ ├── Spinner.module.scss
│ │ │ ├── Spinner.spec.ts
│ │ │ ├── Spinner.tsx
│ │ │ └── SpinnerNative.tsx
│ │ ├── Splitter
│ │ │ ├── HSplitter.md
│ │ │ ├── HSplitter.spec.ts
│ │ │ ├── Splitter.md
│ │ │ ├── Splitter.module.scss
│ │ │ ├── Splitter.spec.ts
│ │ │ ├── Splitter.tsx
│ │ │ ├── SplitterNative.tsx
│ │ │ ├── utils.ts
│ │ │ ├── VSplitter.md
│ │ │ └── VSplitter.spec.ts
│ │ ├── Stack
│ │ │ ├── CHStack.md
│ │ │ ├── CHStack.spec.ts
│ │ │ ├── CVStack.md
│ │ │ ├── CVStack.spec.ts
│ │ │ ├── HStack.md
│ │ │ ├── HStack.spec.ts
│ │ │ ├── Stack.md
│ │ │ ├── Stack.module.scss
│ │ │ ├── Stack.spec.ts
│ │ │ ├── Stack.tsx
│ │ │ ├── StackNative.tsx
│ │ │ ├── VStack.md
│ │ │ └── VStack.spec.ts
│ │ ├── StickyBox
│ │ │ ├── StickyBox.md
│ │ │ ├── StickyBox.module.scss
│ │ │ ├── StickyBox.tsx
│ │ │ └── StickyBoxNative.tsx
│ │ ├── Switch
│ │ │ ├── Switch.md
│ │ │ ├── Switch.spec.ts
│ │ │ └── Switch.tsx
│ │ ├── Table
│ │ │ ├── doc-resources
│ │ │ │ └── list-component-data.js
│ │ │ ├── react-table-config.d.ts
│ │ │ ├── Table.md
│ │ │ ├── Table.module.scss
│ │ │ ├── Table.spec.ts
│ │ │ ├── Table.tsx
│ │ │ ├── TableNative.tsx
│ │ │ └── useRowSelection.tsx
│ │ ├── TableOfContents
│ │ │ ├── TableOfContents.module.scss
│ │ │ ├── TableOfContents.spec.ts
│ │ │ ├── TableOfContents.tsx
│ │ │ └── TableOfContentsNative.tsx
│ │ ├── Tabs
│ │ │ ├── TabContext.tsx
│ │ │ ├── TabItem.md
│ │ │ ├── TabItem.tsx
│ │ │ ├── TabItemNative.tsx
│ │ │ ├── Tabs.md
│ │ │ ├── Tabs.module.scss
│ │ │ ├── Tabs.spec.ts
│ │ │ ├── Tabs.tsx
│ │ │ └── TabsNative.tsx
│ │ ├── Text
│ │ │ ├── Text.md
│ │ │ ├── Text.module.scss
│ │ │ ├── Text.spec.ts
│ │ │ ├── Text.tsx
│ │ │ └── TextNative.tsx
│ │ ├── TextArea
│ │ │ ├── TextArea.md
│ │ │ ├── TextArea.module.scss
│ │ │ ├── TextArea.spec.ts
│ │ │ ├── TextArea.tsx
│ │ │ ├── TextAreaNative.tsx
│ │ │ ├── TextAreaResizable.tsx
│ │ │ └── useComposedRef.ts
│ │ ├── TextBox
│ │ │ ├── TextBox.md
│ │ │ ├── TextBox.module.scss
│ │ │ ├── TextBox.spec.ts
│ │ │ ├── TextBox.tsx
│ │ │ └── TextBoxNative.tsx
│ │ ├── Theme
│ │ │ ├── NotificationToast.tsx
│ │ │ ├── Theme.md
│ │ │ ├── Theme.module.scss
│ │ │ ├── Theme.spec.ts
│ │ │ ├── Theme.tsx
│ │ │ └── ThemeNative.tsx
│ │ ├── TimeInput
│ │ │ ├── TimeInput.md
│ │ │ ├── TimeInput.module.scss
│ │ │ ├── TimeInput.spec.ts
│ │ │ ├── TimeInput.tsx
│ │ │ ├── TimeInputNative.tsx
│ │ │ └── utils.ts
│ │ ├── Timer
│ │ │ ├── Timer.md
│ │ │ ├── Timer.spec.ts
│ │ │ ├── Timer.tsx
│ │ │ └── TimerNative.tsx
│ │ ├── Toggle
│ │ │ ├── Toggle.module.scss
│ │ │ └── Toggle.tsx
│ │ ├── ToneChangerButton
│ │ │ ├── ToneChangerButton.md
│ │ │ ├── ToneChangerButton.spec.ts
│ │ │ └── ToneChangerButton.tsx
│ │ ├── ToneSwitch
│ │ │ ├── ToneSwitch.md
│ │ │ ├── ToneSwitch.module.scss
│ │ │ ├── ToneSwitch.spec.ts
│ │ │ ├── ToneSwitch.tsx
│ │ │ └── ToneSwitchNative.tsx
│ │ ├── Tooltip
│ │ │ ├── Tooltip.md
│ │ │ ├── Tooltip.module.scss
│ │ │ ├── Tooltip.spec.ts
│ │ │ ├── Tooltip.tsx
│ │ │ └── TooltipNative.tsx
│ │ ├── Tree
│ │ │ ├── testData.ts
│ │ │ ├── Tree-dynamic.spec.ts
│ │ │ ├── Tree-icons.spec.ts
│ │ │ ├── Tree.md
│ │ │ ├── Tree.spec.ts
│ │ │ ├── TreeComponent.module.scss
│ │ │ ├── TreeComponent.tsx
│ │ │ └── TreeNative.tsx
│ │ ├── TreeDisplay
│ │ │ ├── TreeDisplay.md
│ │ │ ├── TreeDisplay.module.scss
│ │ │ ├── TreeDisplay.tsx
│ │ │ └── TreeDisplayNative.tsx
│ │ ├── ValidationSummary
│ │ │ ├── ValidationSummary.module.scss
│ │ │ └── ValidationSummary.tsx
│ │ └── VisuallyHidden.tsx
│ ├── components-core
│ │ ├── abstractions
│ │ │ ├── ComponentRenderer.ts
│ │ │ ├── LoaderRenderer.ts
│ │ │ ├── standalone.ts
│ │ │ └── treeAbstractions.ts
│ │ ├── action
│ │ │ ├── actions.ts
│ │ │ ├── APICall.tsx
│ │ │ ├── FileDownloadAction.tsx
│ │ │ ├── FileUploadAction.tsx
│ │ │ ├── NavigateAction.tsx
│ │ │ └── TimedAction.tsx
│ │ ├── ApiBoundComponent.tsx
│ │ ├── appContext
│ │ │ ├── date-functions.ts
│ │ │ ├── math-function.ts
│ │ │ └── misc-utils.ts
│ │ ├── AppContext.tsx
│ │ ├── behaviors
│ │ │ ├── Behavior.tsx
│ │ │ └── CoreBehaviors.tsx
│ │ ├── component-hooks.ts
│ │ ├── ComponentDecorator.tsx
│ │ ├── ComponentViewer.tsx
│ │ ├── CompoundComponent.tsx
│ │ ├── constants.ts
│ │ ├── DebugViewProvider.tsx
│ │ ├── descriptorHelper.ts
│ │ ├── devtools
│ │ │ ├── InspectorDialog.module.scss
│ │ │ ├── InspectorDialog.tsx
│ │ │ └── InspectorDialogVisibilityContext.tsx
│ │ ├── EngineError.ts
│ │ ├── event-handlers.ts
│ │ ├── InspectorButton.module.scss
│ │ ├── InspectorContext.tsx
│ │ ├── interception
│ │ │ ├── abstractions.ts
│ │ │ ├── ApiInterceptor.ts
│ │ │ ├── ApiInterceptorProvider.tsx
│ │ │ ├── apiInterceptorWorker.ts
│ │ │ ├── Backend.ts
│ │ │ ├── Errors.ts
│ │ │ ├── IndexedDb.ts
│ │ │ ├── initMock.ts
│ │ │ ├── InMemoryDb.ts
│ │ │ ├── ReadonlyCollection.ts
│ │ │ └── useApiInterceptorContext.tsx
│ │ ├── loader
│ │ │ ├── ApiLoader.tsx
│ │ │ ├── DataLoader.tsx
│ │ │ ├── ExternalDataLoader.tsx
│ │ │ ├── Loader.tsx
│ │ │ ├── MockLoaderRenderer.tsx
│ │ │ └── PageableLoader.tsx
│ │ ├── LoaderComponent.tsx
│ │ ├── markup-check.ts
│ │ ├── parts.ts
│ │ ├── renderers.ts
│ │ ├── rendering
│ │ │ ├── AppContent.tsx
│ │ │ ├── AppRoot.tsx
│ │ │ ├── AppWrapper.tsx
│ │ │ ├── buildProxy.ts
│ │ │ ├── collectFnVarDeps.ts
│ │ │ ├── ComponentAdapter.tsx
│ │ │ ├── ComponentWrapper.tsx
│ │ │ ├── Container.tsx
│ │ │ ├── containers.ts
│ │ │ ├── ContainerWrapper.tsx
│ │ │ ├── ErrorBoundary.module.scss
│ │ │ ├── ErrorBoundary.tsx
│ │ │ ├── InvalidComponent.module.scss
│ │ │ ├── InvalidComponent.tsx
│ │ │ ├── nodeUtils.ts
│ │ │ ├── reducer.ts
│ │ │ ├── renderChild.tsx
│ │ │ ├── StandaloneComponent.tsx
│ │ │ ├── StateContainer.tsx
│ │ │ ├── UnknownComponent.module.scss
│ │ │ ├── UnknownComponent.tsx
│ │ │ └── valueExtractor.ts
│ │ ├── reportEngineError.ts
│ │ ├── RestApiProxy.ts
│ │ ├── script-runner
│ │ │ ├── asyncProxy.ts
│ │ │ ├── AttributeValueParser.ts
│ │ │ ├── bannedFunctions.ts
│ │ │ ├── BindingTreeEvaluationContext.ts
│ │ │ ├── eval-tree-async.ts
│ │ │ ├── eval-tree-common.ts
│ │ │ ├── eval-tree-sync.ts
│ │ │ ├── ParameterParser.ts
│ │ │ ├── process-statement-async.ts
│ │ │ ├── process-statement-common.ts
│ │ │ ├── process-statement-sync.ts
│ │ │ ├── ScriptingSourceTree.ts
│ │ │ ├── simplify-expression.ts
│ │ │ ├── statement-queue.ts
│ │ │ └── visitors.ts
│ │ ├── StandaloneApp.tsx
│ │ ├── StandaloneExtensionManager.ts
│ │ ├── TableOfContentsContext.tsx
│ │ ├── theming
│ │ │ ├── _themes.scss
│ │ │ ├── component-layout-resolver.ts
│ │ │ ├── extendThemeUtils.ts
│ │ │ ├── hvar.ts
│ │ │ ├── layout-resolver.ts
│ │ │ ├── parse-layout-props.ts
│ │ │ ├── StyleContext.tsx
│ │ │ ├── StyleRegistry.ts
│ │ │ ├── ThemeContext.tsx
│ │ │ ├── ThemeProvider.tsx
│ │ │ ├── themes
│ │ │ │ ├── base-utils.ts
│ │ │ │ ├── palette.ts
│ │ │ │ ├── root.ts
│ │ │ │ ├── solid.ts
│ │ │ │ ├── theme-colors.ts
│ │ │ │ └── xmlui.ts
│ │ │ ├── themeVars.module.scss
│ │ │ ├── themeVars.ts
│ │ │ ├── transformThemeVars.ts
│ │ │ └── utils.ts
│ │ ├── utils
│ │ │ ├── actionUtils.ts
│ │ │ ├── audio-utils.ts
│ │ │ ├── base64-utils.ts
│ │ │ ├── compound-utils.ts
│ │ │ ├── css-utils.ts
│ │ │ ├── DataLoaderQueryKeyGenerator.ts
│ │ │ ├── date-utils.ts
│ │ │ ├── extractParam.ts
│ │ │ ├── hooks.tsx
│ │ │ ├── LruCache.ts
│ │ │ ├── mergeProps.ts
│ │ │ ├── misc.ts
│ │ │ ├── request-params.ts
│ │ │ ├── statementUtils.ts
│ │ │ └── treeUtils.ts
│ │ └── xmlui-parser.ts
│ ├── index-standalone.ts
│ ├── index.scss
│ ├── index.ts
│ ├── language-server
│ │ ├── server-common.ts
│ │ ├── server-web-worker.ts
│ │ ├── server.ts
│ │ ├── services
│ │ │ ├── common
│ │ │ │ ├── docs-generation.ts
│ │ │ │ ├── lsp-utils.ts
│ │ │ │ ├── metadata-utils.ts
│ │ │ │ └── syntax-node-utilities.ts
│ │ │ ├── completion.ts
│ │ │ ├── diagnostic.ts
│ │ │ ├── format.ts
│ │ │ └── hover.ts
│ │ └── xmlui-metadata-generated.js
│ ├── logging
│ │ ├── LoggerContext.tsx
│ │ ├── LoggerInitializer.tsx
│ │ ├── LoggerService.ts
│ │ └── xmlui.ts
│ ├── logo.svg
│ ├── parsers
│ │ ├── common
│ │ │ ├── GenericToken.ts
│ │ │ ├── InputStream.ts
│ │ │ └── utils.ts
│ │ ├── scripting
│ │ │ ├── code-behind-collect.ts
│ │ │ ├── Lexer.ts
│ │ │ ├── modules.ts
│ │ │ ├── Parser.ts
│ │ │ ├── ParserError.ts
│ │ │ ├── ScriptingNodeTypes.ts
│ │ │ ├── TokenTrait.ts
│ │ │ ├── TokenType.ts
│ │ │ └── tree-visitor.ts
│ │ ├── style-parser
│ │ │ ├── errors.ts
│ │ │ ├── source-tree.ts
│ │ │ ├── StyleInputStream.ts
│ │ │ ├── StyleLexer.ts
│ │ │ ├── StyleParser.ts
│ │ │ └── tokens.ts
│ │ └── xmlui-parser
│ │ ├── CharacterCodes.ts
│ │ ├── diagnostics.ts
│ │ ├── fileExtensions.ts
│ │ ├── index.ts
│ │ ├── lint.ts
│ │ ├── parser.ts
│ │ ├── ParserError.ts
│ │ ├── scanner.ts
│ │ ├── syntax-kind.ts
│ │ ├── syntax-node.ts
│ │ ├── transform.ts
│ │ ├── utils.ts
│ │ ├── xmlui-serializer.ts
│ │ └── xmlui-tree.ts
│ ├── react-app-env.d.ts
│ ├── syntax
│ │ ├── monaco
│ │ │ ├── grammar.monacoLanguage.ts
│ │ │ ├── index.ts
│ │ │ ├── xmlui-dark.ts
│ │ │ ├── xmlui-light.ts
│ │ │ └── xmluiscript.monacoLanguage.ts
│ │ └── textMate
│ │ ├── index.ts
│ │ ├── xmlui-dark.json
│ │ ├── xmlui-light.json
│ │ ├── xmlui.json
│ │ └── xmlui.tmLanguage.json
│ ├── testing
│ │ ├── assertions.ts
│ │ ├── component-test-helpers.ts
│ │ ├── ComponentDrivers.ts
│ │ ├── drivers
│ │ │ ├── DateInputDriver.ts
│ │ │ ├── index.ts
│ │ │ ├── ModalDialogDriver.ts
│ │ │ ├── NumberBoxDriver.ts
│ │ │ ├── TextBoxDriver.ts
│ │ │ ├── TimeInputDriver.ts
│ │ │ ├── TimerDriver.ts
│ │ │ └── TreeDriver.ts
│ │ ├── fixtures.ts
│ │ ├── index.ts
│ │ ├── infrastructure
│ │ │ ├── index.html
│ │ │ ├── main.tsx
│ │ │ ├── public
│ │ │ │ ├── mockServiceWorker.js
│ │ │ │ ├── resources
│ │ │ │ │ ├── bell.svg
│ │ │ │ │ ├── box.svg
│ │ │ │ │ ├── doc.svg
│ │ │ │ │ ├── eye.svg
│ │ │ │ │ ├── flower-640x480.jpg
│ │ │ │ │ ├── sun.svg
│ │ │ │ │ ├── test-image-100x100.jpg
│ │ │ │ │ └── txt.svg
│ │ │ │ └── serve.json
│ │ │ └── TestBed.tsx
│ │ └── themed-app-test-helpers.ts
│ └── vite-env.d.ts
├── tests
│ ├── components
│ │ ├── CodeBlock
│ │ │ └── hightlight-code.test.ts
│ │ ├── playground-pattern.test.ts
│ │ └── Tree
│ │ └── Tree-states.test.ts
│ ├── components-core
│ │ ├── abstractions
│ │ │ └── treeAbstractions.test.ts
│ │ ├── container
│ │ │ └── buildProxy.test.ts
│ │ ├── interception
│ │ │ ├── orderBy.test.ts
│ │ │ ├── ReadOnlyCollection.test.ts
│ │ │ └── request-param-converter.test.ts
│ │ ├── scripts-runner
│ │ │ ├── AttributeValueParser.test.ts
│ │ │ ├── eval-tree-arrow-async.test.ts
│ │ │ ├── eval-tree-arrow.test.ts
│ │ │ ├── eval-tree-func-decl-async.test.ts
│ │ │ ├── eval-tree-func-decl.test.ts
│ │ │ ├── eval-tree-pre-post.test.ts
│ │ │ ├── eval-tree-regression.test.ts
│ │ │ ├── eval-tree.test.ts
│ │ │ ├── function-proxy.test.ts
│ │ │ ├── parser-regression.test.ts
│ │ │ ├── process-event.test.ts
│ │ │ ├── process-function.test.ts
│ │ │ ├── process-implicit-context.test.ts
│ │ │ ├── process-statement-asgn.test.ts
│ │ │ ├── process-statement-destruct.test.ts
│ │ │ ├── process-statement-regs.test.ts
│ │ │ ├── process-statement-sync.test.ts
│ │ │ ├── process-statement.test.ts
│ │ │ ├── process-switch-sync.test.ts
│ │ │ ├── process-switch.test.ts
│ │ │ ├── process-try-sync.test.ts
│ │ │ ├── process-try.test.ts
│ │ │ └── test-helpers.ts
│ │ ├── test-metadata-handler.ts
│ │ ├── theming
│ │ │ ├── border-segments.test.ts
│ │ │ ├── component-layout.resolver.test.ts
│ │ │ ├── layout-property-parser.test.ts
│ │ │ ├── layout-resolver.test.ts
│ │ │ ├── layout-resolver2.test.ts
│ │ │ ├── layout-vp-override.test.ts
│ │ │ └── padding-segments.test.ts
│ │ └── utils
│ │ ├── date-utils.test.ts
│ │ ├── format-human-elapsed-time.test.ts
│ │ └── LruCache.test.ts
│ ├── language-server
│ │ ├── completion.test.ts
│ │ ├── format.test.ts
│ │ ├── hover.test.ts
│ │ └── mockData.ts
│ └── parsers
│ ├── common
│ │ └── input-stream.test.ts
│ ├── markdown
│ │ └── parse-binding-expression.test.ts
│ ├── parameter-parser.test.ts
│ ├── paremeter-parser.test.ts
│ ├── scripting
│ │ ├── eval-tree-arrow.test.ts
│ │ ├── eval-tree-pre-post.test.ts
│ │ ├── eval-tree.test.ts
│ │ ├── function-proxy.test.ts
│ │ ├── lexer-literals.test.ts
│ │ ├── lexer-misc.test.ts
│ │ ├── module-parse.test.ts
│ │ ├── parser-arrow.test.ts
│ │ ├── parser-assignments.test.ts
│ │ ├── parser-binary.test.ts
│ │ ├── parser-destructuring.test.ts
│ │ ├── parser-errors.test.ts
│ │ ├── parser-expressions.test.ts
│ │ ├── parser-function.test.ts
│ │ ├── parser-literals.test.ts
│ │ ├── parser-primary.test.ts
│ │ ├── parser-regex.test.ts
│ │ ├── parser-statements.test.ts
│ │ ├── parser-unary.test.ts
│ │ ├── process-event.test.ts
│ │ ├── process-implicit-context.test.ts
│ │ ├── process-statement-asgn.test.ts
│ │ ├── process-statement-destruct.test.ts
│ │ ├── process-statement-regs.test.ts
│ │ ├── process-statement-sync.test.ts
│ │ ├── process-statement.test.ts
│ │ ├── process-switch-sync.test.ts
│ │ ├── process-switch.test.ts
│ │ ├── process-try-sync.test.ts
│ │ ├── process-try.test.ts
│ │ ├── simplify-expression.test.ts
│ │ ├── statement-hooks.test.ts
│ │ └── test-helpers.ts
│ ├── style-parser
│ │ ├── generateHvarChain.test.ts
│ │ ├── parseHVar.test.ts
│ │ ├── parser.test.ts
│ │ └── tokens.test.ts
│ └── xmlui
│ ├── lint.test.ts
│ ├── parser.test.ts
│ ├── scanner.test.ts
│ ├── transform.attr.test.ts
│ ├── transform.circular.test.ts
│ ├── transform.element.test.ts
│ ├── transform.errors.test.ts
│ ├── transform.escape.test.ts
│ ├── transform.regression.test.ts
│ ├── transform.script.test.ts
│ ├── transform.test.ts
│ └── xmlui.ts
├── tests-e2e
│ ├── api-bound-component-regression.spec.ts
│ ├── api-call-as-extracted-component.spec.ts
│ ├── assign-to-object-or-array-regression.spec.ts
│ ├── binding-regression.spec.ts
│ ├── children-as-template-context-vars.spec.ts
│ ├── compound-component.spec.ts
│ ├── context-vars-regression.spec.ts
│ ├── data-bindings.spec.ts
│ ├── datasource-and-api-usage-in-var.spec.ts
│ ├── datasource-direct-binding.spec.ts
│ ├── datasource-onLoaded-regression.spec.ts
│ ├── modify-array-item-regression.spec.ts
│ ├── namespaces.spec.ts
│ ├── push-to-array-regression.spec.ts
│ ├── screen-breakpoints.spec.ts
│ ├── scripting.spec.ts
│ ├── state-scope-in-pages.spec.ts
│ └── state-var-scopes.spec.ts
├── tsconfig.json
├── tsdown.config.ts
├── vite.config.ts
└── vitest.config.ts
```
# Files
--------------------------------------------------------------------------------
/xmlui/src/components/App/AppNative.tsx:
--------------------------------------------------------------------------------
```typescript
1 | import {
2 | type CSSProperties,
3 | type ReactNode,
4 | useCallback,
5 | useEffect,
6 | useMemo,
7 | useRef,
8 | useState,
9 | } from "react";
10 | import type { JSX } from "react/jsx-runtime";
11 | import { Helmet } from "react-helmet-async";
12 | import { useLocation } from "@remix-run/react";
13 | import { noop } from "lodash-es";
14 | import classnames from "classnames";
15 |
16 | import styles from "./App.module.scss";
17 |
18 | import type { ComponentDef } from "../../abstractions/ComponentDefs";
19 | import type { RenderChildFn, RegisterComponentApiFn } from "../../abstractions/RendererDefs";
20 | import { useAppContext } from "../../components-core/AppContext";
21 | import { useIsomorphicLayoutEffect, useResizeObserver } from "../../components-core/utils/hooks";
22 | import { useTheme, useThemes } from "../../components-core/theming/ThemeContext";
23 | import { useScrollbarWidth } from "../../components-core/utils/css-utils";
24 | import { Sheet, SheetContent } from "../../components/App/Sheet";
25 | import { AppContextAwareAppHeader } from "../../components/AppHeader/AppHeaderNative";
26 | import type { AppLayoutType, IAppLayoutContext } from "./AppLayoutContext";
27 | import { AppLayoutContext } from "./AppLayoutContext";
28 | import { SearchContextProvider } from "./SearchContext";
29 | import type { NavHierarchyNode } from "../NavPanel/NavPanelNative";
30 | import { LinkInfoContext } from "./LinkInfoContext";
31 | import { EMPTY_OBJECT } from "../../components-core/constants";
32 | import { shouldKeep } from "../../components-core/utils/extractParam";
33 |
34 | type Props = {
35 | children: ReactNode;
36 | logoContent?: ReactNode;
37 | header?: ReactNode;
38 | footer?: ReactNode;
39 | navPanel?: ReactNode;
40 | navPanelInDrawer?: ReactNode;
41 | style?: CSSProperties;
42 | className?: string;
43 | layout?: AppLayoutType;
44 | loggedInUser?: any;
45 | scrollWholePage: boolean;
46 | noScrollbarGutters?: boolean;
47 | onReady?: () => void;
48 | onMessageReceived?: (data: any, event: MessageEvent) => void;
49 | navPanelDef?: ComponentDef;
50 | logoContentDef?: ComponentDef;
51 | renderChild?: RenderChildFn;
52 | name?: string;
53 | logo?: string;
54 | logoDark?: string;
55 | logoLight?: string;
56 | defaultTone?: string;
57 | defaultTheme?: string;
58 | autoDetectTone?: boolean;
59 | applyDefaultContentPadding?: boolean;
60 | registerComponentApi?: RegisterComponentApiFn;
61 | };
62 |
63 | export const defaultProps: Pick<
64 | Props,
65 | | "scrollWholePage"
66 | | "noScrollbarGutters"
67 | | "defaultTone"
68 | | "defaultTheme"
69 | | "autoDetectTone"
70 | | "onReady"
71 | | "onMessageReceived"
72 | > = {
73 | scrollWholePage: true,
74 | noScrollbarGutters: false,
75 | defaultTone: undefined,
76 | defaultTheme: undefined,
77 | autoDetectTone: false,
78 | onReady: noop,
79 | onMessageReceived: noop,
80 | };
81 |
82 | export function App({
83 | children,
84 | style = EMPTY_OBJECT,
85 | layout,
86 | loggedInUser,
87 | scrollWholePage = defaultProps.scrollWholePage,
88 | noScrollbarGutters = defaultProps.noScrollbarGutters,
89 | onReady = defaultProps.onReady,
90 | onMessageReceived = defaultProps.onMessageReceived,
91 | header,
92 | navPanel,
93 | footer,
94 | navPanelDef,
95 | logoContentDef,
96 | logo,
97 | logoDark,
98 | logoLight,
99 | defaultTone,
100 | defaultTheme,
101 | autoDetectTone = defaultProps.autoDetectTone,
102 | renderChild,
103 | name,
104 | className,
105 | applyDefaultContentPadding,
106 | registerComponentApi,
107 | ...rest
108 | }: Props) {
109 | const { getThemeVar } = useTheme();
110 | const { setActiveThemeTone, setActiveThemeId, themes } = useThemes();
111 |
112 | const mounted = useRef(false);
113 |
114 | const layoutWithDefaultValue = layout || getThemeVar("layout-App") || "condensed-sticky";
115 | const safeLayout = layoutWithDefaultValue
116 | ?.trim()
117 | .replace(/[\u2013\u2014\u2011]/g, "-") as AppLayoutType; //It replaces all – (–) and — (—) and non-breaking hyphen '‑' symbols with simple dashes (-).
118 | const appContext = useAppContext();
119 | const { setLoggedInUser, mediaSize, forceRefreshAnchorScroll, appGlobals } = appContext;
120 | const hasRegisteredHeader = header !== undefined;
121 |
122 | // --- Check if NavPanel's "when" condition allows it to be rendered
123 | // --- This ensures the drawer and hamburger menu are hidden when NavPanel.when evaluates to false
124 | const navPanelShouldRender = useMemo(() => {
125 | if (!navPanelDef) return false;
126 | // Use shouldKeep to evaluate the NavPanel's when condition
127 | // Pass empty state {} and appContext since we're evaluating at the App level
128 | return shouldKeep(navPanelDef.when, {}, appContext);
129 | }, [navPanelDef, appContext]);
130 |
131 | const hasRegisteredNavPanel = navPanelDef !== undefined && navPanelShouldRender;
132 |
133 | useEffect(() => {
134 | setLoggedInUser(loggedInUser);
135 | }, [loggedInUser, setLoggedInUser]);
136 |
137 | useEffect(() => {
138 | if (mounted.current) return;
139 | mounted.current = true;
140 |
141 | if (defaultTone === "dark" || defaultTone === "light") {
142 | setActiveThemeTone(defaultTone as any);
143 | } else if (autoDetectTone) {
144 | // Auto-detect system theme preference when no defaultTone is set
145 | const systemPrefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
146 | const detectedTone = systemPrefersDark ? "dark" : "light";
147 | setActiveThemeTone(detectedTone);
148 | }
149 |
150 | if (defaultTheme) {
151 | setActiveThemeId(defaultTheme);
152 | }
153 |
154 | return () => {
155 | mounted.current = false;
156 | };
157 | }, [defaultTone, defaultTheme, autoDetectTone, setActiveThemeTone, setActiveThemeId, themes]);
158 |
159 | useEffect(() => {
160 | onReady();
161 | }, [onReady]);
162 |
163 | useEffect(() => {
164 | const handleMessage = (event: MessageEvent) => {
165 | onMessageReceived?.(event.data, event);
166 | };
167 |
168 | window.addEventListener("message", handleMessage);
169 |
170 | return () => {
171 | window.removeEventListener("message", handleMessage);
172 | };
173 | }, [onMessageReceived]);
174 |
175 | // Listen for system theme changes when autoDetectTone is enabled
176 | useEffect(() => {
177 | if (!autoDetectTone || defaultTone) return;
178 |
179 | const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
180 |
181 | const handleThemeChange = (e: MediaQueryListEvent) => {
182 | const detectedTone = e.matches ? "dark" : "light";
183 | setActiveThemeTone(detectedTone);
184 | };
185 |
186 | mediaQuery.addEventListener('change', handleThemeChange);
187 |
188 | return () => {
189 | mediaQuery.removeEventListener('change', handleThemeChange);
190 | };
191 | }, [autoDetectTone, defaultTone, setActiveThemeTone]);
192 |
193 | // --- We don't hide the nav panel if there's no header; in that case, we don't have a show drawer
194 | // --- button. The exception is the condensed layout because we render a header in that case (otherwise,
195 | // --- we couldn't show the NavPanel)
196 | const navPanelVisible =
197 | mediaSize.largeScreen ||
198 | (!hasRegisteredHeader && safeLayout !== "condensed" && safeLayout !== "condensed-sticky");
199 |
200 | const scrollPageContainerRef = useRef(null);
201 | const noScrollPageContainerRef = useRef(null);
202 |
203 | const scrollContainerRef = scrollWholePage ? scrollPageContainerRef : noScrollPageContainerRef;
204 | const [footerHeight, setFooterHeight] = useState(0);
205 | const [headerHeight, setHeaderHeight] = useState(0);
206 | const scrollbarWidth = useScrollbarWidth();
207 |
208 | const footerRef = useRef<HTMLDivElement | null>();
209 | const footerRefCallback = useCallback((element: HTMLDivElement | null) => {
210 | footerRef.current = element;
211 | }, []);
212 |
213 | const headerRef = useRef<HTMLDivElement | null>();
214 | const headerRefCallback = useCallback((element: HTMLDivElement | null) => {
215 | headerRef.current = element;
216 | }, []);
217 |
218 | useResizeObserver(
219 | footerRef,
220 | useCallback((entries) => {
221 | setFooterHeight(entries?.[0]?.contentRect?.height);
222 | }, []),
223 | );
224 |
225 | useResizeObserver(
226 | headerRef,
227 | useCallback((entries) => {
228 | setHeaderHeight(entries?.[0]?.contentRect?.height);
229 | }, []),
230 | );
231 |
232 | const styleWithHelpers = useMemo(() => {
233 | return {
234 | ...style,
235 | "--header-height":
236 | !scrollWholePage ||
237 | safeLayout === "vertical" ||
238 | safeLayout === "horizontal" ||
239 | safeLayout === "condensed"
240 | ? "0px"
241 | : safeLayout === "desktop"
242 | ? headerHeight + "px"
243 | : headerHeight + "px",
244 | "--footer-height":
245 | !scrollWholePage ||
246 | safeLayout === "vertical" ||
247 | safeLayout === "horizontal" ||
248 | safeLayout === "condensed"
249 | ? "0px"
250 | : safeLayout === "desktop"
251 | ? footerHeight + "px"
252 | : footerHeight + "px",
253 | "--header-abs-height": headerHeight + "px",
254 | "--footer-abs-height": footerHeight + "px",
255 | "--scrollbar-width": noScrollbarGutters ? "0px" : scrollbarWidth + "px",
256 | } as CSSProperties;
257 | }, [
258 | footerHeight,
259 | headerHeight,
260 | noScrollbarGutters,
261 | safeLayout,
262 | scrollWholePage,
263 | scrollbarWidth,
264 | style,
265 | ]);
266 |
267 | const [drawerVisible, setDrawerVisible] = useState(false);
268 | const location = useLocation();
269 |
270 | const toggleDrawer = useCallback(() => {
271 | setDrawerVisible((prev) => !prev);
272 | }, []);
273 |
274 | useIsomorphicLayoutEffect(() => {
275 | scrollContainerRef.current?.scrollTo({
276 | top: 0,
277 | left: 0,
278 | behavior: "instant", // Optional if you want to skip the scrolling animation
279 | });
280 | }, [location.pathname]);
281 |
282 | useEffect(() => {
283 | requestAnimationFrame(() => {
284 | // we have to force refresh the anchor scroll to pos, because it depends on the header height (scroll-margin-top on anchors)
285 | forceRefreshAnchorScroll();
286 | });
287 | }, [forceRefreshAnchorScroll]);
288 |
289 | const [subNavPanelSlot, setSubNavPanelSlot] = useState(null);
290 |
291 | const registerSubNavPanelSlot = useCallback((element) => {
292 | setSubNavPanelSlot(element);
293 | }, []);
294 |
295 | const [linkMap, setLinkMap] = useState<Map<string, NavHierarchyNode>>(new Map());
296 | const registerLinkMap = useCallback((newLinkMap: Map<string, NavHierarchyNode>) => {
297 | setLinkMap(newLinkMap);
298 | }, []);
299 |
300 | const layoutContextValue = useMemo<IAppLayoutContext>(() => {
301 | return {
302 | hasRegisteredNavPanel,
303 | hasRegisteredHeader,
304 | navPanelVisible,
305 | drawerVisible,
306 | layout: safeLayout,
307 | logo: logo,
308 | logoDark: logoDark,
309 | logoLight: logoLight,
310 | showDrawer: () => {
311 | setDrawerVisible(true);
312 | },
313 | hideDrawer: () => {
314 | setDrawerVisible(false);
315 | },
316 | toggleDrawer,
317 | navPanelDef,
318 | logoContentDef,
319 | registerSubNavPanelSlot,
320 | subNavPanelSlot,
321 | isNested: appGlobals?.isNested || false,
322 | };
323 | }, [
324 | hasRegisteredNavPanel,
325 | hasRegisteredHeader,
326 | navPanelVisible,
327 | drawerVisible,
328 | safeLayout,
329 | logo,
330 | logoDark,
331 | logoLight,
332 | toggleDrawer,
333 | navPanelDef,
334 | logoContentDef,
335 | registerSubNavPanelSlot,
336 | subNavPanelSlot,
337 | appGlobals?.isNested,
338 | ]);
339 |
340 | const linkInfoContextValue = useMemo(() => {
341 | return {
342 | linkMap,
343 | registerLinkMap,
344 | };
345 | }, [linkMap, registerLinkMap]);
346 |
347 | useEffect(() => {
348 | if (navPanelVisible) {
349 | setDrawerVisible(false);
350 | }
351 | }, [navPanelVisible]);
352 |
353 | useEffect(() => {
354 | setDrawerVisible(false);
355 | }, [location, safeLayout]);
356 |
357 | const wrapperBaseClasses = [
358 | className,
359 | styles.wrapper,
360 | {
361 | [styles.scrollWholePage]: scrollWholePage,
362 | [styles.noScrollbarGutters]: noScrollbarGutters,
363 | "media-large": mediaSize.largeScreen,
364 | "media-small": mediaSize.smallScreen,
365 | "media-desktop": mediaSize.desktop,
366 | "media-phone": mediaSize.phone,
367 | "media-tablet": mediaSize.tablet,
368 | "nested-app": appGlobals?.isNested || false,
369 | },
370 | ];
371 |
372 | let content: string | number | boolean | Iterable<ReactNode> | JSX.Element;
373 | let pagesWrapperClasses = classnames(styles.PagesWrapperInner, {
374 | [styles.withDefaultContentPadding]: applyDefaultContentPadding,
375 | });
376 | switch (safeLayout) {
377 | case "vertical":
378 | content = (
379 | <div
380 | {...rest}
381 | className={classnames(wrapperBaseClasses, styles.vertical)}
382 | style={styleWithHelpers}
383 | >
384 | {navPanelVisible && <div className={classnames(styles.navPanelWrapper)}>{navPanel}</div>}
385 | <div className={styles.contentWrapper} ref={scrollPageContainerRef}>
386 | <header ref={headerRefCallback} className={classnames(styles.headerWrapper)}>
387 | {header}
388 | </header>
389 | <div className={styles.PagesWrapper} ref={noScrollPageContainerRef}>
390 | <div className={pagesWrapperClasses}>{children}</div>
391 | </div>
392 | <div className={styles.footerWrapper} ref={footerRefCallback}>
393 | {footer}
394 | </div>
395 | </div>
396 | </div>
397 | );
398 | break;
399 | case "vertical-sticky":
400 | content = (
401 | <div
402 | {...rest}
403 | className={classnames(wrapperBaseClasses, styles.vertical, styles.sticky)}
404 | style={styleWithHelpers}
405 | >
406 | {navPanelVisible && <div className={classnames(styles.navPanelWrapper)}>{navPanel}</div>}
407 | <div className={styles.contentWrapper} ref={scrollPageContainerRef}>
408 | <header
409 | ref={headerRefCallback}
410 | className={classnames(styles.headerWrapper, styles.sticky)}
411 | >
412 | {header}
413 | </header>
414 | <div className={styles.PagesWrapper} ref={noScrollPageContainerRef}>
415 | <div className={pagesWrapperClasses}>{children}</div>
416 | </div>
417 | <div className={styles.footerWrapper} ref={footerRefCallback}>
418 | {footer}
419 | </div>
420 | </div>
421 | </div>
422 | );
423 | break;
424 | case "vertical-full-header":
425 | content = (
426 | <div
427 | {...rest}
428 | className={classnames(wrapperBaseClasses, styles.verticalFullHeader)}
429 | style={styleWithHelpers}
430 | ref={scrollPageContainerRef}
431 | >
432 | <header
433 | className={classnames(styles.headerWrapper, styles.sticky)}
434 | ref={headerRefCallback}
435 | >
436 | {header}
437 | </header>
438 | <div className={styles.content}>
439 | {navPanelVisible && <aside className={styles.navPanelWrapper}>{navPanel}</aside>}
440 | <main className={styles.contentWrapper}>
441 | <div className={styles.PagesWrapper} ref={noScrollPageContainerRef}>
442 | <div className={pagesWrapperClasses}>{children}</div>
443 | </div>
444 | </main>
445 | </div>
446 | <div className={styles.footerWrapper} ref={footerRefCallback}>
447 | {footer}
448 | </div>
449 | </div>
450 | );
451 | break;
452 | case "condensed":
453 | case "condensed-sticky":
454 | content = (
455 | <div
456 | {...rest}
457 | className={classnames(wrapperBaseClasses, styles.horizontal, {
458 | [styles.sticky]: safeLayout === "condensed-sticky",
459 | })}
460 | style={styleWithHelpers}
461 | ref={scrollPageContainerRef}
462 | >
463 | <header
464 | className={classnames("app-layout-condensed", styles.headerWrapper, {
465 | [styles.sticky]: safeLayout === "condensed-sticky",
466 | })}
467 | ref={headerRefCallback}
468 | >
469 | {!hasRegisteredHeader && hasRegisteredNavPanel && (
470 | <AppContextAwareAppHeader renderChild={renderChild} />
471 | )}
472 | {header}
473 | </header>
474 | <div className={styles.PagesWrapper} ref={noScrollPageContainerRef}>
475 | <div className={pagesWrapperClasses}>{children}</div>
476 | </div>
477 | <div className={styles.footerWrapper} ref={footerRefCallback}>
478 | {footer}
479 | </div>
480 | </div>
481 | );
482 | break;
483 | case "horizontal": {
484 | content = (
485 | <div
486 | {...rest}
487 | className={classnames(wrapperBaseClasses, styles.horizontal)}
488 | style={styleWithHelpers}
489 | ref={scrollPageContainerRef}
490 | >
491 | <header className={classnames(styles.headerWrapper)} ref={headerRefCallback}>
492 | {header}
493 | {navPanelVisible && <div className={styles.navPanelWrapper}>{navPanel}</div>}
494 | </header>
495 | <div className={styles.PagesWrapper} ref={noScrollPageContainerRef}>
496 | <div className={pagesWrapperClasses}>{children}</div>
497 | </div>
498 | <div className={styles.footerWrapper} ref={footerRefCallback}>
499 | {footer}
500 | </div>
501 | </div>
502 | );
503 | break;
504 | }
505 | case "horizontal-sticky":
506 | content = (
507 | <div
508 | {...rest}
509 | className={classnames(wrapperBaseClasses, styles.horizontal, styles.sticky)}
510 | style={styleWithHelpers}
511 | ref={scrollPageContainerRef}
512 | >
513 | <header
514 | className={classnames(styles.headerWrapper, styles.sticky)}
515 | ref={headerRefCallback}
516 | >
517 | {header}
518 | {navPanelVisible && <div className={styles.navPanelWrapper}>{navPanel}</div>}
519 | </header>
520 | <div className={styles.PagesWrapper} ref={noScrollPageContainerRef}>
521 | <div className={pagesWrapperClasses}>{children}</div>
522 | </div>
523 | <div className={styles.footerWrapper} ref={footerRefCallback}>
524 | {footer}
525 | </div>
526 | </div>
527 | );
528 | break;
529 | case "desktop":
530 | content = (
531 | <div
532 | {...rest}
533 | className={classnames(wrapperBaseClasses, styles.desktop)}
534 | style={styleWithHelpers}
535 | >
536 | {header && (
537 | <header
538 | className={classnames(styles.headerWrapper, styles.sticky)}
539 | ref={headerRefCallback}
540 | >
541 | {header}
542 | </header>
543 | )}
544 | <div className={styles.PagesWrapper} ref={noScrollPageContainerRef}>
545 | <div className={styles.PagesWrapperInner}>{children}</div>
546 | </div>
547 | {footer && (
548 | <div className={classnames(styles.footerWrapper, styles.sticky)} ref={footerRefCallback}>
549 | {footer}
550 | </div>
551 | )}
552 | </div>
553 | );
554 | break;
555 | default:
556 | throw new Error("layout type not supported: " + safeLayout);
557 | }
558 |
559 | // Memoize the rendered nav panel in drawer to prevent unnecessary re-renders
560 | const memoizedNavPanelInDrawer = useMemo(
561 | () => (renderChild && navPanelDef ? renderChild(navPanelDef, { inDrawer: true }) : null),
562 | [renderChild, navPanelDef],
563 | );
564 |
565 | // Memoize the helmet component
566 | const memoizedHelmet = useMemo(
567 | () =>
568 | name !== undefined ? <Helmet defaultTitle={name} titleTemplate={`%s | ${name}`} /> : null,
569 | [name],
570 | );
571 |
572 | // Memoize the onOpenChange callback
573 | const handleOpenChange = useCallback((open) => {
574 | setDrawerVisible(open);
575 | }, []);
576 |
577 | return (
578 | <>
579 | {memoizedHelmet}
580 | <AppLayoutContext.Provider value={layoutContextValue}>
581 | <LinkInfoContext.Provider value={linkInfoContextValue}>
582 | <SearchContextProvider>
583 | <Sheet open={drawerVisible} onOpenChange={handleOpenChange}>
584 | <SheetContent side={"left"}>{memoizedNavPanelInDrawer}</SheetContent>
585 | </Sheet>
586 | {content}
587 | </SearchContextProvider>
588 | </LinkInfoContext.Provider>
589 | </AppLayoutContext.Provider>
590 | </>
591 | );
592 | }
593 |
594 | export function getAppLayoutOrientation(appLayout?: AppLayoutType) {
595 | switch (appLayout) {
596 | case "vertical":
597 | case "vertical-sticky":
598 | case "vertical-full-header":
599 | return "vertical";
600 | default:
601 | return "horizontal";
602 | }
603 | }
604 |
```
--------------------------------------------------------------------------------
/xmlui/src/components/Charts/RadarChart/RadarChart.spec.ts:
--------------------------------------------------------------------------------
```typescript
1 | import { expect, test } from "../../../testing/fixtures";
2 |
3 | // Test data helpers - using proper XMLUI data format for radar charts
4 | const sampleData = `[
5 | { subject: 'Math', A: 120, B: 110, fullMark: 150 },
6 | { subject: 'Chinese', A: 98, B: 130, fullMark: 150 },
7 | { subject: 'English', A: 86, B: 130, fullMark: 150 },
8 | { subject: 'Geography', A: 99, B: 100, fullMark: 150 },
9 | { subject: 'Physics', A: 85, B: 90, fullMark: 150 },
10 | { subject: 'History', A: 65, B: 85, fullMark: 150 }
11 | ]`;
12 |
13 | const emptyData = `[]`;
14 |
15 | const singlePointData = `[
16 | { subject: 'Math', A: 120, B: 110, fullMark: 150 }
17 | ]`;
18 |
19 | const multiSeriesData = `[
20 | { skill: 'Communication', team1: 80, team2: 90, team3: 75 },
21 | { skill: 'Problem Solving', team1: 95, team2: 85, team3: 90 },
22 | { skill: 'Leadership', team1: 70, team2: 95, team3: 80 },
23 | { skill: 'Technical', team1: 90, team2: 80, team3: 95 },
24 | { skill: 'Creativity', team1: 85, team2: 75, team3: 85 }
25 | ]`;
26 |
27 | const largeDataset = `[
28 | ${Array.from({ length: 10 }, (_, i) =>
29 | `{ category: 'Cat${i + 1}', value1: ${Math.floor(Math.random() * 100)}, value2: ${Math.floor(Math.random() * 100)} }`
30 | ).join(', ')}
31 | ]`;
32 |
33 | // Chart selectors - update based on specific Recharts RadarChart output
34 | const chartRoot = ".recharts-responsive-container";
35 | const chartSvg = ".recharts-surface";
36 | const radarElementsSelector = ".recharts-radar"; // RadarChart specific
37 | const legendSelector = ".recharts-legend-wrapper";
38 | const tooltipSelector = ".recharts-tooltip-wrapper";
39 | const polarGridSelector = ".recharts-polar-grid";
40 | const polarAngleAxisSelector = ".recharts-polar-angle-axis";
41 | const polarRadiusAxisSelector = ".recharts-polar-radius-axis";
42 | const angleAxisTicksSelector = ".recharts-polar-angle-axis .recharts-text";
43 | const radiusAxisTicksSelector = ".recharts-polar-radius-axis .recharts-text";
44 |
45 | // --- Smoke Tests
46 |
47 | test.describe("smoke tests", { tag: "@smoke" }, () => {
48 | test("component renders with basic props", async ({ initTestBed, page }) => {
49 | await initTestBed(`
50 | <RadarChart
51 | nameKey="subject"
52 | data="{${sampleData}}"
53 | dataKeys="{['A']}"
54 | width="600px"
55 | height="400px"
56 | />
57 | `);
58 |
59 | await page.waitForSelector(chartRoot, { timeout: 10000 });
60 | await expect(page.locator(chartRoot)).toBeVisible();
61 | });
62 |
63 | test("renders correct number of radar elements", async ({ initTestBed, page }) => {
64 | await initTestBed(`
65 | <RadarChart
66 | nameKey="subject"
67 | data="{${sampleData}}"
68 | dataKeys="{['A', 'B']}"
69 | width="600px"
70 | height="400px"
71 | />
72 | `);
73 |
74 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
75 | const elements = page.locator(radarElementsSelector);
76 | await expect(elements).toHaveCount(2); // Should match dataKeys length
77 | });
78 |
79 | test("handles empty data gracefully", async ({ initTestBed, page }) => {
80 | await initTestBed(`
81 | <RadarChart
82 | nameKey="subject"
83 | data="{${emptyData}}"
84 | dataKeys="{['A']}"
85 | width="600px"
86 | height="400px"
87 | />
88 | `);
89 |
90 | await page.waitForSelector(chartRoot, { timeout: 10000 });
91 | await expect(page.locator(chartRoot)).toBeVisible();
92 | });
93 |
94 | test("handles single data point", async ({ initTestBed, page }) => {
95 | await initTestBed(`
96 | <RadarChart
97 | nameKey="subject"
98 | data="{${singlePointData}}"
99 | dataKeys="{['A']}"
100 | width="600px"
101 | height="400px"
102 | />
103 | `);
104 |
105 | await page.waitForSelector(chartRoot, { timeout: 10000 });
106 | await expect(page.locator(chartRoot)).toBeVisible();
107 | });
108 | });
109 |
110 | // --- Grid and Axes Tests
111 |
112 | test.describe("polar grid", () => {
113 | test("polar grid is shown by default", async ({ initTestBed, page }) => {
114 | await initTestBed(`
115 | <RadarChart
116 | nameKey="subject"
117 | data="{${sampleData}}"
118 | dataKeys="{['A']}"
119 | width="600px"
120 | height="400px"
121 | />
122 | `);
123 |
124 | await page.waitForSelector(polarGridSelector, { timeout: 10000 });
125 | await expect(page.locator(polarGridSelector)).toBeVisible();
126 | });
127 |
128 | test("polar grid can be hidden", async ({ initTestBed, page }) => {
129 | await initTestBed(`
130 | <RadarChart
131 | nameKey="subject"
132 | data="{${sampleData}}"
133 | dataKeys="{['A']}"
134 | hideGrid="true"
135 | width="600px"
136 | height="400px"
137 | />
138 | `);
139 |
140 | await page.waitForSelector(chartRoot, { timeout: 10000 });
141 | await expect(page.locator(polarGridSelector)).not.toBeVisible();
142 | });
143 | });
144 |
145 | test.describe("angle axis", () => {
146 | test("angle axis is shown by default", async ({ initTestBed, page }) => {
147 | await initTestBed(`
148 | <RadarChart
149 | nameKey="subject"
150 | data="{${sampleData}}"
151 | dataKeys="{['A']}"
152 | width="600px"
153 | height="400px"
154 | />
155 | `);
156 |
157 | await page.waitForSelector(polarAngleAxisSelector, { timeout: 10000 });
158 | await expect(page.locator(polarAngleAxisSelector)).toBeVisible();
159 | });
160 |
161 | test("angle axis can be hidden", async ({ initTestBed, page }) => {
162 | await initTestBed(`
163 | <RadarChart
164 | nameKey="subject"
165 | data="{${sampleData}}"
166 | dataKeys="{['A']}"
167 | hideAngleAxis="true"
168 | width="600px"
169 | height="400px"
170 | />
171 | `);
172 |
173 | await page.waitForSelector(chartRoot, { timeout: 10000 });
174 | await expect(page.locator(polarAngleAxisSelector)).not.toBeVisible();
175 | });
176 | });
177 |
178 | test.describe("radius axis", () => {
179 | test("radius axis is shown by default", async ({ initTestBed, page }) => {
180 | await initTestBed(`
181 | <RadarChart
182 | nameKey="subject"
183 | data="{${sampleData}}"
184 | dataKeys="{['A']}"
185 | width="600px"
186 | height="400px"
187 | />
188 | `);
189 |
190 | await page.waitForSelector(polarRadiusAxisSelector, { timeout: 10000 });
191 | await expect(page.locator(polarRadiusAxisSelector)).toBeVisible();
192 | });
193 |
194 | test("radius axis can be hidden", async ({ initTestBed, page }) => {
195 | await initTestBed(`
196 | <RadarChart
197 | nameKey="subject"
198 | data="{${sampleData}}"
199 | dataKeys="{['A']}"
200 | hideRadiusAxis="true"
201 | width="600px"
202 | height="400px"
203 | />
204 | `);
205 |
206 | await page.waitForSelector(chartRoot, { timeout: 10000 });
207 | await expect(page.locator(polarRadiusAxisSelector)).not.toBeVisible();
208 | });
209 | });
210 |
211 | // --- Legend Tests
212 |
213 | test.describe("legend", () => {
214 | test("legend is hidden by default", async ({ initTestBed, page }) => {
215 | await initTestBed(`
216 | <RadarChart
217 | nameKey="subject"
218 | data="{${sampleData}}"
219 | dataKeys="{['A', 'B']}"
220 | width="600px"
221 | height="400px"
222 | />
223 | `);
224 |
225 | await page.waitForSelector(chartRoot, { timeout: 10000 });
226 | await expect(page.locator(legendSelector)).not.toBeVisible();
227 | });
228 |
229 | test("legend can be shown", async ({ initTestBed, page }) => {
230 | await initTestBed(`
231 | <RadarChart
232 | nameKey="subject"
233 | data="{${sampleData}}"
234 | dataKeys="{['A', 'B']}"
235 | showLegend="true"
236 | width="600px"
237 | height="400px"
238 | />
239 | `);
240 |
241 | await page.waitForSelector(legendSelector, { timeout: 10000 });
242 | await expect(page.locator(legendSelector)).toBeVisible();
243 | });
244 | });
245 |
246 | // --- Radar Chart Specific Tests
247 |
248 | test.describe("filled areas", () => {
249 | test("areas are filled by default", async ({ initTestBed, page }) => {
250 | await initTestBed(`
251 | <RadarChart
252 | nameKey="subject"
253 | data="{${sampleData}}"
254 | dataKeys="{['A', 'B']}"
255 | width="600px"
256 | height="400px"
257 | />
258 | `);
259 |
260 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
261 | const radars = page.locator(radarElementsSelector);
262 | await expect(radars).toHaveCount(2);
263 | });
264 |
265 | test("areas can be unfilled", async ({ initTestBed, page }) => {
266 | await initTestBed(`
267 | <RadarChart
268 | nameKey="subject"
269 | data="{${sampleData}}"
270 | dataKeys="{['A', 'B']}"
271 | filled="false"
272 | width="600px"
273 | height="400px"
274 | />
275 | `);
276 |
277 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
278 | const radars = page.locator(radarElementsSelector);
279 | await expect(radars).toHaveCount(2);
280 | });
281 | });
282 |
283 | test.describe("stroke width", () => {
284 | test("uses default stroke width", async ({ initTestBed, page }) => {
285 | await initTestBed(`
286 | <RadarChart
287 | nameKey="subject"
288 | data="{${sampleData}}"
289 | dataKeys="{['A']}"
290 | width="600px"
291 | height="400px"
292 | />
293 | `);
294 |
295 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
296 | await expect(page.locator(radarElementsSelector)).toBeVisible();
297 | });
298 |
299 | test("applies custom stroke width", async ({ initTestBed, page }) => {
300 | await initTestBed(`
301 | <RadarChart
302 | nameKey="subject"
303 | data="{${sampleData}}"
304 | dataKeys="{['A']}"
305 | strokeWidth="4"
306 | width="600px"
307 | height="400px"
308 | />
309 | `);
310 |
311 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
312 | await expect(page.locator(radarElementsSelector)).toBeVisible();
313 | });
314 | });
315 |
316 | test.describe("fill opacity", () => {
317 | test("uses default fill opacity", async ({ initTestBed, page }) => {
318 | await initTestBed(`
319 | <RadarChart
320 | nameKey="subject"
321 | data="{${sampleData}}"
322 | dataKeys="{['A']}"
323 | width="600px"
324 | height="400px"
325 | />
326 | `);
327 |
328 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
329 | await expect(page.locator(radarElementsSelector)).toBeVisible();
330 | });
331 |
332 | test("applies custom fill opacity", async ({ initTestBed, page }) => {
333 | await initTestBed(`
334 | <RadarChart
335 | nameKey="subject"
336 | data="{${sampleData}}"
337 | dataKeys="{['A']}"
338 | fillOpacity="0.8"
339 | width="600px"
340 | height="400px"
341 | />
342 | `);
343 |
344 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
345 | await expect(page.locator(radarElementsSelector)).toBeVisible();
346 | });
347 | });
348 |
349 | // --- Responsive Behavior Tests
350 |
351 | test.describe("responsive behavior", () => {
352 | test("enters mini mode with very small container height", async ({ initTestBed, page }) => {
353 | await initTestBed(`
354 | <RadarChart
355 | nameKey="subject"
356 | data="{${sampleData}}"
357 | dataKeys="{['A']}"
358 | showLegend="true"
359 | width="600px"
360 | height="100px"
361 | />
362 | `);
363 |
364 | await page.waitForSelector(chartRoot, { timeout: 10000 });
365 |
366 | // Wait for chart to fully render and responsive behavior to take effect
367 | await page.waitForTimeout(1000);
368 |
369 | // In mini mode, legend should be hidden
370 | await expect(page.locator(legendSelector)).not.toBeVisible();
371 |
372 | // Note: Polar axes might still be visible in Recharts RadarChart even in mini mode
373 | // This is different from CartesianGrid charts - RadarChart handles mini mode differently
374 | // So we'll focus on testing the legend hiding which is the main responsive behavior
375 | });
376 |
377 | test("normal mode with adequate height", async ({ initTestBed, page }) => {
378 | await initTestBed(`
379 | <RadarChart
380 | nameKey="subject"
381 | data="{${sampleData}}"
382 | dataKeys="{['A']}"
383 | showLegend="true"
384 | width="600px"
385 | height="300px"
386 | />
387 | `);
388 |
389 | await page.waitForSelector(chartRoot, { timeout: 10000 });
390 |
391 | // In normal mode, legend and axes should be visible
392 | await expect(page.locator(legendSelector)).toBeVisible();
393 | await expect(page.locator(polarAngleAxisSelector)).toBeVisible();
394 | await expect(page.locator(polarRadiusAxisSelector)).toBeVisible();
395 | });
396 | });
397 |
398 | // --- Tooltip Tests
399 |
400 | test.describe("tooltip", () => {
401 | test("tooltip is shown by default", async ({ initTestBed, page }) => {
402 | await initTestBed(`
403 | <RadarChart
404 | nameKey="subject"
405 | data="{${sampleData}}"
406 | dataKeys="{['A']}"
407 | width="600px"
408 | height="400px"
409 | />
410 | `);
411 |
412 | await page.waitForSelector(chartRoot, { timeout: 10000 });
413 |
414 | // Hover over radar area to trigger tooltip
415 | await page.locator(radarElementsSelector).first().hover();
416 | await expect(page.locator(tooltipSelector)).toBeVisible();
417 | });
418 |
419 | test("tooltip can be hidden", async ({ initTestBed, page }) => {
420 | await initTestBed(`
421 | <RadarChart
422 | nameKey="subject"
423 | data="{${sampleData}}"
424 | dataKeys="{['A']}"
425 | hideTooltip="true"
426 | width="600px"
427 | height="400px"
428 | />
429 | `);
430 |
431 | await page.waitForSelector(chartRoot, { timeout: 10000 });
432 |
433 | // Hover over radar area - tooltip should not appear
434 | await page.locator(radarElementsSelector).first().hover();
435 | await expect(page.locator(tooltipSelector)).not.toBeVisible();
436 | });
437 | });
438 |
439 | // --- Comprehensive Prop Tests
440 |
441 | test.describe("data prop", () => {
442 | test("handles array data correctly", async ({ initTestBed, page }) => {
443 | await initTestBed(`
444 | <RadarChart
445 | nameKey="subject"
446 | data="{${sampleData}}"
447 | dataKeys="{['A']}"
448 | width="600px"
449 | height="400px"
450 | />
451 | `);
452 |
453 | await page.waitForSelector(chartRoot, { timeout: 10000 });
454 | await expect(page.locator(chartRoot)).toBeVisible();
455 | await expect(page.locator(radarElementsSelector)).toHaveCount(1);
456 | });
457 |
458 | test("handles large datasets", async ({ initTestBed, page }) => {
459 | await initTestBed(`
460 | <RadarChart
461 | nameKey="category"
462 | data="{${largeDataset}}"
463 | dataKeys="{['value1', 'value2']}"
464 | width="600px"
465 | height="400px"
466 | />
467 | `);
468 |
469 | await page.waitForSelector(chartRoot, { timeout: 10000 });
470 | await expect(page.locator(radarElementsSelector)).toHaveCount(2);
471 | });
472 |
473 | test("handles missing data prop", async ({ initTestBed, page }) => {
474 | await initTestBed(`
475 | <RadarChart
476 | nameKey="subject"
477 | dataKeys="{['A']}"
478 | width="600px"
479 | height="400px"
480 | />
481 | `);
482 |
483 | await page.waitForSelector(chartRoot, { timeout: 10000 });
484 | await expect(page.locator(chartRoot)).toBeVisible();
485 | });
486 | });
487 |
488 | test.describe("dataKeys prop", () => {
489 | test("renders single data series", async ({ initTestBed, page }) => {
490 | await initTestBed(`
491 | <RadarChart
492 | nameKey="subject"
493 | data="{${sampleData}}"
494 | dataKeys="{['A']}"
495 | width="600px"
496 | height="400px"
497 | />
498 | `);
499 |
500 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
501 | await expect(page.locator(radarElementsSelector)).toHaveCount(1);
502 | });
503 |
504 | test("renders multiple data series", async ({ initTestBed, page }) => {
505 | await initTestBed(`
506 | <RadarChart
507 | nameKey="skill"
508 | data="{${multiSeriesData}}"
509 | dataKeys="{['team1', 'team2', 'team3']}"
510 | width="600px"
511 | height="400px"
512 | />
513 | `);
514 |
515 | await page.waitForSelector(radarElementsSelector, { timeout: 10000 });
516 | await expect(page.locator(radarElementsSelector)).toHaveCount(3);
517 | });
518 |
519 | test("handles empty dataKeys array", async ({ initTestBed, page }) => {
520 | await initTestBed(`
521 | <RadarChart
522 | nameKey="subject"
523 | data="{${sampleData}}"
524 | dataKeys="{[]}"
525 | width="600px"
526 | height="400px"
527 | />
528 | `);
529 |
530 | await page.waitForSelector(chartRoot, { timeout: 10000 });
531 | await expect(page.locator(chartRoot)).toBeVisible();
532 | await expect(page.locator(radarElementsSelector)).toHaveCount(0);
533 | });
534 | });
535 |
536 | test.describe("nameKey prop", () => {
537 | test("uses correct nameKey for angle axis labels", async ({ initTestBed, page }) => {
538 | await initTestBed(`
539 | <RadarChart
540 | nameKey="subject"
541 | data="{${sampleData}}"
542 | dataKeys="{['A']}"
543 | width="600px"
544 | height="400px"
545 | />
546 | `);
547 |
548 | await page.waitForSelector(angleAxisTicksSelector, { timeout: 10000 });
549 | const firstTick = page.locator(angleAxisTicksSelector).first();
550 | await expect(firstTick).toContainText("Math");
551 | });
552 |
553 | test("handles different nameKey", async ({ initTestBed, page }) => {
554 | await initTestBed(`
555 | <RadarChart
556 | nameKey="skill"
557 | data="{${multiSeriesData}}"
558 | dataKeys="{['team1']}"
559 | width="600px"
560 | height="400px"
561 | />
562 | `);
563 |
564 | await page.waitForSelector(angleAxisTicksSelector, { timeout: 10000 });
565 | const firstTick = page.locator(angleAxisTicksSelector).first();
566 | await expect(firstTick).toContainText("Communication");
567 | });
568 | });
569 |
570 | test.describe("combined props", () => {
571 | test("all visual props combined", async ({ initTestBed, page }) => {
572 | await initTestBed(`
573 | <RadarChart
574 | nameKey="skill"
575 | data="{${multiSeriesData}}"
576 | dataKeys="{['team1', 'team2']}"
577 | filled="true"
578 | strokeWidth="3"
579 | fillOpacity="0.5"
580 | showLegend="true"
581 | hideGrid="false"
582 | width="600px"
583 | height="400px"
584 | />
585 | `);
586 |
587 | await page.waitForSelector(chartRoot, { timeout: 10000 });
588 | await expect(page.locator(radarElementsSelector)).toHaveCount(2);
589 | await expect(page.locator(legendSelector)).toBeVisible();
590 | await expect(page.locator(polarGridSelector)).toBeVisible();
591 | });
592 |
593 | test("minimal configuration", async ({ initTestBed, page }) => {
594 | await initTestBed(`
595 | <RadarChart
596 | nameKey="subject"
597 | data="{${sampleData}}"
598 | dataKeys="{['A']}"
599 | hideGrid="true"
600 | hideAngleAxis="true"
601 | hideRadiusAxis="true"
602 | hideTooltip="true"
603 | filled="false"
604 | width="600px"
605 | height="400px"
606 | />
607 | `);
608 |
609 | await page.waitForSelector(chartRoot, { timeout: 10000 });
610 | await expect(page.locator(radarElementsSelector)).toHaveCount(1);
611 | await expect(page.locator(polarGridSelector)).not.toBeVisible();
612 | await expect(page.locator(polarAngleAxisSelector)).not.toBeVisible();
613 | await expect(page.locator(polarRadiusAxisSelector)).not.toBeVisible();
614 | });
615 |
616 | test("maximum configuration", async ({ initTestBed, page }) => {
617 | await initTestBed(`
618 | <RadarChart
619 | nameKey="skill"
620 | data="{${multiSeriesData}}"
621 | dataKeys="{['team1', 'team2', 'team3']}"
622 | filled="true"
623 | strokeWidth="4"
624 | fillOpacity="0.8"
625 | showLegend="true"
626 | hideGrid="false"
627 | hideAngleAxis="false"
628 | hideRadiusAxis="false"
629 | hideTooltip="false"
630 | width="600px"
631 | height="400px"
632 | />
633 | `);
634 |
635 | await page.waitForSelector(chartRoot, { timeout: 10000 });
636 | await page.waitForSelector(radarElementsSelector, { timeout: 5000 });
637 | await expect(page.locator(radarElementsSelector)).toHaveCount(3);
638 |
639 | await page.waitForSelector(legendSelector, { timeout: 5000 });
640 | await expect(page.locator(legendSelector)).toBeVisible();
641 |
642 | await page.waitForSelector(polarGridSelector, { timeout: 5000 });
643 | await page.waitForSelector(polarAngleAxisSelector, { timeout: 5000 });
644 | await page.waitForSelector(polarRadiusAxisSelector, { timeout: 5000 });
645 | await expect(page.locator(polarGridSelector)).toBeVisible();
646 | await expect(page.locator(polarAngleAxisSelector)).toBeVisible();
647 | await expect(page.locator(polarRadiusAxisSelector)).toBeVisible();
648 | });
649 | });
650 |
```
--------------------------------------------------------------------------------
/xmlui/src/components/Charts/Legend/Legend.spec.ts:
--------------------------------------------------------------------------------
```typescript
1 | import { expect, test } from "../../../testing/fixtures";
2 |
3 | // Test data helpers - using proper XMLUI data format
4 | const sampleData = `[
5 | { name: 'Desktop', value: 400, fill: '#8884d8' },
6 | { name: 'Mobile', value: 300, fill: '#82ca9d' },
7 | { name: 'Tablet', value: 200, fill: '#ffc658' },
8 | { name: 'Other', value: 100, fill: '#ff7300' }
9 | ]`;
10 |
11 | const emptyData = `[]`;
12 |
13 | const singlePointData = `[
14 | { name: 'Desktop', value: 400 }
15 | ]`;
16 |
17 | const largeDataset = `[
18 | { name: 'Category A', value: 400 },
19 | { name: 'Category B', value: 300 },
20 | { name: 'Category C', value: 200 },
21 | { name: 'Category D', value: 100 },
22 | { name: 'Category E', value: 150 },
23 | { name: 'Category F', value: 250 },
24 | { name: 'Category G', value: 180 },
25 | { name: 'Category H', value: 320 },
26 | { name: 'Category I', value: 275 },
27 | { name: 'Category J', value: 190 }
28 | ]`;
29 |
30 | // Chart selectors - Legend specific
31 | const chartRoot = ".recharts-responsive-container";
32 | const chartSvg = ".recharts-surface";
33 | const legendSelector = ".recharts-legend-wrapper";
34 | const legendItemSelector = ".recharts-legend-item";
35 | const legendTextSelector = ".recharts-legend-item-text";
36 |
37 | // =============================================================================
38 | // BASIC FUNCTIONALITY TESTS
39 | // =============================================================================
40 |
41 | test.describe("Basic Functionality", () => {
42 |
43 | // Smoke tests
44 | test.describe("smoke tests", { tag: "@smoke" }, () => {
45 | test("Legend renders within PieChart", async ({ initTestBed, page }) => {
46 | await initTestBed(`
47 | <PieChart
48 | nameKey="name"
49 | dataKey="value"
50 | data="{${sampleData}}"
51 | width="400px"
52 | height="400px"
53 | >
54 | <Legend />
55 | </PieChart>
56 | `);
57 |
58 | await page.waitForSelector(chartRoot, { timeout: 10000 });
59 | await expect(page.locator(chartRoot)).toBeVisible();
60 | await expect(page.locator(legendSelector)).toBeVisible();
61 | });
62 |
63 | test("Legend renders within BarChart", async ({ initTestBed, page }) => {
64 | await initTestBed(`
65 | <BarChart
66 | xKey="name"
67 | yKeys="{['value']}"
68 | data="{${sampleData}}"
69 | width="600px"
70 | height="400px"
71 | showLegend
72 | >
73 | <Legend />
74 | </BarChart>
75 | `);
76 |
77 | await page.waitForSelector(chartRoot, { timeout: 10000 });
78 | await expect(page.locator(chartRoot)).toBeVisible();
79 | await expect(page.locator(legendSelector)).toBeVisible();
80 | });
81 | });
82 |
83 | // Align prop tests
84 | test.describe("align prop", () => {
85 | test("handles 'left' alignment", async ({ initTestBed, page }) => {
86 | await initTestBed(`
87 | <PieChart
88 | nameKey="name"
89 | dataKey="value"
90 | data="{${sampleData}}"
91 | width="400px"
92 | height="400px"
93 | >
94 | <Legend align="left" />
95 | </PieChart>
96 | `);
97 |
98 | await page.waitForSelector(legendSelector, { timeout: 10000 });
99 | const legend = page.locator(legendSelector);
100 | await expect(legend).toBeVisible();
101 |
102 | // Legend should be visible with left alignment
103 | // Note: Actual positioning may vary based on chart implementation
104 | await expect(legend).toBeVisible();
105 | });
106 |
107 | test("handles 'center' alignment (default)", async ({ initTestBed, page }) => {
108 | await initTestBed(`
109 | <PieChart
110 | nameKey="name"
111 | dataKey="value"
112 | data="{${sampleData}}"
113 | width="400px"
114 | height="400px"
115 | >
116 | <Legend />
117 | </PieChart>
118 | `);
119 |
120 | await page.waitForSelector(legendSelector, { timeout: 10000 });
121 | const legend = page.locator(legendSelector);
122 | await expect(legend).toBeVisible();
123 | });
124 |
125 | test("handles 'right' alignment", async ({ initTestBed, page }) => {
126 | await initTestBed(`
127 | <PieChart
128 | nameKey="name"
129 | dataKey="value"
130 | data="{${sampleData}}"
131 | width="400px"
132 | height="400px"
133 | >
134 | <Legend align="right" />
135 | </PieChart>
136 | `);
137 |
138 | await page.waitForSelector(legendSelector, { timeout: 10000 });
139 | const legend = page.locator(legendSelector);
140 | await expect(legend).toBeVisible();
141 |
142 | // Legend should be visible with right alignment
143 | // Note: Actual positioning may vary based on chart implementation
144 | await expect(legend).toBeVisible();
145 | });
146 | });
147 |
148 | // VerticalAlign prop tests
149 | test.describe("verticalAlign prop", () => {
150 | test("handles 'top' vertical alignment", async ({ initTestBed, page }) => {
151 | await initTestBed(`
152 | <PieChart
153 | nameKey="name"
154 | dataKey="value"
155 | data="{${sampleData}}"
156 | width="400px"
157 | height="400px"
158 | >
159 | <Legend verticalAlign="top" />
160 | </PieChart>
161 | `);
162 |
163 | await page.waitForSelector(legendSelector, { timeout: 10000 });
164 | const legend = page.locator(legendSelector);
165 | await expect(legend).toBeVisible();
166 |
167 | // Legend should be visible with top alignment
168 | // Note: Actual positioning may vary based on chart implementation
169 | await expect(legend).toBeVisible();
170 | });
171 |
172 | test("handles 'bottom' vertical alignment (default)", async ({ initTestBed, page }) => {
173 | await initTestBed(`
174 | <PieChart
175 | nameKey="name"
176 | dataKey="value"
177 | data="{${sampleData}}"
178 | width="400px"
179 | height="400px"
180 | >
181 | <Legend />
182 | </PieChart>
183 | `);
184 |
185 | await page.waitForSelector(legendSelector, { timeout: 10000 });
186 | const legend = page.locator(legendSelector);
187 | await expect(legend).toBeVisible();
188 | });
189 |
190 | test("handles 'middle' vertical alignment", async ({ initTestBed, page }) => {
191 | await initTestBed(`
192 | <PieChart
193 | nameKey="name"
194 | dataKey="value"
195 | data="{${sampleData}}"
196 | width="400px"
197 | height="400px"
198 | >
199 | <Legend verticalAlign="middle" />
200 | </PieChart>
201 | `);
202 |
203 | await page.waitForSelector(legendSelector, { timeout: 10000 });
204 | const legend = page.locator(legendSelector);
205 | await expect(legend).toBeVisible();
206 |
207 | // Legend should be visible with middle alignment
208 | // Note: Actual positioning may vary based on chart implementation
209 | await expect(legend).toBeVisible();
210 | });
211 | });
212 |
213 | // Combined alignment tests
214 | test.describe("combined alignment", () => {
215 | test("handles top-left alignment", async ({ initTestBed, page }) => {
216 | await initTestBed(`
217 | <PieChart
218 | nameKey="name"
219 | dataKey="value"
220 | data="{${sampleData}}"
221 | width="400px"
222 | height="400px"
223 | >
224 | <Legend align="left" verticalAlign="top" />
225 | </PieChart>
226 | `);
227 |
228 | await page.waitForSelector(legendSelector, { timeout: 10000 });
229 | await expect(page.locator(legendSelector)).toBeVisible();
230 | });
231 |
232 | test("handles bottom-right alignment", async ({ initTestBed, page }) => {
233 | await initTestBed(`
234 | <PieChart
235 | nameKey="name"
236 | dataKey="value"
237 | data="{${sampleData}}"
238 | width="400px"
239 | height="400px"
240 | >
241 | <Legend align="right" verticalAlign="bottom" />
242 | </PieChart>
243 | `);
244 |
245 | await page.waitForSelector(legendSelector, { timeout: 10000 });
246 | await expect(page.locator(legendSelector)).toBeVisible();
247 | });
248 |
249 | test("handles center-middle alignment", async ({ initTestBed, page }) => {
250 | await initTestBed(`
251 | <PieChart
252 | nameKey="name"
253 | dataKey="value"
254 | data="{${sampleData}}"
255 | width="400px"
256 | height="400px"
257 | >
258 | <Legend align="center" verticalAlign="middle" />
259 | </PieChart>
260 | `);
261 |
262 | await page.waitForSelector(legendSelector, { timeout: 10000 });
263 | await expect(page.locator(legendSelector)).toBeVisible();
264 | });
265 | });
266 |
267 | // Data handling tests
268 | test.describe("data handling", () => {
269 | test("displays legend items for all data entries", async ({ initTestBed, page }) => {
270 | await initTestBed(`
271 | <PieChart
272 | nameKey="name"
273 | dataKey="value"
274 | data="{${sampleData}}"
275 | width="400px"
276 | height="400px"
277 | >
278 | <Legend />
279 | </PieChart>
280 | `);
281 |
282 | await page.waitForSelector(legendSelector, { timeout: 10000 });
283 | const legendItems = page.locator(legendItemSelector);
284 | await expect(legendItems).toHaveCount(4); // Desktop, Mobile, Tablet, Other
285 |
286 | // Check that legend text matches data names
287 | await expect(page.locator(legendTextSelector).filter({ hasText: "Desktop" })).toBeVisible();
288 | await expect(page.locator(legendTextSelector).filter({ hasText: "Mobile" })).toBeVisible();
289 | await expect(page.locator(legendTextSelector).filter({ hasText: "Tablet" })).toBeVisible();
290 | await expect(page.locator(legendTextSelector).filter({ hasText: "Other" })).toBeVisible();
291 | });
292 |
293 | test("handles single data point", async ({ initTestBed, page }) => {
294 | await initTestBed(`
295 | <PieChart
296 | nameKey="name"
297 | dataKey="value"
298 | data="{${singlePointData}}"
299 | width="400px"
300 | height="400px"
301 | >
302 | <Legend />
303 | </PieChart>
304 | `);
305 |
306 | await page.waitForSelector(legendSelector, { timeout: 10000 });
307 | const legendItems = page.locator(legendItemSelector);
308 | await expect(legendItems).toHaveCount(1);
309 | await expect(page.locator(legendTextSelector).filter({ hasText: "Desktop" })).toBeVisible();
310 | });
311 |
312 | test("handles empty data gracefully", async ({ initTestBed, page }) => {
313 | await initTestBed(`
314 | <PieChart
315 | nameKey="name"
316 | dataKey="value"
317 | data="{${emptyData}}"
318 | width="400px"
319 | height="400px"
320 | >
321 | <Legend />
322 | </PieChart>
323 | `);
324 |
325 | await page.waitForSelector(chartRoot, { timeout: 10000 });
326 | // Legend should still be present but with no items
327 | const legendItems = page.locator(legendItemSelector);
328 | await expect(legendItems).toHaveCount(0);
329 | });
330 |
331 | test("handles large datasets", async ({ initTestBed, page }) => {
332 | await initTestBed(`
333 | <PieChart
334 | nameKey="name"
335 | dataKey="value"
336 | data="{${largeDataset}}"
337 | width="400px"
338 | height="400px"
339 | >
340 | <Legend />
341 | </PieChart>
342 | `);
343 |
344 | await page.waitForSelector(legendSelector, { timeout: 10000 });
345 | const legendItems = page.locator(legendItemSelector);
346 | await expect(legendItems).toHaveCount(10);
347 | });
348 | });
349 |
350 | // Integration with different chart types
351 | test.describe("chart type integration", () => {
352 | test("works with LineChart", async ({ initTestBed, page }) => {
353 | await initTestBed(`
354 | <LineChart
355 | xKey="name"
356 | yKeys="{['value']}"
357 | data="{${sampleData}}"
358 | width="400px"
359 | height="400px"
360 | showLegend
361 | >
362 | <Legend />
363 | </LineChart>
364 | `);
365 |
366 | await page.waitForSelector(chartRoot, { timeout: 10000 });
367 | await expect(page.locator(legendSelector)).toBeVisible();
368 | });
369 |
370 | test("works with DonutChart", async ({ initTestBed, page }) => {
371 | await initTestBed(`
372 | <DonutChart
373 | nameKey="name"
374 | dataKey="value"
375 | data="{${sampleData}}"
376 | width="400px"
377 | height="400px"
378 | >
379 | <Legend />
380 | </DonutChart>
381 | `);
382 |
383 | await page.waitForSelector(chartRoot, { timeout: 10000 });
384 | await expect(page.locator(legendSelector)).toBeVisible();
385 | });
386 | });
387 | });
388 |
389 | // =============================================================================
390 | // ACCESSIBILITY TESTS
391 | // =============================================================================
392 |
393 | test.describe("Accessibility", () => {
394 | test("legend has proper ARIA structure", async ({ initTestBed, page }) => {
395 | await initTestBed(`
396 | <PieChart
397 | nameKey="name"
398 | dataKey="value"
399 | data="{${sampleData}}"
400 | width="400px"
401 | height="400px"
402 | >
403 | <Legend />
404 | </PieChart>
405 | `);
406 |
407 | await page.waitForSelector(legendSelector, { timeout: 10000 });
408 | const legend = page.locator(legendSelector);
409 | await expect(legend).toBeVisible();
410 |
411 | // Legend should be accessible to screen readers
412 | const legendItems = page.locator(legendItemSelector);
413 | await expect(legendItems.first()).toBeVisible();
414 | });
415 |
416 | test("legend items are keyboard accessible", async ({ initTestBed, page }) => {
417 | await initTestBed(`
418 | <PieChart
419 | nameKey="name"
420 | dataKey="value"
421 | data="{${sampleData}}"
422 | width="400px"
423 | height="400px"
424 | >
425 | <Legend />
426 | </PieChart>
427 | `);
428 |
429 | await page.waitForSelector(legendSelector, { timeout: 10000 });
430 |
431 | // Tab navigation should work through legend items
432 | await page.keyboard.press("Tab");
433 | const focusedElement = page.locator(":focus");
434 | await expect(focusedElement).toBeVisible();
435 | });
436 |
437 | test("legend text is readable and properly contrasted", async ({ initTestBed, page }) => {
438 | await initTestBed(`
439 | <PieChart
440 | nameKey="name"
441 | dataKey="value"
442 | data="{${sampleData}}"
443 | width="400px"
444 | height="400px"
445 | >
446 | <Legend />
447 | </PieChart>
448 | `);
449 |
450 | await page.waitForSelector(legendSelector, { timeout: 10000 });
451 | const legendText = page.locator(legendTextSelector).first();
452 | await expect(legendText).toBeVisible();
453 |
454 | // Text should have readable font size
455 | await expect(legendText).toHaveCSS("font-size", /\d+px/);
456 | });
457 |
458 | test("supports screen reader navigation", async ({ initTestBed, page }) => {
459 | await initTestBed(`
460 | <PieChart
461 | nameKey="name"
462 | dataKey="value"
463 | data="{${sampleData}}"
464 | width="400px"
465 | height="400px"
466 | >
467 | <Legend />
468 | </PieChart>
469 | `);
470 |
471 | await page.waitForSelector(legendSelector, { timeout: 10000 });
472 |
473 | // Legend should be announced properly by screen readers
474 | const legendItems = page.locator(legendItemSelector);
475 | for (let i = 0; i < await legendItems.count(); i++) {
476 | const item = legendItems.nth(i);
477 | await expect(item).toBeVisible();
478 | }
479 | });
480 | });
481 |
482 | // =============================================================================
483 | // PERFORMANCE AND EDGE CASES
484 | // =============================================================================
485 |
486 | test.describe("Performance and Edge Cases", () => {
487 | test("handles rapid prop changes efficiently", async ({ initTestBed, page }) => {
488 | const { testStateDriver } = await initTestBed(`
489 | <PieChart
490 | nameKey="name"
491 | dataKey="value"
492 | data="{${sampleData}}"
493 | width="400px"
494 | height="400px"
495 | >
496 | <Legend align="{testState || 'center'}" />
497 | </PieChart>
498 | <Button onClick="testState = testState === 'center' ? 'left' : 'center'">Toggle Align</Button>
499 | `);
500 |
501 | await page.waitForSelector(legendSelector, { timeout: 10000 });
502 |
503 | // Rapidly change alignment
504 | for (let i = 0; i < 5; i++) {
505 | await page.getByRole("button", { name: "Toggle Align" }).click();
506 | await page.waitForTimeout(100);
507 | }
508 |
509 | // Legend should still be visible and functional
510 | await expect(page.locator(legendSelector)).toBeVisible();
511 | });
512 |
513 | test("maintains performance with large datasets", async ({ initTestBed, page }) => {
514 | await initTestBed(`
515 | <PieChart
516 | nameKey="name"
517 | dataKey="value"
518 | data="{${largeDataset}}"
519 | width="400px"
520 | height="400px"
521 | >
522 | <Legend />
523 | </PieChart>
524 | `);
525 |
526 | await page.waitForSelector(legendSelector, { timeout: 10000 });
527 | const legendItems = page.locator(legendItemSelector);
528 | await expect(legendItems).toHaveCount(10);
529 |
530 | // All legend items should be visible
531 | for (let i = 0; i < 10; i++) {
532 | await expect(legendItems.nth(i)).toBeVisible();
533 | }
534 | });
535 |
536 | test("handles responsive container changes", async ({ initTestBed, page }) => {
537 | const { testStateDriver } = await initTestBed(`
538 | <PieChart
539 | nameKey="name"
540 | dataKey="value"
541 | data="{${sampleData}}"
542 | width="{testState || '400px'}"
543 | height="400px"
544 | >
545 | <Legend />
546 | </PieChart>
547 | <Button onClick="testState = testState === '400px' ? '200px' : '400px'">Toggle Size</Button>
548 | `);
549 |
550 | await page.waitForSelector(legendSelector, { timeout: 10000 });
551 |
552 | // Change container size
553 | await page.getByRole("button", { name: "Toggle Size" }).click();
554 | await page.waitForTimeout(500);
555 |
556 | // Legend should still be visible and properly positioned
557 | await expect(page.locator(legendSelector)).toBeVisible();
558 | });
559 |
560 | test("handles Unicode and special characters in legend text", async ({ initTestBed, page }) => {
561 | const unicodeData = `[
562 | { name: 'Desktop 🖥️', value: 400 },
563 | { name: 'Mobile 📱', value: 300 },
564 | { name: 'Tablet 📟', value: 200 },
565 | { name: 'Other ⚡', value: 100 }
566 | ]`;
567 |
568 | await initTestBed(`
569 | <PieChart
570 | nameKey="name"
571 | dataKey="value"
572 | data="{${unicodeData}}"
573 | width="400px"
574 | height="400px"
575 | >
576 | <Legend />
577 | </PieChart>
578 | `);
579 |
580 | await page.waitForSelector(legendSelector, { timeout: 10000 });
581 |
582 | // Check that Unicode characters are displayed correctly
583 | await expect(page.locator(legendTextSelector).filter({ hasText: "🖥️" })).toBeVisible();
584 | await expect(page.locator(legendTextSelector).filter({ hasText: "📱" })).toBeVisible();
585 | await expect(page.locator(legendTextSelector).filter({ hasText: "📟" })).toBeVisible();
586 | await expect(page.locator(legendTextSelector).filter({ hasText: "⚡" })).toBeVisible();
587 | });
588 |
589 | test("handles null and undefined prop values gracefully", async ({ initTestBed, page }) => {
590 | await initTestBed(`
591 | <PieChart
592 | nameKey="name"
593 | dataKey="value"
594 | data="{${sampleData}}"
595 | width="400px"
596 | height="400px"
597 | >
598 | <Legend align="{null}" verticalAlign="{undefined}" />
599 | </PieChart>
600 | `);
601 |
602 | await page.waitForSelector(chartRoot, { timeout: 10000 });
603 | // Should fall back to default values and still render
604 | await expect(page.locator(legendSelector)).toBeVisible();
605 | });
606 |
607 | test("works correctly when multiple Legend components are present", async ({ initTestBed, page }) => {
608 | await initTestBed(`
609 | <PieChart
610 | nameKey="name"
611 | dataKey="value"
612 | data="{${sampleData}}"
613 | width="400px"
614 | height="400px"
615 | >
616 | <Legend align="left" />
617 | <Legend align="right" />
618 | </PieChart>
619 | `);
620 |
621 | await page.waitForSelector(chartRoot, { timeout: 10000 });
622 | // Only one legend should be rendered (last one wins)
623 | const legends = page.locator(legendSelector);
624 | await expect(legends).toHaveCount(1);
625 | });
626 | });
627 |
```