konpeito 0.1.0

data/lib/konpeito/stdlib/ui/konpeito_ui_native.h

@@ -0,0 +1,162 @@
+/*
+ * Konpeito UI Native - SDL3 + Skia C API header
+ *
+ * Provides window management, event polling, and 2D drawing
+ * for the Castella UI framework on the LLVM backend.
+ */
+
+#ifndef KONPEITO_UI_NATIVE_H
+#define KONPEITO_UI_NATIVE_H
+
+#include <stdint.h>
+#include <stdbool.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* Opaque handle to the UI context (window + canvas + event queue) */
+typedef struct KUIContext KUIContext;
+
+/* --- Event types (matches JWM/Castella conventions) --- */
+#define KUI_EVENT_NONE          0
+#define KUI_EVENT_MOUSE_DOWN    1
+#define KUI_EVENT_MOUSE_UP      2
+#define KUI_EVENT_MOUSE_MOVE    3
+#define KUI_EVENT_MOUSE_WHEEL   4
+#define KUI_EVENT_KEY_DOWN      5
+#define KUI_EVENT_KEY_UP        6
+#define KUI_EVENT_TEXT_INPUT    7
+#define KUI_EVENT_RESIZE        8
+#define KUI_EVENT_IME_PREEDIT   9
+#define KUI_EVENT_QUIT         10
+
+/* --- Key modifier flags (matches JWM conventions) --- */
+#define KUI_MOD_SHIFT    1
+#define KUI_MOD_CONTROL  2
+#define KUI_MOD_ALT      4
+#define KUI_MOD_SUPER    8  /* Command on macOS */
+
+/* --- Event ring buffer entry --- */
+typedef struct {
+    int type;
+    double x, y;           /* mouse position or scroll delta */
+    double dx, dy;         /* scroll delta for wheel events */
+    int button;            /* mouse button (0=left, 1=middle, 2=right) */
+    int key_code;          /* JWM-compatible key ordinal */
+    int modifiers;         /* modifier flags */
+    char text[128];        /* text input or IME preedit text */
+    int ime_sel_start;     /* IME selection start */
+    int ime_sel_end;       /* IME selection end */
+} KUIEvent;
+
+/* Max events in ring buffer */
+#define KUI_EVENT_BUFFER_SIZE 256
+
+/* --- Window management --- */
+KUIContext* kui_create_window(const char* title, int width, int height);
+void        kui_destroy_window(KUIContext* ctx);
+void        kui_step(KUIContext* ctx);  /* Poll SDL events into ring buffer */
+
+/* --- Event access (scalar field getters, no struct passing) --- */
+bool kui_has_event(KUIContext* ctx);
+int  kui_event_type(KUIContext* ctx);
+double kui_event_x(KUIContext* ctx);
+double kui_event_y(KUIContext* ctx);
+double kui_event_dx(KUIContext* ctx);
+double kui_event_dy(KUIContext* ctx);
+int  kui_event_button(KUIContext* ctx);
+int  kui_event_key_code(KUIContext* ctx);
+int  kui_event_modifiers(KUIContext* ctx);
+const char* kui_event_text(KUIContext* ctx);
+int  kui_event_ime_sel_start(KUIContext* ctx);
+int  kui_event_ime_sel_end(KUIContext* ctx);
+void kui_consume_event(KUIContext* ctx);
+
+/* --- Frame management (Skia canvas begin/end) --- */
+void kui_begin_frame(KUIContext* ctx);
+void kui_end_frame(KUIContext* ctx);
+
+/* --- Drawing primitives --- */
+void kui_clear(KUIContext* ctx, uint32_t color);
+void kui_fill_rect(KUIContext* ctx, double x, double y, double w, double h, uint32_t color);
+void kui_stroke_rect(KUIContext* ctx, double x, double y, double w, double h, uint32_t color, double stroke_width);
+void kui_fill_round_rect(KUIContext* ctx, double x, double y, double w, double h, double r, uint32_t color);
+void kui_stroke_round_rect(KUIContext* ctx, double x, double y, double w, double h, double r, uint32_t color, double stroke_width);
+void kui_fill_circle(KUIContext* ctx, double cx, double cy, double r, uint32_t color);
+void kui_stroke_circle(KUIContext* ctx, double cx, double cy, double r, uint32_t color, double stroke_width);
+void kui_draw_line(KUIContext* ctx, double x1, double y1, double x2, double y2, uint32_t color, double width);
+void kui_fill_arc(KUIContext* ctx, double cx, double cy, double r, double start_angle, double sweep_angle, uint32_t color);
+void kui_stroke_arc(KUIContext* ctx, double cx, double cy, double r, double start_angle, double sweep_angle, uint32_t color, double stroke_width);
+void kui_fill_triangle(KUIContext* ctx, double x1, double y1, double x2, double y2, double x3, double y3, uint32_t color);
+
+/* --- Text drawing --- */
+void kui_draw_text(KUIContext* ctx, const char* text, double x, double y,
+                   const char* font_family, double font_size, uint32_t color);
+void kui_draw_text_styled(KUIContext* ctx, const char* text, double x, double y,
+                          const char* font_family, double font_size, uint32_t color,
+                          int weight, int slant);
+
+/* --- Text measurement --- */
+double kui_measure_text_width(KUIContext* ctx, const char* text, const char* font_family, double font_size);
+double kui_measure_text_height(KUIContext* ctx, const char* font_family, double font_size);
+double kui_get_text_ascent(KUIContext* ctx, const char* font_family, double font_size);
+
+/* --- Path drawing --- */
+void kui_begin_path(KUIContext* ctx);
+void kui_path_move_to(KUIContext* ctx, double x, double y);
+void kui_path_line_to(KUIContext* ctx, double x, double y);
+void kui_close_fill_path(KUIContext* ctx, uint32_t color);
+void kui_fill_path(KUIContext* ctx, uint32_t color);
+
+/* --- Canvas state --- */
+void kui_save(KUIContext* ctx);
+void kui_restore(KUIContext* ctx);
+void kui_translate(KUIContext* ctx, double dx, double dy);
+void kui_clip_rect(KUIContext* ctx, double x, double y, double w, double h);
+
+/* --- Image operations --- */
+int    kui_load_image(KUIContext* ctx, const char* path);
+int    kui_load_net_image(KUIContext* ctx, const char* url);
+void   kui_draw_image(KUIContext* ctx, int image_id, double x, double y, double w, double h);
+double kui_get_image_width(KUIContext* ctx, int image_id);
+double kui_get_image_height(KUIContext* ctx, int image_id);
+
+/* --- Color utilities --- */
+uint32_t kui_interpolate_color(uint32_t c1, uint32_t c2, double t);
+uint32_t kui_with_alpha(uint32_t color, int alpha);
+uint32_t kui_lighten_color(uint32_t color, double amount);
+uint32_t kui_darken_color(uint32_t color, double amount);
+
+/* --- Window queries --- */
+double kui_get_width(KUIContext* ctx);
+double kui_get_height(KUIContext* ctx);
+double kui_get_scale(KUIContext* ctx);
+bool   kui_is_dark_mode(KUIContext* ctx);
+void   kui_request_frame(KUIContext* ctx);
+void   kui_mark_dirty(KUIContext* ctx);
+
+/* --- IME / Text Input --- */
+void kui_set_text_input_enabled(KUIContext* ctx, bool enabled);
+void kui_set_text_input_rect(KUIContext* ctx, int x, int y, int w, int h);
+
+/* --- Clipboard --- */
+const char* kui_get_clipboard_text(KUIContext* ctx);
+void        kui_set_clipboard_text(KUIContext* ctx, const char* text);
+
+/* --- Utilities --- */
+int64_t kui_current_time_millis(void);
+const char* kui_number_to_string(double value);
+
+/* --- Math helpers (mirrors KUIRuntime.java) --- */
+double kui_math_cos(double radians);
+double kui_math_sin(double radians);
+double kui_math_sqrt(double value);
+double kui_math_atan2(double y, double x);
+double kui_math_abs(double value);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* KONPEITO_UI_NATIVE_H */

