@yuneta/gobj-ui 7.26.26 → 7.26.28

package/src/c_yui_form.js

@@ -2547,11 +2547,21 @@ function field_validation_message($input)
 {
     let key = field_validation_key($input);
     if(key) {
-        return t(key);
+        return t(/* i18n: C_YUI_FORM_I18N_KEYS, FORM_JSON_FIELD_I18N_KEYS */ key);
     }
     return $input.validationMessage;
 }
 
+/*  The keys this form hands on as data: the one field_validation_key()
+ *  returns, which reaches t() by a variable, and the warning of a close
+ *  it vetoes (`kw.warning`), which its HOST shows. Published for a
+ *  consumer's validate-locales, which asks the app's locales for every
+ *  key of an exported `*_I18N_KEYS` array; i18n_key_functions.test.js
+ *  holds it to what field_validation_key() returns and to every
+ *  `.warning =` of this module. (The json editor's own key is published
+ *  by form_json_field.js.)  */
+export const C_YUI_FORM_I18N_KEYS = ["this field is required", "all changes will be lost"];
+
 /************************************************************
  *  The i18n key of the message, when the message is ours ("" when
  *  it is the browser's): written as the help line's data-i18n, so

package/src/c_yui_fsm_graph.js

@@ -71,6 +71,7 @@ import {
 import {yui_is_dark, yui_theme_now, yui_watch_theme} from "./yui_theme.js";
 import {ensure_drag_canvas_patch} from "./g6_drag_canvas_touch.js";
 import {ensure_pinch_zoom_patch} from "./g6_touch_gestures.js";
+import {keep_canvas_tab_order} from "./g6_canvas_tab_order.js";
 
 import {t} from "i18next";
 
@@ -428,6 +429,10 @@ function build_graph(gobj)
         }
     }
 
+    /*  Tab goes from the graph to its own buttons: the main canvas in
+     *  the Tab order, the other layers out (g6_canvas_tab_order.js).  */
+    keep_canvas_tab_order(gobj, priv.graph);
+
     priv.graph.on('aftertransform', () => {
         yui_graph_update_zoom(gobj_read_attr(gobj, "$container"), priv.graph);
     });

package/src/c_yui_gclass.js

@@ -136,6 +136,17 @@ const ZONES = [
     {id: "machine",  key: "machine",          col: "right"},
 ];
 
+/*  The keys of VIEWS, MACHINE_VIEWS and ZONES: they reach t() as data
+ *  (`v.key`, `zone.key`), where no scan of the source reads them, so
+ *  they are published here for a consumer's validate-locales, which asks
+ *  the app's locales for every key of an exported `*_I18N_KEYS` array. A
+ *  view or a zone added to those tables adds its key here.  */
+export const C_YUI_GCLASS_I18N_KEYS = [
+    "zones view", "raw view",
+    "matrix view", "graph view",
+    "attributes", "commands", "methods", "trace levels", "machine"
+];
+
 /***************************************************************
  *              Data
  ***************************************************************/

package/src/c_yui_gobj_tree_js.js

@@ -82,6 +82,7 @@ import { ensure_drag_canvas_patch } from "./g6_drag_canvas_touch.js";
 import { ensure_pinch_zoom_patch } from "./g6_touch_gestures.js";
 import { yui_is_dark, yui_theme_now, yui_watch_theme } from "./yui_theme.js";
 import {g6_event_kw} from "./g6_event_kw.js";
+import {keep_canvas_tab_order} from "./g6_canvas_tab_order.js";
 
 /***************************************************************
  *              Constants
@@ -523,6 +524,18 @@ const LAYOUTS = {
     },
 };
 
+/*  The `key` of every layout: the picker hands it to t() as data
+ *  (`LAYOUTS[key].key`), where no scan of the source reads it, so it is
+ *  published here for a consumer's validate-locales, which asks the
+ *  app's locales for every key of an exported `*_I18N_KEYS` array. A
+ *  layout added to LAYOUTS adds its key here.  */
+export const C_YUI_GOBJ_TREE_JS_I18N_KEYS = [
+    "vertical tree", "vertical tree compact",
+    "horizontal tree", "horizontal tree compact",
+    "lanes vertical", "lanes horizontal",
+    "dagre top-down", "dagre left-right"
+];
+
 function get_layout_cfg(layout_key)
 {
     return LAYOUTS[layout_key] || LAYOUTS["vertical-compact"];
@@ -1150,6 +1163,10 @@ function build_graph(gobj)
         graph.setTheme(priv.theme);
     }
 
