Set CHANGELOG to v4.1.0

Using `auto` seems to create a different output on different platforms.
Notably it was observed that aarch64 compiles return a different
value.

Fix the type of the characters iterated through the string.

Fixes #639

Signed-off-by: Henner Zeller <h.zeller@acm.org>

.bazelrc

@@ -1,9 +0,0 @@
-common --enable_bzlmod
-
-build --features=layering_check
-build --enable_bzlmod
-
-build --enable_platform_specific_config
-build:linux --cxxopt=-std=c++20
-build:macos --cxxopt=-std=c++20
-build:windows --cxxopt=-std:c++20

.bcr/README.md

@@ -1,9 +0,0 @@
-# Bazel Central Registry
-
-When the ruleset is released, we want it to be published to the
-Bazel Central Registry automatically:
-<https://registry.bazel.build>
-
-This folder contains configuration files to automate the publish step.
-See <https://github.com/bazel-contrib/publish-to-bcr/blob/main/templates/README.md>
-for authoritative documentation about these files.

.bcr/metadata.template.json

@@ -1,16 +0,0 @@
-{
-  "homepage": "https://github.com/ArthurSonzogni/FTXUI",
-  "maintainers": [
-    {
-      "name": "Arthur Sonzogni",
-      "email": "sonzogniarthur@gmail.com",
-      "github": "ArthurSonzogni",
-      "github_user_id": 4759106
-    }
-  ],
-  "repository": [
-    "github:ArthurSonzogni/FTXUI"
-  ],
-  "versions": [],
-  "yanked_versions": {}
-}

.bcr/presubmit.yml

@@ -1,36 +0,0 @@
-matrix:
-  bazel:
-    - 7.x
-    - 8.x
-    - rolling
-  unix_platform:
-    - debian11
-    - ubuntu2204
-    - macos
-    - macos_arm64
-  win_platform:
-    - windows
-
-tasks:
-
-  unix_test:
-    name: Verify build targets on Unix
-    platform: ${{ unix_platform }}
-    bazel: ${{ bazel }}
-    build_flags:
-    - --cxxopt=-std=c++20
-    build_targets:
-    - '@ftxui//:dom'
-    - '@ftxui//:component'
-    - '@ftxui//:screen'
-
-  windows_test:
-    name: Verify build targets
-    platform: ${{ win_platform }}
-    bazel: ${{ bazel }}
-    build_flags:
-    - --cxxopt=/std:c++20
-    build_targets:
-    - '@ftxui//:dom'
-    - '@ftxui//:component'
-    - '@ftxui//:screen'

.bcr/source.template.json

@@ -1,5 +0,0 @@
-{
-  "integrity": "",
-  "strip_prefix": "",
-  "url": "https://github.com/ArthurSonzogni/FTXUI/releases/download/{TAG}/source.tar.gz"
-}

.clang-format

@@ -2,6 +2,3 @@
 # http://clang.llvm.org/docs/ClangFormatStyleOptions.html
 BasedOnStyle: Chromium
 Standard: Cpp11
-
-InsertBraces: true
-InsertNewlineAtEOF: true

.clang-tidy

@@ -1,34 +1,23 @@
 ---
 Checks: "*,
-        -*-macro-usage,
-        -*-magic-numbers,
-        -*-narrowing-conversions
-        -*-unnecessary-value-param,
-        -*-uppercase-literal-suffix,
         -abseil-*,
         -altera-*,
         -android-*,
-        -bugprone-easily-swappable-parameters,
-        -cppcoreguidelines-non-private-member-variables-in-classes,
-        -cppcoreguidelines-pro-type-union-access,
         -fuchsia-*,
         -google-*,
-        -hicpp-signed-bitwise,
         -llvm*,
+        -modernize-use-trailing-return-type,
+        -zircon-*,
+        -bugprone-easily-swappable-parameters,
+        -cppcoreguidelines-non-private-member-variables-in-classes,
         -misc-no-recursion,
         -misc-non-private-member-variables-in-classes,
         -modernize-use-nodiscard,
-        -modernize-use-trailing-return-type,
         -readability-avoid-const-params-in-decls,
         -readability-else-after-return,
         -readability-identifier-length,
         -readability-implicit-bool-conversion,
-        -readability-non-const-parameter,
-        -readability-simplify-boolean-expr,
         -readability-static-accessed-through-instance,
-        -readability-use-anyofallof,
-        -readability-avoid-nested-conditional-operator,
-        -zircon-*,
 "
 WarningsAsErrors: ''
 HeaderFilterRegex: ''

.github/workflows/build.yaml

@@ -1,63 +1,19 @@
 name: Build
 
 on:
-  # On new commits to main:
+  create:
+    tags:
+      -v*
   push:
     branches:
-      - main
-
-  # On pull requests:
+      - master
   pull_request:
     branches:
-      - main
+      - master
 
 jobs:
-
-  test_bazel:
-    name: "Bazel, ${{ matrix.cxx }}, ${{ matrix.os }}"
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - os: ubuntu-latest
-            cxx: g++
-            cc: gcc
-
-          - os: ubuntu-latest
-            cxx: clang++
-            cc: clang
-
-          - os: macos-latest
-            cxx: g++
-            cc: gcc
-
-          - os: macos-latest
-            cxx: clang++
-            cc: clang
-
-          - os: windows-latest
-            cxx: cl
-            cc: cl
-
-    runs-on: ${{ matrix.os }}
-    steps:
-      - name: "Checkout repository"
-        uses: actions/checkout@v3
-
-      - name: "Build with Bazel"
-        env:
-          CC: ${{ matrix.cc }}
-          CXX: ${{ matrix.cxx }}
-        run: bazel build ...
-
-      - name: "Tests with Bazel"
-        env:
-          CC: ${{ matrix.cc }}
-          CXX: ${{ matrix.cxx }}
-        run: bazel test --test_output=all ...
-
-  test_cmake:
-    name: "CMake, ${{ matrix.compiler }}, ${{ matrix.os }}"
+  test:
+    name: "Tests"
     strategy:
       fail-fast: false
       matrix:
@@ -65,6 +21,7 @@ jobs:
           - name: Linux GCC
             os: ubuntu-latest
             compiler: gcc
+            gcov_executable: gcov
 
           - name: Linux Clang
             os: ubuntu-latest
@@ -82,12 +39,8 @@ jobs:
 
     runs-on: ${{ matrix.os }}
     steps:
-      - name: Get number of CPU cores
-        uses: SimenB/github-actions-cpu-cores@v1
-        id: cpu-cores
-
       - name: "Checkout repository"
-        uses: actions/checkout@v3
+        uses: actions/checkout@v2
 
       - name: "Setup Cpp"
         uses: aminya/setup-cpp@v1
@@ -96,7 +49,7 @@ jobs:
           vcvarsall: ${{ contains(matrix.os, 'windows' )}}
           cmake: true
           ninja: true
-          clangtidy: false
+          clangtidy: true
           cppcheck: false
           gcovr: "5.0"
           opencppcoverage: true
@@ -108,30 +61,23 @@ jobs:
           cmake -S .
           -B ./build
           -DCMAKE_BUILD_TYPE:STRING=Debug
-          -DCMAKE_BUILD_PARALLEL_LEVEL=${{ steps.cpu-cores.outputs.count }}
           -DFTXUI_ENABLE_COVERAGE:BOOL=ON
           -DFTXUI_BUILD_DOCS:BOOL=OFF
           -DFTXUI_BUILD_EXAMPLES:BOOL=ON
           -DFTXUI_BUILD_TESTS:BOOL=ON
           -DFTXUI_BUILD_TESTS_FUZZER:BOOL=OFF
-          -DFTXUI_ENABLE_INSTALL:BOOL=ON
-          -DFTXUI_DEV_WARNINGS:BOOL=ON ;
+          -DFTXUI_ENABLE_INSTALL:BOOL=ON ;
 
       - name: "Build"
         run: >
           cmake
           --build ./build
 
-      - name: Unix - Test
+      - name: Unix - Test and coverage
         if: runner.os != 'Windows'
         working-directory: ./build
         run: >
           ctest -C Debug --rerun-failed --output-on-failure;
-
-      - name: Unix - coverage
-        if: matrix.gcov_executable != ''
-        working-directory: ./build
-        run: >
           gcovr
           -j ${{env.nproc}}
           --delete
@@ -166,46 +112,108 @@ jobs:
           name: ${{ runner.os }}-coverage
           files: ./build/coverage.xml
 
-  test_modules:
-    name: "Test modules"
+  # Create a release on new v* tags
+  release:
+    needs: test
+    if: ${{ github.event_name == 'create' && startsWith(github.ref, 'refs/tags/v') }}
+    name: "Create release"
+    runs-on: ubuntu-latest
+    outputs:
+      upload_url: ${{ steps.create_release.outputs.upload_url }}
+    steps:
+      - name: "Create release"
+        uses: softprops/action-gh-release@v1
+        id: create_release
+        with:
+          draft: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  # Build artifact for the release
+  package:
+    name: "Build packages"
+    needs: release
     strategy:
       matrix:
         include:
           - os: ubuntu-latest
-            compiler: llvm
-          # TODO add gcc / msvc
+            asset_path: build/ftxui*Linux*
+          - os: macos-latest
+            asset_path: build/ftxui*Darwin*
+          - os: windows-latest
+            asset_path: build/ftxui*Win64*
     runs-on: ${{ matrix.os }}
     steps:
       - name: "Checkout repository"
-        uses: actions/checkout@v3
+        uses: actions/checkout@v2
 
-      - name: "Setup Cpp"
-        uses: aminya/setup-cpp@v1
-        with:
-          compiler: ${{ matrix.compiler }}
-          vcvarsall: ${{ contains(matrix.os, 'windows' )}}
-          cmake: true
-          ninja: true
-          clangtidy: false
-          cppcheck: false
-          opencppcoverage: false
+      - name: "Install cmake"
+        uses: lukka/get-cmake@latest
 
-      - name: "Generate ./examples_modules"
-        run: >
-          ./tools/generate_examples_modules.sh
-
-      - name: "Build modules"
+      - name: "Build packages"
         run: >
           mkdir build;
           cd build;
           cmake ..
-          -DCMAKE_GENERATOR=Ninja
-          -DFTXUI_BUILD_MODULES=ON
-          -DFTXUI_BUILD_EXAMPLES=ON
-          -DCMAKE_BUILD_TYPE=Debug
+          -DCMAKE_BUILD_TYPE=Release
           -DFTXUI_BUILD_DOCS=OFF
+          -DFTXUI_BUILD_EXAMPLES=OFF
           -DFTXUI_BUILD_TESTS=OFF
           -DFTXUI_BUILD_TESTS_FUZZER=OFF
-          -DFTXUI_ENABLE_INSTALL=ON
-          -DFTXUI_DEV_WARNINGS=ON ;
-          cmake --build .
+          -DFTXUI_ENABLE_INSTALL=ON;
+          cmake --build . --target package;
+      - uses: shogo82148/actions-upload-release-asset@v1
+        with:
+          upload_url: ${{ needs.release.outputs.upload_url }}
+          asset_path: ${{ matrix.asset_path }}
+          overwrite: true
+  
+  documentation:
+    if: github.ref == 'refs/heads/master'
+    runs-on: ubuntu-latest
+    steps:
+      - name: "Checkout repository"
+        uses: actions/checkout@v2
+
+      - name: "Install cmake"
+        uses: lukka/get-cmake@latest
+
+      - name: "Install emsdk"
+        uses: mymindstorm/setup-emsdk@v7
+
+      - name: "Install Doxygen/Graphviz"
+        run: >
+          sudo apt-get update;
+          sudo apt-get install doxygen graphviz;
+
+      - name: "Build documentation"
+        run: >
+          mkdir build;
+          cd build;
+          emcmake cmake ..
+          -DCMAKE_BUILD_TYPE=Release
+          -DFTXUI_BUILD_DOCS=ON
+          -DFTXUI_BUILD_EXAMPLES=ON
+          -DFTXUI_BUILD_TESTS=OFF
+          -DFTXUI_BUILD_TESTS_FUZZER=OFF
+          -DFTXUI_ENABLE_INSTALL=OFF;
+          cmake --build . --target doc;
+          cmake --build . ;
+          rsync -amv
+          --include='*/'
+          --include='*.html'
+          --include='*.js'
+          --include='*.wasm'
+          --exclude='*'
+          examples
+          doc/doxygen/html;
+
+      - name: "Deploy"
+        uses: peaceiris/actions-gh-pages@v3
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: build/doc/doxygen/html/
+          enable_jekyll: false
+          allow_empty_commit: false
+          force_orphan: true
+          publish_branch: gh-pages

.github/workflows/documentation.yaml

@@ -1,65 +0,0 @@
-name: Documentation
-
-on:
-  # On new commits to main:
-  push:
-    branches:
-      - main
-
-jobs:
-  documentation:
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Checkout repository"
-        uses: actions/checkout@v3
-
-      - name: "Install cmake"
-        uses: lukka/get-cmake@latest
-
-      - name: "Install emsdk"
-        uses: mymindstorm/setup-emsdk@v7
-
-      - name: "Install Doxygen"
-        uses: ssciwr/doxygen-install@v1
-        with:
-          version: '1.12.0'
-
-      - name: "Install Graphviz"
-        run: >
-          sudo apt-get update;
-          sudo apt-get install graphviz;
-
-      - name: "Build documentation"
-        run: >
-          mkdir build;
-          cd build;
-          emcmake cmake ..
-          -DCMAKE_BUILD_TYPE=Release
-          -DFTXUI_BUILD_DOCS=ON
-          -DFTXUI_BUILD_EXAMPLES=ON
-          -DFTXUI_BUILD_TESTS=OFF
-          -DFTXUI_BUILD_TESTS_FUZZER=OFF
-          -DFTXUI_ENABLE_INSTALL=OFF
-          -DFTXUI_DEV_WARNINGS=OFF;
-          cmake --build . --target doc;
-          cmake --build . ;
-          rsync -amv
-          --include='*/'
-          --include='*.html'
-          --include='*.css'
-          --include='*.mjs'
-          --include='*.js'
-          --include='*.wasm'
-          --exclude='*'
-          examples
-          doc/doxygen/html;
-
-      - name: "Deploy"
-        uses: peaceiris/actions-gh-pages@v3
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: build/doc/doxygen/html/
-          enable_jekyll: false
-          allow_empty_commit: false
-          force_orphan: true
-          publish_branch: gh-pages

.github/workflows/publish.yaml

@@ -1,24 +0,0 @@
-name: "Publish to Bazel Central Registry"
-
-on:
-  # Manual kick-off (you type the tag)
-  workflow_dispatch:
-    inputs:
-      tag_name:
-        description: "Tag to publish"
-        required: true
-        type: string
-
-permissions:
-  contents:     write
-
-jobs:
-  publish:
-    uses: bazel-contrib/publish-to-bcr/.github/workflows/publish.yaml@v0.0.4
-    with:
-      tag_name: ${{ github.event.inputs.tag_name }}
-      registry_fork: ArthurSonzogni/bazel-central-registry
-      attest: false
-
-    secrets:
-      publish_token: ${{ secrets.PUBLISH_TOKEN }}

.github/workflows/release.yaml

@@ -1,100 +0,0 @@
-name: Release
-
-on:
-  # On push to a tag:
-  push:
-    tags:
-      - 'v*'
-
-  # On manual trigger:
-  workflow_dispatch:
-
-permissions:
-  # Needed to mint attestations
-  id-token: write
-  attestations: write
-  # Needed to upload release assets
-  contents: write
-
-jobs:
-  release:
-    name: "Create release"
-    runs-on: ubuntu-latest
-    outputs:
-      upload_url: ${{ steps.create_release.outputs.upload_url }}
-    steps:
-      - name: "Create release"
-        uses: softprops/action-gh-release@v1
-        id: create_release
-        with:
-          draft: true
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-  # Build artifact for the release
-  package_compiled:
-    name: "Build packages"
-    needs: release
-    strategy:
-      matrix:
-        include:
-          - os: ubuntu-latest
-            asset_path: build/ftxui*Linux*
-          - os: macos-latest
-            asset_path: build/ftxui*Darwin*
-          - os: windows-latest
-            asset_path: build/ftxui*Win64*
-    runs-on: ${{ matrix.os }}
-    steps:
-      - name: Get number of CPU cores
-        uses: SimenB/github-actions-cpu-cores@v1
-        id: cpu-cores
-
-      - name: "Checkout repository"
-        uses: actions/checkout@v3
-
-      - name: "Install cmake"
-        uses: lukka/get-cmake@latest
-
-      - name: "Build packages"
-        run: >
-          mkdir build;
-          cd build;
-          cmake ..
-          -DCMAKE_BUILD_TYPE=Release
-          -DCMAKE_BUILD_PARALLEL_LEVEL=${{ steps.cpu-cores.outputs.count }}
-          -DFTXUI_BUILD_DOCS=OFF
-          -DFTXUI_BUILD_EXAMPLES=OFF
-          -DFTXUI_BUILD_TESTS=OFF
-          -DFTXUI_BUILD_TESTS_FUZZER=OFF
-          -DFTXUI_ENABLE_INSTALL=ON
-          -DFTXUI_DEV_WARNINGS=ON ;
-          cmake --build . --target package;
-
-      - uses: shogo82148/actions-upload-release-asset@v1
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: ${{ matrix.asset_path }}
-          overwrite: true
-
-  # Build "source" artifact for the release. This is the same as the github
-  # "source" archive, but with a stable URL. This is useful for the Bazel
-  # Central Repository.
-  package_source:
-    name: "Build source package"
-    needs: release
-    runs-on: ubuntu-latest
-    steps:
-      - name: "Checkout repository"
-        uses: actions/checkout@v3
-
-      - name: "Create source package"
-        run: >
-          git archive --format=tar.gz -o source.tar.gz HEAD
-
-      - name: "Upload source package"
-        uses: shogo82148/actions-upload-release-asset@v1
-        with:
-          upload_url: ${{ needs.release.outputs.upload_url }}
-          asset_path: source.tar.gz
-          overwrite: true

.gitignore

@@ -1,72 +0,0 @@
-# Ignore all the files, except the ones we expect.
-# See https://jasonstitt.com/gitignore-whitelisting-patterns
-*
-!*/
-
-# Ignore build directories generated by default MSVC CMake integration
-# (otherwise causes terribly slow indexing)
-out/
-
-# Allowed top-level files:
-!.clang-format
-!.clang-tidy
-!.gitignore
-!CHANGELOG.md
-!CMakeLists.txt
-!LICENSE
-!README.md
-!codecov.yml
-!flake.lock
-!flake.nix
-!ftxui.pc.in
-!iwyu.imp
-!WORKSPACE.bazel
-!BUILD.bazel
-!MODULE.bazel
-!.bazelrc
-
-# .github directory:
-!.github/**/*.yaml
-!.github/**/*.yml
-
-# cmake directory:
-!cmake/**/*.in
-!cmake/**/*.cmake
-
-# bazel directory:
-!bazel/**/*.bzl
-!.bcr/*
-
-# doc directory:
-!doc/**/Doxyfile.in
-!doc/**/*.txt
-!doc/**/*.css
-!doc/**/*.html
-!doc/**/*.xml
-!doc/**/*.md
-
-# examples directory:
-!examples/**/*.cpp
-!examples/**/*.css
-!examples/**/*.hpp
-!examples/**/*.html
-!examples/**/*.html.disabled
-!examples/**/*.ipp
-!examples/**/*.js
-!examples/**/*.mjs
-!examples/**/*.py
-!examples/**/*.txt
-
-# include directory:
-!include/ftxui/**/*.hpp
-!include/ftxui/**/*.cpp
-
-# src directory:
-!src/ftxui/*.cppm
-!src/ftxui/**/*.hpp
-!src/ftxui/**/*.cpp
-!src/ftxui/**/*.cppm
-
-# tools directory:
-!tools/**/*.sh
-!tools/**/*.cpp

BUILD.bazel

@@ -1,276 +0,0 @@
-# Copyright 2025 Arthur Sonzogni. All rights reserved.
-# Use of this source code is governed by the MIT license that can be found in
-# the LICENSE file.
-
-# TODO:
-# - Build benchmark.
-# - Build fuzzers.
-# - Build documentation.
-# - Enable the two tests timing out.
-# - Support WebAssembly
-
-load("@rules_cc//cc:defs.bzl", "cc_binary", "cc_library", "cc_test")
-load(":bazel/ftxui.bzl", "ftxui_cc_library")
-load(":bazel/ftxui.bzl", "generate_examples")
-load(":bazel/ftxui.bzl", "windows_copts")
-
-# A meta target depending on all of the ftxui submodules.
-# Note that component depends on dom and screen, so ftxui is just an alias for 
-# component.
-# ┌component──┐
-# │┌dom──────┐│
-# ││┌screen─┐││
-# └┴┴───────┴┴┘
-alias(name = "ftxui", actual = ":component")
-
-# @ftxui:screen is a module that provides a screen buffer and color management
-# for terminal applications. A screen is a 2D array of cells, each cell can
-# contain a glyph, a color, and other attributes. The library also provides
-# functions to manipulate the screen.
-ftxui_cc_library(
-    name = "screen",
-    srcs = [
-        "src/ftxui/screen/box.cpp",
-        "src/ftxui/screen/color.cpp",
-        "src/ftxui/screen/color_info.cpp",
-        "src/ftxui/screen/image.cpp",
-        "src/ftxui/screen/screen.cpp",
-        "src/ftxui/screen/string.cpp",
-        "src/ftxui/screen/string_internal.hpp",
-        "src/ftxui/screen/terminal.cpp",
-        "src/ftxui/screen/util.hpp",
-    ],
-    hdrs = [
-        "include/ftxui/screen/box.hpp",
-        "include/ftxui/screen/color.hpp",
-        "include/ftxui/screen/color_info.hpp",
-        "include/ftxui/screen/deprecated.hpp",
-        "include/ftxui/screen/image.hpp",
-        "include/ftxui/screen/pixel.hpp",
-        "include/ftxui/screen/screen.hpp",
-        "include/ftxui/screen/string.hpp",
-        "include/ftxui/screen/terminal.hpp",
-        "include/ftxui/util/autoreset.hpp",
-        "include/ftxui/util/ref.hpp",
-    ],
-)
-
-# @ftxui:dom is a library that provides a way to create and manipulate a
-# "document" that can be rendered to a screen. The document is a tree of nodes.
-# Nodes can be text, layouts, or various decorators. Users needs to compose
-# nodes to create a document. A document is responsive to the size of the
-# screen.
-ftxui_cc_library(
-    name = "dom",
-    srcs = [
-        "src/ftxui/dom/automerge.cpp",
-        "src/ftxui/dom/blink.cpp",
-        "src/ftxui/dom/bold.cpp",
-        "src/ftxui/dom/border.cpp",
-        "src/ftxui/dom/box_helper.cpp",
-        "src/ftxui/dom/box_helper.hpp",
-        "src/ftxui/dom/canvas.cpp",
-        "src/ftxui/dom/clear_under.cpp",
-        "src/ftxui/dom/color.cpp",
-        "src/ftxui/dom/composite_decorator.cpp",
-        "src/ftxui/dom/dbox.cpp",
-        "src/ftxui/dom/dim.cpp",
-        "src/ftxui/dom/flex.cpp",
-        "src/ftxui/dom/flexbox.cpp",
-        "src/ftxui/dom/flexbox_config.cpp",
-        "src/ftxui/dom/flexbox_helper.cpp",
-        "src/ftxui/dom/flexbox_helper.hpp",
-        "src/ftxui/dom/focus.cpp",
-        "src/ftxui/dom/frame.cpp",
-        "src/ftxui/dom/gauge.cpp",
-        "src/ftxui/dom/graph.cpp",
-        "src/ftxui/dom/gridbox.cpp",
-        "src/ftxui/dom/hbox.cpp",
-        "src/ftxui/dom/hyperlink.cpp",
-        "src/ftxui/dom/inverted.cpp",
-        "src/ftxui/dom/italic.cpp",
-        "src/ftxui/dom/linear_gradient.cpp",
-        "src/ftxui/dom/node.cpp",
-        "src/ftxui/dom/node_decorator.cpp",
-        "src/ftxui/dom/node_decorator.hpp",
-        "src/ftxui/dom/paragraph.cpp",
-        "src/ftxui/dom/reflect.cpp",
-        "src/ftxui/dom/scroll_indicator.cpp",
-        "src/ftxui/dom/selection.cpp",
-        "src/ftxui/dom/selection_style.cpp",
-        "src/ftxui/dom/separator.cpp",
-        "src/ftxui/dom/size.cpp",
-        "src/ftxui/dom/spinner.cpp",
-        "src/ftxui/dom/strikethrough.cpp",
-        "src/ftxui/dom/table.cpp",
-        "src/ftxui/dom/text.cpp",
-        "src/ftxui/dom/underlined.cpp",
-        "src/ftxui/dom/underlined_double.cpp",
-        "src/ftxui/dom/util.cpp",
-        "src/ftxui/dom/vbox.cpp",
-    ],
-    hdrs = [
-        "include/ftxui/dom/canvas.hpp",
-        "include/ftxui/dom/deprecated.hpp",
-        "include/ftxui/dom/direction.hpp",
-        "include/ftxui/dom/elements.hpp",
-        "include/ftxui/dom/flexbox_config.hpp",
-        "include/ftxui/dom/linear_gradient.hpp",
-        "include/ftxui/dom/node.hpp",
-        "include/ftxui/dom/requirement.hpp",
-        "include/ftxui/dom/selection.hpp",
-        "include/ftxui/dom/table.hpp",
-        "include/ftxui/dom/take_any_args.hpp",
-    ],
-    deps = [":screen"],
-)
-
-# @ftxui:component is a library to create "dynamic" component renderering and
-# updating a ftxui::dom document on the screen. It is a higher level API than
-# ftxui:dom.
-#
-# The module is required if your program needs to respond to user input. It
-# defines a set of ftxui::Component. These components can be utilized to
-# navigate using the arrow keys and/or cursor. There are several builtin widgets
-# like checkbox/inputbox/etc to interact with. You can combine them, or even
-# define your own custom components.
-ftxui_cc_library(
-    name = "component",
-    srcs = [
-        "src/ftxui/component/animation.cpp",
-        "src/ftxui/component/button.cpp",
-        "src/ftxui/component/catch_event.cpp",
-        "src/ftxui/component/checkbox.cpp",
-        "src/ftxui/component/collapsible.cpp",
-        "src/ftxui/component/component.cpp",
-        "src/ftxui/component/component_options.cpp",
-        "src/ftxui/component/container.cpp",
-        "src/ftxui/component/dropdown.cpp",
-        "src/ftxui/component/event.cpp",
-        "src/ftxui/component/hoverable.cpp",
-        "src/ftxui/component/input.cpp",
-        "src/ftxui/component/loop.cpp",
-        "src/ftxui/component/maybe.cpp",
-        "src/ftxui/component/menu.cpp",
-        "src/ftxui/component/modal.cpp",
-        "src/ftxui/component/radiobox.cpp",
-        "src/ftxui/component/renderer.cpp",
-        "src/ftxui/component/resizable_split.cpp",
-        "src/ftxui/component/screen_interactive.cpp",
-        "src/ftxui/component/slider.cpp",
-        "src/ftxui/component/task.cpp",
-        "src/ftxui/component/task_internal.hpp",
-        "src/ftxui/component/task_queue.cpp",
-        "src/ftxui/component/task_queue.hpp",
-        "src/ftxui/component/task_runner.cpp",
-        "src/ftxui/component/task_runner.hpp",
-        "src/ftxui/component/terminal_input_parser.cpp",
-        "src/ftxui/component/terminal_input_parser.hpp",
-        "src/ftxui/component/util.cpp",
-        "src/ftxui/component/window.cpp",
-
-        # Private header from ftxui:dom.
-        "src/ftxui/dom/node_decorator.hpp",
-
-        # Private header from ftxui:screen.
-        "src/ftxui/screen/string_internal.hpp",
-        "src/ftxui/screen/util.hpp",
-
-        # Private header.
-        "include/ftxui/util/warn_windows_macro.hpp",
-    ],
-    hdrs = [
-        "include/ftxui/component/animation.hpp",
-        "include/ftxui/component/captured_mouse.hpp",
-        "include/ftxui/component/component.hpp",
-        "include/ftxui/component/component_base.hpp",
-        "include/ftxui/component/component_options.hpp",
-        "include/ftxui/component/event.hpp",
-        "include/ftxui/component/loop.hpp",
-        "include/ftxui/component/mouse.hpp",
-        "include/ftxui/component/receiver.hpp",
-        "include/ftxui/component/screen_interactive.hpp",
-        "include/ftxui/component/task.hpp",
-    ],
-    deps = [
-        ":dom",
-        ":screen",
-    ],
-)
-
-# FTXUI's tests
-cc_test(
-    name = "tests",
-    testonly = True,
-    srcs = [
-        "src/ftxui/component/animation_test.cpp",
-        "src/ftxui/component/button_test.cpp",
-        "src/ftxui/component/collapsible_test.cpp",
-        "src/ftxui/component/component_test.cpp",
-        "src/ftxui/component/container_test.cpp",
-        "src/ftxui/component/dropdown_test.cpp",
-        "src/ftxui/component/hoverable_test.cpp",
-        "src/ftxui/component/input_test.cpp",
-        "src/ftxui/component/menu_test.cpp",
-        "src/ftxui/component/modal_test.cpp",
-        "src/ftxui/component/radiobox_test.cpp",
-        "src/ftxui/component/resizable_split_test.cpp",
-        "src/ftxui/component/slider_test.cpp",
-        "src/ftxui/component/terminal_input_parser_test.cpp",
-        "src/ftxui/component/toggle_test.cpp",
-        "src/ftxui/dom/blink_test.cpp",
-        "src/ftxui/dom/bold_test.cpp",
-        "src/ftxui/dom/border_test.cpp",
-        "src/ftxui/dom/canvas_test.cpp",
-        "src/ftxui/dom/color_test.cpp",
-        "src/ftxui/dom/dbox_test.cpp",
-        "src/ftxui/dom/dim_test.cpp",
-        "src/ftxui/dom/flexbox_helper_test.cpp",
-        "src/ftxui/dom/flexbox_test.cpp",
-        "src/ftxui/dom/gauge_test.cpp",
-        "src/ftxui/dom/gridbox_test.cpp",
-        "src/ftxui/dom/hbox_test.cpp",
-        "src/ftxui/dom/hyperlink_test.cpp",
-        "src/ftxui/dom/italic_test.cpp",
-        "src/ftxui/dom/linear_gradient_test.cpp",
-        "src/ftxui/dom/scroll_indicator_test.cpp",
-        "src/ftxui/dom/separator_test.cpp",
-        "src/ftxui/dom/spinner_test.cpp",
-        "src/ftxui/dom/table_test.cpp",
-        "src/ftxui/dom/text_test.cpp",
-        "src/ftxui/dom/underlined_test.cpp",
-        "src/ftxui/dom/vbox_test.cpp",
-        "src/ftxui/screen/color_test.cpp",
-        "src/ftxui/screen/string_test.cpp",
-        "src/ftxui/util/ref_test.cpp",
-
-        # Private header from ftxui:screen for string_test.cpp.
-        "src/ftxui/screen/string_internal.hpp",
-
-        # Private header from ftxui::component for
-        # terminal_input_parser_test.cpp.
-        "src/ftxui/component/terminal_input_parser.hpp",
-
-        # Private header from ftxui::dom for
-        # flexbox_helper_test.cpp.
-        "src/ftxui/dom/flexbox_helper.hpp",
-
-        # TODO: Enable the two tests timing out with Bazel:
-        # - "src/ftxui/component/screen_interactive_test.cpp",
-        # - "src/ftxui/dom/selection_test.cpp",
-    ],
-    includes = [
-        "include",
-        "src",
-    ],
-    copts = windows_copts(),
-    deps = [
-        ":screen",
-        ":dom",
-        ":component",
-        "@googletest//:gtest",
-        "@googletest//:gtest_main",
-    ],
-)
-
-generate_examples()

CHANGELOG.md

@@ -1,264 +1,24 @@
 Changelog
 =========
 
