@yuneta/gobj-ui 3.0.0 → 4.0.0

package/src/c_yui_window.js

@@ -27,6 +27,7 @@ import {
     kw_set_local_storage_value,
     gobj_read_attr,
     gobj_read_bool_attr,
+    gobj_read_str_attr,
     gobj_is_service,
     gobj_name,
     gobj_read_integer_attr,
@@ -34,18 +35,22 @@ import {
     gobj_destroy,
     gobj_write_bool_attr,
     gobj_write_integer_attr,
-    gobj_unsubscribe_event,
     gobj_stop,
     gobj_stop_children,
     gobj_is_running,
     gobj_is_destroying,
     refresh_language,
+    empty_string,
 } from "@yuneta/gobj-js";
 
 import {t} from "i18next";
 
 import {yui_shell_confirm_yesnocancel} from "./shell_modals.js";
-import {yui_shell_of} from "./c_yui_shell.js";
+import {
+    yui_shell_of,
+    yui_shell_register_overlay,
+    yui_shell_overlay_dismissed,
+} from "./c_yui_shell.js";
 
 import "./c_yui_window.css";
 
@@ -78,7 +83,7 @@ SDATA(data_type_t.DTP_INTEGER,  "y",            0,  "100",  "Y position"),
 SDATA(data_type_t.DTP_INTEGER,  "width",        0,  "700",  "Width of the window"),
 SDATA(data_type_t.DTP_INTEGER,  "height",       0,  "500",  "Height of the window"),
 SDATA(data_type_t.DTP_BOOLEAN,  "auto_save_size_and_position", 0, false, "Automatically save size and position"),
-SDATA(data_type_t.DTP_POINTER,  "header",       0,  null,   "Can be a gobj with $container or any createElement2() 'content' parameter"),
+SDATA(data_type_t.DTP_POINTER,  "header",       0,  null,   "Title-bar content, overriding the default `icon`+`title` strip: a gobj with $container or any createElement2() 'content' parameter. Only for a bar that is more than a title (e.g. a toolbar)"),
 SDATA(data_type_t.DTP_POINTER,  "body",         0,  null,   "Can be a gobj with $container or any createElement2() 'content' parameter"),
 SDATA(data_type_t.DTP_POINTER, "footer",       0,  null,   "Can be a gobj with $container or any createElement2() 'content' parameter"),
 SDATA(data_type_t.DTP_BOOLEAN,  "center",       0,  true,   "Center the window"),
@@ -88,17 +93,21 @@ SDATA(data_type_t.DTP_BOOLEAN,  "resizable",    0,  true,   "Allow resizing"),
 SDATA(data_type_t.DTP_BOOLEAN,  "showFooter",   0,  true,   "Show footer"),
 SDATA(data_type_t.DTP_BOOLEAN,  "openMaximized",0,  false,  "Open the window maximized"),
 SDATA(data_type_t.DTP_BOOLEAN,  "showMax",      0,  true,   "Show maximize button"),
-SDATA(data_type_t.DTP_BOOLEAN,  "showMin",      0,  true,   "Show minimize (roll-up / shade) button"),
+SDATA(data_type_t.DTP_BOOLEAN,  "showMin",      0,  true,   "Show minimize (to dock) button; ignored without a `manager`"),
 SDATA(data_type_t.DTP_BOOLEAN,  "maximized",    0,  false,  "Flag to indicate if maximized"),
 SDATA(data_type_t.DTP_JSON,     "window_style", 0,  "{}",   "Override window style"),
 SDATA(data_type_t.DTP_POINTER,  "on_close",     0,  null,   "Callback on destroy"),
 SDATA(data_type_t.DTP_POINTER,  "manager",      0,  null,   "Optional C_YUI_WINDOW_MANAGER (gobj or service name) for dock/taskbar"),
-SDATA(data_type_t.DTP_STRING,   "title",        0,  "",     "Window title, shown on the dock chip"),
-SDATA(data_type_t.DTP_STRING,   "icon",         0,  "",     "Dock-chip icon: a yi-* class name or inline SVG (by window type)"),
+SDATA(data_type_t.DTP_STRING,   "logical_class",0,  "",     "Logical UPPER_SNAKE class(es) added to the window root, so the app can target THIS window exactly (e.g. 'TRANGER_KEYS_WINDOW')"),
+SDATA(data_type_t.DTP_STRING,   "title_prefix", 0,  "",     "Optional DATA half of the title (a topic/service/marker name), shown before `title` and never translated. Use it instead of composing `${name} · ${t(key)}` into `title`, which cannot re-translate"),
+SDATA(data_type_t.DTP_STRING,   "title",        0,  "",     "Window title, an i18n KEY: painted in the title bar (unless `header` overrides it) and on the dock chip. Pass the key, not t(key), or it cannot re-translate"),
+SDATA(data_type_t.DTP_STRING,   "icon",         0,  "",     "Window icon (by window type), leading the title bar and the dock chip: a yi-* class name or inline SVG"),
 // TODO pendiente focus modal keyboard
 SDATA(data_type_t.DTP_POINTER,  "focus",        0,  null,   "Brings focus to the element, can be a number or selector"),
 SDATA(data_type_t.DTP_BOOLEAN,  "modal",        0,  false,  "Enable modal mode"),
 SDATA(data_type_t.DTP_BOOLEAN,  "keyboard",     0,  true,   "Close window on ESC if not modal"),
+SDATA(data_type_t.DTP_BOOLEAN,  "back_dismissable", 0, true, "Browser Back closes this window (floating overlays only; ignored when it has a `manager`)"),
+SDATA(data_type_t.DTP_POINTER,  "back_overlay", 0,  null,   "Internal: overlay-history entry (Back-button integration)"),
 SDATA(data_type_t.DTP_POINTER,  "$container",   0,  null,   "Internal: Window container element"),
 SDATA(data_type_t.DTP_STRING,   "window_id",    0,  "",     "Internal: Window ID"),
 SDATA(data_type_t.DTP_POINTER,  "win_resize_handler", 0, null, "Internal: native window 'resize' listener"),
@@ -107,7 +116,6 @@ SDATA_END()
 
 let PRIVATE_DATA = {
     prevSize: 0,
-    preShadeHeight: 0,
 };
 
 let __gclass__ = null;
@@ -137,12 +145,15 @@ function mt_create(gobj)
 
     let window_id = "window-" + clean_name(gobj_short_name(gobj));
     gobj_write_attr(gobj, "window_id", window_id);
-    build_ui(gobj);
 
     /*  Optional window manager (dock/taskbar): register, and raise/
-     *  highlight on any pointer press. Absent → the window is a plain
-     *  floating window and minimize falls back to shade in place. */
+     *  highlight on any pointer press. Resolved BEFORE build_ui: minimize
+     *  means "send to the dock", so without a manager there is nowhere to
+     *  minimize TO and build_ui must not paint the button at all. */
     let manager = resolve_manager(gobj);
+
+    build_ui(gobj);
+
     if(manager) {
         let $c = gobj_read_attr(gobj, "$container");
         if($c) {
@@ -153,21 +164,44 @@ function mt_create(gobj)
                 }
             }, true);
         }
