#
tokens: 60908/50000 1/1764 files (page 216/224)
lines: on (toggle) GitHub
raw markdown copy reset
This is page 216 of 224. Use http://codebase.md/xmlui-org/xmlui?lines=true&page={x} to view the full context.

# Directory Structure

```
├── .changeset
│   ├── config.json
│   ├── hip-dogs-see.md
│   ├── open-dodos-fetch.md
│   ├── smooth-pears-kneel.md
│   ├── smooth-steaks-jog.md
│   ├── sour-queens-grab.md
│   ├── tasty-owls-win.md
│   └── wild-pots-glow.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-fast.yml
│       ├── run-all-tests.yml
│       └── run-smoke-tests.yml
├── .gitignore
├── .npmrc
├── .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
│   │   │   ├── icons
│   │   │   │   ├── github.svg
│   │   │   │   └── rss.svg
│   │   │   ├── llms.txt
│   │   │   ├── logo-dark.svg
│   │   │   ├── logo.svg
│   │   │   ├── pg-popout.svg
│   │   │   ├── rss.svg
│   │   │   └── xmlui-logo.svg
│   │   ├── serve.json
│   │   └── staticwebapp.config.json
│   ├── scripts
│   │   ├── download-latest-xmlui.js
│   │   ├── generate-rss.js
│   │   ├── get-releases.js
│   │   └── utils.js
│   ├── src
│   │   ├── components
│   │   │   ├── BlogOverview.xmlui
│   │   │   ├── BlogPage.xmlui
│   │   │   ├── LinkButton.xmlui
│   │   │   ├── PageNotFound.xmlui
│   │   │   └── Separator.xmlui
│   │   ├── config.ts
│   │   └── Main.xmlui
│   └── 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
│   │   │   ├── ResponsiveBar.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
│   │   │   │   ├── copy-billing-to-shipping.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
│   │   │   │   ├── implement-an-authentication-gate.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-modal-dialog-onclose.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
│   │   │   ├── icons
│   │   │   │   ├── github.svg
│   │   │   │   └── rss.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
│   │   └── staticwebapp.config.json
│   ├── 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
│   │   │   ├── LinkButton.xmlui
│   │   │   ├── NameValue.xmlui
│   │   │   ├── PageNotFound.xmlui
│   │   │   ├── PaletteItem.xmlui
│   │   │   ├── Palettes.xmlui
│   │   │   ├── SectionHeader.xmlui
│   │   │   ├── Separator.xmlui
│   │   │   ├── TBD.xmlui
│   │   │   ├── Test.xmlui
│   │   │   ├── ThemesIntro.xmlui
│   │   │   ├── ThousandThemes.xmlui
│   │   │   ├── TubeStops.xmlui
│   │   │   ├── TubeStops.xmlui.xs
│   │   │   └── TwoColumnCode.xmlui
│   │   ├── config.ts
│   │   ├── Main.xmlui
│   │   └── themes
│   │       ├── 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
    │   ├── app-next.md
    │   ├── build-system.md
    │   ├── build-xmlui.md
    │   ├── component-behaviors.md
    │   ├── component-metadata.md
    │   ├── components-with-options.md
    │   ├── containers.md
    │   ├── data-operations.md
    │   ├── glossary.md
    │   ├── images
    │   │   ├── condensed-layout-content-scroll-no-gutters-bottom.svg
    │   │   ├── condensed-layout-content-scroll-no-gutters-no-overflow.svg
    │   │   ├── condensed-layout-content-scroll-no-gutters-top.svg
    │   │   ├── condensed-layout-content-scroll-with-gutters-bottom.svg
    │   │   ├── condensed-layout-content-scroll-with-gutters-no-overflow.svg
    │   │   ├── condensed-layout-content-scroll-with-gutters-top.svg
    │   │   ├── condensed-layout-no-gutters-bottom.svg
    │   │   ├── condensed-layout-no-gutters-mid.svg
    │   │   ├── condensed-layout-no-gutters-top.svg
    │   │   ├── condensed-layout-no-overflow.svg
    │   │   ├── condensed-layout-with-gutters-bottom.svg
    │   │   ├── condensed-layout-with-gutters-no-overflow.svg
    │   │   ├── condensed-layout-with-gutters-top.svg
    │   │   ├── condensed-sticky-content-scroll-no-gutters-bottom.svg
    │   │   ├── condensed-sticky-content-scroll-no-gutters-no-overflow.svg
    │   │   ├── condensed-sticky-content-scroll-no-gutters-top.svg
    │   │   ├── condensed-sticky-content-scroll-with-gutters-bottom.svg
    │   │   ├── condensed-sticky-content-scroll-with-gutters-no-overflow.svg
    │   │   ├── condensed-sticky-content-scroll-with-gutters-top.svg
    │   │   ├── condensed-sticky-layout-no-gutters-bottom.svg
    │   │   ├── condensed-sticky-layout-no-gutters-top.svg
    │   │   ├── condensed-sticky-layout-no-overflow.svg
    │   │   ├── condensed-sticky-layout-with-gutters-bottom.svg
    │   │   ├── condensed-sticky-layout-with-gutters-no-overflow.svg
    │   │   ├── condensed-sticky-layout-with-gutters-top.svg
    │   │   ├── desktop-layout-no-overflow.svg
    │   │   ├── desktop-layout-overflow-bottom.svg
    │   │   ├── desktop-layout-overflow-top.svg
    │   │   ├── horizontal-layout-content-scroll-no-gutters-bottom.svg
    │   │   ├── horizontal-layout-content-scroll-no-gutters-top.svg
    │   │   ├── horizontal-layout-content-scroll-no-gutters.svg
    │   │   ├── horizontal-layout-content-scroll-with-gutters-bottom.svg
    │   │   ├── horizontal-layout-content-scroll-with-gutters-diagram.svg
    │   │   ├── horizontal-layout-content-scroll-with-gutters-top.svg
    │   │   ├── horizontal-layout-diagram.svg
    │   │   ├── horizontal-layout-no-gutters-overflow-scrollbar-bottom.svg
    │   │   ├── horizontal-layout-no-gutters-overflow-scrollbar-top.svg
    │   │   ├── horizontal-layout-overflow-scrollbar-bottom.svg
    │   │   ├── horizontal-layout-overflow-scrollbar-nogutter-bottom.svg
    │   │   ├── horizontal-layout-overflow-scrollbar-nogutter-mid.svg
    │   │   ├── horizontal-layout-overflow-scrollbar-top.svg
    │   │   ├── horizontal-layout-with-gutters-diagram.svg
    │   │   ├── horizontal-sticky-content-scroll-no-gutters-bottom.svg
    │   │   ├── horizontal-sticky-content-scroll-no-gutters-top.svg
    │   │   ├── horizontal-sticky-content-scroll-no-gutters.svg
    │   │   ├── horizontal-sticky-content-scroll-with-gutters-bottom.svg
    │   │   ├── horizontal-sticky-content-scroll-with-gutters-top.svg
    │   │   ├── horizontal-sticky-content-scroll-with-gutters.svg
    │   │   ├── horizontal-sticky-layout-overflow-bottom.svg
    │   │   ├── horizontal-sticky-layout-overflow-top.svg
    │   │   ├── horizontal-sticky-layout-with-gutters-bottom-scroll.svg
    │   │   ├── horizontal-sticky-layout-with-gutters-mid-scroll.svg
    │   │   ├── horizontal-sticky-layout-with-gutters-no-overflow.svg
    │   │   ├── horizontal-sticky-layout-with-gutters-overflow-bottom.svg
    │   │   ├── horizontal-sticky-layout-with-gutters-overflow-mid.svg
    │   │   ├── horizontal-sticky-layout-with-gutters-overflow-top.svg
    │   │   ├── horizontal-sticky-layout-with-gutters.svg
    │   │   ├── horizontal-sticky-layout.svg
    │   │   ├── vertical-full-header-content-scroll-no-gutters-overflow-bottom.svg
    │   │   ├── vertical-full-header-content-scroll-no-gutters-overflow-top.svg
    │   │   ├── vertical-full-header-content-scroll-no-gutters.svg
    │   │   ├── vertical-full-header-content-scroll-with-gutters-overflow-bottom.svg
    │   │   ├── vertical-full-header-content-scroll-with-gutters-overflow-top.svg
    │   │   ├── vertical-full-header-content-scroll-with-gutters.svg
    │   │   ├── vertical-full-header-layout-no-gutters-overflow-bottom.svg
    │   │   ├── vertical-full-header-layout-no-gutters-overflow-top.svg
    │   │   ├── vertical-full-header-layout-no-gutters.svg
    │   │   ├── vertical-full-header-layout-with-gutters-overflow-bottom.svg
    │   │   ├── vertical-full-header-layout-with-gutters-overflow-top.svg
    │   │   ├── vertical-full-header-layout-with-gutters.svg
    │   │   ├── vertical-layout-content-scroll-no-gutters-overflow-bottom.svg
    │   │   ├── vertical-layout-content-scroll-no-gutters-overflow-top.svg
    │   │   ├── vertical-layout-content-scroll-no-gutters.svg
    │   │   ├── vertical-layout-content-scroll-with-gutters-overflow-bottom.svg
    │   │   ├── vertical-layout-content-scroll-with-gutters-overflow-top.svg
    │   │   ├── vertical-layout-content-scroll-with-gutters.svg
    │   │   ├── vertical-layout-no-gutters-overflow-bottom.svg
    │   │   ├── vertical-layout-no-gutters-overflow-top.svg
    │   │   ├── vertical-layout-no-gutters.svg
    │   │   ├── vertical-layout-with-gutters-overflow-bottom.svg
    │   │   ├── vertical-layout-with-gutters-overflow-top.svg
    │   │   ├── vertical-layout-with-gutters.svg
    │   │   ├── vertical-sticky-content-scroll-no-gutters-overflow-bottom.svg
    │   │   ├── vertical-sticky-content-scroll-no-gutters-overflow-top.svg
    │   │   ├── vertical-sticky-content-scroll-no-gutters.svg
    │   │   ├── vertical-sticky-content-scroll-with-gutters-overflow-bottom.svg
    │   │   ├── vertical-sticky-content-scroll-with-gutters-overflow-top.svg
    │   │   ├── vertical-sticky-content-scroll-with-gutters.svg
    │   │   ├── vertical-sticky-layout-no-gutters-overflow-bottom.svg
    │   │   ├── vertical-sticky-layout-no-gutters-overflow-top.svg
    │   │   ├── vertical-sticky-layout-no-gutters.svg
    │   │   ├── vertical-sticky-layout-with-gutters-overflow-bottom.svg
    │   │   ├── vertical-sticky-layout-with-gutters-overflow-top.svg
    │   │   └── vertical-sticky-layout-with-gutters.svg
    │   ├── 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
    │   ├── svg-diagram-rules.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-layout.spec.ts
    │   │   │   ├── 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
    │   │   ├── App2
    │   │   │   ├── app-refactor.md
    │   │   │   ├── App2-layout-mobile.spec.ts
    │   │   │   ├── App2-layout.spec.ts
    │   │   │   ├── App2.md
    │   │   │   ├── App2.module.scss
    │   │   │   ├── App2.spec.ts
    │   │   │   ├── App2.tsx
    │   │   │   ├── App2Native.tsx
    │   │   │   ├── App2Navigation.ts
    │   │   │   ├── 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
    │   │   │   ├── SearchIndexCollector.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
    │   │   ├── Part
    │   │   │   └── Part.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
    │   │   │   ├── ResponsiveBarItem.tsx
    │   │   │   └── ResponsiveBarNative.tsx
    │   │   ├── Select
    │   │   │   ├── HiddenOption.tsx
    │   │   │   ├── MultiSelectOption.tsx
    │   │   │   ├── OptionContext.ts
    │   │   │   ├── Select.md
    │   │   │   ├── Select.module.scss
    │   │   │   ├── Select.spec.ts
    │   │   │   ├── Select.tsx
    │   │   │   ├── SelectContext.tsx
    │   │   │   ├── SelectNative.tsx
    │   │   │   ├── SelectOption.tsx
    │   │   │   └── SimpleSelect.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
    │   │   ├── Toast
    │   │   │   ├── Toast.spec.ts
    │   │   │   ├── Toast.tsx
    │   │   │   └── ToastNative.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
    │   └── 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-disabled.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
    │   ├── inline-styles-disabled.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/App2/App2-layout.spec.ts:
--------------------------------------------------------------------------------

```typescript
   1 | import { expect, test } from "../../testing/fixtures";
   2 | import type { Page } from "@playwright/test";
   3 | 
   4 | // =============================================================================
   5 | // TEST HELPERS
   6 | // =============================================================================
   7 | 
   8 | function createLayoutMarkup(
   9 |   layout: string,
  10 |   noScrollbarGutters: boolean,
  11 |   scrollWholePage: boolean,
  12 |   contentHeight: string
  13 | ) {
  14 |   return `
  15 |     <App2
  16 |       layout="${layout}"
  17 |       noScrollbarGutters="${noScrollbarGutters}"
  18 |       scrollWholePage="${scrollWholePage}"
  19 |     >
  20 |       <AppHeader testId="appHeader">
  21 |         Header
  22 |       </AppHeader>
  23 |       <NavPanel testId="navPanel">
  24 |         <NavLink label="Link 1" to="/page1" />
  25 |         <NavLink label="Link 2" to="/page2" />
  26 |       </NavPanel>
  27 |       <Pages fallbackPath="/">
  28 |         <Page url="/">
  29 |           <Stack testId="mainContent" height="${contentHeight}" backgroundColor="lightblue">
  30 |             <Text>
  31 |               Main Content
  32 |             </Text>
  33 |           </Stack>
  34 |         </Page>
  35 |       </Pages>
  36 |       <Footer testId="footer">
  37 |         Footer
  38 |       </Footer>
  39 |     </App2>
  40 |   `;
  41 | }
  42 | 
  43 | async function verifyAllBlocksVisible(page: Page) {
  44 |   const header = page.getByTestId("appHeader");
  45 |   const navPanel = page.getByTestId("navPanel");
  46 |   const mainContent = page.getByTestId("mainContent");
  47 |   const footer = page.getByTestId("footer");
  48 | 
  49 |   await expect(header).toBeVisible();
  50 |   await expect(navPanel).toBeVisible();
  51 |   await expect(mainContent).toBeVisible();
  52 |   await expect(footer).toBeVisible();
  53 | }
  54 | 
  55 | async function verifyBlocksInViewport(page: Page, blockIds: string[]) {
  56 |   for (const id of blockIds) {
  57 |     const block = page.getByTestId(id);
  58 |     const box = await block.boundingBox();
  59 |     expect(box).not.toBeNull();
  60 |     expect(box!.y).toBeGreaterThanOrEqual(0);
  61 |     expect(box!.y + box!.height).toBeLessThanOrEqual(1080);
  62 |   }
  63 | }
  64 | 
  65 | async function verifyBlocksAboveViewport(page: Page, blockIds: string[]) {
  66 |   for (const id of blockIds) {
  67 |     const block = page.getByTestId(id);
  68 |     const box = await block.boundingBox();
  69 |     expect(box).not.toBeNull();
  70 |     expect(box!.y + box!.height).toBeLessThan(0);
  71 |   }
  72 | }
  73 | 
  74 | async function verifyBlocksBelowViewport(page: Page, blockIds: string[]) {
  75 |   for (const id of blockIds) {
  76 |     const block = page.getByTestId(id);
  77 |     const box = await block.boundingBox();
  78 |     expect(box).not.toBeNull();
  79 |     expect(box!.y).toBeGreaterThan(1080);
  80 |   }
  81 | }
  82 | 
  83 | async function verifyAppContainerScrollable(page: Page, shouldBeScrollable: boolean) {
  84 |   const info = await page.evaluate(() => {
  85 |     const appWrapper = document.querySelector('[class*="appContainer"]');
  86 |     if (!appWrapper || appWrapper.className.includes("pagesContainer")) {
  87 |       return { found: false, isScrollable: false };
  88 |     }
  89 | 
  90 |     // For vertical-full-header layout, check if appWrapper itself has verticalFullHeader class
  91 |     const isVerticalFullHeader = appWrapper.className.includes('verticalFullHeader');
  92 |     
  93 |     // Check if there's a mainContentArea inside (vertical layout)
  94 |     const mainContentArea = appWrapper.querySelector('[class*="mainContentArea"]');
  95 |     
  96 |     // Priority: appWrapper with verticalFullHeader > mainContentArea > appWrapper
  97 |     const scrollContainer = (isVerticalFullHeader ? appWrapper : (mainContentArea || appWrapper)) as HTMLElement;
  98 | 
  99 |     const styles = window.getComputedStyle(scrollContainer);
 100 |     const scrollHeight = scrollContainer.scrollHeight;
 101 |     const clientHeight = scrollContainer.clientHeight;
 102 |     const isScrollable = scrollHeight > clientHeight;
 103 | 
 104 |     const hasOverflow =
 105 |       styles.overflow === "auto" ||
 106 |       styles.overflow === "scroll" ||
 107 |       styles.overflowY === "auto" ||
 108 |       styles.overflowY === "scroll";
 109 | 
 110 |     return { found: true, isScrollable, hasOverflow };
 111 |   });
 112 | 
 113 |   expect(info.found).toBe(true);
 114 |   expect(info.isScrollable).toBe(shouldBeScrollable);
 115 |   if (shouldBeScrollable) {
 116 |     expect(info.hasOverflow).toBe(true);
 117 |   }
 118 | }
 119 | 
 120 | async function verifyScrollbarGutters(page: Page, shouldHaveGutters: boolean) {
 121 |   const info = await page.evaluate(() => {
 122 |     const appWrapper = document.querySelector('[class*="appContainer"]');
 123 |     if (!appWrapper || appWrapper.className.includes("pagesContainer")) {
 124 |       return { found: false };
 125 |     }
 126 | 
 127 |     // For vertical-full-header layout, check if appWrapper itself has verticalFullHeader class
 128 |     const isVerticalFullHeader = appWrapper.className.includes('verticalFullHeader');
 129 |     
 130 |     // Check if there's a mainContentArea inside (vertical layout)
 131 |     const mainContentArea = appWrapper.querySelector('[class*="mainContentArea"]');
 132 |     
 133 |     // Priority: appWrapper with verticalFullHeader > mainContentArea > appWrapper
 134 |     const scrollContainer = isVerticalFullHeader ? appWrapper : (mainContentArea || appWrapper);
 135 | 
 136 |     const styles = window.getComputedStyle(scrollContainer);
 137 |     return {
 138 |       found: true,
 139 |       scrollbarGutter: styles.scrollbarGutter,
 140 |     };
 141 |   });
 142 | 
 143 |   expect(info.found).toBe(true);
 144 |   if (shouldHaveGutters) {
 145 |     expect(info.scrollbarGutter).toBe("stable both-edges");
 146 |   } else {
 147 |     expect(info.scrollbarGutter).not.toBe("stable both-edges");
 148 |   }
 149 | }
 150 | 
 151 | async function verifyMainContentIsScrollContainer(page: Page) {
 152 |   const info = await page.evaluate(() => {
 153 |     const mainContent = document.querySelector('[data-testid="mainContent"]');
 154 |     if (!mainContent) return { found: false };
 155 | 
 156 |     let scrollContainer = mainContent.parentElement;
 157 |     while (scrollContainer) {
 158 |       const styles = window.getComputedStyle(scrollContainer);
 159 |       const hasOverflow =
 160 |         styles.overflow === "auto" ||
 161 |         styles.overflow === "scroll" ||
 162 |         styles.overflowY === "auto" ||
 163 |         styles.overflowY === "scroll";
 164 | 
 165 |       if (hasOverflow) {
 166 |         const className = scrollContainer.className || "";
 167 |         const isPagesWrapper =
 168 |           className.includes("pagesContainer") || 
 169 |           className.includes("pageContentContainer");
 170 | 
 171 |         return {
 172 |           found: true,
 173 |           isPagesWrapper,
 174 |           isScrollable: scrollContainer.scrollHeight > scrollContainer.clientHeight,
 175 |           scrollbarGutter: styles.scrollbarGutter,
 176 |         };
 177 |       }
 178 |       scrollContainer = scrollContainer.parentElement;
 179 |     }
 180 | 
 181 |     return { found: false };
 182 |   });
 183 | 
 184 |   expect(info.found).toBe(true);
 185 |   expect(info.isPagesWrapper).toBe(true);
 186 |   return info;
 187 | }
 188 | 
 189 | async function verifyAppContainerNotScrollable(page: Page) {
 190 |   const info = await page.evaluate(() => {
 191 |     const appWrapper = document.querySelector('[class*="appContainer"]');
 192 |     if (!appWrapper || appWrapper.className.includes("pagesContainer")) {
 193 |       return { found: false };
 194 |     }
 195 | 
 196 |     // Check if there's a mainContentArea inside (vertical layout)
 197 |     const mainContentArea = appWrapper.querySelector('[class*="mainContentArea"]');
 198 |     const scrollContainer = mainContentArea || appWrapper;
 199 | 
 200 |     const styles = window.getComputedStyle(scrollContainer);
 201 |     return {
 202 |       found: true,
 203 |       overflow: styles.overflow,
 204 |       overflowY: styles.overflowY,
 205 |     };
 206 |   });
 207 | 
 208 |   expect(info.found).toBe(true);
 209 |   expect(["hidden", "visible", ""]).toContain(info.overflow);
 210 | }
 211 | 
 212 | async function scrollAppContainerTo(page: Page, position: "top" | "mid" | "bottom") {
 213 |   await page.evaluate((pos) => {
 214 |     const appWrapper = document.querySelector('[class*="appContainer"]') as HTMLElement;
 215 |     if (!appWrapper || appWrapper.className.includes("pagesContainer")) return;
 216 | 
 217 |     // For vertical-full-header layout, check if appWrapper itself has verticalFullHeader class
 218 |     const isVerticalFullHeader = appWrapper.className.includes('verticalFullHeader');
 219 |     
 220 |     // Check if there's a mainContentArea inside (vertical layout)
 221 |     const mainContentArea = appWrapper.querySelector('[class*="mainContentArea"]') as HTMLElement;
 222 |     
 223 |     // Priority: appWrapper with verticalFullHeader > mainContentArea > appWrapper
 224 |     const scrollContainer = isVerticalFullHeader ? appWrapper : (mainContentArea || appWrapper);
 225 | 
 226 |     const maxScroll = scrollContainer.scrollHeight - scrollContainer.clientHeight;
 227 |     if (pos === "top") {
 228 |       scrollContainer.scrollTop = 0;
 229 |     } else if (pos === "mid") {
 230 |       scrollContainer.scrollTop = maxScroll * 0.33;
 231 |     } else {
 232 |       scrollContainer.scrollTop = maxScroll;
 233 |     }
 234 |   }, position);
 235 | 
 236 |   await page.waitForTimeout(100);
 237 | }
 238 | 
 239 | async function scrollMainContentTo(page: Page, position: "top" | "mid" | "bottom") {
 240 |   await page.evaluate((pos) => {
 241 |     const mainContent = document.querySelector('[data-testid="mainContent"]');
 242 |     if (!mainContent) return;
 243 | 
 244 |     let scrollContainer = mainContent.parentElement;
 245 |     while (scrollContainer) {
 246 |       const styles = window.getComputedStyle(scrollContainer);
 247 |       const hasOverflow =
 248 |         styles.overflow === "auto" ||
 249 |         styles.overflow === "scroll" ||
 250 |         styles.overflowY === "auto" ||
 251 |         styles.overflowY === "scroll";
 252 | 
 253 |       if (hasOverflow) {
 254 |         const maxScroll = scrollContainer.scrollHeight - scrollContainer.clientHeight;
 255 |         if (pos === "top") {
 256 |           scrollContainer.scrollTop = 0;
 257 |         } else if (pos === "mid") {
 258 |           scrollContainer.scrollTop = maxScroll * 0.5;
 259 |         } else {
 260 |           scrollContainer.scrollTop = maxScroll;
 261 |         }
 262 |         break;
 263 |       }
 264 |       scrollContainer = scrollContainer.parentElement;
 265 |     }
 266 |   }, position);
 267 | 
 268 |   await page.waitForTimeout(100);
 269 | }
 270 | 
 271 | async function verifyMainContentScrollbarGutters(page: Page, shouldHaveGutters: boolean) {
 272 |   const info = await page.evaluate(() => {
 273 |     const mainContent = document.querySelector('[data-testid="mainContent"]');
 274 |     if (!mainContent) return { found: false };
 275 | 
 276 |     let scrollContainer = mainContent.parentElement;
 277 |     while (scrollContainer) {
 278 |       const styles = window.getComputedStyle(scrollContainer);
 279 |       const hasOverflow =
 280 |         styles.overflow === "auto" ||
 281 |         styles.overflow === "scroll" ||
 282 |         styles.overflowY === "auto" ||
 283 |         styles.overflowY === "scroll";
 284 | 
 285 |       if (hasOverflow) {
 286 |         return {
 287 |           found: true,
 288 |           scrollbarGutter: styles.scrollbarGutter,
 289 |         };
 290 |       }
 291 |       scrollContainer = scrollContainer.parentElement;
 292 |     }
 293 | 
 294 |     return { found: false };
 295 |   });
 296 | 
 297 |   expect(info.found).toBe(true);
 298 |   if (shouldHaveGutters) {
 299 |     expect(info.scrollbarGutter).toBe("stable both-edges");
 300 |   } else {
 301 |     expect(info.scrollbarGutter).not.toBe("stable both-edges");
 302 |   }
 303 | }
 304 | 
 305 | // =============================================================================
 306 | // LAYOUT TESTS
 307 | // =============================================================================
 308 | // These tests verify that the App2 component correctly positions and displays
 309 | // its layout blocks (Header, NavPanel, Main Content, Footer) according to the
 310 | // layout configuration specified in app-next.md.
 311 | //
 312 | // Viewport: 1280 x 1080 for all tests
 313 | //
 314 | // Test Matrix:
 315 | // - scrollWholePage: true/false (determines scroll container: App Container vs Main Content)
 316 | // - noScrollbarGutters: true/false (determines scrollbar gutter reservation)
 317 | // - Content height: 200px (fits in viewport) vs 2000px (overflows viewport)
 318 | // - Scroll position: top, mid (33%), bottom (for overflow cases)
 319 | 
 320 | test.describe("Horizontal Layout - scrollWholePage=true, noScrollbarGutters=true", () => {
 321 |   test.beforeEach(async ({ page }) => {
 322 |     await page.setViewportSize({ width: 1280, height: 1080 });
 323 |   });
 324 | 
 325 |   test("renders header, nav panel, main content, and footer in correct positions", async ({
 326 |     initTestBed,
 327 |     page,
 328 |   }) => {
 329 |     await initTestBed(createLayoutMarkup("horizontal", true, true, "200px"));
 330 | 
 331 |     await verifyAllBlocksVisible(page);
 332 | 
 333 |     // Get bounding boxes to verify layout structure
 334 |     const header = page.getByTestId("appHeader");
 335 |     const navPanel = page.getByTestId("navPanel");
 336 |     const mainContent = page.getByTestId("mainContent");
 337 |     const footer = page.getByTestId("footer");
 338 | 
 339 |     const headerBox = await header.boundingBox();
 340 |     const navPanelBox = await navPanel.boundingBox();
 341 |     const mainContentBox = await mainContent.boundingBox();
 342 |     const footerBox = await footer.boundingBox();
 343 | 
 344 |     expect(headerBox).not.toBeNull();
 345 |     expect(navPanelBox).not.toBeNull();
 346 |     expect(mainContentBox).not.toBeNull();
 347 |     expect(footerBox).not.toBeNull();
 348 | 
 349 |     // Verify vertical stacking order
 350 |     expect(headerBox!.y).toBeLessThan(navPanelBox!.y);
 351 |     expect(navPanelBox!.y).toBeGreaterThan(headerBox!.y);
 352 |     expect(mainContentBox!.y).toBeGreaterThan(navPanelBox!.y + navPanelBox!.height);
 353 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
 354 | 
 355 |     // Verify full width blocks
 356 |     expect(headerBox!.width).toBeGreaterThan(1200);
 357 |     expect(navPanelBox!.width).toBeGreaterThan(1200);
 358 |     expect(footerBox!.width).toBeGreaterThan(1200);
 359 | 
 360 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 361 |     await verifyAppContainerScrollable(page, false);
 362 |     await verifyScrollbarGutters(page, false);
 363 |   });
 364 | 
 365 |   test("tall content at top: header and nav visible, footer outside viewport, app container scrolls", async ({
 366 |     initTestBed,
 367 |     page,
 368 |   }) => {
 369 |     await initTestBed(createLayoutMarkup("horizontal", true, true, "2000px"));
 370 | 
 371 |     await expect(page.getByTestId("mainContent")).toBeVisible();
 372 | 
 373 |     const initialScrollY = await page.evaluate(() => window.scrollY);
 374 |     expect(initialScrollY).toBe(0);
 375 | 
 376 |     await verifyAppContainerScrollable(page, true);
 377 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel"]);
 378 |     await verifyBlocksBelowViewport(page, ["footer"]);
 379 |   });
 380 | 
 381 |   test("tall content at mid-scroll: header and nav scrolled out, footer still below viewport", async ({
 382 |     initTestBed,
 383 |     page,
 384 |   }) => {
 385 |     await initTestBed(createLayoutMarkup("horizontal", true, true, "2000px"));
 386 | 
 387 |     await scrollAppContainerTo(page, "mid");
 388 | 
 389 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 390 |     await verifyBlocksBelowViewport(page, ["footer"]);
 391 |   });
 392 | 
 393 |   test("tall content at bottom: header and nav scrolled out, footer visible in viewport", async ({
 394 |     initTestBed,
 395 |     page,
 396 |   }) => {
 397 |     await initTestBed(createLayoutMarkup("horizontal", true, true, "2000px"));
 398 | 
 399 |     await scrollAppContainerTo(page, "bottom");
 400 | 
 401 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 402 |     await verifyBlocksInViewport(page, ["footer"]);
 403 |   });
 404 | });
 405 | 
 406 | test.describe("Horizontal Layout - scrollWholePage=true, noScrollbarGutters=false", () => {
 407 |   test.beforeEach(async ({ page }) => {
 408 |     await page.setViewportSize({ width: 1280, height: 1080 });
 409 |   });
 410 | 
 411 |   test("short content: all blocks visible, no scrollbar, gutters reserved", async ({
 412 |     initTestBed,
 413 |     page,
 414 |   }) => {
 415 |     await initTestBed(createLayoutMarkup("horizontal", false, true, "200px"));
 416 |     await verifyAllBlocksVisible(page);
 417 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
 418 |     await verifyAppContainerScrollable(page, false);
 419 |     await verifyScrollbarGutters(page, true);
 420 |   });
 421 | 
 422 |   test("tall content at top: app container scrolls with reserved gutters", async ({
 423 |     initTestBed,
 424 |     page,
 425 |   }) => {
 426 |     await initTestBed(createLayoutMarkup("horizontal", false, true, "2000px"));
 427 |     await verifyAllBlocksVisible(page);
 428 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel"]);
 429 |     await verifyBlocksBelowViewport(page, ["footer"]);
 430 |     await verifyAppContainerScrollable(page, true);
 431 |     await verifyScrollbarGutters(page, true);
 432 |   });
 433 | 
 434 |   test("tall content at mid-scroll: header and nav scrolled out, footer still below viewport", async ({
 435 |     initTestBed,
 436 |     page,
 437 |   }) => {
 438 |     await initTestBed(createLayoutMarkup("horizontal", false, true, "2000px"));
 439 |     await scrollAppContainerTo(page, "mid");
 440 |     await verifyAllBlocksVisible(page);
 441 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 442 |     await verifyBlocksBelowViewport(page, ["footer"]);
 443 |     await verifyScrollbarGutters(page, true);
 444 |   });
 445 | 
 446 |   test("tall content at bottom: header and nav scrolled out, footer visible", async ({
 447 |     initTestBed,
 448 |     page,
 449 |   }) => {
 450 |     await initTestBed(createLayoutMarkup("horizontal", false, true, "2000px"));
 451 |     await scrollAppContainerTo(page, "bottom");
 452 |     await verifyAllBlocksVisible(page);
 453 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 454 |     await verifyBlocksInViewport(page, ["footer"]);
 455 |     await verifyScrollbarGutters(page, true);
 456 |   });
 457 | });
 458 | 
 459 | test.describe("Horizontal Layout - scrollWholePage=false, noScrollbarGutters=true", () => {
 460 |   test.beforeEach(async ({ page }) => {
 461 |     await page.setViewportSize({ width: 1280, height: 1080 });
 462 |   });
 463 | 
 464 |   test("short content: all blocks visible, main content is scroll container, no gutters", async ({
 465 |     initTestBed,
 466 |     page,
 467 |   }) => {
 468 |     await initTestBed(createLayoutMarkup("horizontal", true, false, "200px"));
 469 |     await verifyAllBlocksVisible(page);
 470 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
 471 |     await verifyMainContentIsScrollContainer(page);
 472 |     await verifyAppContainerNotScrollable(page);
 473 |   });
 474 | 
 475 |   test("tall content at top: main content scrolls, header/footer static, no gutters", async ({
 476 |     initTestBed,
 477 |     page,
 478 |   }) => {
 479 |     await initTestBed(createLayoutMarkup("horizontal", true, false, "2000px"));
 480 |     await verifyAllBlocksVisible(page);
 481 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 482 |     await verifyMainContentIsScrollContainer(page);
 483 |     await verifyMainContentScrollbarGutters(page, false);
 484 |     await verifyAppContainerNotScrollable(page);
 485 |   });
 486 | 
 487 |   test("tall content at mid-scroll: only main content scrolls, header/footer remain static", async ({
 488 |     initTestBed,
 489 |     page,
 490 |   }) => {
 491 |     await initTestBed(createLayoutMarkup("horizontal", true, false, "2000px"));
 492 |     await scrollMainContentTo(page, "mid");
 493 |     await verifyAllBlocksVisible(page);
 494 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 495 |   });
 496 | 
 497 |   test("tall content at bottom: only main content scrolls, header/footer remain static", async ({
 498 |     initTestBed,
 499 |     page,
 500 |   }) => {
 501 |     await initTestBed(createLayoutMarkup("horizontal", true, false, "2000px"));
 502 |     await scrollMainContentTo(page, "bottom");
 503 |     await verifyAllBlocksVisible(page);
 504 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 505 |   });
 506 | });
 507 | 
 508 | test.describe("Horizontal Layout - scrollWholePage=false, noScrollbarGutters=false", () => {
 509 |   test.beforeEach(async ({ page }) => {
 510 |     await page.setViewportSize({ width: 1280, height: 1080 });
 511 |   });
 512 | 
 513 |   test("short content: main content is scroll container with reserved gutters", async ({
 514 |     initTestBed,
 515 |     page,
 516 |   }) => {
 517 |     await initTestBed(createLayoutMarkup("horizontal", false, false, "200px"));
 518 |     await verifyAllBlocksVisible(page);
 519 |     await verifyMainContentIsScrollContainer(page);
 520 |     await verifyMainContentScrollbarGutters(page, true);
 521 |   });
 522 | 
 523 |   test("tall content: main content scrolls with reserved gutters, header/footer static", async ({
 524 |     initTestBed,
 525 |     page,
 526 |   }) => {
 527 |     await initTestBed(createLayoutMarkup("horizontal", false, false, "2000px"));
 528 |     await verifyAllBlocksVisible(page);
 529 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 530 |     await verifyMainContentIsScrollContainer(page);
 531 |     await verifyMainContentScrollbarGutters(page, true);
 532 |   });
 533 | 
 534 |   test("tall content at mid-scroll: main content scrolls with gutters, header/footer remain static", async ({
 535 |     initTestBed,
 536 |     page,
 537 |   }) => {
 538 |     await initTestBed(createLayoutMarkup("horizontal", false, false, "2000px"));
 539 |     await scrollMainContentTo(page, "mid");
 540 |     await verifyAllBlocksVisible(page);
 541 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 542 |     await verifyMainContentScrollbarGutters(page, true);
 543 |   });
 544 | 
 545 |   test("tall content at bottom: main content scrolls with gutters, header/footer remain static", async ({
 546 |     initTestBed,
 547 |     page,
 548 |   }) => {
 549 |     await initTestBed(createLayoutMarkup("horizontal", false, false, "2000px"));
 550 |     await scrollMainContentTo(page, "bottom");
 551 |     await verifyAllBlocksVisible(page);
 552 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 553 |     await verifyMainContentScrollbarGutters(page, true);
 554 |   });
 555 | });
 556 | 
 557 | test.describe("Horizontal-Sticky Layout - scrollWholePage=true, noScrollbarGutters=true", () => {
 558 |   test.beforeEach(async ({ page }) => {
 559 |     await page.setViewportSize({ width: 1280, height: 1080 });
 560 |   });
 561 | 
 562 |   test("renders header, nav panel, main content, and footer in correct positions", async ({
 563 |     initTestBed,
 564 |     page,
 565 |   }) => {
 566 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, true, "200px"));
 567 | 
 568 |     await verifyAllBlocksVisible(page);
 569 | 
 570 |     // Get bounding boxes to verify layout structure
 571 |     const header = page.getByTestId("appHeader");
 572 |     const navPanel = page.getByTestId("navPanel");
 573 |     const mainContent = page.getByTestId("mainContent");
 574 |     const footer = page.getByTestId("footer");
 575 | 
 576 |     const headerBox = await header.boundingBox();
 577 |     const navPanelBox = await navPanel.boundingBox();
 578 |     const mainContentBox = await mainContent.boundingBox();
 579 |     const footerBox = await footer.boundingBox();
 580 | 
 581 |     expect(headerBox).not.toBeNull();
 582 |     expect(navPanelBox).not.toBeNull();
 583 |     expect(mainContentBox).not.toBeNull();
 584 |     expect(footerBox).not.toBeNull();
 585 | 
 586 |     // Verify vertical stacking order
 587 |     expect(headerBox!.y).toBeLessThan(navPanelBox!.y);
 588 |     expect(navPanelBox!.y).toBeGreaterThan(headerBox!.y);
 589 |     expect(mainContentBox!.y).toBeGreaterThan(navPanelBox!.y + navPanelBox!.height);
 590 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
 591 | 
 592 |     // Verify full width blocks
 593 |     expect(headerBox!.width).toBeGreaterThan(1200);
 594 |     expect(navPanelBox!.width).toBeGreaterThan(1200);
 595 |     expect(footerBox!.width).toBeGreaterThan(1200);
 596 | 
 597 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 598 |     await verifyAppContainerScrollable(page, false);
 599 |     await verifyScrollbarGutters(page, false);
 600 |   });
 601 | 
 602 |   test("tall content at top: header and nav sticky at top, footer outside viewport, app container scrolls", async ({
 603 |     initTestBed,
 604 |     page,
 605 |   }) => {
 606 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, true, "2000px"));
 607 | 
 608 |     await expect(page.getByTestId("mainContent")).toBeVisible();
 609 | 
 610 |     const initialScrollY = await page.evaluate(() => window.scrollY);
 611 |     expect(initialScrollY).toBe(0);
 612 | 
 613 |     await verifyAppContainerScrollable(page, true);
 614 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 615 |   });
 616 | 
 617 |   test("tall content at mid-scroll: header and nav remain sticky at top, footer sticky at bottom", async ({
 618 |     initTestBed,
 619 |     page,
 620 |   }) => {
 621 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, true, "2000px"));
 622 | 
 623 |     await scrollAppContainerTo(page, "mid");
 624 | 
 625 |     // Header, nav, and footer should all remain sticky and visible
 626 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 627 |   });
 628 | 
 629 |   test("tall content at bottom: header and nav remain sticky at top, footer visible in viewport", async ({
 630 |     initTestBed,
 631 |     page,
 632 |   }) => {
 633 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, true, "2000px"));
 634 | 
 635 |     await scrollAppContainerTo(page, "bottom");
 636 | 
 637 |     // Header and nav should remain sticky at top
 638 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 639 |   });
 640 | });
 641 | 
 642 | test.describe("Horizontal-Sticky Layout - scrollWholePage=true, noScrollbarGutters=false", () => {
 643 |   test.beforeEach(async ({ page }) => {
 644 |     await page.setViewportSize({ width: 1280, height: 1080 });
 645 |   });
 646 | 
 647 |   test("short content: all blocks visible, no scrollbar, gutters reserved", async ({
 648 |     initTestBed,
 649 |     page,
 650 |   }) => {
 651 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, true, "200px"));
 652 |     await verifyAllBlocksVisible(page);
 653 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
 654 |     await verifyAppContainerScrollable(page, false);
 655 |     await verifyScrollbarGutters(page, true);
 656 |   });
 657 | 
 658 |   test("tall content at top: app container scrolls with reserved gutters, header/nav/footer sticky", async ({
 659 |     initTestBed,
 660 |     page,
 661 |   }) => {
 662 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, true, "2000px"));
 663 |     await verifyAllBlocksVisible(page);
 664 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 665 |     await verifyAppContainerScrollable(page, true);
 666 |     await verifyScrollbarGutters(page, true);
 667 |   });
 668 | 
 669 |   test("tall content at mid-scroll: header and nav remain sticky, footer sticky at bottom", async ({
 670 |     initTestBed,
 671 |     page,
 672 |   }) => {
 673 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, true, "2000px"));
 674 |     await scrollAppContainerTo(page, "mid");
 675 |     await verifyAllBlocksVisible(page);
 676 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 677 |     await verifyScrollbarGutters(page, true);
 678 |   });
 679 | 
 680 |   test("tall content at bottom: header and nav remain sticky, footer visible", async ({
 681 |     initTestBed,
 682 |     page,
 683 |   }) => {
 684 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, true, "2000px"));
 685 |     await scrollAppContainerTo(page, "bottom");
 686 |     await verifyAllBlocksVisible(page);
 687 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 688 |     await verifyScrollbarGutters(page, true);
 689 |   });
 690 | });
 691 | 
 692 | test.describe("Horizontal-Sticky Layout - scrollWholePage=false, noScrollbarGutters=true", () => {
 693 |   test.beforeEach(async ({ page }) => {
 694 |     await page.setViewportSize({ width: 1280, height: 1080 });
 695 |   });
 696 | 
 697 |   test("short content: all blocks visible, main content is scroll container, no gutters", async ({
 698 |     initTestBed,
 699 |     page,
 700 |   }) => {
 701 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, false, "200px"));
 702 |     await verifyAllBlocksVisible(page);
 703 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
 704 |     await verifyMainContentIsScrollContainer(page);
 705 |     await verifyAppContainerNotScrollable(page);
 706 |   });
 707 | 
 708 |   test("tall content at top: main content scrolls, header/nav/footer sticky, no gutters", async ({
 709 |     initTestBed,
 710 |     page,
 711 |   }) => {
 712 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, false, "2000px"));
 713 |     await verifyAllBlocksVisible(page);
 714 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 715 |     await verifyMainContentIsScrollContainer(page);
 716 |     await verifyMainContentScrollbarGutters(page, false);
 717 |     await verifyAppContainerNotScrollable(page);
 718 |   });
 719 | 
 720 |   test("tall content at mid-scroll: only main content scrolls, header/nav/footer remain sticky", async ({
 721 |     initTestBed,
 722 |     page,
 723 |   }) => {
 724 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, false, "2000px"));
 725 |     await scrollMainContentTo(page, "mid");
 726 |     await verifyAllBlocksVisible(page);
 727 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 728 |   });
 729 | 
 730 |   test("tall content at bottom: only main content scrolls, header/nav/footer remain sticky", async ({
 731 |     initTestBed,
 732 |     page,
 733 |   }) => {
 734 |     await initTestBed(createLayoutMarkup("horizontal-sticky", true, false, "2000px"));
 735 |     await scrollMainContentTo(page, "bottom");
 736 |     await verifyAllBlocksVisible(page);
 737 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 738 |   });
 739 | });
 740 | 
 741 | test.describe("Horizontal-Sticky Layout - scrollWholePage=false, noScrollbarGutters=false", () => {
 742 |   test.beforeEach(async ({ page }) => {
 743 |     await page.setViewportSize({ width: 1280, height: 1080 });
 744 |   });
 745 | 
 746 |   test("short content: main content is scroll container with reserved gutters", async ({
 747 |     initTestBed,
 748 |     page,
 749 |   }) => {
 750 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, false, "200px"));
 751 |     await verifyAllBlocksVisible(page);
 752 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
 753 |     await verifyMainContentIsScrollContainer(page);
 754 |     await verifyMainContentScrollbarGutters(page, true);
 755 |     await verifyAppContainerNotScrollable(page);
 756 |   });
 757 | 
 758 |   test("tall content at top: main content scrolls with reserved gutters, header/nav/footer sticky", async ({
 759 |     initTestBed,
 760 |     page,
 761 |   }) => {
 762 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, false, "2000px"));
 763 |     await verifyAllBlocksVisible(page);
 764 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 765 |     await verifyMainContentIsScrollContainer(page);
 766 |     await verifyMainContentScrollbarGutters(page, true);
 767 |   });
 768 | 
 769 |   test("tall content at mid-scroll: only main content scrolls, header/nav/footer sticky", async ({
 770 |     initTestBed,
 771 |     page,
 772 |   }) => {
 773 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, false, "2000px"));
 774 |     await scrollMainContentTo(page, "mid");
 775 |     await verifyAllBlocksVisible(page);
 776 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 777 |   });
 778 | 
 779 |   test("tall content at bottom: only main content scrolls, header/nav/footer sticky", async ({
 780 |     initTestBed,
 781 |     page,
 782 |   }) => {
 783 |     await initTestBed(createLayoutMarkup("horizontal-sticky", false, false, "2000px"));
 784 |     await scrollMainContentTo(page, "bottom");
 785 |     await verifyAllBlocksVisible(page);
 786 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 787 |   });
 788 | });
 789 | 
 790 | test.describe("Condensed Layout - scrollWholePage=true, noScrollbarGutters=true", () => {
 791 |   test.beforeEach(async ({ page }) => {
 792 |     await page.setViewportSize({ width: 1280, height: 1080 });
 793 |   });
 794 | 
 795 |   test("renders header with embedded nav panel, main content, and footer in correct positions", async ({
 796 |     initTestBed,
 797 |     page,
 798 |   }) => {
 799 |     await initTestBed(createLayoutMarkup("condensed", true, true, "200px"));
 800 | 
 801 |     await verifyAllBlocksVisible(page);
 802 | 
 803 |     // Get bounding boxes to verify layout structure
 804 |     const header = page.getByTestId("appHeader");
 805 |     const navPanel = page.getByTestId("navPanel");
 806 |     const mainContent = page.getByTestId("mainContent");
 807 |     const footer = page.getByTestId("footer");
 808 | 
 809 |     const headerBox = await header.boundingBox();
 810 |     const navPanelBox = await navPanel.boundingBox();
 811 |     const mainContentBox = await mainContent.boundingBox();
 812 |     const footerBox = await footer.boundingBox();
 813 | 
 814 |     expect(headerBox).not.toBeNull();
 815 |     expect(navPanelBox).not.toBeNull();
 816 |     expect(mainContentBox).not.toBeNull();
 817 |     expect(footerBox).not.toBeNull();
 818 | 
 819 |     // Verify NavPanel is within header boundary (condensed layout characteristic)
 820 |     expect(navPanelBox!.y).toBeGreaterThanOrEqual(headerBox!.y);
 821 |     expect(navPanelBox!.y + navPanelBox!.height).toBeLessThanOrEqual(
 822 |       headerBox!.y + headerBox!.height
 823 |     );
 824 | 
 825 |     // Verify vertical stacking order
 826 |     expect(mainContentBox!.y).toBeGreaterThan(headerBox!.y + headerBox!.height);
 827 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
 828 | 
 829 |     // Verify full width blocks
 830 |     expect(headerBox!.width).toBeGreaterThan(1200);
 831 |     expect(footerBox!.width).toBeGreaterThan(1200);
 832 | 
 833 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 834 |     await verifyAppContainerScrollable(page, false);
 835 |     await verifyScrollbarGutters(page, false);
 836 |   });
 837 | 
 838 |   test("tall content at top: header with nav visible, footer outside viewport, app container scrolls", async ({
 839 |     initTestBed,
 840 |     page,
 841 |   }) => {
 842 |     await initTestBed(createLayoutMarkup("condensed", true, true, "2000px"));
 843 | 
 844 |     await expect(page.getByTestId("mainContent")).toBeVisible();
 845 | 
 846 |     const initialScrollY = await page.evaluate(() => window.scrollY);
 847 |     expect(initialScrollY).toBe(0);
 848 | 
 849 |     await verifyAppContainerScrollable(page, true);
 850 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel"]);
 851 |     await verifyBlocksBelowViewport(page, ["footer"]);
 852 |   });
 853 | 
 854 |   test("tall content at mid-scroll: header and nav scrolled out, footer still below viewport", async ({
 855 |     initTestBed,
 856 |     page,
 857 |   }) => {
 858 |     await initTestBed(createLayoutMarkup("condensed", true, true, "2000px"));
 859 | 
 860 |     await scrollAppContainerTo(page, "mid");
 861 | 
 862 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 863 |     await verifyBlocksBelowViewport(page, ["footer"]);
 864 |   });
 865 | 
 866 |   test("tall content at bottom: header and nav scrolled out, footer visible in viewport", async ({
 867 |     initTestBed,
 868 |     page,
 869 |   }) => {
 870 |     await initTestBed(createLayoutMarkup("condensed", true, true, "2000px"));
 871 | 
 872 |     await scrollAppContainerTo(page, "bottom");
 873 | 
 874 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 875 |     await verifyBlocksInViewport(page, ["footer"]);
 876 |   });
 877 | });
 878 | 
 879 | test.describe("Condensed Layout - scrollWholePage=true, noScrollbarGutters=false", () => {
 880 |   test.beforeEach(async ({ page }) => {
 881 |     await page.setViewportSize({ width: 1280, height: 1080 });
 882 |   });
 883 | 
 884 |   test("short content: all blocks visible, no scrollbar, gutters reserved", async ({
 885 |     initTestBed,
 886 |     page,
 887 |   }) => {
 888 |     await initTestBed(createLayoutMarkup("condensed", false, true, "200px"));
 889 |     await verifyAllBlocksVisible(page);
 890 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
 891 |     await verifyAppContainerScrollable(page, false);
 892 |     await verifyScrollbarGutters(page, true);
 893 |   });
 894 | 
 895 |   test("tall content at top: app container scrolls with reserved gutters", async ({
 896 |     initTestBed,
 897 |     page,
 898 |   }) => {
 899 |     await initTestBed(createLayoutMarkup("condensed", false, true, "2000px"));
 900 |     await verifyAllBlocksVisible(page);
 901 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel"]);
 902 |     await verifyBlocksBelowViewport(page, ["footer"]);
 903 |     await verifyAppContainerScrollable(page, true);
 904 |     await verifyScrollbarGutters(page, true);
 905 |   });
 906 | 
 907 |   test("tall content at mid-scroll: header and nav scrolled out, footer still below viewport", async ({
 908 |     initTestBed,
 909 |     page,
 910 |   }) => {
 911 |     await initTestBed(createLayoutMarkup("condensed", false, true, "2000px"));
 912 |     await scrollAppContainerTo(page, "mid");
 913 |     await verifyAllBlocksVisible(page);
 914 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 915 |     await verifyBlocksBelowViewport(page, ["footer"]);
 916 |     await verifyScrollbarGutters(page, true);
 917 |   });
 918 | 
 919 |   test("tall content at bottom: header and nav scrolled out, footer visible", async ({
 920 |     initTestBed,
 921 |     page,
 922 |   }) => {
 923 |     await initTestBed(createLayoutMarkup("condensed", false, true, "2000px"));
 924 |     await scrollAppContainerTo(page, "bottom");
 925 |     await verifyAllBlocksVisible(page);
 926 |     await verifyBlocksAboveViewport(page, ["appHeader", "navPanel"]);
 927 |     await verifyBlocksInViewport(page, ["footer"]);
 928 |     await verifyScrollbarGutters(page, true);
 929 |   });
 930 | });
 931 | 
 932 | test.describe("Condensed Layout - scrollWholePage=false, noScrollbarGutters=true", () => {
 933 |   test.beforeEach(async ({ page }) => {
 934 |     await page.setViewportSize({ width: 1280, height: 1080 });
 935 |   });
 936 | 
 937 |   test("short content: all blocks visible, main content is scroll container, no gutters", async ({
 938 |     initTestBed,
 939 |     page,
 940 |   }) => {
 941 |     await initTestBed(createLayoutMarkup("condensed", true, false, "200px"));
 942 |     await verifyAllBlocksVisible(page);
 943 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
 944 |     await verifyMainContentIsScrollContainer(page);
 945 |     await verifyAppContainerNotScrollable(page);
 946 |   });
 947 | 
 948 |   test("tall content at top: main content scrolls, header/footer static, no gutters", async ({
 949 |     initTestBed,
 950 |     page,
 951 |   }) => {
 952 |     await initTestBed(createLayoutMarkup("condensed", true, false, "2000px"));
 953 |     await verifyAllBlocksVisible(page);
 954 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 955 |     await verifyMainContentIsScrollContainer(page);
 956 |     await verifyMainContentScrollbarGutters(page, false);
 957 |     await verifyAppContainerNotScrollable(page);
 958 |   });
 959 | 
 960 |   test("tall content at mid-scroll: only main content scrolls, header/footer remain static", async ({
 961 |     initTestBed,
 962 |     page,
 963 |   }) => {
 964 |     await initTestBed(createLayoutMarkup("condensed", true, false, "2000px"));
 965 |     await scrollMainContentTo(page, "mid");
 966 |     await verifyAllBlocksVisible(page);
 967 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 968 |   });
 969 | 
 970 |   test("tall content at bottom: only main content scrolls, header/footer remain static", async ({
 971 |     initTestBed,
 972 |     page,
 973 |   }) => {
 974 |     await initTestBed(createLayoutMarkup("condensed", true, false, "2000px"));
 975 |     await scrollMainContentTo(page, "bottom");
 976 |     await verifyAllBlocksVisible(page);
 977 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
 978 |   });
 979 | });
 980 | 
 981 | test.describe("Condensed Layout - scrollWholePage=false, noScrollbarGutters=false", () => {
 982 |   test.beforeEach(async ({ page }) => {
 983 |     await page.setViewportSize({ width: 1280, height: 1080 });
 984 |   });
 985 | 
 986 |   test("short content: main content is scroll container with reserved gutters", async ({
 987 |     initTestBed,
 988 |     page,
 989 |   }) => {
 990 |     await initTestBed(createLayoutMarkup("condensed", false, false, "200px"));
 991 |     await verifyAllBlocksVisible(page);
 992 |     await verifyMainContentIsScrollContainer(page);
 993 |     await verifyMainContentScrollbarGutters(page, true);
 994 |   });
 995 | 
 996 |   test("tall content: main content scrolls with reserved gutters, header/footer static", async ({
 997 |     initTestBed,
 998 |     page,
 999 |   }) => {
1000 |     await initTestBed(createLayoutMarkup("condensed", false, false, "2000px"));
1001 |     await verifyAllBlocksVisible(page);
1002 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1003 |     await verifyMainContentIsScrollContainer(page);
1004 |     await verifyMainContentScrollbarGutters(page, true);
1005 |   });
1006 | 
1007 |   test("tall content at mid-scroll: main content scrolls with gutters, header/footer remain static", async ({
1008 |     initTestBed,
1009 |     page,
1010 |   }) => {
1011 |     await initTestBed(createLayoutMarkup("condensed", false, false, "2000px"));
1012 |     await scrollMainContentTo(page, "mid");
1013 |     await verifyAllBlocksVisible(page);
1014 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1015 |     await verifyMainContentScrollbarGutters(page, true);
1016 |   });
1017 | 
1018 |   test("tall content at bottom: main content scrolls with gutters, header/footer remain static", async ({
1019 |     initTestBed,
1020 |     page,
1021 |   }) => {
1022 |     await initTestBed(createLayoutMarkup("condensed", false, false, "2000px"));
1023 |     await scrollMainContentTo(page, "bottom");
1024 |     await verifyAllBlocksVisible(page);
1025 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1026 |     await verifyMainContentScrollbarGutters(page, true);
1027 |   });
1028 | });
1029 | 
1030 | test.describe("Condensed-Sticky Layout - scrollWholePage=true, noScrollbarGutters=true", () => {
1031 |   test.beforeEach(async ({ page }) => {
1032 |     await page.setViewportSize({ width: 1280, height: 1080 });
1033 |   });
1034 | 
1035 |   test("renders header with embedded nav panel, main content, and footer in correct positions", async ({
1036 |     initTestBed,
1037 |     page,
1038 |   }) => {
1039 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, true, "200px"));
1040 | 
1041 |     await verifyAllBlocksVisible(page);
1042 | 
1043 |     // Get bounding boxes to verify layout structure
1044 |     const header = page.getByTestId("appHeader");
1045 |     const navPanel = page.getByTestId("navPanel");
1046 |     const mainContent = page.getByTestId("mainContent");
1047 |     const footer = page.getByTestId("footer");
1048 | 
1049 |     const headerBox = await header.boundingBox();
1050 |     const navPanelBox = await navPanel.boundingBox();
1051 |     const mainContentBox = await mainContent.boundingBox();
1052 |     const footerBox = await footer.boundingBox();
1053 | 
1054 |     expect(headerBox).not.toBeNull();
1055 |     expect(navPanelBox).not.toBeNull();
1056 |     expect(mainContentBox).not.toBeNull();
1057 |     expect(footerBox).not.toBeNull();
1058 | 
1059 |     // Verify NavPanel is within header boundary (condensed layout characteristic)
1060 |     expect(navPanelBox!.y).toBeGreaterThanOrEqual(headerBox!.y);
1061 |     expect(navPanelBox!.y + navPanelBox!.height).toBeLessThanOrEqual(
1062 |       headerBox!.y + headerBox!.height
1063 |     );
1064 | 
1065 |     // Verify vertical stacking order
1066 |     expect(mainContentBox!.y).toBeGreaterThan(headerBox!.y + headerBox!.height);
1067 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1068 | 
1069 |     // Verify full width blocks
1070 |     expect(headerBox!.width).toBeGreaterThan(1200);
1071 |     expect(footerBox!.width).toBeGreaterThan(1200);
1072 | 
1073 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1074 |     await verifyAppContainerScrollable(page, false);
1075 |     await verifyScrollbarGutters(page, false);
1076 |   });
1077 | 
1078 |   test("tall content at top: header/nav sticky at top, footer sticky at bottom, app container scrolls", async ({
1079 |     initTestBed,
1080 |     page,
1081 |   }) => {
1082 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, true, "2000px"));
1083 | 
1084 |     await expect(page.getByTestId("mainContent")).toBeVisible();
1085 | 
1086 |     const initialScrollY = await page.evaluate(() => window.scrollY);
1087 |     expect(initialScrollY).toBe(0);
1088 | 
1089 |     await verifyAppContainerScrollable(page, true);
1090 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1091 |   });
1092 | 
1093 |   test("tall content at mid-scroll: header/nav remain sticky at top, footer sticky at bottom", async ({
1094 |     initTestBed,
1095 |     page,
1096 |   }) => {
1097 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, true, "2000px"));
1098 | 
1099 |     await scrollAppContainerTo(page, "mid");
1100 | 
1101 |     // Header, nav, and footer should all remain sticky and visible
1102 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1103 |   });
1104 | 
1105 |   test("tall content at bottom: header/nav remain sticky at top, footer visible in viewport", async ({
1106 |     initTestBed,
1107 |     page,
1108 |   }) => {
1109 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, true, "2000px"));
1110 | 
1111 |     await scrollAppContainerTo(page, "bottom");
1112 | 
1113 |     // Header, nav, and footer should all remain sticky and visible
1114 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1115 |   });
1116 | });
1117 | 
1118 | test.describe("Condensed-Sticky Layout - scrollWholePage=true, noScrollbarGutters=false", () => {
1119 |   test.beforeEach(async ({ page }) => {
1120 |     await page.setViewportSize({ width: 1280, height: 1080 });
1121 |   });
1122 | 
1123 |   test("short content: all blocks visible, no scrollbar, gutters reserved", async ({
1124 |     initTestBed,
1125 |     page,
1126 |   }) => {
1127 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, true, "200px"));
1128 |     await verifyAllBlocksVisible(page);
1129 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
1130 |     await verifyAppContainerScrollable(page, false);
1131 |     await verifyScrollbarGutters(page, true);
1132 |   });
1133 | 
1134 |   test("tall content at top: app container scrolls with reserved gutters, header/nav/footer sticky", async ({
1135 |     initTestBed,
1136 |     page,
1137 |   }) => {
1138 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, true, "2000px"));
1139 |     await verifyAllBlocksVisible(page);
1140 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1141 |     await verifyAppContainerScrollable(page, true);
1142 |     await verifyScrollbarGutters(page, true);
1143 |   });
1144 | 
1145 |   test("tall content at mid-scroll: header/nav remain sticky, footer sticky at bottom", async ({
1146 |     initTestBed,
1147 |     page,
1148 |   }) => {
1149 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, true, "2000px"));
1150 |     await scrollAppContainerTo(page, "mid");
1151 |     await verifyAllBlocksVisible(page);
1152 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1153 |     await verifyScrollbarGutters(page, true);
1154 |   });
1155 | 
1156 |   test("tall content at bottom: header/nav remain sticky, footer visible", async ({
1157 |     initTestBed,
1158 |     page,
1159 |   }) => {
1160 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, true, "2000px"));
1161 |     await scrollAppContainerTo(page, "bottom");
1162 |     await verifyAllBlocksVisible(page);
1163 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1164 |     await verifyScrollbarGutters(page, true);
1165 |   });
1166 | });
1167 | 
1168 | test.describe("Condensed-Sticky Layout - scrollWholePage=false, noScrollbarGutters=true", () => {
1169 |   test.beforeEach(async ({ page }) => {
1170 |     await page.setViewportSize({ width: 1280, height: 1080 });
1171 |   });
1172 | 
1173 |   test("short content: all blocks visible, main content is scroll container, no gutters", async ({
1174 |     initTestBed,
1175 |     page,
1176 |   }) => {
1177 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, false, "200px"));
1178 |     await verifyAllBlocksVisible(page);
1179 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
1180 |     await verifyMainContentIsScrollContainer(page);
1181 |     await verifyAppContainerNotScrollable(page);
1182 |   });
1183 | 
1184 |   test("tall content at top: main content scrolls, header/nav/footer sticky, no gutters", async ({
1185 |     initTestBed,
1186 |     page,
1187 |   }) => {
1188 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, false, "2000px"));
1189 |     await verifyAllBlocksVisible(page);
1190 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1191 |     await verifyMainContentIsScrollContainer(page);
1192 |     await verifyMainContentScrollbarGutters(page, false);
1193 |     await verifyAppContainerNotScrollable(page);
1194 |   });
1195 | 
1196 |   test("tall content at mid-scroll: only main content scrolls, header/nav/footer remain sticky", async ({
1197 |     initTestBed,
1198 |     page,
1199 |   }) => {
1200 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, false, "2000px"));
1201 |     await scrollMainContentTo(page, "mid");
1202 |     await verifyAllBlocksVisible(page);
1203 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1204 |   });
1205 | 
1206 |   test("tall content at bottom: only main content scrolls, header/nav/footer remain sticky", async ({
1207 |     initTestBed,
1208 |     page,
1209 |   }) => {
1210 |     await initTestBed(createLayoutMarkup("condensed-sticky", true, false, "2000px"));
1211 |     await scrollMainContentTo(page, "bottom");
1212 |     await verifyAllBlocksVisible(page);
1213 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1214 |   });
1215 | });
1216 | 
1217 | test.describe("Condensed-Sticky Layout - scrollWholePage=false, noScrollbarGutters=false", () => {
1218 |   test.beforeEach(async ({ page }) => {
1219 |     await page.setViewportSize({ width: 1280, height: 1080 });
1220 |   });
1221 | 
1222 |   test("short content: main content is scroll container with reserved gutters", async ({
1223 |     initTestBed,
1224 |     page,
1225 |   }) => {
1226 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, false, "200px"));
1227 |     await verifyAllBlocksVisible(page);
1228 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "mainContent", "footer"]);
1229 |     await verifyMainContentIsScrollContainer(page);
1230 |     await verifyMainContentScrollbarGutters(page, true);
1231 |     await verifyAppContainerNotScrollable(page);
1232 |   });
1233 | 
1234 |   test("tall content at top: main content scrolls with reserved gutters, header/nav/footer sticky", async ({
1235 |     initTestBed,
1236 |     page,
1237 |   }) => {
1238 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, false, "2000px"));
1239 |     await verifyAllBlocksVisible(page);
1240 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1241 |     await verifyMainContentIsScrollContainer(page);
1242 |     await verifyMainContentScrollbarGutters(page, true);
1243 |   });
1244 | 
1245 |   test("tall content at mid-scroll: only main content scrolls, header/nav/footer sticky", async ({
1246 |     initTestBed,
1247 |     page,
1248 |   }) => {
1249 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, false, "2000px"));
1250 |     await scrollMainContentTo(page, "mid");
1251 |     await verifyAllBlocksVisible(page);
1252 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1253 |   });
1254 | 
1255 |   test("tall content at bottom: only main content scrolls, header/nav/footer sticky", async ({
1256 |     initTestBed,
1257 |     page,
1258 |   }) => {
1259 |     await initTestBed(createLayoutMarkup("condensed-sticky", false, false, "2000px"));
1260 |     await scrollMainContentTo(page, "bottom");
1261 |     await verifyAllBlocksVisible(page);
1262 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1263 |   });
1264 | });
1265 | 
1266 | test.describe("Vertical Layout - scrollWholePage=true, noScrollbarGutters=true", () => {
1267 |   test.beforeEach(async ({ page }) => {
1268 |     await page.setViewportSize({ width: 1280, height: 1080 });
1269 |   });
1270 | 
1271 |   test("renders header, nav panel on left, main content, and footer in correct positions", async ({
1272 |     initTestBed,
1273 |     page,
1274 |   }) => {
1275 |     await initTestBed(createLayoutMarkup("vertical", true, true, "200px"));
1276 | 
1277 |     await verifyAllBlocksVisible(page);
1278 | 
1279 |     // Get bounding boxes to verify layout structure
1280 |     const header = page.getByTestId("appHeader");
1281 |     const navPanel = page.getByTestId("navPanel");
1282 |     const mainContent = page.getByTestId("mainContent");
1283 |     const footer = page.getByTestId("footer");
1284 | 
1285 |     const headerBox = await header.boundingBox();
1286 |     const navPanelBox = await navPanel.boundingBox();
1287 |     const mainContentBox = await mainContent.boundingBox();
1288 |     const footerBox = await footer.boundingBox();
1289 | 
1290 |     expect(headerBox).not.toBeNull();
1291 |     expect(navPanelBox).not.toBeNull();
1292 |     expect(mainContentBox).not.toBeNull();
1293 |     expect(footerBox).not.toBeNull();
1294 | 
1295 |     // Verify vertical layout: NavPanel on left, content on right
1296 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1297 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1298 | 
1299 |     // Verify header is above the nav/content row
1300 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1301 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1302 | 
1303 |     // Verify footer is below the nav/content row
1304 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1305 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1306 | 
1307 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1308 |     await verifyAppContainerScrollable(page, false);
1309 |     await verifyScrollbarGutters(page, false);
1310 |   });
1311 | 
1312 |   test("tall content at top: header and nav visible, footer outside viewport, app container scrolls", async ({
1313 |     initTestBed,
1314 |     page,
1315 |   }) => {
1316 |     await initTestBed(createLayoutMarkup("vertical", true, true, "2000px"));
1317 | 
1318 |     await expect(page.getByTestId("mainContent")).toBeVisible();
1319 | 
1320 |     const initialScrollY = await page.evaluate(() => window.scrollY);
1321 |     expect(initialScrollY).toBe(0);
1322 | 
1323 |     await verifyAppContainerScrollable(page, true);
1324 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel"]);
1325 |     await verifyBlocksBelowViewport(page, ["footer"]);
1326 |   });
1327 | 
1328 |   test("tall content at mid-scroll: header scrolled out, nav visible (full height), footer below viewport", async ({
1329 |     initTestBed,
1330 |     page,
1331 |   }) => {
1332 |     await initTestBed(createLayoutMarkup("vertical", true, true, "2000px"));
1333 | 
1334 |     await scrollAppContainerTo(page, "mid");
1335 | 
1336 |     await verifyBlocksAboveViewport(page, ["appHeader"]);
1337 |     await verifyBlocksBelowViewport(page, ["footer"]);
1338 |     // NavPanel remains visible - it spans full viewport height on the left
1339 |     await verifyBlocksInViewport(page, ["navPanel"]);
1340 |   });
1341 | 
1342 |   test("tall content at bottom: header scrolled out, nav visible (full height), footer visible", async ({
1343 |     initTestBed,
1344 |     page,
1345 |   }) => {
1346 |     await initTestBed(createLayoutMarkup("vertical", true, true, "2000px"));
1347 | 
1348 |     await scrollAppContainerTo(page, "bottom");
1349 | 
1350 |     await verifyBlocksAboveViewport(page, ["appHeader"]);
1351 |     await verifyBlocksInViewport(page, ["navPanel", "footer"]);
1352 |   });
1353 | });
1354 | 
1355 | test.describe("Vertical Layout - scrollWholePage=true, noScrollbarGutters=false", () => {
1356 |   test.beforeEach(async ({ page }) => {
1357 |     await page.setViewportSize({ width: 1280, height: 1080 });
1358 |   });
1359 | 
1360 |   test("short content: all blocks visible, no scrollbar, gutters reserved", async ({
1361 |     initTestBed,
1362 |     page,
1363 |   }) => {
1364 |     await initTestBed(createLayoutMarkup("vertical", false, true, "200px"));
1365 | 
1366 |     await verifyAllBlocksVisible(page);
1367 | 
1368 |     // Get bounding boxes to verify layout structure
1369 |     const header = page.getByTestId("appHeader");
1370 |     const navPanel = page.getByTestId("navPanel");
1371 |     const mainContent = page.getByTestId("mainContent");
1372 |     const footer = page.getByTestId("footer");
1373 | 
1374 |     const headerBox = await header.boundingBox();
1375 |     const navPanelBox = await navPanel.boundingBox();
1376 |     const mainContentBox = await mainContent.boundingBox();
1377 |     const footerBox = await footer.boundingBox();
1378 | 
1379 |     expect(headerBox).not.toBeNull();
1380 |     expect(navPanelBox).not.toBeNull();
1381 |     expect(mainContentBox).not.toBeNull();
1382 |     expect(footerBox).not.toBeNull();
1383 | 
1384 |     // Verify vertical layout: NavPanel on left, content on right
1385 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1386 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1387 | 
1388 |     // Verify header is above the nav/content row
1389 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1390 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1391 | 
1392 |     // Verify footer is below the nav/content row
1393 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1394 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1395 | 
1396 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1397 |     await verifyAppContainerScrollable(page, false);
1398 |     await verifyScrollbarGutters(page, true);
1399 |   });
1400 | 
1401 |   test("tall content at top: app container scrolls with reserved gutters", async ({
1402 |     initTestBed,
1403 |     page,
1404 |   }) => {
1405 |     await initTestBed(createLayoutMarkup("vertical", false, true, "2000px"));
1406 |     await verifyAllBlocksVisible(page);
1407 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel"]);
1408 |     await verifyBlocksBelowViewport(page, ["footer"]);
1409 |     await verifyAppContainerScrollable(page, true);
1410 |     await verifyScrollbarGutters(page, true);
1411 |   });
1412 | 
1413 |   test("tall content at mid-scroll: header scrolled out, nav visible (full height), footer below viewport", async ({
1414 |     initTestBed,
1415 |     page,
1416 |   }) => {
1417 |     await initTestBed(createLayoutMarkup("vertical", false, true, "2000px"));
1418 |     await scrollAppContainerTo(page, "mid");
1419 |     await verifyAllBlocksVisible(page);
1420 |     await verifyBlocksAboveViewport(page, ["appHeader"]);
1421 |     await verifyBlocksBelowViewport(page, ["footer"]);
1422 |     await verifyScrollbarGutters(page, true);
1423 |     await verifyBlocksInViewport(page, ["navPanel"]);
1424 |   });
1425 | 
1426 |   test("tall content at bottom: header scrolled out, nav visible (full height), footer visible", async ({
1427 |     initTestBed,
1428 |     page,
1429 |   }) => {
1430 |     await initTestBed(createLayoutMarkup("vertical", false, true, "2000px"));
1431 |     await scrollAppContainerTo(page, "bottom");
1432 |     await verifyAllBlocksVisible(page);
1433 |     await verifyBlocksAboveViewport(page, ["appHeader"]);
1434 |     await verifyBlocksInViewport(page, ["navPanel", "footer"]);
1435 |     await verifyScrollbarGutters(page, true);
1436 |   });
1437 | });
1438 | 
1439 | test.describe("Vertical Layout - scrollWholePage=false, noScrollbarGutters=true", () => {
1440 |   test.beforeEach(async ({ page }) => {
1441 |     await page.setViewportSize({ width: 1280, height: 1080 });
1442 |   });
1443 | 
1444 |   test("short content: all blocks visible, main content is scroll container, no gutters", async ({
1445 |     initTestBed,
1446 |     page,
1447 |   }) => {
1448 |     await initTestBed(createLayoutMarkup("vertical", true, false, "200px"));
1449 | 
1450 |     await verifyAllBlocksVisible(page);
1451 | 
1452 |     // Get bounding boxes to verify layout structure
1453 |     const header = page.getByTestId("appHeader");
1454 |     const navPanel = page.getByTestId("navPanel");
1455 |     const mainContent = page.getByTestId("mainContent");
1456 |     const footer = page.getByTestId("footer");
1457 | 
1458 |     const headerBox = await header.boundingBox();
1459 |     const navPanelBox = await navPanel.boundingBox();
1460 |     const mainContentBox = await mainContent.boundingBox();
1461 |     const footerBox = await footer.boundingBox();
1462 | 
1463 |     expect(headerBox).not.toBeNull();
1464 |     expect(navPanelBox).not.toBeNull();
1465 |     expect(mainContentBox).not.toBeNull();
1466 |     expect(footerBox).not.toBeNull();
1467 | 
1468 |     // Verify vertical layout: NavPanel on left, content on right
1469 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1470 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1471 | 
1472 |     // Verify header is above the nav/content row
1473 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1474 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1475 | 
1476 |     // Verify footer is below the nav/content row
1477 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1478 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1479 | 
1480 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1481 |     await verifyMainContentIsScrollContainer(page);
1482 |     await verifyAppContainerNotScrollable(page);
1483 |   });
1484 | 
1485 |   test("tall content at top: main content scrolls, header/nav/footer static, no gutters", async ({
1486 |     initTestBed,
1487 |     page,
1488 |   }) => {
1489 |     await initTestBed(createLayoutMarkup("vertical", true, false, "2000px"));
1490 |     await verifyAllBlocksVisible(page);
1491 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1492 |     await verifyMainContentIsScrollContainer(page);
1493 |     await verifyMainContentScrollbarGutters(page, false);
1494 |     await verifyAppContainerNotScrollable(page);
1495 |   });
1496 | 
1497 |   test("tall content at mid-scroll: only main content scrolls, header/nav/footer remain static", async ({
1498 |     initTestBed,
1499 |     page,
1500 |   }) => {
1501 |     await initTestBed(createLayoutMarkup("vertical", true, false, "2000px"));
1502 |     await scrollMainContentTo(page, "mid");
1503 |     await verifyAllBlocksVisible(page);
1504 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1505 |   });
1506 | 
1507 |   test("tall content at bottom: only main content scrolls, header/nav/footer remain static", async ({
1508 |     initTestBed,
1509 |     page,
1510 |   }) => {
1511 |     await initTestBed(createLayoutMarkup("vertical", true, false, "2000px"));
1512 |     await scrollMainContentTo(page, "bottom");
1513 |     await verifyAllBlocksVisible(page);
1514 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1515 |   });
1516 | });
1517 | 
1518 | test.describe("Vertical Layout - scrollWholePage=false, noScrollbarGutters=false", () => {
1519 |   test.beforeEach(async ({ page }) => {
1520 |     await page.setViewportSize({ width: 1280, height: 1080 });
1521 |   });
1522 | 
1523 |   test("short content: main content is scroll container with reserved gutters", async ({
1524 |     initTestBed,
1525 |     page,
1526 |   }) => {
1527 |     await initTestBed(createLayoutMarkup("vertical", false, false, "200px"));
1528 | 
1529 |     await verifyAllBlocksVisible(page);
1530 | 
1531 |     // Get bounding boxes to verify layout structure
1532 |     const header = page.getByTestId("appHeader");
1533 |     const navPanel = page.getByTestId("navPanel");
1534 |     const mainContent = page.getByTestId("mainContent");
1535 |     const footer = page.getByTestId("footer");
1536 | 
1537 |     const headerBox = await header.boundingBox();
1538 |     const navPanelBox = await navPanel.boundingBox();
1539 |     const mainContentBox = await mainContent.boundingBox();
1540 |     const footerBox = await footer.boundingBox();
1541 | 
1542 |     expect(headerBox).not.toBeNull();
1543 |     expect(navPanelBox).not.toBeNull();
1544 |     expect(mainContentBox).not.toBeNull();
1545 |     expect(footerBox).not.toBeNull();
1546 | 
1547 |     // Verify vertical layout: NavPanel on left, content on right
1548 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1549 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1550 | 
1551 |     // Verify header is above the nav/content row
1552 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1553 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1554 | 
1555 |     // Verify footer is below the nav/content row
1556 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1557 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1558 | 
1559 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1560 |     await verifyMainContentIsScrollContainer(page);
1561 |     await verifyMainContentScrollbarGutters(page, true);
1562 |   });
1563 | 
1564 |   test("tall content: main content scrolls with reserved gutters, header/nav/footer static", async ({
1565 |     initTestBed,
1566 |     page,
1567 |   }) => {
1568 |     await initTestBed(createLayoutMarkup("vertical", false, false, "2000px"));
1569 |     await verifyAllBlocksVisible(page);
1570 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1571 |     await verifyMainContentIsScrollContainer(page);
1572 |     await verifyMainContentScrollbarGutters(page, true);
1573 |   });
1574 | 
1575 |   test("tall content at mid-scroll: main content scrolls with gutters, header/nav/footer remain static", async ({
1576 |     initTestBed,
1577 |     page,
1578 |   }) => {
1579 |     await initTestBed(createLayoutMarkup("vertical", false, false, "2000px"));
1580 |     await scrollMainContentTo(page, "mid");
1581 |     await verifyAllBlocksVisible(page);
1582 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1583 |     await verifyMainContentScrollbarGutters(page, true);
1584 |   });
1585 | 
1586 |   test("tall content at bottom: main content scrolls with gutters, header/nav/footer remain static", async ({
1587 |     initTestBed,
1588 |     page,
1589 |   }) => {
1590 |     await initTestBed(createLayoutMarkup("vertical", false, false, "2000px"));
1591 |     await scrollMainContentTo(page, "bottom");
1592 |     await verifyAllBlocksVisible(page);
1593 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1594 |     await verifyMainContentScrollbarGutters(page, true);
1595 |   });
1596 | });
1597 | 
1598 | test.describe("Vertical-Sticky Layout - scrollWholePage=true, noScrollbarGutters=true", () => {
1599 |   test.beforeEach(async ({ page }) => {
1600 |     await page.setViewportSize({ width: 1280, height: 1080 });
1601 |   });
1602 | 
1603 |   test("renders header, nav panel on left, main content, and footer in correct positions", async ({
1604 |     initTestBed,
1605 |     page,
1606 |   }) => {
1607 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, true, "200px"));
1608 | 
1609 |     await verifyAllBlocksVisible(page);
1610 | 
1611 |     // Get bounding boxes to verify layout structure
1612 |     const header = page.getByTestId("appHeader");
1613 |     const navPanel = page.getByTestId("navPanel");
1614 |     const mainContent = page.getByTestId("mainContent");
1615 |     const footer = page.getByTestId("footer");
1616 | 
1617 |     const headerBox = await header.boundingBox();
1618 |     const navPanelBox = await navPanel.boundingBox();
1619 |     const mainContentBox = await mainContent.boundingBox();
1620 |     const footerBox = await footer.boundingBox();
1621 | 
1622 |     expect(headerBox).not.toBeNull();
1623 |     expect(navPanelBox).not.toBeNull();
1624 |     expect(mainContentBox).not.toBeNull();
1625 |     expect(footerBox).not.toBeNull();
1626 | 
1627 |     // Verify vertical layout: NavPanel on left, content on right
1628 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1629 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1630 | 
1631 |     // Verify header is above the nav/content row
1632 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1633 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1634 | 
1635 |     // Verify footer is below the nav/content row
1636 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1637 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1638 | 
1639 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1640 |     await verifyAppContainerScrollable(page, false);
1641 |     await verifyScrollbarGutters(page, false);
1642 |   });
1643 | 
1644 |   test("tall content at top: header/footer sticky, nav visible (full height), app container scrolls", async ({
1645 |     initTestBed,
1646 |     page,
1647 |   }) => {
1648 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, true, "2000px"));
1649 | 
1650 |     await expect(page.getByTestId("mainContent")).toBeVisible();
1651 | 
1652 |     const initialScrollY = await page.evaluate(() => window.scrollY);
1653 |     expect(initialScrollY).toBe(0);
1654 | 
1655 |     await verifyAppContainerScrollable(page, true);
1656 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1657 |   });
1658 | 
1659 |   test("tall content at mid-scroll: header/footer sticky, nav visible (full height)", async ({
1660 |     initTestBed,
1661 |     page,
1662 |   }) => {
1663 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, true, "2000px"));
1664 | 
1665 |     await scrollAppContainerTo(page, "mid");
1666 | 
1667 |     // Header, nav, and footer should all remain sticky and visible
1668 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1669 |   });
1670 | 
1671 |   test("tall content at bottom: header/footer sticky, nav visible (full height)", async ({
1672 |     initTestBed,
1673 |     page,
1674 |   }) => {
1675 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, true, "2000px"));
1676 | 
1677 |     await scrollAppContainerTo(page, "bottom");
1678 | 
1679 |     // Header, nav, and footer should all remain sticky and visible
1680 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1681 |   });
1682 | });
1683 | 
1684 | test.describe("Vertical-Sticky Layout - scrollWholePage=true, noScrollbarGutters=false", () => {
1685 |   test.beforeEach(async ({ page }) => {
1686 |     await page.setViewportSize({ width: 1280, height: 1080 });
1687 |   });
1688 | 
1689 |   test("short content: all blocks visible, no scrollbar, gutters reserved", async ({
1690 |     initTestBed,
1691 |     page,
1692 |   }) => {
1693 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, true, "200px"));
1694 | 
1695 |     await verifyAllBlocksVisible(page);
1696 | 
1697 |     // Get bounding boxes to verify layout structure
1698 |     const header = page.getByTestId("appHeader");
1699 |     const navPanel = page.getByTestId("navPanel");
1700 |     const mainContent = page.getByTestId("mainContent");
1701 |     const footer = page.getByTestId("footer");
1702 | 
1703 |     const headerBox = await header.boundingBox();
1704 |     const navPanelBox = await navPanel.boundingBox();
1705 |     const mainContentBox = await mainContent.boundingBox();
1706 |     const footerBox = await footer.boundingBox();
1707 | 
1708 |     expect(headerBox).not.toBeNull();
1709 |     expect(navPanelBox).not.toBeNull();
1710 |     expect(mainContentBox).not.toBeNull();
1711 |     expect(footerBox).not.toBeNull();
1712 | 
1713 |     // Verify vertical layout: NavPanel on left, content on right
1714 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1715 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1716 | 
1717 |     // Verify header is above the nav/content row
1718 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1719 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1720 | 
1721 |     // Verify footer is below the nav/content row
1722 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1723 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1724 | 
1725 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1726 |     await verifyAppContainerScrollable(page, false);
1727 |     await verifyScrollbarGutters(page, true);
1728 |   });
1729 | 
1730 |   test("tall content at top: app container scrolls with reserved gutters, header/footer sticky", async ({
1731 |     initTestBed,
1732 |     page,
1733 |   }) => {
1734 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, true, "2000px"));
1735 |     await verifyAllBlocksVisible(page);
1736 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1737 |     await verifyAppContainerScrollable(page, true);
1738 |     await verifyScrollbarGutters(page, true);
1739 |   });
1740 | 
1741 |   test("tall content at mid-scroll: header/footer sticky, nav visible (full height)", async ({
1742 |     initTestBed,
1743 |     page,
1744 |   }) => {
1745 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, true, "2000px"));
1746 |     await scrollAppContainerTo(page, "mid");
1747 |     await verifyAllBlocksVisible(page);
1748 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1749 |     await verifyScrollbarGutters(page, true);
1750 |   });
1751 | 
1752 |   test("tall content at bottom: header/footer sticky, nav visible (full height)", async ({
1753 |     initTestBed,
1754 |     page,
1755 |   }) => {
1756 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, true, "2000px"));
1757 |     await scrollAppContainerTo(page, "bottom");
1758 |     await verifyAllBlocksVisible(page);
1759 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1760 |     await verifyScrollbarGutters(page, true);
1761 |   });
1762 | });
1763 | 
1764 | test.describe("Vertical-Sticky Layout - scrollWholePage=false, noScrollbarGutters=true", () => {
1765 |   test.beforeEach(async ({ page }) => {
1766 |     await page.setViewportSize({ width: 1280, height: 1080 });
1767 |   });
1768 | 
1769 |   test("short content: all blocks visible, main content is scroll container, no gutters", async ({
1770 |     initTestBed,
1771 |     page,
1772 |   }) => {
1773 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, false, "200px"));
1774 | 
1775 |     await verifyAllBlocksVisible(page);
1776 | 
1777 |     // Get bounding boxes to verify layout structure
1778 |     const header = page.getByTestId("appHeader");
1779 |     const navPanel = page.getByTestId("navPanel");
1780 |     const mainContent = page.getByTestId("mainContent");
1781 |     const footer = page.getByTestId("footer");
1782 | 
1783 |     const headerBox = await header.boundingBox();
1784 |     const navPanelBox = await navPanel.boundingBox();
1785 |     const mainContentBox = await mainContent.boundingBox();
1786 |     const footerBox = await footer.boundingBox();
1787 | 
1788 |     expect(headerBox).not.toBeNull();
1789 |     expect(navPanelBox).not.toBeNull();
1790 |     expect(mainContentBox).not.toBeNull();
1791 |     expect(footerBox).not.toBeNull();
1792 | 
1793 |     // Verify vertical layout: NavPanel on left, content on right
1794 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1795 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1796 | 
1797 |     // Verify header is above the nav/content row
1798 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1799 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1800 | 
1801 |     // Verify footer is below the nav/content row
1802 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1803 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1804 | 
1805 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1806 |     await verifyMainContentIsScrollContainer(page);
1807 |     await verifyAppContainerNotScrollable(page);
1808 |   });
1809 | 
1810 |   test("tall content at top: main content scrolls, header/nav/footer sticky, no gutters", async ({
1811 |     initTestBed,
1812 |     page,
1813 |   }) => {
1814 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, false, "2000px"));
1815 |     await verifyAllBlocksVisible(page);
1816 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1817 |     await verifyMainContentIsScrollContainer(page);
1818 |     await verifyMainContentScrollbarGutters(page, false);
1819 |     await verifyAppContainerNotScrollable(page);
1820 |   });
1821 | 
1822 |   test("tall content at mid-scroll: only main content scrolls, header/nav/footer remain sticky", async ({
1823 |     initTestBed,
1824 |     page,
1825 |   }) => {
1826 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, false, "2000px"));
1827 |     await scrollMainContentTo(page, "mid");
1828 |     await verifyAllBlocksVisible(page);
1829 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1830 |   });
1831 | 
1832 |   test("tall content at bottom: only main content scrolls, header/nav/footer remain sticky", async ({
1833 |     initTestBed,
1834 |     page,
1835 |   }) => {
1836 |     await initTestBed(createLayoutMarkup("vertical-sticky", true, false, "2000px"));
1837 |     await scrollMainContentTo(page, "bottom");
1838 |     await verifyAllBlocksVisible(page);
1839 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1840 |   });
1841 | });
1842 | 
1843 | test.describe("Vertical-Sticky Layout - scrollWholePage=false, noScrollbarGutters=false", () => {
1844 |   test.beforeEach(async ({ page }) => {
1845 |     await page.setViewportSize({ width: 1280, height: 1080 });
1846 |   });
1847 | 
1848 |   test("short content: main content is scroll container with reserved gutters", async ({
1849 |     initTestBed,
1850 |     page,
1851 |   }) => {
1852 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, false, "200px"));
1853 | 
1854 |     await verifyAllBlocksVisible(page);
1855 | 
1856 |     // Get bounding boxes to verify layout structure
1857 |     const header = page.getByTestId("appHeader");
1858 |     const navPanel = page.getByTestId("navPanel");
1859 |     const mainContent = page.getByTestId("mainContent");
1860 |     const footer = page.getByTestId("footer");
1861 | 
1862 |     const headerBox = await header.boundingBox();
1863 |     const navPanelBox = await navPanel.boundingBox();
1864 |     const mainContentBox = await mainContent.boundingBox();
1865 |     const footerBox = await footer.boundingBox();
1866 | 
1867 |     expect(headerBox).not.toBeNull();
1868 |     expect(navPanelBox).not.toBeNull();
1869 |     expect(mainContentBox).not.toBeNull();
1870 |     expect(footerBox).not.toBeNull();
1871 | 
1872 |     // Verify vertical layout: NavPanel on left, content on right
1873 |     expect(navPanelBox!.x).toBeLessThan(mainContentBox!.x);
1874 |     expect(navPanelBox!.x).toBeLessThan(headerBox!.x);
1875 | 
1876 |     // Verify header is above the nav/content row
1877 |     expect(headerBox!.y).toBe(navPanelBox!.y);
1878 |     expect(headerBox!.y).toBeLessThan(mainContentBox!.y);
1879 | 
1880 |     // Verify footer is below the nav/content row
1881 |     expect(footerBox!.y).toBe(navPanelBox!.y + navPanelBox!.height - footerBox!.height);
1882 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y + mainContentBox!.height);
1883 | 
1884 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1885 |     await verifyMainContentIsScrollContainer(page);
1886 |     await verifyMainContentScrollbarGutters(page, true);
1887 |   });
1888 | 
1889 |   test("tall content: main content scrolls with reserved gutters, header/nav/footer sticky", async ({
1890 |     initTestBed,
1891 |     page,
1892 |   }) => {
1893 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, false, "2000px"));
1894 |     await verifyAllBlocksVisible(page);
1895 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1896 |     await verifyMainContentIsScrollContainer(page);
1897 |     await verifyMainContentScrollbarGutters(page, true);
1898 |   });
1899 | 
1900 |   test("tall content at mid-scroll: main content scrolls with gutters, header/nav/footer sticky", async ({
1901 |     initTestBed,
1902 |     page,
1903 |   }) => {
1904 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, false, "2000px"));
1905 |     await scrollMainContentTo(page, "mid");
1906 |     await verifyAllBlocksVisible(page);
1907 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1908 |     await verifyMainContentScrollbarGutters(page, true);
1909 |   });
1910 | 
1911 |   test("tall content at bottom: main content scrolls with gutters, header/nav/footer sticky", async ({
1912 |     initTestBed,
1913 |     page,
1914 |   }) => {
1915 |     await initTestBed(createLayoutMarkup("vertical-sticky", false, false, "2000px"));
1916 |     await scrollMainContentTo(page, "bottom");
1917 |     await verifyAllBlocksVisible(page);
1918 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1919 |     await verifyMainContentScrollbarGutters(page, true);
1920 |   });
1921 | });
1922 | 
1923 | // =============================================================================
1924 | // VERTICAL-FULL-HEADER LAYOUT TESTS
1925 | // =============================================================================
1926 | // Layout: Row 1: [H spanning full width], Row 2 columns: [N] [M], Row 3: [F spanning full width]
1927 | // - H: sticky to viewport top, spans entire width
1928 | // - N: fixed width, sticky to top (below H), height = viewport - H - F
1929 | // - M: fills remaining width, scrollable
1930 | // - F: sticky to viewport bottom, spans entire width
1931 | // - Scroll container: entire viewport (scrollWholePage is always treated as true)
1932 | // =============================================================================
1933 | 
1934 | test.describe("Vertical-Full-Header Layout - scrollWholePage=true, noScrollbarGutters=true", () => {
1935 |   test.beforeEach(async ({ page }) => {
1936 |     await page.setViewportSize({ width: 1280, height: 1080 });
1937 |   });
1938 | 
1939 |   test("renders header spanning full width at top, nav panel and main content in row, footer spanning full width at bottom", async ({
1940 |     initTestBed,
1941 |     page,
1942 |   }) => {
1943 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, true, "200px"));
1944 | 
1945 |     await verifyAllBlocksVisible(page);
1946 | 
1947 |     // Get bounding boxes to verify layout structure
1948 |     const header = page.getByTestId("appHeader");
1949 |     const navPanel = page.getByTestId("navPanel");
1950 |     const mainContent = page.getByTestId("mainContent");
1951 |     const footer = page.getByTestId("footer");
1952 | 
1953 |     const headerBox = await header.boundingBox();
1954 |     const navPanelBox = await navPanel.boundingBox();
1955 |     const mainContentBox = await mainContent.boundingBox();
1956 |     const footerBox = await footer.boundingBox();
1957 | 
1958 |     expect(headerBox).not.toBeNull();
1959 |     expect(navPanelBox).not.toBeNull();
1960 |     expect(mainContentBox).not.toBeNull();
1961 |     expect(footerBox).not.toBeNull();
1962 | 
1963 |     // Verify header spans full width at top
1964 |     expect(headerBox!.x).toBe(0);
1965 |     expect(headerBox!.width).toBe(1280);
1966 |     expect(headerBox!.y).toBe(0);
1967 | 
1968 |     // Verify nav panel and main content are in a row below header
1969 |     expect(navPanelBox!.y).toBe(headerBox!.y + headerBox!.height);
1970 |     expect(mainContentBox!.y).toBeGreaterThanOrEqual(headerBox!.y + headerBox!.height);
1971 | 
1972 |     // Verify nav panel is on left, main content on right
1973 |     expect(navPanelBox!.x).toBe(0);
1974 |     expect(mainContentBox!.x).toBeGreaterThanOrEqual(navPanelBox!.x + navPanelBox!.width);
1975 | 
1976 |     // Verify footer spans full width at bottom
1977 |     expect(footerBox!.x).toBe(0);
1978 |     expect(footerBox!.width).toBe(1280);
1979 |     expect(footerBox!.y).toBeGreaterThan(mainContentBox!.y);
1980 | 
1981 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1982 |     await verifyAppContainerScrollable(page, false);
1983 |     await verifyScrollbarGutters(page, false);
1984 |   });
1985 | 
1986 |   test("tall content at top: header/footer sticky, nav sticky (full height available), app container scrolls without gutters", async ({
1987 |     initTestBed,
1988 |     page,
1989 |   }) => {
1990 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, true, "2000px"));
1991 | 
1992 |     await expect(page.getByTestId("mainContent")).toBeVisible();
1993 | 
1994 |     const initialScrollY = await page.evaluate(() => window.scrollY);
1995 |     expect(initialScrollY).toBe(0);
1996 | 
1997 |     await verifyAppContainerScrollable(page, true);
1998 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
1999 |     await verifyScrollbarGutters(page, false);
2000 |   });
2001 | 
2002 |   test("tall content at mid-scroll: header/footer sticky, nav sticky, content partially visible", async ({
2003 |     initTestBed,
2004 |     page,
2005 |   }) => {
2006 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, true, "2000px"));
2007 | 
2008 |     await scrollAppContainerTo(page, "mid");
2009 | 
2010 |     // Header, nav, and footer should all remain sticky and visible
2011 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
2012 | 
2013 |     // Verify header still spans full width
2014 |     const header = page.getByTestId("appHeader");
2015 |     const headerBox = await header.boundingBox();
2016 |     expect(headerBox!.x).toBe(0);
2017 |     expect(headerBox!.width).toBe(1280);
2018 |   });
2019 | 
2020 |   test("tall content at bottom: header/footer sticky, nav sticky, bottom of content visible", async ({
2021 |     initTestBed,
2022 |     page,
2023 |   }) => {
2024 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, true, "2000px"));
2025 | 
2026 |     await scrollAppContainerTo(page, "bottom");
2027 | 
2028 |     // Header, nav, and footer should all remain sticky and visible
2029 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
2030 | 
2031 |     // Verify footer still spans full width
2032 |     const footer = page.getByTestId("footer");
2033 |     const footerBox = await footer.boundingBox();
2034 |     expect(footerBox!.x).toBe(0);
2035 |     expect(footerBox!.width).toBe(1280);
2036 |   });
2037 | });
2038 | 
2039 | test.describe("Vertical-Full-Header Layout - scrollWholePage=true, noScrollbarGutters=false", () => {
2040 |   test.beforeEach(async ({ page }) => {
2041 |     await page.setViewportSize({ width: 1280, height: 1080 });
2042 |   });
2043 | 
2044 |   test("short content: all blocks visible, no scrollbar, gutters reserved", async ({
2045 |     initTestBed,
2046 |     page,
2047 |   }) => {
2048 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, true, "200px"));
2049 | 
2050 |     await verifyAllBlocksVisible(page);
2051 | 
2052 |     // Get bounding boxes to verify layout structure
2053 |     const header = page.getByTestId("appHeader");
2054 |     const navPanel = page.getByTestId("navPanel");
2055 |     const mainContent = page.getByTestId("mainContent");
2056 |     const footer = page.getByTestId("footer");
2057 | 
2058 |     const headerBox = await header.boundingBox();
2059 |     const navPanelBox = await navPanel.boundingBox();
2060 |     const mainContentBox = await mainContent.boundingBox();
2061 |     const footerBox = await footer.boundingBox();
2062 | 
2063 |     expect(headerBox).not.toBeNull();
2064 |     expect(navPanelBox).not.toBeNull();
2065 |     expect(mainContentBox).not.toBeNull();
2066 |     expect(footerBox).not.toBeNull();
2067 | 
2068 |     // Verify header spans full width at top
2069 |     expect(headerBox!.x).toBeGreaterThanOrEqual(0);
2070 |     expect(headerBox!.width).toBeGreaterThanOrEqual(1250);
2071 | 
2072 |     // Verify nav panel and main content are in a row
2073 |     expect(navPanelBox!.y).toBe(headerBox!.y + headerBox!.height);
2074 |     expect(mainContentBox!.y).toBeGreaterThanOrEqual(headerBox!.y + headerBox!.height);
2075 |     expect(navPanelBox!.x).toBeGreaterThanOrEqual(0);
2076 |     expect(mainContentBox!.x).toBeGreaterThanOrEqual(navPanelBox!.x + navPanelBox!.width);
2077 | 
2078 |     // Verify footer spans full width
2079 |     expect(footerBox!.x).toBeGreaterThanOrEqual(0);
2080 |     expect(footerBox!.width).toBeGreaterThanOrEqual(1250);
2081 | 
2082 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
2083 |     await verifyAppContainerScrollable(page, false);
2084 |     await verifyScrollbarGutters(page, true);
2085 |   });
2086 | 
2087 |   test("tall content at top: app container scrolls with gutters, all blocks sticky and visible", async ({
2088 |     initTestBed,
2089 |     page,
2090 |   }) => {
2091 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, true, "2000px"));
2092 | 
2093 |     await verifyAppContainerScrollable(page, true);
2094 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
2095 |     await verifyScrollbarGutters(page, true);
2096 |   });
2097 | 
2098 |   test("tall content at mid-scroll: app container scrolls with gutters, header/nav/footer sticky", async ({
2099 |     initTestBed,
2100 |     page,
2101 |   }) => {
2102 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, true, "2000px"));
2103 |     await scrollAppContainerTo(page, "mid");
2104 |     await verifyAllBlocksVisible(page);
2105 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
2106 |     await verifyScrollbarGutters(page, true);
2107 |   });
2108 | 
2109 |   test("tall content at bottom: app container scrolls with gutters, header/nav/footer sticky", async ({
2110 |     initTestBed,
2111 |     page,
2112 |   }) => {
2113 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, true, "2000px"));
2114 |     await scrollAppContainerTo(page, "bottom");
2115 |     await verifyAllBlocksVisible(page);
2116 |     await verifyBlocksInViewport(page, ["appHeader", "navPanel", "footer"]);
2117 |     await verifyScrollbarGutters(page, true);
2118 |   });
2119 | });
2120 | 
2121 | test.describe("Vertical-Full-Header Layout - scrollWholePage=false, noScrollbarGutters=true", () => {
2122 |   test.beforeEach(async ({ page }) => {
2123 |     await page.setViewportSize({ width: 1280, height: 1080 });
2124 |   });
2125 | 
2126 |   test("short content: all blocks visible, main content does not need scrolling", async ({
2127 |     initTestBed,
2128 |     page,
2129 |   }) => {
2130 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, false, "200px"));
2131 | 
2132 |     await verifyAllBlocksVisible(page);
2133 | 
2134 |     // Get bounding boxes to verify layout structure
2135 |     const header = page.getByTestId("appHeader");
2136 |     const navPanel = page.getByTestId("navPanel");
2137 |     const mainContent = page.getByTestId("mainContent");
2138 |     const footer = page.getByTestId("footer");
2139 | 
2140 |     const headerBox = await header.boundingBox();
2141 |     const navPanelBox = await navPanel.boundingBox();
2142 |     const mainContentBox = await mainContent.boundingBox();
2143 |     const footerBox = await footer.boundingBox();
2144 | 
2145 |     expect(headerBox).not.toBeNull();
2146 |     expect(navPanelBox).not.toBeNull();
2147 |     expect(mainContentBox).not.toBeNull();
2148 |     expect(footerBox).not.toBeNull();
2149 | 
2150 |     // Verify header spans full width
2151 |     expect(headerBox!.x).toBeGreaterThanOrEqual(0);
2152 |     expect(headerBox!.width).toBeGreaterThanOrEqual(1250);
2153 | 
2154 |     // Verify nav and content row
2155 |     expect(navPanelBox!.y).toBe(headerBox!.y + headerBox!.height);
2156 |     expect(mainContentBox!.y).toBeGreaterThanOrEqual(headerBox!.y + headerBox!.height);
2157 | 
2158 |     // Verify footer spans full width
2159 |     expect(footerBox!.x).toBeGreaterThanOrEqual(0);
2160 |     expect(footerBox!.width).toBeGreaterThanOrEqual(1250);
2161 | 
2162 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2163 |     await verifyAppContainerNotScrollable(page);
2164 |   });
2165 | 
2166 |   test("tall content at top: main content is scroll container without gutters, header/nav/footer sticky", async ({
2167 |     initTestBed,
2168 |     page,
2169 |   }) => {
2170 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, false, "2000px"));
2171 |     await verifyAllBlocksVisible(page);
2172 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2173 |     await verifyMainContentIsScrollContainer(page);
2174 |     await verifyMainContentScrollbarGutters(page, false);
2175 |   });
2176 | 
2177 |   test("tall content at mid-scroll: main content scrolls without gutters, header/nav/footer sticky", async ({
2178 |     initTestBed,
2179 |     page,
2180 |   }) => {
2181 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, false, "2000px"));
2182 |     await scrollMainContentTo(page, "mid");
2183 |     await verifyAllBlocksVisible(page);
2184 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2185 |     await verifyMainContentScrollbarGutters(page, false);
2186 |   });
2187 | 
2188 |   test("tall content at bottom: main content scrolls without gutters, header/nav/footer sticky", async ({
2189 |     initTestBed,
2190 |     page,
2191 |   }) => {
2192 |     await initTestBed(createLayoutMarkup("vertical-full-header", true, false, "2000px"));
2193 |     await scrollMainContentTo(page, "bottom");
2194 |     await verifyAllBlocksVisible(page);
2195 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2196 |     await verifyMainContentScrollbarGutters(page, false);
2197 |   });
2198 | });
2199 | 
2200 | test.describe("Vertical-Full-Header Layout - scrollWholePage=false, noScrollbarGutters=false", () => {
2201 |   test.beforeEach(async ({ page }) => {
2202 |     await page.setViewportSize({ width: 1280, height: 1080 });
2203 |   });
2204 | 
2205 |   test("short content: all blocks visible, main content does not need scrolling, gutters reserved", async ({
2206 |     initTestBed,
2207 |     page,
2208 |   }) => {
2209 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, false, "200px"));
2210 | 
2211 |     await verifyAllBlocksVisible(page);
2212 | 
2213 |     // Get bounding boxes to verify layout structure
2214 |     const header = page.getByTestId("appHeader");
2215 |     const navPanel = page.getByTestId("navPanel");
2216 |     const mainContent = page.getByTestId("mainContent");
2217 |     const footer = page.getByTestId("footer");
2218 | 
2219 |     const headerBox = await header.boundingBox();
2220 |     const navPanelBox = await navPanel.boundingBox();
2221 |     const mainContentBox = await mainContent.boundingBox();
2222 |     const footerBox = await footer.boundingBox();
2223 | 
2224 |     expect(headerBox).not.toBeNull();
2225 |     expect(navPanelBox).not.toBeNull();
2226 |     expect(mainContentBox).not.toBeNull();
2227 |     expect(footerBox).not.toBeNull();
2228 | 
2229 |     // Verify header spans full width
2230 |     expect(headerBox!.x).toBeGreaterThanOrEqual(0);
2231 |     expect(headerBox!.width).toBeGreaterThanOrEqual(1250);
2232 | 
2233 |     // Verify nav and content row
2234 |     expect(navPanelBox!.y).toBe(headerBox!.y + headerBox!.height);
2235 |     expect(mainContentBox!.y).toBeGreaterThanOrEqual(headerBox!.y + headerBox!.height);
2236 | 
2237 |     // Verify footer spans full width
2238 |     expect(footerBox!.x).toBeGreaterThanOrEqual(0);
2239 |     expect(footerBox!.width).toBeGreaterThanOrEqual(1250);
2240 | 
2241 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2242 |     await verifyAppContainerNotScrollable(page);
2243 |   });
2244 | 
2245 |   test("tall content at top: main content is scroll container with gutters, header/nav/footer sticky", async ({
2246 |     initTestBed,
2247 |     page,
2248 |   }) => {
2249 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, false, "2000px"));
2250 |     await verifyAllBlocksVisible(page);
2251 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2252 |     await verifyMainContentIsScrollContainer(page);
2253 |     await verifyMainContentScrollbarGutters(page, true);
2254 |   });
2255 | 
2256 |   test("tall content at mid-scroll: main content scrolls with gutters, header/nav/footer sticky", async ({
2257 |     initTestBed,
2258 |     page,
2259 |   }) => {
2260 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, false, "2000px"));
2261 |     await scrollMainContentTo(page, "mid");
2262 |     await verifyAllBlocksVisible(page);
2263 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2264 |     await verifyMainContentScrollbarGutters(page, true);
2265 |   });
2266 | 
2267 |   test("tall content at bottom: main content scrolls with gutters, header/nav/footer sticky", async ({
2268 |     initTestBed,
2269 |     page,
2270 |   }) => {
2271 |     await initTestBed(createLayoutMarkup("vertical-full-header", false, false, "2000px"));
2272 |     await scrollMainContentTo(page, "bottom");
2273 |     await verifyAllBlocksVisible(page);
2274 |     await verifyBlocksInViewport(page, ["appHeader", "footer"]);
2275 |     await verifyMainContentScrollbarGutters(page, true);
2276 |   });
2277 | });
2278 | 
2279 | // =============================================================================
2280 | // DESKTOP LAYOUT TESTS
2281 | // =============================================================================
2282 | 
2283 | test.describe("Desktop Layout - with Header and Footer", () => {
2284 |   test.beforeEach(async ({ page }) => {
2285 |     await page.setViewportSize({ width: 1280, height: 1080 });
2286 |   });
2287 | 
2288 |   test("renders full viewport layout with header, main content, and footer", async ({
2289 |     initTestBed,
2290 |     page,
2291 |   }) => {
2292 |     await initTestBed(`
2293 |       <App2 layout="desktop">
2294 |         <AppHeader testId="appHeader">
2295 |           Desktop Header
2296 |         </AppHeader>
2297 |         <Pages fallbackPath="/">
2298 |           <Page url="/">
2299 |             <Stack testId="mainContent" height="200px" backgroundColor="lightblue">
2300 |               <Text>Desktop Main Content</Text>
2301 |             </Stack>
2302 |           </Page>
2303 |         </Pages>
2304 |         <Footer testId="footer">
2305 |           Desktop Footer
2306 |         </Footer>
2307 |       </App2>
2308 |     `);
2309 | 
2310 |     // Verify header and footer are visible, NavPanel should not exist
2311 |     const header = page.getByTestId("appHeader");
2312 |     const mainContent = page.getByTestId("mainContent");
2313 |     const footer = page.getByTestId("footer");
2314 |     const navPanel = page.getByTestId("navPanel");
2315 | 
2316 |     await expect(header).toBeVisible();
2317 |     await expect(mainContent).toBeVisible();
2318 |     await expect(footer).toBeVisible();
2319 |     await expect(navPanel).not.toBeVisible();
2320 | 
2321 |     // Verify layout structure
2322 |     const headerBox = await header.boundingBox();
2323 |     const mainContentBox = await mainContent.boundingBox();
2324 |     const footerBox = await footer.boundingBox();
2325 | 
2326 |     expect(headerBox).not.toBeNull();
2327 |     expect(mainContentBox).not.toBeNull();
2328 |     expect(footerBox).not.toBeNull();
2329 | 
2330 |     // Header should be at top
2331 |     expect(headerBox!.y).toBeLessThan(50);
2332 |     
2333 |     // Footer should be at bottom
2334 |     expect(footerBox!.y + footerBox!.height).toBeGreaterThan(1000);
2335 | 
2336 |     // Main content should be between header and footer
2337 |     expect(mainContentBox!.y).toBeGreaterThan(headerBox!.y + headerBox!.height);
2338 |     expect(mainContentBox!.y).toBeLessThan(footerBox!.y);
2339 |   });
2340 | 
2341 |   test("header and footer are sticky when content is tall", async ({
2342 |     initTestBed,
2343 |     page,
2344 |   }) => {
2345 |     await initTestBed(`
2346 |       <App2 layout="desktop">
2347 |         <AppHeader testId="appHeader">
2348 |           Desktop Header
2349 |         </AppHeader>
2350 |         <Pages fallbackPath="/">
2351 |           <Page url="/">
2352 |             <Stack testId="mainContent" height="2000px" backgroundColor="lightblue">
2353 |               <Text>Tall Desktop Content</Text>
2354 |             </Stack>
2355 |           </Page>
2356 |         </Pages>
2357 |         <Footer testId="footer">
2358 |           Desktop Footer
2359 |         </Footer>
2360 |       </App2>
2361 |     `);
2362 | 
2363 |     const header = page.getByTestId("appHeader");
2364 |     const footer = page.getByTestId("footer");
2365 |     const mainContent = page.getByTestId("mainContent");
2366 | 
2367 |     // Before scrolling - header and footer should be in viewport
2368 |     await expect(header).toBeVisible();
2369 |     await expect(footer).toBeVisible();
2370 |     await expect(mainContent).toBeVisible();
2371 | 
2372 |     const headerBoxBefore = await header.boundingBox();
2373 |     const footerBoxBefore = await footer.boundingBox();
2374 | 
2375 |     // Scroll main content
2376 |     await scrollMainContentTo(page, "mid");
2377 | 
2378 |     const headerBoxAfter = await header.boundingBox();
2379 |     const footerBoxAfter = await footer.boundingBox();
2380 | 
2381 |     // Header and footer should remain in same position (sticky)
2382 |     expect(headerBoxAfter!.y).toBeCloseTo(headerBoxBefore!.y, 0);
2383 |     expect(footerBoxAfter!.y).toBeCloseTo(footerBoxBefore!.y, 0);
2384 |   });
2385 | 
2386 |   test("main content is the scroll container", async ({
2387 |     initTestBed,
2388 |     page,
2389 |   }) => {
2390 |     await initTestBed(`
2391 |       <App2 layout="desktop">
2392 |         <AppHeader testId="appHeader">
2393 |           Desktop Header
2394 |         </AppHeader>
2395 |         <Pages fallbackPath="/">
2396 |           <Page url="/">
2397 |             <Stack testId="mainContent" height="2000px" backgroundColor="lightblue">
2398 |               <Text>Tall Desktop Content</Text>
2399 |             </Stack>
2400 |           </Page>
2401 |         </Pages>
2402 |         <Footer testId="footer">
2403 |           Desktop Footer
2404 |         </Footer>
2405 |       </App2>
2406 |     `);
2407 | 
2408 |     // Verify main content is scrollable
2409 |     await verifyMainContentIsScrollContainer(page);
2410 |     
2411 |     // App container should not be scrollable
2412 |     await verifyAppContainerNotScrollable(page);
2413 |   });
2414 | 
2415 |   test("no scrollbar gutters in desktop layout", async ({
2416 |     initTestBed,
2417 |     page,
2418 |   }) => {
2419 |     await initTestBed(`
2420 |       <App2 layout="desktop">
2421 |         <AppHeader testId="appHeader">
2422 |           Desktop Header
2423 |         </AppHeader>
2424 |         <Pages fallbackPath="/">
2425 |           <Page url="/">
2426 |             <Stack testId="mainContent" height="2000px" backgroundColor="lightblue">
2427 |               <Text>Tall Desktop Content</Text>
2428 |             </Stack>
2429 |           </Page>
2430 |         </Pages>
2431 |         <Footer testId="footer">
2432 |           Desktop Footer
2433 |         </Footer>
2434 |       </App2>
2435 |     `);
2436 | 
2437 |     // Desktop layout should not have scrollbar gutters
2438 |     const info = await page.evaluate(() => {
2439 |       const appWrapper = document.querySelector('[class*="appContainer"]');
2440 |       if (!appWrapper) return { found: false };
2441 | 
2442 |       const styles = window.getComputedStyle(appWrapper);
2443 |       return {
2444 |         found: true,
2445 |         scrollbarGutter: styles.scrollbarGutter,
2446 |       };
2447 |     });
2448 | 
2449 |     expect(info.found).toBe(true);
2450 |     expect(info.scrollbarGutter).not.toBe("stable both-edges");
2451 |   });
2452 | 
2453 |   test("container stretches to full viewport (100vw × 100vh)", async ({
2454 |     initTestBed,
2455 |     page,
2456 |   }) => {
2457 |     await initTestBed(`
2458 |       <App2 layout="desktop">
2459 |         <AppHeader testId="appHeader">
2460 |           Desktop Header
2461 |         </AppHeader>
2462 |         <Pages fallbackPath="/">
2463 |           <Page url="/">
2464 |             <Stack testId="mainContent" height="200px" backgroundColor="lightblue">
2465 |               <Text>Desktop Content</Text>
2466 |             </Stack>
2467 |           </Page>
2468 |         </Pages>
2469 |         <Footer testId="footer">
2470 |           Desktop Footer
2471 |         </Footer>
2472 |       </App2>
2473 |     `);
2474 | 
2475 |     const containerInfo = await page.evaluate(() => {
2476 |       const appWrapper = document.querySelector('[class*="appContainer"]') as HTMLElement;
2477 |       if (!appWrapper) return { found: false };
2478 | 
2479 |       const rect = appWrapper.getBoundingClientRect();
2480 |       const viewportWidth = window.innerWidth;
2481 |       const viewportHeight = window.innerHeight;
2482 | 
2483 |       return {
2484 |         found: true,
2485 |         width: rect.width,
2486 |         height: rect.height,
2487 |         viewportWidth,
2488 |         viewportHeight,
2489 |       };
2490 |     });
2491 | 
2492 |     expect(containerInfo.found).toBe(true);
2493 |     
2494 |     // Container should fill viewport (allow small tolerance for scrollbars)
2495 |     expect(containerInfo.width).toBeGreaterThanOrEqual(containerInfo.viewportWidth - 20);
2496 |     expect(containerInfo.height).toBeGreaterThanOrEqual(containerInfo.viewportHeight - 20);
2497 |   });
2498 | });
2499 | 
2500 | test.describe("Desktop Layout - without Header and Footer", () => {
2501 |   test.beforeEach(async ({ page }) => {
2502 |     await page.setViewportSize({ width: 1280, height: 1080 });
2503 |   });
2504 | 
2505 |   test("renders only main content when header and footer are omitted", async ({
2506 |     initTestBed,
2507 |     page,
2508 |   }) => {
2509 |     await initTestBed(`
2510 |       <App2 layout="desktop">
2511 |         <Pages fallbackPath="/">
2512 |           <Page url="/">
2513 |             <Stack testId="mainContent" height="200px" backgroundColor="lightblue">
2514 |               <Text>Desktop Main Content Only</Text>
2515 |             </Stack>
2516 |           </Page>
2517 |         </Pages>
2518 |       </App2>
2519 |     `);
2520 | 
2521 |     // Only main content should be visible
2522 |     const mainContent = page.getByTestId("mainContent");
2523 |     const header = page.getByTestId("appHeader");
2524 |     const footer = page.getByTestId("footer");
2525 |     const navPanel = page.getByTestId("navPanel");
2526 | 
2527 |     await expect(mainContent).toBeVisible();
2528 |     await expect(header).not.toBeVisible();
2529 |     await expect(footer).not.toBeVisible();
2530 |     await expect(navPanel).not.toBeVisible();
2531 |   });
2532 | 
2533 |   test("main content fills entire viewport", async ({
2534 |     initTestBed,
2535 |     page,
2536 |   }) => {
2537 |     await initTestBed(`
2538 |       <App2 layout="desktop">
2539 |         <Pages fallbackPath="/">
2540 |           <Page url="/">
2541 |             <Stack testId="mainContent" height="200px" backgroundColor="lightblue">
2542 |               <Text>Desktop Content</Text>
2543 |             </Stack>
2544 |           </Page>
2545 |         </Pages>
2546 |       </App2>
2547 |     `);
2548 | 
2549 |     const mainContent = page.getByTestId("mainContent");
2550 |     const mainContentBox = await mainContent.boundingBox();
2551 | 
2552 |     expect(mainContentBox).not.toBeNull();
2553 |     
2554 |     // Main content should start near top of viewport
2555 |     expect(mainContentBox!.y).toBeLessThan(50);
2556 |   });
2557 | 
2558 |   test("tall content scrolls within main content area", async ({
2559 |     initTestBed,
2560 |     page,
2561 |   }) => {
2562 |     await initTestBed(`
2563 |       <App2 layout="desktop">
2564 |         <Pages fallbackPath="/">
2565 |           <Page url="/">
2566 |             <Stack testId="mainContent" height="2000px" backgroundColor="lightblue">
2567 |               <Text>Tall Desktop Content</Text>
2568 |             </Stack>
2569 |           </Page>
2570 |         </Pages>
2571 |       </App2>
2572 |     `);
2573 | 
2574 |     // Verify main content is scrollable
2575 |     await verifyMainContentIsScrollContainer(page);
2576 |     
2577 |     // App container should not be scrollable
2578 |     await verifyAppContainerNotScrollable(page);
2579 |   });
2580 | });
2581 | 
2582 | test.describe("Desktop Layout - scrollWholePage and noScrollbarGutters props", () => {
2583 |   test.beforeEach(async ({ page }) => {
2584 |     await page.setViewportSize({ width: 1280, height: 1080 });
2585 |   });
2586 | 
2587 |   test("scrollWholePage prop is ignored in desktop layout", async ({
2588 |     initTestBed,
2589 |     page,
2590 |   }) => {
2591 |     // Test with scrollWholePage=true
2592 |     await initTestBed(`
2593 |       <App2 layout="desktop" scrollWholePage="true">
2594 |         <Pages fallbackPath="/">
2595 |           <Page url="/">
2596 |             <Stack testId="mainContent" height="2000px" backgroundColor="lightblue">
2597 |               <Text>Tall Content</Text>
2598 |             </Stack>
2599 |           </Page>
2600 |         </Pages>
2601 |       </App2>
2602 |     `);
2603 | 
2604 |     // Main content should still be the scroll container (desktop always uses content-only scroll)
2605 |     await verifyMainContentIsScrollContainer(page);
2606 |     await verifyAppContainerNotScrollable(page);
2607 |   });
2608 | 
2609 |   test("noScrollbarGutters prop is ignored in desktop layout", async ({
2610 |     initTestBed,
2611 |     page,
2612 |   }) => {
2613 |     // Test with noScrollbarGutters=false (should still not have gutters)
2614 |     await initTestBed(`
2615 |       <App2 layout="desktop" noScrollbarGutters="false">
2616 |         <Pages fallbackPath="/">
2617 |           <Page url="/">
2618 |             <Stack testId="mainContent" height="2000px" backgroundColor="lightblue">
2619 |               <Text>Tall Content</Text>
2620 |             </Stack>
2621 |           </Page>
2622 |         </Pages>
2623 |       </App2>
2624 |     `);
2625 | 
2626 |     // Desktop layout never uses scrollbar gutters
2627 |     const info = await page.evaluate(() => {
2628 |       const appWrapper = document.querySelector('[class*="appContainer"]');
2629 |       if (!appWrapper) return { found: false };
2630 | 
2631 |       const styles = window.getComputedStyle(appWrapper);
2632 |       return {
2633 |         found: true,
2634 |         scrollbarGutter: styles.scrollbarGutter,
2635 |       };
2636 |     });
2637 | 
2638 |     expect(info.found).toBe(true);
2639 |     expect(info.scrollbarGutter).not.toBe("stable both-edges");
2640 |   });
2641 | });
2642 | 
2643 | test.describe("Desktop Layout - NavPanel behavior", () => {
2644 |   test.beforeEach(async ({ page }) => {
2645 |     await page.setViewportSize({ width: 1280, height: 1080 });
2646 |   });
2647 | 
2648 |   test("NavPanel is not rendered even when provided", async ({
2649 |     initTestBed,
2650 |     page,
2651 |   }) => {
2652 |     await initTestBed(`
2653 |       <App2 layout="desktop">
2654 |         <AppHeader testId="appHeader">
2655 |           Desktop Header
2656 |         </AppHeader>
2657 |         <NavPanel testId="navPanel">
2658 |           <NavLink label="Link 1" to="/page1" />
2659 |           <NavLink label="Link 2" to="/page2" />
2660 |         </NavPanel>
2661 |         <Pages fallbackPath="/">
2662 |           <Page url="/">
2663 |             <Stack testId="mainContent" height="200px" backgroundColor="lightblue">
2664 |               <Text>Desktop Content</Text>
2665 |             </Stack>
2666 |           </Page>
2667 |         </Pages>
2668 |         <Footer testId="footer">
2669 |           Desktop Footer
2670 |         </Footer>
2671 |       </App2>
2672 |     `);
2673 | 
2674 |     // NavPanel should not be visible in desktop layout
2675 |     const navPanel = page.getByTestId("navPanel");
2676 |     await expect(navPanel).not.toBeVisible();
2677 | 
2678 |     // Header, main content, and footer should still be visible
2679 |     await expect(page.getByTestId("appHeader")).toBeVisible();
2680 |     await expect(page.getByTestId("mainContent")).toBeVisible();
2681 |     await expect(page.getByTestId("footer")).toBeVisible();
2682 |   });
2683 | 
2684 |   test("no drawer/hamburger menu in desktop layout", async ({
2685 |     initTestBed,
2686 |     page,
2687 |   }) => {
2688 |     await initTestBed(`
2689 |       <App2 layout="desktop">
2690 |         <AppHeader testId="appHeader">
2691 |           Desktop Header
2692 |         </AppHeader>
2693 |         <NavPanel testId="navPanel">
2694 |           <NavLink label="Link 1" to="/page1" />
2695 |           <NavLink label="Link 2" to="/page2" />
2696 |         </NavPanel>
2697 |         <Pages fallbackPath="/">
2698 |           <Page url="/">
2699 |             <Stack testId="mainContent" height="200px" backgroundColor="lightblue">
2700 |               <Text>Desktop Content</Text>
2701 |             </Stack>
2702 |           </Page>
2703 |         </Pages>
2704 |       </App2>
2705 |     `);
2706 | 
2707 |     // No hamburger menu button should exist
2708 |     const hamburgerButton = page.locator('[data-part-id="hamburger-button"]');
2709 |     await expect(hamburgerButton).not.toBeVisible();
2710 |   });
2711 | });
2712 | 
```
Page 216/224FirstPrevNextLast