data/lib/konpeito/stdlib/ui/ui.rb

@@ -0,0 +1,318 @@
+# KonpeitoUI - Native UI runtime module (SDL3 + Skia)
+#
+# Ruby fallback stub for when the native extension is not available.
+# This module provides the same interface as the C++ extension but
+# raises an error when called, directing users to build the extension.
+
+module KonpeitoUI
+  # Event type constants
+  EVENT_NONE        = 0
+  EVENT_MOUSE_DOWN  = 1
+  EVENT_MOUSE_UP    = 2
+  EVENT_MOUSE_MOVE  = 3
+  EVENT_MOUSE_WHEEL = 4
+  EVENT_KEY_DOWN    = 5
+  EVENT_KEY_UP      = 6
+  EVENT_TEXT_INPUT  = 7
+  EVENT_RESIZE      = 8
+  EVENT_IME_PREEDIT = 9
+  EVENT_QUIT        = 10
+
+  # Modifier constants
+  MOD_SHIFT   = 1
+  MOD_CONTROL = 2
+  MOD_ALT     = 4
+  MOD_SUPER   = 8
+
+  class << self
+    def create_window(title, width, height)
+      raise_not_available
+    end
+
+    def destroy_window(handle)
+      raise_not_available
+    end
+
+    def step(handle)
+      raise_not_available
+    end
+
+    def has_event(handle)
+      raise_not_available
+    end
+
+    def event_type(handle)
+      raise_not_available
+    end
+
+    def event_x(handle)
+      raise_not_available
+    end
+
+    def event_y(handle)
+      raise_not_available
+    end
+
+    def event_dx(handle)
+      raise_not_available
+    end
+
+    def event_dy(handle)
+      raise_not_available
+    end
+
+    def event_button(handle)
+      raise_not_available
+    end
+
+    def event_key_code(handle)
+      raise_not_available
+    end
+
+    def event_modifiers(handle)
+      raise_not_available
+    end
+
+    def event_text(handle)
+      raise_not_available
+    end
+
+    def event_ime_sel_start(handle)
+      raise_not_available
+    end
+
+    def event_ime_sel_end(handle)
+      raise_not_available
+    end
+
+    def consume_event(handle)
+      raise_not_available
+    end
+
+    def begin_frame(handle)
+      raise_not_available
+    end
+
+    def end_frame(handle)
+      raise_not_available
+    end
+
+    def clear(handle, color)
+      raise_not_available
+    end
+
+    def fill_rect(handle, x, y, w, h, color)
+      raise_not_available
+    end
+
+    def stroke_rect(handle, x, y, w, h, color, stroke_width)
+      raise_not_available
+    end
+
+    def fill_round_rect(handle, x, y, w, h, r, color)
+      raise_not_available
+    end
+
+    def stroke_round_rect(handle, x, y, w, h, r, color, stroke_width)
+      raise_not_available
+    end
+
+    def fill_circle(handle, cx, cy, r, color)
+      raise_not_available
+    end
+
+    def stroke_circle(handle, cx, cy, r, color, stroke_width)
+      raise_not_available
+    end
+
+    def draw_line(handle, x1, y1, x2, y2, color, width)
+      raise_not_available
+    end
+
+    def fill_arc(handle, cx, cy, r, start_angle, sweep_angle, color)
+      raise_not_available
+    end
+
+    def stroke_arc(handle, cx, cy, r, start_angle, sweep_angle, color, stroke_width)
+      raise_not_available
+    end
+
+    def fill_triangle(handle, x1, y1, x2, y2, x3, y3, color)
+      raise_not_available
+    end
+
+    def draw_text(handle, text, x, y, font_family, font_size, color)
+      raise_not_available
+    end
+
+    def draw_text_styled(handle, text, x, y, font_family, font_size, color, weight, slant)
+      raise_not_available
+    end
+
+    def measure_text_width(handle, text, font_family, font_size)
+      raise_not_available
+    end
+
+    def measure_text_height(handle, font_family, font_size)
+      raise_not_available
+    end
+
+    def get_text_ascent(handle, font_family, font_size)
+      raise_not_available
+    end
+
+    def begin_path(handle)
+      raise_not_available
+    end
+
+    def path_move_to(handle, x, y)
+      raise_not_available
+    end
+
+    def path_line_to(handle, x, y)
+      raise_not_available
+    end
+
+    def close_fill_path(handle, color)
+      raise_not_available
+    end
+
+    def fill_path(handle, color)
+      raise_not_available
+    end
+
+    def save(handle)
+      raise_not_available
+    end
+
+    def restore(handle)
+      raise_not_available
+    end
+
+    def translate(handle, dx, dy)
+      raise_not_available
+    end
+
+    def clip_rect(handle, x, y, w, h)
+      raise_not_available
+    end
+
+    def load_image(handle, path)
+      raise_not_available
+    end
+
+    def load_net_image(handle, url)
+      raise_not_available
+    end
+
+    def draw_image(handle, image_id, x, y, w, h)
+      raise_not_available
+    end
+
+    def get_image_width(handle, image_id)
+      raise_not_available
+    end
+
+    def get_image_height(handle, image_id)
+      raise_not_available
+    end
+
+    def interpolate_color(c1, c2, t)
+      raise_not_available
+    end
+
+    def with_alpha(color, alpha)
+      raise_not_available
+    end
+
+    def lighten_color(color, amount)
+      raise_not_available
+    end
+
+    def darken_color(color, amount)
+      raise_not_available
+    end
+
+    def get_width(handle)
+      raise_not_available
+    end
+
+    def get_height(handle)
+      raise_not_available
+    end
+
+    def get_scale(handle)
+      raise_not_available
+    end
+
+    def is_dark_mode(handle)
+      raise_not_available
+    end
+
+    def request_frame(handle)
+      raise_not_available
+    end
+
+    def mark_dirty(handle)
+      raise_not_available
+    end
+
+    def set_text_input_enabled(handle, enabled)
+      raise_not_available
+    end
+
+    def set_text_input_rect(handle, x, y, w, h)
+      raise_not_available
+    end
+
+    def get_clipboard_text(handle)
+      raise_not_available
+    end
+
+    def set_clipboard_text(handle, text)
+      raise_not_available
+    end
+
+    def current_time_millis
+      (Time.now.to_f * 1000).to_i
+    end
+
+    def number_to_string(value)
+      value.to_s
+    end
+
+    def math_cos(radians)
+      Math.cos(radians)
+    end
+
+    def math_sin(radians)
+      Math.sin(radians)
+    end
+
+    def math_sqrt(value)
+      Math.sqrt(value)
+    end
+
+    def math_atan2(y, x)
+      Math.atan2(y, x)
+    end
+
+    def math_abs(value)
+      value.abs
+    end
+
+    private
+
+    def raise_not_available
+      raise RuntimeError, <<~MSG
+        KonpeitoUI native extension not available.
+        Build it with:
+          cd lib/konpeito/stdlib/ui && ruby extconf.rb && make
+
+        Prerequisites:
+          macOS: brew install sdl3 && export SKIA_DIR=/path/to/skia
+          Linux: sudo apt install libsdl3-dev && export SKIA_DIR=/path/to/skia
+      MSG
+    end
+  end
+end