Add wayland-based backend support

.github/CONTRIBUTING.md

@@ -0,0 +1,41 @@
+# Contributing to PAL
+
+Everyone is welcome to contribute to PAL by submitting bug reports, 
+bug fixes, improving documentation, adding tests examples, telling others about PAL,
+giving PAL a star, adding a new backend, etc.
+
+### Reporting Bugs
+
+Make sure the bug is not an API usage issue and you have the lastest version of PAL.
+If the above is not the case, report the bug on our [GitHub Issue Tracker](https://github.com/nichcode/PAL/issues) using the bug report template. Please make sure you write a good bug report.
+
+## Requesting Features
+
+Requesting a feature which does not align with the goals of PAL (explicit, low-level) will likey
+not be merge into PAL. This approach keeps project focused and consistent.
+
+Request features on our [GitHub Issue Tracker](https://github.com/nichcode/PAL/issues) 
+using the feature report template. Please explain into detail why your feature will work and if 
+possibly usages of it in use.
+
+## Coding Convention
+
+- **C99** for C source.
+
+- Naming convention:
+  - `lowerCamelCase` for functions and function parameters. (e.g. `palCreateWindow`, `windowHandle`).
+  - `PascalCase` for public types (e.g. `PalResult`).
+  - static internal variables uses 's_' prefix. (eg. `s_InternalData`).
+  - `snakeCase` for public and internal macros. (e.g. `PAL_DEFAULT_ALIGNMENT`).
+
+
+## Contributing code
+
+**PAL is released under the Zlib License and every 
+code contributed to PAL must agree to Zlib licensing terms.**
+
+Pull request checklist:
+
+- Ensure it compiles on **all** supported platforms.
+- Ensure the PR is focused and changes are relevant to the feature or bug fix.
+- Ensure your code is formatted with clang-format using the `clang-format` file in the repo.

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,28 @@
+---
+name: Bug report
+about: Create a report to help us improve
+labels: bug
+---
+
+**Describe the bug**  
+A clear and concise description of what the bug is.
+
+**To Reproduce**  
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**  
+A clear and concise description of what you expected to happen.
+
+**Screenshots**  
+If applicable, add screenshots to help explain your problem.
+
+**Operating system (please complete the following information)**:
+- OS: [e.g. windows]
+- Version: [e.g. 11]
+
+**Additional context**  
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/config.yaml

@@ -0,0 +1 @@
+blank_issues_enabled: false

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+labels: enhancement
+---
+
+**Is your feature request related to a problem? Please describe.**  
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**  
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**  
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**  
+Add any other context or screenshots about the feature request here.

CHANGELOG.md

@@ -1,4 +1,4 @@
-# Changelog
+# CHANGELOG
 
 ## [1.0.0] - 2025-09-27
 - Initial stable release of PAL.
@@ -68,4 +68,56 @@ reflecting its role as the primary explicit foundation for OS and graphics abstr
 
 ### Notes
 - No API or ABI changes - existing code remains compatible.
-- Safe upgrade from **v1.1.0** - just rebuild your project after updating.
+- Safe upgrade from **v1.1.0** - just rebuild your project after updating.
+
+## [1.3.0] - 2025-11-21
+
+### Features
+- **Video:** Added Wayland backend support
+- **Video:** Added **palGetVideoFeaturesEx()** to check old and extended supported features.
+- **Video:** Added **palGetWindowHandleInfoEx()** to get extended window handles.
+- **Video:** Added **palGetRawMouseWheelDelta()** to get raw mouse wheel delta.
+- **Video:** Added **PAL_CONFIG_BACKEND_GLES** to `PalFBConfigBackend` enum.
+- **Video:** Added **palSetPreferredInstance()** to set the native instance or display PAL video should use rather than creating a new one.
+
+- **Core:** Added **palPackFloat()** to combine two floats into a single Int64 integer.
+- **Core:** Added **palUnpackFloat()** to retreive two floats from a single Int64 integer.
+
+- **OpenGL:** Added **palGLSetInstance()** to set the native instance or display PAL opengl should use. This must be set before calling **palInitGL()**.
+- **OpenGL:** Added **palGLGetBackend()** to get the opengl backend.
+
+- **Event:** Added **PAL_EVENT_WINDOW_DECORATION_MODE** to `PalEventType` enum.
+- **Event:** Added **PalDecorationMode** enum.
+
+### Tests
+- Added native integration example: demonstrating **Native API Integration with PAL API**. see 
+**native_integration_test.c**.
+
+- Added native instance example: demonstrating **Native Instance or Display Integration with PAL API**.
+see **native_instance_test.c**.
+
+- Added custom decoration example: demonstrating **Custom Window Decoration**.
+see **custom_decoration_test.c**.
+
+### Notes
+- **No ABI changes** - existing code remains compatible.
+
+- **OpenGL tests may fail** - The opengl system now needs to call **palGLSetInstance()**
+to set the instance or display before initializing. Failure to do this fails.
+This is a runtime behavior change. The tests are updated in the repo.
+
+- **Pal mouse button event** - The `event.data` now packs both the button and
+wayland seat serial (If on wayland). Existing code that reads as a single value
+without unpacking will see different values. 
+This is a runtime behavior change. The **input_window_test.c** has been updated in the repo.
+
+- **palJoinThread()** - ABI remains unchanged but now takes the address 
+of a pointer variable for the return value of the thread.
+PAL internally reinterpreted into a pointer-to-pointer. This is for ABI stability.
+
+Example – Join thread and get the return value
+```c
+void* retval;
+palJoinThread(thread, &retval);
+```
+

LICENSE.txt

@@ -1,7 +1,7 @@
 
 zlib License
 
-Copyright (C) 2025 Nicholas Agbo
+Copyright (C) 2025 Nicholas Agbo <agbonicholas04@gmail.com>
 
 This software is provided 'as-is', without any express or implied
 warranty.  In no event will the authors be held liable for any damages

README.md

@@ -7,11 +7,12 @@
 
 PAL is a lightweight, low-level, cross-platform abstraction layer in **C**, designed to be **explicit** and as close to the **OS** as possible — similar in philosophy to Vulkan. It gives you precise control without hidden behavior, making it ideal for developers who want performance and predictability.
 
-Originally named as **Platform Abstraction Layer**, 
-PAL has evolved into **Prime Abstraction Layer** — the **first** and most **direct** layer between your engine or software and the operating system.
-
 PAL is transparent. All queries — window size, position, monitor info, and more — reflect the current platform state. Using PAL is like working directly with the OS: it applies no hidden logic, makes no assumptions, and leaves behavior fully in your control.
 
+The goal is very simple, write low-level cross-platform code without having per platform files
+all over the place. Example: `renderer_vulkan`, `renderer_d3d12`, `window_win32`, etc.
+PAL makes it possible to safely mix native API with its API in a very straight forward way. This is one of the main reasons why PAL exists.
+
 This approach gives you total control: you handle events, manage resources, and cache state explicitly. PAL provides the building blocks; how you use them — whether for simple applications or advanced frameworks — is entirely up to you.
 
 Example – Get Window Size
@@ -93,9 +94,9 @@ For more detailed examples, see the [tests folder](./tests) tests folder, which
 ## Supported Platforms
 - Windows (Vista+)
 - Linux (X11)
+- Linux (Wayland)
 
 ## Planned Platforms
-- Linux (Wayland)
 - macOS (Cocoa)
 - Android
 - iOS

include/pal/pal_core.h

@@ -1,7 +1,7 @@
 
 /**
 
-Copyright (C) 2025 Nicholas Agbo
+Copyright (C) 2025 Nicholas Agbo <agbonicholas04@gmail.com>
 
 This software is provided 'as-is', without any express or implied
 warranty.  In no event will the authors be held liable for any damages
@@ -33,6 +33,7 @@ freely, subject to the following restrictions:
 #define _PAL_CORE_H
 
 #include <stdint.h>
+#include <string.h>
 
 #ifdef __cplusplus
 #define PAL_EXTERN_C extern "C"
@@ -75,7 +76,14 @@ typedef _Bool bool;
 #define PAL_API PAL_EXTERN_C
 #endif // _PAL_BUILD_DLL
 
+#if defined(__BYTE_ORDER__) && __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
+#define PAL_BIG_ENDIAN 1
+#else
+#define PAL_BIG_ENDIAN 0
+#endif // __ORDER_BIG_ENDIAN__
+
 #define PAL_BIT(x) 1 << x
+#define PAL_BIT64(x) 1ULL << x
 
 /**
  * @brief A signed 8-bit integer
@@ -462,6 +470,33 @@ static inline Int64 PAL_CALL palPackPointer(void* ptr)
     return (Int64)(UintPtr)ptr;
 }
 
+/**
+ * @brief Combine two floats into a single 64-bit signed integer.
+ *
+ * @return The combined 64-bit signed integer.
+ *
+ * Thread safety: This function is thread safe.
+ *
+ * @since 1.3
+ * @ingroup pal_core
+ * @sa palUnpackFloat
+ */
+static inline Int64 PAL_CALL palPackFloat(
+    float low,
+    float high)
+{
+    Int64 combined = 0;
+#if PAL_BIG_ENDIAN
+    memcpy(&((Uint32*)&combined)[0], &high, sizeof(float));
+    memcpy(&((Uint32*)&combined)[1], &low, sizeof(float));
+#else
+    memcpy(&((Uint32*)&combined)[0], &low, sizeof(float));
+    memcpy(&((Uint32*)&combined)[1], &high, sizeof(float));
+#endif // PAL_BIG_ENDIAN
+
+    return combined;
+}
+
 /**
  * @brief Retrieve two 32-bit unsigned integers from a 64-bit signed integer.
  *
@@ -531,6 +566,44 @@ static inline void* PAL_CALL palUnpackPointer(Int64 data)
     return (void*)(UintPtr)data;
 }
 
+/**
+ * @brief Retrieve two floats from a 64-bit signed integer.
+ *
+ * @param[out] outLow Low value of the 64-bit signed integer.
+ * @param[out] outHigh High value of the 64-bit signed integer.
+ *
+ * Thread safety: This function is thread-safe if `outLow` and `outHigh` are
+ * thread local.
+ *
+ * @since 1.3
+ * @ingroup pal_core
+ * @sa palPackFloat
+ */
+static inline void PAL_CALL palUnpackFloat(
+    Int64 data,
+    float* low,
+    float* high)
+{
+#if PAL_BIG_ENDIAN
+    if (low) {
+        memcpy(low, &((Uint32*)&data)[1], sizeof(float));
+    }
+
+    if (high) {
+        memcpy(high, &((Uint32*)&data)[0], sizeof(float));
+    }
+#else
+    if (low) {
+        memcpy(low, &((Uint32*)&data)[0], sizeof(float));
+    }
+
+    if (high) {
+        memcpy(high, &((Uint32*)&data)[1], sizeof(float));
+    }
+
+#endif // PAL_BIG_ENDIAN
+}
+
 /** @} */ // end of pal_core group
 
 #endif // _PAL_CORE_H

include/pal/pal_event.h

@@ -1,7 +1,7 @@
 
 /**
 
-Copyright (C) 2025 Nicholas Agbo
+Copyright (C) 2025 Nicholas Agbo <agbonicholas04@gmail.com>
 
 This software is provided 'as-is', without any express or implied
 warranty.  In no event will the authors be held liable for any damages
@@ -100,6 +100,21 @@ typedef bool(PAL_CALL* PalPollFn)(
     void* userData,
     PalEvent* outEvent);
 
+/**
+ * @enum PalDecorationMode
+ * @brief Decoration types. This is not a bitmask enum.
+ *
+ * All decoration types follow the format `PAL_DECORATION_MODE_**` for
+ * consistency and API use.
+ *
+ * @since 1.3
+ * @ingroup pal_event
+ */
+typedef enum {
+    PAL_DECORATION_MODE_CLIENT_SIDE,
+    PAL_DECORATION_MODE_SERVER_SIDE
+} PalDecorationMode;
+
 /**
  * @enum PalEventType
  * @brief Event types. This is not a bitmask enum.
@@ -259,7 +274,7 @@ typedef enum {
     /**
      * PAL_EVENT_MOUSE_BUTTONDOWN
      *
-     * event.data : mouse button
+     * event.data : lower 32 bits = button, upper 32 bits = serial
      *
      * event.data2 : window
      *
@@ -271,7 +286,7 @@ typedef enum {
     /**
      * PAL_EVENT_MOUSE_BUTTONUP
      *
-     * event.data : mouse button
+     * event.data : lower 32 bits = button, upper 32 bits = serial
      *
      * event.data2 : window
      *
@@ -348,6 +363,18 @@ typedef enum {
      */
     PAL_EVENT_KEYCHAR,
 
+    /**
+     * PAL_EVENT_WINDOW_DECORATION_MODE
+     *
+     * event.data : negotiated decorations mode
+     *
+     * event.data2 : window
+     *
+     * Use inline helpers:
+     * - palUnpackPointer()
+     */
+    PAL_EVENT_WINDOW_DECORATION_MODE,
+
     PAL_EVENT_MAX
 } PalEventType;