@yuneta/gobj-ui 7.26.30 → 7.26.32

package/src/c_g6_nodes_tree.js

@@ -5295,10 +5295,12 @@ function name_form_control(parent, control)
     }
     control.id = 'g6-form-control-' + (++form_control_seq);
     label.htmlFor = control.id;
-    control.setAttribute('title', t(key));
-    control.setAttribute('data-i18n-title', key);
-    control.setAttribute('aria-label', t(key));
-    control.setAttribute('data-i18n-aria-label', key);
+    /*  The label's own key, read back from its DOM: it was read where the
+     *  label was built  */
+    control.setAttribute('title', t(/* i18n: data */ key));
+    control.setAttribute('data-i18n-title', /* i18n: data */ key);
+    control.setAttribute('aria-label', t(/* i18n: data */ key));
+    control.setAttribute('data-i18n-aria-label', /* i18n: data */ key);
 }
 
 function create_form_color_input(parent, value, onInput)

package/src/c_yui_form.js

@@ -688,6 +688,12 @@ function name_form_control($field, conf)
         $control.setAttribute("aria-label", t(key));
         $control.setAttribute("data-i18n-aria-label", key);
     }
+    /*  And its title, as every control carries: the label sits apart
+     *  from the box, and a narrow form takes it to another line.  */
+    if($control && !$control.getAttribute("title")) {
+        $control.setAttribute("title", t(key));
+        $control.setAttribute("data-i18n-title", key);
+    }
 
     /*  Tom Select HIDES the <select> it is given (`ts-hidden-accessible`)
      *  and draws its own text box in front of it. Naming the original
@@ -700,6 +706,10 @@ function name_form_control($field, conf)
         $ts.setAttribute("aria-label", t(key));
         $ts.setAttribute("data-i18n-aria-label", key);
     }
+    if($ts && !$ts.getAttribute("title")) {
+        $ts.setAttribute("title", t(key));
+        $ts.setAttribute("data-i18n-title", key);
+    }
 
     /*  The ✕ of the clear_button plugin is drawn by Tom Select too, with a
      *  title written once with t() and no key: named here, after the
@@ -793,11 +803,12 @@ function build_html_form(gobj, $form, prefix, template)
             : [field_desc.name];
         const NO_I18N = "\x00";
         html_field_conf.label = t(label_keys, {defaultValue: field_desc.header});
+        /*  A column of the template: the host's schema, data  */
         html_field_conf.label_i18n =
-            (t(field_desc.name, {defaultValue: NO_I18N}) !== NO_I18N)
+            (t(/* i18n: data */ field_desc.name, {defaultValue: NO_I18N}) !== NO_I18N)
                 ? field_desc.name
                 : null;
-        html_field_conf.placeholder = field_desc.placeholder?t(field_desc.placeholder):'';
+        html_field_conf.placeholder = field_desc.placeholder?t(/* i18n: data */ field_desc.placeholder):'';
 
         let placeholders = gobj_read_attr(gobj, "placeholders");
         if(placeholders[key]) {
@@ -2052,6 +2063,8 @@ function create_coordinates(gobj, attrs)
                   *  froze in the language it was built in.  */
                  placeholder: t('coordinates...'),
                  'data-i18n-placeholder': 'coordinates...',
+                 title: t('coordinates'),
+                 'data-i18n-title': 'coordinates',
                  'aria-label': t('coordinates'),
                  'data-i18n-aria-label': 'coordinates'},
                 '',