-Next
-====
-
-### Doc
-- Fix broken Doxygen output. See @markmandel in #1029.
-- Use Doxygen awesome. Add our own theme.
-- Break the documentation into several pages.
-
-### Build
-- Feature: Support C++20 modules. 
-  This requires:
-  - Using the Ninja or MSVC generator
-  - A recent Clang/GCC/MSVC compiler.
-  - Cmake 3.28 or higher.
-  Usage:
-  ```cpp
-  import ftxui;
-  import ftxui.component;
-  import ftxui.dom;
-  import ftxui.screen;
-  import ftxui.util;
-  ```
-  Thanks @mikomikotaishi for PR #1015.
-- Remove dependency on 'pthread'.
-
-### Component
-- Fix ScreenInteractive::FixedSize screen stomps on the preceding terminal
-  output. Thanks @zozowell in #1064.
-- Fix vertical `ftxui::Slider`. The "up" key was previously decreasing the
-  value. Thanks @its-pablo in #1093 for reporting the issue.
-
-
-6.1.9 (2025-05-07)
-------------
-
-### Build
-If all goes well (pending), ftxui should appear in the Bazel central repository.
-It can be imported into your project using the following lines:
-
-**MODULE.bazel**
-```bazel
-bazel_dep(name = "ftxui", version = "6.1.9")
-```
-
-Thanks @robinlinden and @kcc for the reviews.
-
-### dom
-- Bugfix: Restore the `dbox` behavior from ftxui 5.0.0. To apply bgcolor
-  blending between the two layers, a new `dboxBlend` will be added.
-
-6.1.8 (2025-05-01)
-------------------
-
-### Build
-- Feature: Support `bazel` build system. See #1032.
-  Proposed by Kostya Serebryany @kcc
-
-  **BUILD.bazel**
-  ```bazel
-  deps = [
-    // Depend on the whole library:
-    "@ftxui//:ftxui",
-
-    // Choose a specific submodule:
-    "@ftxui//:component",
-    "@ftxui//:dom",
-    "@ftxui//:screen",
-  ]
-  ```
-
-### Component
-- Bugfix: Fix a crash with ResizeableSplit. See #1023.
-  - Clamp screen size to terminal size.
-  - Disallow `ResizeableSplit` with negative size.
-
-### Dom
-- Bugfix: Disallow specifying a negative size constraint. See #1023.
-
-
-6.0.2 (2025-03-30)
------
-
-### Component
-- BugFix: Fix major crash on Windows affecting all components. See #1020
-- BugFix: Fix focusRelative.
-
-6.0.1 (2025-03-28)
------
-
-Same as v6.0.0.
-
-Due to a problem tag v6.0.0 was replaced. This isn't a good practice and affect
-developers that started using it in the short timeframe. Submitting a new
-release with the same content is the best way to fix this.
-
-See #1017 and #1019.
-
-6.0.0 (2025-03-23)
------
-
-### Component
-- Feature: Add support for raw input. Allowing more keys to be detected.
-- Feature: Add `ScreenInteractive::ForceHandleCtrlC(false)` to allow component
-  to fully override the default `Ctrl+C` handler.
-- Feature: Add `ScreenInteractive::ForceHandleCtrlZ(false)` to allow component
-  to fully override the default `Ctrl+Z` handler.
-- Feature: Add `Mouse::WeelLeft` and `Mouse::WeelRight` events on supported
-  terminals.
-- Feature: Add `Event::DebugString()`.
-- Feature: Add support for `Input`'s insert mode. Add `InputOption::insert`
-  option. Added by @mingsheng13.
-- Feature: Add `DropdownOption` to configure the dropdown. See #826.
-- Feature: Add support for Selection. Thanks @clement-roblot. See #926.
-  - See `ScreenInteractive::GetSelection()`.
-  - See `ScreenInteractive::SelectionChange(...)` listener.
-- Bugfix/Breaking change: `Mouse transition`:
-  - Detect when the mouse move, as opposed to being pressed.
-    The Mouse::Moved motion was added.
-  - Dragging the mouse with the left button pressed now avoids activating
-    multiple checkboxes.
-  - A couple of components are now activated when the mouse is pressed,
-  as opposed to being released.
-  This fixes: https://github.com/ArthurSonzogni/FTXUI/issues/773
-  This fixes: https://github.com/ArthurSonzogni/FTXUI/issues/792
-- Bugfix: mouse.control is now reported correctly.
-- Feature: Add `ScreenInteractive::FullscreenPrimaryScreen()`. This allows
-  displaying a fullscreen component on the primary screen, as opposed to the
-  alternate screen.
-- Bugfix: `Input` `onchange` was not called on backspace or delete key.
-  Fixed by @chrysante in chrysante in PR #776.
-- Bugfix: Propertly restore cursor shape on exit. See #792.
-- Bugfix: Fix cursor position in when in the last column. See #831.
-- Bugfix: Fix `ResizeableSplit` keyboard navigation. Fixed by #842.
-- Bugfix: Fix `Menu` focus. See #841
-- Feature: Add `ComponentBase::Index()`. This allows to get the index of a
-  component in its parent. See #932
-- Feature: Add `EntryState::index`. This allows to get the index of a menu entry.
-  See #932
-- Feature: Add `SliderOption::on_change`. This allows to set a callback when the
-  slider value changes. See #938.
-- Bugfix: Handle `Dropdown` with no entries.
-- Bugfix: Fix crash in `LinearGradient` due to float precision and an off-by-one
-          mistake. See #998.
-
-### Dom
-- Feature: Add `italic` decorator. For instance:
-  ```cpp
-  auto italic_text = text("Italic text") | italic;
-  ```
-  ```cpp
-  auto italic_text = italic(text("Italic text"));
-  ```
-  Proposed by @kenReneris in #1009.
-- Feature: Add `hscroll_indicator`. It display an horizontal indicator
-  reflecting the current scroll position. Proposed by @ibrahimnasson in
-  [issue 752](https://github.com/ArthurSonzogni/FTXUI/issues/752)
-- Feature: Add `extend_beyond_screen` option to `Dimension::Fit(..)`, allowing
-  the element to be larger than the screen. Proposed by @LordWhiro. See #572 and
-  #949.
-- Feature: Add support for Selection. Thanks @clement-roblot. See #926.
-  - See `selectionColor` decorator.
-  - See `selectionBackgroundColor` decorator.
-  - See `selectionForegroundColor` decorator.
-  - See `selectionStyle(style)` decorator.
-  - See `selectionStyleReset` decorator.
-- Breaking change: Change how "focus"/"select" are handled. This fixes the
-  behavior.
-- Breaking change: `Component::OnRender()` becomes the method to override to
-  render a component. This replaces `Component::Render()` that is still in use
-  to call the rendering method on the children. This change allows to fix a
-  couple of issues around focus handling.
-
-### Screen
-- Feature: Add `Box::IsEmpty()`.
-- Feature: Color transparency
-    - Add `Color::RGBA(r,g,b,a)`.
-    - Add `Color::HSVA(r,g,b,a)`.
-    - Add `Color::Blend(Color)`.
-    - Add `Color::IsOpaque()`
-
-### Util
-- Feature: Support arbitrary `Adapter` for `ConstStringListRef`. See #843.
-
-### Build
-- Support for cmake's "unity/jumbo" builds. Fixed by @ClausKlein.
-
-5.0.0
------
-
-### Component
-- Breaking: MenuDirection enum is renamed Direction
-- Breaking: GaugeDirection enum is renamed Direction
-- Breaking: Direction enum is renamed WidthOrHeight
-- Breaking: Remove `ComponentBase` copy constructor/assignment.
-- Breaking: MenuOption::entries is renamed MenuOption::entries_option.
-- Breaking: `Ref<{Component}Option>` becomes `{Component}Option` in component constructors.
-- Feature: `ResizeableSplit` now support arbitrary element as a separator.
-- Feature: `input` is now supporting multiple lines.
-- Feature: `input` style is now customizeable.
-- Bugfix: Support F1-F5 from OS terminal.
-- Feature: Add struct based constructor:
-  ```cpp
-  Component Button(ButtonOption options);
-  Component Checkbox(CheckboxOption options);
-  Component Input(InputOption options);
-  Component Menu(MenuOption options);
-  Component MenuEntry(MenuEntryOption options);
-  Component Radiobox(RadioboxOption options);
-  Component Slider(SliderOption<T> options);
-  Component ResizableSplit(ResizableSplitOption options);
-  ```
-- Feature: Add `ScreenInteractive::TrackMouse(false)` disable mouse support.
-
-### Dom
-- Feature: Add `hyperlink` decorator. For instance:
-  ```cpp
-  auto link = text("Click here") | hyperlink("https://github.com/FTXUI")
-  ```
-  See the [OSC 8 page](https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda).
-  FTXUI support proposed by @aaleino in [#662](https://github.com/ArthurSonzogni/FTXUI/issues/662).
-
-### Screen
-- Breaking: `WordBreakProperty` becomes a uint8_t enum. This yields a 0.8%
-  performance improvement.
-- Breaking: Remove user defined Pixel constructor and equality operator.
-- Performance: 19% faster on benchmarks.
-
-
-### Build
-- Check version compatibility when using cmake find_package()
-- Add `FTXUI_DEV_WARNING` options to turn on warnings when building FTXUI
-- Turn OFF by default `FTXUI_BUILD_DOCS`
-- Turn OFF by default `FTXUI_BUILD_EXAMPLE`
-
-4.1.1
+4.1.0
 -----
 
 ### Component
+- Feature: Support `ResizableSplit` with customizable separator.
 - Fix: Support arrow keys in application mode
 - Fix: Remove useless new line when using an alternative screen.
 
 ### Dom
-- Feature: Add the dashed style for border and separator:
-  - See `DASHED` enum, and  `separatorDashed()`, `borderDashed()` functions.
+- Feature: Add the dashed style for border and separator.
 - Feature: Add colored borders.
-  - See functions: `borderStyled(BorderStyle, Color)` and `borderStyled(Color)`.
-- Feature: Add `LinearGradient`. It can be used in `color` and `bgColor`.
+- Feature: Add `LinearGradient`!
 - Improvement: Color::Interpolate() uses gamma correction.
 - Fix: Check the `graph` area is positive.
 
 ### Build/Install
 - Use globally set CMAKE_CXX_STANDARD if it is set.
-- Expose the pkg-config file
-- Check version compatibility when using cmake find_package()
-
-4.1.0  (Abandonned)
------
-This version is abandonned and must not be used. It introduced a breaking change in the API.
+- Expose the pkg-config file.
 
 4.0.0
 -----

CMakeLists.txt

@@ -1,26 +1,18 @@
-option(FTXUI_BUILD_DOCS "Set to ON to build docs" OFF)
-option(FTXUI_BUILD_EXAMPLES "Set to ON to build examples" OFF)
-option(FTXUI_BUILD_MODULES "Build the C++20 modules" OFF)
-option(FTXUI_BUILD_TESTS "Set to ON to build tests" OFF)
-option(FTXUI_BUILD_TESTS_FUZZER "Set to ON to enable fuzzing" OFF)
-option(FTXUI_CLANG_TIDY "Execute clang-tidy" OFF)
-option(FTXUI_DEV_WARNINGS "Enable more compiler warnings and warnings as errors" OFF)
-option(FTXUI_ENABLE_COVERAGE "Execute code coverage" OFF)
-option(FTXUI_ENABLE_INSTALL "Generate the install target" ON)
-option(FTXUI_QUIET "Set to ON for FTXUI to be quiet" OFF)
-
-if (FTXUI_BUILD_MODULES)
-  cmake_minimum_required(VERSION 3.28.2)
-else()
-  cmake_minimum_required(VERSION 3.12)
-endif()
+cmake_minimum_required(VERSION 3.11)
 
 project(ftxui
   LANGUAGES CXX
-  VERSION 6.1.9
+  VERSION 4.1.0
   DESCRIPTION "C++ Functional Terminal User Interface."
 )
 
+option(FTXUI_BUILD_DOCS "Set to ON to build docs" ON)
+option(FTXUI_BUILD_EXAMPLES "Set to ON to build examples" ON)
+option(FTXUI_BUILD_TESTS "Set to ON to build tests" OFF)
+option(FTXUI_BUILD_TESTS_FUZZER "Set to ON to enable fuzzing" OFF)
+option(FTXUI_ENABLE_INSTALL "Generate the install target" ON)
+option(FTXUI_CLANG_TIDY "Execute clang-tidy" OFF)
+option(FTXUI_ENABLE_COVERAGE "Execute code coverage" OFF)
 
 set(FTXUI_MICROSOFT_TERMINAL_FALLBACK_HELP_TEXT "On windows, assume the \
 terminal used will be one of Microsoft and use a set of reasonnable fallback \
@@ -33,22 +25,16 @@ else()
     ${FTXUI_MICROSOFT_TERMINAL_FALLBACK_HELP_TEXT} OFF)
 endif()
 
-set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
-
-include(cmake/ftxui_message.cmake)
 
 add_library(screen
   include/ftxui/screen/box.hpp
   include/ftxui/screen/color.hpp
   include/ftxui/screen/color_info.hpp
-  include/ftxui/screen/image.hpp
-  include/ftxui/screen/pixel.hpp
   include/ftxui/screen/screen.hpp
   include/ftxui/screen/string.hpp
   src/ftxui/screen/box.cpp
   src/ftxui/screen/color.cpp
   src/ftxui/screen/color_info.cpp
-  src/ftxui/screen/image.cpp
   src/ftxui/screen/screen.cpp
   src/ftxui/screen/string.cpp
   src/ftxui/screen/terminal.cpp
@@ -62,10 +48,8 @@ add_library(dom
   include/ftxui/dom/flexbox_config.hpp
   include/ftxui/dom/node.hpp
   include/ftxui/dom/requirement.hpp
-  include/ftxui/dom/selection.hpp
   include/ftxui/dom/take_any_args.hpp
   src/ftxui/dom/automerge.cpp
-  src/ftxui/dom/selection_style.cpp
   src/ftxui/dom/blink.cpp
   src/ftxui/dom/bold.cpp
   src/ftxui/dom/border.cpp
@@ -88,16 +72,13 @@ add_library(dom
   src/ftxui/dom/graph.cpp
   src/ftxui/dom/gridbox.cpp
   src/ftxui/dom/hbox.cpp
-  src/ftxui/dom/hyperlink.cpp
   src/ftxui/dom/inverted.cpp
-  src/ftxui/dom/italic.cpp
   src/ftxui/dom/linear_gradient.cpp
   src/ftxui/dom/node.cpp
   src/ftxui/dom/node_decorator.cpp
   src/ftxui/dom/paragraph.cpp
   src/ftxui/dom/reflect.cpp
   src/ftxui/dom/scroll_indicator.cpp
-  src/ftxui/dom/selection.cpp
   src/ftxui/dom/separator.cpp
   src/ftxui/dom/size.cpp
   src/ftxui/dom/spinner.cpp
@@ -144,20 +125,25 @@ add_library(component
   src/ftxui/component/resizable_split.cpp
   src/ftxui/component/screen_interactive.cpp
   src/ftxui/component/slider.cpp
-  src/ftxui/component/task.cpp
-  src/ftxui/component/task_internal.hpp
-  src/ftxui/component/task_queue.cpp
-  src/ftxui/component/task_queue.hpp
-  src/ftxui/component/task_runner.cpp
-  src/ftxui/component/task_runner.hpp
   src/ftxui/component/terminal_input_parser.cpp
   src/ftxui/component/terminal_input_parser.hpp
   src/ftxui/component/util.cpp
-  src/ftxui/component/window.cpp
 )
 
-target_link_libraries(dom PUBLIC screen)
-target_link_libraries(component PUBLIC dom)
+target_link_libraries(dom
+  PUBLIC screen
+)
+
+target_link_libraries(component
+  PUBLIC dom
+)
+
+if (NOT EMSCRIPTEN)
+  find_package(Threads)
+  target_link_libraries(component
+    PUBLIC Threads::Threads
+  )
+endif()
 
 include(cmake/ftxui_set_options.cmake)
 ftxui_set_options(screen)
@@ -176,13 +162,6 @@ include(cmake/iwyu.cmake)
 include(cmake/ftxui_export.cmake)
 include(cmake/ftxui_install.cmake)
 include(cmake/ftxui_package.cmake)
-include(cmake/ftxui_modules.cmake)
 
 add_subdirectory(examples)
 add_subdirectory(doc)
-
-# You can generate ./examples_modules/ by running
-# ./tools/generate_examples_modules.sh
-if(EXISTS "${CMAKE_CURRENT_SOURCE_DIR}/examples_modules/CMakeLists.txt")
-  add_subdirectory(examples_modules)
-endif()

MODULE.bazel

@@ -1,13 +0,0 @@
-# FTXUI module.
-module(
-    name = "ftxui",
-    version = "6.1.9",
-    compatibility_level = 6,
-)
-
-# Build dependencies.
-bazel_dep(name = "rules_cc", version = "0.1.1")
-bazel_dep(name = "platforms", version = "0.0.10")
-
-# Test dependencies.
-bazel_dep(name = "googletest", version = "1.14.0.bcr.1", dev_dependency = True)

README.md

@@ -1,16 +1,13 @@
-
 <p align="center">
-  <img src="https://github.com/ArthurSonzogni/FTXUI/assets/4759106/6925b6da-0a7e-49d9-883c-c890e1f36007" alt="Demo image"></img>
+  <img src="./examples/component/homescreen.gif" alt="Demo image"></img>
   <br/>
   <a href="#"><img src="https://img.shields.io/badge/c++-%2300599C.svg?style=flat&logo=c%2B%2B&logoColor=white"></img></a>
   <a href="http://opensource.org/licenses/MIT"><img src="https://img.shields.io/github/license/arthursonzogni/FTXUI?color=black"></img></a>
   <a href="#"><img src="https://img.shields.io/github/stars/ArthurSonzogni/FTXUI"></img></a>
   <a href="#"><img src="https://img.shields.io/github/forks/ArthurSonzogni/FTXUI"></img></a>
   <a href="#"><img src="https://img.shields.io/github/repo-size/ArthurSonzogni/FTXUI"></img></a>
-  <a href="https://github.com/ArthurSonzogni/FTXUI/graphs/contributors"><img src="https://img.shields.io/github/contributors/arthursonzogni/FTXUI?color=blue"></img></a>
-  <br/>
   <a href="https://github.com/ArthurSonzogni/FTXUI/issues"><img src="https://img.shields.io/github/issues/ArthurSonzogni/FTXUI"></img></a>
-  <a href="https://repology.org/project/ftxui/versions"><img src="https://repology.org/badge/latest-versions/ftxui.svg" alt="latest packaged version(s)"></a>
+  <a href="https://github.com/ArthurSonzogni/FTXUI/graphs/contributors"><img src="https://img.shields.io/github/contributors/arthursonzogni/FTXUI?color=blue"></img></a>
   <a href="https://codecov.io/gh/ArthurSonzogni/FTXUI">
     <img src="https://codecov.io/gh/ArthurSonzogni/FTXUI/branch/master/graph/badge.svg?token=C41FdRpNVA"/>
   </a>
@@ -19,74 +16,74 @@
   <br/>
   <a href="https://arthursonzogni.github.io/FTXUI/">Documentation</a> ·
   <a href="https://github.com/ArthurSonzogni/FTXUI/issues">Report a Bug</a> ·
-  <a href="https://arthursonzogni.github.io/FTXUI/examples/">Examples</a> .
+  <a href="https://arthursonzogni.github.io/FTXUI/examples.html">Examples</a> .
   <a href="https://github.com/ArthurSonzogni/FTXUI/issues">Request Feature</a> ·
   <a href="https://github.com/ArthurSonzogni/FTXUI/pulls">Send a Pull Request</a>
 
 </p>
 
-# FTXUI
+## FTXUI
 
 <i>Functional Terminal (X) User interface</i>
 
-A simple cross-platform C++ library for terminal based user interfaces!
+A simple C++ library for terminal based user interfaces!
 
 ## Feature
  * Functional style. Inspired by
-   [1](https://hackernoon.com/building-reactive-terminal-interfaces-in-c-d392ce34e649?gi=d9fb9ce35901)
+   [[1]](https://hackernoon.com/building-reactive-terminal-interfaces-in-c-d392ce34e649?gi=d9fb9ce35901)
    and [React](https://reactjs.org/)
  * Simple and elegant syntax (in my opinion)
  * Keyboard & mouse navigation.
  * Support for [UTF8](https://en.wikipedia.org/wiki/UTF-8) and [fullwidth chars](https://en.wikipedia.org/wiki/Halfwidth_and_fullwidth_forms) (→ 测试)
  * Support for animations. [Demo 1](https://arthursonzogni.github.io/FTXUI/examples/?file=component/menu_underline_animated_gallery), [Demo 2](https://arthursonzogni.github.io/FTXUI/examples/?file=component/button_style)
  * Support for drawing. [Demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/canvas_animated)
- * No dependencies.
- * [C++20 Module support](https://arthursonzogni.github.io/FTXUI/cpp20-modules.html)
- * **Cross platform**: Linux/MacOS (main target), WebAssembly, Windows (Thanks to contributors!).
+ * No dependencies
+ * Cross platform: Linux/MacOS (main target), WebAssembly, Windows (Thanks to contributors!).
  * Learn by [examples](#documentation), and [tutorials](#documentation)
- * Multiple packages:
-     - CMake [FetchContent]([https://bewagner.net/programming/2020/05/02/cmake-fetchcontent/](https://cmake.org/cmake/help/latest/module/FetchContent.html)) (preferred)
-     - [Bazel](https://registry.bazel.build/modules/ftxui)
-     - [vcpkg](https://vcpkg.link/ports/ftxui)
-     - [Conan](https://conan.io/center/recipes/ftxui) [Debian package](https://tracker.debian.org/pkg/ftxui)
-     - [Ubuntu package](https://launchpad.net/ubuntu/+source/ftxui)
-     - [Arch Linux](https://aur.archlinux.org/packages/ftxui/)
-    - [OpenSUSE](https://build.opensuse.org/package/show/devel:libraries:c_c++/ftxui)
-    - [XMake](https://xmake.io) repository [package](https://github.com/xmake-io/xmake-repo/blob/dev/packages/f/ftxui/xmake.lua)
-    - [Nix](https://github.com/ArthurSonzogni/FTXUI/blob/main/flake.nix)
- * Good practices: documentation, tests, fuzzers, performance tests, automated CI, automated packaging, etc...
+ * Multiple packages: CMake [FetchContent](https://bewagner.net/programming/2020/05/02/cmake-fetchcontent/) (preferred), vcpkg, pkgbuild, conan.
+ * Good practises: documentation, tests, fuzzers, performance tests, automated CI, automated packaging, etc...
 
 ## Documentation
 
-- [Starter CMake](https://github.com/ArthurSonzogni/ftxui-starter)
-- [Starter Bazel](https://github.com/ArthurSonzogni/ftxui-bazel)
+- [Starter example project](https://github.com/ArthurSonzogni/ftxui-starter)
 - [Documentation](https://arthursonzogni.github.io/FTXUI/)
 - [Examples (WebAssembly)](https://arthursonzogni.github.io/FTXUI/examples/)
 - [Build using CMake](https://arthursonzogni.github.io/FTXUI/#build-cmake)
-- [Build using Bazel](https://arthursonzogni.github.io/FTXUI/#build-bazel)
+
+## Operating systems
+
+This is expected to be cross platform. This supports / tests:
+- WebAssembly
+- Linux
+- MacOS
+- Windows
 
 ## Example
 ~~~cpp
   vbox({
     hbox({
-        text("one") | border,
-        text("two") | border | flex,
-        text("three") | border | flex,
+      text("left") | border,
+      text("middle") | border | flex,
+      text("right") | border,
     }),
-
-      gauge(0.25) | color(Color::Red),
-      gauge(0.50) | color(Color::White),
-      gauge(0.75) | color(Color::Blue),
+    gauge(0.5) | border,
   });
 ~~~
 
-![image](https://github.com/ArthurSonzogni/FTXUI/assets/4759106/569bf043-4e85-4245-aad5-2324572135c4)
+~~~bash
+┌────┐┌───────────────────────────────────────────────────────────────┐┌─────┐
+│left││middle                                                         ││right│
+└────┘└───────────────────────────────────────────────────────────────┘└─────┘
+┌────────────────────────────────────────────────────────────────────────────┐
+│██████████████████████████████████████                                      │
+└────────────────────────────────────────────────────────────────────────────┘
+~~~
 
 ## Short gallery
 
 #### DOM
 
-This module defines a hierarchical set of Element. An Element manages layout and can be responsive to the terminal dimensions.
+This module defines a hierarchical set of Element. An element manages layout and can be responsive to the terminal dimensions.
 
 They are declared in [<ftxui/dom/elements.hpp>](https://arthursonzogni.github.io/FTXUI/elements_8hpp_source.html
 )
@@ -99,14 +96,14 @@ Element can be arranged together:
   - inside a grid with `gridbox`
   - wrap along one direction using the `flexbox`.
   
-Element can become flexible using the `flex` decorator.
+Element can become flexible using the the `flex` decorator.
   
 [Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2vbox_hbox_8cpp-example.html) using `hbox`, `vbox` and `filler`.
 
 ![image](https://user-images.githubusercontent.com/4759106/147242524-7103b5d9-1a92-4e2d-ac70-b3d6740061e3.png)
   
   
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2gridbox_8cpp-example.html) using gridbox:
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2gridbox_8cpp-example.htmlp) using gridbox:
 
 ![image](https://user-images.githubusercontent.com/4759106/147242972-0db1f2e9-0790-496f-86e6-ed2c604f7a73.png)
 
@@ -122,7 +119,6 @@ Element can become flexible using the `flex` decorator.
 
 An element can be decorated using the functions:
   - `bold`
-  - `italic`
   - `dim`
   - `inverted`
   - `underlined`
@@ -131,7 +127,6 @@ An element can be decorated using the functions:
   - `strikethrough`
   - `color`
   - `bgcolor`
-  - `hyperlink`
 
 [Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2style_gallery_8cpp-example.html)
 
@@ -213,7 +208,7 @@ Complex [examples](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/
 
 #### Component
 
-ftxui/component produces dynamic UI, reactive to the user's input. It defines a set of ftxui::Component. A component reacts to Events (keyboard, mouse, resize, ...) and Renders as an Element (see previous section).
+The ftxui/component is needed when you want to produce dynamic UI, reactive to the user's input. It defines a set of ftxui::Component. A component reacts to Events (keyboard, mouse, resize, ...) and Render Element (see previous section).
 
 Prebuilt components are declared in [<ftxui/component/component.hpp>](https://arthursonzogni.github.io/FTXUI/component_8hpp_source.html)
 
@@ -306,11 +301,8 @@ Prebuilt components are declared in [<ftxui/component/component.hpp>](https://ar
 
 </details>
 
-## Libraries for FTXUI
-- *Want to share a useful Component for FTXUI? Feel free to add yours here*
-- [ftxui-grid-container](https://github.com/mingsheng13/grid-container-ftxui)
-- [ftxui-ip-input](https://github.com/mingsheng13/ip-input-ftxui)
-- [ftxui-image-view](https://github.com/ljrrjl/ftxui-image-view.git): For Image Display.
+
+
 
 
 ## Project using FTXUI
@@ -318,12 +310,12 @@ Prebuilt components are declared in [<ftxui/component/component.hpp>](https://ar
 Feel free to add your projects here:
 - [json-tui](https://github.com/ArthurSonzogni/json-tui)
 - [git-tui](https://github.com/ArthurSonzogni/git-tui)
-- [ostree-tui](https://github.com/AP-Sensing/ostree-tui)
 - [rgb-tui](https://github.com/ArthurSonzogni/rgb-tui)
 - [chrome-log-beautifier](https://github.com/ArthurSonzogni/chrome-log-beautifier)
 - [x86-64 CPU Architecture Simulation](https://github.com/AnisBdz/CPU)
 - [ltuiny](https://github.com/adrianoviana87/ltuiny)
 - [i3-termdialogs](https://github.com/mibli/i3-termdialogs)
+- [Just-Fast](https://github.com/GiuseppeCesarano/just-fast)
 - [simpPRU](https://github.com/VedantParanjape/simpPRU)
 - [Pigeon ROS TUI](https://github.com/PigeonSensei/Pigeon_ros_tui)
 - [hastur](https://github.com/robinlinden/hastur)
@@ -338,35 +330,8 @@ Feel free to add your projects here:
 - [turing_cmd](https://github.com/DanArmor/turing_cmd)
 - [StartUp](https://github.com/StubbornVegeta/StartUp)
 - [eCAL monitor](https://github.com/eclipse-ecal/ecal)
-- [Path Finder](https://github.com/Ruebled/Path_Finder)
-- [rw-tui](https://github.com/LeeKyuHyuk/rw-tui)
-- [resource-monitor](https://github.com/catalincd/resource-monitor)
-- [ftxuiFileReader](https://github.com/J0sephDavis/ftxuiFileReader)
-- [ftxui_CPUMeter](https://github.com/tzzzzzzzx/ftxui_CPUMeter)
-- [Captain's log](https://github.com/nikoladucak/caps-log)
-- [FTowerX](https://github.com/MhmRhm/FTowerX)
-- [Caravan](https://github.com/r3w0p/caravan)
-- [Step-Writer](https://github.com/BrianAnakPintar/step-writer)
-- [XJ music](https://github.com/xjmusic/xjmusic)
-- [UDP chat](https://github.com/Sergeydigl3/udp-chat-tui)
-- [2048-cpp](https://github.com/Chessom/2048-cpp)
-- [Memory game](https://github.com/mikolajlubiak/memory)
-- [Terminal Animation](https://github.com/mikolajlubiak/terminal_animation)
-- [pciex](https://github.com/s0nx/pciex)
-- [Fallout terminal hacking](https://github.com/gshigin/yet-another-fallout-terminal-hacking-game)
-- [Lazylist](https://github.com/zhuyongqi9/lazylist)
-- [TUISIC](https://github.com/Dark-Kernel/tuisic)
-- [inLimbo](https://github.com/nots1dd/inLimbo)
-- [BestEdrOfTheMarket](https://github.com/Xacone/BestEdrOfTheMarket)
-- [terminal-rain](https://github.com/Oakamoore/terminal-rain)
-- [keywords](https://github.com/Oakamoore/keywords) ([Play web version :heart:](https://oakamoore.itch.io/keywords))
-- [FTB - tertminal file browser](https://github.com/Cyxuan0311/FTB)
-- [openJuice](https://github.com/mikomikotaishi/openJuice)
-- [SHOOT!](https://github.com/ShingZhanho/ENGG1340-Project-25Spring)
-- [VerifySN (Fast Hash Tool)](https://github.com/d06i/verifySN)
-- [tic-tac-toe](https://github.com/birland/tic-tac-toe)
 
-### [cpp-best-practices/game_jam](https://github.com/cpp-best-practices/game_jam)
+## [cpp-best-practices/game_jam](https://github.com/cpp-best-practices/game_jam)
 
 Several games using the FTXUI have been made during the Game Jam:
 - [TermBreaker](https://github.com/ArthurSonzogni/termBreaker) [**[Play web version]**](https://arthursonzogni.com/TermBreaker/)
@@ -381,69 +346,29 @@ Several games using the FTXUI have been made during the Game Jam:
 - [smoothlife](https://github.com/cpp-best-practices/game_jam/blob/main/Jam1_April_2022/smoothlife.md)
 - [Consu](https://github.com/cpp-best-practices/game_jam/blob/main/Jam1_April_2022/consu.md)
 
-## Build using CMake
+## External package
 
-It is **highly** recommended to use CMake FetchContent to depend on FTXUI so you may specify which commit you would like to depend on.
+It is **highly** recommended to use CMake FetchContent to depend on FTXUI. This
+way you can specify which commit you would like to depend on.
 ```cmake
 include(FetchContent)
+
 FetchContent_Declare(ftxui
   GIT_REPOSITORY https://github.com/ArthurSonzogni/ftxui
-  GIT_TAG v6.1.9
+  GIT_TAG v3.0.0
 )
-FetchContent_MakeAvailable(ftxui)
 
-target_link_libraries(your_target PRIVATE
-    # Chose a submodule
-    ftxui::component
-    ftxui::dom
-    ftxui::screen
-)
+FetchContent_GetProperties(ftxui)
+if(NOT ftxui_POPULATED)
+  FetchContent_Populate(ftxui)
+  add_subdirectory(${ftxui_SOURCE_DIR} ${ftxui_BINARY_DIR} EXCLUDE_FROM_ALL)
+endif()
 ```
 
-# Build using Bazel
-
-**MODULE.bazel**
-```starlark
-bazel_dep(
-    name = "ftxui",
-    version = "v6.1.9",
-)
-```
-
-**BUILD.bazel**
-```starlark
-cc_binary(
-    name = "your_target",
-    srcs = ["your_source.cc"],
-    deps = [
-        "@ftxui//:ftxui_component",
-        "@ftxui//:ftxui_dom",
-        "@ftxui//:ftxui_screen",
-    ],
-)
-```
-
-
-# Build with something else:
-If you don't, FTXUI may be used from the following packages:
-- CMake [FetchContent]([https://bewagner.net/programming/2020/05/02/cmake-fetchcontent/](https://cmake.org/cmake/help/latest/module/FetchContent.html)) (preferred),
-- [Bazel](https://registry.bazel.build/modules/ftxui),
-- [vcpkg](https://vcpkg.link/ports/ftxui),
-- [Conan](https://conan.io/center/recipes/ftxui)
-- [Debian package](https://tracker.debian.org/pkg/ftxui),
-- [Ubuntu package](https://launchpad.net/ubuntu/+source/ftxui),
-- [Arch Linux](https://aur.archlinux.org/packages/ftxui/),
-- [OpenSUSE](https://build.opensuse.org/package/show/devel:libraries:c_c++/ftxui),
-[Nix](https://github.com/ArthurSonzogni/FTXUI/blob/main/flake.nix),
-[![Packaging status](https://repology.org/badge/vertical-allrepos/libftxui.svg)](https://repology.org/project/libftxui/versions)
-
-
-If you choose to build and link FTXUI yourself, `ftxui-component` must be first in the linking order relative to the other FTXUI libraries, i.e.
-```bash
-g++ . . . -lftxui-component -lftxui-dom -lftxui-screen . . .
-```
-
-To build FTXUI with modules, check [documentation](https://arthursonzogni.github.io/FTXUI/cpp20-modules.html)
+If you don't, the following packages have been created:
+- [vcpkg](https://vcpkgx.com/details.html?package=ftxui)
+- [Arch Linux PKGBUILD](https://aur.archlinux.org/packages/ftxui-git/).
+- [conan.io](https://conan.io/center/ftxui)
 
 ## Contributors
 

WORKSPACE.bazel

@@ -1,4 +0,0 @@
-# Copyright 2025 Arthur Sonzogni. All rights reserved.
-# Use of this source code is governed by the MIT license that can be found in
-# the LICENSE file.
-workspace(name = "ftxui")

bazel/ftxui.bzl

@@ -1,94 +0,0 @@
-# ftxui_common.bzl
-
-load("@rules_cc//cc:defs.bzl", "cc_library")
-load("@rules_cc//cc:defs.bzl", "cc_binary")
-
-# Microsoft terminal is a bit buggy ¯\_(ツ)_/¯ and MSVC uses bad defaults.
-def windows_copts():
-    MSVC_COPTS = [
-      # Microsoft Visual Studio must decode sources files as UTF-8.
-      "/utf-8",
-
-      # Microsoft Visual Studio must interpret the codepoint using unicode.
-      "/DUNICODE",
-      "/D_UNICODE",
-
-      # Fallback for Microsoft Terminal.
-      # This
-      # - Replace missing font symbols by others.
-      # - Reduce screen position pooling frequency to deals against a Microsoft
-      #   race condition. This was fixed in 2020, but clients never not updated.
-      #   - https://github.com/microsoft/terminal/pull/7583
-      #   - https://github.com/ArthurSonzogni/FTXUI/issues/136
-      "/DFTXUI_MICROSOFT_TERMINAL_FALLBACK",
-    ]
-
-    WINDOWS_COPTS = [
-      # Fallback for Microsoft Terminal.
-      # This
-      # - Replace missing font symbols by others.
-      # - Reduce screen position pooling frequency to deals against a Microsoft
-      #   race condition. This was fixed in 2020, but clients are still using
-      #   old versions.
-      #   - https://github.com/microsoft/terminal/pull/7583
-      #   - https://github.com/ArthurSonzogni/FTXUI/issues/136
-      "-DFTXUI_MICROSOFT_TERMINAL_FALLBACK",
-    ];
-    
-    return select({
-        # MSVC:
-        "@rules_cc//cc/compiler:msvc-cl": MSVC_COPTS,
-        "@rules_cc//cc/compiler:clang-cl": MSVC_COPTS,
-        "@platforms//os:windows": WINDOWS_COPTS,
-        "//conditions:default": [],
-    })
-
-def ftxui_cc_library(
-        name,
-        srcs = [],
-        hdrs = [],
-        linkopts = [],
-        deps = []):
-
-    cc_library(
-        name = name,
-        srcs = srcs,
-        hdrs = hdrs,
-        linkopts = linkopts,
-        deps = deps,
-        strip_include_prefix = "",
-        include_prefix = "",
-        includes = [
-            "include",
-            "src",
-        ],
-        copts = windows_copts(),
-        visibility = ["//visibility:public"],
-    )
-
-# Compile all the examples in the examples/ directory.
-# This is useful to check the Bazel is always synchronized against CMake
-# definitions.
-def generate_examples():
-    cpp_files = native.glob(["examples/**/*.cpp"])
-
-    for src in cpp_files:
-        # Skip failing examples due to the color_info_sorted_2d.ipp dependency.
-        if src == "examples/component/homescreen.cpp" or \
-           src == "examples/dom/color_info_palette256.cpp" or \
-           src == "examples/dom/color_gallery.cpp":
-            continue
-
-        # Turn "examples/component/button.cpp" → "example_component_button"
-        name = src.replace("/", "_").replace(".cpp", "")
-
-        cc_binary(
-            name = name,
-            srcs = [src],
-            deps = [
-              ":component",
-              ":dom",
-              ":screen",
-            ],
-            copts = windows_copts(),
-        )

build/_deps/googlebenchmark-subbuild/CMakeLists.txt

@@ -1,42 +0,0 @@
-# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
-# file Copyright.txt or https://cmake.org/licensing for details.
-
-cmake_minimum_required(VERSION 3.31.6)
-
-# Reject any attempt to use a toolchain file. We must not use one because
-# we could be downloading it here. If the CMAKE_TOOLCHAIN_FILE environment
-# variable is set, the cache variable will have been initialized from it.
-unset(CMAKE_TOOLCHAIN_FILE CACHE)
-unset(ENV{CMAKE_TOOLCHAIN_FILE})
-
-# We name the project and the target for the ExternalProject_Add() call
-# to something that will highlight to the user what we are working on if
-# something goes wrong and an error message is produced.
-
-project(googlebenchmark-populate NONE)
-
-
-# Pass through things we've already detected in the main project to avoid
-# paying the cost of redetecting them again in ExternalProject_Add()
-set(GIT_EXECUTABLE [==[/usr/bin/git]==])
-set(GIT_VERSION_STRING [==[2.51.0]==])
-set_property(GLOBAL PROPERTY _CMAKE_FindGit_GIT_EXECUTABLE_VERSION
-  [==[/usr/bin/git;2.51.0]==]
-)
-
-
-include(ExternalProject)
-ExternalProject_Add(googlebenchmark-populate
-                     "UPDATE_DISCONNECTED" "False" "GIT_REPOSITORY" "https://github.com/google/benchmark" "EXTERNALPROJECT_INTERNAL_ARGUMENT_SEPARATOR" "GIT_TAG" "015d1a091af6937488242b70121858bce8fd40e9" "GIT_PROGRESS" "TRUE"
-                    SOURCE_DIR          "/home/runner/work/FTXUI/FTXUI/build/_deps/googlebenchmark-src"
-                    BINARY_DIR          "/home/runner/work/FTXUI/FTXUI/build/_deps/googlebenchmark-build"
-                    CONFIGURE_COMMAND   ""
-                    BUILD_COMMAND       ""
-                    INSTALL_COMMAND     ""
-                    TEST_COMMAND        ""
-                    USES_TERMINAL_DOWNLOAD  YES
-                    USES_TERMINAL_UPDATE    YES
-                    USES_TERMINAL_PATCH     YES
-)
-
-

build/_deps/googletest-subbuild/CMakeLists.txt

@@ -1,42 +0,0 @@
-# Distributed under the OSI-approved BSD 3-Clause License.  See accompanying
-# file Copyright.txt or https://cmake.org/licensing for details.
-
-cmake_minimum_required(VERSION 3.31.6)
-
-# Reject any attempt to use a toolchain file. We must not use one because
-# we could be downloading it here. If the CMAKE_TOOLCHAIN_FILE environment
-# variable is set, the cache variable will have been initialized from it.
-unset(CMAKE_TOOLCHAIN_FILE CACHE)
-unset(ENV{CMAKE_TOOLCHAIN_FILE})
-
-# We name the project and the target for the ExternalProject_Add() call
-# to something that will highlight to the user what we are working on if
-# something goes wrong and an error message is produced.
-
-project(googletest-populate NONE)
-
-
-# Pass through things we've already detected in the main project to avoid
-# paying the cost of redetecting them again in ExternalProject_Add()
-set(GIT_EXECUTABLE [==[/usr/bin/git]==])
-set(GIT_VERSION_STRING [==[2.51.0]==])
-set_property(GLOBAL PROPERTY _CMAKE_FindGit_GIT_EXECUTABLE_VERSION
-  [==[/usr/bin/git;2.51.0]==]
-)
-
-
-include(ExternalProject)
-ExternalProject_Add(googletest-populate
-                     "UPDATE_DISCONNECTED" "False" "GIT_REPOSITORY" "https://github.com/google/googletest" "EXTERNALPROJECT_INTERNAL_ARGUMENT_SEPARATOR" "GIT_TAG" "23ef29555ef4789f555f1ba8c51b4c52975f0907" "GIT_PROGRESS" "TRUE"
-                    SOURCE_DIR          "/home/runner/work/FTXUI/FTXUI/build/_deps/googletest-src"
-                    BINARY_DIR          "/home/runner/work/FTXUI/FTXUI/build/_deps/googletest-build"
-                    CONFIGURE_COMMAND   ""
-                    BUILD_COMMAND       ""
-                    INSTALL_COMMAND     ""
-                    TEST_COMMAND        ""
-                    USES_TERMINAL_DOWNLOAD  YES
-                    USES_TERMINAL_UPDATE    YES
-                    USES_TERMINAL_PATCH     YES
-)
-
-

cmake/ftxui_export.cmake

@@ -4,5 +4,5 @@ add_library(ftxui::component ALIAS component)
 export(
   TARGETS screen dom component
   NAMESPACE ftxui::
-  FILE "${PROJECT_BINARY_DIR}/ftxui-targets.cmake"
+  FILE ${PROJECT_BINARY_DIR}/ftxui-targets.cmake
 )

cmake/ftxui_find_google_benchmark.cmake

@@ -13,7 +13,7 @@ include(FetchContent)
 
 FetchContent_Declare(googlebenchmark
   GIT_REPOSITORY "https://github.com/google/benchmark"
-  GIT_TAG        "015d1a091af6937488242b70121858bce8fd40e9"  # v1.8.2
+  GIT_TAG        62937f91b5c763a8e119d0c20c67b87bde8eff1c 
   GIT_PROGRESS   TRUE
 )
 

cmake/ftxui_find_google_test.cmake

@@ -27,7 +27,7 @@ set(BUILD_GMOCK OFF CACHE INTERNAL "")
 set(INSTALL_GTEST OFF CACHE INTERNAL "")
 set(gtest_force_shared_crt ON CACHE INTERNAL "")
 add_subdirectory(
-  "${googletest_SOURCE_DIR}"
-  "${googletest_BINARY_DIR}"
+  ${googletest_SOURCE_DIR}
+  ${googletest_BINARY_DIR}
   EXCLUDE_FROM_ALL
 )

cmake/ftxui_fuzzer.cmake

@@ -4,17 +4,24 @@ endif()
 
 set(CMAKE_C_COMPILER clang)
 set(CMAKE_CXX_COMPILER clang++)
+set(CMAKE_CXX_STANDARD 17)
 
-function(fuzz source)
-  set(name "ftxui-${source}")
+function(fuzz name)
   add_executable(${name}
-    src/ftxui/component/${source}.cpp
+    src/ftxui/component/${name}.cpp
+  )
+  target_include_directories(${name}
+    PRIVATE src
+  )
+  target_link_libraries(${name}
+    PRIVATE component
+  )
+  target_compile_options(${name}
+    PRIVATE -fsanitize=fuzzer,address
+  )
+  target_link_libraries(${name}
+    PRIVATE -fsanitize=fuzzer,address
   )
-  target_include_directories(${name} PRIVATE src)
-  target_link_libraries(${name} PRIVATE component)
-  target_compile_options(${name} PRIVATE -fsanitize=fuzzer,address)
-  target_link_libraries(${name} PRIVATE -fsanitize=fuzzer,address)
-  target_compile_features(${name} PRIVATE cxx_std_17)
 endfunction(fuzz)
 
 fuzz(terminal_input_parser_test_fuzzer)

cmake/ftxui_install.cmake

@@ -3,61 +3,41 @@ if(NOT FTXUI_ENABLE_INSTALL)
 endif()
 
 include(GNUInstallDirs)
+install(TARGETS screen dom component
+    EXPORT ftxui-export
+    LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
+    ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
+)
+
+install(DIRECTORY include/ftxui DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})
+
+# CMake package configuration for easy use of library in CMake
 include(CMakePackageConfigHelpers)
-
-# ------------------------------------------------------------------------------
-# Install the library and its public headers into the standard subdirectories
-# ------------------------------------------------------------------------------
-install(
-  TARGETS screen dom component
-  EXPORT ftxui-targets
-  ARCHIVE DESTINATION "${CMAKE_INSTALL_LIBDIR}"
-  LIBRARY DESTINATION "${CMAKE_INSTALL_LIBDIR}"
-  RUNTIME DESTINATION "${CMAKE_INSTALL_BINDIR}"
-  )
-
-install(
-  DIRECTORY include/ftxui
-  DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
-  )
-
-# ------------------------------------------------------------------------------
-# Install the exported cmake targets for use in other CMake projects.
-# ------------------------------------------------------------------------------
-install(
-  EXPORT ftxui-targets
-  NAMESPACE ftxui::
-  DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/ftxui"
-  )
-
-# ------------------------------------------------------------------------------
-# Create and install the ftuxi-config.cmake and ftuxi-config-version.cmake files
-# needed to support users of find_package()
-# ------------------------------------------------------------------------------
-configure_package_config_file(
-  "${CMAKE_CURRENT_SOURCE_DIR}/cmake/ftxui-config.cmake.in"
-  "${CMAKE_CURRENT_BINARY_DIR}/cmake/ftxui-config.cmake"
-  INSTALL_DESTINATION "${CMAKE_INSTALL_LIBDIR}/ftxui/cmake"
+configure_package_config_file(ftxui-config.cmake.in
+  ${CMAKE_CURRENT_BINARY_DIR}/ftxui-config.cmake
+  INSTALL_DESTINATION ${CMAKE_INSTALL_LIBDIR}/ftxui/cmake
   PATH_VARS CMAKE_INSTALL_INCLUDEDIR
-  )
+)
 write_basic_package_version_file(
-  "${CMAKE_CURRENT_BINARY_DIR}/cmake/ftxui-config-version.cmake"
+  ftxui-config-version.cmake
   VERSION ${PACKAGE_VERSION}
-  COMPATIBILITY SameMajorVersion
-  )
-install(
-  FILES
-  "${CMAKE_CURRENT_BINARY_DIR}/cmake/ftxui-config.cmake"
-  "${CMAKE_CURRENT_BINARY_DIR}/cmake/ftxui-config-version.cmake"
-  DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/ftxui"
-  )
+  COMPATIBILITY AnyNewerVersion
+)
 
-# ------------------------------------------------------------------------------
-# Create and install pkg-config file for easy use of library in build systems
-# other than CMake:
-# ------------------------------------------------------------------------------
-configure_file(ftxui.pc.in ${CMAKE_CURRENT_BINARY_DIR}/ftxui.pc @ONLY)
-install(
-  FILES "${CMAKE_CURRENT_BINARY_DIR}/ftxui.pc"
-  DESTINATION "${CMAKE_INSTALL_LIBDIR}/pkgconfig"
-  )
+install(FILES ${CMAKE_CURRENT_BINARY_DIR}/ftxui-config.cmake
+  DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/ftxui
+)
+install(EXPORT ftxui-export
+  FILE ftxui-config-version.cmake
+  NAMESPACE ftxui::
+  DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/ftxui
+)
+
+# pkg-config file for easy use of library in build systems other than CMake
+configure_file(ftxui.pc.in
+  ${CMAKE_CURRENT_BINARY_DIR}/ftxui.pc
+  @ONLY)
+
+install(FILES ${CMAKE_CURRENT_BINARY_DIR}/ftxui.pc
+  DESTINATION lib/pkgconfig
+)

cmake/ftxui_message.cmake

@@ -1,18 +0,0 @@
-function(ftxui_message msg)
-  if (NOT FTXUI_QUIET)
-    message(STATUS "${msg}")
-  endif()
-endfunction()
-
-ftxui_message("┌─ FTXUI options ─────────────────────")
-ftxui_message("│ FTXUI_BUILD_DOCS         : ${FTXUI_BUILD_DOCS}")
-ftxui_message("│ FTXUI_BUILD_EXAMPLES     : ${FTXUI_BUILD_EXAMPLES}")
-ftxui_message("│ FTXUI_BUILD_MODULES      : ${FTXUI_BUILD_MODULES}")
-ftxui_message("│ FTXUI_BUILD_TESTS        : ${FTXUI_BUILD_TESTS}")
-ftxui_message("│ FTXUI_BUILD_TESTS_FUZZER : ${FTXUI_BUILD_TESTS_FUZZER}")
-ftxui_message("│ FTXUI_CLANG_TIDY         : ${FTXUI_CLANG_TIDY}")
-ftxui_message("│ FTXUI_DEV_WARNINGS       : ${FTXUI_DEV_WARNINGS}")
-ftxui_message("│ FTXUI_ENABLE_COVERAGE    : ${FTXUI_ENABLE_COVERAGE}")
-ftxui_message("│ FTXUI_ENABLE_INSTALL     : ${FTXUI_ENABLE_INSTALL}")
-ftxui_message("│ FTXUI_QUIET              : ${FTXUI_QUIET}")
-ftxui_message("└─────────────────────────────────────")

cmake/ftxui_modules.cmake

@@ -1,83 +0,0 @@
-if (NOT FTXUI_BUILD_MODULES)
-  return()
-endif()
-
-add_library(ftxui-modules)
-
-target_sources(ftxui-modules
-  PUBLIC FILE_SET CXX_MODULES FILES
-  src/ftxui/ftxui.cppm
-  src/ftxui/component.cppm
-  src/ftxui/component/animation.cppm
-  src/ftxui/component/captured_mouse.cppm
-  src/ftxui/component/component.cppm
-  src/ftxui/component/component_base.cppm
-  src/ftxui/component/component_options.cppm
-  src/ftxui/component/event.cppm
-  src/ftxui/component/loop.cppm
-  src/ftxui/component/mouse.cppm
-  src/ftxui/component/receiver.cppm
-  src/ftxui/component/screen_interactive.cppm
-  src/ftxui/component/task.cppm
-  src/ftxui/dom.cppm
-  src/ftxui/dom/canvas.cppm
-  src/ftxui/dom/deprecated.cppm
-  src/ftxui/dom/direction.cppm
-  src/ftxui/dom/elements.cppm
-  src/ftxui/dom/flexbox_config.cppm
-  src/ftxui/dom/linear_gradient.cppm
-  src/ftxui/dom/node.cppm
-  src/ftxui/dom/requirement.cppm
-  src/ftxui/dom/selection.cppm
-  src/ftxui/dom/table.cppm
-  src/ftxui/screen.cppm
-  src/ftxui/screen/box.cppm
-  src/ftxui/screen/color.cppm
-  src/ftxui/screen/color_info.cppm
-  src/ftxui/screen/deprecated.cppm
-  src/ftxui/screen/image.cppm
-  src/ftxui/screen/pixel.cppm
-  src/ftxui/screen/screen.cppm
-  src/ftxui/screen/string.cppm
-  src/ftxui/screen/terminal.cppm
-  src/ftxui/util.cppm
-  src/ftxui/util/autoreset.cppm
-  src/ftxui/util/ref.cppm
-  )
-
-target_link_libraries(ftxui-modules
-  PUBLIC
-  ftxui::screen
-  ftxui::dom
-  ftxui::component
-  )
-
-target_compile_features(ftxui-modules PUBLIC cxx_std_20)
-# TODO: Explain why this is needed.
-if (CMAKE_COMPILER_IS_GNUCXX)
-  target_compile_options(ftxui-modules PUBLIC -fmodules-ts)
-endif ()
-
-add_library(ftxui::modules ALIAS ftxui-modules)
-
-if(FTXUI_ENABLE_INSTALL)
-
-  include(GNUInstallDirs)
-
-  install(TARGETS ftxui-modules
-    EXPORT ftxui-targets
-    FILE_SET CXX_MODULES
-    DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/ftxui
-    FILE_SET HEADERS
-    DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/ftxui
-    INCLUDES
-    DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/ftxui
-    )
-  install(EXPORT ftxui-targets
-    DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/ftxui
-    CXX_MODULES_DIRECTORY ${CMAKE_INSTALL_LIBDIR}/cmake/ftxui
-    )
-  install(FILES my_package-config.cmake
-    DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/ftxui
-    )
-endif()

cmake/ftxui_set_options.cmake

@@ -1,16 +1,18 @@
 find_program(CLANG_TIDY_EXE NAMES "clang-tidy" DOC "Path to clang-tidy executable" )
+if(NOT CLANG_TIDY_EXE)
+  message(STATUS "clang-tidy not found.")
+else()
+  message(STATUS "clang-tidy found: ${CLANG_TIDY_EXE}")
+endif()
 
 function(ftxui_set_options library)
+  message(STATUS "ftxui_set_options " ${library})
   set_target_properties(${library} PROPERTIES VERSION ${PROJECT_VERSION})
   if (NOT ${library} MATCHES "ftxui-*")
     set_target_properties(${library} PROPERTIES OUTPUT_NAME "ftxui-${library}")
   endif()
 
-  if (FTXUI_CLANG_TIDY)
-    if (NOT CLANG_TIDY_EXE)
-      message(FATAL_ERROR "clang-tidy requested but executable not found")
-    endif()
-
+  if(CLANG_TIDY_EXE AND FTXUI_CLANG_TIDY)
     set_target_properties(${library}
       PROPERTIES CXX_CLANG_TIDY "${CLANG_TIDY_EXE};-warnings-as-errors=*"
     )
@@ -41,27 +43,31 @@ function(ftxui_set_options library)
       $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
   )
 
-  target_compile_features(${library} PUBLIC cxx_std_17)
+  # Play nicely if we are being consumed by another project
+  # and use their CMAKE_CXX_STANDARD. Otherwise, fall back to 17
+  # C++17 is used. We require fold expression at least.
+  if (DEFINED CMAKE_CXX_STANDARD)
+    set(CXX_STANDARD ${CMAKE_CXX_STANDARD})
+  else()
+    set(CXX_STANDARD 17)
+  endif()
+  
+  set_target_properties(${library} PROPERTIES
+    CXX_STANDARD ${CXX_STANDARD}
+    CXX_EXTENSIONS OFF
+  )
 
   # Force Microsoft Visual Studio to decode sources files in UTF-8. This applies
   # to the library and the library users.
-  if (CMAKE_CXX_COMPILER_ID STREQUAL "MSVC")
+  if (MSVC)
     target_compile_options(${library} PUBLIC "/utf-8")
   endif()
 
-  # CMake does automatically add -fPIC when linking a shared library, but it
-  # does not add it when linking a static library. This is a problem when the 
-  # static library is later linked into a shared library. 
-  # Doing it helps some users.
-  set_property(TARGET ${library} PROPERTY POSITION_INDEPENDENT_CODE ON)
-
   # Add as many warning as possible:
   if (WIN32)
     if (MSVC)
-      if(FTXUI_DEV_WARNINGS)
       target_compile_options(${library} PRIVATE "/W3")
       target_compile_options(${library} PRIVATE "/WX")
-      endif()
       target_compile_options(${library} PRIVATE "/wd4244")
       target_compile_options(${library} PRIVATE "/wd4267")
       target_compile_options(${library} PRIVATE "/D_CRT_SECURE_NO_WARNINGS")
@@ -69,29 +75,14 @@ function(ftxui_set_options library)
     # Force Win32 to UNICODE
     target_compile_definitions(${library} PRIVATE UNICODE _UNICODE)
   else()
-    if(FTXUI_DEV_WARNINGS)
     target_compile_options(${library} PRIVATE "-Wall")
-      target_compile_options(${library} PRIVATE "-Werror")
     target_compile_options(${library} PRIVATE "-Wextra")
-  
-      target_compile_options(${library} PRIVATE "-Wcast-align")
-      target_compile_options(${library} PRIVATE "-Wdeprecated")
+    target_compile_options(${library} PRIVATE "-pedantic")
+    target_compile_options(${library} PRIVATE "-Werror")
     target_compile_options(${library} PRIVATE "-Wmissing-declarations")
-      target_compile_options(${library} PRIVATE "-Wnon-virtual-dtor")
-      target_compile_options(${library} PRIVATE "-Wnull-dereference")
-      target_compile_options(${library} PRIVATE "-Woverloaded-virtual")
-      target_compile_options(${library} PRIVATE "-Wpedantic")
+    target_compile_options(${library} PRIVATE "-Wdeprecated")
     target_compile_options(${library} PRIVATE "-Wshadow")
-      target_compile_options(${library} PRIVATE "-Wunused")
   endif()
-  endif()
-
-  if (CMAKE_CXX_COMPILER_ID MATCHES "Clang")
-    if(FTXUI_DEV_WARNINGS)
-      target_compile_options(${library} PRIVATE "-Wdocumentation")
-    endif()
-  endif()
-
 
   if (FTXUI_MICROSOFT_TERMINAL_FALLBACK)
     target_compile_definitions(${library}
@@ -101,5 +92,6 @@ endfunction()
 
 if (EMSCRIPTEN)
   string(APPEND CMAKE_CXX_FLAGS " -s USE_PTHREADS")
+  string(APPEND CMAKE_EXE_LINKER_FLAGS " -s ASYNCIFY")
   string(APPEND CMAKE_EXE_LINKER_FLAGS " -s PROXY_TO_PTHREAD")
 endif()

cmake/ftxui_test.cmake

@@ -1,4 +1,5 @@
-if (NOT FTXUI_BUILD_TESTS)
+if (NOT FTXUI_BUILD_TESTS OR
+    NOT ${CMAKE_VERSION} VERSION_GREATER "3.11.4")
   return()
 endif()
 
@@ -13,16 +14,15 @@ add_executable(ftxui-tests
   src/ftxui/component/component_test.cpp
   src/ftxui/component/component_test.cpp
   src/ftxui/component/container_test.cpp
-  src/ftxui/component/dropdown_test.cpp
   src/ftxui/component/hoverable_test.cpp
   src/ftxui/component/input_test.cpp
   src/ftxui/component/menu_test.cpp
   src/ftxui/component/modal_test.cpp
   src/ftxui/component/radiobox_test.cpp
+  src/ftxui/component/receiver_test.cpp
   src/ftxui/component/resizable_split_test.cpp
   src/ftxui/component/screen_interactive_test.cpp
   src/ftxui/component/slider_test.cpp
-  src/ftxui/component/task_test.cpp
   src/ftxui/component/terminal_input_parser_test.cpp
   src/ftxui/component/toggle_test.cpp
   src/ftxui/dom/blink_test.cpp
@@ -37,11 +37,8 @@ add_executable(ftxui-tests
   src/ftxui/dom/gauge_test.cpp
   src/ftxui/dom/gridbox_test.cpp
   src/ftxui/dom/hbox_test.cpp
-  src/ftxui/dom/hyperlink_test.cpp
-  src/ftxui/dom/italic_test.cpp
   src/ftxui/dom/linear_gradient_test.cpp
   src/ftxui/dom/scroll_indicator_test.cpp
-  src/ftxui/dom/selection_test.cpp
   src/ftxui/dom/separator_test.cpp
   src/ftxui/dom/spinner_test.cpp
   src/ftxui/dom/table_test.cpp
@@ -50,7 +47,6 @@ add_executable(ftxui-tests
   src/ftxui/dom/vbox_test.cpp
   src/ftxui/screen/color_test.cpp
   src/ftxui/screen/string_test.cpp
-  src/ftxui/util/ref_test.cpp
 )
 
 target_link_libraries(ftxui-tests
@@ -61,23 +57,10 @@ target_link_libraries(ftxui-tests
 target_include_directories(ftxui-tests
   PRIVATE src
 )
-target_compile_features(ftxui-tests PRIVATE cxx_std_20)
-
-# Disable unity build for tests. There are several files defining the same
-# function in different anonymous namespaces. This is not allowed in unity
-# builds, as it would result in multiple definitions of the same function.
-set_target_properties(ftxui-tests PROPERTIES UNITY_BUILD OFF)
-
-if (FTXUI_MICROSOFT_TERMINAL_FALLBACK)
-  target_compile_definitions(ftxui-tests
-    PRIVATE "FTXUI_MICROSOFT_TERMINAL_FALLBACK")
-endif()
+ftxui_set_options(ftxui-tests)
+target_compile_features(ftxui-tests PUBLIC cxx_std_20)
 
 include(GoogleTest)
 gtest_discover_tests(ftxui-tests
   DISCOVERY_TIMEOUT 600
 )
-
-#set(CMAKE_CTEST_ARGUMENTS "--rerun-failed --output-on-failure")
-#set_tests_properties(gen_init_queries PROPERTIES FIXTURES_SETUP f_init_queries)
-#set_tests_properties(test PROPERTIES  FIXTURES_REQUIRED f_init_queries)

cmake/iwyu.cmake

@@ -1,7 +1,7 @@
 find_program(iwyu_path NAMES include-what-you-use iwyu)
 if(iwyu_path)
   set_property(TARGET ${lib}
-    PROPERTY "${iwyu_path}" -Xiwyu
-      --mapping_file "${CMAKE_CURRENT_SOURCE_DIR}/iwyu.imp"
+    PROPERTY ${iwyu_path} -Xiwyu
+      --mapping_file ${CMAKE_CURRENT_SOURCE_DIR}/iwyu.imp
   )
 endif()

doc/CMakeLists.txt

@@ -8,63 +8,13 @@ if (NOT DOXYGEN_FOUND)
   return()
 endif()
 
-include(FetchContent)
-FetchContent_Declare(
-    doxygen-awesome-css
-    GIT_REPOSITORY https://github.com/jothepro/doxygen-awesome-css.git
-    GIT_TAG v2.3.4
-
-)
-FetchContent_MakeAvailable(doxygen-awesome-css)
-FetchContent_GetProperties(doxygen-awesome-css SOURCE_DIR AWESOME_CSS_DIR)
-
 # Generate example list for documentation
-set(DOM_EXAMPLES "")
-set(COMPONENT_EXAMPLES "")
-
+set(EXAMPLE_LIST "${CMAKE_CURRENT_BINARY_DIR}/example_list.md")
+file(WRITE ${EXAMPLE_LIST} "# Examples")
 get_property(EXAMPLES GLOBAL PROPERTY FTXUI::EXAMPLES)
-
-foreach(example IN LISTS EXAMPLES)
-  if(example MATCHES "^dom/.*")
-    list(APPEND DOM_EXAMPLES "${example}")
-  elseif(example MATCHES "^component/.*")
-    list(APPEND COMPONENT_EXAMPLES "${example}")
-  else()
-    message(ERROR "Unknown example '${example}'")
-  endif()
-endforeach()
-
-macro(write_example_list file title page examples)
-  file(WRITE "${file}" "@page ${page} ${title}\n")
-  file(APPEND "${file}" "@tableofcontents\n")
-
-  foreach(example IN LISTS ${examples})
-    get_filename_component(name "${example}" NAME_WE)
-    file(APPEND "${file}" "# ${name}\n")
-
-    # Add a markdown  to the demo. URL example:
-    # https://arthursonzogni.github.io/FTXUI/examples/?file=component/canvas_animated
-    file(APPEND "${file}" "[Demo](https://arthursonzogni.github.io/FTXUI/examples/?file=${example})\n")
-
-    file(APPEND "${file}" "@include examples/${example}.cpp\n")
-    file(APPEND "${file}" "\n")
-  endforeach()
-
-  # Reference to the examples
-  foreach(example IN LISTS ${examples})
-    get_filename_component(name "${example}" NAME_WE)
-    file(APPEND "${file}" "@example examples/${example}.cpp\n")
-  endforeach()
-endmacro()
-
-write_example_list("${CMAKE_CURRENT_BINARY_DIR}/dom_examples.md"
-  "Example"
-  module-dom-examples
-  DOM_EXAMPLES)
-write_example_list("${CMAKE_CURRENT_BINARY_DIR}/component_examples.md"
-  "Example"
-  module-component-examples
-  COMPONENT_EXAMPLES)
+foreach(EXAMPLE IN LISTS EXAMPLES)
+  file(APPEND ${EXAMPLE_LIST} "\n@example examples/${EXAMPLE}.cpp")
+endforeach(EXAMPLE IN LISTS EXAMPLES)
 
 configure_file(Doxyfile.in Doxyfile @ONLY)
 

doc/cpp20-modules.md

@@ -1,107 +0,0 @@
-@page cpp20-modules C++20 Modules
-
-
-> [!WARNING]
-> This feature is still in development, and the API may change in future releases.
-> Your contribution is needed to help us improve the compatibility and usability
-> of C++20 modules in FTXUI. If you encounter any issues or have suggestions,
-> please open an issue.
-
-FTXUI experimentally supports
-[C++20 modules](https://en.cppreference.com/w/cpp/language/modules) to reduce
-compilation times and improve code organization. Each header has a
-corresponding module.
-
-Use the FTXUI_BUILD_MODULES option to build the FTXUI project itself to provide C++ 20 modules,
-for example with CMake and Ninja:
-
-```sh
-cmake \
-    -DCMAKE_GENERATOR=Ninja \
-    -DFTXUI_BUILD_MODULES=ON \
-    ..
-
-ninja
-```
-
-> [!NOTE]
-> To use modules, you need a C++20 compatible compiler, CMake version 3.20 or
-> higher, and use a compatible generator like Ninja. Note that Makefile
-> generators **do not support modules**.
-
-Then, in your own code you can consume the modules and code as normal:
-
-```cpp
-import ftxui;
-
-int main() {
-  auto screen = ftxui::ScreenInteractive::TerminalOutput();
-  auto button = ftxui::Button("Click me", screen.QuitClosure());
-  screen.Loop(button);
-  return 0;
-}
-```
-
-Note, the `ftxui` convenience module which simply pulls together all the modules:
-
-```cpp
-export import ftxui.component;
-export import ftxui.dom;
-export import ftxui.screen;
-export import ftxui.util;
-```
-You can instead import only the module(s) you need if desired.
-
-To properly find and link the modules with CMake, use `target_link_libraries` to get the right
-compiler, linker, etc. flags.
-
-```cmake
-target_link_libraries(my_executable
-    #...whatever...
-    PRIVATE ftxui::modules
-)
-```
-
-### Module list
-
-The modules directly reference the corresponding header, or a group of related
-headers to provide a more convenient interface. The following modules
-are available:
-
-- `ftxui`
-    - `ftxui.component`
-      - `ftxui.component.Animation`
-      - `ftxui.component.CapturedMouse`
-      - `ftxui.component.Component`
-      - `ftxui.component.ComponentBase`
-      - `ftxui.component.ComponentOptions`
-      - `ftxui.component.Event`
-      - `ftxui.component.Loop`
-      - `ftxui.component.Mouse`
-      - `ftxui.component.Receiver`
-      - `ftxui.component.ScreenInteractive`
-      - `ftxui.component.Task`
-- `ftxui.dom`
-    - `ftxui.dom.Canvas`
-    - `ftxui.dom.Deprecated`
-    - `ftxui.dom.Direction`
-    - `ftxui.dom.Elements`
-    - `ftxui.dom.FlexboxConfig`
-    - `ftxui.dom.LinearGradient`
-    - `ftxui.dom.Node`
-    - `ftxui.dom.Requirement`
-    - `ftxui.dom.Selection`
-    - `ftxui.dom.Table`
-- `ftxui.screen`
-    - `ftxui.screen.Box`
-    - `ftxui.screen.Color`
-    - `ftxui.screen.ColorInfo`
-    - `ftxui.screen.Deprecated`
-    - `ftxui.screen.Image`
-    - `ftxui.screen.Pixel`
-    - `ftxui.screen.Screen`
-    - `ftxui.screen.String`
-    - `ftxui.screen.Terminal`
-- `ftxui.util`
-    - `ftxui.util.AutoReset`
-    - `ftxui.util.Ref`

doc/doxygen_extra.css

@@ -0,0 +1,323 @@
+/*
+ *  GitHub Markdown style CSS for doxygen 1.8.14
+ *  Source:  https://github.com/sindresorhus/github-markdown-css
+ *  License: MIT <20> Sindre Sorhus
+ */
+
+* {
+  box-sizing: border-box;
+}
+
+body, table, div, p, dl {
+  -ms-text-size-adjust: 100%;
+  -webkit-text-size-adjust: 100%;
+  line-height: 1.5;
+  color: #24292e;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+  font-size: 16px;
+  word-wrap: break-word;
+}
+
+b {
+  font-weight: 600;
+}
+
+/* @group Heading Levels */
+
+h1, h2, h3, h4, h5, h6 {
+  font-weight: 600;
+  line-height: 1.25;
+  margin-top: 24px;
+  margin-bottom: 16px;
+}
+
+h1 {
+  font-size: 2em;
+  padding-bottom: 0.3em;
+  border-bottom: 1px solid #eaecef;
+}
+
+h2 {
+  padding-bottom: 0.3em;
+  font-size: 1.5em;
+  border-bottom: 1px solid #eaecef;
+}
+
+h3 {
+  font-size: 1.25em;
+}
+
+h4 {
+  font-size: 1em;
+}
+
+h5 {
+  font-size: 0.875em;
+}
+
+h6 {
+  font-size: 0.85em;
+  color: #6a737d;
+}
+
+a {
+  background-color: transparent;
+  color: #0366d6;
+  text-decoration: none;
+  font-weight: normal;
+}
+
+.contents a:visited {
+  color: #0366d6;
+}
+
+a:active, a:hover {
+  outline-width: 0;
+}
+
+a:hover {
+  text-decoration: underline;
+}
+
+a:not([href]) {
+  color: inherit;
+  text-decoration: none;
+}
+
+a.el {
+  font-weight: normal;
+}
+
+.image {
+  text-align: left;
+}
+
+.tip {
+  background-image: url(tip.png);
+  background-position: left center;
+  background-repeat: no-repeat;
+  padding-left: 30px;
+  margin-top: 1em;
+  margin-bottom: 1em;
+  min-height: 31px;
+  display: block;
+  font-style:italic;
+}
+
+.warn {
+  background-image: url(warn.png);
+  background-position: left center;
+  background-repeat: no-repeat;
+  padding-left: 48px;
+  margin-top: 1em;
+  margin-bottom: 1em;
+  min-height: 31px;
+  display: block;
+  font-style:italic;
+}
+
+#projectname {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+  font-size: 2em;
+  font-weight: bold;
+}
+
+#projectbrief {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+  font-size: 0.8em;
+}
+
+#projectnumber {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+  font-size: 1em;
+}
+
+div.contents {
+  width: 980px;
+  padding: 40px;
+  margin-top: -1px;
+  margin-left: auto;
+  margin-right: auto;
+  margin-bottom: 10px;
+  border: 1px solid #d1d5da;
+  border-radius: 2px;
+}
+
+div.toc {
+  border: 0 none;
+  border-radius: 7px;
+}
+
+div.header {
+  width: 980px;
+  padding: 10px;
+  margin-top: 10px;
+  margin-left: auto;
+  margin-right: auto;
+  background-image: none;
+  background-repeat: none;
+  background-color: #f6f8fa;
+  border: 1px solid #d1d5da;
+}
+
+div.headertitle {
+  padding: 0;
+}
+
+.title ol {
+  margin: 0;
+}
+
+.title ol li {
+  list-style-type: none;
+}
+
+.ui-resizable-e {
+  background: none;
+  background-color: #E6E6E6;
+}
+
+div.fragment {
+  background-color: #f3f3f3;
+  border-radius:5px;
+  border: 0 solid;
+  border: none;
+  padding:16px;
+  transition: all 0.5s ease-in-out;
+}
+
+div.fragment:hover {
+  background-color: #e9e9e9;
+  box-shadow: 0 5px 10px -5px rgb(0,0,0,0.5) inset;
+}
+
+div.line {
+  font-family: "SFMono-Regular", Consolas, "Liberation Mono", Menlo, Courier, monospace;
+  font-size: 90%;
+  font-variant-numeric: tabular-nums lining-nums;
+  font-kerning: none;
+  -webkit-transition-duration: 0;
+  -moz-transition-duration: 0;
+  -ms-transition-duration: 0;
+  -o-transition-duration: 0;
+  transition-duration: 0;
+}
+
+div.line.glow {
+  background-color: auto;
+  box-shadow: none;
+}
+
+/* @group Code Colorization */
+span.keyword {
+  color: #808000
+}
+
+span.keywordtype {
+  color: #808000
+}
+
+span.keywordflow {
+  color: #808000
+}
+
+span.comment {
+  color: #008000
+}
+
+span.preprocessor {
+  color: #800000
+}
+
+span.stringliteral {
+  color: #000080
+}
+
+span.charliteral {
+  color: #000080
+}
+
+blockquote {
+  background-color: #EEEEEE;
+  border-left: 2px solid #606060;
+  margin: 0 24px 0 4px;
+  padding: 0 12px 0 16px;
+}
+
+/* @end */
+
+.arrow {
+  box-sizing: content-box;
+}
+
+img {
+  max-width: 100%;
+  max-height: 100%;
+}
+
+#nav-tree {
+  background-image: none;
+  background-color: white;
+}
+
+#nav-tree .label {
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+  font-size: 14px;
+}
+
+#side-nav {
+  width: 25%;
+  max-width: 50%;
+}
+
+.memtitle {
+  background-image: none;
+}
+
+.memproto {
+  text-shadow: none;
+  /* opera specific markup */
+  box-shadow: none;
+  /* firefox specific markup */
+  -moz-box-shadow: none;
+  -moz-border-radius-topright: 4px;
+  /* webkit specific markup */
+  -webkit-box-shadow: none;
+  -webkit-border-top-right-radius: 4px;
+}
+
+.memdoc {
+  background-image:none;
+  background-repeat:repeat-x;
+  background-color: #FFFFFF;
+  /* opera specific markup */
+  box-shadow: none;
+  /* firefox specific markup */
+  -moz-box-shadow: none;
+  /* webkit specific markup */
+  -webkit-box-shadow: none;
+}
+
+#main-menu {
+  background: none;
+  border-bottom: 1px solid black;
+}
+
+#main-menu li {
+  border: none !important;
+  transition: all 0.1s ease-in-out;
+}
+
+#main-menu li:hover {
+  color:black;
+  background-color:black;
+}
+
+.sm-dox a, .sm-dox a:focus, .sm-dox a:active, .sm-dox a:hover, .sm-dox a.highlighted {
+  background-image:none;
+}
+
+#titlearea {
+  margin: 8px;
+  border: none;
+}

doc/doxygen_footer.html

@@ -0,0 +1,10 @@
+<!-- HTML footer for doxygen 1.8.14-->
+<!-- start footer part -->
+<!--BEGIN GENERATE_TREEVIEW-->
+<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
+</div>
+<!--END GENERATE_TREEVIEW-->
+<!--BEGIN !GENERATE_TREEVIEW-->
+<!--END !GENERATE_TREEVIEW-->
+</body>
+</html>

doc/doxygen_header.html

@@ -0,0 +1,59 @@
+<!-- HTML header for doxygen 1.8.14-->
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta http-equiv="cache-control" content="max-age=86400"/>
+<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
+<meta http-equiv="X-UA-Compatible" content="IE=9"/>
+<meta name="generator" content="Doxygen $doxygenversion"/>
+<meta name="viewport" content="width=device-width, initial-scale=1"/>
+<!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
+<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
+<link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
+<script type="text/javascript" src="$relpath^jquery.js"></script>
+<script type="text/javascript" src="$relpath^dynsections.js"></script>
+$treeview
+$search
+$mathjax
+<link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
+$extrastylesheet
+</head>
+<body>
+<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
+
+<!--BEGIN TITLEAREA-->
+<div id="titlearea">
+<table cellspacing="0" cellpadding="0">
+ <tbody>
+ <tr style="height: 56px;">
+  <!--BEGIN PROJECT_LOGO-->
+  <td id="projectlogo"><img alt="Logo" src="$relpath^$projectlogo"/></td>
+  <!--END PROJECT_LOGO-->
+  <!--BEGIN PROJECT_NAME-->
+  <td id="projectalign" style="padding-left: 0.5em;">
+   <div id="projectname">$projectname
+   <!--BEGIN PROJECT_NUMBER-->&#160;<span id="projectnumber">$projectnumber</span><!--END PROJECT_NUMBER-->
+   </div>
+   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
+  </td>
+  <!--END PROJECT_NAME-->
+  <!--BEGIN !PROJECT_NAME-->
+   <!--BEGIN PROJECT_BRIEF-->
+    <td style="padding-left: 0.5em;">
+    <div id="projectbrief">$projectbrief</div>
+    </td>
+   <!--END PROJECT_BRIEF-->
+  <!--END !PROJECT_NAME-->
+  <!--BEGIN DISABLE_INDEX-->
+   <!--BEGIN SEARCHENGINE-->
+   <td>$searchbox</td>
+   <!--END SEARCHENGINE-->
+  <!--END DISABLE_INDEX-->
+ </tr>
+ </tbody>
+</table>
+</div>
+<!--END TITLEAREA-->
+<!-- end header part -->
+
+

doc/doxygen_layout.xml

@@ -1,56 +1,44 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <doxygenlayout version="1.0">
-  <!-- Generated by doxygen 1.12.0 -->
   <!-- Navigation index tabs for HTML output -->
   <navindex>
-    <tab type="mainpage" visible="no" title=""/>
-    <tab type="pages" visible="yes" title="Pages" intro=""/>
-    <tab type="topics" visible="yes" title="Reference" intro=""/>
-    <tab type="modules" visible="yes" title="" intro="">
-      <tab type="modulelist" visible="yes" title="" intro=""/>
-      <tab type="modulemembers" visible="yes" title="" intro=""/>
-    </tab>
+    <tab type="mainpage" visible="yes" title="Tutorial"/>
+    <tab type="examples" visible="yes" title="" intro=""/>  
+    <tab type="filelist" visible="yes" title=""/>
+
+    <tab type="pages" visible="no" title="" intro=""/>
+    <tab type="modules" visible="yes" title="" intro=""/>
     <tab type="namespaces" visible="yes" title="">
       <tab type="namespacelist" visible="yes" title="" intro=""/>
       <tab type="namespacemembers" visible="yes" title="" intro=""/>
     </tab>
-    <tab type="concepts" visible="yes" title="">
-    </tab>
-    <tab type="interfaces" visible="yes" title="">
+    <tab type="interfaces" visible="no" title="">
       <tab type="interfacelist" visible="yes" title="" intro=""/>
       <tab type="interfaceindex" visible="$ALPHABETICAL_INDEX" title=""/> 
       <tab type="interfacehierarchy" visible="yes" title="" intro=""/>
     </tab>
-    <tab type="classes" visible="yes" title="">
+    <tab type="classes" visible="no" title="">
       <tab type="classlist" visible="yes" title="" intro=""/>
       <tab type="classindex" visible="$ALPHABETICAL_INDEX" title=""/> 
       <tab type="hierarchy" visible="yes" title="" intro=""/>
       <tab type="classmembers" visible="yes" title="" intro=""/>
     </tab>
-    <tab type="structs" visible="yes" title="">
+    <tab type="structs" visible="no" title="">
       <tab type="structlist" visible="yes" title="" intro=""/>
       <tab type="structindex" visible="$ALPHABETICAL_INDEX" title=""/> 
     </tab>
-    <tab type="exceptions" visible="yes" title="">
+    <tab type="exceptions" visible="no" title="">
       <tab type="exceptionlist" visible="yes" title="" intro=""/>
       <tab type="exceptionindex" visible="$ALPHABETICAL_INDEX" title=""/> 
       <tab type="exceptionhierarchy" visible="yes" title="" intro=""/>
     </tab>
-
-    <tab type="files" visible="yes" title="">
-      <tab type="filelist" visible="yes" title="" intro=""/>
-      <tab type="globals" visible="yes" title="" intro=""/>
-    </tab>
-
-    <tab type="examples" visible="yes" title="" intro=""/>
   </navindex>
 
   <!-- Layout definition for a class page -->
   <class>
     <briefdescription visible="yes"/>
-    <includes visible="$SHOW_HEADERFILE"/>
-    <inheritancegraph visible="yes"/>
-    <collaborationgraph visible="yes"/>
+    <includes visible="$SHOW_INCLUDE_FILES"/>
+    <inheritancegraph visible="$CLASS_GRAPH"/>
+    <collaborationgraph visible="$COLLABORATION_GRAPH"/>
     <memberdecl>
       <nestedclasses visible="yes" title=""/>
       <publictypes title=""/>
@@ -108,20 +96,19 @@
   <namespace>
     <briefdescription visible="yes"/>
     <memberdecl>
+      <functions title=""/>
+      <enums title=""/>
+      <typedefs title=""/>
+      <classes visible="yes" title=""/>
+      <structs visible="yes" title=""/>
+
       <nestednamespaces visible="yes" title=""/>
       <constantgroups visible="yes" title=""/>
       <interfaces visible="yes" title=""/>
-      <classes visible="yes" title=""/>
-      <concepts visible="yes" title=""/>
-      <structs visible="yes" title=""/>
       <exceptions visible="yes" title=""/>
-      <typedefs title=""/>
       <sequences title=""/>
       <dictionaries title=""/>
-      <enums title=""/>
-      <functions title=""/>
       <variables title=""/>
-      <properties title=""/>
       <membergroups visible="yes"/>
     </memberdecl>
     <detaileddescription title=""/>
@@ -133,26 +120,16 @@
       <enums title=""/>
       <functions title=""/>
       <variables title=""/>
-      <properties title=""/>
     </memberdef>
     <authorsection visible="yes"/>
   </namespace>
 
-  <!-- Layout definition for a concept page -->
-  <concept>
-    <briefdescription visible="yes"/>
-    <includes visible="$SHOW_HEADERFILE"/>
-    <definition visible="yes" title=""/>
-    <detaileddescription title=""/>
-    <authorsection visible="yes"/>
-  </concept>
-
   <!-- Layout definition for a file page -->
   <file>
     <briefdescription visible="yes"/>
     <includes visible="$SHOW_INCLUDE_FILES"/>
-    <includegraph visible="yes"/>
-    <includedbygraph visible="yes"/>
+    <includegraph visible="$INCLUDE_GRAPH"/>
+    <includedbygraph visible="$INCLUDED_BY_GRAPH"/>
     <sourcelink visible="yes"/>
     <memberdecl>
       <interfaces visible="yes" title=""/>
@@ -160,7 +137,6 @@
       <structs visible="yes" title=""/>
       <exceptions visible="yes" title=""/>
       <namespaces visible="yes" title=""/>
-      <concepts visible="yes" title=""/>
       <constantgroups visible="yes" title=""/>
       <defines title=""/>
       <typedefs title=""/>
@@ -169,7 +145,6 @@
       <enums title=""/>
       <functions title=""/>
       <variables title=""/>
-      <properties title=""/>
       <membergroups visible="yes"/>
     </memberdecl>
     <detaileddescription title=""/>
@@ -182,24 +157,19 @@
       <enums title=""/>
       <functions title=""/>
       <variables title=""/>
-      <properties title=""/>
     </memberdef>
     <authorsection/>
   </file>
 
   <!-- Layout definition for a group page -->
   <group>
-    <briefdescription visible="no"/>
-    <authorsection visible="no"/>
-    <detaileddescription title=""/>
-    <groupgraph visible="yes"/>
+    <briefdescription visible="yes"/>
+    <groupgraph visible="$GROUP_GRAPHS"/>
     <memberdecl>
       <nestedgroups visible="yes" title=""/>
-      <modules visible="yes" title=""/>
       <dirs visible="yes" title=""/>
       <files visible="yes" title=""/>
       <namespaces visible="yes" title=""/>
-      <concepts visible="yes" title=""/>
       <classes visible="yes" title=""/>
       <defines title=""/>
       <typedefs title=""/>
@@ -218,6 +188,7 @@
       <friends title=""/>
       <membergroups visible="yes"/>
     </memberdecl>
+    <detaileddescription title=""/>
     <memberdef>
       <pagedocs/>
       <inlineclasses title=""/>
@@ -237,27 +208,9 @@
       <properties title=""/>
       <friends title=""/>
     </memberdef>
+    <authorsection visible="yes"/>
   </group>
 
-  <!-- Layout definition for a C++20 module page -->
-  <module>
-    <briefdescription visible="yes"/>
-    <exportedmodules visible="yes"/>
-    <memberdecl>
-      <concepts visible="yes" title=""/>
-      <classes visible="yes" title=""/>
-      <enums title=""/>
-      <typedefs title=""/>
-      <functions title=""/>
-      <variables title=""/>
-      <membergroups title=""/>
-    </memberdecl>
-    <detaileddescription title=""/>
-    <memberdecl>
-      <files visible="yes"/>
-    </memberdecl>
-  </module>
-
   <!-- Layout definition for a directory page -->
   <directory>
     <briefdescription visible="yes"/>

doc/footer.html

@@ -1,17 +0,0 @@
-<!-- HTML footer for doxygen 1.9.8-->
-<!-- start footer part -->
-<!--BEGIN GENERATE_TREEVIEW-->
-<div id="nav-path" class="navpath"><!-- id is needed for treeview function! -->
-  <ul>
-    $navpath
-    <li class="footer">$generatedby <a href="https://www.doxygen.org/index.html"><img class="footer" src="$relpath^doxygen.svg" width="104" height="31" alt="doxygen"/></a> $doxygenversion </li>
-  </ul>
-</div>
-<!--END GENERATE_TREEVIEW-->
-<!--BEGIN !GENERATE_TREEVIEW-->
-<hr class="footer"/><address class="footer"><small>
-$generatedby&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="$relpath^doxygen.svg" width="104" height="31" alt="doxygen"/></a> $doxygenversion
-</small></address>
-<!--END !GENERATE_TREEVIEW-->
-</body>
-</html>

doc/getting-started.md

@@ -1,62 +0,0 @@
-@page getting-started Getting Started
-@tableofcontents
-
-![title-img](https://nsm09.casimages.com/img/2025/05/30//2505300816063242518595256.jpg)
-
-# Install FTXUI
-
-To set up FTXUI in your project, follow the [installation guide](installation.html), which provides instructions for multiple build systems and package managers.
-
-# Minimal Example
-
-Save the following code as `main.cpp`:
-
-```cpp
-#include <ftxui/dom/elements.hpp>
-#include <ftxui/screen/screen.hpp>
-#include <iostream>
-
-int main() {
-  using namespace ftxui;
-
-  Element document = hbox({
-    text("left")   | border,
-    text("middle") | border | flex,
-    text("right")  | border,
-  });
-
-  auto screen = Screen::Create(Dimension::Full(), Dimension::Fit(document));
-  Render(screen, document);
-  screen.Print();
-}
-```
-
-Build and run it using your preferred build system.  
-If unsure, start with one of the methods described in the [installation page](installation.html).
-
-Expected output:
-
-```
-┌────┐┌────────────────────────────────────┐┌─────┐
-│left││middle                              ││right│
-└────┘└────────────────────────────────────┘└─────┘
-```
-
-# Starter Template
-
-For a complete working project, clone the official starter repository:
-
-```bash
-git clone https://github.com/ArthurSonzogni/ftxui-starter
-```
-
-Follow the build instructions in the `README.md` of that repository.
-
-<div class="section_buttons">
- 
-| Previous                          | Next                    |
-|:----------------------------------|------------------------:|
-| [Introduction](index.html) | [Modules](modules.html) |
-
- 
-</div>

doc/header.html

@@ -1,183 +0,0 @@
-<!-- HTML header for doxygen 1.9.8-->
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml" lang="$langISO">
-<head>
-<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
-<meta http-equiv="X-UA-Compatible" content="IE=11"/>
-<meta name="generator" content="Doxygen $doxygenversion"/>
-<meta name="viewport" content="width=device-width, initial-scale=1"/>
-<!--BEGIN PROJECT_NAME--><title>$projectname: $title</title><!--END PROJECT_NAME-->
-<!--BEGIN !PROJECT_NAME--><title>$title</title><!--END !PROJECT_NAME-->
-<link href="$relpath^tabs.css" rel="stylesheet" type="text/css"/>
-<!--BEGIN DISABLE_INDEX-->
-  <!--BEGIN FULL_SIDEBAR-->
-<script type="text/javascript">var page_layout=1;</script>
-  <!--END FULL_SIDEBAR-->
-<!--END DISABLE_INDEX-->
-<script type="text/javascript" src="$relpath^jquery.js"></script>
-<script type="text/javascript" src="$relpath^dynsections.js"></script>
-<script type="text/javascript" src="$relpath^doxygen-awesome-fragment-copy-button.js"></script>
-<script type="text/javascript" src="$relpath^doxygen-awesome-paragraph-link.js"></script>
-<script type="text/javascript" src="$relpath^doxygen-awesome-interactive-toc.js"></script>
-<script type="text/javascript" src="$relpath^doxygen-awesome-tabs.js"></script>
-<script type="module">
-    DoxygenAwesomeFragmentCopyButton.init()
-    DoxygenAwesomeParagraphLink.init()
-    DoxygenAwesomeInteractiveToc.init()
-    DoxygenAwesomeTabs.init()
-
-    await new Promise(r => window.addEventListener('DOMContentLoaded', r));
-
-    // Remove title when a img[alt='title-img'] is present.
-    // Find an image with the alt "img-title".
-    const img = document.querySelector("img[alt='title-img']");
-    const header = document.querySelector(".headertitle");
-
-    if (img && header) {
-      // Hide the header title progressively.
-      header.style.display = "none";
-
-      // Show progressively the image.
-      img.style.maxHeight = "40vh";
-      img.style.maxWidth = "100%";
-      img.style.objectFit = "contain";
-    }
-
-    // In the "examples.html" page. Turn every link with text
-    // "examples/<...>
-    //
-    // Add a "demo" link toward.
-    // https://arthursonzogni.github.io/FTXUI/examples/?file=<...>
-    const examples = document.querySelectorAll("a")
-    examples.forEach((example) => {
-      if (!example.textContent.startsWith("examples/")) {
-        return;
-      }
-
-      // Remove the ".cpp" extension from the example name.
-      const exampleName = example.textContent.replace("examples/", "").replace(".cpp", "");
-
-      const a = document.createElement("a");
-      a.textContent = "[demo]";
-      a.href = "https://arthursonzogni.github.io/FTXUI/examples/?file=" + exampleName;
-      a.style.marginRight= "1em";
-      a.style.fontWeight = "bold";
-
-      example.parentElement.insertBefore(a, example)
-    });
-
-    // If the current URL ends with -example.html, we can add a link to the demo
-    // as well using the div.title textContent.
-    const url = new URL(window.location.href);
-    if (url.pathname.endsWith("-example.html")) {
-      // Get the title text.
-      const title = document.querySelector("div.title").textContent;
-      const example = title.replace("examples/", "").replace(".cpp", "");
-
-      // Create a link to the demo.
-      const a = document.createElement("a");
-      a.textContent = "[demo]";
-      a.href = "https://arthursonzogni.github.io/FTXUI/examples/?file=" + example;
-      a.style.marginLeft = "1em";
-      a.style.fontWeight = "bold";
-      a.style.display = "inline-block";
-
-      // Insert the link after the title.
-      const titleDiv = document.querySelector("div.title");
-      if (titleDiv) {
-        titleDiv.insertBefore(a, titleDiv.nextSibling);
-      }
-
-    }
-
-</script>
-<script type="module">
-  // Click on the navtree, except for the main page where this is already done
-  // automatically.
-  let delay = 0;
-  while(true) {
-    const navtree = document.querySelector("div.item.selected");
-    if (!navtree) {
-      delay *= 2;
-      delay += 1;
-      await new Promise(resolve => setTimeout(resolve, delay));
-      continue;
-    }
-
-    // Include only selected navtree items.
-    console.log("navtree.textContent", navtree.textContent);
-    if (!navtree.textContent.includes("Getting Started") &&
-        !navtree.textContent.includes("Installation") &&
-        !navtree.textContent.includes("ftxui / screen") &&
-        !navtree.textContent.includes("ftxui / dom") &&
-        !navtree.textContent.includes("ftxui / component") &&
-        !navtree.textContent.includes("Reference")) {
-      break;
-    }
-
-    // Find the first link inside the navtree.
-    const link = navtree.querySelector("a");
-    if (link) {
-      // Simulate a click on the link.
-      link.click();
-      break;
-    }
-  }
-</script>
-
-$treeview
-$search
-$mathjax
-$darkmode
-<link href="$relpath^$stylesheet" rel="stylesheet" type="text/css" />
-$extrastylesheet
-</head>
-<body>
-<!--BEGIN DISABLE_INDEX-->
-  <!--BEGIN FULL_SIDEBAR-->
-<div id="side-nav" class="ui-resizable side-nav-resizable"><!-- do not remove this div, it is closed by doxygen! -->
-  <!--END FULL_SIDEBAR-->
-<!--END DISABLE_INDEX-->
-
-<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
-
-<!--BEGIN TITLEAREA-->
-<div id="titlearea">
-<table cellspacing="0" cellpadding="0">
- <tbody>
- <tr id="projectrow">
-  <!--BEGIN PROJECT_LOGO-->
-  <td id="projectlogo"><img alt="Logo" src="$relpath^$projectlogo"/></td>
-  <!--END PROJECT_LOGO-->
-  <!--BEGIN PROJECT_NAME-->
-  <td id="projectalign">
-   <div id="projectname">$projectname<!--BEGIN PROJECT_NUMBER--><span id="projectnumber">&#160;$projectnumber</span><!--END PROJECT_NUMBER-->
-   </div>
-   <!--BEGIN PROJECT_BRIEF--><div id="projectbrief">$projectbrief</div><!--END PROJECT_BRIEF-->
-  </td>
-  <!--END PROJECT_NAME-->
-  <!--BEGIN !PROJECT_NAME-->
-   <!--BEGIN PROJECT_BRIEF-->
-    <td>
-    <div id="projectbrief">$projectbrief</div>
-    </td>
-   <!--END PROJECT_BRIEF-->
-  <!--END !PROJECT_NAME-->
-  <!--BEGIN DISABLE_INDEX-->
-   <!--BEGIN SEARCHENGINE-->
-     <!--BEGIN !FULL_SIDEBAR-->
-    <td>$searchbox</td>
-     <!--END !FULL_SIDEBAR-->
-   <!--END SEARCHENGINE-->
-  <!--END DISABLE_INDEX-->
- </tr>
-  <!--BEGIN SEARCHENGINE-->
-   <!--BEGIN FULL_SIDEBAR-->
-   <tr><td colspan="2">$searchbox</td></tr>
-   <!--END FULL_SIDEBAR-->
-  <!--END SEARCHENGINE-->
- </tbody>
-</table>
-</div>
-<!--END TITLEAREA-->
-<!-- end header part -->

doc/installation.md

@@ -1,47 +0,0 @@
-
-@page installation Installation
-@tableofcontents
-
-![title-img](https://nsm09.casimages.com/img/2025/05/30//2505300816063242518595255.jpg)
-
-## Overview
-
-FTXUI can be integrated into your project using several build systems and package managers.  
-This page serves as an entry point for the available integration methods.
-
-## Supported Methods
-
-- @subpage installation_cmake
-- @subpage installation_bazel
-- @subpage installation_vcpkg
-- @subpage installation_conan
-- @subpage installation_manual
-- @subpage installation_nix
-- @subpage installation_debian
-- @subpage installation_arch
-- @subpage installation_opensuse
-- @subpage installation_xmake
-
-## Next Steps
-
-Once FTXUI is installed:
-
-- [Getting Started](getting-started.html): Write and run your first program
-- [Examples](examples.html): See what FTXUI can do
-- Modules:
-  - [DOM](module-dom.html)
-  - [Component](module-component.html)
-  - [Screen](module-screen.html)
-
-## Contributions
-
-If you use another build system or package manager, feel free to contribute a guide.  
-You can also open a feature request on the [GitHub issue tracker](https://github.com/ArthurSonzogni/FTXUI/issues).
-
-<div class="section_buttons">
- 
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
- 
-</div>

doc/installation_arch.md

@@ -1,34 +0,0 @@
-@page installation_arch Arch Linux
-
-FTXUI is packaged on the AUR. Install using an AUR helper:
-
-```bash
-yay -S ftxui
-```
-
-You can also manually download the PKGBUILD from <https://aur.archlinux.org/packages/ftxui>.
-
-Once installed, you can use it in your CMake projects by adding the following to your `CMakeLists.txt`:
-
-```cmake
-find_package(ftxui REQUIRED)
-add_executable(main main.cpp)
-target_link_libraries(main
-  PRIVATE ftxui::screen
-  PRIVATE ftxui::dom
-  PRIVATE ftxui::component
-)
-```
-
-> [!note]
-> This is an unofficial package. That means it is not maintained by the FTXUI
-> team, but by the community. The package maintainers seems to actively update
-> the package to the latest version. Thanks to the maintainers for their work!
-
-<div class="section_buttons">
-
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
-
-</div>

doc/installation_bazel.md

@@ -1,38 +0,0 @@
-@page installation_bazel Bazel
-
-FTXUI can be integrated into your project using [Bazel](https://bazel.build)
-with Bzlmod (Bazel modules).
-
-The library is registered in the [Bazel Central Registry](https://registry.bazel.build/modules/ftxui)
-
-**MODULE.bazel**
-```starlark
-bazel_dep(name = "ftxui", version = "6.1.9")
-```
-
-**BUILD.bazel**
-```starlark
-cc_binary(
-    name = "main",
-    srcs = ["main.cpp"],
-    deps = [
-        "@ftxui//:component",
-        "@ftxui//:dom",
-        "@ftxui//:screen",
-    ],
-)
-```
-
-## Starter Project
-
-You can use the official Bazel starter project for a minimal working setup:
-
-- [ftxui-bazel (starter)](https://github.com/ArthurSonzogni/ftxui-bazel)
- 
-<div class="section_buttons">
- 
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
- 
-</div>

doc/installation_cmake.md

@@ -1,111 +0,0 @@
-@page installation_cmake CMake
-
-@tableofcontents
-
-This page explains how to depend on FTXUI using [CMake](https://cmake.org).  
-
-# Methods of Integration
-
-## Using FetchContent
-
-This approach downloads FTXUI at configure time and doesn't require a system-wide install.
-
-```cmake 
-include(FetchContent)
-
-FetchContent_Declare(ftxui
-  GIT_REPOSITORY https://github.com/ArthurSonzogni/FTXUI
-  GIT_TAG v6.1.9  # Replace with a version, tag, or commit hash
-)
-
-FetchContent_MakeAvailable(ftxui)
-
-add_executable(main main.cpp)
-target_link_libraries(main
-  PRIVATE ftxui::screen
-  PRIVATE ftxui::dom
-  PRIVATE ftxui::component
-)
-```
-
-This ensures reproducible builds and easy dependency management.
-
-## Using find_package
-
-If FTXUI is installed system-wide or via a package manager (e.g. vcpkg or Conan), you can use:
-
-```cmake 
-find_package(ftxui REQUIRED)
-
-add_executable(main main.cpp)
-target_link_libraries(main
-  PRIVATE ftxui::screen
-  PRIVATE ftxui::dom
-  PRIVATE ftxui::component
-)
-```
-
-Make sure the package is visible in your `CMAKE_PREFIX_PATH`.
-
-## Using git submodule
-
-You can also add FTXUI as a [Git submodule](https://git-scm.com/book/en/v2/Git-Tools-Submodules), keeping it as part of your repository:
-
-```cmake
-git submodule add https://github.com/ArthurSonzogni/FTXUI external/ftxui
-git submodule update --init --recursive
-```
-
-When cloning a repository that already includes FTXUI as a submodule, make sure to fetch submodules with:
-
-```
-git clone --recurse-submodules <your-repo>
-# Or, if already cloned:
-git submodule update --init --recursive
-```
-
-Then in your `CMakeLists.txt`:
-
-```cmake
-add_subdirectory(external/ftxui)
-
-add_executable(main main.cpp)
-target_link_libraries(main
-  PRIVATE ftxui::screen
-  PRIVATE ftxui::dom
-  PRIVATE ftxui::component
-)
-```
-
-This approach works well if you want to vendor FTXUI in your own repository.
-
-# Optional CMake Flags
-
-FTXUI supports the following CMake options:
-
-| Option                            | Description                   | Default |
-| --------------------------------- | ----------------------------- | ------- |
-| FTXUI_BUILD_EXAMPLES              | Build bundled examples        | OFF     |
-| FTXUI_BUILD_DOCS                  | Build the documentation       | OFF     |
-| FTXUI_BUILD_TESTS                 | Enable tests                  | OFF     |
-| FTXUI_ENABLE_INSTALL              | Generate install targets      | ON      |
-| FTXUI_MICROSOFT_TERMINAL_FALLBACK | Improve Windows compatibility | ON/OFF  |
-
-To enable an option:
-
-```
-cmake -DFTXUI_BUILD_EXAMPLES=ON ..
-```
-
-# Verifying Integration
-
-To confirm the setup is working, build and run a minimal example.
-If you need a complete template, see: [ftxui-starter](https://github.com/ArthurSonzogni/ftxui-starter)
-
-<div class="section_buttons">
- 
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
- 
-</div>

doc/installation_conan.md

@@ -1,104 +0,0 @@
-@page installation_conan Conan
-@tableofcontents
-
-FTXUI can be easily obtained and integrated into your project using the Conan package manager.
-
-## Prerequisites
-
-First, ensure that Conan is installed on your system. If not, you can install it via pip:
-
-```powershell
-pip install conan
-```
-Conan often works in tandem with CMake, so you will need to have CMake installed as well. Once you have confirmed both Conan and CMake are installed, create a project directory, for example, `ftxui-demo`:
-
-```powershell
-mkdir C:\ftxui-demo
-cd C:\ftxui-demo
-```
-
-## Configuration
-
-After ensuring your environment is set up correctly, create a Conan configuration file `conanfile.txt`. This file is used to declare your project's dependencies. The community-maintained package for FTXUI can be found on [Conan Center](https://conan.io/center/recipes/ftxui).
-
-> [!note]
-> This is an unofficial build script. This means it is not maintained by the FTXUI
-> team but by the community. The package maintainer appears to actively update it
-> to the latest releases. Many thanks to the maintainer for their work!
-
-@todo If you are familiar with the process, please consider adding an "official" build script to Conan Center.
-This could be a GitHub Action that automatically updates Conan Center upon new releases.
-
-```ini
-[requires]
-ftxui/6.0.2
-
-[generators]
-CMakeDeps
-CMakeToolchain
-
-[layout]
-cmake_layout
-```
-
-## Install Dependencies and Build
-
-Once configured, run the following command to install FTXUI and its dependencies:
-
-```powershell
-conan install . --output-folder=build --build=missing
-```
-
-This will download and install `ftxui/6.0.2` along with all its dependencies from Conan's remote repositories.
-
-After the installation completes, you can test it by creating a `demo.cpp` file in your project directory:
-
-```cpp
-#include <ftxui/screen/screen.hpp>
-#include <ftxui/dom/elements.hpp>
-#include <iostream>
-
-int main() {
-    using namespace ftxui;
-    auto document = hbox({
-        text(" Hello "),
-        text("FTXUI ") | bold | color(Color::Red),
-        text(" world! ")
-    });
-    auto screen = Screen::Create(Dimension::Full(), Dimension::Fit(document));
-    Render(screen, document);
-    std::cout << screen.ToString() << std::endl;
-    return 0;
-}
-```
-
-If the test is successful, you can then create a `CMakeLists.txt` file in the project directory:
-
-```cmake
-cmake_minimum_required(VERSION 3.20)
-project(ftxui-demo)
-
-# Set the C++ standard
-set(CMAKE_CXX_STANDARD 20)
-
-# Find the FTXUI package installed via Conan
-find_package(ftxui CONFIG REQUIRED)
-
-# Create the executable
-add_executable(demo demo.cpp)
-
-# Link the executable to the FTXUI library
-target_link_libraries(demo PRIVATE ftxui::component)
-```
-
-@todo 考虑到中国多数地区使用Conan很有可能遇到各种网络问题，我想做一个定制的版本说明，但是我对conan的了解有限再加上没有找到合适的资料，因此这个计划短暂的被搁置了，如果您知道方法，欢迎在[中文版本](xiaoditx.girhub.io/public/docs/ftxui%E4%B8%AD%E6%96%87%E7%BF%BB%E8%AF%91/installation/conan/)的下方留下评论以提醒我
-
----
-
-<div class="section_buttons">
-
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
-
-</div>

doc/installation_debian.md

@@ -1,42 +0,0 @@
-@page installation_debian Debian/Ubuntu
-
-## Debian and Ubuntu Packages (Unofficial)
-
-Pre-built packages are provided by the distributions. Install with:
-
-```bash
-sudo apt install libftxui-dev
-```
-
-The following packages are available:
-- `ftxui-doc`
-- `ftxui-examples`
-- `libftxui-component<version>`
-- `libftxui-dev`
-- `libftxui-dom<version>`
-- `libftxui-screen<version>`
-
-Once installed, you can use it in your CMake projects by adding the following to
-your `CMakeLists.txt`:
-
-```cmake
-find_package(ftxui REQUIRED)
-add_executable(main main.cpp)
-target_link_libraries(main
-  PRIVATE ftxui::screen
-  PRIVATE ftxui::dom
-  PRIVATE ftxui::component
-)
-```
-
-> [!note]
-> This is an **unofficial** package. That means it is not maintained by the FTXUI
-> team, but by the community. 
-
-<div class="section_buttons">
-
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
-
-</div>

doc/installation_manual.md

@@ -1,35 +0,0 @@
-@page installation_manual Manual
-@tableofcontents
-
-## Building from Source (Official)
-
-Clone and build the project using CMake:
-
-```bash
-git clone https://github.com/ArthurSonzogni/FTXUI.git
-cd FTXUI
-cmake -S . -B build -DFTXUI_ENABLE_INSTALL=ON -D
-cmake --build build -j
-sudo cmake --install build
-```
-
-Once installed you can use it in your CMake projects by adding the following to your `CMakeLists.txt`:
-
-```cmake
-find_package(ftxui REQUIRED)
-add_executable(main main.cpp)
-target_link_libraries(main
-  PRIVATE ftxui::screen
-  PRIVATE ftxui::dom
-  PRIVATE ftxui::component
-)
-```
-
-
-<div class="section_buttons">
-
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
-
-</div>

doc/installation_nix.md

@@ -1,38 +0,0 @@
-@page installation_nix Nix
-
-> [!note]
-> FTXUI author is not very knowledgeable about Nix. This page has been mostly
-> generated by AI. If you have any suggestions to improve it, please open a
-> PR.
-
-## Nix Flake
-
-FTXUI ships with a `flake.nix` providing both packages and a development shell.
-
-### Build the Library
-
-```bash
-nix build github:ArthurSonzogni/FTXUI
-```
-
-The resulting package is accessible via the `result` link.
-
-### Use as a Dependency
-
-Add FTXUI to your flake inputs:
-
-```nix
-{
-  inputs.ftxui.url = "github:ArthurSonzogni/FTXUI";
-}
-```
-
-Then reference `ftxui.packages.<system>.ftxui` in your outputs.
-
-<div class="section_buttons">
-
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
-
-</div>

doc/installation_opensuse.md

@@ -1,32 +0,0 @@
-@page installation_opensuse openSUSE
-
-## openSUSE Package (Unofficial)
-
-FTXUI seems to be available from the `devel:libraries:c_c++` repository.
-
-```bash
-sudo zypper addrepo https://download.opensuse.org/repositories/devel:libraries:c_c++/openSUSE_Leap_$releasever/devel:libraries:c_c++.repo
-sudo zypper install ftxui
-```
-
-See <https://build.opensuse.org/package/show/devel:libraries:c_c++/ftxui> for details.
-
-> [!note]
-> This is an **unofficial** package. That means it is not maintained by the FTXUI
-> team, but by the community. 
-
---
-
-> [!note]
-> The FTXUI author is not very knowledgeable about openSUSE. This page has been
-> mostly generated by AI. If you have any suggestions to improve it, please open
-> a PR.
-
-
-<div class="section_buttons">
-
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
-
-</div>

doc/installation_vcpkg.md

@@ -1,79 +0,0 @@
-@page installation_vcpkg Vcpkg
-@tableofcontents
-
-# Vcpkg Package
-
-FTXUI is available in the [Vcpkg registry](https://vcpkg.link/ports/ftxui)
-
-To use it, you can add the following to your `vcpkg.json`:
-
-```json
-{
-  "name": "your-project",
-  "version-string": "0.1.0",
-  "dependencies": [
-    {
-        "name": "ftxui",
-        "version>=": "6.1.9"
-    }
-  ]
-}
-```
-
-# Install FTXUI using Vcpkg
-```bash
-vcpkg install --triplet x64-linux  # or x64-windows / arm64-osx etc.
-```
-
-# Configure your build system.
-If you are using CMake, you can use the following in your `CMakeLists.txt`:
-
-**CMakeLists.txt**
-```cmake
-cmake_minimum_required(VERSION 3.15)
-project(my_project)
-
-# Make sure vcpkg toolchain file is passed at configure time
-find_package(ftxui CONFIG REQUIRED)
-
-add_executable(main main.cpp)
-target_link_libraries(main
-    PRIVATE ftxui::screen
-    PRIVATE ftxui::dom
-    PRIVATE ftxui::component
-)
-```
-
-**main.cpp**
-```cpp
-#include <ftxui/component/screen_interactive.hpp>
-#include <ftxui/component/component.hpp>
-#include <ftxui/component/component_options.hpp>
-
-int main() {
-  using namespace ftxui;
-
-  auto screen = ScreenInteractive::TerminalOutput();
-  auto button = Button("Click me", [] { std::cout << "Clicked!\n"; });
-
-  screen.Loop(button);
-}
-```
-
-**Configure and build the project**
-```bash
-cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=/path/to/vcpkg/scripts/buildsystems/vcpkg.cmake
-cmake --build build
-./build/main
-```
-
-
-
-
-<div class="section_buttons">
- 
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
- 
-</div>

doc/installation_xmake.md

@@ -1,40 +0,0 @@
-@page installation_xmake XMake
-@tableofcontents
-
-## XMake Package (Unofficial)
-
-FTXUI is available in the [xmake-repo](https://github.com/xmake-io/xmake-repo/blob/dev/packages/f/ftxui/xmake.lua)
-
-Example `xmake.lua` snippet:
-
-```lua
-add_requires("ftxui", {system = false})
-
-target("demo")
-    set_kind("binary")
-    add_files("src/*.cpp")
-    add_packages("ftxui")
-```
-
-Refer to the [XMake documentation](https://xmake.io) for further options.
-
-> [!note]
-> This is an **unofficial** package. That means it is not maintained by the FTXUI
-> team, but by the community. 
-
----
-
-> [!note]
-> The FTXUI author is not very knowledgeable about openSUSE. This page has been
-> mostly generated by AI. If you have any suggestions to improve it, please open
-> a PR.
-
----
-
-<div class="section_buttons">
-
-| Previous          |
-|:------------------|
-| [Getting Started](getting-started.html) |
-
-</div>

doc/introduction.md

@@ -1,88 +0,0 @@
-@mainpage Introduction
-@tableofcontents
-
-<img src="https://github.com/ArthurSonzogni/FTXUI/assets/4759106/6925b6da-0a7e-49d9-883c-c890e1f36007" alt="Demo image"></img>
-
-**FTXUI** is simple cross-platform C++ library for terminal based user interfaces!
-
-# Feature
- * Functional style. Inspired by
-   [1](https://hackernoon.com/building-reactive-terminal-interfaces-in-c-d392ce34e649?gi=d9fb9ce35901)
-   and [React](https://reactjs.org/)
- * No dependencies
- * **Cross platform**.
- * Simple and elegant syntax (in my opinion)
- * Keyboard & mouse navigation.
- * Support for [UTF8](https://en.wikipedia.org/wiki/UTF-8) and [fullwidth chars](https://en.wikipedia.org/wiki/Halfwidth_and_fullwidth_forms) (→ 测试)
- * Support for animations. [Demo 1](https://arthursonzogni.github.io/FTXUI/examples/?file=component/menu_underline_animated_gallery), [Demo 2](https://arthursonzogni.github.io/FTXUI/examples/?file=component/button_style)
- * Support for drawing. [Demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/canvas_animated)
- * Learn by [examples](#documentation), and [tutorials](#documentation)
- * Multiple build system and packages: 
- * Good practices: documentation, tests, fuzzers, performance tests, automated CI, automated packaging, etc...
-
-# Example
-
-```cpp
-#include <ftxui/dom/elements.hpp>
-#include <ftxui/screen/screen.hpp>
-#include <iostream>
-
-int main() {
-  using namespace ftxui;
-
-  // Create a simple document with three text elements.
-  Element document = hbox({
-    text("left")   | border,
-    text("middle") | border | flex,
-    text("right")  | border,
-  });
-
-  // Create a screen with full width and height fitting the document.
-  auto screen = Screen::Create(
-    Dimension::Full(),       // Width
-    Dimension::Fit(document) // Height
-  );
-
-  // Render the document onto the screen.
-  Render(screen, document);
-
-  // Print the screen to the console.
-  screen.Print();
-}
-```
-
-Expected output:
-
-```
-┌────┐┌────────────────────────────────────┐┌─────┐
-│left││middle                              ││right│
-└────┘└────────────────────────────────────┘└─────┘
-```
-
-# Supported Platforms
-
-- Linux
-- MacOS
-- Windows
-- WebAssembly
-
-<div class="section_buttons">
- 
-|                                  Next |
-|--------------------------------------:|
-| [Getting Started](getting-started.html) |
- 
-</div>
-
-@defgroup screen ftxui/screen
-
-Please check the [tutorial](module-screen.html) of the `ftxui/screen` module.
-
-@defgroup dom ftxui/dom
-
-Please check the [tutorial](module-dom.html) of the `ftxui/dom` module.
-
-@defgroup component ftxui/component
-
-Please check the [tutorial](module-component.html) of the `ftxui/component`
-module.

doc/mainpage.md

@@ -0,0 +1,874 @@
+\mainpage
+
+# Introduction {#introduction}
+
+Welcome to the FTXUI documentation!
+
+This is a brief tutorial. You are also encouraged to self-learn by reading the
+[examples](./examples.html).
+
+@tableofcontents 
+
+**Short example**
+
+To build a single frame, you need create an `ftxui::Element`, and display it on
+a `ftxui::Screen`.
+
+**main.cpp**
+```cpp
+#include <ftxui/dom/elements.hpp>
+#include <ftxui/screen/screen.hpp>
+#include <iostream>
+
+int main(void) {
+  using namespace ftxui;
+
+  // Define the document
+  Element document =
+    hbox({
+      text("left")   | border,
+      text("middle") | border | flex,
+      text("right")  | border,
+    });
+
+  auto screen = Screen::Create(
+    Dimension::Full(),       // Width
+    Dimension::Fit(document) // Height
+  );
+  Render(screen, document);
+  screen.Print();
+
+  return EXIT_SUCCESS;
+}
+```
+
+
+**output**
+```bash
+┌────┐┌────────────────────────────────────┐┌─────┐
+│left││middle                              ││right│
+└────┘└────────────────────────────────────┘└─────┘
+```
+
+# Build {#build}
+
+## Using CMake {#build-cmake}
+
+This is an example configuration for your **CMakeLists.txt**
+
+CMakeLists.txt
+```cmake
+cmake_minimum_required (VERSION 3.11)
+
+# --- Fetch FTXUI --------------------------------------------------------------
+include(FetchContent)
+
+set(FETCHCONTENT_UPDATES_DISCONNECTED TRUE)
+FetchContent_Declare(ftxui
+  GIT_REPOSITORY https://github.com/ArthurSonzogni/ftxui
+  # Important: Specify a GIT_TAG XXXXX here.
+)
+
+FetchContent_GetProperties(ftxui)
+if(NOT ftxui_POPULATED)
+  FetchContent_Populate(ftxui)
+  add_subdirectory(${ftxui_SOURCE_DIR} ${ftxui_BINARY_DIR} EXCLUDE_FROM_ALL)
+endif()
+
+# ------------------------------------------------------------------------------
+
+project(ftxui-starter
+  LANGUAGES CXX
+  VERSION 1.0.0
+)
+
+add_executable(ftxui-starter src/main.cpp)
+target_include_directories(ftxui-starter PRIVATE src)
+
+target_link_libraries(ftxui-starter
+  PRIVATE ftxui::screen
+  PRIVATE ftxui::dom
+  PRIVATE ftxui::component # Not needed for this example.
+)
+
+```
+
+Subsequently, you build the project in the standard fashion as follows:
+```bash
+mkdir build && cd build
+cmake ..
+make
+./main
+```
+
+# List of modules. {#modules}
+
+The project is comprised of 3 modules:
+
+1. **ftxui/screen** defines a `ftxui::Screen`, a grid of `ftxui::Pixel`.
+
+2. **ftxui/dom** is the main module. It defines a hierarchical set of
+   `ftxui::Element`.  An element draws something on the `ftxui::Screen`. It is
+   responsive to the size of its container.
+
+3. **ftxui/component** The module is required if your program needs to respond
+   to user input. It defines a set of `ftxui::Component`. These components can
+   be utilized to navigate the program by using the arrow keys and interacting
+   with widgets such as the checkbox. You can also make you own components.
+   The use can navigates
+   using the arrow keys and interact with widgets like checkbox/inputbox/... You
+   can make you own components.
+
+# screen {#module-screen}
+
+This is the visual element of the program. It defines a `ftxui::Screen`, which
+is a grid of `ftxui::Pixel`. A Pixel represents a Unicode character and its
+associated style (bold, colors, etc.). The screen can be printed as a string
+using `ftxui::Screen::ToString()`. The following example highlights this
+process:
+
+```cpp
+  #include <ftxui/screen/screen.hpp>
+  #include <iostream>
+
+  int main(void) {
+    using namespace ftxui;
+    auto screen = Screen::Create(Dimension::Fixed(32), Dimension::Fixed(10));
+
+    auto& pixel = screen.PixelAt(9,9);
+    pixel.character = U'A';
+    pixel.bold = true;
+    pixel.foreground_color = Color::Blue;
+
+    std::cout << screen.ToString();
+    return EXIT_SUCCESS;
+  }
+```
+
+# dom {#module-dom}
+
+This module defines a hierarchical set of `ftxui::Element`. An element manages
+the layout and can be responsive to the terminal dimension changes. Note the
+following example where this module is used to create a simple layout with a
+number of operators:
+
+**Example:**
+```cpp
+// Define the document
+Element document = vbox({
+  text("The window") | bold | color(Color::Blue),
+  gauge(0.5)
+  text("The footer")
+});
+
+// Add a border, by calling the `ftxui::border` decorator function.
+document = border(document);
+
+// Add another border, using the pipe operator.
+document = document | border.
+
+// Add another border, using the |= operator.
+document |= border
+
+```
+
+**List of elements**
+
+The list of all elements are included and can be accessed by including the
+corresponding header file:
+```cpp
+#include <ftxui/dom/elements.hpp>
+```
+
+\include ftxui/dom/elements.hpp
+
+## text ## {#dom-text}
+
+The most simple widget. It displays a text.
+```cpp
+text("I am a piece of text");
+```
+```bash
+I am a piece of text.
+```
+
+## vtext {#dom-vtext}
+
+Identical to `ftxui::text`, but displayed vertically.
+
+Code:
+```cpp
+vtext("HELLO");
+```
+
+Terminal output:
+```bash
+H
+E
+L
+L
+O
+```
+
+## paragraph {#dom-paragraph}
+
+Similar to `ftxui::text`, but the individual word are wrapped along multiple
+lines, depending on the width of its container.
+
+Sample Code:
+```cpp
+paragraph("A very long text")
+```
+
+![ezgif com-gif-maker (4)](https://user-images.githubusercontent.com/4759106/147251370-983a06e7-6f41-4113-92b8-942f43d34d06.gif)
+
+For a more detailed example refer to [detailed example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2paragraph_8cpp-example.html). Paragraph also includes a number of other variants as shown below:
+```cpp
+Element paragraph(std::string text);
+Element paragraphAlignLeft(std::string text);
+Element paragraphAlignRight(std::string text);
+Element paragraphAlignCenter(std::string text);
+Element paragraphAlignJustify(std::string text);
+```
+
+
+## border {#dom-border}
+
+Adds a border around an element.
+
+Code:
+```cpp
+border(text("The element"))
+```
+
+Terminal output:
+```bash
+┌───────────┐
+│The element│
+└───────────┘
+```
+
+You can achieve the same behavior by using the pipe operator.
+
+Code:
+```cpp
+text("The element") | border
+```
+
+Border also comes in a variety of styles as shown below:
+```cpp
+Element border(Element);
+Element borderLight(Element);
+Element borderHeavy(Element);
+Element borderDouble(Element);
+Element borderRounded(Element);
+Element borderEmpty(Element);
+Decorator borderStyled(BorderStyle);
+Decorator borderWith(Pixel);
+```
+
+
+## window ## {#dom-window}
+
+A `ftxui::window` is a `ftxui::border`, but with an additional header. To add a
+window around an element, wrap it and specify a string as the header.
+Code:
+```cpp
+window("The window", text("The element"))
+```
+
+Terminal output:
+```bash
+┌The window─┐
+│The element│
+└───────────┘
+```
+
+## separator {#dom-separator}
+
+Displays a vertical/horizontal line to visually split the content of a
+container in two.
+
+Code:
+```cpp
+border(
+  hbox({
+    text("Left"), 
+    separator(),
+    text("Right")
+  })
+)
+```
+
+Terminal output:
+```bash
+┌────┬─────┐
+│left│right│
+└────┴─────┘
+```
+
+
+Separators come in a variety of flavors as shown below:
+```cpp
+Element separator(void);
+Element separatorLight();
+Element separatorHeavy();
+Element separatorDouble();
+Element separatorEmpty();
+Element separatorStyled(BorderStyle);
+Element separator(Pixel);
+Element separatorCharacter(std::string);
+Element separatorHSelector(float left,
+                           float right,
+                           Color background,
+                           Color foreground);
+Element separatorVSelector(float up,
+                           float down,
+                           Color background,
+                           Color foreground);
+```
+
+## gauge {#dom-gauge}
+
+It constitutes a gauge. It can be used to represent a progress bar.
+
+Code:
+```cpp
+border(gauge(0.5))
+```
+
+Teminal output:
+```bash
+┌────────────────────────────────────────────────────────────────────────────┐
+│██████████████████████████████████████                                      │
+└────────────────────────────────────────────────────────────────────────────┘
+```
+
+Gauges can be displayed in many orientations as shown below:
+```cpp
+Element gauge(float ratio);
+Element gaugeLeft(float ratio);
+Element gaugeRight(float ratio);
+Element gaugeUp(float ratio);
+Element gaugeDown(float ratio);
+Element gaugeDirection(float ratio, GaugeDirection);
+```
+
+## graph {#dom-graph}
+
+@htmlonly
+<script id="asciicast-223726" src="https://asciinema.org/a/223726.js" async></script>
+@endhtmlonly
+
+See:
+```cpp
+Element graph(GraphFunction);
+```
+
+## Colors {#dom-colors}
+
+Most terminal consoles can display colored text and colored backgrounds. FTXUI
+supports every color palette:
+```cpp
+Decorator color(Color);
+Decorator bgcolor(Color);
+```
+
+
+Color [gallery](https://arthursonzogni.github.io/FTXUI/examples_2dom_2color_gallery_8cpp-example.html):
+![image](https://user-images.githubusercontent.com/4759106/147248595-04c7245a-5b85-4544-809d-a5984fc6f9e7.png)
+
+### Palette16 #{#dom-colors-palette-16}
+
+On most terminals the following colors are supported:
+- Default
+
+- Black
+- GrayDark
+- GrayLight
+
+- White
+
+- Blue
+- BlueLight
+
+- Cyan
+- CyanLight
+
+- Green
+- GreenLight
+
+- Magenta
+- MagentaLight
+
+- Red
+- RedLight
+
+- Yellow
+- YellowLight
+
+Example use of the above colors using the pipe operator:
+```cpp
+text("Blue foreground") | color(Color::Blue);
+text("Blue background") | bgcolor(Color::Blue);
+text("Black on white") | color(Color::Black) | bgcolor(Color::White);
+```
+
+### Palette256 #{#dom-colors-palette-256}
+
+On terminal supporting 256 colors. 
+@htmlonly
+<script id="asciicast-OAUc3n6QrkmrLt7XEEb8AzbLt" src="https://asciinema.org/a/OAUc3n6QrkmrLt7XEEb8AzbLt.js" async></script>
+@endhtmlonly
+
+```cpp
+text("HotPink") | color(Color::HotPink);
+```
+
+### TrueColor #{#dom-colors-true-color}
+
+On terminal supporting trueColor, you can directly use the 24bit RGB color
+space:
+
+Use the constructors below to specify the **RGB** or **HSV** values for your
+color:
+
+There are two constructors:
+```cpp
+ftxui::Color::RGB(uint8_t red, uint8_t green, uint8_t blue);
+ftxui::Color::HSV(uint8_t hue, uint8_t saturation, uint8_t value);
+```
+
+@htmlonly
+<script id="asciicast-dk5r8IcCH0aFIIgWG0keSEHMG" src="https://asciinema.org/a/dk5r8IcCH0aFIIgWG0keSEHMG.js" async></script>
+<script id="asciicast-xwzzghmqcqzIuyLwCpQFEqbEu" src="https://asciinema.org/a/xwzzghmqcqzIuyLwCpQFEqbEu.js" async></script>
+@endhtmlonly
+
+## LinearGradient #{#dom-linear-gradient}
+
+FTXUI supports linear gradient. Either on the foreground or the background.
+
+```cpp
+Decorator color(const LinearGradient&);
+Decorator bgcolor(const LinearGradient&);
+```
+
+A `ftxui::LinearGradient` is defined by an angle in degree, and a list of color
+stops.
+```cpp
+auto gradient = LinearGradient()
+  .Angle(45)
+  .AddStop(0.0, Color::Red)
+  .AddStop(0.5, Color::Green)
+  .AddStop(1.0, Color::Blue);
+```
+
+You can also use simplified constructors:
+```cpp
+LinearGradient(Color::Red, Color::Blue);
+```
+```cpp
+LinearGradient(45, Color::Red, Color::Blue);
+```
+
+See [demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/linear_gradient_gallery).
+
+
+## Style {#dom-style}
+In addition to colored text and colored backgrounds. Many terminals support text
+effects such as: `bold`, `dim`, `underlined`, `inverted`, `blink`.
+
+```cpp
+Element bold(Element);
+Element dim(Element);
+Element inverted(Element);
+Element underlined(Element);
+Element underlinedDouble(Element);
+Element strikethrough(Element);
+Element blink(Element);
+Decorator color(Color);
+Decorator bgcolor(Color);
+Decorator colorgrad(LinearGradient);
+Decorator bgcolorgrad(LinearGradient);
+```
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2style_gallery_8cpp-example.html)
+
+![image](https://user-images.githubusercontent.com/4759106/147244118-380bf834-9e33-40df-9ff0-07c10f2598ef.png)
+
+To use these effects, simply wrap your elements with your desired effect:
+```cpp
+underlined(bold(text("This text is bold and underlined")))
+```
+
+Alternatively, use the pipe operator to chain it on your element:
+```cpp
+text("This text is bold") | bold | underlined
+```
+
+## Layout {#dom-layout}
+
+Enables elements to be arranged in the following ways:
+  - **Horizontally** with `ftxui::hbox`
+  - **Vertically** with `ftxui::vbox`
+  - **Inside a grid** with `ftxui::gridbox`
+  - **Wrapped along one direction** using the `ftxui::flexbox`.
+  
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2vbox_hbox_8cpp-example.html) using `ftxui::hbox`, `ftxui::vbox` and `ftxui::filler`.
+
+![image](https://user-images.githubusercontent.com/4759106/147242524-7103b5d9-1a92-4e2d-ac70-b3d6740061e3.png)
+  
+  
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2gridbox_8cpp-example.htmlp)
+using `ftxui::gridbox`:
+
+![image](https://user-images.githubusercontent.com/4759106/147242972-0db1f2e9-0790-496f-86e6-ed2c604f7a73.png)
+
+[Example](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/dom/hflow.cpp)
+using flexbox:
+
+![image](https://user-images.githubusercontent.com/4759106/147243064-780ac7cc-605b-475f-94b8-cf7c4aed03a5.png)
+
+Checkout this
+[example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2hflow_8cpp-example.html)
+and the associated
+[demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/flexbox).
+
+Element can also become flexible using the the `ftxui::flex` decorator.
+
+Code:
+```cpp
+  hbox({
+    text("left") | border ,
+    text("middle") | border | flex,
+    text("right") | border,
+  });
+```
+Terminal output:
+```bash
+┌────┐┌─────────────────────────────────────────────────────┐┌─────┐
+│left││middle                                               ││right│
+└────┘└─────────────────────────────────────────────────────┘└─────┘
+```
+
+Code:
+```cpp
+  hbox({
+    text("left") | border ,
+    text("middle") | border | flex,
+    text("right") | border | flex,
+  });
+```
+
+Terminal output:
+```bash
+┌────┐┌───────────────────────────────┐┌───────────────────────────────┐
+│left││middle                         ││right                          │
+└────┘└───────────────────────────────┘└───────────────────────────────┘
+```
+
+## Table {#dom-table}
+
+Enables easy formatting of data into a neat table like visual form.
+
+[Code example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2table_8cpp-example.html):
+  
+![image](https://user-images.githubusercontent.com/4759106/147250766-77d8ec9e-cf2b-486d-9866-1fd9f1bd2e6b.png)
+
+## Canvas {#dom-canvas}
+
+See the API [<ftxui/dom/canvas.hpp>](./canvas_8hpp_source.html)
+
+```cpp
+  auto c = Canvas(100, 100);
+  c.DrawPointLine(10, 10, 80, 10, Color::Red);
+  auto element = canvas(c);
+```
+
+Drawing can be performed on a `ftxui::Canvas`, using braille, block, or simple
+characters:
+  
+Simple [example](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/dom/canvas.cpp):
+  
+![image](https://user-images.githubusercontent.com/4759106/147245843-76cc62fb-ccb4-421b-aacf-939f9afb42fe.png)
+
+Complex [example](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/component/canvas_animated.cpp):
+  
+![ezgif com-gif-maker (3)](https://user-images.githubusercontent.com/4759106/147250538-783a8246-98e0-4a25-b032-3bd3710549d1.gif)
+# component {#module-component}
+
+The `ftxui::component` module defines the logic that produces interactive
+components that respond to user events (keyboard, mouse, etc.).
+
+A `ftxui::ScreenInteractive` defines a main loop that renders a component.
+
+A `ftxui::Component` is a shared pointer to a `ftxui::ComponentBase`. The latter defines:
+  - `ftxui::ComponentBase::Render()`: How to render the interface.
+  - `ftxui::ComponentBase::OnEvent()`: How to react to events.
+  - `ftxui::ComponentBase::Add()`: Construct a parent/child relationship
+    between two components. The tree of component is used to define how to
+    navigate using the keyboard.
+
+`ftxui::Element` are used to render a single frame.
+
+`ftxui::Component` are used to render dynamic user interface, producing multiple
+frame, and updating its state on events.
+
+[Gallery](https://arthursonzogni.github.io/FTXUI/examples_2component_2gallery_8cpp-example.html) of multiple components. ([demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/gallery))
+
+![image](https://user-images.githubusercontent.com/4759106/147247330-b60beb9f-e665-48b4-81c0-4b01ee95bc66.png)
+
+All predefined components are available in
+["ftxui/dom/component.hpp"](./component_8hpp.html)
+
+\include ftxui/component/component.hpp
+
+## Input {#component-input}
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2input_8cpp-example.html):
+
+![image](https://user-images.githubusercontent.com/4759106/147247671-f1d6f606-1845-4e94-a4a0-d4273e9ae6bd.png)
+
+Produced by: `ftxui::Input()` from "ftxui/component/component.hpp"
+
+@htmlonly
+<script id="asciicast-223719" src="https://asciinema.org/a/223719.js" async></script>
+@endhtmlonly
+
+## Menu {#component-menu}
+
+Defines a menu object. It contains a list of entries, one of them is selected.
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2menu_8cpp-example.html):
+
+![image](https://user-images.githubusercontent.com/4759106/147247822-0035fd6f-bb13-4b3a-b057-77eb9291582f.png)
+
+
+Produced by: `ftxui::Menu()` from "ftxui/component/component.hpp"
+
+@htmlonly
+<script id="asciicast-223720" src="https://asciinema.org/a/223720.js" async></script>
+@endhtmlonly
+
+## Toggle {#component-toggle}
+
+A special kind of menu. The entries are displayed horizontally.
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2toggle_8cpp-example.html):
+
+![image](https://user-images.githubusercontent.com/4759106/147249383-e2201cf1-b7b8-4a5a-916f-d761e3e7ae40.png)
+
+Produced by: `ftxui::Toggle()` from "ftxui/component/component.hpp"
+
+@htmlonly
+<script id="asciicast-223722" src="https://asciinema.org/a/223722.js" async></script>
+@endhtmlonly
+
+## CheckBox {#component-checkbox}
+
+This component defines a checkbox. It is a single entry that can be turned
+on/off.
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2checkbox_8cpp-example.html):
+
+![image](https://user-images.githubusercontent.com/4759106/147246646-b86926a9-1ef9-4efb-af98-48a9b62acd81.png)
+
+Produced by: `ftxui::Checkbox()` from "ftxui/component/component.hpp"
+
+@htmlonly
+<script id="asciicast-223724" src="https://asciinema.org/a/223724.js" async></script>
+@endhtmlonly
+
+## RadioBox {#component-radiobox}
+
+A radiobutton component. This is a list of entries, where one can be turned on.
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2radiobox_8cpp-example.html):
+  
+![image](https://user-images.githubusercontent.com/4759106/147246401-809d14a5-6621-4e36-8dd9-a2d75ef2a94e.png)
+
+Produced by: `ftxui::Radiobox()` from "ftxui/component/component.hpp"
+
+@htmlonly
+<script id="asciicast-223725" src="https://asciinema.org/a/223725.js" async></script>
+@endhtmlonly
+
+## Dropdown {#component-dropdown}
+
+A drop down menu is a component that when checked display a list of element for
+the user to select one.
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2dropdown_8cpp-example.html):
+
+![youtube-video-gif (3)](https://user-images.githubusercontent.com/4759106/147246982-1e821751-531c-4e1f-bc37-2fa290e143cd.gif)
+
+Produced by: `ftxui::Dropdown()` from "ftxui/component/component.hpp"
+
+## Slider {#component-slider}
+
+Represents a slider object that consists of a range with binned intermediate
+intervals. It can be created by `ftxui::Slider()`.
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2slider_8cpp-example.html):
+
+![image](https://user-images.githubusercontent.com/4759106/147249265-7e2cad75-082c-436e-affe-44a550c480ab.png)
+
+Produced by: `ftxui::Slider()` from "ftxui/component/component.hpp"
+
+## Renderer {#component-renderer}
+
+Produced by: `ftxui::Renderer()` from \ref ftxui/component/component.hpp. This
+component decorate another one by using a different function to render an
+interface.
+
+Example:
+```cpp
+auto inner = [...]
+
+auto renderer = Renderer(inner, [&] {
+  return inner->Render() | border
+});
+```
+
+`ftxui::Renderer` also supports the component decorator pattern:
+```cpp
+auto component = [...]
+component = component
+  | Renderer([](Element e) { return e | border))
+  | Renderer(bold)
+```
+
+As a short hand, you can also compose a component with an element decorator:
+```cpp
+auto component = [...]
+component = component | border | bold;
+```
+
+## CatchEvent {#component-catchevent}
+
+Produced by: `ftxui::CatchEvent()` from \ref ftxui/component/component.hpp.
+This component decorate others, catching events before the underlying component.
+
+Examples:
+```cpp
+auto screen = ScreenInteractive::TerminalOutput();
+auto renderer = Renderer([] {
+  return text("My interface");
+});
+auto component = CatchEvent(renderer, [&](Event event) {
+  if (event == Event::Character('q')) {
+    screen.ExitLoopClosure()();
+    return true;
+  }
+  return false;
+});
+screen.Loop(component);
+```
+
+The `ftxui::CatchEvent` can also be used as a decorator:
+```cpp
+component = component
+  | CatchEvent(handler_1)
+  | CatchEvent(handler_2)
+  | CatchEvent(handler_3)
+  ;
+```
+
+## Collapsible {#component-collapsible}
+
+Useful for visual elements whose visibility can be toggle on/off by the user.
+Essentially, this the combination of the `ftxui::Checkbox()` and
+`ftxui::Maybe()` components.
+
+```cpp
+auto collabsible = Collapsible("Show more", inner_element);
+```
+
+## Maybe {#component-maybe}
+
+Produced by: `ftxui::Maybe()` from \ref ftxui/component/component.hpp.
+This component can be utilized to show/hide any other component via a boolean or
+a predicate.
+
+Example with a boolean:
+```cpp
+bool show = true;
+auto component = Renderer([]{ return "Hello World!"; });
+auto maybe_component = Maybe(component, &show)
+```
+
+Example with a predicate:
+```cpp
+auto component = Renderer([]{ return "Hello World!"; });
+auto maybe_component = Maybe(component, [&] { return time > 10; })
+```
+
+As usual, `ftxui::Maybe` can also be used as a decorator:
+```cpp
+component = component
+  | Maybe(&a_boolean)
+  | Maybe([&] { return time > 10; })
+  ;
+```
+
+## Container {#component-container}
+
+### Horizontal {#component-horizontal}
+
+Produced by: `ftxui::Container::Horizontal()` from
+"ftxui/component/component.hpp". It displays a list of components horizontally
+and handle keyboard/mouse navigation.
+
+### Vertical {#component-vertical}
+
+Produced by: `ftxui::Container::Vertical()` from
+"ftxui/component/component.hpp". It displays a list of components vertically 
+and handles keyboard/mouse navigation.
+
+### Tab {#component-tab}
+
+Produced by: `ftxui::Container::Tab()` from
+"ftxui/component/component.hpp". It take a list of component and display only
+one of them. This is useful for implementing a tab bar.
+
+[Vertical](https://arthursonzogni.github.io/FTXUI/examples_2component_2tab_vertical_8cpp-example.html):
+  
+![ezgif com-gif-maker (1)](https://user-images.githubusercontent.com/4759106/147250144-22ff044a-4773-4ff7-a49c-12ba4034acb4.gif)
+
+[Horizontal](https://arthursonzogni.github.io/FTXUI/examples_2component_2tab_horizontal_8cpp-example.html):
+  
+  ![ezgif com-gif-maker (2)](https://user-images.githubusercontent.com/4759106/147250217-fe447e0f-7a99-4e08-948a-995087d9b40e.gif)
+
+
+## ResizableSplit  {#component-resizable-split}
+
+It defines a horizontal or vertical separation between two children components.
+The position of the split is variable and controllable using the mouse. 
+There are four possible splits:
+- `ftxui::ResizableSplitLeft()`
+- `ftxui::ResizableSplitRight()`
+- `ftxui::ResizableSplitTop()`
+- `ftxui::ResizableSplitBottom()`
+from "ftxui/component/component.hpp"
+
+[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2resizable_split_8cpp-example.html):
+
+![ezgif com-gif-maker](https://user-images.githubusercontent.com/4759106/147248372-c55512fe-9b96-4b08-a1df-d05cf2cae431.gif)  
+
+@htmlonly
+<script id="asciicast-tprMH2EdkUoMb7D2YxgMGgpzx" src="https://asciinema.org/a/tprMH2EdkUoMb7D2YxgMGgpzx.js" async></script>
+@endhtmlonly
+
+## Force a frame redraw. {#component-force-redraw}
+
+Typically, `ftxui::ScreenInteractive::Loop()` is responsible for drawing a new
+frame whenever a new group of events (e.g keyboard, mouse, window resize, etc.)
+has been processed. However, you might want to react to arbitrary events that
+are unknown to FTXUI. To accomplish this, you must post events using
+`ftxui::ScreenInteractive::PostEvent` (**this is thread safe**) via a thread.
+You will have to post the event `ftxui::Event::Custom`.
+
+Example:
+```cpp
+screen->PostEvent(Event::Custom);
+```

doc/module-component.md

@@ -1,308 +0,0 @@
-@page module-component ftxui / component
-@tableofcontents
-
-![title-img](https://nsm09.casimages.com/img/2025/05/31//2505310207423242518595349.png)
-
-The `ftxui::component` module defines the logic that produces interactive
-components that respond to user events (keyboard, mouse, etc.).
-
-The @subpage module-component-examples section provides a collection of examples.
-
-A `ftxui::ScreenInteractive` defines a main loop that renders a component.
-
-A `ftxui::Component` is a shared pointer to a `ftxui::ComponentBase`. The latter defines:
-  - `ftxui::ComponentBase::Render()`: How to render the interface.
-  - `ftxui::ComponentBase::OnEvent()`: How to react to events.
-  - `ftxui::ComponentBase::Add()`: Construct a parent/child relationship
-    between two components. The tree of components is used to define how to
-    navigate using the keyboard.
-
-`ftxui::Element` are used to render a single frame.
-
-`ftxui::Component` are used to render dynamic user interface, producing multiple
-frame, and updating its state on events.
-
-[Gallery](https://arthursonzogni.github.io/FTXUI/examples_2component_2gallery_8cpp-example.html) of multiple components. ([demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/gallery))
-
-![image](https://user-images.githubusercontent.com/4759106/147247330-b60beb9f-e665-48b4-81c0-4b01ee95bc66.png)
-
-All predefined components are available in
-["ftxui/dom/component.hpp"](./component_8hpp.html)
-
-\include ftxui/component/component.hpp
-
-# Input {#component-input}
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2input_8cpp-example.html):
-
-![image](https://user-images.githubusercontent.com/4759106/147247671-f1d6f606-1845-4e94-a4a0-d4273e9ae6bd.png)
-
-Produced by: `ftxui::Input()` from "ftxui/component/component.hpp"
-
-@htmlonly
-<script id="asciicast-223719" src="https://asciinema.org/a/223719.js" async></script>
-@endhtmlonly
-
-## Filtered input
-
-One can filter out the characters received by the input component, using
-`ftxui::CatchEvent`.
-
-```cpp
-std::string phone_number;
-Component input = Input(&phone_number, "phone number");
-
-// Filter out non-digit characters.
-input |= CatchEvent([&](Event event) {
-  return event.is_character() && !std::isdigit(event.character()[0]);
-});
-
-// Filter out characters past the 10th one.
-input |= CatchEvent([&](Event event) {
-  return event.is_character() && phone_number.size() >= 10;
-});
-```
-
-# Menu {#component-menu}
-
-Defines a menu object. It contains a list of entries, one of them is selected.
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2menu_8cpp-example.html):
-
-![image](https://user-images.githubusercontent.com/4759106/147247822-0035fd6f-bb13-4b3a-b057-77eb9291582f.png)
-
-
-Produced by: `ftxui::Menu()` from "ftxui/component/component.hpp"
-
-@htmlonly
-<script id="asciicast-223720" src="https://asciinema.org/a/223720.js" async></script>
-@endhtmlonly
-
-# Toggle {#component-toggle}
-
-A special kind of menu. The entries are displayed horizontally.
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2toggle_8cpp-example.html):
-
-![image](https://user-images.githubusercontent.com/4759106/147249383-e2201cf1-b7b8-4a5a-916f-d761e3e7ae40.png)
-
-Produced by: `ftxui::Toggle()` from "ftxui/component/component.hpp"
-
-@htmlonly
-<script id="asciicast-223722" src="https://asciinema.org/a/223722.js" async></script>
-@endhtmlonly
-
-# CheckBox {#component-checkbox}
-
-This component defines a checkbox. It is a single entry that can be turned
-on/off.
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2checkbox_8cpp-example.html):
-
-![image](https://user-images.githubusercontent.com/4759106/147246646-b86926a9-1ef9-4efb-af98-48a9b62acd81.png)
-
-Produced by: `ftxui::Checkbox()` from "ftxui/component/component.hpp"
-
-@htmlonly
-<script id="asciicast-223724" src="https://asciinema.org/a/223724.js" async></script>
-@endhtmlonly
-
-# RadioBox {#component-radiobox}
-
-A radiobutton component. This is a list of entries, where one can be turned on.
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2radiobox_8cpp-example.html):
-  
-![image](https://user-images.githubusercontent.com/4759106/147246401-809d14a5-6621-4e36-8dd9-a2d75ef2a94e.png)
-
-Produced by: `ftxui::Radiobox()` from "ftxui/component/component.hpp"
-
-@htmlonly
-<script id="asciicast-223725" src="https://asciinema.org/a/223725.js" async></script>
-@endhtmlonly
-
-# Dropdown {#component-dropdown}
-
-A drop-down menu is a component that, when opened, displays a list of elements
-for the user to select from.
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2dropdown_8cpp-example.html):
-
-![youtube-video-gif (3)](https://user-images.githubusercontent.com/4759106/147246982-1e821751-531c-4e1f-bc37-2fa290e143cd.gif)
-
-Produced by: `ftxui::Dropdown()` from "ftxui/component/component.hpp"
-
-# Slider {#component-slider}
-
-Represents a slider object that consists of a range with binned intermediate
-intervals. It can be created by `ftxui::Slider()`.
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2slider_8cpp-example.html):
-
-![image](https://user-images.githubusercontent.com/4759106/147249265-7e2cad75-082c-436e-affe-44a550c480ab.png)
-
-Produced by: `ftxui::Slider()` from "ftxui/component/component.hpp"
-
-# Renderer {#component-renderer}
-
-Produced by: `ftxui::Renderer()` from \ref ftxui/component/component.hpp. This
-component decorate another one by using a different function to render an
-interface.
-
-Example:
-```cpp
-auto inner = [...]
-
-auto renderer = Renderer(inner, [&] {
-  return inner->Render() | border
-});
-```
-
-`ftxui::Renderer` also supports the component decorator pattern:
-```cpp
-auto component = [...]
-component = component
-  | Renderer([](Element e) { return e | border))
-  | Renderer(bold)
-```
-
-As a short hand, you can also compose a component with an element decorator:
-```cpp
-auto component = [...]
-component = component | border | bold;
-```
-
-# CatchEvent {#component-catchevent}
-
-Produced by: `ftxui::CatchEvent()` from \ref ftxui/component/component.hpp.
-This component decorate others, catching events before the underlying component.
-
-Examples:
-```cpp
-auto screen = ScreenInteractive::TerminalOutput();
-auto renderer = Renderer([] {
-  return text("My interface");
-});
-auto component = CatchEvent(renderer, [&](Event event) {
-  if (event == Event::Character('q')) {
-    screen.ExitLoopClosure()();
-    return true;
-  }
-  return false;
-});
-screen.Loop(component);
-```
-
-The `ftxui::CatchEvent` can also be used as a decorator:
-```cpp
-component = component
-  | CatchEvent(handler_1)
-  | CatchEvent(handler_2)
-  | CatchEvent(handler_3)
-  ;
-```
-
-# Collapsible {#component-collapsible}
-
-Useful for visual elements whose visibility can be toggled on or off by the
-user. Essentially, this is the combination of the `ftxui::Checkbox()` and
-`ftxui::Maybe()` components.
-
-```cpp
-auto collapsible = Collapsible("Show more", inner_element);
-```
-
-# Maybe {#component-maybe}
-
-Produced by: `ftxui::Maybe()` from \ref ftxui/component/component.hpp.
-This component can be utilized to show/hide any other component via a boolean or
-a predicate.
-
-Example with a boolean:
-```cpp
-bool show = true;
-auto component = Renderer([]{ return "Hello World!"; });
-auto maybe_component = Maybe(component, &show)
-```
-
-Example with a predicate:
-```cpp
-auto component = Renderer([]{ return "Hello World!"; });
-auto maybe_component = Maybe(component, [&] { return time > 10; })
-```
-
-As usual, `ftxui::Maybe` can also be used as a decorator:
-```cpp
-component = component
-  | Maybe(&a_boolean)
-  | Maybe([&] { return time > 10; })
-  ;
-```
-
-# Container {#component-container}
-
-## Horizontal {#component-horizontal}
-
-Produced by: `ftxui::Container::Horizontal()` from
-"ftxui/component/component.hpp". It displays a list of components horizontally
-and handles keyboard/mouse navigation.
-
-## Vertical {#component-vertical}
-
-Produced by: `ftxui::Container::Vertical()` from
-"ftxui/component/component.hpp". It displays a list of components vertically 
-and handles keyboard/mouse navigation.
-
-## Tab {#component-tab}
-
-Produced by: `ftxui::Container::Tab()` from
-"ftxui/component/component.hpp". It takes a list of components and displays
-only one of them. This is useful for implementing a tab bar.
-
-[Vertical](https://arthursonzogni.github.io/FTXUI/examples_2component_2tab_vertical_8cpp-example.html):
-  
-![ezgif com-gif-maker (1)](https://user-images.githubusercontent.com/4759106/147250144-22ff044a-4773-4ff7-a49c-12ba4034acb4.gif)
-
-[Horizontal](https://arthursonzogni.github.io/FTXUI/examples_2component_2tab_horizontal_8cpp-example.html):
-  
-  ![ezgif com-gif-maker (2)](https://user-images.githubusercontent.com/4759106/147250217-fe447e0f-7a99-4e08-948a-995087d9b40e.gif)
-
-
-# ResizableSplit  {#component-resizable-split}
-
-It defines a horizontal or vertical separation between two children components.
-The position of the split is variable and controllable using the mouse. 
-There are four possible splits:
-- `ftxui::ResizableSplitLeft()`
-- `ftxui::ResizableSplitRight()`
-- `ftxui::ResizableSplitTop()`
-- `ftxui::ResizableSplitBottom()`
-from "ftxui/component/component.hpp"
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2component_2resizable_split_8cpp-example.html):
-
-![ezgif com-gif-maker](https://user-images.githubusercontent.com/4759106/147248372-c55512fe-9b96-4b08-a1df-d05cf2cae431.gif)  
-
-@htmlonly
-<script id="asciicast-tprMH2EdkUoMb7D2YxgMGgpzx" src="https://asciinema.org/a/tprMH2EdkUoMb7D2YxgMGgpzx.js" async></script>
-@endhtmlonly
-
-# Force a frame redraw. {#component-force-redraw}
-
-Typically, `ftxui::ScreenInteractive::Loop()` is responsible for drawing a new
-frame whenever a new group of events (e.g keyboard, mouse, window resize, etc.)
-has been processed. However, you might want to react to arbitrary events that
-are unknown to FTXUI. To accomplish this, you must post events using
-`ftxui::ScreenInteractive::PostEvent` (**this is thread safe**) via a thread.
-You will have to post the event `ftxui::Event::Custom`.
-
-Example:
-```cpp
-screen->PostEvent(Event::Custom);
-```
-
-If you don't need to process a new Event, you can use:
-```cpp
-screen->RequestAnimationFrame();
-```
-instead.

doc/module-dom.md

@@ -1,470 +0,0 @@
-@page module-dom ftxui / dom
-@tableofcontents
-
-![title-img](https://nsm09.casimages.com/img/2025/05/31//2505310207423242518595347.png)
-
-This module defines a hierarchical set of `ftxui::Element`. An element manages
-the layout and can be responsive to the terminal dimension changes. Note the
-following example where this module is used to create a simple layout with a
-number of operators:
-
-The @subpage module-dom-examples section provides a collection of examples.
-
-**Example:**
-```cpp
-namespace ftxui {
-    ...
-
-// Define the document
-Element document = vbox({
-  text("The window") | bold | color(Color::Blue),
-  gauge(0.5)
-  text("The footer")
-});
-
-// Add a border, by calling the `ftxui::border` decorator function.
-document = border(document);
-
-// Add another border, using the pipe operator.
-document = document | border.
-
-// Add another border, using the |= operator.
-document |= border
-
-...
-}
-```
-
-**List of elements**
-
-The list of all elements are included and can be accessed by including the
-corresponding header file:
-```cpp
-#include <ftxui/dom/elements.hpp>
-```
-
-\include{strip} "ftxui/dom/elements.hpp"
-
-# text # {#dom-text}
-
-The most simple widget. It displays a text.
-```cpp
-text("I am a piece of text");
-```
-```bash
-I am a piece of text.
-```
-
-# vtext {#dom-vtext}
-
-Identical to `ftxui::text`, but displayed vertically.
-
-Code:
-```cpp
-vtext("HELLO");
-```
-
-Terminal output:
-```bash
-H
-E
-L
-L
-O
-```
-
-# paragraph {#dom-paragraph}
-
-Similar to `ftxui::text`, but the individual word are wrapped along multiple
-lines, depending on the width of its container.
-
-Sample Code:
-```cpp
-paragraph("A very long text")
-```
-
-![ezgif com-gif-maker (4)](https://user-images.githubusercontent.com/4759106/147251370-983a06e7-6f41-4113-92b8-942f43d34d06.gif)
-
-For a more detailed example refer to [detailed example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2paragraph_8cpp-example.html). Paragraph also includes a number of other variants as shown below:
-```cpp
-namespace ftxui {
-    Element paragraph(std::string text);
-    Element paragraphAlignLeft(std::string text);
-    Element paragraphAlignRight(std::string text);
-    Element paragraphAlignCenter(std::string text);
-    Element paragraphAlignJustify(std::string text);
-}
-```
-
-
-# border {#dom-border}
-
-Adds a border around an element.
-
-Code:
-```cpp
-border(text("The element"))
-```
-
-Terminal output:
-```bash
-┌───────────┐
-│The element│
-└───────────┘
-```
-
-> [!note]
-> You can achieve the same behavior by using the pipe operator.
-> 
-> Code:
-> ```cpp
-> text("The element") | border
-> ```
-
-Border also comes in a variety of styles as shown below:
-```cpp
-namespace ftxui {
-    Element border(Element);
-    Element borderLight(Element);
-    Element borderHeavy(Element);
-    Element borderDouble(Element);
-    Element borderRounded(Element);
-    Element borderEmpty(Element);
-    Decorator borderStyled(BorderStyle);
-    Decorator borderWith(Pixel);
-}
-```
-
-
-# window # {#dom-window}
-
-A `ftxui::window` is a `ftxui::border`, but with an additional header. To add a
-window around an element, wrap it and specify a string as the header.
-Code:
-```cpp
-window("The window", text("The element"))
-```
-
-Terminal output:
-```bash
-┌The window─┐
-│The element│
-└───────────┘
-```
-
-# separator {#dom-separator}
-
-Displays a vertical/horizontal line to visually split the content of a
-container in two.
-
-Code:
-```cpp
-border(
-  hbox({
-    text("Left"), 
-    separator(),
-    text("Right")
-  })
-)
-```
-
-Terminal output:
-```bash
-┌────┬─────┐
-│left│right│
-└────┴─────┘
-```
-
-
-Separators come in a variety of flavors as shown below:
-```cpp
-namespace ftxui {
-    Element separator(void);
-    Element separatorLight();
-    Element separatorHeavy();
-    Element separatorDouble();
-    Element separatorEmpty();
-    Element separatorStyled(BorderStyle);
-    Element separator(Pixel);
-    Element separatorCharacter(std::string);
-    Element separatorHSelector(float left,
-                               float right,
-                               Color background,
-                               Color foreground);
-    Element separatorVSelector(float up,
-                               float down,
-                               Color background,
-                               Color foreground);
-}
-```
-
-# gauge {#dom-gauge}
-
-This is a visual element that represents a ratio of progress.
-
-Code:
-```cpp
-border(gauge(0.5))
-```
-
-Terminal output:
-```bash
-┌────────────────────────────────────────────────────────────────────────────┐
-│██████████████████████████████████████                                      │
-└────────────────────────────────────────────────────────────────────────────┘
-```
-
-Gauges can be displayed in many orientations as shown below:
-```cpp
-namespace {
-    Element gauge(float ratio);
-    Element gaugeLeft(float ratio);
-    Element gaugeRight(float ratio);
-    Element gaugeUp(float ratio);
-    Element gaugeDown(float ratio);
-    Element gaugeDirection(float ratio, GaugeDirection);
-}
-```
-
-# graph {#dom-graph}
-
-@htmlonly
-<script id="asciicast-223726" src="https://asciinema.org/a/223726.js" async></script>
-@endhtmlonly
-
-See:
-```cpp
-Element graph(GraphFunction);
-```
-
-# Colors {#dom-colors}
-
-Most terminal consoles can display colored text and colored backgrounds. FTXUI
-supports every color palette:
-```cpp
-Decorator color(Color);
-Decorator bgcolor(Color);
-```
-
-
-Color [gallery](https://arthursonzogni.github.io/FTXUI/examples_2dom_2color_gallery_8cpp-example.html):
-![image](https://user-images.githubusercontent.com/4759106/147248595-04c7245a-5b85-4544-809d-a5984fc6f9e7.png)
-
-## Palette16 #{#dom-colors-palette-16}
-
-On most terminals the following colors are supported:
-- Default
-
-- Black
-- GrayDark
-- GrayLight
-
-- White
-
-- Blue
-- BlueLight
-
-- Cyan
-- CyanLight
-
-- Green
-- GreenLight
-
-- Magenta
-- MagentaLight
-
-- Red
-- RedLight
-
-- Yellow
-- YellowLight
-
-Example use of the above colors using the pipe operator:
-```cpp
-text("Blue foreground") | color(Color::Blue);
-text("Blue background") | bgcolor(Color::Blue);
-text("Black on white") | color(Color::Black) | bgcolor(Color::White);
-```
-
-## Palette256 #{#dom-colors-palette-256}
-
-On terminal supporting 256 colors. 
-@htmlonly
-<script id="asciicast-OAUc3n6QrkmrLt7XEEb8AzbLt" src="https://asciinema.org/a/OAUc3n6QrkmrLt7XEEb8AzbLt.js" async></script>
-@endhtmlonly
-
-```cpp
-text("HotPink") | color(Color::HotPink);
-```
-
-## TrueColor #{#dom-colors-true-color}
-
-On terminal supporting trueColor, you can directly use the 24bit RGB color
-space:
-
-Use the constructors below to specify the **RGB** or **HSV** values for your
-color:
-
-There are two constructors:
-```cpp
-ftxui::Color::RGB(uint8_t red, uint8_t green, uint8_t blue);
-ftxui::Color::HSV(uint8_t hue, uint8_t saturation, uint8_t value);
-```
-
-@htmlonly
-<script id="asciicast-dk5r8IcCH0aFIIgWG0keSEHMG" src="https://asciinema.org/a/dk5r8IcCH0aFIIgWG0keSEHMG.js" async></script>
-<script id="asciicast-xwzzghmqcqzIuyLwCpQFEqbEu" src="https://asciinema.org/a/xwzzghmqcqzIuyLwCpQFEqbEu.js" async></script>
-@endhtmlonly
-
-# LinearGradient #{#dom-linear-gradient}
-
-FTXUI supports linear gradient. Either on the foreground or the background.
-
-```cpp
-Decorator color(const LinearGradient&);
-Decorator bgcolor(const LinearGradient&);
-```
-
-A `ftxui::LinearGradient` is defined by an angle in degree, and a list of color
-stops.
-```cpp
-auto gradient = LinearGradient()
-  .Angle(45)
-  .AddStop(0.0, Color::Red)
-  .AddStop(0.5, Color::Green)
-  .AddStop(1.0, Color::Blue);
-```
-
-You can also use simplified constructors:
-```cpp
-LinearGradient(Color::Red, Color::Blue);
-```
-```cpp
-LinearGradient(45, Color::Red, Color::Blue);
-```
-
-See [demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/linear_gradient_gallery).
-
-
-# Style {#dom-style}
-In addition to colored text and colored backgrounds. Many terminals support text
-effects such as: `bold`, `italic`, `dim`, `underlined`, `inverted`, `blink`.
-
-```cpp
-Element bold(Element);
-Element italic(Element);
-Element dim(Element);
-Element inverted(Element);
-Element underlined(Element);
-Element underlinedDouble(Element);
-Element strikethrough(Element);
-Element blink(Element);
-Decorator color(Color);
-Decorator bgcolor(Color);
-Decorator colorgrad(LinearGradient);
-Decorator bgcolorgrad(LinearGradient);
-```
-
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2style_gallery_8cpp-example.html)
-
-![image](https://user-images.githubusercontent.com/4759106/147244118-380bf834-9e33-40df-9ff0-07c10f2598ef.png)
-
-To use these effects, simply wrap your elements with your desired effect:
-```cpp
-underlined(bold(text("This text is bold and underlined")))
-```
-
-Alternatively, use the pipe operator to chain it on your element:
-```cpp
-text("This text is bold") | bold | underlined
-```
-
-# Layout {#dom-layout}
-
-Enables elements to be arranged in the following ways:
-  - **Horizontally** with `ftxui::hbox`
-  - **Vertically** with `ftxui::vbox`
-  - **Inside a grid** with `ftxui::gridbox`
-  - **Wrapped along one direction** using the `ftxui::flexbox`.
-  
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2vbox_hbox_8cpp-example.html) using `ftxui::hbox`, `ftxui::vbox` and `ftxui::filler`.
-
-![image](https://user-images.githubusercontent.com/4759106/147242524-7103b5d9-1a92-4e2d-ac70-b3d6740061e3.png)
-  
-  
-[Example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2gridbox_8cpp-example.htmlp)
-using `ftxui::gridbox`:
-
-![image](https://user-images.githubusercontent.com/4759106/147242972-0db1f2e9-0790-496f-86e6-ed2c604f7a73.png)
-
-[Example](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/dom/hflow.cpp)
-using flexbox:
-
-![image](https://user-images.githubusercontent.com/4759106/147243064-780ac7cc-605b-475f-94b8-cf7c4aed03a5.png)
-
-Checkout this
-[example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2hflow_8cpp-example.html)
-and the associated
-[demo](https://arthursonzogni.github.io/FTXUI/examples/?file=component/flexbox).
-
-Element can also become flexible using the `ftxui::flex` decorator.
-
-Code:
-```cpp
-  hbox({
-    text("left") | border ,
-    text("middle") | border | flex,
-    text("right") | border,
-  });
-```
-Terminal output:
-```bash
-┌────┐┌─────────────────────────────────────────────────────┐┌─────┐
-│left││middle                                               ││right│
-└────┘└─────────────────────────────────────────────────────┘└─────┘
-```
-
-Code:
-```cpp
-  hbox({
-    text("left") | border ,
-    text("middle") | border | flex,
-    text("right") | border | flex,
-  });
-```
-
-Terminal output:
-```bash
-┌────┐┌───────────────────────────────┐┌───────────────────────────────┐
-│left││middle                         ││right                          │
-└────┘└───────────────────────────────┘└───────────────────────────────┘
-```
-
-# Table {#dom-table}
-
-Enables easy formatting of data into a neat table like visual form.
-
-[Code example](https://arthursonzogni.github.io/FTXUI/examples_2dom_2table_8cpp-example.html):
-  
-![image](https://user-images.githubusercontent.com/4759106/147250766-77d8ec9e-cf2b-486d-9866-1fd9f1bd2e6b.png)
-
-# Canvas {#dom-canvas}
-
-See the API [<ftxui/dom/canvas.hpp>](./canvas_8hpp_source.html)
-
-```cpp
-  auto c = Canvas(100, 100);
-  c.DrawPointLine(10, 10, 80, 10, Color::Red);
-  auto element = canvas(c);
-```
-
-Drawing can be performed on a `ftxui::Canvas`, using braille, block, or simple
-characters:
-  
-Simple [example](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/dom/canvas.cpp):
-  
-![image](https://user-images.githubusercontent.com/4759106/147245843-76cc62fb-ccb4-421b-aacf-939f9afb42fe.png)
-
-Complex [example](https://github.com/ArthurSonzogni/FTXUI/blob/master/examples/component/canvas_animated.cpp):
-  
-![ezgif com-gif-maker (3)](https://user-images.githubusercontent.com/4759106/147250538-783a8246-98e0-4a25-b032-3bd3710549d1.gif)

doc/module-screen.md

@@ -1,202 +0,0 @@
-@page module-screen ftxui / screen
-@tableofcontents
-
-![title-img](https://nsm09.casimages.com/img/2025/05/31//2505310207423242518595348.png)
-
-The `ftxui::screen` module is the low-level foundation. It can be used
-standalone, but it is primarily designed to be used together by
-[ftxui::dom](module-dom.html) and [ftxui::component](module-component.html)
-modules.
-
-It provides a @ref ftxui::Screen.
-
----
-
-# ftxui::Screen
-
-The @ref ftxui::Screen class represents a 2D grid of styled characters that can
-be rendered to a terminal.  
-It provides methods to create a screen, access pixels, and render elements.
-
-You can access the individual cells (@ref ftxui::Pixel) of the screen using 
-the @ref ftxui::Screen::PixelAt method, which returns a reference
-to the pixel at the specified coordinates.
-
-**Example**
-```cpp
-#include <ftxui/screen/screen.hpp>
-#include <ftxui/screen/color.hpp>
-
-void main() {
-    auto screen = ftxui::Screen::Create(
-        ftxui::Dimension::Full(),   // Use full terminal width
-        ftxui::Dimension::Fixed(10) // Fixed height of 10 rows
-    );
-
-    // Access a specific pixel at (10, 5)
-    auto& pixel = screen.PixelAt(10, 5);
-
-    // Set properties of the pixel.
-    pixel.character = U'X';
-    pixel.foreground_color = ftxui::Color::Red;
-    pixel.background_color = ftxui::Color::RGB(0, 255, 0);
-    pixel.bold = true; // Set bold style
-    screen.Print(); // Print the screen to the terminal
-}
-```
-
-> [!note]
-> If the coordinates are out of bounds, a dummy pixel is returned.
-
-The screen can be printed to the terminal using @ref ftxui::Screen::Print() or
-converted to a std::string with @ref ftxui::Screen::ToString().
-
-<div class="tabbed">
- 
-- <b class="tab-title">Print()</b>
-  ```cpp
-  auto screen = ...;
-  screen.Print();
-  ```
-- <b class="tab-title">ToString()</b>
-  ```cpp
-  auto screen = ...;
-  std::cout << screen.ToString();
-  ```
- 
-</div>
-
-Note that you can reset the cursor position to the top-left corner of the
-screen after printing by calling @ref ftxui::Screen::ResetCursorPosition().
-
-**Example**
-```cpp
-auto screen = ...;
-while(true) {
-  // Drawing operations:
-  ...
-  
-  // Print the screen to the terminal. Then reset the cursor position and the
-  // screen content.
-  std::cout << screen.ToString();
-  std::cout << screen.ResetCursorPosition(/*clear=*/true);
-  std::cout << std::flush;
-
-  // Sleep for a short duration to control the refresh rate.
-  std::this_thread::sleep_for(std::chrono::milliseconds(100));
-}
-```
-
----
-
-# ftxui::Dimension
-
-The @ref ftxui::Dimension utility controls screen sizing:
-
-* `Dimension::Full()` — use full terminal width or height
-* `Dimension::Fit(element)` — size to fit the rendered @ref ftxui::Element
-* `Dimension::Fixed(n)` — use exactly `n` columns or rows
-
-These values are to be passed to `ftxui::Screen::Create()`.
-
-@ref ftxui::Screen::Create() provides two overloads:
-
-- `Screen::Create(Dimension)` sets both width and height to the same kind of dimension
-- `Screen::Create(Dimension width, Dimension height)` allows distinct control per axis
-
-```cpp
-auto screen = ftxui::Screen::Create(
-  ftxui::Dimension::Full(),      // width
-  ftxui::Dimension::Fixed(10)    // height
-);
-```
-
-Once created, render an element and display the result:
-
-```cpp
-ftxui::Render(screen, element);
-screen.Print();
-```
-
----
-
-# ftxui::Pixel
-
-Each cell in the screen grid is a @ref ftxui::Pixel, which holds:
-
-- Unicode codepoint.
-    - `character`
-- @ref ftxui::Color:
-    - `foreground_color`
-    - `background_color`
-- Booleans:
-    - `blink`
-    - `bold`
-    - `dim`
-    - `italic`
-    - `inverted` (swap foreground and background colors)
-    - `underlined`
-    - `underlined_double`
-    - `strikethrough`
-
-
-```cpp
-auto screen = ftxui::Screen::Create(
-  ftxui::Dimension::Fixed(5),
-  ftxui::Dimension::Fixed(5),
-);
-
-auto& pixel = screen.PixelAt(3, 3);
-pixel.character = U'X';
-pixel.bold = true;
-pixel.foreground_color = ftxui::Color::Red;
-pixel.background_color = ftxui::Color::RGB(0, 255, 0);
-
-screen.Print();
-```
-
-> [!note]
-> `PixelAt(x, y)` performs bounds checking and returns a reference to the pixel
-> at the specified coordinate. If out-of-bounds, a dummy pixel reference is
-> returned.
-
-
-Each cell in the screen is a @ref ftxui::Pixel. You can modify them using:
-
-```cpp
-auto& pixel = screen.PixelAt(x, y);
-pixel.character = U'X';
-pixel.bold = true;
-pixel.foreground_color = Color::Red;
-```
-
----
-
-# ftxui::Color
-
-The @ref ftxui::Color class is used to define foreground and background colors for each @ref ftxui::Pixel.
-
-It supports various color spaces and predefined palettes. FTXUI will
-dynamically fallback to the closest available color in the terminal if the
-requested color is not supported by the terminal.
-
-**Color Spaces**
-
-- **Default**: `ftxui::Color::Default` (terminal's default color)
-- **16-color palette** [Demo](https://arthursonzogni.github.io/FTXUI/examples/?file=dom/color_gallery):
-    - `ftxui::Color::Black`,
-    - `ftxui::Color::Red`,
-    - ...
-- **256-color palette** [Demo](https://arthursonzogni.github.io/FTXUI/examples/?file=dom/color_palette256):
-    - `ftxui::Color::Chartreuse1`,
-    - `ftxui::Color::DarkViolet`,
-    - ...
-- **True color** (24bit) [Demo](https://arthursonzogni.github.io/FTXUI/examples/?file=dom/color_truecolor_HSV:
-    - `ftxui::Color::RGB(uint8_t red, uint8_t green, uint8_t blue)`
-    - `ftxui::Color::HSV(uint8_t h, uint8_t s, uint8_t v)`.
-    
-
-> [!note]
-> You can query the terminal capability using @ref ftxui::Terminal::ColorSupport();
->
-> This can manually be set using @ref ftxui::Terminal::SetColorSupport().

doc/module.md

@@ -1,74 +0,0 @@
-# ftxui {#ftxui}
-
-![title-img](https://nsm09.casimages.com/img/2025/05/30//2505300816063242518595251.jpg)
-
-FTXUI is organized into three modules, each building upon the previous:
-
-1. [ftxui/screen](#module-screen) - Low-level rendering
-2. [ftxui/dom](#module-dom) - Layout and composition
-3. [ftxui/component](#module-component) - User interaction
-
----
-
-# ftxui/screen
-
-Defines:
-
-- **`ftxui::Screen`**: a 2D grid of styled characters.
-- **`ftxui::Pixel`**: the unit of rendering.
-- Helpers like `ftxui::Color` and `Dimension`.
-
-Use for direct terminal drawing and styling.
-
-<div class="section_buttons">
- 
-|                                  Next |
-|--------------------------------------:|
-| [Documentation](module-screen.html) |
- 
-</div>
-
-
----
-
-# ftxui/dom
-
-Provides:
-
-- **`ftxui::Element`**: a tree structure for layout and UI.
-- Composable and responsive elements.
-- `Render()` to draw onto a `Screen`.
-
-Ideal for structured, styled UIs.
-
-<div class="section_buttons">
-
-|                                  Next |
-|--------------------------------------:|
-| [Documentation](module-dom.html) |
-
-</div>
-
-
----
-# ftxui/component
-
-Adds:
-
-- **`ftxui::Component`**: stateful, interactive widgets.
-- Built-ins: `Checkbox`, `Input`, `Menu`, `Button`.
-- Supports keyboard/cursor input and composition.
-
-Use for interactive apps.
-
-<div class="section_buttons">
-
-|                                  Next |
-|--------------------------------------:|
-| [Documentation](module-component.html) |
-
-</div>
-
----
-
-Modules can be used independently, or together: `screen → dom → component`.

doc/stylesheet.css

@@ -1,119 +0,0 @@
-html {
-  --primary-color: #9ed072;         /* green (identifier, strings) */
-  --primary-dark-color: #f39660;    /* orange (functions, tags) */
-  --primary-light-color: #7fbbb3;   /* teal (types, decorators) */
-
-  --page-background-color: #2c2e34; /* main background */
-  --page-foreground-color: #e2e2e3; /* main text */
-  --page-secondary-foreground-color: #9aa5ce; /* dim text */
-  --separator-color: #3b3e48;
-  --side-nav-background: #1a1b26;
-
-  --code-background: #2a2e38;
-  --code-foreground: #e2e2e3;
-
-  --tablehead-background: #1f1f28;
-
-  --blockquote-background: #3a3e44;
-  --blockquote-foreground: #d4bfff;
-
-  --warning-color: #e0af68;
-  --warning-color-dark: #ff9e64;
-  --warning-color-darker: #f7768e;
-  --bug-color: #f7768e;
-
-  --fragment-background: #222222;
-  --fragment-foreground: #e2e2e3;
-  --fragment-keyword: #f7768e;       /* pink */
-  --fragment-keywordtype: #7fbbb3;   /* teal */
-  --fragment-keywordflow: #e0af68;   /* orange-yellow */
-  --fragment-token: #9ed072;         /* green */
-  --fragment-comment: #5c6370;
-  --fragment-link: #7aa2f7;          /* blue link */
-  --fragment-preprocessor: #f39660;  /* orange */
-  --fragment-linenumber-color: #414868;
-  --fragment-linenumber-background: #2c2e34;
-  --fragment-linenumber-border: #1a1b26;
-  --fragment-lineheight: 1.125em;
-}
-
-/* Base style for all sections */
-.section.note,
-.section.warning,
-.section.remark,
-.section.attention,
-.section.important {
-  border-left: 4px solid var(--primary-dark-color);
-  border-radius: 6px;
-  padding: 0.9em 1.2em;
-  margin: 1.5em 0;
-  background-color: #2e303e;
-  color: var(--page-foreground-color);
-  font-size: 0.95em;
-}
-
-/* Section title */
-.section.note dt,
-.section.warning dt,
-.section.remark dt,
-.section.attention dt,
-.section.important dt {
-  font-weight: bold;
-  display: block;
-  margin-bottom: 0.35em;
-}
-
-/* Section body */
-.section.note dd,
-.section.warning dd,
-.section.remark dd,
-.section.attention dd,
-.section.important dd {
-  margin: 0;
-}
-
-/* Note - soft cyan */
-.section.note {
-  border-left-color: #7fbbb3;
-  background-color: #263640;
-}
-.section.note dt {
-  color: #7fbbb3;
-}
-
-/* Warning - amber */
-.section.warning {
-  border-left-color: #e0af68;
-  background-color: #3d2f1f;
-}
-.section.warning dt {
-  color: #e0af68;
-}
-
-/* Tip (Remark) - green */
-.section.remark {
-  border-left-color: #9ed072;
-  background-color: #2d3a2d;
-}
-.section.remark dt {
-  color: #9ed072;
-}
-
-/* Caution (Attention) - bold red-orange */
-.section.attention {
-  border-left-color: #f7768e;
-  background-color: #3d2a2e;
-}
-.section.attention dt {
-  color: #f7768e;
-}
-
-/* Important - purple */
-.section.important {
-  border-left-color: #ab9df2;
-  background-color: #2f2a3a;
-}
-.section.important dt {
-  color: #ab9df2;
-}
-

examples/CMakeLists.txt

@@ -8,21 +8,26 @@ function(example name)
   target_link_libraries(ftxui_example_${name} PUBLIC ${DIRECTORY_LIB})
   file(RELATIVE_PATH dir ${EXAMPLES_DIR} ${CMAKE_CURRENT_SOURCE_DIR})
   set_property(GLOBAL APPEND PROPERTY FTXUI::EXAMPLES ${dir}/${name})
-  target_compile_features(ftxui_example_${name} PRIVATE cxx_std_20)
+  set_target_properties(ftxui_example_${name} PROPERTIES
+    CXX_STANDARD 20
+  )
 endfunction(example)
 
 add_subdirectory(component)
 add_subdirectory(dom)
 
 if (EMSCRIPTEN)
+  # 32MB should be enough to run all the examples, in debug mode.
+  target_link_options(component PUBLIC "SHELL: -s TOTAL_MEMORY=33554432")
+  target_link_options(component PUBLIC "SHELL: -s ASSERTIONS=1")
+  #string(APPEND CMAKE_EXE_LINKER_FLAGS " -s ALLOW_MEMORY_GROWTH=1")
+  #target_link_options(component PUBLIC "SHELL: -s ALLOW_MEMORY_GROWTH=1")
+
   get_property(EXAMPLES GLOBAL PROPERTY FTXUI::EXAMPLES)
   foreach(file
-      "index.css"
       "index.html"
-      "index.mjs"
-      "run_webassembly.py"
       "sw.js"
-  )
+      "run_webassembly.py")
     configure_file(${file} ${file})
   endforeach(file)
 endif()

examples/component/CMakeLists.txt

@@ -11,15 +11,12 @@ example(collapsible)
 example(composition)
 example(custom_loop)
 example(dropdown)
-example(dropdown_custom)
 example(flexbox_gallery)
 example(focus)
 example(focus_cursor)
 example(gallery)
 example(homescreen)
 example(input)
-example(input_in_frame)
-example(input_style)
 example(linear_gradient_gallery)
 example(maybe)
 example(menu)
@@ -27,7 +24,6 @@ example(menu2)
 example(menu_entries)
 example(menu_entries_animated)
 example(menu_in_frame)
-example(menu_in_frame_horizontal)
 example(menu_multiple)
 example(menu_style)
 example(menu_underline_animated_gallery)
@@ -39,14 +35,10 @@ example(radiobox)
 example(radiobox_in_frame)
 example(renderer)
 example(resizable_split)
-example(scrollbar)
-example(selection)
 example(slider)
 example(slider_direction)
 example(slider_rgb)
 example(tab_horizontal)
 example(tab_vertical)
-example(textarea)
 example(toggle)
-example(window)
 example(with_restored_io)

examples/component/button.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for shared_ptr, __shared_ptr_access
 #include <string>  // for operator+, to_string
 
@@ -12,40 +9,13 @@
 
 using namespace ftxui;
 
-// This is a helper function to create a button with a custom style.
-// The style is defined by a lambda function that takes an EntryState and
-// returns an Element.
-// We are using `center` to center the text inside the button, then `border` to
-// add a border around the button, and finally `flex` to make the button fill
-// the available space.
-ButtonOption Style() {
-  auto option = ButtonOption::Animated();
-  option.transform = [](const EntryState& s) {
-    auto element = text(s.label);
-    if (s.focused) {
-      element |= bold;
-    }
-    return element | center | borderEmpty | flex;
-  };
-  return option;
-}
-
-int main() {
+int main(int argc, const char* argv[]) {
   int value = 50;
 
-  // clang-format off
-  auto btn_dec_01 = Button("-1", [&] { value -= 1; }, Style());
-  auto btn_inc_01 = Button("+1", [&] { value += 1; }, Style());
-  auto btn_dec_10 = Button("-10", [&] { value -= 10; }, Style());
-  auto btn_inc_10 = Button("+10", [&] { value += 10; }, Style());
-  // clang-format on
-
   // The tree of components. This defines how to navigate using the keyboard.
-  // The selected `row` is shared to get a grid layout.
-  int row = 0;
-  auto buttons = Container::Vertical({
-      Container::Horizontal({btn_dec_01, btn_inc_01}, &row) | flex,
-      Container::Horizontal({btn_dec_10, btn_inc_10}, &row) | flex,
+  auto buttons = Container::Horizontal({
+      Button("Decrease", [&] { value--; }),
+      Button("Increase", [&] { value++; }),
   });
 
   // Modify the way to render them on screen:
@@ -53,12 +23,18 @@ int main() {
     return vbox({
                text("value = " + std::to_string(value)),
                separator(),
-               buttons->Render() | flex,
+               gauge(value * 0.01f),
+               separator(),
+               buttons->Render(),
            }) |
-           flex | border;
+           border;
   });
 
   auto screen = ScreenInteractive::FitComponent();
   screen.Loop(component);
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/button_animated.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for shared_ptr, __shared_ptr_access
 #include <string>  // for operator+, to_string
 
@@ -14,7 +11,7 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   int value = 50;
 
   // The tree of components. This defines how to navigate using the keyboard.
@@ -43,3 +40,7 @@ int main() {
   screen.Loop(component);
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/button_in_frame.cpp

@@ -1,6 +1,3 @@
-// Copyright 2022 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for allocator, __shared_ptr_access, shared_ptr
 #include <string>  // for to_string, operator+
 
@@ -14,16 +11,17 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   int counter = 0;
   auto on_click = [&] { counter++; };
 
-  auto style = ButtonOption::Animated(Color::Default, Color::GrayDark,
+  auto button_style = ButtonOption::Animated(Color::Default, Color::GrayDark,
                                              Color::Default, Color::White);
 
   auto container = Container::Vertical({});
   for (int i = 0; i < 30; ++i) {
-    auto button = Button("Button " + std::to_string(i), on_click, style);
+    auto button =
+        Button("Button " + std::to_string(i), on_click, &button_style);
     container->Add(button);
   }
 
@@ -45,3 +43,7 @@ int main() {
 
   return 0;
 }
+
+// Copyright 2022 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/button_style.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <string>  // for operator+, to_string
 
 #include "ftxui/component/captured_mouse.hpp"  // for ftxui
@@ -13,7 +10,7 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   int value = 0;
   auto action = [&] { value++; };
   auto action_renderer =
@@ -58,3 +55,7 @@ int main() {
   screen.Loop(buttons);
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/canvas_animated.cpp

@@ -1,6 +1,3 @@
-// Copyright 2021 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSED file.
 #include <cmath>                   // for sin, cos
 #include <ftxui/dom/elements.hpp>  // for canvas, Element, separator, hbox, operator|, border
 #include <ftxui/screen/screen.hpp>  // for Pixel
@@ -17,7 +14,7 @@
 #include "ftxui/dom/canvas.hpp"                    // for Canvas
 #include "ftxui/screen/color.hpp"  // for Color, Color::Red, Color::Blue, Color::Green, ftxui
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
 
   int mouse_x = 0;
@@ -133,9 +130,8 @@ int main() {
       float dy = 50.f;
       ys[x] = int(dy + 20 * cos(dx * 0.14) + 10 * sin(dx * 0.42));
     }
-    for (int x = 1; x < 99; x++) {
+    for (int x = 1; x < 99; x++)
       c.DrawPointLine(x, ys[x], x + 1, ys[x + 1]);
-    }
 
     return canvas(std::move(c));
   });
@@ -261,3 +257,7 @@ int main() {
 
   return 0;
 }
+
+// Copyright 2021 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSED file.

examples/component/checkbox.cpp

@@ -1,38 +1,31 @@
+#include <memory>  // for allocator, __shared_ptr_access
+#include <string>  // for string, basic_string, operator+, to_string
+#include <vector>  // for vector
+
+#include "ftxui/component/captured_mouse.hpp"  // for ftxui
+#include "ftxui/component/component.hpp"       // for Input, Renderer, Vertical
+#include "ftxui/component/component_base.hpp"  // for ComponentBase
+#include "ftxui/component/screen_interactive.hpp"  // for Component, ScreenInteractive
+#include "ftxui/dom/elements.hpp"  // for operator|, Element, size, border, frame, vscroll_indicator, HEIGHT, LESS_THAN
+
+int main(int argc, const char* argv[]) {
+  using namespace ftxui;
+
+  Component input_list = Container::Vertical({});
+  std::vector<std::string> items(100, "");
+  for (int i = 0; i < items.size(); ++i) {
+    input_list->Add(Input(&(items[i]), "placeholder " + std::to_string(i)));
+  }
+
+  auto renderer = Renderer(input_list, [&] {
+    return input_list->Render() | vscroll_indicator | frame | border |
+           size(HEIGHT, LESS_THAN, 10);
+  });
+
+  auto screen = ScreenInteractive::TerminalOutput();
+  screen.Loop(renderer);
+}
+
 // Copyright 2021 Arthur Sonzogni. All rights reserved.
 // Use of this source code is governed by the MIT license that can be found in
 // the LICENSE file.
-#include <array>  // for array
-#include <iostream>
-#include <memory>  // for shared_ptr, __shared_ptr_access
-#include <string>  // for operator+, to_string
-
-#include "ftxui/component/captured_mouse.hpp"  // for ftxui
-#include "ftxui/component/component.hpp"  // for Checkbox, Renderer, Vertical
-#include "ftxui/component/component_base.hpp"      // for ComponentBase
-#include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
-#include "ftxui/dom/elements.hpp"  // for operator|, Element, size, border, frame, vscroll_indicator, HEIGHT, LESS_THAN
-
-using namespace ftxui;
-
-int main() {
-  bool download = false;
-  bool upload = false;
-  bool ping = false;
-
-  auto container = Container::Vertical({
-      Checkbox("Download", &download),
-      Checkbox("Upload", &upload),
-      Checkbox("Ping", &ping),
-  });
-
-  auto screen = ScreenInteractive::FitComponent();
-  screen.Loop(container);
-
-  std::cout << "---" << std::endl;
-  std::cout << "Download: " << download << std::endl;
-  std::cout << "Upload: " << upload << std::endl;
-  std::cout << "Ping: " << ping << std::endl;
-  std::cout << "---" << std::endl;
-
-  return 0;
-}

examples/component/checkbox_in_frame.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <array>   // for array
 #include <memory>  // for shared_ptr, __shared_ptr_access
 #include <string>  // for operator+, to_string
@@ -13,7 +10,7 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   std::array<bool, 30> states;
 
   auto container = Container::Vertical({});
@@ -32,3 +29,7 @@ int main() {
 
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/collapsible.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>   // for allocator, make_shared, __shared_ptr_access
 #include <utility>  // for move
 #include <vector>   // for vector
@@ -29,7 +26,7 @@ Component Empty() {
   return std::make_shared<ComponentBase>();
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto component =
       Collapsible("Collapsible 1",
                   Inner({
@@ -55,3 +52,7 @@ int main() {
 
   ScreenInteractive::FitComponent().Loop(component);
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/composition.cpp

@@ -1,6 +1,3 @@
-// Copyright 2021 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for allocator, shared_ptr, __shared_ptr_access
 #include <string>  // for operator+, to_string
 
@@ -14,7 +11,7 @@ using namespace ftxui;
 
 // An example of how to compose multiple components into one and maintain their
 // interactiveness.
-int main() {
+int main(int argc, const char* argv[]) {
   auto left_count = 0;
   auto right_count = 0;
 
@@ -61,3 +58,7 @@ int main() {
 }
 
 // Thanks to Chris Morgan for this example!
+
+// Copyright 2021 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/custom_loop.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <stdlib.h>                   // for EXIT_SUCCESS
 #include <chrono>                     // for milliseconds
 #include <ftxui/component/event.hpp>  // for Event
@@ -14,7 +11,7 @@
 #include "ftxui/component/loop.hpp"       // for Loop
 #include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
   auto screen = ScreenInteractive::FitComponent();
 
@@ -52,3 +49,7 @@ int main() {
 
   return EXIT_SUCCESS;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/dropdown.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <string>  // for basic_string, string, allocator
 #include <vector>  // for vector
 
@@ -8,7 +5,7 @@
 #include "ftxui/component/component.hpp"  // for Dropdown, Horizontal, Vertical
 #include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
 
   std::vector<std::string> entries = {
@@ -42,3 +39,7 @@ int main() {
   auto screen = ScreenInteractive::FitComponent();
   screen.Loop(layout);
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/dropdown_custom.cpp

@@ -1,104 +0,0 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
-#include <string>  // for basic_string, string, allocator
-#include <vector>  // for vector
-
-#include "ftxui/component/captured_mouse.hpp"  // for ftxui
-#include "ftxui/component/component.hpp"  // for Dropdown, Horizontal, Vertical
-#include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
-
-int main() {
-  using namespace ftxui;
-
-  std::vector<std::string> entries = {
-      "tribute",     "clearance", "ally",        "bend",        "electronics",
-      "module",      "era",       "cultural",    "sniff",       "nationalism",
-      "negotiation", "deliver",   "figure",      "east",        "tribute",
-      "clearance",   "ally",      "bend",        "electronics", "module",
-      "era",         "cultural",  "sniff",       "nationalism", "negotiation",
-      "deliver",     "figure",    "east",        "tribute",     "clearance",
-      "ally",        "bend",      "electronics", "module",      "era",
-      "cultural",    "sniff",     "nationalism", "negotiation", "deliver",
-      "figure",      "east",
-  };
-
-  auto dropdown_1 = Dropdown({
-      .radiobox = {.entries = &entries},
-      .transform =
-          [](bool open, Element checkbox, Element radiobox) {
-            if (open) {
-              return vbox({
-                  checkbox | inverted,
-                  radiobox | vscroll_indicator | frame |
-                      size(HEIGHT, LESS_THAN, 10),
-                  filler(),
-              });
-            }
-            return vbox({
-                checkbox,
-                filler(),
-            });
-          },
-  });
-
-  auto dropdown_2 = Dropdown({
-      .radiobox = {.entries = &entries},
-      .transform =
-          [](bool open, Element checkbox, Element radiobox) {
-            if (open) {
-              return vbox({
-                  checkbox | inverted,
-                  radiobox | vscroll_indicator | frame |
-                      size(HEIGHT, LESS_THAN, 10) | bgcolor(Color::Blue),
-                  filler(),
-              });
-            }
-            return vbox({
-                checkbox | bgcolor(Color::Blue),
-                filler(),
-            });
-          },
-  });
-
-  auto dropdown_3 = Dropdown({
-      .radiobox =
-          {
-              .entries = &entries,
-              .transform =
-                  [](const EntryState& s) {
-                    auto t = text(s.label) | borderEmpty;
-                    if (s.active) {
-                      t |= bold;
-                    }
-                    if (s.focused) {
-                      t |= inverted;
-                    }
-                    return t;
-                  },
-          },
-      .transform =
-          [](bool open, Element checkbox, Element radiobox) {
-            checkbox |= borderEmpty;
-            if (open) {
-              return vbox({
-                  checkbox | inverted,
-                  radiobox | vscroll_indicator | frame |
-                      size(HEIGHT, LESS_THAN, 20) | bgcolor(Color::Red),
-                  filler(),
-              });
-            }
-            return vbox({
-                checkbox | bgcolor(Color::Red),
-                filler(),
-            });
-          },
-  });
-
-  auto screen = ScreenInteractive::FitComponent();
-  screen.Loop(Container::Horizontal({
-      dropdown_1,
-      dropdown_2,
-      dropdown_3,
-  }));
-}

examples/component/flexbox_gallery.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <stddef.h>  // for size_t
 #include <memory>    // for shared_ptr, __shared_ptr_access, allocator
 #include <string>  // for string, basic_string, to_string, operator+, char_traits
@@ -16,7 +13,7 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::Fullscreen();
 
   int direction_index = 0;
@@ -82,12 +79,10 @@ int main() {
                    size(WIDTH, EQUAL, dimx) | size(HEIGHT, EQUAL, dimy) |
                    bgcolor(Color::HSV(index * 25, 255, 255)) |
                    color(Color::Black);
-    if (element_xflex_grow) {
+    if (element_xflex_grow)
       element = element | xflex_grow;
-    }
-    if (element_yflex_grow) {
+    if (element_yflex_grow)
       element = element | yflex_grow;
-    }
     return element;
   };
 
@@ -121,12 +116,10 @@ int main() {
 
     group = group | notflex;
 
-    if (!group_xflex_grow) {
+    if (!group_xflex_grow)
       group = hbox(group, filler());
-    }
-    if (!group_yflex_grow) {
+    if (!group_yflex_grow)
       group = vbox(group, filler());
-    }
 
     group = group | flex;
     return group;
@@ -193,3 +186,7 @@ int main() {
 
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/focus.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for allocator, shared_ptr, __shared_ptr_access
 #include <string>  // for operator+, char_traits, to_string, string
 #include <vector>  // for vector
@@ -34,7 +31,7 @@ Element make_grid() {
   return gridbox(rows);
 };
 
-int main() {
+int main(int argc, const char* argv[]) {
   float focus_x = 0.5f;
   float focus_y = 0.5f;
 
@@ -67,3 +64,7 @@ int main() {
 
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/focus_cursor.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <ftxui/component/captured_mouse.hpp>  // for ftxui
 #include <string>  // for allocator, operator+, char_traits, string
 
@@ -22,7 +19,7 @@ Component Instance(std::string label, Decorator focusCursor) {
   });
 };
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::Fullscreen();
   screen.Loop(Container::Vertical({
       Instance("focus", focus),
@@ -35,3 +32,7 @@ int main() {
   }));
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/gallery.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <functional>  // for function
 #include <memory>      // for shared_ptr, allocator, __shared_ptr_access
 #include <string>      // for string, basic_string
@@ -26,7 +23,7 @@ Component Wrap(std::string name, Component component) {
   });
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::FitComponent();
 
   // -- Menu
@@ -97,25 +94,7 @@ int main() {
   });
   sliders = Wrap("Slider", sliders);
 
-  // A large text:
-  auto lorel_ipsum = Renderer([] {
-    return vbox({
-        text("Lorem ipsum dolor sit amet, consectetur adipiscing elit. "),
-        text("Sed do eiusmod tempor incididunt ut labore et dolore magna "
-             "aliqua. "),
-        text("Ut enim ad minim veniam, quis nostrud exercitation ullamco "
-             "laboris nisi ut aliquip ex ea commodo consequat. "),
-        text("Duis aute irure dolor in reprehenderit in voluptate velit esse "
-             "cillum dolore eu fugiat nulla pariatur. "),
-        text("Excepteur sint occaecat cupidatat non proident, sunt in culpa "
-             "qui officia deserunt mollit anim id est laborum. "),
-
-    });
-  });
-  lorel_ipsum = Wrap("Lorel Ipsum", lorel_ipsum);
-
-  // -- Layout
-  // -----------------------------------------------------------------
+  // -- Layout -----------------------------------------------------------------
   auto layout = Container::Vertical({
       menu,
       toggle,
@@ -124,7 +103,6 @@ int main() {
       input,
       sliders,
       button,
-      lorel_ipsum,
   });
 
   auto component = Renderer(layout, [&] {
@@ -142,8 +120,6 @@ int main() {
                sliders->Render(),
                separator(),
                button->Render(),
-               separator(),
-               lorel_ipsum->Render(),
            }) |
            xflex | size(WIDTH, GREATER_THAN, 40) | border;
   });
@@ -152,3 +128,7 @@ int main() {
 
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/homescreen.cpp

@@ -1,12 +1,8 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <stddef.h>    // for size_t
 #include <array>       // for array
 #include <atomic>      // for atomic
 #include <chrono>      // for operator""s, chrono_literals
 #include <cmath>       // for sin
-#include <ftxui/component/loop.hpp>
 #include <functional>  // for ref, reference_wrapper, function
 #include <memory>      // for allocator, shared_ptr, __shared_ptr_access
 #include <string>  // for string, basic_string, char_traits, operator+, to_string
@@ -28,7 +24,7 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::Fullscreen();
 
   // ---------------------------------------------------------------------------
@@ -265,12 +261,12 @@ int main() {
   });
 
   // ---------------------------------------------------------------------------
-  // Spinner
+  // Spiner
   // ---------------------------------------------------------------------------
   auto spinner_tab_renderer = Renderer([&] {
     Elements entries;
     for (int i = 0; i < 22; ++i) {
-      entries.push_back(spinner(i, shift / 5) | bold |
+      entries.push_back(spinner(i, shift / 2) | bold |
                         size(WIDTH, GREATER_THAN, 2) | border);
     }
     return hflow(std::move(entries));
@@ -425,7 +421,7 @@ int main() {
   auto paragraph_renderer_left = Renderer([&] {
     std::string str =
         "Lorem Ipsum is simply dummy text of the printing and typesetting "
-        "industry.\nLorem Ipsum has been the industry's standard dummy text "
+        "industry. Lorem Ipsum has been the industry's standard dummy text "
         "ever since the 1500s, when an unknown printer took a galley of type "
         "and scrambled it to make a type specimen book.";
     return vbox({
@@ -491,42 +487,41 @@ int main() {
       },
       &tab_index);
 
-  auto exit_button =
-      Button("Exit", [&] { screen.Exit(); }, ButtonOption::Animated());
-
   auto main_container = Container::Vertical({
-      Container::Horizontal({
       tab_selection,
-          exit_button,
-      }),
       tab_content,
   });
 
   auto main_renderer = Renderer(main_container, [&] {
     return vbox({
         text("FTXUI Demo") | bold | hcenter,
-        hbox({
-            tab_selection->Render() | flex,
-            exit_button->Render(),
-        }),
+        tab_selection->Render(),
         tab_content->Render() | flex,
     });
   });
 
-  Loop loop(&screen, main_renderer);
-  while (!loop.HasQuitted()) {
-    // Update the state of the application.
-    shift++;
-
-    // Request a new frame to be drawn.
-    screen.RequestAnimationFrame();
-
-    // Execute events, and draw the next frame.
-    loop.RunOnce();
-
-    // Sleep for a short duration to control the frame rate (60 FPS).
-    std::this_thread::sleep_for(std::chrono::milliseconds(1000 / 60));
+  std::atomic<bool> refresh_ui_continue = true;
+  std::thread refresh_ui([&] {
+    while (refresh_ui_continue) {
+      using namespace std::chrono_literals;
+      std::this_thread::sleep_for(0.05s);
+      // The |shift| variable belong to the main thread. `screen.Post(task)`
+      // will execute the update on the thread where |screen| lives (e.g. the
+      // main thread). Using `screen.Post(task)` is threadsafe.
+      screen.Post([&] { shift++; });
+      // After updating the state, request a new frame to be drawn. This is done
+      // by simulating a new "custom" event to be handled.
+      screen.Post(Event::Custom);
     }
+  });
+
+  screen.Loop(main_renderer);
+  refresh_ui_continue = false;
+  refresh_ui.join();
 
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/input.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for allocator, __shared_ptr_access
 #include <string>  // for char_traits, operator+, string, basic_string
 
@@ -12,53 +9,33 @@
 #include "ftxui/dom/elements.hpp"  // for text, hbox, separator, Element, operator|, vbox, border
 #include "ftxui/util/ref.hpp"  // for Ref
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
 
-  // The data:
   std::string first_name;
   std::string last_name;
   std::string password;
-  std::string phoneNumber;
 
-  // The basic input components:
   Component input_first_name = Input(&first_name, "first name");
   Component input_last_name = Input(&last_name, "last name");
 
-  // The password input component:
   InputOption password_option;
   password_option.password = true;
   Component input_password = Input(&password, "password", password_option);
 
-  // The phone number input component:
-  // We are using `CatchEvent` to filter out non-digit characters.
-  Component input_phone_number = Input(&phoneNumber, "phone number");
-  input_phone_number |= CatchEvent([&](Event event) {
-    return event.is_character() && !std::isdigit(event.character()[0]);
-  });
-  input_phone_number |= CatchEvent([&](Event event) {
-    return event.is_character() && phoneNumber.size() > 10;
-  });
-
-  // The component tree:
   auto component = Container::Vertical({
       input_first_name,
       input_last_name,
       input_password,
-      input_phone_number,
   });
 
-  // Tweak how the component tree is rendered:
   auto renderer = Renderer(component, [&] {
     return vbox({
+               text("Hello " + first_name + " " + last_name),
+               separator(),
                hbox(text(" First name : "), input_first_name->Render()),
                hbox(text(" Last name  : "), input_last_name->Render()),
                hbox(text(" Password   : "), input_password->Render()),
-               hbox(text(" Phone num  : "), input_phone_number->Render()),
-               separator(),
-               text("Hello " + first_name + " " + last_name),
-               text("Your password is " + password),
-               text("Your phone number is " + phoneNumber),
            }) |
            border;
   });
@@ -66,3 +43,7 @@ int main() {
   auto screen = ScreenInteractive::TerminalOutput();
   screen.Loop(renderer);
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/input_in_frame.cpp

@@ -1,30 +0,0 @@
-// Copyright 2021 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
-#include <memory>  // for allocator, __shared_ptr_access
-#include <string>  // for string, basic_string, operator+, to_string
-#include <vector>  // for vector
-
-#include "ftxui/component/captured_mouse.hpp"  // for ftxui
-#include "ftxui/component/component.hpp"       // for Input, Renderer, Vertical
-#include "ftxui/component/component_base.hpp"  // for ComponentBase
-#include "ftxui/component/screen_interactive.hpp"  // for Component, ScreenInteractive
-#include "ftxui/dom/elements.hpp"  // for operator|, Element, size, border, frame, vscroll_indicator, HEIGHT, LESS_THAN
-
-int main() {
-  using namespace ftxui;
-
-  Component input_list = Container::Vertical({});
-  std::vector<std::string> items(100, "");
-  for (size_t i = 0; i < items.size(); ++i) {
-    input_list->Add(Input(&(items[i]), "placeholder " + std::to_string(i)));
-  }
-
-  auto renderer = Renderer(input_list, [&] {
-    return input_list->Render() | vscroll_indicator | frame | border |
-           size(HEIGHT, LESS_THAN, 10);
-  });
-
-  auto screen = ScreenInteractive::TerminalOutput();
-  screen.Loop(renderer);
-}

examples/component/input_style.cpp

@@ -1,97 +0,0 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
-#include <ftxui/dom/linear_gradient.hpp>  // for LinearGradient
-#include <ftxui/screen/color.hpp>  // for Color, Color::White, Color::Red, Color::Blue, Color::Black, Color::GrayDark, ftxui
-#include <functional>              // for function
-#include <string>                  // for allocator, string
-#include <utility>                 // for move
-
-#include "ftxui/component/component.hpp"  // for Input, Horizontal, Vertical, operator|
-#include "ftxui/component/component_base.hpp"     // for Component
-#include "ftxui/component/component_options.hpp"  // for InputState, InputOption
-#include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
-#include "ftxui/dom/elements.hpp"  // for operator|=, Element, bgcolor, operator|, separatorEmpty, color, borderEmpty, separator, text, center, dim, hbox, vbox, border, borderDouble, borderRounded
-
-int main() {
-  using namespace ftxui;
-
-  InputOption style_1 = InputOption::Default();
-
-  InputOption style_2 = InputOption::Spacious();
-
-  InputOption style_3 = InputOption::Spacious();
-  style_3.transform = [](InputState state) {
-    state.element |= borderEmpty;
-
-    if (state.is_placeholder) {
-      state.element |= dim;
-    }
-
-    if (state.focused) {
-      state.element |= borderDouble;
-      state.element |= bgcolor(Color::White);
-      state.element |= color(Color::Black);
-    } else if (state.hovered) {
-      state.element |= borderRounded;
-      state.element |= bgcolor(LinearGradient(90, Color::Blue, Color::Red));
-      state.element |= color(Color::White);
-    } else {
-      state.element |= border;
-      state.element |= bgcolor(LinearGradient(0, Color::Blue, Color::Red));
-      state.element |= color(Color::White);
-    }
-
-    return state.element;
-  };
-
-  InputOption style_4 = InputOption::Spacious();
-  style_4.transform = [](InputState state) {
-    state.element = hbox({
-        text("Theorem") | center | borderEmpty | bgcolor(Color::Red),
-        separatorEmpty(),
-        separator() | color(Color::White),
-        separatorEmpty(),
-        std::move(state.element),
-    });
-
-    state.element |= borderEmpty;
-    if (state.is_placeholder) {
-      state.element |= dim;
-    }
-
-    if (state.focused) {
-      state.element |= bgcolor(Color::Black);
-    } else {
-      state.element |= bgcolor(Color::Blue);
-    }
-
-    if (state.hovered) {
-      state.element |= bgcolor(Color::GrayDark);
-    }
-
-    return vbox({state.element, separatorEmpty()});
-  };
-
-  auto generateUiFromStyle = [&](InputOption style) {
-    auto first_name = new std::string();   // Leaked
-    auto middle_name = new std::string();  // Leaked
-    auto last_name = new std::string();    // Leaked
-    return Container::Vertical({
-               Input(first_name, "first name", style),
-               Input(middle_name, "middle name", style),
-               Input(last_name, "last name", style),
-           }) |
-           borderEmpty;
-  };
-
-  auto ui = Container::Horizontal({
-      generateUiFromStyle(style_1),
-      generateUiFromStyle(style_2),
-      generateUiFromStyle(style_3),
-      generateUiFromStyle(style_4),
-  });
-
-  auto screen = ScreenInteractive::TerminalOutput();
-  screen.Loop(ui);
-}

examples/component/linear_gradient_gallery.cpp

@@ -1,6 +1,3 @@
-// Copyright 2023 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <ftxui/component/component_base.hpp>  // for ComponentBase, Component
 #include <ftxui/dom/elements.hpp>  // for operator|, Element, flex, bgcolor, text, vbox, center
 #include <ftxui/dom/linear_gradient.hpp>  // for LinearGradient
@@ -12,7 +9,7 @@
 #include "ftxui/component/component.hpp"       // for Slider, Renderer, Vertical
 #include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
   auto screen = ScreenInteractive::Fullscreen();
 
@@ -25,8 +22,8 @@ int main() {
   std::string slider_end_text;
 
   auto slider_angle = Slider(&slider_angle_text, &angle, 0, 360);
-  auto slider_start = Slider(&slider_start_text, &start, 0.f, 1.f, 0.05f);
-  auto slider_end = Slider(&slider_end_text, &end, 0.f, 1.f, 0.05f);
+  auto slider_start = Slider(&slider_start_text, &start, 0.f, 1.f);
+  auto slider_end = Slider(&slider_end_text, &end, 0.f, 1.f);
 
   auto layout = Container::Vertical({
       slider_angle,
@@ -53,3 +50,7 @@ int main() {
 
   screen.Loop(renderer);
 }
+
+// Copyright 2023 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/maybe.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <string>  // for string, allocator, basic_string
 #include <vector>  // for vector
 
@@ -13,7 +10,7 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   std::vector<std::string> entries = {
       "entry 1",
       "entry 2",
@@ -39,3 +36,7 @@ int main() {
   auto screen = ScreenInteractive::TerminalOutput();
   screen.Loop(layout);
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <functional>  // for function
 #include <iostream>  // for basic_ostream::operator<<, operator<<, endl, basic_ostream, basic_ostream<>::__ostream_type, cout, ostream
 #include <string>    // for string, basic_string, allocator
@@ -11,7 +8,7 @@
 #include "ftxui/component/component_options.hpp"   // for MenuOption
 #include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
   auto screen = ScreenInteractive::TerminalOutput();
 
@@ -24,9 +21,13 @@ int main() {
 
   MenuOption option;
   option.on_enter = screen.ExitLoopClosure();
-  auto menu = Menu(&entries, &selected, option);
+  auto menu = Menu(&entries, &selected, &option);
 
   screen.Loop(menu);
 
   std::cout << "Selected element = " << selected << std::endl;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu2.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <functional>  // for function
 #include <memory>      // for allocator, __shared_ptr_access
 #include <string>      // for string, basic_string, operator+, to_string
@@ -13,7 +10,7 @@
 #include "ftxui/component/screen_interactive.hpp"  // for Component, ScreenInteractive
 #include "ftxui/dom/elements.hpp"  // for text, separator, bold, hcenter, vbox, hbox, gauge, Element, operator|, border
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
   auto screen = ScreenInteractive::TerminalOutput();
 
@@ -30,9 +27,9 @@ int main() {
   int left_menu_selected = 0;
   int right_menu_selected = 0;
   Component left_menu_ =
-      Menu(&left_menu_entries, &left_menu_selected, menu_option);
+      Menu(&left_menu_entries, &left_menu_selected, &menu_option);
   Component right_menu_ =
-      Menu(&right_menu_entries, &right_menu_selected, menu_option);
+      Menu(&right_menu_entries, &right_menu_selected, &menu_option);
 
   Component container = Container::Horizontal({
       left_menu_,
@@ -77,3 +74,7 @@ int main() {
 
   screen.Loop(renderer);
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu_entries.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <functional>  // for function
 #include <iostream>  // for basic_ostream::operator<<, operator<<, endl, basic_ostream, basic_ostream<>::__ostream_type, cout, ostream
 #include <memory>    // for allocator, shared_ptr, __shared_ptr_access
@@ -22,18 +19,16 @@ MenuEntryOption Colored(ftxui::Color c) {
   option.transform = [c](EntryState state) {
     state.label = (state.active ? "> " : "  ") + state.label;
     Element e = text(state.label) | color(c);
-    if (state.focused) {
+    if (state.focused)
       e = e | inverted;
-    }
-    if (state.active) {
+    if (state.active)
       e = e | bold;
-    }
     return e;
   };
   return option;
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::TerminalOutput();
 
   int selected = 0;
@@ -81,3 +76,7 @@ int main() {
 
   std::cout << "Selected element = " << selected << std::endl;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu_entries_animated.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <iostream>  // for basic_ostream::operator<<, operator<<, endl, basic_ostream, basic_ostream<>::__ostream_type, cout, ostream
 #include <memory>    // for shared_ptr, __shared_ptr_access
 #include <string>    // for to_string, allocator
@@ -27,7 +24,7 @@ MenuEntryOption Colored(ftxui::Color c) {
   return option;
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::TerminalOutput();
 
   int selected = 0;
@@ -63,3 +60,7 @@ int main() {
 
   std::cout << "Selected element = " << selected << std::endl;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu_in_frame.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for shared_ptr, __shared_ptr_access
 #include <string>  // for string, basic_string, operator+, to_string
 #include <vector>  // for vector
@@ -13,13 +10,12 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   std::vector<std::string> entries;
   int selected = 0;
 
-  for (int i = 0; i < 30; ++i) {
+  for (int i = 0; i < 30; ++i)
     entries.push_back("Entry " + std::to_string(i));
-  }
   auto radiobox = Menu(&entries, &selected);
   auto renderer = Renderer(radiobox, [&] {
     return radiobox->Render() | vscroll_indicator | frame |
@@ -31,3 +27,7 @@ int main() {
 
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu_in_frame_horizontal.cpp

@@ -1,31 +0,0 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
-#include <memory>  // for shared_ptr, __shared_ptr_access
-#include <string>  // for string, basic_string, operator+, to_string
-#include <vector>  // for vector
-
-#include "ftxui/component/captured_mouse.hpp"      // for ftxui
-#include "ftxui/component/component.hpp"           // for Radiobox, Renderer
-#include "ftxui/component/component_base.hpp"      // for ComponentBase
-#include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
-#include "ftxui/dom/elements.hpp"  // for operator|, Element, size, border, frame, HEIGHT, LESS_THAN
-
-using namespace ftxui;
-
-int main() {
-  std::vector<std::string> entries;
-  int selected = 0;
-
-  for (int i = 0; i < 100; ++i) {
-    entries.push_back(std::to_string(i));
-  }
-  auto radiobox = Menu(&entries, &selected, MenuOption::Horizontal());
-  auto renderer = Renderer(
-      radiobox, [&] { return radiobox->Render() | hscroll_indicator | frame; });
-
-  auto screen = ScreenInteractive::FitComponent();
-  screen.Loop(renderer);
-
-  return 0;
-}

examples/component/menu_multiple.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <stdlib.h>  // for EXIT_SUCCESS
 #include <memory>    // for allocator, __shared_ptr_access
 #include <string>  // for string, operator+, basic_string, to_string, char_traits
@@ -20,7 +17,7 @@ Component Window(std::string title, Component component) {
   });
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   int menu_selected[] = {0, 0, 0};
   std::vector<std::vector<std::string>> menu_entries = {
       {
@@ -75,3 +72,7 @@ int main() {
   screen.Loop(global);
   return EXIT_SUCCESS;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu_style.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <array>       // for array
 #include <chrono>      // for milliseconds
 #include <functional>  // for function
@@ -33,7 +30,7 @@ Component HMenu3(std::vector<std::string>* entries, int* selected);
 Component HMenu4(std::vector<std::string>* entries, int* selected);
 Component HMenu5(std::vector<std::string>* entries, int* selected);
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::TerminalOutput();
 
   std::vector<std::string> entries{
@@ -113,15 +110,13 @@ int main() {
 
 Component VMenu1(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::Vertical();
-  option.entries_option.transform = [](EntryState state) {
+  option.entries.transform = [](EntryState state) {
     state.label = (state.active ? "> " : "  ") + state.label;
     Element e = text(state.label);
-    if (state.focused) {
+    if (state.focused)
       e = e | bgcolor(Color::Blue);
-    }
-    if (state.active) {
+    if (state.active)
       e = e | bold;
-    }
     return e;
   };
   return Menu(entries, selected, option);
@@ -129,15 +124,13 @@ Component VMenu1(std::vector<std::string>* entries, int* selected) {
 
 Component VMenu2(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::Vertical();
-  option.entries_option.transform = [](EntryState state) {
+  option.entries.transform = [](EntryState state) {
     state.label += (state.active ? " <" : "  ");
     Element e = hbox(filler(), text(state.label));
-    if (state.focused) {
+    if (state.focused)
       e = e | bgcolor(Color::Red);
-    }
-    if (state.active) {
+    if (state.active)
       e = e | bold;
-    }
     return e;
   };
   return Menu(entries, selected, option);
@@ -145,19 +138,16 @@ Component VMenu2(std::vector<std::string>* entries, int* selected) {
 
 Component VMenu3(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::Vertical();
-  option.entries_option.transform = [](EntryState state) {
+  option.entries.transform = [](EntryState state) {
     Element e = state.active ? text("[" + state.label + "]")
                              : text(" " + state.label + " ");
-    if (state.focused) {
+    if (state.focused)
       e = e | bold;
-    }
 
-    if (state.focused) {
+    if (state.focused)
       e = e | color(Color::Blue);
-    }
-    if (state.active) {
+    if (state.active)
       e = e | bold;
-    }
     return e;
   };
   return Menu(entries, selected, option);
@@ -165,7 +155,7 @@ Component VMenu3(std::vector<std::string>* entries, int* selected) {
 
 Component VMenu4(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::Vertical();
-  option.entries_option.transform = [](EntryState state) {
+  option.entries.transform = [](EntryState state) {
     if (state.active && state.focused) {
       return text(state.label) | color(Color::Yellow) | bgcolor(Color::Black) |
              bold;
@@ -185,7 +175,7 @@ Component VMenu4(std::vector<std::string>* entries, int* selected) {
 
 Component VMenu5(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::Vertical();
-  option.entries_option.transform = [](EntryState state) {
+  option.entries.transform = [](EntryState state) {
     auto element = text(state.label);
     if (state.active && state.focused) {
       return element | borderDouble;
@@ -211,19 +201,19 @@ Component VMenu6(std::vector<std::string>* entries, int* selected) {
 
 Component VMenu7(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::Vertical();
-  option.entries_option.animated_colors.foreground.enabled = true;
-  option.entries_option.animated_colors.background.enabled = true;
-  option.entries_option.animated_colors.background.active = Color::Red;
-  option.entries_option.animated_colors.background.inactive = Color::Black;
-  option.entries_option.animated_colors.foreground.active = Color::White;
-  option.entries_option.animated_colors.foreground.inactive = Color::Red;
+  option.entries.animated_colors.foreground.enabled = true;
+  option.entries.animated_colors.background.enabled = true;
+  option.entries.animated_colors.background.active = Color::Red;
+  option.entries.animated_colors.background.inactive = Color::Black;
+  option.entries.animated_colors.foreground.active = Color::White;
+  option.entries.animated_colors.foreground.inactive = Color::Red;
   return Menu(entries, selected, option);
 }
 
 Component VMenu8(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::Vertical();
-  option.entries_option.animated_colors.foreground.Set(
-      Color::Red, Color::White, std::chrono::milliseconds(500));
+  option.entries.animated_colors.foreground.Set(Color::Red, Color::White,
+                                                std::chrono::milliseconds(500));
   return Menu(entries, selected, option);
 }
 
@@ -250,17 +240,19 @@ Component HMenu5(std::vector<std::string>* entries, int* selected) {
   auto option = MenuOption::HorizontalAnimated();
   option.underline.SetAnimation(std::chrono::milliseconds(1500),
                                 animation::easing::ElasticOut);
-  option.entries_option.transform = [](EntryState state) {
+  option.entries.transform = [](EntryState state) {
     Element e = text(state.label) | hcenter | flex;
-    if (state.active && state.focused) {
+    if (state.active && state.focused)
       e = e | bold;
-    }
-    if (!state.focused && !state.active) {
+    if (!state.focused && !state.active)
       e = e | dim;
-    }
     return e;
   };
   option.underline.color_inactive = Color::Default;
   option.underline.color_active = Color::Red;
   return Menu(entries, selected, option);
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/menu_underline_animated_gallery.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <chrono>  // for operator""ms, literals
 #include <memory>  // for allocator, shared_ptr, __shared_ptr_access
 #include <string>  // for string, operator+, to_string, basic_string
@@ -20,9 +17,8 @@ using namespace ftxui;
 Component DummyComponent(int id) {
   return Renderer([id](bool focused) {
     auto t = text("component " + std::to_string(id));
-    if (focused) {
+    if (focused)
       t = t | inverted;
-    }
     return t;
   });
 }
@@ -31,7 +27,7 @@ Component Text(const std::string& t) {
   return Renderer([t] { return text(t) | borderEmpty; });
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace std::literals;
   std::vector<std::string> tab_values{
       "Tab 1", "Tab 2", "Tab 3", "A very very long tab", "탭",
@@ -92,3 +88,7 @@ int main() {
   auto screen = ScreenInteractive::TerminalOutput();
   screen.Loop(container);
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/modal_dialog.cpp

@@ -1,6 +1,3 @@
-// Copyright 2022 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <ftxui/component/component_options.hpp>  // for ButtonOption
 #include <ftxui/component/mouse.hpp>              // for ftxui
 #include <functional>                             // for function
@@ -80,3 +77,7 @@ int main(int argc, const char* argv[]) {
   screen.Loop(main_component);
   return 0;
 }
+
+// Copyright 2022 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/modal_dialog_custom.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for allocator, shared_ptr, __shared_ptr_access
 #include <string>  // for string, basic_string, char_traits, operator+
 #include <vector>  // for vector
@@ -11,7 +8,7 @@
 #include "ftxui/component/screen_interactive.hpp"  // for ScreenInteractive
 #include "ftxui/dom/elements.hpp"  // for operator|, Element, filler, text, hbox, separator, center, vbox, bold, border, clear_under, dbox, size, GREATER_THAN, HEIGHT
 
-int main() {
+int main(int argc, const char* argv[]) {
   using namespace ftxui;
   auto screen = ScreenInteractive::TerminalOutput();
 
@@ -91,3 +88,7 @@ int main() {
   screen.Loop(main_renderer);
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/nested_screen.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <memory>  // for allocator, shared_ptr, __shared_ptr_access
 #include <string>  // for operator+, string, char_traits, basic_string
 
@@ -38,7 +35,7 @@ void Nested(std::string path) {
   screen.Loop(renderer);
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::FitComponent();
   auto button_quit = Button("Quit", screen.ExitLoopClosure());
   auto button_nested = Button("Nested", [] { Nested(""); });
@@ -48,3 +45,7 @@ int main() {
   }));
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.

examples/component/print_key_press.cpp

@@ -18,48 +18,137 @@
 
 using namespace ftxui;
 
-std::string Code(Event event) {
-  std::string codes;
-  for (auto& it : event.input()) {
-    codes += " " + std::to_string((unsigned int)it);
+std::string Stringify(Event event) {
+  std::string out;
+  for (auto& it : event.input())
+    out += " " + std::to_string((unsigned int)it);
+
+  out = "(" + out + " ) -> ";
+  if (event.is_character()) {
+    out += "Event::Character(\"" + event.character() + "\")";
+  } else if (event.is_mouse()) {
+    out += "mouse";
+    switch (event.mouse().button) {
+      case Mouse::Left:
+        out += "_left";
+        break;
+      case Mouse::Middle:
+        out += "_middle";
+        break;
+      case Mouse::Right:
+        out += "_right";
+        break;
+      case Mouse::None:
+        out += "_none";
+        break;
+      case Mouse::WheelUp:
+        out += "_wheel_up";
+        break;
+      case Mouse::WheelDown:
+        out += "_wheel_down";
+        break;
     }
-  return codes;
+    switch (event.mouse().motion) {
+      case Mouse::Pressed:
+        out += "_pressed";
+        break;
+      case Mouse::Released:
+        out += "_released";
+        break;
+    }
+    if (event.mouse().control)
+      out += "_control";
+    if (event.mouse().shift)
+      out += "_shift";
+    if (event.mouse().meta)
+      out += "_meta";
+
+    out += "(" +  //
+           std::to_string(event.mouse().x) + "," +
+           std::to_string(event.mouse().y) + ")";
+  } else if (event == Event::ArrowLeft) {
+    out += "Event::ArrowLeft";
+  } else if (event == Event::ArrowRight) {
+    out += "Event::ArrowRight";
+  } else if (event == Event::ArrowUp) {
+    out += "Event::ArrowUp";
+  } else if (event == Event::ArrowDown) {
+    out += "Event::ArrowDown";
+  } else if (event == Event::ArrowLeftCtrl) {
+    out += "Event::ArrowLeftCtrl";
+  } else if (event == Event ::ArrowRightCtrl) {
+    out += "Event::ArrowRightCtrl";
+  } else if (event == Event::ArrowUpCtrl) {
+    out += "Event::ArrowUpCtrl";
+  } else if (event == Event::ArrowDownCtrl) {
+    out += "Event::ArrowDownCtrl";
+  } else if (event == Event::Backspace) {
+    out += "Event::Backspace";
+  } else if (event == Event::Delete) {
+    out += "Event::Delete";
+  } else if (event == Event::Escape) {
+    out += "Event::Escape";
+  } else if (event == Event::Return) {
+    out += "Event::Return";
+  } else if (event == Event::Tab) {
+    out += "Event::Tab";
+  } else if (event == Event::TabReverse) {
+    out += "Event::TabReverse";
+  } else if (event == Event::F1) {
+    out += "Event::F1";
+  } else if (event == Event::F2) {
+    out += "Event::F2";
+  } else if (event == Event::F3) {
+    out += "Event::F3";
+  } else if (event == Event::F4) {
+    out += "Event::F4";
+  } else if (event == Event::F5) {
+    out += "Event::F5";
+  } else if (event == Event::F6) {
+    out += "Event::F6";
+  } else if (event == Event::F7) {
+    out += "Event::F7";
+  } else if (event == Event::F8) {
+    out += "Event::F8";
+  } else if (event == Event::F9) {
+    out += "Event::F9";
+  } else if (event == Event::F10) {
+    out += "Event::F10";
+  } else if (event == Event::F11) {
+    out += "Event::F11";
+  } else if (event == Event::F12) {
+    out += "Event::F12";
+  } else if (event == Event::Home) {
+    out += "Event::Home";
+  } else if (event == Event::End) {
+    out += "Event::End";
+  } else if (event == Event::PageUp) {
+    out += "Event::PageUp";
+  } else if (event == Event::PageDown) {
+    out += "Event::PageDown";
+  } else if (event == Event::Custom) {
+    out += "Custom";
+  } else {
+    out += "(special)";
+  }
+  return out;
 }
 
-int main() {
+int main(int argc, const char* argv[]) {
   auto screen = ScreenInteractive::TerminalOutput();
 
   std::vector<Event> keys;
 
-  auto left_column = Renderer([&] {
-    Elements children = {
-        text("Codes"),
-        separator(),
-    };
-    for (size_t i = std::max(0, (int)keys.size() - 20); i < keys.size(); ++i) {
-      children.push_back(text(Code(keys[i])));
-    }
-    return vbox(children);
+  auto component = Renderer([&] {
+    Elements children;
+    for (size_t i = std::max(0, (int)keys.size() - 20); i < keys.size(); ++i)
+      children.push_back(text(Stringify(keys[i])));
+    return window(text("keys"), vbox(std::move(children)));
   });
 
-  auto right_column = Renderer([&] {
-    Elements children = {
-        text("Event"),
-        separator(),
-    };
-    for (size_t i = std::max(0, (int)keys.size() - 20); i < keys.size(); ++i) {
-      children.push_back(text(keys[i].DebugString()));
-    }
-    return vbox(children);
-  });
-
-  int split_size = 40;
-  auto component = ResizableSplitLeft(left_column, right_column, &split_size);
-  component |= border;
-
   component |= CatchEvent([&](Event event) {
     keys.push_back(event);
-    return false;
+    return true;
   });
 
   screen.Loop(component);

examples/component/radiobox.cpp

@@ -1,6 +1,3 @@
-// Copyright 2020 Arthur Sonzogni. All rights reserved.
-// Use of this source code is governed by the MIT license that can be found in
-// the LICENSE file.
 #include <string>  // for string, allocator, basic_string
 #include <vector>  // for vector
 
@@ -10,7 +7,7 @@
 
 using namespace ftxui;
 
-int main() {
+int main(int argc, const char* argv[]) {
   std::vector<std::string> radiobox_list = {
       "Use gcc",
       "Use clang",
@@ -23,3 +20,7 @@ int main() {
   screen.Loop(Radiobox(&radiobox_list, &selected));
   return 0;
 }
+
+// Copyright 2020 Arthur Sonzogni. All rights reserved.
+// Use of this source code is governed by the MIT license that can be found in
+// the LICENSE file.