+        /*  The chip gets the SPLIT halves so its label re-translates
+         *  like the title bar: `title_key` is the i18n KEY (the chip
+         *  renders it with data-i18n, so refresh_language reaches it),
+         *  `title` the translated fallback text so the chip is born in
+         *  the current language (the manager has no translator of its
+         *  own), `title_prefix` the DATA half, never translated. */
+        let chip_title = composed_title(gobj);
         gobj_send_event(manager, "EV_REGISTER_WINDOW", {
             window: gobj,
-            title: gobj_read_attr(gobj, "title") || gobj_short_name(gobj),
+            title: chip_title ? chip_title : gobj_short_name(gobj),
+            title_key: gobj_read_str_attr(gobj, "title") || "",
+            title_kind_text: empty_string(gobj_read_str_attr(gobj, "title"))
+                ? "" : t(gobj_read_str_attr(gobj, "title")),
+            title_prefix: gobj_read_str_attr(gobj, "title_prefix") || "",
             icon: gobj_read_attr(gobj, "icon") || "",
         }, gobj);
+    } else if(gobj_read_bool_attr(gobj, "back_dismissable")) {
+        /*  Floating overlay window (no dock manager): the browser Back
+         *  button closes it, like a modal/popup.  Dock-managed windows
+         *  are persistent workspace surfaces and are left out.  Retired
+         *  in mt_destroy (covers every teardown path). */
+        let shell = yui_shell_of(gobj);
+        if(shell) {
+            let overlay = yui_shell_register_overlay(
+                shell, function() { close_window(gobj); }
+            );
+            gobj_write_attr(gobj, "back_overlay", overlay);
+        }
     }
 
     /*  Keep the window inside the viewport on a breakpoint change.
-     *  Wired in mt_create (NOT mt_start) on purpose: windows are
-     *  often created via gobj_create_service WITHOUT being started
-     *  (e.g. setup_dev, the connection-info window), so mt_start
-     *  never runs — the legacy __yui_main__/EV_RESIZE path is dead
-     *  under C_YUI_SHELL too.  A native 'resize' listener is
-     *  start-independent and reuses handleResize() (clamp-to-screen
-     *  + optional re-center).  Detached in mt_destroy. */
+     *  The browser's own 'resize' is the source: this IS the OS
+     *  notification, and handleResize() clamps to screen (+ optional
+     *  re-center).  The legacy path — subscribing to EV_RESIZE from a
+     *  C_YUI_MAIN "__yui_main__" service — was retired: C_YUI_SHELL has
+     *  no such service, so it never fired under v2, and it duplicated
+     *  this listener wherever an app did provide one.  Detached in
+     *  mt_destroy. */
     let on_win_resize = function() {
         handleResize(gobj);
     };