+    /*  Tab goes from the graph to its own buttons: the main canvas in
+     *  the Tab order, the other layers out (g6_canvas_tab_order.js).  */
+    keep_canvas_tab_order(gobj, graph);
+
     /*  The readout follows ANY camera change, the wheel included — a
      *  wheel notch passes through no action of ours.  */
     graph.on('aftertransform', () => {

package/src/c_yui_json_graph.js

@@ -83,6 +83,7 @@ import {
     count_branches,
 } from "./json_view_helpers.js";
 import {g6_event_kw} from "./g6_event_kw.js";
+import {keep_canvas_tab_order} from "./g6_canvas_tab_order.js";
 
 /***************************************************************
  *              Constants
@@ -754,6 +755,10 @@ function build_graph(gobj)
         graph.setTheme(priv.theme);
     }
 
+    /*  Tab goes from the graph to its own buttons: the main canvas in
+     *  the Tab order, the other layers out (g6_canvas_tab_order.js).  */
+    keep_canvas_tab_order(gobj, graph);
+
     graph.on(NodeEvent.CLICK, (evt) => {
         /*  An identity, never the G6 event: a kw is plain json, and the
          *  event is circular -- the machine trace dumps the kw.  */

package/src/c_yui_nav.js

@@ -268,7 +268,7 @@ function build_ui(gobj)
         if(!$container.hasAttribute("aria-label")) {
             /*  A key, translated by the shell's translator: the bare
              *  menu_id read out "secondary.main.system".  */
-            let label = gobj_read_attr(gobj, "nav_label") || "navigation";
+            const label = gobj_read_attr(gobj, "nav_label") || "navigation";
             $container.setAttribute("aria-label", t(label));
             $container.setAttribute("data-i18n-aria-label", label);
         }
@@ -527,16 +527,19 @@ function render_backbar(gobj)
     if(label) {
         label_attrs.i18n = label;
     }
+    /*  Named by the label when the nav has one, else by "back" -- through
+     *  t() and with its key, or it reads the raw key in every language.  */
+    const name_key = label || "back";
     let a_attrs = {
         class: "yui-nav-item yui-nav-back",
         href: back_route ? "#" + back_route : "#",
         "data-item-id": "__index__",
         "data-route": back_route,
-        "aria-label": label || "back"
+        title: t(name_key),
+        "data-i18n-title": name_key,
+        "aria-label": t(name_key),
+        "data-i18n-aria-label": name_key
     };
-    if(label) {
-        a_attrs["data-i18n-aria-label"] = label;
-    }
     return createElement2(
         ["div", {},
             ["a", a_attrs, [
@@ -558,7 +561,7 @@ function render_drawer(gobj, items)
     wrap.className = "yui-drawer";
     wrap.setAttribute("role", "dialog");
     wrap.setAttribute("aria-modal", "true");
-    let nav_label = gobj_read_attr(gobj, "nav_label") || "navigation";
+    const nav_label = gobj_read_attr(gobj, "nav_label") || "navigation";
     wrap.setAttribute("aria-label", t(nav_label));
     wrap.setAttribute("data-i18n-aria-label", nav_label);
 

package/src/c_yui_pager.js

@@ -237,7 +237,7 @@ function render_header(gobj)
      *  deeper pages show a back arrow.
      */
     let $back_icon = $back.querySelector('i');
-    let back_key = (model.back_kind === "close") ? 'close' : 'back';
+    const back_key = (model.back_kind === "close") ? 'close' : 'back';
     $back_icon.className = (back_key === 'close') ? 'yi-xmark' : 'yi-arrow-left';
     /*  The key moves with the glyph: a key left on "back" made the ✕ of
      *  the root page announce itself as Back after a language switch.  */

package/src/c_yui_period.js

@@ -112,6 +112,13 @@ const GCLASS_NAME = "C_YUI_PERIOD";
 const MODE_SPAN = "span";
 const MODE_CUSTOM = "custom";
 
+/*  Their names: a mode is named by its id through a variable
+ *  (`t(mode.id)`), where no scan of the source reads it, so they are
+ *  published for a consumer's validate-locales, which asks the app's
+ *  locales for every key of an exported `*_I18N_KEYS` array. The names
+ *  of the granularities and of the rolling windows are yui_time.js's.  */
+export const C_YUI_PERIOD_I18N_KEYS = ["span", "custom"];
+
 /***************************************************************
  *              Data
  ***************************************************************/
@@ -379,7 +386,7 @@ function mode_name(mode)
         return t(mode.roll.label || mode.id);
     }
     if(mode.kind === "bucket") {
-        return period_name(mode.spec, t);
+        return period_name(/* i18n: YUI_TIME_I18N_KEYS */ mode.spec, t);
     }
     return t(mode.id);                      /*  span / custom  */
 }
@@ -565,7 +572,7 @@ function build_mode_button(gobj, mode)
 {
     /*  The name is COMPOSED for a bucket (period_name), so it carries no
      *  key: ac_language_changed() rewrites the text and both names.  */
-    let name = mode_name(mode);
+    let name = mode_name(/* i18n: C_YUI_PERIOD_I18N_KEYS, YUI_TIME_I18N_KEYS */ mode);
     let $btn = createElement2(
         ["button", {class: `button YUI_PERIOD_MODE YUI_PERIOD_MODE_${mode.id.toUpperCase()}`,
                     type: "button", title: name, "aria-label": name},
@@ -591,7 +598,7 @@ function build_more_menu(gobj)
         if(!mode.overflow) {
             continue;
         }
-        let name = mode_name(mode);
+        let name = mode_name(/* i18n: C_YUI_PERIOD_I18N_KEYS, YUI_TIME_I18N_KEYS */ mode);
         let $item = createElement2(
             ["a", {class: `dropdown-item YUI_PERIOD_MODE ` +
                           `YUI_PERIOD_MODE_${mode.id.toUpperCase()}`, href: "#",
@@ -1364,7 +1371,7 @@ function ac_language_changed(gobj, event, kw, src)
         if(!mode.$btn) {
             continue;
         }
-        let name = mode_name(mode);
+        let name = mode_name(/* i18n: C_YUI_PERIOD_I18N_KEYS, YUI_TIME_I18N_KEYS */ mode);
         let $text = mode.$btn.querySelector(".YUI_PERIOD_MODE_TEXT");
         if($text) {
             $text.textContent = name;

package/src/c_yui_schema_editor.js

@@ -168,6 +168,16 @@ import {text_node} from "./yui_text.js";
  ***************************************************************/
 const GCLASS_NAME = "C_YUI_SCHEMA_EDITOR";
 
+/*  The keys this editor hands to t() as DATA, where no scan of the
+ *  source reads them: the severity of a finding, which the checks of
+ *  schema_validate.js write (`add("error", ...)`) and the report
+ *  translates. Published for a consumer's validate-locales, which asks
+ *  the app's locales for every key of an exported `*_I18N_KEYS` array;
+ *  i18n_key_functions.test.js holds it to the severities those checks
+ *  write. The flags' words are schema_flags.js's, the plan's ops
+ *  schema_import.js's.  */
+export const C_YUI_SCHEMA_EDITOR_I18N_KEYS = ["error", "warning"];
+
 /*  The three topics a schema is stored in. Named once: everything
  *  below addresses them by these constants and nothing composes the
  *  strings again.  */
@@ -373,7 +383,7 @@ function mt_destroy(gobj)
 function refuse_bad_name(gobj, $message)
 {
     mark_name_field(gobj, true);
-    yui_shell_show_error(yui_shell_of(gobj), $message, {t: t});
+    yui_shell_show_error(yui_shell_of(gobj), /* i18n: data */ $message, {t: t});
     return -1;
 }
 
@@ -1911,7 +1921,7 @@ function open_dialog(gobj, $content, title, logical, title_prefix)
     priv.dialog_gen = priv.model_gen;
     priv.dialog_kind = logical;
     priv.dialog_content = $content;
-    priv.dialog = yui_shell_show_modal(yui_shell_of(gobj), $content, {
+    priv.dialog = yui_shell_show_modal(yui_shell_of(gobj), /* i18n: data */ $content, {
         dialog:        true,
         title:         title,
         title_prefix:  title_prefix || "",
@@ -2425,7 +2435,8 @@ function open_report(gobj, findings, treedb_id)
         return ["tr", {class: `SCHEMA_REPORT_ROW SCHEMA_REPORT_${finding.severity.toUpperCase()}`}, [
             ["td", {class: "SCHEMA_REPORT_SEVERITY"}, [
                 ["span", {class: `tag ${finding.severity === "error" ? "is-danger" : "is-warning"}` +
-                                 " is-light", i18n: finding.severity}, t(finding.severity)]
+                                 " is-light", i18n: /* i18n: C_YUI_SCHEMA_EDITOR_I18N_KEYS */ finding.severity},
+                    t(/* i18n: C_YUI_SCHEMA_EDITOR_I18N_KEYS */ finding.severity)]
             ]],
             ["td", {class: "SCHEMA_REPORT_WHAT", i18n: finding.code}, t(finding.code)],
             ["td", {class: "SCHEMA_REPORT_TOPIC"}, text_node(finding.topic || "")],
@@ -3527,7 +3538,7 @@ function ac_mt_command_answer(gobj, event, kw, src)
             return late_write_done(gobj, command, topic_name, data);
         }
         if(result < 0) {
-            return end_writes(gobj, comment || t("the treedb refused the write"));
+            return end_writes(gobj, /* i18n: data */ comment || "the treedb refused the write");
         }
         priv.save_wrote = true;
         let record = null;
@@ -4229,7 +4240,8 @@ function confirm_column_delete(gobj, verdict)
         capped:  "the records read hold no value in this column, but not all were read: the rest may hold values that no reader will show any more",
         unknown: "the records of this topic could not be read: if they hold values in this column, they keep them, but no reader shows them any more"
     };
-    let message = "delete this column?";
+    const message = "delete this column?";
+    let $warning = null;
     if(NOTES[verdict]) {
         let children = [
             ["p", {class: "CONFIRM_MSG yui-confirm-msg", i18n: message}, t(message)],
@@ -4242,9 +4254,9 @@ function confirm_column_delete(gobj, verdict)
                 ["span", {class: "ml-1"}, String(c.scanned)]
             ]]);
         }
-        message = createElement2(["div", {class: "SCHEMA_COLUMN_DATA_WARNING"}, children]);
+        $warning = createElement2(["div", {class: "SCHEMA_COLUMN_DATA_WARNING"}, children]);
     }
-    confirm_then(gobj, message, `${c.topic}.${c.col}`,
+    confirm_then(gobj, $warning? /* i18n: data */ $warning : message, `${c.topic}.${c.col}`,
         {what: "column", topic: c.topic, col: c.col});
     return 0;
 }

package/src/c_yui_shell.js

@@ -1807,7 +1807,7 @@ function build_toolbar(gobj, config)
      *  which createElement2 maps to `data-i18n` on the rendered
      *  element.  Apps swap languages by calling
      *  refresh_language(shell.$container, t) — no DOM rebuild here. */
-    let toolbar_aria = tb.aria_label || "Toolbar";
+    const toolbar_aria = tb.aria_label || "toolbar";
     let $bar = createElement2(
         ["nav", {class: "yui-toolbar navbar",
                  role: "navigation",
@@ -2060,8 +2060,8 @@ function build_toolbar_brand_item(gobj, it)
 function build_toolbar_avatar_item(gobj, it)
 {
     let priv = gobj.priv;
-    let aria_key = it.aria_label || it.name || it.id || "User menu";
-    let i18n_aria = it.aria_label || it.name || "User menu";
+    const aria_key = it.aria_label || it.name || it.id || "user menu";
+    const i18n_aria = it.aria_label || it.name || "user menu";
     let action_type = (it.action && it.action.type) || "";
     let attrs = {
         class: "navbar-item yui-toolbar-item yui-toolbar-avatar is-unselectable",
@@ -2151,8 +2151,8 @@ function attach_context_action(gobj, $item, it)
 function build_toolbar_connection_item(gobj, it)
 {
     let priv = gobj.priv;
-    let aria_key  = it.aria_label || it.name || it.id || "backend connection";
-    let i18n_aria = it.aria_label || it.name || "backend connection";
+    const aria_key  = it.aria_label || it.name || it.id || "backend connection";
+    const i18n_aria = it.aria_label || it.name || "backend connection";
     let attrs = {
         class: "navbar-item yui-toolbar-item yui-toolbar-conn " +
                "is-unselectable is-disconnected",
@@ -2328,8 +2328,8 @@ function open_toolbar_dropdown(gobj, item, action, $trigger)
      *  (yui_shell_set_translator), re-apply it to the freshly built
      *  $panel.  Rebuilt per open ⇒ a later language switch is picked
      *  up the next time the dropdown opens. */
-    let aria_key = item && (item.aria_label || item.name || item.id) || "Menu";
-    let i18n_aria = (item && (item.aria_label || item.name)) || "Menu";
+    const aria_key = item && (item.aria_label || item.name || item.id) || "menu";
+    const i18n_aria = (item && (item.aria_label || item.name)) || "menu";
     let $panel = createElement2(["div", {
         class: "yui-toolbar-dropdown-panel",
         role: "menu",

package/src/c_yui_treedb_graph.js

@@ -513,7 +513,7 @@ function show_load_error(gobj, message)
         $container.insertBefore($err, $container.firstChild);
     }
     let treedb = gobj_read_attr(gobj, "treedb_name") || "";
-    $err.textContent = (treedb ? `${treedb}: ` : "") + (message || "cannot load treedb");
+    $err.textContent = (treedb ? `${treedb}: ` : "") + (message || t("cannot load treedb"));
 }
 
 /************************************************************
@@ -671,6 +671,15 @@ const NODE_MODE_ICONS = {
     shape:    'yi-hexagon-nodes',
 };
 
+/*  The keys that reach t() as data: the labels of NODE_MODE_LABELS.
+ *  Published for a consumer's validate-locales, which asks the app's
+ *  locales for every key of an exported `*_I18N_KEYS` array. A view
+ *  added to NODE_MODE_LABELS adds its label here
+ *  (i18n_key_functions.test.js checks it).  */
+export const C_YUI_TREEDB_GRAPH_I18N_KEYS = [
+    'full', 'compact', 'shape'
+];
+
 /*  The pressed view and the labels toggle, from the attrs. The
  *  toggle only means something on figures, so it is disabled
  *  elsewhere.
@@ -1219,7 +1228,7 @@ function open_json_viewer(gobj)
             close_json_viewer(gobj);
             return;
         }
-        priv.json_modal = yui_shell_show_modal(shell, $box, {
+        priv.json_modal = yui_shell_show_modal(shell, /* i18n: data */ $box, {
             dialog:        true,
             logical_class: "TREEDB_JSON_SHEET",
             title_prefix: priv.treedb_name,
@@ -1353,7 +1362,7 @@ function answer_print_tranger_refused(gobj, path, answer)
             Object.assign({path: path}, answer), gobj);
     } else {
         yui_shell_show_error(yui_shell_of(gobj),
-            answer.i18n || answer.error, {t: t});
+            /* i18n: data */ answer.i18n || answer.error, {t: t});
     }
 }
 
@@ -2167,7 +2176,7 @@ function ac_mt_command_answer(gobj, event, kw, src)
                     {path: path, error: comment || "print-tranger failed"}, gobj);
             } else {
                 yui_shell_show_error(yui_shell_of(gobj),
-                    comment || "print-tranger failed", {t: t});
+                    /* i18n: data */ comment || "print-tranger failed", {t: t});
             }
             return 0;
         }
@@ -2186,7 +2195,7 @@ function ac_mt_command_answer(gobj, event, kw, src)
              *  app-modal that wedges the whole SPA behind an empty tab. */
             show_load_error(gobj, t(comment));
         } else {
-            yui_shell_show_error(yui_shell_of(gobj), comment, {t: t});
+            yui_shell_show_error(yui_shell_of(gobj), /* i18n: data */ comment, {t: t});
         }
         // HACK don't return for non-descs, pass errors when need it.
     }
@@ -3099,7 +3108,7 @@ function refresh_legend(gobj)
              hidden? `${entry.total}` : `${entry.visible}/${entry.total}`]
         );
 
-        let body_key = is_main? 'main topic' : (hidden? 'show topic' : 'hide topic');
+        const body_key = is_main? 'main topic' : (hidden? 'show topic' : 'hide topic');
 
         /*  Built as an object first: an attribute that is `undefined`
          *  is still SET by createElement2 (to the string "undefined"),

package/src/c_yui_treedb_schema.js

@@ -68,6 +68,7 @@ import {
     yui_graph_update_zoom,
 } from "./yui_graph_camera.js";
 import {ensure_pinch_zoom_patch} from "./g6_touch_gestures.js";
+import {keep_canvas_tab_order} from "./g6_canvas_tab_order.js";
 import {col_key_roles} from "./treedb_topic_keys.js";
 
 import {getStrokeColor} from "./lib_graph.js";
@@ -659,6 +660,10 @@ function build_graph(gobj)
 
     graph.setTheme(dark ? "dark" : "light");
 
+    /*  Tab goes from the graph to its own buttons: the main canvas in
+     *  the Tab order, the other layers out (g6_canvas_tab_order.js).  */
+    keep_canvas_tab_order(gobj, graph);
+
     /*  The readout follows ANY camera change, the wheel included -- a
      *  wheel notch passes through no action of ours.  */
     graph.on('aftertransform', () => {

package/src/c_yui_treedb_topic_with_form.js

@@ -325,7 +325,7 @@ function present_json_popup(gobj, $box, opts)
 
     if(is_mobile()) {
         return {
-            modal: yui_shell_show_modal(shell, $box, {
+            modal: yui_shell_show_modal(shell, /* i18n: data */ $box, {
                 dialog:        true,
                 logical_class: opts.logical_class + "_SHEET",
                 title_prefix:  opts.title_prefix,
@@ -2428,7 +2428,7 @@ function open_form_dialog(gobj, mode, record)
      *  while "new"/"edit"/"view" is what only this header can tell you.
      *  All three are keys this library already uses.  */
     let pkey = desc.pkey || "id";
-    let title = (mode === "create")? "new" : ((mode === "view")? "view" : "edit");
+    const title = (mode === "create")? "new" : ((mode === "view")? "view" : "edit");
     let title_prefix = "";
     if(mode !== "create") {
         let rid = record ? String(record[pkey] ?? "") : "";
@@ -2496,7 +2496,7 @@ function open_form_dialog(gobj, mode, record)
      *  are wired by the shell. `before_close` preserves the unsaved-changes
      *  guard — it vetoes the dismiss and, on confirm, closes the modal
      *  itself. `on_close` tears the hosted form child down. */
-    priv.form_modal = yui_shell_show_modal(shell, $body, {
+    priv.form_modal = yui_shell_show_modal(shell, /* i18n: data */ $body, {
         dialog:        true,
         logical_class: "TREEDB_FORM_SHEET",
         title_prefix:  title_prefix,
@@ -2548,7 +2548,7 @@ function form_may_close(gobj)
              *  a second key to define — and the one that was here had never
              *  been defined in any locale, which renders as the English
              *  sentence itself, in every language, for ever. */
-            confirm_then(gobj, kw.warning || "all changes will be lost",
+            confirm_then(gobj, /* i18n: C_YUI_FORM_I18N_KEYS */ kw.warning || "all changes will be lost",
                 {what: "close_form"});
             return false;
         }
@@ -2807,7 +2807,7 @@ function open_cell_json_dialog(gobj, row_id, col_id)
         name:          "cellwin_" + clean_name(gobj_name(gobj)),
         logical_class: "TREEDB_CELL_JSON",
         title_prefix:  String(row_id),
-        title:         col_id,
+        title:         /* i18n: data */ col_id,
         icon:          "yi-js-square",
         forget_window: function() {
             priv.cell_json_win = null;
@@ -3019,7 +3019,7 @@ function open_cell_file_dialog(gobj, row_id, col_id)
         name:          "filewin_" + clean_name(gobj_name(gobj)),
         logical_class: "TREEDB_CELL_FILE",
         title_prefix:  String(row_id),
-        title:         col_id,
+        title:         /* i18n: data */ col_id,
         icon:          "yi-eye",
         forget_window: function() {
             priv.cell_file_win = null;
@@ -3167,7 +3167,7 @@ function open_hook_choice_dialog(gobj, targets, parent_id, hook)
             }];
         })]
     );
-    priv.hook_choice_modal = yui_shell_show_modal(shell, $body, {
+    priv.hook_choice_modal = yui_shell_show_modal(shell, /* i18n: data */ $body, {
         dialog:        true,
         logical_class: "TREEDB_HOOK_CHOICE_SHEET",
         title:         "choose a topic",
@@ -4132,7 +4132,7 @@ function ac_delete_rows(gobj, event, kw, src)
             return 0;
         }
 
-        confirm_then(gobj, build_delete_question(gobj, rows),
+        confirm_then(gobj, /* i18n: data */ build_delete_question(gobj, rows),
             {what: "delete_selection", ids: yui_row_ids(tabulator, rows)});
 
     } else {
@@ -4140,7 +4140,7 @@ function ac_delete_rows(gobj, event, kw, src)
          *  Delete one row
          *  {row: }
          *----------------------------*/
-        confirm_then(gobj, build_delete_question(gobj, kw.row),
+        confirm_then(gobj, /* i18n: data */ build_delete_question(gobj, kw.row),
             {what: "delete_row", ids: yui_row_ids(tabulator, [kw.row])});
     }
 
@@ -5078,7 +5078,7 @@ function ac_open_columns(gobj, event, kw, src)
         ));
     }
 
-    yui_shell_show_modal(shell, $list, {
+    yui_shell_show_modal(shell, /* i18n: data */ $list, {
         dialog:        true,
         logical_class: "TREEDB_COLUMNS_DIALOG",
         title_prefix:  gobj_read_str_attr(gobj, "topic_name"),

package/src/c_yui_treedb_topics.js

@@ -565,7 +565,7 @@ function show_load_error(gobj, message)
         $container.insertBefore($err, $container.firstChild);
     }
     let treedb = gobj_read_attr(gobj, "treedb_name") || "";
-    $err.textContent = (treedb ? `${treedb}: ` : "") + (message || "cannot load treedb");
+    $err.textContent = (treedb ? `${treedb}: ` : "") + (message || t("cannot load treedb"));
 }
 
 /************************************************************
@@ -2075,7 +2075,7 @@ function open_json_viewer(gobj, opts)
             close_json_viewer(gobj);
             return;
         }
-        priv.json_modal = yui_shell_show_modal(shell, $box, {
+        priv.json_modal = yui_shell_show_modal(shell, /* i18n: data */ $box, {
             dialog:        true,
             logical_class: "TREEDB_JSON_SHEET",
             title_prefix: priv.treedb_name,
@@ -2224,7 +2224,7 @@ function answer_print_tranger_refused(gobj, path, answer)
             Object.assign({path: path}, answer), gobj);
     } else {
         yui_shell_show_error(yui_shell_of(gobj),
-            answer.i18n || answer.error, {t: t});
+            /* i18n: data */ answer.i18n || answer.error, {t: t});
     }
 }
 
@@ -2386,7 +2386,7 @@ function ac_mt_command_answer(gobj, event, kw, src)
                     {path: path, error: comment || "print-tranger failed"}, gobj);
             } else {
                 yui_shell_show_error(yui_shell_of(gobj),
-                    comment || "print-tranger failed", {t: t});
+                    /* i18n: data */ comment || "print-tranger failed", {t: t});
             }
             return 0;
         }
@@ -2411,7 +2411,7 @@ function ac_mt_command_answer(gobj, event, kw, src)
         }
         if(result < 0) {
             yui_shell_show_error(yui_shell_of(gobj),
-                comment || "schema-file failed", {t: t});
+                /* i18n: data */ comment || "schema-file failed", {t: t});
             return 0;
         }
         gobj_send_event(jv, "EV_SET_JSON", {json: data}, gobj);
@@ -2461,7 +2461,7 @@ function ac_mt_command_answer(gobj, event, kw, src)
              *  app-modal that wedges the whole SPA behind an empty tab. */
             show_load_error(gobj, t(comment));
         } else {
-            yui_shell_show_error(yui_shell_of(gobj), comment, {t: t});
+            yui_shell_show_error(yui_shell_of(gobj), /* i18n: data */ comment, {t: t});
             /*  A refused write leaves the TABLE showing what the operator
              *  typed and the store holding what it had. That is tolerable
              *  for a form (it stays open on the values it failed with) and

package/src/c_yui_window.js

@@ -836,7 +836,7 @@ function close_window(gobj)
         return {state: "vetoed"};
     }
     const answer = yui_shell_confirm_yesnocancel(
-        yui_shell_of(gobj), kw_close.warning,
+        yui_shell_of(gobj), /* i18n: data */ kw_close.warning,
         {t: t, yes_label: "yes", no_label: "no", cancel_label: "cancel"}
     ).then(function(answer) {
         if(answer !== "yes") {
@@ -909,7 +909,7 @@ function set_max_icon(gobj, maximized)
     }
     let $btn = $container.querySelector('.wc-max');
     if($btn) {
-        let key = maximized ? 'restore' : 'maximize';
+        const key = maximized ? 'restore' : 'maximize';
         $btn.innerHTML = maximized ? WC_RESTORE : WC_MAX;
         $btn.setAttribute('title', t(key));
         $btn.setAttribute('data-i18n-title', key);

package/src/c_yui_wizard.js

@@ -75,6 +75,12 @@ SDATA(data_type_t.DTP_POINTER,  "$container",   0,  null,       "HTMLElement roo
 SDATA_END()
 ];
 
+/*  The default keys of the three buttons, which reach t() through the
+ *  attrs: published for a consumer's validate-locales, which asks the
+ *  app's locales for every key of an exported `*_I18N_KEYS` array. A
+ *  host that names its own buttons asks for its own keys besides.  */
+export const C_YUI_WIZARD_I18N_KEYS = ["confirm", "next", "back"];
+
 let PRIVATE_DATA = {
     steps:    null,
     idx:      0,
@@ -267,7 +273,8 @@ function render_chrome(gobj)
 
     $back.classList.toggle('is-hidden', !model.show_back);
 
-    $plabel.setAttribute('data-i18n', model.primary_label);
+    $plabel.setAttribute('data-i18n',
+        /* i18n: WIZARD_HELPERS_I18N_KEYS, C_YUI_WIZARD_I18N_KEYS */ model.primary_label);
     $plabel.textContent = t(model.primary_label);
     $primary.setAttribute('title', t(model.primary_label));
     $primary.setAttribute('data-i18n-title', model.primary_label);

package/src/form_json_field.js

@@ -64,6 +64,13 @@ function value_fits(value, shape)
     }
 }
 
+/*  The key parse_json_field() returns as data (its `error`), which the
+ *  form hands to t(): published for a consumer's validate-locales, which
+ *  asks the app's locales for every key of an exported `*_I18N_KEYS`
+ *  array. i18n_key_functions.test.js holds it to every `error:` this
+ *  module writes.  */
+export const FORM_JSON_FIELD_I18N_KEYS = ["invalid json"];
+
 /************************************************************
  *  Parse what a json field holds.
  *