From 577c5bc3b274d60f1b356d13787621fe38848ec4 Mon Sep 17 00:00:00 2001
From: Zedhugh Chen <zedhugh@gmail.com>
Date: Mon, 23 Mar 2026 02:43:59 +0800
Subject: [PATCH] =?UTF-8?q?=E5=AE=9A=E4=B9=89=E5=85=AC=E5=85=B1=E7=94=A8?=
 =?UTF-8?q?=E6=88=B7=E8=87=AA=E5=AE=9A=E4=B9=89=E9=85=8D=E7=BD=AE=E9=9C=80?=
 =?UTF-8?q?=E8=A6=81=E7=94=A8=E5=88=B0=E7=9A=84=E6=8E=A5=E5=8F=A3=E5=92=8C?=
 =?UTF-8?q?=E6=95=B0=E6=8D=AE=E7=BB=93=E6=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 include/zdwm/config.h | 44 +++++++++++++++++++++++++++++++
 include/zdwm/layout.h | 61 +++++++++++++++++++++++++++++++++++++++++++
 include/zdwm/types.h  | 36 +++++++++++++++++++++++++
 3 files changed, 141 insertions(+)
 create mode 100644 include/zdwm/config.h
 create mode 100644 include/zdwm/layout.h
 create mode 100644 include/zdwm/types.h

diff --git a/include/zdwm/config.h b/include/zdwm/config.h
new file mode 100644
index 0000000..54f0d5b
--- /dev/null
+++ b/include/zdwm/config.h
@@ -0,0 +1,44 @@
+#ifndef ZDWM_CONFIG_H
+#define ZDWM_CONFIG_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <zdwm/layout.h>
+
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
+#define ZDWM_CONFIG_ABI_VERSION 1u
+
+typedef struct zdwm_config_builder_t zdwm_config_builder_t;
+
+typedef struct zdwm_builtin_layouts_t {
+  zdwm_layout_fn tile;
+  zdwm_layout_fn monocle;
+} zdwm_builtin_layouts_t;
+
+typedef struct zdwm_api_t {
+  uint32_t abi_version;
+  zdwm_builtin_layouts_t builtin_layouts;
+
+  zdwm_layout_id_t (*register_layout)(zdwm_config_builder_t *builder,
+                                      const char *name, const char *symbol,
+                                      const char *description,
+                                      zdwm_layout_fn fn);
+
+  bool (*define_workspace)(zdwm_config_builder_t *builder, size_t output_index,
+                           const char *name, const zdwm_layout_id_t *layout_ids,
+                           size_t layout_count,
+                           zdwm_layout_id_t initial_layout_id);
+} zdwm_api_t;
+
+bool zdwm_config_setup(const zdwm_api_t *api, zdwm_config_builder_t *builder,
+                       const zdwm_output_info_t *outputs, size_t output_count);
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif /* ZDWM_CONFIG_H */
diff --git a/include/zdwm/layout.h b/include/zdwm/layout.h
new file mode 100644
index 0000000..e38f2c5
--- /dev/null
+++ b/include/zdwm/layout.h
@@ -0,0 +1,61 @@
+#ifndef ZDWM_LAYOUT_H
+#define ZDWM_LAYOUT_H
+
+#include <stdbool.h>
+#include <stddef.h>
+#include <stdint.h>
+#include <stdlib.h>
+#include <zdwm/types.h>
+
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
+typedef struct zdwm_layout_ctx_t {
+  zdwm_workspace_id_t workspace_id;
+  zdwm_window_id_t focused_window_id;
+  zdwm_rect_t workarea;
+  const zdwm_window_id_t *window_ids;
+  size_t window_count;
+} zdwm_layout_ctx_t;
+
+typedef struct zdwm_layout_item_t {
+  zdwm_window_id_t window_id;
+  zdwm_rect_t rect;
+} zdwm_layout_item_t;
+
+typedef struct zdwm_layout_result_t {
+  zdwm_layout_item_t *items;
+  size_t item_count;
+  size_t item_capacity;
+} zdwm_layout_result_t;
+
+typedef bool (*zdwm_layout_fn)(const zdwm_layout_ctx_t *ctx,
+                               zdwm_layout_result_t *out);
+
+static inline void zdwm_layout_result_reset(zdwm_layout_result_t *result) {
+  if (!result) abort();
+  result->item_count = 0;
+}
+
+static inline void zdwm_layout_result_push(zdwm_layout_result_t *result,
+                                           zdwm_layout_item_t item) {
+  if (!result) abort();
+
+  if (result->item_count == result->item_capacity) {
+    size_t capacity = result->item_capacity ? result->item_capacity * 2u : 4u;
+    zdwm_layout_item_t *items =
+      realloc(result->items, capacity * sizeof(*result->items));
+    if (!items) abort();
+    result->items = items;
+    result->item_capacity = capacity;
+  }
+
+  result->items[result->item_count++] = item;
+}
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif /* ZDWM_LAYOUT_H */
diff --git a/include/zdwm/types.h b/include/zdwm/types.h
new file mode 100644
index 0000000..c010174
--- /dev/null
+++ b/include/zdwm/types.h
@@ -0,0 +1,36 @@
+#ifndef ZDWM_TYPES_H
+#define ZDWM_TYPES_H
+
+#include <stdint.h>
+
+#if defined(__cplusplus)
+extern "C" {
+#endif
+
+typedef uint32_t zdwm_layout_id_t;
+typedef uint32_t zdwm_window_id_t;
+typedef uint32_t zdwm_workspace_id_t;
+
+/* clang-format off */
+#define ZDWM_LAYOUT_ID_INVALID      ((zdwm_layout_id_t)UINT32_MAX)
+#define ZDWM_WINDOW_ID_INVALID      ((zdwm_window_id_t)0)
+#define ZDWM_WORKSPACE_ID_INVALID   ((zdwm_workspace_id_t)UINT32_MAX)
+/* clang-format on */
+
+typedef struct zdwm_rect_t {
+  int32_t x;
+  int32_t y;
+  int32_t width;
+  int32_t height;
+} zdwm_rect_t;
+
+typedef struct zdwm_output_info_t {
+  const char *name;
+  zdwm_rect_t geometry;
+} zdwm_output_info_t;
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif /* ZDWM_TYPES_H */