@@ -175,29 +209,6 @@ function mt_create(gobj)
     window.addEventListener("resize", on_win_resize);
 }
 
-/***************************************************************
- *          Framework Method: Start
- ***************************************************************/
-function mt_start(gobj)
-{
-    let __yui_main__ = gobj_find_service("__yui_main__", false);
-    if(__yui_main__) {
-        gobj_subscribe_event(__yui_main__, "EV_RESIZE", {}, gobj);
-    }
-}
-
-/***************************************************************
- *          Framework Method: Stop
- ***************************************************************/
-function mt_stop(gobj)
-{
-    // TODO quita esto para chequear el fallo dl_subscribings not implemented
-    let __yui_main__ = gobj_find_service("__yui_main__", false);
-    if(__yui_main__) {
-        gobj_unsubscribe_event(__yui_main__, "EV_RESIZE", {}, gobj);
-    }
-}
-
 /***************************************************************
  *          Framework Method: Destroy
  ***************************************************************/
@@ -208,6 +219,17 @@ function mt_destroy(gobj)
         gobj_send_event(manager, "EV_UNREGISTER_WINDOW", {window: gobj}, gobj);
     }
 
+    /*  Retire the overlay-history entry, if this was a Back-dismissable
+     *  floating window (no-op when Back itself triggered the teardown). */
+    let back_overlay = gobj_read_attr(gobj, "back_overlay");
+    if(back_overlay) {
+        let shell = yui_shell_of(gobj);
+        if(shell) {
+            yui_shell_overlay_dismissed(shell, back_overlay);
+        }
+        gobj_write_attr(gobj, "back_overlay", null);
+    }
+
     let on_win_resize = gobj_read_attr(gobj, "win_resize_handler");
     if(on_win_resize) {
         window.removeEventListener("resize", on_win_resize);
@@ -243,6 +265,16 @@ function ensure_window_style()
     -webkit-user-select: none; user-select: none;
 }
 .yui-window-titlebar-controls { display: flex; align-items: center; gap: 2px; padding-left: 6px; }
