[WIP] feat(ptk): add preliminary Wayland backend implementation

.clang-format

@@ -33,3 +33,6 @@ SpacesInParentheses: false
 SpacesInSquareBrackets: false
 SortIncludes: false
 UseTab: Never
+InsertNewlineAtEOF: true
+DeriveLineEnding: false
+UseCRLF: false

.github/CODE_OF_CONDUCT.md

@@ -34,7 +34,7 @@ This Code of Conduct applies both within project spaces and in public spaces whe
 
 ## Enforcement
 
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at admin@lc-soft.io. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at hello@lcui.dev. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
 
 Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
 

.github/CONTRIBUTING.md

@@ -74,9 +74,10 @@ To ensure consistency throughout the source code, keep these rules in mind as yo
 
 - All features or bug fixes **must be tested** by one or more specs (unit-tests).
 - All public API methods **must be documented**. (Details TBC).
-- Follow the existing code style. You have the following two ways to format the code:
-  - Use [clang-format](http://clang.llvm.org/docs/ClangFormat.html) to format the changed files: `clang-format --style=file [src/????.c]`.
-  - Install the [NodeJS](https://nodejs.org/en/) Environment and run `npm install`, which will add a git hook to format the changed code, and it will run before you run `git commit`.
+- Follow the existing code style. The project uses [clang-format](http://clang.llvm.org/docs/ClangFormat.html) with the rules defined in `.clang-format`. You have two options:
+  - Run `clang-format -i path/to/file.c` manually on the files you changed.
+  - Install [Node.js](https://nodejs.org/) and run `npm install` once. This installs [husky](https://typicode.github.io/husky/) + [lint-staged](https://github.com/lint-staged/lint-staged), which formats every staged `.c` / `.h` file with clang-format on `git commit` automatically.
+  - CI checks formatting of only the files changed in each PR, so pre-existing style deviations won't block you.
 
 ## Commit Message Guidelines
 

.github/workflows/ccpp.yml

@@ -1,7 +1,36 @@
 name: C/C++ CI
-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - develop
+      - master
+      - main
+    tags:
+      - 'v*'
+  pull_request:
 jobs:
+  format:
+    name: Check C/C++ formatting
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check formatting of changed files
+        run: npm run format:check -- origin/${{ github.base_ref || 'develop' }}
+
   build:
+    needs: format
     env:
       TARGET_MAJOR: 3
       TARGET_VERSION: 3.0.0
@@ -14,68 +43,47 @@ jobs:
     runs-on: ${{ matrix.os }}
     name: "Builds binaries on ${{ matrix.os }}"
     steps:
-      - uses: actions/checkout@v1
-
-      - uses: xmake-io/github-action-setup-xmake@v1
+      - uses: actions/checkout@v4
         with:
-          xmake-version: branch@dev
+          submodules: recursive
 
-      - name: Update git submodule
-        run: |
-          git submodule update --init
+      - uses: xmake-io/github-action-setup-xmake@v1
+        with:
+          package-cache: true
+          actions-cache-folder: '.xmake-cache'
 
       - name: Install tools
         if: runner.os == 'Linux'
         run: |
           sudo apt-get update --fix-missing
-          sudo apt-get install debhelper lcov valgrind -yy
-          sudo apt-get install libfreetype6-dev libpng-dev libyaml-dev libomp-dev libx11-dev ninja-build fontconfig libfontconfig1-dev libjpeg-dev
+          sudo apt-get install debhelper lcov valgrind xvfb -yy
+          sudo apt-get install libfreetype6-dev libpng-dev libyaml-dev libomp-dev libx11-dev ninja-build fontconfig libfontconfig1-dev libjpeg-dev libwayland-dev libxkbcommon-dev wayland-protocols
 
       - name: Configure
         if: runner.os == 'Windows'
         run: xmake config -y -v -k ${{ env.TARGET_KIND }} -m release --ci-env=y
 
       - name: Configure for coverage mode
         if: runner.os == 'Linux'
-        run: xmake config -y -v -k ${{ env.TARGET_KIND }} -m coverage --ci-env=y
+        run: xmake config -y -v -k ${{ env.TARGET_KIND }} -m coverage --ci-env=y --memcheck=y
 
       - name: Build
-        run: |
-          xmake
-          xmake build yutil_test
-          xmake build pandagl_tests
-          xmake build libcss_tests
-          xmake build librouter_tests
-          xmake build libi18n_tests
-          xmake build lcui_tests
-
-      - name: Run tests for libraries with memcheck
-        if: runner.os == 'Linux'
-        run: |
-          xmake run pandagl_tests
-          xmake run yutil_test --memcheck
-          xmake run libcss_tests --memcheck
-          xmake run librouter_tests --memcheck
-          xmake run libi18n_tests --memcheck
+        run: xmake
 
-      - name: Run tests for lcui with memcheck
-        if: runner.os == 'Linux'
-        run: |
-            xmake run lcui_tests --memcheck
-
-      - name: Run tests
+      - name: Run all tests
         if: runner.os == 'Windows'
-        run: |
-          xmake run pandagl_tests
-          xmake run yutil_test
-          xmake run libcss_tests
-          xmake run librouter_tests
-          xmake run libi18n_tests
-          xmake run lcui_tests
+        run: xmake test
+
+      - name: Run all tests with memcheck
+        if: runner.os == 'Linux'
+        run: xvfb-run -a xmake test
 
       - name: Upload reports to Codecov
         if: runner.os == 'Linux'
-        run: bash <(curl -s https://codecov.io/bash);
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
 
       - name: Build for release
         run: |
@@ -87,22 +95,40 @@ jobs:
           xmake package
           xmake install -o dist/lcui-package
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Install doc-viewer dependencies
+        working-directory: examples/doc-viewer
+        run: bun install
+
+      - name: Install lcui-cli
+        run: npm install -g @lcui/cli
+
+      - name: Generate doc-viewer sources
+        working-directory: examples/doc-viewer
+        run: bun run compile
+
+      - name: Process doc-viewer TSX files
+        working-directory: examples/doc-viewer
+        run: lcui build
+
       - name: Build examples
-        run: |
-          cd examples
-          xmake config -P . -y
-          xmake build -P .
-          xmake install -P . -o ../dist/lcui-examples
-          mv ../dist/lcui-examples/bin/* ../dist/lcui-examples/
-          rm -r ../dist/lcui-examples/bin
-
-      - uses: actions/upload-artifact@master
+        run: xmake build -yg lcui-examples
+
+      - name: Install examples
+        run: xmake install -o dist/lcui-examples -g lcui-examples
+
+      - uses: actions/upload-artifact@v4
         with:
           name: lcui${{ env.TARGET_MAJOR }}-${{ env.TARGET_VERSION }}-${{ env.TARGET_KIND }} (${{ runner.os }})
           path: |
             dist/lcui-package
 
-      - uses: actions/upload-artifact@master
+      - uses: actions/upload-artifact@v4
         with:
           name: lcui${{ env.TARGET_MAJOR }}-examples (${{ runner.os }})
           path: |
@@ -116,10 +142,10 @@ jobs:
       ARTIFACT_DIR: ./release
 
     steps:
-      - uses: actions/checkout@v1
+      - uses: actions/checkout@v4
 
       - name: Download artifacts
-        uses: actions/download-artifact@v3
+        uses: actions/download-artifact@v4
         with:
           path: ${{ env.ARTIFACT_DIR }}
 

.gitignore

@@ -69,4 +69,5 @@ build/*.jpg
 config.h
 test/build
 vsxmake*
-compile_commands.json
+compile_commands.json
+docs/build/

.husky/pre-commit

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+npx lint-staged