Merge mango

.github/ISSUE_TEMPLATE/bug_report.md

@@ -18,11 +18,15 @@ mango version:
 wlroots version:
 
 ## Crash track
+
 1.you need to build mango by enable asan flag.
+
 ```bash
 meson build -Dprefix=/usr -Dasan=true
-``
+```
+
 2.run mango in tty.
+
 ```bash
 export ASAN_OPTIONS="detect_leaks=1:halt_on_error=0:log_path=/home/xxx/asan.log"
 mango

.github/workflows/README.md

@@ -0,0 +1,163 @@
+# GitHub Actions Workflows
+
+This directory contains the GitHub Actions workflows for the MangoWC project.
+
+## Workflows
+
+### build-arch.yml
+
+**Purpose**: Builds the project on Arch Linux to ensure code changes compile
+successfully.
+
+**Triggers**:
+
+- Push to `main` or `master` branch (only when code files change)
+- Pull requests to `main` or `master` branch (only when code files change)
+- Manual dispatch (workflow_dispatch)
+
+**Path filters** (only runs when these change):
+
+- Source files: `**.c`, `**.h`, `**.cpp`, `**.scm`
+- Build files: `meson.build`, `meson_options.txt`, `flake.nix`
+- Protocol definitions: `protocols/**`
+- Workflow file itself: `.github/workflows/build-arch.yml`
+
+**What it does**:
+
+1. Runs in Arch Linux container (archlinux:latest)
+2. Updates system and installs all dependencies via pacman
+3. Installs wlroots from official Arch repositories
+4. Installs scenefx from AUR (Arch User Repository)
+5. Configures the project with meson
+6. Builds the project with ninja
+7. Verifies the executables were created
+
+**Build Strategy**:
+
+- Uses Arch Linux for up-to-date system packages
+- All dependencies installed via pacman or AUR (no source builds)
+- wlroots installed from official Arch repositories
+- scenefx installed from AUR
+
+**Dependencies**:
+
+- Arch Linux container (archlinux:latest)
+- Meson build system
+- Ninja build tool
+- All system packages from pacman (wayland, libinput, wlroots, mesa, etc.)
+- scenefx from AUR
+
+### build-nixos.yml
+
+**Purpose**: Builds the project on NixOS using Nix flakes to ensure code
+changes work correctly in the NixOS ecosystem.
+
+**Triggers**:
+
+- Push to `main` or `master` branch (only when code files change)
+- Pull requests to `main` or `master` branch (only when code files change)
+- Manual dispatch (workflow_dispatch)
+
+**Path filters** (only runs when these change):
+
+- Source files: `**.c`, `**.h`, `**.cpp`, `**.scm`
+- Build files: `meson.build`, `meson_options.txt`, `flake.nix`
+- Nix files: `nix/**`
+- Protocol definitions: `protocols/**`
+- Workflow file itself: `.github/workflows/build-nixos.yml`
+
+**What it does**:
+
+1. Runs on Ubuntu with Nix installed
+2. Installs Nix with flakes and nix-command experimental features
+3. Builds the project using `nix build` with the repository's flake.nix
+4. Verifies that executables (mango and mmsg) are created and executable
+5. Tests basic executable functionality
+
+**Build Strategy**:
+
+- Uses Nix flakes for reproducible builds
+- All dependencies managed through Nix
+- Leverages the repository's flake.nix configuration
+- Dependencies from nixpkgs-unstable
+
+**Dependencies**:
+
+- Nix package manager with flakes support
+- All dependencies defined in flake.nix and nix/default.nix
+- scenefx from upstream flake
+- wlroots 0.19 from nixpkgs
+
+### docs.yml
+
+**Purpose**: Validates markdown documentation for style and formatting consistency.
+
+**Triggers**:
+
+- Push to `main` or `master` branch (only when markdown files change)
+- Pull requests to `main` or `master` branch (only when markdown files change)
+- Manual dispatch (workflow_dispatch)
+
+**Path filters** (only runs when these change):
+
+- Markdown files: `**.md`
+- Workflow file itself: `.github/workflows/docs.yml`
+
+**What it does**:
+
+- Lints markdown files in the repository using markdownlint-cli2
+- Checks for common markdown formatting issues
+- Ensures documentation follows consistent style guidelines
+- Excludes dependency directories (wayland, wlroots, scenefx) to only lint
+  repository files
+
+### lock.yml
+
+**Purpose**: Automatically locks inactive issues and PRs to keep the repository
+  clean.
+
+**Triggers**:
+
+- Scheduled daily at 12:30 UTC
+- Manual dispatch
+
+**What it does**:
+
+- Locks issues, PRs, and discussions that have been closed for 30 days
+- Adds a comment explaining why the thread was locked
+
+### stale.yml
+
+**Purpose**: Automatically closes issues that have been manually marked as stale.
+
+**Triggers**:
+
+- Scheduled daily at 12:30 UTC
+
+**What it does**:
+
+- Closes issues marked with the "stale" label after 7 days of inactivity
+- Adds "automatic-closing" label when closing
+- Does not automatically mark issues as stale (only processes manually marked ones)
+
+## Development Notes
+
+The build workflows ensure that:
+
+- Only run when actual code or build configuration changes
+- All dependencies are properly installed
+- The project compiles without errors on both Arch Linux and NixOS
+- Both main executables (`mango` and `mmsg`) are built successfully
+
+The docs workflow ensures that:
+
+- Only runs when markdown documentation changes
+- Documentation follows consistent formatting
+- Markdown files are well-formed and free of common issues
+
+If a build workflow fails, check:
+
+1. Dependencies are up to date in the workflow file
+2. wlroots and scenefx versions match requirements in meson.build
+3. Build configuration in meson.build hasn't changed
+4. For NixOS builds: flake.nix and nix/default.nix are correctly configured

.github/workflows/build-arch.yml

@@ -0,0 +1,98 @@
+name: Build (Arch Linux)
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - '**.c'
+      - '**.h'
+      - '**.cpp'
+      - '**.scm'
+      - 'meson.build'
+      - 'meson_options.txt'
+      - 'flake.nix'
+      - 'protocols/**'
+      - '.github/workflows/build-arch.yml'
+  pull_request:
+    branches: [main, master]
+    paths:
+      - '**.c'
+      - '**.h'
+      - '**.cpp'
+      - '**.scm'
+      - 'meson.build'
+      - 'meson_options.txt'
+      - 'flake.nix'
+      - 'protocols/**'
+      - '.github/workflows/build-arch.yml'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    container:
+      image: archlinux:latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Update system and install dependencies
+        run: |
+          # Update package database
+          pacman -Syu --noconfirm
+
+          # Install build tools and all dependencies
+          pacman -S --noconfirm \
+            base-devel \
+            git \
+            meson \
+            ninja \
+            wayland \
+            wayland-protocols \
+            libinput \
+            libxkbcommon \
+            pcre2 \
+            pixman \
+            libdrm \
+            libxcb \
+            xcb-util-wm \
+            xorg-xwayland \
+            hwdata \
+            libliftoff \
+            libdisplay-info \
+            seatd \
+            mesa \
+            wlroots0.19 \
+            pkg-config
+
+      - name: Install scenefx from AUR
+        run: |
+          # Install scenefx from AUR since it's not in official repos
+          # Create a non-root user for makepkg (AUR requires non-root)
+          useradd -m -G wheel builder
+          echo "builder ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
+
+          # Clone and build scenefx from AUR as builder user
+          cd /home/builder
+          su - builder -c "git clone https://aur.archlinux.org/scenefx0.4.git"
+          cd scenefx0.4
+          su - builder -c "cd /home/builder/scenefx0.4 && makepkg -si --noconfirm"
+
+      - name: Configure meson
+        run: |
+          # Download meson subprojects if needed
+          meson subprojects download || true
+          meson setup build/ --prefix=/usr
+
+      - name: Build project
+        run: |
+          ninja -C build/
+
+      - name: Build summary
+        run: |
+          echo "✅ Build completed successfully!"
+          echo "Built executables:"
+          ls -lh build/mango build/mmsg

.github/workflows/build-nixos.yml

@@ -0,0 +1,77 @@
+name: Build (NixOS)
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - '**.c'
+      - '**.h'
+      - '**.cpp'
+      - '**.scm'
+      - 'meson.build'
+      - 'meson_options.txt'
+      - 'flake.nix'
+      - 'nix/**'
+      - 'protocols/**'
+      - '.github/workflows/build-nixos.yml'
+  pull_request:
+    branches: [main, master]
+    paths:
+      - '**.c'
+      - '**.h'
+      - '**.cpp'
+      - '**.scm'
+      - 'meson.build'
+      - 'meson_options.txt'
+      - 'flake.nix'
+      - 'nix/**'
+      - 'protocols/**'
+      - '.github/workflows/build-nixos.yml'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install Nix
+        uses: cachix/install-nix-action@v27
+        with:
+          nix_path: nixpkgs=channel:nixos-unstable
+          extra_nix_config: |
+            experimental-features = nix-command flakes
+
+      - name: Build project with Nix
+        run: |
+          nix build --print-build-logs
+
+      - name: Check build outputs
+        run: |
+          echo "✅ Build completed successfully!"
+          echo "Built executables:"
+          ls -lh result/bin/
+
+      - name: Verify executables
+        run: |
+          # Check that mango executable exists and is executable
+          if [ -x "result/bin/mango" ]; then
+            echo "✅ mango executable found and is executable"
+            result/bin/mango --version || echo "Note: --version may not be supported"
+          else
+            echo "❌ mango executable not found or not executable"
+            exit 1
+          fi
+
+          # Check that mmsg executable exists and is executable
+          if [ -x "result/bin/mmsg" ]; then
+            echo "✅ mmsg executable found and is executable"
+            result/bin/mmsg --help || echo "Note: --help may not be supported"
+          else
+            echo "❌ mmsg executable not found or not executable"
+            exit 1
+          fi

.github/workflows/docs.yml

@@ -0,0 +1,35 @@
+name: Documentation
+
+on:
+  push:
+    branches: [main, master]
+    paths:
+      - '**.md'
+      - '.github/workflows/docs.yml'
+  pull_request:
+    branches: [main, master]
+    paths:
+      - '**.md'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+jobs:
+  markdown-lint:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Lint markdown files
+        uses: DavidAnson/markdownlint-cli2-action@v18
+        with:
+          globs: |
+            *.md
+            .github/**/*.md
+            !**/node_modules/**
+            !**/wayland/**
+            !**/wlroots/**
+            !**/scenefx/**