@@ -2237,7 +2250,7 @@ function template2columns(gobj, columns, template, sub_elements)
         let validator = [];
         let column = {
             field: field_desc.name,
-            title: t(field_desc.header || field_desc.name),
+            title: t(/* i18n: data */ field_desc.header || field_desc.name),    // the host's schema
             titleFormatter: text_title_formatter,
             editable: get_editable_state,
             editor: false,
@@ -2614,7 +2627,7 @@ function mark_field_validity($input)
     if($h) {
         let key = field_validation_key($input);
         if(key) {
-            $h.setAttribute('data-i18n', key);
+            $h.setAttribute('data-i18n', /* i18n: C_YUI_FORM_I18N_KEYS, FORM_JSON_FIELD_I18N_KEYS */ key);
         } else {
             $h.removeAttribute('data-i18n');    // the browser's own sentence
         }

package/src/c_yui_treedb_graph.js

@@ -1367,7 +1367,9 @@ function answer_print_tranger_refused(gobj, path, answer)
 
 /************************************************************
  *  The text of a transport's refusal: gobj_command() answers a string,
- *  a command response or a number.
+ *  a command response or a number. Data only ("" when it says
+ *  nothing): the caller writes its own key as the fallback, where
+ *  validate-locales reads it.
  ************************************************************/
 function refusal_text(ret)
 {
@@ -1377,7 +1379,7 @@ function refusal_text(ret)
     if(ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) {
         return ret.comment;
     }
-    return "print-tranger failed";
+    return "";
 }
 
 /************************************************************
@@ -1412,7 +1414,8 @@ function request_print_tranger(gobj, path)
         }, gobj);
     if(ret) {
         log_error(ret);
-        answer_print_tranger_refused(gobj, path, {error: /* i18n: data */ refusal_text(ret)});
+        answer_print_tranger_refused(gobj, path,
+            {error: /* i18n: data */ refusal_text(ret) || "print-tranger failed"});
         return;
     }
     if(path) {

package/src/c_yui_treedb_topics.js

@@ -2230,7 +2230,9 @@ function answer_print_tranger_refused(gobj, path, answer)
 
 /************************************************************
  *  The text of a transport's refusal: gobj_command() answers a string,
- *  a command response or a number.
+ *  a command response or a number. Data only ("" when it says
+ *  nothing): the caller writes its own key as the fallback, where
+ *  validate-locales reads it.
  ************************************************************/
 function refusal_text(ret)
 {
@@ -2240,7 +2242,7 @@ function refusal_text(ret)
     if(ret && typeof ret === "object" && typeof ret.comment === "string" && ret.comment) {
         return ret.comment;
     }
-    return "print-tranger failed";
+    return "";
 }
 
 /************************************************************
@@ -2274,7 +2276,8 @@ function request_print_tranger(gobj, path)
         }, gobj);
     if(ret) {
         log_error(ret);
-        answer_print_tranger_refused(gobj, path, {error: /* i18n: data */ refusal_text(ret)});
+        answer_print_tranger_refused(gobj, path,
+            {error: /* i18n: data */ refusal_text(ret) || "print-tranger failed"});
         return;
     }
     if(path) {

package/src/c_yui_window.js

@@ -81,7 +81,7 @@ const MOBILE_MAX = 768;
  ***************************************************************/
 const attrs_table = [
 SDATA(data_type_t.DTP_POINTER,  "subscriber",   0,  null,   "Subscriber of output events"),
-SDATA(data_type_t.DTP_POINTER,  "$parent",      0,  null,   "$container will be appended to $parent if not null, else to document.body"),
+SDATA(data_type_t.DTP_POINTER,  "$parent",      0,  null,   "$container will be appended to $parent if not null, else to the overlay layer of the shell (document.body when there is none)"),
 SDATA(data_type_t.DTP_INTEGER,  "x",            0,  "300",  "X position"),
 SDATA(data_type_t.DTP_INTEGER,  "y",            0,  "100",  "Y position"),
 SDATA(data_type_t.DTP_INTEGER,  "width",        0,  "700",  "Width of the window"),
@@ -724,11 +724,10 @@ function build_ui(gobj)
     refresh_language($container, t);
 
     let $parent = gobj_read_attr(gobj, "$parent");
-    if($parent) {
-        $parent.appendChild($container);
-    } else {
-        document.body.appendChild($container);
+    if(!$parent) {
+        $parent = default_parent(gobj);
     }
+    $parent.appendChild($container);
 
     if (gobj_read_bool_attr(gobj, "openMaximized")) {
         max(gobj);
@@ -860,6 +859,34 @@ function close_window(gobj)
     return {state: "asking", answer: answer};
 }
 
+/************************************************************
+ *  Where a window lives when its host names no `$parent`: the
+ *  OVERLAY layer of the shell -- above the content, below the
+ *  toolbar's dropdowns, the dialogs and the toasts.
+ *
+ *  It used to be document.body, and that put every window above
+ *  the WHOLE shell: `.yui-shell` is position:fixed, a stacking
+ *  context of its own, so the z-index of its modal layer (99)
+ *  counted only inside it, and a window at z-index 11 on the body
+ *  covered it. The confirmation a window's own close asks ("all
+ *  changes will be lost") opened UNDER the window that asked it,
+ *  where no click could reach it; a toast, a dropdown of the
+ *  toolbar, any dialog opened with a window on screen, the same.
+ *
+ *  Inside the layer the dock's z-index still orders the windows
+ *  among themselves. No shell (a page with windows and no shell):
+ *  the body, as before.
+ ************************************************************/
+function default_parent(gobj)
+{
+    let shell = yui_shell_of(gobj);
+    let layers = shell && shell.priv && shell.priv.layers;
+    if(layers && layers.overlay) {
+        return layers.overlay;
+    }
+    return document.body;
+}
+
 /************************************************************
  *
  ************************************************************/

package/src/i18n_key_functions.js

@@ -30,7 +30,8 @@
  *                                           of the array `actions`
  *                          A position may also hold DOM or nothing: only
  *                          a string there is a key. DOM is an array (a
- *                          createElement2 spec), a call of createElement2(),
+ *                          createElement2 spec; an array of string
+ *                          literals is none), a call of createElement2(),
  *                          createOneHtml() or html_markup() of gobj-js, of
  *                          text_node() of gobj-ui, of document.createElement()
  *                          and the like, a const bound to one, a plain `let`
@@ -39,43 +40,64 @@
  *
  *          What is read at a position: a string literal, a template with
  *          no `${}`, every branch of a `?:`, `||`, `??` (the right one of
- *          `&&`), and what the reader follows -- a const to its value, a
- *          property of a const object, the element of a const array a
- *          `.map()` or a for...of walks (and what a destructuring reads
- *          from it), String(x) and `${x}` as x, the default of a parameter,
- *          a call of a function of the same module whose every return is
- *          one of these. A `let`, a parameter or data is not read: its keys
- *          are published in an exported `<NAME>_I18N_KEYS` array, and the
- *          call is MARKED with a comment right before what it hands over,
- *          `i18n: <NAME>_I18N_KEYS` (the list) or `i18n: data` (no key a
- *          list can hold). A marked `let` is held to its marker: every
- *          literal it is given is read and must be in the list, and one
- *          given nothing but literals fails (write it as a const, which the
- *          reader follows). A `data` marker on what the reader follows to
- *          keys and nothing else -- a literal, a const or a branch that is
- *          one, a call that returns literals -- fails too: it claims data
- *          where the reader reads a key.
+ *          `&&`), and what the reader follows -- a const to its value (what
+ *          a destructuring reads from it too), an import of a const or a
+ *          function of a module the reader reads, a property of a const
+ *          object or of a copy of one (`{...o}`), the element of a const
+ *          array a `.map()` or a for...of walks (and what a destructuring
+ *          reads from it), String(x) and `${x}` as x, the default of a
+ *          parameter, a call of a function -- of the module or imported --
+ *          whose every return is one of these (read once; a recursion is
+ *          not followed). A `let`, a parameter or data is not read: its
+ *          keys are published in an exported `<NAME>_I18N_KEYS` array (an
+ *          `export const`, never mutated), and the call is MARKED with a
+ *          comment right before what it hands over, `i18n: <NAME>_I18N_KEYS`
+ *          (the list) or `i18n: data` (no key a list can hold). A marked
+ *          `let` is held to its marker: every literal it is given is read
+ *          and must be in the list, and one given nothing but literals fails
+ *          (write it as a const, which the reader follows). A `data` marker
+ *          on what the reader follows to keys and nothing else -- a
+ *          literal, a const or a branch that is one, a call that returns
+ *          literals -- fails too: it claims data where the reader reads a
+ *          key; and so does one that would hide a key the reader does not
+ *          read: a call whose returns mix keys with data, an array of
+ *          string literals.
+ *
+ *          A call reaches a function of this table however it names it:
+ *          its name, an import under any name, a re-export, a const alias,
+ *          a map (`API.info(...)`), `.call()`, `.apply()`.
  *
  *          The rule, per CALL: a key position given anything else than a
  *          literal (or DOM, or nothing), a const the reader follows, a key
  *          position of the enclosing table function handed on, or a marked
- *          value fails, with the file and the line; a TRANSLATED text,
- *          t("..."), fails even marked (it would be translated again, and
- *          never change language). A test (i18n_key_functions.test.js)
- *          holds the library to it, and validate-locales an app's own code.
- *          Publishing a list exempts no module.
+ *          value fails, with the file and the line; a TRANSLATED text --
+ *          t("..."), tr(), an alias of t, `t?.()`, `t.call()` -- fails even
+ *          marked (it would be translated again, and never change
+ *          language). A test (i18n_key_functions.test.js) holds the library
+ *          to it, and validate-locales an app's own code. Publishing a list
+ *          exempts no module.
  *
- *          The table is COMPLETE, and the same test proves it: it finds
- *          every function of the library that hands one of its parameters
- *          -- or what it reads from one, `opts.title`, a destructured
- *          `{label}`, each `items[].name` -- to t(), to an `i18n`, `code` or
- *          `data-i18n*` value, or to a key position of a function of this
- *          table (REV-CLOUD V21.4.1: up to 7.26.28 it lacked 39 such
- *          functions, and 6 entries lacked positions).
+ *          The table is COMPLETE and CORRECT, and the same test proves both
+ *          (REV-CLOUD V21.4.1, V22): it finds every function of the library
+ *          that hands one of its parameters -- or what it reads from one:
+ *          `opts.title`, `opts?.title`, a destructured `{label}` (in the
+ *          parameter or in the body), each `items[].name`, `arguments[1]`,
+ *          `rest[0]`, a copy `{...opts}` -- to a translator, to an `i18n`,
+ *          `code` or `data-i18n*` value (`el.dataset.i18nTitle` included),
+ *          or to a key position of a function of this table, and fails on
+ *          a function missing here; and the same search, started from NO
+ *          table, must find every entry here, at every position, with the
+ *          same `exported`: an entry nothing forwards to fails. A function
+ *          that hands a parameter on through what no position can name --
+ *          `k.toLowerCase()`, a concatenation or a template, an iteration
+ *          of `Object.entries(opts)`, a rest parameter walked, `arguments`
+ *          by a computed index, a parameter an array pattern destructures
+ *          -- fails too, unless it marks it where it hands it.
  *          One called by name goes here, with that position. One nothing
  *          calls by name -- an FSM action, a callback, a method -- has no
  *          call to read: it marks what it hands on, where it hands it. What
- *          a gobj keeps in its `priv` is its own state, never a position.
+ *          a gobj keeps in its `priv`, and what is read from a parameter
+ *          `gobj` (its attrs), is its own state, never a position.
  *
  *          Copyright (c) 2026, ArtGins.
  *          All Rights Reserved.
@@ -140,6 +162,7 @@ export const I18N_KEY_FUNCTIONS = Object.freeze([
         keys: ["0.id", "0.roll.label", "0.spec", "0.spec.id"]},
     {module: "c_yui_period.js", name: "build_mode_button", exported: false,
         keys: ["1.id", "1.roll.label", "1.spec", "1.spec.id"]},
+    {module: "yui_table_select.js", name: "paint_label", exported: false, keys: ["1"]},
     {module: "c_yui_form.js", name: "cell_icon", exported: false, keys: ["1"]},
     {module: "c_yui_form.js", name: "name_form_control", exported: false, keys: ["1.label_i18n", "1.label"]},
     {module: "c_yui_form.js", name: "create_form_field", exported: false,
@@ -183,7 +206,7 @@ export const I18N_KEY_FUNCTIONS = Object.freeze([
     {module: "c_yui_schema_editor.js", name: "render_import_plan", exported: false,
         keys: ["1.conflicts[].code", "1.writes[].op"]},
     {module: "schema_validate.js", name: "add", exported: false, keys: ["1"]},
-    {module: "c_g6_nodes_tree.js", name: "create_floating_icon", exported: false, keys: ["4"]},
+    {module: "c_g6_nodes_tree.js", name: "create_floating_icon", exported: true, keys: ["4"]},
     {module: "c_g6_nodes_tree.js", name: "show_dual_icons", exported: false, keys: ["3", "5"]},
     {module: "c_g6_nodes_tree.js", name: "create_form_label", exported: false, keys: ["1"]},
     {module: "c_g6_nodes_tree.js", name: "create_form_select", exported: false, keys: ["1[].i18n"]},