novac 2.0.1 → 2.2.0

package/kits/kitx11/kitx11.js

@@ -0,0 +1,2472 @@
+'use strict';
+
+// ============================================================
+//  kitx11.js  —  Full X11 / Xlib reference in JavaScript
+//  Every constant, every atom, every keysym, every color.
+//
+//  Cross-platform fixes applied:
+//    1. Runtime byte-order detection — works on big-endian hosts.
+//    2. buildConnectionRequest supports MIT-MAGIC-COOKIE-1 auth.
+//    3. Extension negotiation helper (queryExtension / assertExtension).
+//    4. Dual CJS + ESM export shim — works in Node.js and browsers.
+//
+//  Exports (CJS):  const { kitdef } = require('./kitx11.js')
+//  Exports (ESM):  import { kitdef } from './kitx11.js'
+// ============================================================
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 1: PROTOCOL FUNDAMENTALS
+// ────────────────────────────────────────────────────────────
+
+/** X11 protocol version */
+const PROTOCOL = { MAJOR: 11, MINOR: 0 };
+
+/** X11 connection byte order markers */
+const ByteOrder = { LSB_FIRST: 0x6C, MSB_FIRST: 0x42 }; // 'l' and 'B'
+
+/** Special resource IDs */
+const XID = {
+  NONE:        0,
+  COPY_FROM_PARENT: 0,
+  PARENT_RELATIVE:  1,
+  ALL_TEMPORARY:    2,
+};
+
+/** Boolean constants */
+const XBool = { FALSE: 0, TRUE: 1 };
+
+/** Time constants */
+const Time = {
+  CURRENT_TIME:   0,
+  LAST_KNOWN_TIME:1,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 2: EVENT TYPES
+// ────────────────────────────────────────────────────────────
+
+const EventType = {
+  KEY_PRESS:          2,
+  KEY_RELEASE:        3,
+  BUTTON_PRESS:       4,
+  BUTTON_RELEASE:     5,
+  MOTION_NOTIFY:      6,
+  ENTER_NOTIFY:       7,
+  LEAVE_NOTIFY:       8,
+  FOCUS_IN:           9,
+  FOCUS_OUT:          10,
+  KEYMAP_NOTIFY:      11,
+  EXPOSE:             12,
+  GRAPHICS_EXPOSE:    13,
+  NO_EXPOSE:          14,
+  VISIBILITY_NOTIFY:  15,
+  CREATE_NOTIFY:      16,
+  DESTROY_NOTIFY:     17,
+  UNMAP_NOTIFY:       18,
+  MAP_NOTIFY:         19,
+  MAP_REQUEST:        20,
+  REPARENT_NOTIFY:    21,
+  CONFIGURE_NOTIFY:   22,
+  CONFIGURE_REQUEST:  23,
+  GRAVITY_NOTIFY:     24,
+  RESIZE_REQUEST:     25,
+  CIRCULATE_NOTIFY:   26,
+  CIRCULATE_REQUEST:  27,
+  PROPERTY_NOTIFY:    28,
+  SELECTION_CLEAR:    29,
+  SELECTION_REQUEST:  30,
+  SELECTION_NOTIFY:   31,
+  COLORMAP_NOTIFY:    32,
+  CLIENT_MESSAGE:     33,
+  MAPPING_NOTIFY:     34,
+  GENERIC_EVENT:      35,
+  LAST_EVENT:         36,
+};
+
+/** Reverse map: event number → name */
+const EventTypeName = Object.fromEntries(Object.entries(EventType).map(([k,v])=>[v,k]));
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 3: EVENT MASKS
+// ────────────────────────────────────────────────────────────
+
+const EventMask = {
+  NO_EVENT_MASK:              0,
+  KEY_PRESS_MASK:             (1 << 0),
+  KEY_RELEASE_MASK:           (1 << 1),
+  BUTTON_PRESS_MASK:          (1 << 2),
+  BUTTON_RELEASE_MASK:        (1 << 3),
+  ENTER_WINDOW_MASK:          (1 << 4),
+  LEAVE_WINDOW_MASK:          (1 << 5),
+  POINTER_MOTION_MASK:        (1 << 6),
+  POINTER_MOTION_HINT_MASK:   (1 << 7),
+  BUTTON1_MOTION_MASK:        (1 << 8),
+  BUTTON2_MOTION_MASK:        (1 << 9),
+  BUTTON3_MOTION_MASK:        (1 << 10),
+  BUTTON4_MOTION_MASK:        (1 << 11),
+  BUTTON5_MOTION_MASK:        (1 << 12),
+  BUTTON_MOTION_MASK:         (1 << 13),
+  KEYMAP_STATE_MASK:          (1 << 14),
+  EXPOSURE_MASK:              (1 << 15),
+  VISIBILITY_CHANGE_MASK:     (1 << 16),
+  STRUCTURE_NOTIFY_MASK:      (1 << 17),
+  RESIZE_REDIRECT_MASK:       (1 << 18),
+  SUBSTRUCTURE_NOTIFY_MASK:   (1 << 19),
+  SUBSTRUCTURE_REDIRECT_MASK: (1 << 20),
+  FOCUS_CHANGE_MASK:          (1 << 21),
+  PROPERTY_CHANGE_MASK:       (1 << 22),
+  COLORMAP_CHANGE_MASK:       (1 << 23),
+  OWNER_GRAB_BUTTON_MASK:     (1 << 24),
+};
+
+/** Decode an event mask bitmask into an array of flag names */
+function decodeEventMask(mask) {
+  return Object.entries(EventMask).filter(([,v]) => v && (mask & v) === v).map(([k]) => k);
+}
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 4: REQUEST OPCODES
+// ────────────────────────────────────────────────────────────
+
+const Request = {
+  CREATE_WINDOW:                1,
+  CHANGE_WINDOW_ATTRIBUTES:     2,
+  GET_WINDOW_ATTRIBUTES:        3,
+  DESTROY_WINDOW:               4,
+  DESTROY_SUBWINDOWS:           5,
+  CHANGE_SAVE_SET:              6,
+  REPARENT_WINDOW:              7,
+  MAP_WINDOW:                   8,
+  MAP_SUBWINDOWS:               9,
+  UNMAP_WINDOW:                 10,
+  UNMAP_SUBWINDOWS:             11,
+  CONFIGURE_WINDOW:             12,
+  CIRCULATE_WINDOW:             13,
+  GET_GEOMETRY:                 14,
+  QUERY_TREE:                   15,
+  INTERN_ATOM:                  16,
+  GET_ATOM_NAME:                17,
+  CHANGE_PROPERTY:              18,
+  DELETE_PROPERTY:              19,
+  GET_PROPERTY:                 20,
+  LIST_PROPERTIES:              21,
+  SET_SELECTION_OWNER:          22,
+  GET_SELECTION_OWNER:          23,
+  CONVERT_SELECTION:            24,
+  SEND_EVENT:                   25,
+  GRAB_POINTER:                 26,
+  UNGRAB_POINTER:               27,
+  GRAB_BUTTON:                  28,
+  UNGRAB_BUTTON:                29,
+  CHANGE_ACTIVE_POINTER_GRAB:   30,
+  GRAB_KEYBOARD:                31,
+  UNGRAB_KEYBOARD:              32,
+  GRAB_KEY:                     33,
+  UNGRAB_KEY:                   34,
+  ALLOW_EVENTS:                 35,
+  GRAB_SERVER:                  36,
+  UNGRAB_SERVER:                37,
+  QUERY_POINTER:                38,
+  GET_MOTION_EVENTS:            39,
+  TRANSLATE_COORDINATES:        40,
+  WARP_POINTER:                 41,
+  SET_INPUT_FOCUS:              42,
+  GET_INPUT_FOCUS:              43,
+  QUERY_KEYMAP:                 44,
+  OPEN_FONT:                    45,
+  CLOSE_FONT:                   46,
+  QUERY_FONT:                   47,
+  QUERY_TEXT_EXTENTS:           48,
+  LIST_FONTS:                   49,
+  LIST_FONTS_WITH_INFO:         50,
+  SET_FONT_PATH:                51,
+  GET_FONT_PATH:                52,
+  CREATE_PIXMAP:                53,
+  FREE_PIXMAP:                  54,
+  CREATE_GC:                    55,
+  CHANGE_GC:                    56,
+  COPY_GC:                      57,
+  SET_DASHES:                   58,
+  SET_CLIP_RECTANGLES:          59,
+  FREE_GC:                      60,
+  CLEAR_AREA:                   61,
+  COPY_AREA:                    62,
+  COPY_PLANE:                   63,
+  POLY_POINT:                   64,
+  POLY_LINE:                    65,
+  POLY_SEGMENT:                 66,
+  POLY_RECTANGLE:               67,
+  POLY_ARC:                     68,
+  FILL_POLY:                    69,
+  POLY_FILL_RECTANGLE:          70,
+  POLY_FILL_ARC:                71,
+  PUT_IMAGE:                    72,
+  GET_IMAGE:                    73,
+  POLY_TEXT_8:                  74,
+  POLY_TEXT_16:                 75,
+  IMAGE_TEXT_8:                 76,
+  IMAGE_TEXT_16:                77,
+  CREATE_COLORMAP:              78,
+  FREE_COLORMAP:                79,
+  COPY_COLORMAP_AND_FREE:       80,
+  INSTALL_COLORMAP:             81,
+  UNINSTALL_COLORMAP:           82,
+  LIST_INSTALLED_COLORMAPS:     83,
+  ALLOC_COLOR:                  84,
+  ALLOC_NAMED_COLOR:            85,
+  ALLOC_COLOR_CELLS:            86,
+  ALLOC_COLOR_PLANES:           87,
+  FREE_COLORS:                  88,
+  STORE_COLORS:                 89,
+  STORE_NAMED_COLOR:            90,
+  QUERY_COLORS:                 91,
+  LOOKUP_COLOR:                 92,
+  CREATE_CURSOR:                93,
+  CREATE_GLYPH_CURSOR:          94,
+  FREE_CURSOR:                  95,
+  RECOLOR_CURSOR:               96,
+  QUERY_BEST_SIZE:              97,
+  QUERY_EXTENSION:              98,
+  LIST_EXTENSIONS:              99,
+  CHANGE_KEYBOARD_MAPPING:      100,
+  GET_KEYBOARD_MAPPING:         101,
+  CHANGE_KEYBOARD_CONTROL:      102,
+  GET_KEYBOARD_CONTROL:         103,
+  BELL:                         104,
+  CHANGE_POINTER_CONTROL:       105,
+  GET_POINTER_CONTROL:          106,
+  SET_SCREEN_SAVER:             107,
+  GET_SCREEN_SAVER:             108,
+  CHANGE_HOSTS:                 109,
+  LIST_HOSTS:                   110,
+  SET_ACCESS_CONTROL:           111,
+  SET_CLOSE_DOWN_MODE:          112,
+  KILL_CLIENT:                  113,
+  ROTATE_PROPERTIES:            114,
+  FORCE_SCREEN_SAVER:           115,
+  SET_POINTER_MAPPING:          116,
+  GET_POINTER_MAPPING:          117,
+  SET_MODIFIER_MAPPING:         118,
+  GET_MODIFIER_MAPPING:         119,
+  NO_OPERATION:                 127,
+};
+
+const RequestName = Object.fromEntries(Object.entries(Request).map(([k,v])=>[v,k]));
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 5: ERROR CODES
+// ────────────────────────────────────────────────────────────
+
+const ErrorCode = {
+  SUCCESS:          0,
+  BAD_REQUEST:      1,
+  BAD_VALUE:        2,
+  BAD_WINDOW:       3,
+  BAD_PIXMAP:       4,
+  BAD_ATOM:         5,
+  BAD_CURSOR:       6,
+  BAD_FONT:         7,
+  BAD_MATCH:        8,
+  BAD_DRAWABLE:     9,
+  BAD_ACCESS:       10,
+  BAD_ALLOC:        11,
+  BAD_COLOR:        12,
+  BAD_GC:           13,
+  BAD_ID_CHOICE:    14,
+  BAD_NAME:         15,
+  BAD_LENGTH:       16,
+  BAD_IMPLEMENTATION:17,
+  FIRST_EXTENSION_ERROR: 128,
+  LAST_EXTENSION_ERROR:  255,
+};
+
+const ErrorName = Object.fromEntries(Object.entries(ErrorCode).map(([k,v])=>[v,k]));
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 6: WINDOW ATTRIBUTES & VALUES
+// ────────────────────────────────────────────────────────────
+
+/** Window attribute value masks (CW_ flags) */
+const CW = {
+  BACK_PIXMAP:       (1 << 0),
+  BACK_PIXEL:        (1 << 1),
+  BORDER_PIXMAP:     (1 << 2),
+  BORDER_PIXEL:      (1 << 3),
+  BIT_GRAVITY:       (1 << 4),
+  WIN_GRAVITY:       (1 << 5),
+  BACKING_STORE:     (1 << 6),
+  BACKING_PLANES:    (1 << 7),
+  BACKING_PIXEL:     (1 << 8),
+  OVERRIDE_REDIRECT: (1 << 9),
+  SAVE_UNDER:        (1 << 10),
+  EVENT_MASK:        (1 << 11),
+  DONT_PROPAGATE:    (1 << 12),
+  COLORMAP:          (1 << 13),
+  CURSOR:            (1 << 14),
+};
+
+/** Window classes */
+const WindowClass = {
+  COPY_FROM_PARENT: 0,
+  INPUT_OUTPUT:     1,
+  INPUT_ONLY:       2,
+};
+
+/** Map state */
+const MapState = {
+  IS_UNMAPPED:   0,
+  IS_UNVIEWABLE: 1,
+  IS_VIEWABLE:   2,
+};
+
+/** Backing store */
+const BackingStore = {
+  NOT_USEFUL:  0,
+  WHEN_MAPPED: 1,
+  ALWAYS:      2,
+};
+
+/** Bit gravity */
+const BitGravity = {
+  FORGET:    0,
+  NORTH_WEST:1,
+  NORTH:     2,
+  NORTH_EAST:3,
+  WEST:      4,
+  CENTER:    5,
+  EAST:      6,
+  SOUTH_WEST:7,
+  SOUTH:     8,
+  SOUTH_EAST:9,
+  STATIC:    10,
+};
+
+/** Window gravity */
+const WinGravity = {
+  UNMAP:     0,
+  NORTH_WEST:1,
+  NORTH:     2,
+  NORTH_EAST:3,
+  WEST:      4,
+  CENTER:    5,
+  EAST:      6,
+  SOUTH_WEST:7,
+  SOUTH:     8,
+  SOUTH_EAST:9,
+  STATIC:    10,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 7: GC (GRAPHICS CONTEXT) VALUES
+// ────────────────────────────────────────────────────────────
+
+/** GC value masks */
+const GCMask = {
+  FUNCTION:           (1 << 0),
+  PLANE_MASK:         (1 << 1),
+  FOREGROUND:         (1 << 2),
+  BACKGROUND:         (1 << 3),
+  LINE_WIDTH:         (1 << 4),
+  LINE_STYLE:         (1 << 5),
+  CAP_STYLE:          (1 << 6),
+  JOIN_STYLE:         (1 << 7),
+  FILL_STYLE:         (1 << 8),
+  FILL_RULE:          (1 << 9),
+  TILE:               (1 << 10),
+  STIPPLE:            (1 << 11),
+  TILE_STIPPLE_X_ORIGIN:(1 << 12),
+  TILE_STIPPLE_Y_ORIGIN:(1 << 13),
+  FONT:               (1 << 14),
+  SUBWINDOW_MODE:     (1 << 15),
+  GRAPHICS_EXPOSURES: (1 << 16),
+  CLIP_X_ORIGIN:      (1 << 17),
+  CLIP_Y_ORIGIN:      (1 << 18),
+  CLIP_MASK:          (1 << 19),
+  DASH_OFFSET:        (1 << 20),
+  DASH_LIST:          (1 << 21),
+  ARC_MODE:           (1 << 22),
+  LAST_GC:            (1 << 23),
+};
+
+/** GC function (logical drawing operations) */
+const GCFunction = {
+  CLEAR:         0,   // 0
+  AND:           1,   // src AND dst
+  AND_REVERSE:   2,   // src AND NOT dst
+  COPY:          3,   // src
+  AND_INVERTED:  4,   // NOT src AND dst
+  NOOP:          5,   // dst
+  XOR:           6,   // src XOR dst
+  OR:            7,   // src OR dst
+  NOR:           8,   // NOT (src OR dst)
+  EQUIV:         9,   // NOT (src XOR dst)
+  INVERT:        10,  // NOT dst
+  OR_REVERSE:    11,  // src OR NOT dst
+  COPY_INVERTED: 12,  // NOT src
+  OR_INVERTED:   13,  // NOT src OR dst
+  NAND:          14,  // NOT (src AND dst)
+  SET:           15,  // 1
+};
+
+/** Line style */
+const LineStyle = {
+  SOLID:       0,
+  ON_OFF_DASH: 1,
+  DOUBLE_DASH: 2,
+};
+
+/** Cap style */
+const CapStyle = {
+  NOT_LAST: 0,
+  BUTT:     1,
+  ROUND:    2,
+  PROJECTING:3,
+};
+
+/** Join style */
+const JoinStyle = {
+  MITER: 0,
+  ROUND: 1,
+  BEVEL: 2,
+};
+
+/** Fill style */
+const FillStyle = {
+  SOLID:          0,
+  TILED:          1,
+  STIPPLED:       2,
+  OPAQUE_STIPPLED:3,
+};
+
+/** Fill rule */
+const FillRule = {
+  EVEN_ODD_RULE: 0,
+  WINDING_RULE:  1,
+};
+
+/** Arc mode */
+const ArcMode = {
+  CHORD:     0,
+  PIE_SLICE: 1,
+};
+
+/** Subwindow mode */
+const SubwindowMode = {
+  CLIP_BY_CHILDREN:   0,
+  INCLUDE_INFERIORS:  1,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 8: POINTER / KEYBOARD / INPUT
+// ────────────────────────────────────────────────────────────
+
+/** Modifier key masks */
+const ModifierMask = {
+  SHIFT_MASK:   (1 << 0),
+  LOCK_MASK:    (1 << 1),
+  CONTROL_MASK: (1 << 2),
+  MOD1_MASK:    (1 << 3),  // usually Alt
+  MOD2_MASK:    (1 << 4),  // usually NumLock
+  MOD3_MASK:    (1 << 5),
+  MOD4_MASK:    (1 << 6),  // usually Super/Win
+  MOD5_MASK:    (1 << 7),  // usually AltGr
+  BUTTON1_MASK: (1 << 8),
+  BUTTON2_MASK: (1 << 9),
+  BUTTON3_MASK: (1 << 10),
+  BUTTON4_MASK: (1 << 11),
+  BUTTON5_MASK: (1 << 12),
+  ANY_MODIFIER: 0x8000,
+};
+
+/** Mouse button numbers */
+const Button = { B1: 1, B2: 2, B3: 3, B4: 4, B5: 5, ANY: 0 };
+
+/** Input focus modes */
+const FocusMode = {
+  NORMAL:          0,
+  GRAB:            1,
+  UNGRAB:          2,
+  WHILE_GRABBED:   3,
+};
+
+/** Input focus revert-to */
+const RevertTo = {
+  NONE:          0,
+  POINTER_ROOT:  1,
+  PARENT:        2,
+};
+
+/** Grab modes */
+const GrabMode = {
+  SYNC:  0,
+  ASYNC: 1,
+};
+
+/** Grab status */
+const GrabStatus = {
+  GRAB_SUCCESS:    0,
+  ALREADY_GRABBED: 1,
+  GRAB_INVALID_TIME:2,
+  GRAB_NOT_VIEWABLE:3,
+  GRAB_FROZEN:     4,
+};
+
+/** Allow-events modes */
+const AllowEvents = {
+  ASYNC_POINTER:   0,
+  SYNC_POINTER:    1,
+  REPLAY_POINTER:  2,
+  ASYNC_KEYBOARD:  3,
+  SYNC_KEYBOARD:   4,
+  REPLAY_KEYBOARD: 5,
+  ASYNC_BOTH:      6,
+  SYNC_BOTH:       7,
+};
+
+/** Notify modes (EnterNotify, FocusIn, etc.) */
+const NotifyMode = {
+  NORMAL:          0,
+  GRAB:            1,
+  UNGRAB:          2,
+  WHILE_GRABBED:   3,
+};
+
+/** Notify detail */
+const NotifyDetail = {
+  ANCESTOR:          0,
+  VIRTUAL:           1,
+  INFERIOR:          2,
+  NONLINEAR:         3,
+  NONLINEAR_VIRTUAL: 4,
+  POINTER:           5,
+  POINTER_ROOT:      6,
+  DETAIL_NONE:       7,
+};
+
+/** Visibility state */
+const Visibility = {
+  UNOBSCURED:        0,
+  PARTIALLY_OBSCURED:1,
+  FULLY_OBSCURED:    2,
+};
+
+/** Circulate direction */
+const Circulate = {
+  RAISE_LOWEST:  0,
+  LOWER_HIGHEST: 1,
+};
+
+/** Property state (PropertyNotify) */
+const PropertyState = {
+  NEW_VALUE: 0,
+  DELETED:   1,
+};
+
+/** Colormap state */
+const ColormapState = {
+  UNINSTALLED: 0,
+  INSTALLED:   1,
+};
+
+/** Mapping request */
+const MappingRequest = {
+  MODIFIER: 0,
+  KEYBOARD: 1,
+  POINTER:  2,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 9: SCREEN SAVER & POWER
+// ────────────────────────────────────────────────────────────
+
+const ScreenSaver = {
+  RESET:  0,
+  ACTIVE: 1,
+};
+
+const ScreenSaverState = {
+  OFF:      0,
+  ON:       1,
+  CYCLE:    2,
+  DISABLED: 3,
+};
+
+const ScreenSaverKind = {
+  BLANKED:   0,
+  INTERNAL:  1,
+  EXTERNAL:  2,
+};
+
+const Blanking = {
+  DONT_PREFER_BLANKING: 0,
+  PREFER_BLANKING:      1,
+  DEFAULT_BLANKING:     2,
+};
+
+const Exposures = {
+  DONT_ALLOW_EXPOSURES: 0,
+  ALLOW_EXPOSURES:      1,
+  DEFAULT_EXPOSURES:    2,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 10: HOST ACCESS
+// ────────────────────────────────────────────────────────────
+
+const HostFamily = {
+  INTERNET:       0,
+  DECnet:         1,
+  CHAOS:          2,
+  SERVER_INTERPRETED: 5,
+  INTERNET6:      6,
+};
+
+const AccessControl = {
+  DISABLE: 0,
+  ENABLE:  1,
+};
+
+const CloseDownMode = {
+  DESTROY_ALL:      0,
+  RETAIN_PERMANENT: 1,
+  RETAIN_TEMPORARY: 2,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 11: COLORMAP
+// ────────────────────────────────────────────────────────────
+
+const ColormapAlloc = {
+  ALLOC_NONE: 0,
+  ALLOC_ALL:  1,
+};
+
+const VisualClass = {
+  STATIC_GRAY:   0,
+  GRAY_SCALE:    1,
+  STATIC_COLOR:  2,
+  PSEUDO_COLOR:  3,
+  TRUE_COLOR:    4,
+  DIRECT_COLOR:  5,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 12: IMAGE / PIXMAP
+// ────────────────────────────────────────────────────────────
+
+const ImageFormat = {
+  XY_BITMAP: 0,
+  XY_PIXMAP: 1,
+  Z_PIXMAP:  2,
+};
+
+const BitmapBitOrder = {
+  LSB_FIRST: 0,
+  MSB_FIRST: 1,
+};
+
+const ByteOrderConst = {
+  LSB_FIRST: 0,
+  MSB_FIRST: 1,
+};
+
+const QueryBestSizeClass = {
+  CURSOR: 0,
+  TILE:   1,
+  STIPPLE:2,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 13: BUILT-IN ATOMS
+// ────────────────────────────────────────────────────────────
+
+/** Predefined atom IDs (XA_ constants) */
+const Atom = {
+  NONE:               0,
+  ANY:                0,
+  PRIMARY:            1,
+  SECONDARY:          2,
+  ARC:                3,
+  ATOM:               4,
+  BITMAP:             5,
+  CARDINAL:           6,
+  COLORMAP:           7,
+  CURSOR:             8,
+  CUT_BUFFER0:        9,
+  CUT_BUFFER1:        10,
+  CUT_BUFFER2:        11,
+  CUT_BUFFER3:        12,
+  CUT_BUFFER4:        13,
+  CUT_BUFFER5:        14,
+  CUT_BUFFER6:        15,
+  CUT_BUFFER7:        16,
+  DRAWABLE:           17,
+  FONT:               18,
+  INTEGER:            19,
+  PIXMAP:             20,
+  POINT:              21,
+  RECTANGLE:          22,
+  RESOURCE_MANAGER:   23,
+  RGB_COLOR_MAP:      24,
+  RGB_BEST_MAP:       25,
+  RGB_BLUE_MAP:       26,
+  RGB_DEFAULT_MAP:    27,
+  RGB_GRAY_MAP:       28,
+  RGB_GREEN_MAP:      29,
+  RGB_RED_MAP:        30,
+  STRING:             31,
+  VISUALID:           32,
+  WINDOW:             33,
+  WM_COMMAND:         34,
+  WM_HINTS:           35,
+  WM_CLIENT_MACHINE:  36,
+  WM_ICON_NAME:       37,
+  WM_ICON_SIZE:       38,
+  WM_NAME:            39,
+  WM_NORMAL_HINTS:    40,
+  WM_SIZE_HINTS:      41,
+  WM_ZOOM_HINTS:      42,
+  MIN_SPACE:          43,
+  NORM_SPACE:         44,
+  MAX_SPACE:          45,
+  END_SPACE:          46,
+  SUPERSCRIPT_X:      47,
+  SUPERSCRIPT_Y:      48,
+  SUBSCRIPT_X:        49,
+  SUBSCRIPT_Y:        50,
+  UNDERLINE_POSITION: 51,
+  UNDERLINE_THICKNESS:52,
+  STRIKEOUT_ASCENT:   53,
+  STRIKEOUT_DESCENT:  54,
+  ITALIC_ANGLE:       55,
+  X_HEIGHT:           56,
+  QUAD_WIDTH:         57,
+  WEIGHT:             58,
+  POINT_SIZE:         59,
+  RESOLUTION:         60,
+  COPYRIGHT:          61,
+  NOTICE:             62,
+  FONT_NAME:          63,
+  FAMILY_NAME:        64,
+  FULL_NAME:          65,
+  CAP_HEIGHT:         66,
+  WM_CLASS:           67,
+  WM_TRANSIENT_FOR:   68,
+  LAST_PREDEFINED:    68,
+};
+
+const AtomName = Object.fromEntries(Object.entries(Atom).map(([k,v])=>[v,k]));
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 14: ICCCM PROPERTY NAMES
+// ────────────────────────────────────────────────────────────
+
+/** ICCCM (Inter-Client Communication Conventions Manual) atom name strings */
+const ICCCM = {
+  // WM Protocols
+  WM_PROTOCOLS:               'WM_PROTOCOLS',
+  WM_DELETE_WINDOW:           'WM_DELETE_WINDOW',
+  WM_TAKE_FOCUS:              'WM_TAKE_FOCUS',
+  WM_SAVE_YOURSELF:           'WM_SAVE_YOURSELF',
+
+  // Window manager hints
+  WM_NAME:                    'WM_NAME',
+  WM_ICON_NAME:               'WM_ICON_NAME',
+  WM_NORMAL_HINTS:            'WM_NORMAL_HINTS',
+  WM_HINTS:                   'WM_HINTS',
+  WM_CLASS:                   'WM_CLASS',
+  WM_TRANSIENT_FOR:           'WM_TRANSIENT_FOR',
+  WM_COMMAND:                 'WM_COMMAND',
+  WM_CLIENT_MACHINE:          'WM_CLIENT_MACHINE',
+  WM_ICON_SIZE:               'WM_ICON_SIZE',
+  WM_STATE:                   'WM_STATE',
+  WM_CHANGE_STATE:            'WM_CHANGE_STATE',
+  WM_COLORMAP_WINDOWS:        'WM_COLORMAP_WINDOWS',
+  WM_COLORMAP_NOTIFY:         'WM_COLORMAP_NOTIFY',
+  WM_CLIENT_LEADER:           'WM_CLIENT_LEADER',
+  WM_WINDOW_ROLE:             'WM_WINDOW_ROLE',
+
+  // Selections
+  PRIMARY:                    'PRIMARY',
+  SECONDARY:                  'SECONDARY',
+  CLIPBOARD:                  'CLIPBOARD',
+  CLIPBOARD_MANAGER:          'CLIPBOARD_MANAGER',
+  SAVE_TARGETS:               'SAVE_TARGETS',
+
+  // Selection targets
+  TARGETS:                    'TARGETS',
+  MULTIPLE:                   'MULTIPLE',
+  TIMESTAMP:                  'TIMESTAMP',
+  INCR:                       'INCR',
+  TEXT:                       'TEXT',
+  COMPOUND_TEXT:              'COMPOUND_TEXT',
+  UTF8_STRING:                'UTF8_STRING',
+  STRING:                     'STRING',
+
+  // Cut buffers
+  CUT_BUFFER0:                'CUT_BUFFER0',
+  CUT_BUFFER1:                'CUT_BUFFER1',
+  CUT_BUFFER2:                'CUT_BUFFER2',
+  CUT_BUFFER3:                'CUT_BUFFER3',
+  CUT_BUFFER4:                'CUT_BUFFER4',
+  CUT_BUFFER5:                'CUT_BUFFER5',
+  CUT_BUFFER6:                'CUT_BUFFER6',
+  CUT_BUFFER7:                'CUT_BUFFER7',
+
+  // Types
+  ATOM:                       'ATOM',
+  CARDINAL:                   'CARDINAL',
+  INTEGER:                    'INTEGER',
+  WINDOW:                     'WINDOW',
+  PIXMAP:                     'PIXMAP',
+  BITMAP:                     'BITMAP',
+  STRING:                     'STRING',
+};
+
+/** WM_STATE values */
+const WMState = {
+  WITHDRAWN: 0,
+  NORMAL:    1,
+  ICONIC:    3,
+};
+
+/** WM_HINTS flags */
+const WMHints = {
+  INPUT_HINT:         (1 << 0),
+  STATE_HINT:         (1 << 1),
+  ICON_PIXMAP_HINT:   (1 << 2),
+  ICON_WINDOW_HINT:   (1 << 3),
+  ICON_POSITION_HINT: (1 << 4),
+  ICON_MASK_HINT:     (1 << 5),
+  WINDOW_GROUP_HINT:  (1 << 6),
+  MESSAGE_HINT:       (1 << 7),
+  URGENCY_HINT:       (1 << 8),
+};
+
+/** WM_SIZE_HINTS / WM_NORMAL_HINTS flags */
+const SizeHints = {
+  US_POSITION:   (1 << 0),
+  US_SIZE:       (1 << 1),
+  P_POSITION:    (1 << 2),
+  P_SIZE:        (1 << 3),
+  P_MIN_SIZE:    (1 << 4),
+  P_MAX_SIZE:    (1 << 5),
+  P_RESIZE_INC:  (1 << 6),
+  P_ASPECT:      (1 << 7),
+  P_BASE_SIZE:   (1 << 8),
+  P_WIN_GRAVITY: (1 << 9),
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 15: EWMH (_NET_) PROPERTY NAMES
+// ────────────────────────────────────────────────────────────
+
+/** Extended Window Manager Hints (EWMH / _NET_ atoms) */
+const EWMH = {
+  // Root window properties
+  _NET_SUPPORTED:                '_NET_SUPPORTED',
+  _NET_CLIENT_LIST:              '_NET_CLIENT_LIST',
+  _NET_CLIENT_LIST_STACKING:     '_NET_CLIENT_LIST_STACKING',
+  _NET_NUMBER_OF_DESKTOPS:       '_NET_NUMBER_OF_DESKTOPS',
+  _NET_DESKTOP_GEOMETRY:         '_NET_DESKTOP_GEOMETRY',
+  _NET_DESKTOP_VIEWPORT:         '_NET_DESKTOP_VIEWPORT',
+  _NET_CURRENT_DESKTOP:          '_NET_CURRENT_DESKTOP',
+  _NET_DESKTOP_NAMES:            '_NET_DESKTOP_NAMES',
+  _NET_ACTIVE_WINDOW:            '_NET_ACTIVE_WINDOW',
+  _NET_WORKAREA:                 '_NET_WORKAREA',
+  _NET_SUPPORTING_WM_CHECK:      '_NET_SUPPORTING_WM_CHECK',
+  _NET_VIRTUAL_ROOTS:            '_NET_VIRTUAL_ROOTS',
+  _NET_DESKTOP_LAYOUT:           '_NET_DESKTOP_LAYOUT',
+  _NET_SHOWING_DESKTOP:          '_NET_SHOWING_DESKTOP',
+
+  // Root window messages
+  _NET_CLOSE_WINDOW:             '_NET_CLOSE_WINDOW',
+  _NET_MOVERESIZE_WINDOW:        '_NET_MOVERESIZE_WINDOW',
+  _NET_WM_MOVERESIZE:            '_NET_WM_MOVERESIZE',
+  _NET_RESTACK_WINDOW:           '_NET_RESTACK_WINDOW',
+  _NET_REQUEST_FRAME_EXTENTS:    '_NET_REQUEST_FRAME_EXTENTS',
+
+  // Application window properties
+  _NET_WM_NAME:                  '_NET_WM_NAME',
+  _NET_WM_VISIBLE_NAME:          '_NET_WM_VISIBLE_NAME',
+  _NET_WM_ICON_NAME:             '_NET_WM_ICON_NAME',
+  _NET_WM_VISIBLE_ICON_NAME:     '_NET_WM_VISIBLE_ICON_NAME',
+  _NET_WM_DESKTOP:               '_NET_WM_DESKTOP',
+  _NET_WM_WINDOW_TYPE:           '_NET_WM_WINDOW_TYPE',
+  _NET_WM_STATE:                 '_NET_WM_STATE',
+  _NET_WM_ALLOWED_ACTIONS:       '_NET_WM_ALLOWED_ACTIONS',
+  _NET_WM_STRUT:                 '_NET_WM_STRUT',
+  _NET_WM_STRUT_PARTIAL:         '_NET_WM_STRUT_PARTIAL',
+  _NET_WM_ICON_GEOMETRY:         '_NET_WM_ICON_GEOMETRY',
+  _NET_WM_ICON:                  '_NET_WM_ICON',
+  _NET_WM_PID:                   '_NET_WM_PID',
+  _NET_WM_HANDLED_ICONS:         '_NET_WM_HANDLED_ICONS',
+  _NET_WM_USER_TIME:             '_NET_WM_USER_TIME',
+  _NET_WM_USER_TIME_WINDOW:      '_NET_WM_USER_TIME_WINDOW',
+  _NET_FRAME_EXTENTS:            '_NET_FRAME_EXTENTS',
+  _NET_WM_OPAQUE_REGION:         '_NET_WM_OPAQUE_REGION',
+  _NET_WM_BYPASS_COMPOSITOR:     '_NET_WM_BYPASS_COMPOSITOR',
+
+  // Window types
+  _NET_WM_WINDOW_TYPE_DESKTOP:   '_NET_WM_WINDOW_TYPE_DESKTOP',
+  _NET_WM_WINDOW_TYPE_DOCK:      '_NET_WM_WINDOW_TYPE_DOCK',
+  _NET_WM_WINDOW_TYPE_TOOLBAR:   '_NET_WM_WINDOW_TYPE_TOOLBAR',
+  _NET_WM_WINDOW_TYPE_MENU:      '_NET_WM_WINDOW_TYPE_MENU',
+  _NET_WM_WINDOW_TYPE_UTILITY:   '_NET_WM_WINDOW_TYPE_UTILITY',
+  _NET_WM_WINDOW_TYPE_SPLASH:    '_NET_WM_WINDOW_TYPE_SPLASH',
+  _NET_WM_WINDOW_TYPE_DIALOG:    '_NET_WM_WINDOW_TYPE_DIALOG',
+  _NET_WM_WINDOW_TYPE_DROPDOWN_MENU: '_NET_WM_WINDOW_TYPE_DROPDOWN_MENU',
+  _NET_WM_WINDOW_TYPE_POPUP_MENU:'_NET_WM_WINDOW_TYPE_POPUP_MENU',
+  _NET_WM_WINDOW_TYPE_TOOLTIP:   '_NET_WM_WINDOW_TYPE_TOOLTIP',
+  _NET_WM_WINDOW_TYPE_NOTIFICATION:'_NET_WM_WINDOW_TYPE_NOTIFICATION',
+  _NET_WM_WINDOW_TYPE_COMBO:     '_NET_WM_WINDOW_TYPE_COMBO',
+  _NET_WM_WINDOW_TYPE_DND:       '_NET_WM_WINDOW_TYPE_DND',
+  _NET_WM_WINDOW_TYPE_NORMAL:    '_NET_WM_WINDOW_TYPE_NORMAL',
+
+  // Window states
+  _NET_WM_STATE_MODAL:           '_NET_WM_STATE_MODAL',
+  _NET_WM_STATE_STICKY:          '_NET_WM_STATE_STICKY',
+  _NET_WM_STATE_MAXIMIZED_VERT:  '_NET_WM_STATE_MAXIMIZED_VERT',
+  _NET_WM_STATE_MAXIMIZED_HORZ:  '_NET_WM_STATE_MAXIMIZED_HORZ',
+  _NET_WM_STATE_SHADED:          '_NET_WM_STATE_SHADED',
+  _NET_WM_STATE_SKIP_TASKBAR:    '_NET_WM_STATE_SKIP_TASKBAR',
+  _NET_WM_STATE_SKIP_PAGER:      '_NET_WM_STATE_SKIP_PAGER',
+  _NET_WM_STATE_HIDDEN:          '_NET_WM_STATE_HIDDEN',
+  _NET_WM_STATE_FULLSCREEN:      '_NET_WM_STATE_FULLSCREEN',
+  _NET_WM_STATE_ABOVE:           '_NET_WM_STATE_ABOVE',
+  _NET_WM_STATE_BELOW:           '_NET_WM_STATE_BELOW',
+  _NET_WM_STATE_DEMANDS_ATTENTION:'_NET_WM_STATE_DEMANDS_ATTENTION',
+  _NET_WM_STATE_FOCUSED:         '_NET_WM_STATE_FOCUSED',
+
+  // Allowed actions
+  _NET_WM_ACTION_MOVE:           '_NET_WM_ACTION_MOVE',
+  _NET_WM_ACTION_RESIZE:         '_NET_WM_ACTION_RESIZE',
+  _NET_WM_ACTION_MINIMIZE:       '_NET_WM_ACTION_MINIMIZE',
+  _NET_WM_ACTION_SHADE:          '_NET_WM_ACTION_SHADE',
+  _NET_WM_ACTION_STICK:          '_NET_WM_ACTION_STICK',
+  _NET_WM_ACTION_MAXIMIZE_HORZ:  '_NET_WM_ACTION_MAXIMIZE_HORZ',
+  _NET_WM_ACTION_MAXIMIZE_VERT:  '_NET_WM_ACTION_MAXIMIZE_VERT',
+  _NET_WM_ACTION_FULLSCREEN:     '_NET_WM_ACTION_FULLSCREEN',
+  _NET_WM_ACTION_CHANGE_DESKTOP: '_NET_WM_ACTION_CHANGE_DESKTOP',
+  _NET_WM_ACTION_CLOSE:          '_NET_WM_ACTION_CLOSE',
+  _NET_WM_ACTION_ABOVE:          '_NET_WM_ACTION_ABOVE',
+  _NET_WM_ACTION_BELOW:          '_NET_WM_ACTION_BELOW',
+
+  // WM identification
+  _NET_WM_FULL_PLACEMENT:        '_NET_WM_FULL_PLACEMENT',
+  _NET_WM_PING:                  '_NET_WM_PING',
+  _NET_WM_SYNC_REQUEST:          '_NET_WM_SYNC_REQUEST',
+  _NET_WM_SYNC_REQUEST_COUNTER:  '_NET_WM_SYNC_REQUEST_COUNTER',
+  _NET_WM_FULLSCREEN_MONITORS:   '_NET_WM_FULLSCREEN_MONITORS',
+
+  // Startup notification
+  _NET_STARTUP_ID:               '_NET_STARTUP_ID',
+  _NET_STARTUP_INFO:             '_NET_STARTUP_INFO',
+  _NET_STARTUP_INFO_BEGIN:       '_NET_STARTUP_INFO_BEGIN',
+
+  // System tray
+  _NET_SYSTEM_TRAY_OPCODE:       '_NET_SYSTEM_TRAY_OPCODE',
+  _NET_SYSTEM_TRAY_VISUAL:       '_NET_SYSTEM_TRAY_VISUAL',
+  _NET_SYSTEM_TRAY_ORIENTATION:  '_NET_SYSTEM_TRAY_ORIENTATION',
+
+  // Desktop layout
+  _NET_DESKTOP_LAYOUT_ORIENTATION_HORZ: '_NET_DESKTOP_LAYOUT_ORIENTATION_HORZ',
+  _NET_DESKTOP_LAYOUT_ORIENTATION_VERT: '_NET_DESKTOP_LAYOUT_ORIENTATION_VERT',
+  _NET_DESKTOP_LAYOUT_TOPLEFT:   '_NET_DESKTOP_LAYOUT_TOPLEFT',
+  _NET_DESKTOP_LAYOUT_TOPRIGHT:  '_NET_DESKTOP_LAYOUT_TOPRIGHT',
+  _NET_DESKTOP_LAYOUT_BOTTOMRIGHT:'_NET_DESKTOP_LAYOUT_BOTTOMRIGHT',
+  _NET_DESKTOP_LAYOUT_BOTTOMLEFT:'_NET_DESKTOP_LAYOUT_BOTTOMLEFT',
+};
+
+/** _NET_WM_STATE action values */
+const EWMHStateAction = {
+  REMOVE: 0,
+  ADD:    1,
+  TOGGLE: 2,
+};
+
+/** _NET_WM_MOVERESIZE direction values */
+const MoveResizeDirection = {
+  SIZE_TOPLEFT:     0,
+  SIZE_TOP:         1,
+  SIZE_TOPRIGHT:    2,
+  SIZE_RIGHT:       3,
+  SIZE_BOTTOMRIGHT: 4,
+  SIZE_BOTTOM:      5,
+  SIZE_BOTTOMLEFT:  6,
+  SIZE_LEFT:        7,
+  MOVE:             8,
+  SIZE_KEYBOARD:    9,
+  MOVE_KEYBOARD:    10,
+  CANCEL:           11,
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 16: SELECTION / PROPERTY TYPES
+// ────────────────────────────────────────────────────────────
+
+const SelectionType = {
+  PRIMARY:   'PRIMARY',
+  SECONDARY: 'SECONDARY',
+  CLIPBOARD: 'CLIPBOARD',
+};
+
+/** Property change modes */
+const PropMode = {
+  REPLACE: 0,
+  PREPEND: 1,
+  APPEND:  2,
+};
+
+/** Property format sizes */
+const PropFormat = { F8: 8, F16: 16, F32: 32 };
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 17: KEYSYM TABLE
+//  Full XK_ keysym constants (X11/keysymdef.h)
+// ────────────────────────────────────────────────────────────
+
+const Keysym = {
+  // ── Void / special ──────────────────────────────────────
+  XK_VoidSymbol:        0xFFFFFF,
+
+  // ── TTY functions ────────────────────────────────────────
+  XK_BackSpace:         0xFF08,
+  XK_Tab:               0xFF09,
+  XK_Linefeed:          0xFF0A,
+  XK_Clear:             0xFF0B,
+  XK_Return:            0xFF0D,
+  XK_Pause:             0xFF13,
+  XK_Scroll_Lock:       0xFF14,
+  XK_Sys_Req:           0xFF15,
+  XK_Escape:            0xFF1B,
+  XK_Delete:            0xFFFF,
+
+  // ── Cursor control ────────────────────────────────────────
+  XK_Home:              0xFF50,
+  XK_Left:              0xFF51,
+  XK_Up:                0xFF52,
+  XK_Right:             0xFF53,
+  XK_Down:              0xFF54,
+  XK_Prior:             0xFF55, // Page Up
+  XK_Page_Up:           0xFF55,
+  XK_Next:              0xFF56, // Page Down
+  XK_Page_Down:         0xFF56,
+  XK_End:               0xFF57,
+  XK_Begin:             0xFF58,
+
+  // ── Misc functions ────────────────────────────────────────
+  XK_Select:            0xFF60,
+  XK_Print:             0xFF61,
+  XK_Execute:           0xFF62,
+  XK_Insert:            0xFF63,
+  XK_Undo:              0xFF65,
+  XK_Redo:              0xFF66,
+  XK_Menu:              0xFF67,
+  XK_Find:              0xFF68,
+  XK_Cancel:            0xFF69,
+  XK_Help:              0xFF6A,
+  XK_Break:             0xFF6B,
+  XK_Mode_switch:       0xFF7E,
+  XK_script_switch:     0xFF7E,
+  XK_Num_Lock:          0xFF7F,
+
+  // ── Keypad ────────────────────────────────────────────────
+  XK_KP_Space:          0xFF80,
+  XK_KP_Tab:            0xFF89,
+  XK_KP_Enter:          0xFF8D,
+  XK_KP_F1:             0xFF91,
+  XK_KP_F2:             0xFF92,
+  XK_KP_F3:             0xFF93,
+  XK_KP_F4:             0xFF94,
+  XK_KP_Home:           0xFF95,
+  XK_KP_Left:           0xFF96,
+  XK_KP_Up:             0xFF97,
+  XK_KP_Right:          0xFF98,
+  XK_KP_Down:           0xFF99,
+  XK_KP_Prior:          0xFF9A,
+  XK_KP_Page_Up:        0xFF9A,
+  XK_KP_Next:           0xFF9B,
+  XK_KP_Page_Down:      0xFF9B,
+  XK_KP_End:            0xFF9C,
+  XK_KP_Begin:          0xFF9D,
+  XK_KP_Insert:         0xFF9E,
+  XK_KP_Delete:         0xFF9F,
+  XK_KP_Equal:          0xFFBD,
+  XK_KP_Multiply:       0xFFAA,
+  XK_KP_Add:            0xFFAB,
+  XK_KP_Separator:      0xFFAC,
+  XK_KP_Subtract:       0xFFAD,
+  XK_KP_Decimal:        0xFFAE,
+  XK_KP_Divide:         0xFFAF,
+  XK_KP_0:              0xFFB0,
+  XK_KP_1:              0xFFB1,
+  XK_KP_2:              0xFFB2,
+  XK_KP_3:              0xFFB3,
+  XK_KP_4:              0xFFB4,
+  XK_KP_5:              0xFFB5,
+  XK_KP_6:              0xFFB6,
+  XK_KP_7:              0xFFB7,
+  XK_KP_8:              0xFFB8,
+  XK_KP_9:              0xFFB9,
+
+  // ── Function keys ─────────────────────────────────────────
+  XK_F1:  0xFFBE, XK_F2:  0xFFBF, XK_F3:  0xFFC0, XK_F4:  0xFFC1,
+  XK_F5:  0xFFC2, XK_F6:  0xFFC3, XK_F7:  0xFFC4, XK_F8:  0xFFC5,
+  XK_F9:  0xFFC6, XK_F10: 0xFFC7, XK_F11: 0xFFC8, XK_F12: 0xFFC9,
+  XK_F13: 0xFFCA, XK_F14: 0xFFCB, XK_F15: 0xFFCC, XK_F16: 0xFFCD,
+  XK_F17: 0xFFCE, XK_F18: 0xFFCF, XK_F19: 0xFFD0, XK_F20: 0xFFD1,
+  XK_F21: 0xFFD2, XK_F22: 0xFFD3, XK_F23: 0xFFD4, XK_F24: 0xFFD5,
+  XK_F25: 0xFFD6, XK_F26: 0xFFD7, XK_F27: 0xFFD8, XK_F28: 0xFFD9,
+  XK_F29: 0xFFDA, XK_F30: 0xFFDB, XK_F31: 0xFFDC, XK_F32: 0xFFDD,
+  XK_F33: 0xFFDE, XK_F34: 0xFFDF, XK_F35: 0xFFE0,
+
+  // ── Modifier keys ─────────────────────────────────────────
+  XK_Shift_L:        0xFFE1,
+  XK_Shift_R:        0xFFE2,
+  XK_Control_L:      0xFFE3,
+  XK_Control_R:      0xFFE4,
+  XK_Caps_Lock:      0xFFE5,
+  XK_Shift_Lock:     0xFFE6,
+  XK_Meta_L:         0xFFE7,
+  XK_Meta_R:         0xFFE8,
+  XK_Alt_L:          0xFFE9,
+  XK_Alt_R:          0xFFEA,
+  XK_Super_L:        0xFFEB,
+  XK_Super_R:        0xFFEC,
+  XK_Hyper_L:        0xFFED,
+  XK_Hyper_R:        0xFFEE,
+
+  // ── ISO keys ──────────────────────────────────────────────
+  XK_ISO_Lock:              0xFE01,
+  XK_ISO_Level2_Latch:      0xFE02,
+  XK_ISO_Level3_Shift:      0xFE03,
+  XK_ISO_Level3_Latch:      0xFE04,
+  XK_ISO_Level3_Lock:       0xFE05,
+  XK_ISO_Group_Shift:       0xFF7E,
+  XK_ISO_Group_Latch:       0xFE06,
+  XK_ISO_Group_Lock:        0xFE07,
+  XK_ISO_Next_Group:        0xFE08,
+  XK_ISO_Next_Group_Lock:   0xFE09,
+  XK_ISO_Prev_Group:        0xFE0A,
+  XK_ISO_Prev_Group_Lock:   0xFE0B,
+  XK_ISO_First_Group:       0xFE0C,
+  XK_ISO_First_Group_Lock:  0xFE0D,
+  XK_ISO_Last_Group:        0xFE0E,
+  XK_ISO_Last_Group_Lock:   0xFE0F,
+  XK_ISO_Left_Tab:          0xFE20,
+  XK_ISO_Move_Line_Up:      0xFE21,
+  XK_ISO_Move_Line_Down:    0xFE22,
+  XK_ISO_Partial_Line_Up:   0xFE23,
+  XK_ISO_Partial_Line_Down: 0xFE24,
+  XK_ISO_Partial_Space_Left:0xFE25,
+  XK_ISO_Partial_Space_Right:0xFE26,
+  XK_ISO_Set_Margin_Left:   0xFE27,
+  XK_ISO_Set_Margin_Right:  0xFE28,
+  XK_ISO_Release_Margin_Left:0xFE29,
+  XK_ISO_Release_Margin_Right:0xFE2A,
+  XK_ISO_Release_Both_Margins:0xFE2B,
+  XK_ISO_Fast_Cursor_Left:  0xFE2C,
+  XK_ISO_Fast_Cursor_Right: 0xFE2D,
+  XK_ISO_Fast_Cursor_Up:    0xFE2E,
+  XK_ISO_Fast_Cursor_Down:  0xFE2F,
+  XK_ISO_Continuous_Underline:0xFE30,
+  XK_ISO_Discontinuous_Underline:0xFE31,
+  XK_ISO_Emphasize:         0xFE32,
+  XK_ISO_Center_Object:     0xFE33,
+  XK_ISO_Enter:             0xFE34,
+
+  // ── Latin-1 (0x0020-0x00FF) ──────────────────────────────
+  XK_space:       0x0020, XK_exclam:      0x0021, XK_quotedbl:    0x0022,
+  XK_numbersign:  0x0023, XK_dollar:      0x0024, XK_percent:     0x0025,
+  XK_ampersand:   0x0026, XK_apostrophe:  0x0027, XK_quoteright:  0x0027,
+  XK_parenleft:   0x0028, XK_parenright:  0x0029, XK_asterisk:    0x002A,
+  XK_plus:        0x002B, XK_comma:       0x002C, XK_minus:       0x002D,
+  XK_period:      0x002E, XK_slash:       0x002F,
+  XK_0: 0x0030, XK_1: 0x0031, XK_2: 0x0032, XK_3: 0x0033,
+  XK_4: 0x0034, XK_5: 0x0035, XK_6: 0x0036, XK_7: 0x0037,
+  XK_8: 0x0038, XK_9: 0x0039,
+  XK_colon:       0x003A, XK_semicolon:   0x003B, XK_less:        0x003C,
+  XK_equal:       0x003D, XK_greater:     0x003E, XK_question:    0x003F,
+  XK_at:          0x0040,
+  XK_A: 0x0041, XK_B: 0x0042, XK_C: 0x0043, XK_D: 0x0044,
+  XK_E: 0x0045, XK_F: 0x0046, XK_G: 0x0047, XK_H: 0x0048,
+  XK_I: 0x0049, XK_J: 0x004A, XK_K: 0x004B, XK_L: 0x004C,
+  XK_M: 0x004D, XK_N: 0x004E, XK_O: 0x004F, XK_P: 0x0050,
+  XK_Q: 0x0051, XK_R: 0x0052, XK_S: 0x0053, XK_T: 0x0054,
+  XK_U: 0x0055, XK_V: 0x0056, XK_W: 0x0057, XK_X: 0x0058,
+  XK_Y: 0x0059, XK_Z: 0x005A,
+  XK_bracketleft: 0x005B, XK_backslash:   0x005C, XK_bracketright:0x005D,
+  XK_asciicircum: 0x005E, XK_underscore:  0x005F, XK_grave:       0x0060,
+  XK_quoteleft:   0x0060,
+  XK_a: 0x0061, XK_b: 0x0062, XK_c: 0x0063, XK_d: 0x0064,
+  XK_e: 0x0065, XK_f: 0x0066, XK_g: 0x0067, XK_h: 0x0068,
+  XK_i: 0x0069, XK_j: 0x006A, XK_k: 0x006B, XK_l: 0x006C,
+  XK_m: 0x006D, XK_n: 0x006E, XK_o: 0x006F, XK_p: 0x0070,
+  XK_q: 0x0071, XK_r: 0x0072, XK_s: 0x0073, XK_t: 0x0074,
+  XK_u: 0x0075, XK_v: 0x0076, XK_w: 0x0077, XK_x: 0x0078,
+  XK_y: 0x0079, XK_z: 0x007A,
+  XK_braceleft:   0x007B, XK_bar:         0x007C, XK_braceright:  0x007D,
+  XK_asciitilde:  0x007E,
+
+  // ── Latin-1 extended ──────────────────────────────────────
+  XK_nobreakspace:   0x00A0, XK_exclamdown:    0x00A1, XK_cent:          0x00A2,
+  XK_sterling:       0x00A3, XK_currency:      0x00A4, XK_yen:           0x00A5,
+  XK_brokenbar:      0x00A6, XK_section:       0x00A7, XK_diaeresis:     0x00A8,
+  XK_copyright:      0x00A9, XK_ordfeminine:   0x00AA, XK_guillemotleft: 0x00AB,
+  XK_notsign:        0x00AC, XK_hyphen:        0x00AD, XK_registered:    0x00AE,
+  XK_macron:         0x00AF, XK_degree:        0x00B0, XK_plusminus:     0x00B1,
+  XK_twosuperior:    0x00B2, XK_threesuperior: 0x00B3, XK_acute:         0x00B4,
+  XK_mu:             0x00B5, XK_paragraph:     0x00B6, XK_periodcentered:0x00B7,
+  XK_cedilla:        0x00B8, XK_onesuperior:   0x00B9, XK_masculine:     0x00BA,
+  XK_guillemotright: 0x00BB, XK_onequarter:    0x00BC, XK_onehalf:       0x00BD,
+  XK_threequarters:  0x00BE, XK_questiondown:  0x00BF,
+  XK_Agrave: 0x00C0, XK_Aacute: 0x00C1, XK_Acircumflex: 0x00C2,
+  XK_Atilde: 0x00C3, XK_Adiaeresis: 0x00C4, XK_Aring: 0x00C5,
+  XK_AE: 0x00C6, XK_Ccedilla: 0x00C7,
+  XK_Egrave: 0x00C8, XK_Eacute: 0x00C9, XK_Ecircumflex: 0x00CA, XK_Ediaeresis: 0x00CB,
+  XK_Igrave: 0x00CC, XK_Iacute: 0x00CD, XK_Icircumflex: 0x00CE, XK_Idiaeresis: 0x00CF,
+  XK_ETH: 0x00D0, XK_Ntilde: 0x00D1,
+  XK_Ograve: 0x00D2, XK_Oacute: 0x00D3, XK_Ocircumflex: 0x00D4,
+  XK_Otilde: 0x00D5, XK_Odiaeresis: 0x00D6, XK_multiply: 0x00D7,
+  XK_Ooblique: 0x00D8, XK_Oslash: 0x00D8,
+  XK_Ugrave: 0x00D9, XK_Uacute: 0x00DA, XK_Ucircumflex: 0x00DB, XK_Udiaeresis: 0x00DC,
+  XK_Yacute: 0x00DD, XK_THORN: 0x00DE, XK_ssharp: 0x00DF,
+  XK_agrave: 0x00E0, XK_aacute: 0x00E1, XK_acircumflex: 0x00E2,
+  XK_atilde: 0x00E3, XK_adiaeresis: 0x00E4, XK_aring: 0x00E5,
+  XK_ae: 0x00E6, XK_ccedilla: 0x00E7,
+  XK_egrave: 0x00E8, XK_eacute: 0x00E9, XK_ecircumflex: 0x00EA, XK_ediaeresis: 0x00EB,
+  XK_igrave: 0x00EC, XK_iacute: 0x00ED, XK_icircumflex: 0x00EE, XK_idiaeresis: 0x00EF,
+  XK_eth: 0x00F0, XK_ntilde: 0x00F1,
+  XK_ograve: 0x00F2, XK_oacute: 0x00F3, XK_ocircumflex: 0x00F4,
+  XK_otilde: 0x00F5, XK_odiaeresis: 0x00F6, XK_division: 0x00F7,
+  XK_oslash: 0x00F8, XK_ooblique: 0x00F8,
+  XK_ugrave: 0x00F9, XK_uacute: 0x00FA, XK_ucircumflex: 0x00FB, XK_udiaeresis: 0x00FC,
+  XK_yacute: 0x00FD, XK_thorn: 0x00FE, XK_ydiaeresis: 0x00FF,
+
+  // ── XF86 / multimedia keys ───────────────────────────────
+  XF86XK_ModeLock:          0x1008FF01,
+  XF86XK_MonBrightnessUp:   0x1008FF02,
+  XF86XK_MonBrightnessDown: 0x1008FF03,
+  XF86XK_KbdLightOnOff:     0x1008FF04,
+  XF86XK_KbdBrightnessUp:   0x1008FF05,
+  XF86XK_KbdBrightnessDown: 0x1008FF06,
+  XF86XK_Standby:           0x1008FF10,
+  XF86XK_AudioLowerVolume:  0x1008FF11,
+  XF86XK_AudioMute:         0x1008FF12,
+  XF86XK_AudioRaiseVolume:  0x1008FF13,
+  XF86XK_AudioPlay:         0x1008FF14,
+  XF86XK_AudioStop:         0x1008FF15,
+  XF86XK_AudioPrev:         0x1008FF16,
+  XF86XK_AudioNext:         0x1008FF17,
+  XF86XK_HomePage:          0x1008FF18,
+  XF86XK_Mail:              0x1008FF19,
+  XF86XK_Start:             0x1008FF1A,
+  XF86XK_Search:            0x1008FF1B,
+  XF86XK_AudioRecord:       0x1008FF1C,
+  XF86XK_Calculator:        0x1008FF1D,
+  XF86XK_Memo:              0x1008FF1E,
+  XF86XK_ToDoList:          0x1008FF1F,
+  XF86XK_Calendar:          0x1008FF20,
+  XF86XK_PowerDown:         0x1008FF21,
+  XF86XK_ContrastAdjust:    0x1008FF22,
+  XF86XK_RockerUp:          0x1008FF23,
+  XF86XK_RockerDown:        0x1008FF24,
+  XF86XK_RockerEnter:       0x1008FF25,
+  XF86XK_Back:              0x1008FF26,
+  XF86XK_Forward:           0x1008FF27,
+  XF86XK_Stop:              0x1008FF28,
+  XF86XK_Refresh:           0x1008FF29,
+  XF86XK_PowerOff:          0x1008FF2A,
+  XF86XK_WakeUp:            0x1008FF2B,
+  XF86XK_Eject:             0x1008FF2C,
+  XF86XK_ScreenSaver:       0x1008FF2D,
+  XF86XK_WWW:               0x1008FF2E,
+  XF86XK_Sleep:             0x1008FF2F,
+  XF86XK_Favorites:         0x1008FF30,
+  XF86XK_AudioPause:        0x1008FF31,
+  XF86XK_AudioMedia:        0x1008FF32,
+  XF86XK_MyComputer:        0x1008FF33,
+  XF86XK_VendorHome:        0x1008FF34,
+  XF86XK_LightBulb:         0x1008FF35,
+  XF86XK_Shop:              0x1008FF36,
+  XF86XK_History:           0x1008FF37,
+  XF86XK_OpenURL:           0x1008FF38,
+  XF86XK_AddFavorite:       0x1008FF39,
+  XF86XK_HotLinks:          0x1008FF3A,
+  XF86XK_BrightnessAdjust:  0x1008FF3B,
+  XF86XK_Finance:           0x1008FF3C,
+  XF86XK_Community:         0x1008FF3D,
+  XF86XK_AudioRewind:       0x1008FF3E,
+  XF86XK_BackForward:       0x1008FF3F,
+  XF86XK_Launch0:           0x1008FF40,
+  XF86XK_Launch1:           0x1008FF41,
+  XF86XK_Launch2:           0x1008FF42,
+  XF86XK_Launch3:           0x1008FF43,
+  XF86XK_Launch4:           0x1008FF44,
+  XF86XK_Launch5:           0x1008FF45,
+  XF86XK_Launch6:           0x1008FF46,
+  XF86XK_Launch7:           0x1008FF47,
+  XF86XK_Launch8:           0x1008FF48,
+  XF86XK_Launch9:           0x1008FF49,
+  XF86XK_LaunchA:           0x1008FF4A,
+  XF86XK_LaunchB:           0x1008FF4B,
+  XF86XK_LaunchC:           0x1008FF4C,
+  XF86XK_LaunchD:           0x1008FF4D,
+  XF86XK_LaunchE:           0x1008FF4E,
+  XF86XK_LaunchF:           0x1008FF4F,
+  XF86XK_ApplicationLeft:   0x1008FF50,
+  XF86XK_ApplicationRight:  0x1008FF51,
+  XF86XK_Book:              0x1008FF52,
+  XF86XK_CD:                0x1008FF53,
+  XF86XK_Calculater:        0x1008FF54,
+  XF86XK_Clear:             0x1008FF55,
+  XF86XK_Close:             0x1008FF56,
+  XF86XK_Copy:              0x1008FF57,
+  XF86XK_Cut:               0x1008FF58,
+  XF86XK_Display:           0x1008FF59,
+  XF86XK_DOS:               0x1008FF5A,
+  XF86XK_Documents:         0x1008FF5B,
+  XF86XK_Excel:             0x1008FF5C,
+  XF86XK_Explorer:          0x1008FF5D,
+  XF86XK_Game:              0x1008FF5E,
+  XF86XK_Go:                0x1008FF5F,
+  XF86XK_iTouch:            0x1008FF60,
+  XF86XK_LogOff:            0x1008FF61,
+  XF86XK_Market:            0x1008FF62,
+  XF86XK_Meeting:           0x1008FF63,
+  XF86XK_MenuKB:            0x1008FF65,
+  XF86XK_MenuPB:            0x1008FF66,
+  XF86XK_MySites:           0x1008FF67,
+  XF86XK_New:               0x1008FF68,
+  XF86XK_News:              0x1008FF69,
+  XF86XK_OfficeHome:        0x1008FF6A,
+  XF86XK_Open:              0x1008FF6B,
+  XF86XK_Option:            0x1008FF6C,
+  XF86XK_Paste:             0x1008FF6D,
+  XF86XK_Phone:             0x1008FF6E,
+  XF86XK_Q:                 0x1008FF70,
+  XF86XK_Reply:             0x1008FF72,
+  XF86XK_Reload:            0x1008FF73,
+  XF86XK_RotateWindows:     0x1008FF74,
+  XF86XK_RotationPB:        0x1008FF75,
+  XF86XK_RotationKB:        0x1008FF76,
+  XF86XK_Save:              0x1008FF77,
+  XF86XK_ScrollUp:          0x1008FF78,
+  XF86XK_ScrollDown:        0x1008FF79,
+  XF86XK_ScrollClick:       0x1008FF7A,
+  XF86XK_Send:              0x1008FF7B,
+  XF86XK_Spell:             0x1008FF7C,
+  XF86XK_SplitScreen:       0x1008FF7D,
+  XF86XK_Support:           0x1008FF7E,
+  XF86XK_TaskPane:          0x1008FF7F,
+  XF86XK_Terminal:          0x1008FF80,
+  XF86XK_Tools:             0x1008FF81,
+  XF86XK_Travel:            0x1008FF82,
+  XF86XK_UserPB:            0x1008FF84,
+  XF86XK_User1KB:           0x1008FF85,
+  XF86XK_User2KB:           0x1008FF86,
+  XF86XK_Video:             0x1008FF87,
+  XF86XK_WheelButton:       0x1008FF88,
+  XF86XK_Word:              0x1008FF89,
+  XF86XK_Xfer:              0x1008FF8A,
+  XF86XK_ZoomIn:            0x1008FF8B,
+  XF86XK_ZoomOut:           0x1008FF8C,
+  XF86XK_Away:              0x1008FF8D,
+  XF86XK_Messenger:         0x1008FF8E,
+  XF86XK_WebCam:            0x1008FF8F,
+  XF86XK_MailForward:       0x1008FF90,
+  XF86XK_Pictures:          0x1008FF91,
+  XF86XK_Music:             0x1008FF92,
+  XF86XK_Battery:           0x1008FF93,
+  XF86XK_Bluetooth:         0x1008FF94,
+  XF86XK_WLAN:              0x1008FF95,
+  XF86XK_UWB:               0x1008FF96,
+  XF86XK_AudioForward:      0x1008FF97,
+  XF86XK_AudioRepeat:       0x1008FF98,
+  XF86XK_AudioRandomPlay:   0x1008FF99,
+  XF86XK_Subtitle:          0x1008FF9A,
+  XF86XK_AudioCycleTrack:   0x1008FF9B,
+  XF86XK_CycleAngle:        0x1008FF9C,
+  XF86XK_FrameBack:         0x1008FF9D,
+  XF86XK_FrameForward:      0x1008FF9E,
+  XF86XK_Time:              0x1008FF9F,
+  XF86XK_Select:            0x1008FFA0,
+  XF86XK_View:              0x1008FFA1,
+  XF86XK_TopMenu:           0x1008FFA2,
+  XF86XK_SuspendVide:       0x1008FFA7,
+  XF86XK_Hibernate:         0x1008FFA8,
+  XF86XK_TouchpadToggle:    0x1008FFA9,
+  XF86XK_TouchpadOn:        0x1008FFB0,
+  XF86XK_TouchpadOff:       0x1008FFB1,
+  XF86XK_AudioMicMute:      0x1008FFB2,
+  XF86XK_Switch_VT_1:       0x1008FE01,
+  XF86XK_Switch_VT_2:       0x1008FE02,
+  XF86XK_Switch_VT_3:       0x1008FE03,
+  XF86XK_Switch_VT_4:       0x1008FE04,
+  XF86XK_Switch_VT_5:       0x1008FE05,
+  XF86XK_Switch_VT_6:       0x1008FE06,
+  XF86XK_Switch_VT_7:       0x1008FE07,
+  XF86XK_Switch_VT_8:       0x1008FE08,
+  XF86XK_Switch_VT_9:       0x1008FE09,
+  XF86XK_Switch_VT_10:      0x1008FE0A,
+  XF86XK_Switch_VT_11:      0x1008FE0B,
+  XF86XK_Switch_VT_12:      0x1008FE0C,
+  XF86XK_Ungrab:            0x1008FE20,
+  XF86XK_ClearGrab:         0x1008FE21,
+  XF86XK_Next_VMode:        0x1008FE22,
+  XF86XK_Prev_VMode:        0x1008FE23,
+  XF86XK_LogWindowTree:     0x1008FE24,
+  XF86XK_LogGrabInfo:       0x1008FE25,
+};
+
+/** Reverse map: keysym code → name */
+const KeysymName = Object.fromEntries(
+  Object.entries(Keysym).map(([k,v]) => [v, k])
+);
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 18: KEYSYM UTILITIES
+// ────────────────────────────────────────────────────────────
+
+/**
+ * Look up a keysym code by name (XK_ prefix optional).
+ * @param {string} name
+ * @returns {number|undefined}
+ */
+function keysymByName(name) {
+  if (Keysym[name] !== undefined) return Keysym[name];
+  const withPrefix = 'XK_' + name;
+  return Keysym[withPrefix];
+}
+
+/**
+ * Look up a keysym name by code.
+ * @param {number} code
+ * @returns {string|undefined}
+ */
+function keysymToName(code) {
+  return KeysymName[code];
+}
+
+/**
+ * Convert a keysym to its Unicode code point (for Latin-1 and Unicode keysyms).
+ * @param {number} keysym
+ * @returns {number|null}
+ */
+function keysymToUnicode(keysym) {
+  // Direct Latin-1
+  if (keysym >= 0x0020 && keysym <= 0x00FF) return keysym;
+  // Unicode keysyms (0x01000000 + codepoint)
+  if ((keysym & 0xFF000000) === 0x01000000) return keysym & 0x00FFFFFF;
+  return null;
+}
+
+/**
+ * Convert a keysym to a character string (if printable).
+ * @param {number} keysym
+ * @returns {string|null}
+ */
+function keysymToChar(keysym) {
+  const cp = keysymToUnicode(keysym);
+  if (cp !== null && cp >= 0x0020) return String.fromCodePoint(cp);
+  return null;
+}
+
+/**
+ * Get a Unicode code point's corresponding keysym.
+ * @param {number} codepoint
+ * @returns {number}
+ */
+function unicodeToKeysym(codepoint) {
+  if (codepoint >= 0x0020 && codepoint <= 0x00FF) return codepoint;
+  return 0x01000000 | codepoint;
+}
+
+/**
+ * Test if a keysym is a modifier key.
+ * @param {number} keysym
+ * @returns {boolean}
+ */
+function isModifierKeysym(keysym) {
+  return keysym >= 0xFFE1 && keysym <= 0xFFEE;
+}
+
+/**
+ * Test if a keysym is a function key (F1–F35).
+ * @param {number} keysym
+ * @returns {boolean}
+ */
+function isFunctionKeysym(keysym) {
+  return keysym >= 0xFFBE && keysym <= 0xFFE0;
+}
+
+/**
+ * Test if a keysym is a keypad key.
+ */
+function isKeypadKeysym(keysym) {
+  return keysym >= 0xFF80 && keysym <= 0xFFBD;
+}
+
+/**
+ * Test if a keysym is printable (has a character).
+ */
+function isPrintableKeysym(keysym) {
+  return keysymToChar(keysym) !== null;
+}
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 19: X11 NAMED COLORS (rgb.txt — full list)
+// ────────────────────────────────────────────────────────────
+
+/**
+ * Full X11 named color table.
+ * Keys are lowercase names (spaces removed), values are [r, g, b].
+ */
+const X11Colors = {
+  aliceblue:            [240,248,255], antiquewhite:         [250,235,215],
+  antiquewhite1:        [255,239,219], antiquewhite2:        [238,223,204],
+  antiquewhite3:        [205,192,176], antiquewhite4:        [139,131,120],
+  aquamarine:           [127,255,212], aquamarine1:          [127,255,212],
+  aquamarine2:          [118,238,198], aquamarine3:          [102,205,170],
+  aquamarine4:          [69,139,116],  azure:                [240,255,255],
+  azure1:               [240,255,255], azure2:               [224,238,238],
+  azure3:               [193,205,205], azure4:               [131,139,139],
+  beige:                [245,245,220], bisque:               [255,228,196],
+  bisque1:              [255,228,196], bisque2:              [238,213,183],
+  bisque3:              [205,183,158], bisque4:              [139,125,107],
+  black:                [0,0,0],       blanchedalmond:       [255,235,205],
+  blue:                 [0,0,255],     blue1:                [0,0,255],
+  blue2:                [0,0,238],     blue3:                [0,0,205],
+  blue4:                [0,0,139],     blueviolet:           [138,43,226],
+  brown:                [165,42,42],   brown1:               [255,64,64],
+  brown2:               [238,59,59],   brown3:               [205,51,51],
+  brown4:               [139,35,35],   burlywood:            [222,184,135],
+  burlywood1:           [255,211,155], burlywood2:           [238,197,145],
+  burlywood3:           [205,170,125], burlywood4:           [139,115,85],
+  cadetblue:            [95,158,160],  cadetblue1:           [152,245,255],
+  cadetblue2:           [142,229,238], cadetblue3:           [122,197,205],
+  cadetblue4:           [83,134,139],  chartreuse:           [127,255,0],
+  chartreuse1:          [127,255,0],   chartreuse2:          [118,238,0],
+  chartreuse3:          [102,205,0],   chartreuse4:          [69,139,0],
+  chocolate:            [210,105,30],  chocolate1:           [255,127,36],
+  chocolate2:           [238,118,33],  chocolate3:           [205,102,29],
+  chocolate4:           [139,69,19],   coral:                [255,127,80],
+  coral1:               [255,114,86],  coral2:               [238,106,80],
+  coral3:               [205,91,69],   coral4:               [139,62,47],
+  cornflowerblue:       [100,149,237], cornsilk:             [255,248,220],
+  cornsilk1:            [255,248,220], cornsilk2:            [238,232,205],
+  cornsilk3:            [205,200,177], cornsilk4:            [139,136,120],
+  cyan:                 [0,255,255],   cyan1:                [0,255,255],
+  cyan2:                [0,238,238],   cyan3:                [0,205,205],
+  cyan4:                [0,139,139],   darkblue:             [0,0,139],
+  darkcyan:             [0,139,139],   darkgoldenrod:        [184,134,11],
+  darkgoldenrod1:       [255,185,15],  darkgoldenrod2:       [238,173,14],
+  darkgoldenrod3:       [205,149,12],  darkgoldenrod4:       [139,101,8],
+  darkgray:             [169,169,169], darkgreen:            [0,100,0],
+  darkgrey:             [169,169,169], darkkhaki:            [189,183,107],
+  darkmagenta:          [139,0,139],   darkolivegreen:       [85,107,47],
+  darkolivegreen1:      [202,255,112], darkolivegreen2:      [188,238,104],
+  darkolivegreen3:      [162,205,90],  darkolivegreen4:      [110,139,61],
+  darkorange:           [255,140,0],   darkorange1:          [255,127,0],
+  darkorange2:          [238,118,0],   darkorange3:          [205,102,0],
+  darkorange4:          [139,69,0],    darkorchid:           [153,50,204],
+  darkorchid1:          [191,62,255],  darkorchid2:          [178,58,238],
+  darkorchid3:          [154,50,205],  darkorchid4:          [104,34,139],
+  darkred:              [139,0,0],     darksalmon:           [233,150,122],
+  darkseagreen:         [143,188,143], darkseagreen1:        [193,255,193],
+  darkseagreen2:        [180,238,180], darkseagreen3:        [155,205,155],
+  darkseagreen4:        [105,139,105], darkslateblue:        [72,61,139],
+  darkslategray:        [47,79,79],    darkslategray1:       [151,255,255],
+  darkslategray2:       [141,238,238], darkslategray3:       [121,205,205],
+  darkslategray4:       [82,139,139],  darkslategrey:        [47,79,79],
+  darkturquoise:        [0,206,209],   darkviolet:           [148,0,211],
+  deeppink:             [255,20,147],  deeppink1:            [255,20,147],
+  deeppink2:            [238,18,137],  deeppink3:            [205,16,118],
+  deeppink4:            [139,10,80],   deepskyblue:          [0,191,255],
+  deepskyblue1:         [0,191,255],   deepskyblue2:         [0,178,238],
+  deepskyblue3:         [0,154,205],   deepskyblue4:         [0,104,139],
+  dimgray:              [105,105,105], dimgrey:              [105,105,105],
+  dodgerblue:           [30,144,255],  dodgerblue1:          [30,144,255],
+  dodgerblue2:          [28,134,238],  dodgerblue3:          [24,116,205],
+  dodgerblue4:          [16,78,139],   firebrick:            [178,34,34],
+  firebrick1:           [255,48,48],   firebrick2:           [238,44,44],
+  firebrick3:           [205,38,38],   firebrick4:           [139,26,26],
+  floralwhite:          [255,250,240], forestgreen:          [34,139,34],
+  gainsboro:            [220,220,220], ghostwhite:           [248,248,255],
+  gold:                 [255,215,0],   gold1:                [255,215,0],
+  gold2:                [238,201,0],   gold3:                [205,173,0],
+  gold4:                [139,117,0],   goldenrod:            [218,165,32],
+  goldenrod1:           [255,193,37],  goldenrod2:           [238,180,34],
+  goldenrod3:           [205,155,29],  goldenrod4:           [139,105,20],
+  gray:                 [190,190,190], gray0:                [0,0,0],
+  gray1:                [3,3,3],       gray2:                [5,5,5],
+  gray3:                [8,8,8],       gray4:                [10,10,10],
+  gray5:                [13,13,13],    gray6:                [15,15,15],
+  gray7:                [18,18,18],    gray8:                [20,20,20],
+  gray9:                [23,23,23],    gray10:               [26,26,26],
+  gray11:               [28,28,28],    gray12:               [31,31,31],
+  gray13:               [33,33,33],    gray14:               [36,36,36],
+  gray15:               [38,38,38],    gray16:               [41,41,41],
+  gray17:               [43,43,43],    gray18:               [46,46,46],
+  gray19:               [48,48,48],    gray20:               [51,51,51],
+  gray21:               [54,54,54],    gray22:               [56,56,56],
+  gray23:               [59,59,59],    gray24:               [61,61,61],
+  gray25:               [64,64,64],    gray26:               [66,66,66],
+  gray27:               [69,69,69],    gray28:               [71,71,71],
+  gray29:               [74,74,74],    gray30:               [77,77,77],
+  gray31:               [79,79,79],    gray32:               [82,82,82],
+  gray33:               [84,84,84],    gray34:               [87,87,87],
+  gray35:               [89,89,89],    gray36:               [92,92,92],
+  gray37:               [94,94,94],    gray38:               [97,97,97],
+  gray39:               [99,99,99],    gray40:               [102,102,102],
+  gray41:               [105,105,105], gray42:               [107,107,107],
+  gray43:               [110,110,110], gray44:               [112,112,112],
+  gray45:               [115,115,115], gray46:               [117,117,117],
+  gray47:               [120,120,120], gray48:               [122,122,122],
+  gray49:               [125,125,125], gray50:               [127,127,127],
+  gray51:               [130,130,130], gray52:               [133,133,133],
+  gray53:               [135,135,135], gray54:               [138,138,138],
+  gray55:               [140,140,140], gray56:               [143,143,143],
+  gray57:               [145,145,145], gray58:               [148,148,148],
+  gray59:               [150,150,150], gray60:               [153,153,153],
+  gray61:               [156,156,156], gray62:               [158,158,158],
+  gray63:               [161,161,161], gray64:               [163,163,163],
+  gray65:               [166,166,166], gray66:               [168,168,168],
+  gray67:               [171,171,171], gray68:               [173,173,173],
+  gray69:               [176,176,176], gray70:               [179,179,179],
+  gray71:               [181,181,181], gray72:               [184,184,184],
+  gray73:               [186,186,186], gray74:               [189,189,189],
+  gray75:               [191,191,191], gray76:               [194,194,194],
+  gray77:               [196,196,196], gray78:               [199,199,199],
+  gray79:               [201,201,201], gray80:               [204,204,204],
+  gray81:               [207,207,207], gray82:               [209,209,209],
+  gray83:               [212,212,212], gray84:               [214,214,214],
+  gray85:               [217,217,217], gray86:               [219,219,219],
+  gray87:               [222,222,222], gray88:               [224,224,224],
+  gray89:               [227,227,227], gray90:               [229,229,229],
+  gray91:               [232,232,232], gray92:               [235,235,235],
+  gray93:               [237,237,237], gray94:               [240,240,240],
+  gray95:               [242,242,242], gray96:               [245,245,245],
+  gray97:               [247,247,247], gray98:               [250,250,250],
+  gray99:               [252,252,252], gray100:              [255,255,255],
+  green:                [0,255,0],     green1:               [0,255,0],
+  green2:               [0,238,0],     green3:               [0,205,0],
+  green4:               [0,139,0],     greenyellow:          [173,255,47],
+  grey:                 [190,190,190], honeydew:             [240,255,240],
+  honeydew1:            [240,255,240], honeydew2:            [224,238,224],
+  honeydew3:            [193,205,193], honeydew4:            [131,139,131],
+  hotpink:              [255,105,180], hotpink1:             [255,110,180],
+  hotpink2:             [238,106,167], hotpink3:             [205,96,144],
+  hotpink4:             [139,58,98],   indianred:            [205,92,92],
+  indianred1:           [255,106,106], indianred2:           [238,99,99],
+  indianred3:           [205,85,85],   indianred4:           [139,58,58],
+  ivory:                [255,255,240], ivory1:               [255,255,240],
+  ivory2:               [238,238,224], ivory3:               [205,205,193],
+  ivory4:               [139,139,131], khaki:                [240,230,140],
+  khaki1:               [255,246,143], khaki2:               [238,230,133],
+  khaki3:               [205,198,115], khaki4:               [139,134,78],
+  lavender:             [230,230,250], lavenderblush:        [255,240,245],
+  lavenderblush1:       [255,240,245], lavenderblush2:       [238,224,229],
+  lavenderblush3:       [205,193,197], lavenderblush4:       [139,131,134],
+  lawngreen:            [124,252,0],   lemonchiffon:         [255,250,205],
+  lemonchiffon1:        [255,250,205], lemonchiffon2:        [238,233,191],
+  lemonchiffon3:        [205,201,165], lemonchiffon4:        [139,137,112],
+  lightblue:            [173,216,230], lightblue1:           [191,239,255],
+  lightblue2:           [178,223,238], lightblue3:           [154,192,205],
+  lightblue4:           [104,131,139], lightcoral:           [240,128,128],
+  lightcyan:            [224,255,255], lightcyan1:           [224,255,255],
+  lightcyan2:           [209,238,238], lightcyan3:           [180,205,205],
+  lightcyan4:           [122,139,139], lightgoldenrod:       [238,221,130],
+  lightgoldenrod1:      [255,236,139], lightgoldenrod2:      [238,220,130],
+  lightgoldenrod3:      [205,190,112], lightgoldenrod4:      [139,129,76],
+  lightgoldenrodyellow: [250,250,210], lightgray:            [211,211,211],
+  lightgreen:           [144,238,144], lightgrey:            [211,211,211],
+  lightpink:            [255,182,193], lightpink1:           [255,174,185],
+  lightpink2:           [238,162,173], lightpink3:           [205,140,149],
+  lightpink4:           [139,95,101],  lightsalmon:          [255,160,122],
+  lightsalmon1:         [255,160,122], lightsalmon2:         [238,149,114],
+  lightsalmon3:         [205,129,98],  lightsalmon4:         [139,87,66],
+  lightseagreen:        [32,178,170],  lightskyblue:         [135,206,250],
+  lightskyblue1:        [176,226,255], lightskyblue2:        [164,211,238],
+  lightskyblue3:        [141,182,205], lightskyblue4:        [96,123,139],
+  lightslateblue:       [132,112,255], lightslategray:       [119,136,153],
+  lightslategrey:       [119,136,153], lightsteelblue:       [176,196,222],
+  lightsteelblue1:      [202,225,255], lightsteelblue2:      [188,210,238],
+  lightsteelblue3:      [162,181,205], lightsteelblue4:      [110,123,139],
+  lightyellow:          [255,255,224], lightyellow1:         [255,255,224],
+  lightyellow2:         [238,238,209], lightyellow3:         [205,205,180],
+  lightyellow4:         [139,139,122], limegreen:            [50,205,50],
+  linen:                [250,240,230], magenta:              [255,0,255],
+  magenta1:             [255,0,255],   magenta2:             [238,0,238],
+  magenta3:             [205,0,205],   magenta4:             [139,0,139],
+  maroon:               [176,48,96],   maroon1:              [255,52,179],
+  maroon2:              [238,48,167],  maroon3:              [205,41,144],
+  maroon4:              [139,28,98],   mediumaquamarine:     [102,205,170],
+  mediumblue:           [0,0,205],     mediumorchid:         [186,85,211],
+  mediumorchid1:        [224,102,255], mediumorchid2:        [209,95,238],
+  mediumorchid3:        [180,82,205],  mediumorchid4:        [122,55,139],
+  mediumpurple:         [147,112,219], mediumpurple1:        [171,130,255],
+  mediumpurple2:        [159,121,238], mediumpurple3:        [137,104,205],
+  mediumpurple4:        [93,71,139],   mediumseagreen:       [60,179,113],
+  mediumslateblue:      [123,104,238], mediumspringgreen:    [0,250,154],
+  mediumturquoise:      [72,209,204],  mediumvioletred:      [199,21,133],
+  midnightblue:         [25,25,112],   mintcream:            [245,255,250],
+  mistyrose:            [255,228,225], mistyrose1:           [255,228,225],
+  mistyrose2:           [238,213,210], mistyrose3:           [205,183,181],
+  mistyrose4:           [139,125,123], moccasin:             [255,228,181],
+  navajowhite:          [255,222,173], navajowhite1:         [255,222,173],
+  navajowhite2:         [238,207,161], navajowhite3:         [205,179,139],
+  navajowhite4:         [139,121,94],  navy:                 [0,0,128],
+  navyblue:             [0,0,128],     oldlace:              [253,245,230],
+  olivedrab:            [107,142,35],  olivedrab1:           [192,255,62],
+  olivedrab2:           [179,238,58],  olivedrab3:           [154,205,50],
+  olivedrab4:           [105,139,34],  orange:               [255,165,0],
+  orange1:              [255,165,0],   orange2:              [238,154,0],
+  orange3:              [205,133,0],   orange4:              [139,90,0],
+  orangered:            [255,69,0],    orangered1:           [255,69,0],
+  orangered2:           [238,64,0],    orangered3:           [205,55,0],
+  orangered4:           [139,37,0],    orchid:               [218,112,214],
+  orchid1:              [255,131,250], orchid2:              [238,122,233],
+  orchid3:              [205,105,201], orchid4:              [139,71,137],
+  palegoldenrod:        [238,232,170], palegreen:            [152,251,152],
+  palegreen1:           [154,255,154], palegreen2:           [144,238,144],
+  palegreen3:           [124,205,124], palegreen4:           [84,139,84],
+  paleturquoise:        [175,238,238], paleturquoise1:       [187,255,255],
+  paleturquoise2:       [174,238,238], paleturquoise3:       [150,205,205],
+  paleturquoise4:       [102,139,139], palevioletred:        [219,112,147],
+  palevioletred1:       [255,130,171], palevioletred2:       [238,121,159],
+  palevioletred3:       [205,104,137], palevioletred4:       [139,71,93],
+  papayawhip:           [255,239,213], peachpuff:            [255,218,185],
+  peachpuff1:           [255,218,185], peachpuff2:           [238,203,173],
+  peachpuff3:           [205,175,149], peachpuff4:           [139,119,101],
+  peru:                 [205,133,63],  pink:                 [255,192,203],
+  pink1:                [255,181,197], pink2:                [238,169,184],
+  pink3:                [205,145,158], pink4:                [139,99,108],
+  plum:                 [221,160,221], plum1:                [255,187,255],
+  plum2:                [238,174,238], plum3:                [205,150,205],
+  plum4:                [139,102,139], powderblue:           [176,224,230],
+  purple:               [160,32,240],  purple1:              [155,48,255],
+  purple2:              [145,44,238],  purple3:              [125,38,205],
+  purple4:              [85,26,139],   red:                  [255,0,0],
+  red1:                 [255,0,0],     red2:                 [238,0,0],
+  red3:                 [205,0,0],     red4:                 [139,0,0],
+  rosybrown:            [188,143,143], rosybrown1:           [255,193,193],
+  rosybrown2:           [238,180,180], rosybrown3:           [205,155,155],
+  rosybrown4:           [139,105,105], royalblue:            [65,105,225],
+  royalblue1:           [72,118,255],  royalblue2:           [67,110,238],
+  royalblue3:           [58,95,205],   royalblue4:           [39,64,139],
+  saddlebrown:          [139,69,19],   salmon:               [250,128,114],
+  salmon1:              [255,140,105], salmon2:              [238,130,98],
+  salmon3:              [205,112,84],  salmon4:              [139,76,57],
+  sandybrown:           [244,164,96],  seagreen:             [46,139,87],
+  seagreen1:            [84,255,159],  seagreen2:            [78,238,148],
+  seagreen3:            [67,205,128],  seagreen4:            [46,139,87],
+  seashell:             [255,245,238], seashell1:            [255,245,238],
+  seashell2:            [238,229,222], seashell3:            [205,197,191],
+  seashell4:            [139,134,130], sienna:               [160,82,45],
+  sienna1:              [255,130,71],  sienna2:              [238,121,66],
+  sienna3:              [205,104,57],  sienna4:              [139,71,38],
+  skyblue:              [135,206,235], skyblue1:             [135,206,255],
+  skyblue2:             [126,192,238], skyblue3:             [108,166,205],
+  skyblue4:             [74,112,139],  slateblue:            [106,90,205],
+  slateblue1:           [131,111,255], slateblue2:           [122,103,238],
+  slateblue3:           [105,89,205],  slateblue4:           [71,60,139],
+  slategray:            [112,128,144], slategray1:           [198,226,255],
+  slategray2:           [185,211,238], slategray3:           [159,182,205],
+  slategray4:           [108,123,139], slategrey:            [112,128,144],
+  snow:                 [255,250,250], snow1:                [255,250,250],
+  snow2:                [238,233,233], snow3:                [205,201,201],
+  snow4:                [139,137,137], springgreen:          [0,255,127],
+  springgreen1:         [0,255,127],   springgreen2:         [0,238,118],
+  springgreen3:         [0,205,102],   springgreen4:         [0,139,69],
+  steelblue:            [70,130,180],  steelblue1:           [99,184,255],
+  steelblue2:           [92,172,238],  steelblue3:           [79,148,205],
+  steelblue4:           [54,100,139],  tan:                  [210,180,140],
+  tan1:                 [255,165,79],  tan2:                 [238,154,73],
+  tan3:                 [205,133,63],  tan4:                 [139,90,43],
+  thistle:              [216,191,216], thistle1:             [255,225,255],
+  thistle2:             [238,210,238], thistle3:             [205,181,205],
+  thistle4:             [139,123,139], tomato:               [255,99,71],
+  tomato1:              [255,99,71],   tomato2:              [238,92,66],
+  tomato3:              [205,79,57],   tomato4:              [139,54,38],
+  turquoise:            [64,224,208],  turquoise1:           [0,245,255],
+  turquoise2:           [0,229,238],   turquoise3:           [0,197,205],
+  turquoise4:           [0,134,139],   violet:               [238,130,238],
+  violetred:            [208,32,144],  violetred1:           [255,62,150],
+  violetred2:           [238,58,140],  violetred3:           [205,50,120],
+  violetred4:           [139,34,82],   wheat:                [245,222,179],
+  wheat1:               [255,231,186], wheat2:               [238,216,174],
+  wheat3:               [205,186,150], wheat4:               [139,126,102],
+  white:                [255,255,255], whitesmoke:           [245,245,245],
+  yellow:               [255,255,0],   yellow1:              [255,255,0],
+  yellow2:              [238,238,0],   yellow3:              [205,205,0],
+  yellow4:              [139,139,0],   yellowgreen:          [154,205,50],
+};
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 20: COLOR UTILITIES
+// ────────────────────────────────────────────────────────────
+
+/**
+ * Normalize an X11 color name (lowercase, remove spaces/hyphens).
+ */
+function _normColorName(name) {
+  return name.toLowerCase().replace(/[\s\-_]/g, '');
+}
+
+/**
+ * Look up an X11 named color. Returns [r,g,b] or null.
+ * @param {string} name
+ * @returns {[number,number,number]|null}
+ */
+function colorByName(name) {
+  return X11Colors[_normColorName(name)] || null;
+}
+
+/**
+ * Look up an X11 color name by exact [r,g,b] values.
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @returns {string|null}
+ */
+function colorNameByRGB(r, g, b) {
+  for (const [name, [cr,cg,cb]] of Object.entries(X11Colors)) {
+    if (cr === r && cg === g && cb === b) return name;
+  }
+  return null;
+}
+
+/**
+ * Find the closest X11 named color to an [r,g,b] value.
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @returns {{ name: string, rgb: [number,number,number], distance: number }}
+ */
+function closestColor(r, g, b) {
+  let best = null, bestDist = Infinity;
+  for (const [name, [cr,cg,cb]] of Object.entries(X11Colors)) {
+    const d = (r-cr)**2 + (g-cg)**2 + (b-cb)**2;
+    if (d < bestDist) { bestDist = d; best = { name, rgb: [cr,cg,cb], distance: Math.sqrt(d) }; }
+  }
+  return best;
+}
+
+/**
+ * Parse a color string in any common format:
+ *   '#RGB', '#RRGGBB', 'rgb(r,g,b)', 'X11 name'
+ * Returns { r, g, b } or null.
+ * @param {string} str
+ * @returns {{r:number, g:number, b:number}|null}
+ */
+function parseColor(str) {
+  str = str.trim();
+  // #RGB
+  if (/^#[0-9a-fA-F]{3}$/.test(str)) {
+    const [,r,g,b] = str.match(/^#(.)(.)(.)$/);
+    return { r: parseInt(r+r,16), g: parseInt(g+g,16), b: parseInt(b+b,16) };
+  }
+  // #RRGGBB
+  if (/^#[0-9a-fA-F]{6}$/.test(str)) {
+    return { r: parseInt(str.slice(1,3),16), g: parseInt(str.slice(3,5),16), b: parseInt(str.slice(5,7),16) };
+  }
+  // rgb(r,g,b)
+  const rgbMatch = str.match(/^rgb\s*\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/i);
+  if (rgbMatch) return { r: +rgbMatch[1], g: +rgbMatch[2], b: +rgbMatch[3] };
+  // X11 name
+  const named = colorByName(str);
+  if (named) return { r: named[0], g: named[1], b: named[2] };
+  return null;
+}
+
+/**
+ * Convert [r,g,b] to hex string.
+ * @param {number} r @param {number} g @param {number} b
+ * @returns {string}
+ */
+function rgbToHex(r, g, b) {
+  return '#' + [r,g,b].map(v => Math.max(0,Math.min(255,v)).toString(16).padStart(2,'0').toUpperCase()).join('');
+}
+
+/**
+ * Convert [r,g,b] to HSL { h, s, l } (h: 0-360, s/l: 0-100).
+ */
+function rgbToHSL(r, g, b) {
+  r /= 255; g /= 255; b /= 255;
+  const max = Math.max(r,g,b), min = Math.min(r,g,b);
+  const l = (max+min)/2;
+  if (max === min) return { h:0, s:0, l: Math.round(l*100) };
+  const d = max - min;
+  const s = l > 0.5 ? d/(2-max-min) : d/(max+min);
+  let h;
+  if (max===r) h = ((g-b)/d + (g<b?6:0))/6;
+  else if (max===g) h = ((b-r)/d+2)/6;
+  else h = ((r-g)/d+4)/6;
+  return { h: Math.round(h*360), s: Math.round(s*100), l: Math.round(l*100) };
+}
+
+/**
+ * Convert HSL { h, s, l } to [r, g, b].
+ */
+function hslToRGB(h, s, l) {
+  s /= 100; l /= 100;
+  const c = (1 - Math.abs(2*l-1)) * s;
+  const x = c * (1 - Math.abs((h/60)%2 - 1));
+  const m = l - c/2;
+  let r=0,g=0,b=0;
+  if      (h<60)  { r=c; g=x; }
+  else if (h<120) { r=x; g=c; }
+  else if (h<180) { g=c; b=x; }
+  else if (h<240) { g=x; b=c; }
+  else if (h<300) { r=x; b=c; }
+  else            { r=c; b=x; }
+  return [Math.round((r+m)*255), Math.round((g+m)*255), Math.round((b+m)*255)];
+}
+
+/**
+ * Convert [r,g,b] to HSV { h, s, v } (h: 0-360, s/v: 0-100).
+ */
+function rgbToHSV(r, g, b) {
+  r /= 255; g /= 255; b /= 255;
+  const max = Math.max(r,g,b), min = Math.min(r,g,b), d = max-min;
+  const v = max;
+  const s = max === 0 ? 0 : d/max;
+  let h = 0;
+  if (d !== 0) {
+    if      (max===r) h = ((g-b)/d)%6;
+    else if (max===g) h = (b-r)/d+2;
+    else              h = (r-g)/d+4;
+    h = h/6;
+    if (h<0) h+=1;
+  }
+  return { h: Math.round(h*360), s: Math.round(s*100), v: Math.round(v*100) };
+}
+
+/**
+ * Convert HSV to [r,g,b].
+ */
+function hsvToRGB(h, s, v) {
+  s /= 100; v /= 100;
+  const c = v*s, x = c*(1-Math.abs((h/60)%2-1)), m = v-c;
+  let r=0,g=0,b=0;
+  if      (h<60)  { r=c; g=x; }
+  else if (h<120) { r=x; g=c; }
+  else if (h<180) { g=c; b=x; }
+  else if (h<240) { g=x; b=c; }
+  else if (h<300) { r=x; b=c; }
+  else            { r=c; b=x; }
+  return [Math.round((r+m)*255), Math.round((g+m)*255), Math.round((b+m)*255)];
+}
+
+/**
+ * Convert [r,g,b] to X11 16-bit format (0–65535 per channel).
+ */
+function rgbToX11(r, g, b) {
+  return { r: r*257, g: g*257, b: b*257 };
+}
+
+/**
+ * Convert X11 16-bit format to [r,g,b] (0–255).
+ */
+function x11ToRGB(r, g, b) {
+  return [Math.round(r/257), Math.round(g/257), Math.round(b/257)];
+}
+
+/**
+ * Calculate relative luminance (WCAG).
+ */
+function luminance(r, g, b) {
+  const c = [r,g,b].map(v => { v /= 255; return v <= 0.03928 ? v/12.92 : ((v+0.055)/1.055)**2.4; });
+  return 0.2126*c[0] + 0.7152*c[1] + 0.0722*c[2];
+}
+
+/**
+ * Calculate WCAG contrast ratio between two colors.
+ * @param {[number,number,number]} c1
+ * @param {[number,number,number]} c2
+ * @returns {number}  ratio (1-21)
+ */
+function contrastRatio(c1, c2) {
+  const l1 = luminance(...c1), l2 = luminance(...c2);
+  return (Math.max(l1,l2)+0.05) / (Math.min(l1,l2)+0.05);
+}
+
+/**
+ * Check WCAG accessibility level.
+ * @returns {'AAA'|'AA'|'AA Large'|'Fail'}
+ */
+function wcagLevel(c1, c2) {
+  const r = contrastRatio(c1, c2);
+  if (r >= 7)   return 'AAA';
+  if (r >= 4.5) return 'AA';
+  if (r >= 3)   return 'AA Large';
+  return 'Fail';
+}
+
+/**
+ * Mix two [r,g,b] colors.
+ * @param {[number,number,number]} c1
+ * @param {[number,number,number]} c2
+ * @param {number} [t=0.5] mix factor 0=c1, 1=c2
+ * @returns {[number,number,number]}
+ */
+function mixColors(c1, c2, t = 0.5) {
+  return c1.map((v,i) => Math.round(v + (c2[i]-v)*t));
+}
+
+/**
+ * Search X11 colors by partial name.
+ * @param {string} query
+ * @returns {Array<{name:string, rgb:[number,number,number]}>}
+ */
+function searchColors(query) {
+  const q = _normColorName(query);
+  return Object.entries(X11Colors)
+    .filter(([name]) => name.includes(q))
+    .map(([name, rgb]) => ({ name, rgb }));
+}
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 21: PROTOCOL MESSAGE BUILDERS
+// ────────────────────────────────────────────────────────────
+
+// ── FIX 1: Runtime byte-order detection ──────────────────────
+// The X11 protocol lets the client declare its native byte order.
+// We detect it at load time instead of hard-coding little-endian,
+// so the same code works on big-endian hosts (SPARC, PowerPC, etc.).
+const _hostIsLE = (() => {
+  const b = new Uint8Array(2);
+  new DataView(b.buffer).setUint16(0, 1, true); // write 1 as LE
+  return b[0] === 1;                             // true if host is LE
+})();
+
+const _byteOrderMarker = _hostIsLE ? 0x6C /* 'l' */ : 0x42 /* 'B' */;
+
+/**
+ * Write a uint16 / uint32 in the host's native byte order.
+ * @internal
+ */
+function _setU16(view, offset, val) { view.setUint16(offset, val, _hostIsLE); }
+function _setU32(view, offset, val) { view.setUint32(offset, val, _hostIsLE); }
+function _setI16(view, offset, val) { view.setInt16(offset,  val, _hostIsLE); }
+
+// ── FIX 2: Auth-aware connection request ─────────────────────
+/**
+ * Build an X11 connection setup request (RFC / Xlib §8).
+ *
+ * The packet includes optional MIT-MAGIC-COOKIE-1 authorisation data so
+ * that callers can connect to servers that require authentication (i.e.
+ * virtually every real display server).
+ *
+ * @param {object}     [opts]
+ * @param {number}     [opts.majorVersion=11]    Protocol major version
+ * @param {number}     [opts.minorVersion=0]     Protocol minor version
+ * @param {string}     [opts.authName='']        e.g. 'MIT-MAGIC-COOKIE-1'
+ * @param {Uint8Array} [opts.authData]           Raw auth data bytes
+ * @returns {Uint8Array}  Ready-to-send connection setup packet
+ *
+ * @example
+ * // No auth (e.g. Xvfb with -nolisten tcp and xhost +)
+ * buildConnectionRequest();
+ *
+ * // MIT-MAGIC-COOKIE-1 (read from ~/.Xauthority via the 'xauth' package)
+ * buildConnectionRequest({
+ *   authName: 'MIT-MAGIC-COOKIE-1',
+ *   authData: Uint8Array.from(Buffer.from(cookieHex, 'hex')),
+ * });
+ */
+function buildConnectionRequest(opts = {}) {
+  const major    = opts.majorVersion ?? 11;
+  const minor    = opts.minorVersion ?? 0;
+  const authName = opts.authName     ?? '';
+  const authData = opts.authData     ?? new Uint8Array(0);
+
+  const enc          = new TextEncoder();
+  const nameBytes    = enc.encode(authName);
+  const namePad      = (4 - (nameBytes.length % 4)) % 4;
+  const dataPad      = (4 - (authData.length % 4)) % 4;
+
+  const totalLen = 12 + nameBytes.length + namePad + authData.length + dataPad;
+  const buf  = new Uint8Array(totalLen);
+  const view = new DataView(buf.buffer);
+
+  view.setUint8(0, _byteOrderMarker); // byte-order (host-native)
+  view.setUint8(1, 0);                // unused
+  _setU16(view, 2, major);            // protocol-major-version
+  _setU16(view, 4, minor);            // protocol-minor-version
+  _setU16(view, 6, nameBytes.length); // auth-proto-name-length
+  _setU16(view, 8, authData.length);  // auth-proto-data-length
+  _setU16(view, 10, 0);               // unused
+
+  let off = 12;
+  buf.set(nameBytes, off); off += nameBytes.length + namePad;
+  buf.set(authData,  off);
+
+  return buf;
+}
+
+/**
+ * Build a CreateWindow request buffer.
+ * @param {object} attrs
+ * @returns {Uint8Array}
+ */
+function buildCreateWindowRequest(attrs) {
+  const {
+    wid, parent, x=0, y=0, width=100, height=100,
+    borderWidth=0, windowClass=WindowClass.INPUT_OUTPUT,
+    visual=0, valueMask=0, values=[]
+  } = attrs;
+  const len = 8 + values.length;
+  const buf = new Uint8Array(len * 4);
+  const v = new DataView(buf.buffer);
+  v.setUint8(0, Request.CREATE_WINDOW);
+  v.setUint8(1, 0); // depth
+  _setU16(v, 2, len);
+  _setU32(v, 4, wid);
+  _setU32(v, 8, parent);
+  _setI16(v, 12, x);
+  _setI16(v, 14, y);
+  _setU16(v, 16, width);
+  _setU16(v, 18, height);
+  _setU16(v, 20, borderWidth);
+  _setU16(v, 22, windowClass);
+  _setU32(v, 24, visual);
+  _setU32(v, 28, valueMask);
+  values.forEach((val, i) => _setU32(v, 32 + i*4, val));
+  return buf;
+}
+
+/**
+ * Build a MapWindow request.
+ * @param {number} wid
+ * @returns {Uint8Array}
+ */
+function buildMapWindowRequest(wid) {
+  const buf = new Uint8Array(8);
+  const v = new DataView(buf.buffer);
+  v.setUint8(0, Request.MAP_WINDOW);
+  v.setUint8(1, 0);
+  _setU16(v, 2, 2);
+  _setU32(v, 4, wid);
+  return buf;
+}
+
+/**
+ * Build a ChangeProperty request.
+ * @param {object} attrs
+ * @returns {Uint8Array}
+ */
+function buildChangePropertyRequest(attrs) {
+  const { wid, mode=PropMode.REPLACE, property, type, format=PropFormat.F32, data=[] } = attrs;
+  const dataBytes = format === 8 ? data.length : format === 16 ? data.length*2 : data.length*4;
+  const padded = Math.ceil(dataBytes / 4) * 4;
+  const len = 6 + padded/4;
+  const buf = new Uint8Array(len * 4);
+  const v = new DataView(buf.buffer);
+  v.setUint8(0, Request.CHANGE_PROPERTY);
+  v.setUint8(1, mode);
+  _setU16(v, 2, len);
+  _setU32(v, 4, wid);
+  _setU32(v, 8, property);
+  _setU32(v, 12, type);
+  v.setUint8(16, format);
+  // bytes 17-19: unused
+  _setU32(v, 20, data.length);
+  data.forEach((val, i) => {
+    if (format === 8)       v.setUint8(24+i, val);
+    else if (format === 16) _setU16(v, 24+i*2, val);
+    else                    _setU32(v, 24+i*4, val);
+  });
+  return buf;
+}
+
+/**
+ * Build an InternAtom request.
+ * @param {string} name
+ * @param {boolean} [onlyIfExists=false]
+ * @returns {Uint8Array}
+ */
+function buildInternAtomRequest(name, onlyIfExists = false) {
+  const encoded = new TextEncoder().encode(name);
+  const padded  = Math.ceil(encoded.length / 4) * 4;
+  const len = 2 + padded/4;
+  const buf = new Uint8Array(len * 4);
+  const v   = new DataView(buf.buffer);
+  v.setUint8(0, Request.INTERN_ATOM);
+  v.setUint8(1, onlyIfExists ? 1 : 0);
+  _setU16(v, 2, len);
+  _setU16(v, 4, encoded.length);
+  buf.set(encoded, 8);
+  return buf;
+}
+
+// ── FIX 3: Extension negotiation helper ──────────────────────
+/**
+ * Build a QueryExtension request for the given extension name string.
+ * Use this to probe whether a given extension is available before
+ * sending any extension-specific requests.
+ *
+ * @param {string} name  e.g. Extension.RANDR ('RANDR')
+ * @returns {Uint8Array}
+ *
+ * @example
+ * // Node.js with a raw socket to the X11 display:
+ * socket.write(buildQueryExtensionRequest(Extension.RANDR));
+ * // Parse the reply: reply[8] is 'present' (1 = yes, 0 = not present)
+ */
+function buildQueryExtensionRequest(name) {
+  const encoded = new TextEncoder().encode(name);
+  const padded  = Math.ceil(encoded.length / 4) * 4;
+  const len = 2 + padded / 4;
+  const buf = new Uint8Array(len * 4);
+  const v   = new DataView(buf.buffer);
+  v.setUint8(0, Request.QUERY_EXTENSION);
+  v.setUint8(1, 0);
+  _setU16(v, 2, len);
+  _setU16(v, 4, encoded.length);
+  // bytes 6-7: unused
+  buf.set(encoded, 8);
+  return buf;
+}
+
+/**
+ * Parse a QueryExtension reply (32-byte fixed-size reply).
+ * Call this with the raw reply Uint8Array received from the server.
+ *
+ * @param {Uint8Array} reply
+ * @returns {{ present: boolean, majorOpcode: number, firstEvent: number, firstError: number }}
+ */
+function parseQueryExtensionReply(reply) {
+  if (reply.length < 32) throw new RangeError('QueryExtension reply must be ≥ 32 bytes');
+  const v = new DataView(reply.buffer, reply.byteOffset, reply.byteLength);
+  return {
+    present:      v.getUint8(8) === 1,
+    majorOpcode:  v.getUint8(9),
+    firstEvent:   v.getUint8(10),
+    firstError:   v.getUint8(11),
+  };
+}
+
+/**
+ * Convenience: throw a clear error when an extension is not present.
+ * Call this after parsing the QueryExtension reply for a required extension.
+ *
+ * @param {string} name           Extension name (for the error message)
+ * @param {ReturnType<parseQueryExtensionReply>} reply
+ * @throws {Error} if reply.present is false
+ */
+function assertExtension(name, reply) {
+  if (!reply.present) {
+    throw new Error(
+      `X11 extension "${name}" is not available on this server. ` +
+      `Check server capabilities with buildQueryExtensionRequest() before use.`
+    );
+  }
+}
+
+// ────────────────────────────────────────────────────────────
+//  SECTION 22: EXTENSION CONSTANTS
+// ────────────────────────────────────────────────────────────
+
+/** Common X11 extension names */
+const Extension = {
+  BIGREQ:       'BIG-REQUESTS',
+  COMPOSITE:    'Composite',
+  DAMAGE:       'DAMAGE',
+  DPMS:         'DPMS',
+  DRI2:         'DRI2',
+  DRI3:         'DRI3',
+  FIXES:        'XFIXES',
+  GENERIC_EVENT:'Generic Event Extension',
+  GLX:          'GLX',
+  INPUT:        'XInputExtension',
+  PRESENT:      'Present',
+  RANDR:        'RANDR',
+  RECORD:       'RECORD',
+  RENDER:       'RENDER',
+  RESOURCE:     'X-Resource',
+  SCREENSAVER:  'MIT-SCREEN-SAVER',
+  SHAPE:        'SHAPE',
+  SHM:          'MIT-SHM',
+  SYNC:         'SYNC',
+  TEST:         'XTEST',
+  VIDEO:        'XVideo',
+  XINERAMA:     'XINERAMA',
+  XKB:          'XKEYBOARD',
+  XPRINT:       'XpExtension',
+};
+
+/** XRANDR rotation/reflection flags */
+const RandrRotation = {
+  ROTATE_0:   1,
+  ROTATE_90:  2,
+  ROTATE_180: 4,
+  ROTATE_270: 8,
+  REFLECT_X:  16,
+  REFLECT_Y:  32,
+};
+
+/** XRANDR connection status */
+const RandrConnection = {
+  CONNECTED:         0,
+  DISCONNECTED:      1,
+  UNKNOWN_CONNECTION:2,
+};
+
+/** XRender picture format types */
+const PictType = {
+  INDEXED: 0,
+  DIRECT:  1,
+};
+
+/** XRender repeat types */
+const RepeatType = {
+  NONE:    0,
+  NORMAL:  1,
+  PAD:     2,
+  REFLECT: 3,
+};
+
+/** XInput2 device types */
+const XIDeviceType = {
+  MASTER_POINTER:  1,
+  MASTER_KEYBOARD: 2,
+  SLAVE_POINTER:   3,
+  SLAVE_KEYBOARD:  4,
+  FLOATING_SLAVE:  5,
+};
+
+/** XFIXES region operations */
+const FixesRegionOp = {
+  SET:       0,
+  UNION:     1,
+  INTERSECT: 2,
+  SUBTRACT:  3,
+  INVERT:    4,
+};
+
+/** XSync counter value sign */
+const SyncValueType = {
+  ABSOLUTE: 0,
+  RELATIVE: 1,
+};
+
+/** COMPOSITE redirect modes */
+const CompositeRedirect = {
+  AUTOMATIC: 0,
+  MANUAL:    1,
+};
+
+// ────────────────────────────────────────────────────────────
+//  EXPORTS
+// ────────────────────────────────────────────────────────────
+//  EXPORTS  (FIX 4: dual CJS + ESM shim)
+// ────────────────────────────────────────────────────────────
+
+const kitdef = {
+  // ── Host byte-order (runtime) ────────────────────
+  hostIsLittleEndian: _hostIsLE,
+  byteOrderMarker:    _byteOrderMarker,
+
+  // ── Protocol fundamentals ────────────────────────
+  PROTOCOL, ByteOrder, XID, XBool, Time,
+
+  // ── Events ───────────────────────────────────────
+  EventType, EventTypeName, EventMask, decodeEventMask,
+
+  // ── Requests ─────────────────────────────────────
+  Request, RequestName,
+
+  // ── Errors ───────────────────────────────────────
+  ErrorCode, ErrorName,
+
+  // ── Window ───────────────────────────────────────
+  CW, WindowClass, MapState, BackingStore, BitGravity, WinGravity,
+
+  // ── Graphics Context ─────────────────────────────
+  GCMask, GCFunction, LineStyle, CapStyle, JoinStyle,
+  FillStyle, FillRule, ArcMode, SubwindowMode,
+
+  // ── Input ────────────────────────────────────────
+  ModifierMask, Button, FocusMode, RevertTo, GrabMode, GrabStatus,
+  AllowEvents, NotifyMode, NotifyDetail, Visibility, Circulate,
+  PropertyState, ColormapState, MappingRequest,
+
+  // ── Screen / Power ───────────────────────────────
+  ScreenSaver, ScreenSaverState, ScreenSaverKind, Blanking, Exposures,
+
+  // ── Host / Access ────────────────────────────────
+  HostFamily, AccessControl, CloseDownMode,
+
+  // ── Colormap / Visual ────────────────────────────
+  ColormapAlloc, VisualClass,
+
+  // ── Image ────────────────────────────────────────
+  ImageFormat, BitmapBitOrder, ByteOrderConst, QueryBestSizeClass,
+
+  // ── Atoms ────────────────────────────────────────
+  Atom, AtomName,
+
+  // ── ICCCM ────────────────────────────────────────
+  ICCCM, WMState, WMHints, SizeHints,
+
+  // ── EWMH ─────────────────────────────────────────
+  EWMH, EWMHStateAction, MoveResizeDirection,
+
+  // ── Selections / Properties ──────────────────────
+  SelectionType, PropMode, PropFormat,
+
+  // ── Keysyms ──────────────────────────────────────
+  Keysym, KeysymName,
+  keysymByName, keysymToName, keysymToUnicode, keysymToChar,
+  unicodeToKeysym, isModifierKeysym, isFunctionKeysym,
+  isKeypadKeysym, isPrintableKeysym,
+
+  // ── X11 Colors ───────────────────────────────────
+  X11Colors,
+  colorByName, colorNameByRGB, closestColor,
+  parseColor, rgbToHex,
+  rgbToHSL, hslToRGB, rgbToHSV, hsvToRGB,
+  rgbToX11, x11ToRGB,
+  luminance, contrastRatio, wcagLevel,
+  mixColors, searchColors,
+
+  // ── Protocol message builders ────────────────────
+  buildConnectionRequest,        // FIX 1+2: endian-aware + auth support
+  buildCreateWindowRequest,      // FIX 1: endian-aware
+  buildMapWindowRequest,         // FIX 1: endian-aware
+  buildChangePropertyRequest,    // FIX 1: endian-aware
+  buildInternAtomRequest,        // FIX 1: endian-aware
+
+  // ── Extension negotiation (FIX 3) ────────────────
+  buildQueryExtensionRequest,
+  parseQueryExtensionReply,
+  assertExtension,
+
+  // ── Extensions ───────────────────────────────────
+  Extension,
+  RandrRotation, RandrConnection,
+  PictType, RepeatType,
+  XIDeviceType,
+  FixesRegionOp,
+  SyncValueType,
+  CompositeRedirect,
+};
+
+// FIX 4: Dual CommonJS + ESM export shim.
+//
+//   CJS (Node.js require):  const { kitdef } = require('./kitx11.js')
+//   ESM (import / browser): import { kitdef } from './kitx11.js'
+//
+// The 'typeof' guard is evaluated at runtime so bundlers targeting
+// pure-ESM environments can tree-shake the CJS branch away.
+if (typeof module !== 'undefined' && typeof module.exports !== 'undefined') {
+  // CommonJS (Node.js)
+  module.exports = { kitdef };
+} else if (typeof globalThis !== 'undefined') {
+  // Browser global fallback (no bundler, no module system)
+  globalThis.kitx11 = { kitdef };
+}
+