+.yui-window-title { white-space: nowrap; }
+.yui-window-title .icon { flex: 0 0 auto; }
+.yui-window-title svg { width: 14px; height: 14px; display: block; }
+/*  Separator between the data half and the translated kind half. CSS,
+ *  not a text node: createElement2 trims text nodes and eats the spaces. */
+.WINDOW_TITLE_PREFIX + .WINDOW_TITLE_KIND::before {
+    content: "·";
+    padding: 0 0.4em;
+    color: var(--bulma-text-weak);
+}
 .yui-wc {
     width: 30px; height: 26px; display: inline-flex; align-items: center; justify-content: center;
     padding: 0; border: 0; background: transparent; color: var(--bulma-text); cursor: pointer;
@@ -251,9 +283,6 @@ function ensure_window_style()
 .yui-wc:hover { background: var(--bulma-scheme-main-ter); color: var(--bulma-text-strong); }
 .yui-wc.wc-close:hover { background: #e0364a; color: #fff; }
 .yui-wc svg { width: 15px; height: 15px; display: block; }
-.C_YUI_WINDOW.is-shaded .yui-window-body,
-.C_YUI_WINDOW.is-shaded .yui-window-footer { display: none !important; }
-.C_YUI_WINDOW.is-shaded { height: auto !important; }
 .yui-window-resize { color: var(--bulma-text-weak); opacity: 0.55; }
 .yui-window-resize:hover { opacity: 1; color: var(--bulma-text); }
 @media (max-width: ${MOBILE_MAX}px) {
@@ -270,6 +299,81 @@ function ensure_window_style()
     document.head.appendChild($style);
 }
 
+/************************************************************
+ *   The title bar's default content: `icon` + `title_prefix` +
+ *   `title`, used when the caller supplies no `header`. Until this
+ *   existed, `title` only reached the dock chip, so a window without
+ *   a hand-rolled header painted an EMPTY bar — every caller that
+ *   wanted a title built the same icon+text strip itself, and the
+ *   ones that didn't (Keys, Raw JSON) ended up anonymous or titled
+ *   inside their body.
+ *
+ *   `icon` follows the dock chip's convention: inline SVG when it
+ *   starts with '<', otherwise a yi-* class name.
+ *
+ *   The two halves are separate text nodes on purpose. Titles here are
+ *   nearly always "<what> · <kind>" — `raw_tracks · keys` — and
+ *   composing that into one string is what makes a title untranslatable:
+ *   `${topic} · ${t("keys")}` is not an i18n key, so i18next answers it
+ *   with itself and it stays in the language it was built in for the
+ *   life of the window. Split, the DATA half (`title_prefix`) is left
+ *   alone and the KIND half carries its key, so a host
+ *   refresh_language() re-translates just that one. The separator is
+ *   CSS (::before), never a text node: createElement2 TRIMS text nodes
+ *   and would eat the spaces around it.
+ ************************************************************/
+function build_default_header(gobj)
+{
+    let title = gobj_read_str_attr(gobj, "title");
+    let prefix = gobj_read_str_attr(gobj, "title_prefix");
+    if(empty_string(title) && empty_string(prefix)) {
+        return null;
+    }
+
+    let icon = gobj_read_str_attr(gobj, "icon");
+    let items = [];
+    if(!empty_string(icon)) {
+        if(icon.charAt(0) === '<') {
+            items.push(['span', {class: 'icon'}, icon]);
+        } else {
+            items.push(['span', {class: 'icon'}, [['i', {class: icon}]]]);
+        }
+    }
+    if(!empty_string(prefix)) {
+        items.push(
+            ['span', {class: 'WINDOW_TITLE_PREFIX has-text-weight-semibold'},
+             prefix]
+        );
+    }
+    if(!empty_string(title)) {
+        items.push(
+            ['span', {class: 'WINDOW_TITLE_KIND has-text-weight-semibold',
+                      i18n: title}, title]
+        );
+    }
+
+    return createElement2(
+        ['span', {class: 'WINDOW_TITLE yui-window-title icon-text ml-1'}, items]
+    );
+}
+
+/************************************************************
+ *   The window's title as ONE plain string, for consumers that
+ *   cannot hold markup: the dock chip's label and its `title`
+ *   tooltip. Same two halves as the bar, joined here.
+ ************************************************************/
+function composed_title(gobj)
+{
+    let title = gobj_read_str_attr(gobj, "title");
+    let prefix = gobj_read_str_attr(gobj, "title_prefix");
+    let kind = empty_string(title) ? "" : t(title);
+
+    if(!empty_string(prefix) && !empty_string(kind)) {
+        return `${prefix} · ${kind}`;
+    }
+    return empty_string(prefix) ? kind : prefix;
+}
+
 /************************************************************
  *   Below the mobile breakpoint the window is a full-screen
  *   sheet (no float / drag / resize).
@@ -298,40 +402,17 @@ function resolve_manager(gobj)
 }
 
 /************************************************************
- *   Minimize: with a manager, send the window to the dock;
- *   otherwise "shade" it in place. Called by the minimize button.
+ *   Minimize: send the window to the dock. Only reachable when
+ *   a manager exists — the button is not painted otherwise.
  ************************************************************/
 function do_minimize(gobj)
 {
     let manager = gobj_read_pointer_attr(gobj, "manager");
-    if(manager) {
-        gobj_send_event(manager, "EV_MINIMIZE_WINDOW", {window: gobj}, gobj);
-    } else {
-        toggle_shade(gobj);
-    }
-}
-
-/************************************************************
- *   Minimize as "shade": roll the window up to its title bar
- *   in place (self-contained; no window manager needed). Toggles.
- ************************************************************/
-function toggle_shade(gobj)
-{
-    let priv = gobj.priv;
-    let $container = gobj_read_attr(gobj, "$container");
-    if(!$container) {
+    if(!manager) {
+        log_error(`${gobj_short_name(gobj)}: minimize without a window manager`);
         return;
     }
-    if($container.classList.contains("is-shaded")) {
-        $container.classList.remove("is-shaded");
-        if(priv.preShadeHeight) {
-            $container.style.height = parseInt(priv.preShadeHeight) + 'px';
-        }
-    } else {
-        priv.preShadeHeight = $container.getBoundingClientRect().height;
-        $container.classList.add("is-shaded");
-        $container.style.height = "auto";
-    }
+    gobj_send_event(manager, "EV_MINIMIZE_WINDOW", {window: gobj}, gobj);
 }
 
 /************************************************************
@@ -346,6 +427,9 @@ function build_ui(gobj)
     if(is_gobj(header)) {
         header = gobj_read_attr(header, "$container");
     }
+    if(!header) {
+        header = build_default_header(gobj);
+    }
     let body = gobj_read_attr(gobj, "body");
     if(is_gobj(body)) {
         body = gobj_read_attr(body, "$container");
@@ -413,16 +497,24 @@ function build_ui(gobj)
     };
     Object.assign(window_style, gobj_read_attr(gobj, "window_style"));
 
+    /*  Logical (UPPER_SNAKE) block names, per the repo's DOM convention:
+     *  uppercase identifies the block, lowercase styles it. `logical_class`
+     *  is the CALLER's name for this particular window (e.g.
+     *  TRANGER_KEYS_WINDOW) — several windows share the C_YUI_WINDOW class,
+     *  only this tells them apart in the Inspector or in a selector. */
+    let logical = gobj_read_str_attr(gobj, "logical_class");
+
     let $container = createElement2(
         ['div', {
-            class: 'C_YUI_WINDOW strong-shadow is-flex is-flex-direction-column' + (mobile ? ' is-mobile-sheet' : ''),
+            class: 'C_YUI_WINDOW' + (logical ? ' ' + logical : '') +
+                   ' strong-shadow is-flex is-flex-direction-column' + (mobile ? ' is-mobile-sheet' : ''),
             style: window_style}, [
 
             /*----------------------------*
              *          Header
              *----------------------------*/
             ['div', {
-                class: 'yui-window-header p-1 is-flex-shrink-0 is-flex is-flex-nowrap is-justify-content-space-between is-align-items-center', style: 'border-bottom:1px solid var(--bulma-border); cursor:move; box-sizing: border-box;'
+                class: 'WINDOW_HEADER yui-window-header p-1 is-flex-shrink-0 is-flex is-flex-nowrap is-justify-content-space-between is-align-items-center', style: 'border-bottom:1px solid var(--bulma-border); cursor:move; box-sizing: border-box;'
                 }, [
                 /*  Custom header content: a single-row, horizontally
                  *  scrollable strip.  It takes the remaining width and
@@ -444,14 +536,18 @@ function build_ui(gobj)
                 ]],
                 /*  Window controls: pinned top-right, never shrink,
                  *  never wrap, always on top so the click always lands.
-                 *  Minimize (shade) · maximize/restore · close. */
-                ['div', {class: 'yui-window-titlebar-controls is-flex-shrink-0', style: 'position:relative; z-index:1; cursor:default;'}, [
+                 *  Minimize (to dock) · maximize/restore · close.
+                 *  Minimize exists ONLY with a window manager: it means
+                 *  "send to the dock", and there is no such place without
+                 *  one. `manager` is already resolved (mt_create). */
+                ['div', {class: 'WINDOW_CONTROLS yui-window-titlebar-controls is-flex-shrink-0', style: 'position:relative; z-index:1; cursor:default;'}, [
                     /*----------------------------*
-                     *      Minimize (shade)
+                     *      Minimize (to dock)
                      *----------------------------*/
                     ['button', {
-                        class: 'yui-wc wc-min', type: 'button', 'aria-label': 'minimize',
-                        style: gobj_read_bool_attr(gobj, "showMin") ? '' : 'display:none;',
+                        class: 'WINDOW_MIN yui-wc wc-min', type: 'button', 'aria-label': 'minimize',
+                        style: (gobj_read_bool_attr(gobj, "showMin") &&
+                                gobj_read_pointer_attr(gobj, "manager")) ? '' : 'display:none;',
                     }, WC_MIN, {
                         click: (evt) => {
                             evt.stopPropagation();
@@ -462,7 +558,7 @@ function build_ui(gobj)
                      *      Maximize / restore
                      *----------------------------*/
                     ['button', {
-                        class: 'yui-wc wc-max', type: 'button', 'aria-label': 'maximize',
+                        class: 'WINDOW_MAX yui-wc wc-max', type: 'button', 'aria-label': 'maximize',
                         style: gobj_read_bool_attr(gobj, "showMax") ? '' : 'display:none;',
                     }, WC_MAX, {
                         click: (evt) => {
@@ -474,7 +570,7 @@ function build_ui(gobj)
                      *      Close
                      *----------------------------*/
                     ['button', {
-                        class: 'yui-wc wc-close', type: 'button', 'aria-label': 'close',
+                        class: 'WINDOW_CLOSE yui-wc wc-close', type: 'button', 'aria-label': 'close',
                     }, WC_CLOSE, {
                         click: (evt) => {
                             evt.stopPropagation();
@@ -523,7 +619,7 @@ function build_ui(gobj)
              *          Body
              *----------------------------*/
             ['div', {
-                class: 'yui-window-body is-flex-grow-1 p-1',
+                class: 'WINDOW_BODY yui-window-body is-flex-grow-1 p-1',
                 style: {
                     "position": "relative", // to resize button (absolute position) when no footer bar
                     "overflow": "auto",
@@ -535,7 +631,7 @@ function build_ui(gobj)
             /*----------------------------*
              *          Footer
              *----------------------------*/
-            ['div', {class: 'yui-window-footer is-flex-shrink-0'}, [
+            ['div', {class: 'WINDOW_FOOTER yui-window-footer is-flex-shrink-0'}, [
                 ['div', {
                     class: 'is-justify-content-space-between is-align-items-center p-1',
                     style: {
@@ -586,7 +682,7 @@ function build_ui(gobj)
      *----------------------------*/
     if(gobj_read_bool_attr(gobj, "resizable") && !gobj_read_bool_attr(gobj, "showFooter")) {
         let $resizable_btn = createElement2(['div', {
-            class: 'without-border yui-window-resize',
+            class: 'WINDOW_RESIZE without-border yui-window-resize',
             style: {
                 cursor: "nwse-resize",
                 display: "flex",
@@ -1051,15 +1147,6 @@ function handleResize(gobj)
 
 
 
-/************************************************************
- *
- ************************************************************/
-function ac_resize(gobj, event, kw, src)
-{
-    handleResize(gobj);
-    return 0;
-}
-
 /************************************************************
  *
  ************************************************************/
@@ -1110,8 +1197,6 @@ function ac_close(gobj, event, kw, src)
  *---------------------------------------------*/
 const gmt = {
     mt_create:  mt_create,
-    mt_start:   mt_start,
-    mt_stop:    mt_stop,
     mt_destroy: mt_destroy
 };
 
@@ -1130,7 +1215,6 @@ function create_gclass(gclass_name)
      *---------------------------------------------*/
     const states = [
         ["ST_IDLE", [
-            ["EV_RESIZE",       ac_resize,      null],
             ["EV_REFRESH",      ac_refresh,     null],
             ["EV_SHOW",         ac_show,        null],
             ["EV_HIDE",         ac_hide,        null],
@@ -1145,7 +1229,6 @@ function create_gclass(gclass_name)
         ["EV_WINDOW_TO_CLOSE",  event_flag_t.EVF_OUTPUT_EVENT|event_flag_t.EVF_NO_WARN_SUBS],
         ["EV_WINDOW_MOVED",     event_flag_t.EVF_OUTPUT_EVENT|event_flag_t.EVF_NO_WARN_SUBS],
         ["EV_WINDOW_RESIZED",   event_flag_t.EVF_OUTPUT_EVENT|event_flag_t.EVF_NO_WARN_SUBS],
-        ["EV_RESIZE",           0],
         ["EV_REFRESH",          0],
         ["EV_SHOW",             0],
         ["EV_HIDE",             0],

package/src/c_yui_window_manager.js

@@ -205,6 +205,10 @@ function ensure_dock_style()
 .yui-dock-icon svg { width: 14px; height: 14px; display: block; }
 .yui-dock-icon i { line-height: 1; }
 .yui-dock-label { flex: 0 0 auto; }
+/*  Split label halves (prefix = DATA, kind = translatable). The
+ *  separator is CSS, never a text node — same rule as the window
+ *  title bar (createElement2 trims text nodes). */
+.yui-dock-label .yui-dock-label-prefix + .yui-dock-label-kind::before { content: " \\00b7 "; }
 .yui-dock-close {
     width: 18px; height: 18px; display: inline-flex; align-items: center; justify-content: center;
     padding: 0; margin-left: 1px; border: 0; border-radius: 4px;
@@ -428,7 +432,15 @@ function on_chip_click(gobj, entry)
 
 
 /************************************************************
- *   EV_REGISTER_WINDOW { window, title }
+ *   EV_REGISTER_WINDOW { window, title, title_key,
+ *                        title_kind_text, title_prefix, icon }
+ *
+ *   `title` is the composed, already-translated fallback (also the
+ *   tooltip).  The label itself renders the SPLIT halves so it can
+ *   change language: `title_prefix` (DATA, plain text) + the KIND
+ *   half carrying `title_key` as data-i18n, born as
+ *   `title_kind_text` (the manager has no translator of its own —
+ *   the app's refresh_language() re-translates the key later).
  ************************************************************/
 function ac_register_window(gobj, event, kw, src)
 {
@@ -442,16 +454,38 @@ function ac_register_window(gobj, event, kw, src)
     apply_placement(gobj);
 
     let title = kw.title || gobj_name(win) || "window";
+    let title_key = kw.title_key || "";
+    let kind_text = kw.title_kind_text || "";
+    let prefix = kw.title_prefix || "";
+    let label_items = [];
+    if(prefix) {
+        label_items.push(['span', {class: 'yui-dock-label-prefix'}, prefix]);
+    }
+    if(title_key) {
+        label_items.push(
+            ['span', {class: 'yui-dock-label-kind', i18n: title_key},
+             kind_text || title_key]
+        );
+    }
+    if(label_items.length === 0) {
+        /*  No split halves supplied (legacy caller): plain text. */
+        label_items.push(['span', {class: 'yui-dock-label-kind'}, title]);
+    }
 
     let entry = {gobj: win, $chip: null, minimized: false};
     /*  A div (not a button) so it can hold the close button — a
      *  button inside a button is invalid. The chip toggles; the ✕
      *  closes the window (EV_CLOSE_WINDOW → the window's own teardown
-     *  → EV_UNREGISTER_WINDOW removes this chip). */
+     *  → EV_UNREGISTER_WINDOW removes this chip).
+     *  Tooltip: the composed string; when there is no DATA half it
+     *  carries the key as data-i18n-title so it re-translates too. */
     let $chip = createElement2(
-        ['div', {class: 'yui-dock-chip', role: 'button', tabindex: '0', title: title}, [
+        ['div', Object.assign(
+            {class: 'yui-dock-chip', role: 'button', tabindex: '0', title: title},
+            (!prefix && title_key) ? {'data-i18n-title': title_key} : {}
+        ), [
             chip_lead(kw.icon),
-            ['span', {class: 'yui-dock-label'}, title],
+            ['span', {class: 'yui-dock-label'}, label_items],
             ['button', {class: 'yui-dock-close', type: 'button', 'aria-label': 'close'}, WC_X, {
                 click: (evt) => {
                     evt.stopPropagation();