npm - @jsenv/navi - Versions diffs - 0.0.1 → 0.1.0 - Mend

@jsenv/navi 0.0.1 → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (138) hide show

package/dist/jsenv_navi.js +22954 -0
package/index.js +66 -16
package/package.json +22 -11
package/src/actions.js +50 -26
package/src/browser_integration/browser_integration.js +31 -6
package/src/browser_integration/via_history.js +42 -9
package/src/components/action_execution/render_actionable_component.jsx +6 -4
package/src/components/action_execution/use_action.js +51 -282
package/src/components/action_execution/use_execute_action.js +106 -92
package/src/components/action_execution/use_run_on_mount.js +9 -0
package/src/components/action_renderer.jsx +21 -32
package/src/components/demos/0_button_demo.html +574 -103
package/src/components/demos/10_column_reordering_debug.html +277 -0
package/src/components/demos/11_table_selection_debug.html +432 -0
package/src/components/demos/1_checkbox_demo.html +579 -202
package/src/components/demos/2_input_textual_demo.html +81 -138
package/src/components/demos/3_radio_demo.html +0 -2
package/src/components/demos/4_select_demo.html +19 -23
package/src/components/demos/6_tablist_demo.html +77 -0
package/src/components/demos/7_table_selection_demo.html +176 -0
package/src/components/demos/8_table_fixed_headers_demo.html +584 -0
package/src/components/demos/9_table_column_drag_demo.html +325 -0
package/src/components/demos/action/0_button_demo.html +2 -4
package/src/components/demos/action/1_input_text_demo.html +643 -222
package/src/components/demos/action/3_details_demo.html +146 -115
package/src/components/demos/action/4_input_checkbox_demo.html +442 -322
package/src/components/demos/action/5_input_checkbox_state_demo.html +270 -0
package/src/components/demos/action/6_checkbox_list_demo.html +304 -72
package/src/components/demos/action/7_radio_list_demo.html +310 -170
package/src/components/demos/action/{8_editable_text_demo.html → 8_editable_demo.html} +65 -76
package/src/components/demos/action/9_link_demo.html +84 -62
package/src/components/demos/ui_transition/0_action_renderer_ui_transition_demo.html +695 -0
package/src/components/demos/ui_transition/1_nested_ui_transition_demo.html +429 -0
package/src/components/demos/ui_transition/2_height_transition_test.html +295 -0
package/src/components/details/details.jsx +62 -64
package/src/components/edition/editable.jsx +186 -0
package/src/components/field/README.md +247 -0
package/src/components/{input → field}/button.jsx +151 -130
package/src/components/field/checkbox_list.jsx +184 -0
package/src/components/{collect_form_element_values.js → field/collect_form_element_values.js} +7 -4
package/src/components/{input → field}/field_css.js +4 -1
package/src/components/field/form.jsx +211 -0
package/src/components/{input → field}/input.jsx +1 -0
package/src/components/{input → field}/input_checkbox.jsx +132 -155
package/src/components/{input → field}/input_radio.jsx +135 -46
package/src/components/{input → field}/input_textual.jsx +247 -173
package/src/components/field/label.jsx +32 -0
package/src/components/field/radio_list.jsx +182 -0
package/src/components/{input → field}/select.jsx +17 -32
package/src/components/field/use_action_events.js +132 -0
package/src/components/field/use_form_events.js +55 -0
package/src/components/field/use_ui_state_controller.js +506 -0
package/src/components/item_tracker/README.md +461 -0
package/src/components/item_tracker/use_isolated_item_tracker.jsx +209 -0
package/src/components/item_tracker/use_isolated_item_tracker_demo.html +148 -0
package/src/components/item_tracker/use_isolated_item_tracker_demo.jsx +460 -0
package/src/components/item_tracker/use_item_tracker.jsx +143 -0
package/src/components/item_tracker/use_item_tracker_demo.html +207 -0
package/src/components/item_tracker/use_item_tracker_demo.jsx +216 -0
package/src/components/keyboard_shortcuts/active_keyboard_shortcuts.jsx +87 -0
package/src/components/keyboard_shortcuts/aria_key_shortcuts.js +61 -0
package/src/components/keyboard_shortcuts/keyboard_key_meta.js +17 -0
package/src/components/keyboard_shortcuts/keyboard_shortcuts.js +371 -0
package/src/components/link/link.jsx +65 -102
package/src/components/link/link_with_icon.jsx +52 -0
package/src/components/loader/loader_background.jsx +85 -64
package/src/components/loader/rectangle_loading.jsx +38 -19
package/src/components/route.jsx +8 -4
package/src/components/selection/selection.jsx +1583 -0
package/src/components/svg/font_sized_svg.jsx +45 -0
package/src/components/svg/icon_and_text.jsx +21 -0
package/src/components/svg/svg_mask_overlay.jsx +105 -0
package/src/components/table/drag/table_drag.jsx +506 -0
package/src/components/table/resize/table_resize.jsx +650 -0
package/src/components/table/resize/table_size.js +43 -0
package/src/components/table/selection/table_selection.js +106 -0
package/src/components/table/selection/table_selection.jsx +203 -0
package/src/components/table/sticky/sticky_group.js +354 -0
package/src/components/table/sticky/table_sticky.js +25 -0
package/src/components/table/sticky/table_sticky.jsx +501 -0
package/src/components/table/table.jsx +721 -0
package/src/components/table/table_css.js +211 -0
package/src/components/table/table_ui.jsx +49 -0
package/src/components/table/use_cells_and_columns.js +90 -0
package/src/components/table/use_object_array_to_cells.js +46 -0
package/src/components/table/z_indexes.js +23 -0
package/src/components/tablist/tablist.jsx +99 -0
package/src/components/text/overflow.jsx +15 -0
package/src/components/text/text_and_count.jsx +28 -0
package/src/components/ui_transition.jsx +128 -0
package/src/components/use_auto_focus.js +58 -7
package/src/components/use_batch_during_render.js +33 -0
package/src/components/use_debounce_true.js +7 -7
package/src/components/use_dependencies_diff.js +35 -0
package/src/components/use_focus_group.js +4 -3
package/src/components/use_initial_value.js +8 -34
package/src/components/use_signal_sync.js +1 -1
package/src/components/use_stable_callback.js +68 -0
package/src/components/use_state_array.js +16 -9
package/src/docs/actions.md +22 -0
package/src/notes.md +33 -12
package/src/route/route.js +97 -47
package/src/store/resource_graph.js +2 -1
package/src/store/tests/{resource_graph_dependencies.test.js → resource_graph_dependencies.test_manual.js} +13 -13
package/src/utils/is_signal.js +20 -0
package/src/utils/stringify_for_display.js +4 -23
package/src/validation/constraints/confirm_constraint.js +14 -0
package/src/validation/constraints/create_unique_value_constraint.js +27 -0
package/src/validation/constraints/native_constraints.js +313 -0
package/src/validation/constraints/readonly_constraint.js +36 -0
package/src/validation/constraints/single_space_constraint.js +13 -0
package/src/validation/custom_constraint_validation.js +599 -0
package/src/validation/custom_message.js +18 -0
package/src/validation/demos/browser_style.png +0 -0
package/src/validation/demos/form_validation_demo.html +142 -0
package/src/validation/demos/form_validation_demo_preact.html +87 -0
package/src/validation/demos/form_validation_native_popover_demo.html +168 -0
package/src/validation/demos/form_validation_vs_native_demo.html +172 -0
package/src/validation/demos/validation_message_demo.html +203 -0
package/src/validation/hooks/use_constraints.js +23 -0
package/src/validation/hooks/use_custom_validation_ref.js +73 -0
package/src/validation/hooks/use_validation_message.js +19 -0
package/src/validation/validation_message.js +741 -0
package/src/components/editable_text/editable_text.jsx +0 -96
package/src/components/form.jsx +0 -144
package/src/components/input/checkbox_list.jsx +0 -294
package/src/components/input/field.jsx +0 -61
package/src/components/input/radio_list.jsx +0 -283
package/src/components/input/use_form_event.js +0 -20
package/src/components/input/use_on_change.js +0 -12
package/src/components/selection/selection.js +0 -5
package/src/components/selection/selection_context.jsx +0 -262
package/src/components/shortcut/shortcut_context.jsx +0 -390
package/src/components/use_action_events.js +0 -37
package/src/utils/iterable_weak_set.js +0 -62
/package/src/components/demos/action/{11_nested_shortcuts_demo.html → 11_nested_shortcuts_demo.xhtml} +0 -0
/package/src/components/{shortcut → keyboard_shortcuts}/os.js +0 -0
/package/src/route/{route.test.html → route.xtest.html} +0 -0

package/src/components/item_tracker/use_item_tracker.jsx ADDED Viewed

@@ -0,0 +1,143 @@
+import { createContext } from "preact";
+import { useContext, useMemo, useRef } from "preact/hooks";
+/*
+ * Item Tracker - For colocated producer/consumer scenarios
+ *
+ * USE CASE:
+ * This is for scenarios where producers and consumers are in the same
+ * component tree, such as:
+ * - TableRow components registering themselves
+ * - TableCell components accessing row data by index
+ * - Both happen within the same table structure
+ *
+ * Unlike the isolated producer/consumer system, this doesn't need complex
+ * synchronization because everything happens in the same render cycle.
+ *
+ * USAGE:
+ * ```jsx
+ * // Create domain-specific tracker hooks
+ * const [useRowTrackerProvider, useRegisterRow, useRow, useRows] = createItemTracker();
+ *
+ * function App() {
+ *   const RowTrackerProvider = useRowTrackerProvider();
+ *
+ *   return (
+ *     <RowTrackerProvider>
+ *       <table>
+ *         <tbody>
+ *           {rows.map(({ id, name, color }) => (
+ *             <TableRow key={id} name={name} color={color}>
+ *               <TableCell column="name" />
+ *               <TableCell column="color" />
+ *             </TableRow>
+ *           ))}
+ *         </tbody>
+ *       </table>
+ *       <TrackedRowsList />
+ *     </RowTrackerProvider>
+ *   );
+ * }
+ *
+ * function TableRow({ name, color, children }) {
+ *   const rowIndex = useRegisterRow({ name, color });
+ *   return (
+ *     <tr>
+ *       <TableRowIndexContext.Provider value={rowIndex}>
+ *         {children}
+ *       </TableRowIndexContext.Provider>
+ *     </tr>
+ *   );
+ * }
+ *
+ * function TableCell({ column }) {
+ *   const rowIndex = useContext(TableRowIndexContext);
+ *   const rowData = useRow(rowIndex);
+ *   return <td>{rowData[column]}</td>;
+ * }
+ *
+ * function TrackedRowsList() {
+ *   const rows = useRows();
+ *   return <div>Total rows: {rows.length}</div>;
+ * }
+ * ```
+ */
+export const createItemTracker = () => {
+  const ItemTrackerContext = createContext();
+  const useItemTrackerProvider = () => {
+    const itemsRef = useRef([]);
+    const items = itemsRef.current;
+    const itemCountRef = useRef(0);
+    const tracker = useMemo(() => {
+      const ItemTrackerProvider = ({ children }) => {
+        // Reset on each render to start fresh
+        tracker.reset();
+        return (
+          <ItemTrackerContext.Provider value={tracker}>
+            {children}
+          </ItemTrackerContext.Provider>
+        );
+      };
+      ItemTrackerProvider.items = items;
+      return {
+        ItemTrackerProvider,
+        items,
+        registerItem: (data) => {
+          const index = itemCountRef.current++;
+          items[index] = data;
+          return index;
+        },
+        getItem: (index) => {
+          return items[index];
+        },
+        getAllItems: () => {
+          return items;
+        },
+        reset: () => {
+          items.length = 0;
+          itemCountRef.current = 0;
+        },
+      };
+    }, []);
+    return tracker.ItemTrackerProvider;
+  };
+  const useTrackItem = (data) => {
+    const tracker = useContext(ItemTrackerContext);
+    if (!tracker) {
+      throw new Error(
+        "useTrackItem must be used within SimpleItemTrackerProvider",
+      );
+    }
+    return tracker.registerItem(data);
+  };
+  const useTrackedItem = (index) => {
+    const trackedItems = useTrackedItems();
+    const item = trackedItems[index];
+    return item;
+  };
+  const useTrackedItems = () => {
+    const tracker = useContext(ItemTrackerContext);
+    if (!tracker) {
+      throw new Error(
+        "useTrackedItems must be used within SimpleItemTrackerProvider",
+      );
+    }
+    return tracker.items;
+  };
+  return [
+    useItemTrackerProvider,
+    useTrackItem,
+    useTrackedItem,
+    useTrackedItems,
+  ];
+};

package/src/components/item_tracker/use_item_tracker_demo.html ADDED Viewed

@@ -0,0 +1,207 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>Item Tracker Demo</title>
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <link rel="icon" href="data:," />
+    <style>
+      body {
+        font-family: system-ui, sans-serif;
+        margin: 20px;
+        background: #f5f5f5;
+      }
+      .demo-container {
+        max-width: 800px;
+        margin: 0 auto;
+        background: white;
+        padding: 20px;
+        border-radius: 8px;
+        box-shadow: 0 2px 10px rgba(0, 0, 0, 0.1);
+      }
+      .section {
+        margin-bottom: 25px;
+        padding: 15px;
+        border: 1px solid #ddd;
+        border-radius: 6px;
+        background: #fafafa;
+      }
+      .section h3 {
+        margin: 0 0 15px 0;
+        font-size: 16px;
+        color: #333;
+        border-bottom: 1px solid #eee;
+        padding-bottom: 8px;
+      }
+      .table-container {
+        border: 1px solid #ccc;
+        border-radius: 4px;
+        overflow: hidden;
+      }
+      .table {
+        width: 100%;
+        border-collapse: collapse;
+        background: white;
+      }
+      .table th,
+      .table td {
+        padding: 8px 12px;
+        text-align: left;
+        border-bottom: 1px solid #eee;
+        font-size: 12px;
+      }
+      .table th {
+        background: #f8f9fa;
+        font-weight: 600;
+        color: #495057;
+      }
+      .table-row {
+        position: relative;
+      }
+      .table-row--red {
+        background-color: #ffebee;
+      }
+      .table-row--blue {
+        background-color: #e3f2fd;
+      }
+      .table-row--green {
+        background-color: #e8f5e8;
+      }
+      .table-row--yellow {
+        background-color: #fff8e1;
+      }
+      .controls {
+        display: flex;
+        gap: 8px;
+        align-items: center;
+        flex-wrap: wrap;
+      }
+      .btn {
+        padding: 4px 8px;
+        font-size: 11px;
+        border: 1px solid #ddd;
+        border-radius: 3px;
+        background: white;
+        cursor: pointer;
+        color: #333;
+      }
+      .btn:hover {
+        background: #f0f0f0;
+      }
+      .btn--primary {
+        background: #007bff;
+        color: white;
+        border-color: #007bff;
+      }
+      .btn--primary:hover {
+        background: #0056b3;
+      }
+      .btn--small {
+        padding: 2px 6px;
+        font-size: 10px;
+      }
+      .info-grid {
+        display: grid;
+        grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
+        gap: 10px;
+        margin-top: 10px;
+      }
+      .info-item {
+        background: white;
+        padding: 8px;
+        border-radius: 4px;
+        border: 1px solid #e0e0e0;
+        font-size: 11px;
+      }
+      .info-item strong {
+        color: #333;
+        display: block;
+        margin-bottom: 4px;
+      }
+      .tracked-rows {
+        display: flex;
+        flex-direction: column;
+        gap: 4px;
+      }
+      .tracked-row-item {
+        background: white;
+        padding: 6px 8px;
+        border-radius: 3px;
+        border: 1px solid #ddd;
+        font-size: 10px;
+        display: flex;
+        justify-content: space-between;
+        align-items: center;
+      }
+      .log {
+        background: #f8f9fa;
+        border: 1px solid #dee2e6;
+        border-radius: 4px;
+        padding: 10px;
+        font-family: "Courier New", monospace;
+        font-size: 10px;
+        max-height: 200px;
+        overflow-y: auto;
+        white-space: pre-wrap;
+      }
+    </style>
+  </head>
+  <body>
+    <div class="demo-container">
+      <h1>Simple Item Tracker Demo</h1>
+      <p>
+        <strong>Use Case:</strong> TableRow components register themselves,
+        TableCell components access row data by index.
+      </p>
+      <p>
+        This demonstrates colocated producer/consumer usage - simpler than the
+        separated colgroup scenario.
+      </p>
+      <div id="app-root"></div>
+      <div class="section">
+        <h3>🔍 Debug Log</h3>
+        <div id="log" class="log"></div>
+        <button class="btn btn--small" onclick="window.clearLog()">
+          Clear Log
+        </button>
+      </div>
+    </div>
+    <script type="module" jsenv-type="module/jsx">
+      import { render } from "preact";
+      // eslint-disable-next-line no-unused-vars
+      import { App } from "./use_item_tracker_demo.jsx";
+      const logContainer = document.getElementById("log");
+      window.clearLog = () => {
+        logContainer.textContent = "";
+      };
+      // Render the app
+      render(<App />, document.getElementById("app-root"));
+    </script>
+  </body>
+</html>

package/src/components/item_tracker/use_item_tracker_demo.jsx ADDED Viewed

@@ -0,0 +1,216 @@
+import { createContext } from "preact";
+import { useContext, useState } from "preact/hooks";
+import { createItemTracker } from "./use_item_tracker.jsx";
+const [useRowTrackerProvider, useRegisterRow, useRow, useRows] =
+  createItemTracker();
+// Main demo app
+export const App = () => {
+  const [rows, setRows] = useState([
+    {
+      id: "a",
+      name: "First Row",
+      color: "red",
+      category: "Type A",
+      value: 100,
+    },
+    {
+      id: "b",
+      name: "Second Row",
+      color: "blue",
+      category: "Type B",
+      value: 200,
+    },
+  ]);
+  const [renderKey, setRenderKey] = useState(0);
+  log(`🎬 App render #${renderKey}`);
+  const RowTrackerProvider = useRowTrackerProvider();
+  const addRow = () => {
+    const colors = ["red", "blue", "green", "yellow"];
+    const newId = String.fromCharCode(97 + rows.length);
+    const newRow = {
+      id: newId,
+      name: `Row ${newId.toUpperCase()}`,
+      color: colors[Math.floor(Math.random() * colors.length)],
+    };
+    setRows((prev) => [...prev, newRow]);
+    log(`➕ Added row: ${JSON.stringify(newRow)}`);
+  };
+  const removeLastRow = () => {
+    if (rows.length > 0) {
+      const removed = rows[rows.length - 1];
+      setRows((prev) => prev.slice(0, -1));
+      log(`➖ Removed row: ${removed.name}`);
+    }
+  };
+  const forceRerender = () => {
+    setRenderKey((prev) => prev + 1);
+    log(`🔄 Forced re-render #${renderKey + 1}`);
+  };
+  return (
+    <div>
+      <div className="section">
+        <h3>🎮 Controls</h3>
+        <div className="controls">
+          <button className="btn btn--primary" onClick={addRow}>
+            ➕ Add Row
+          </button>
+          <button className="btn" onClick={removeLastRow}>
+            ➖ Remove Last Row
+          </button>
+          <button className="btn" onClick={forceRerender}>
+            🔄 Force Re-render
+          </button>
+          <span style={{ fontSize: "11px", opacity: 0.7 }}>
+            Render #{renderKey}
+          </span>
+        </div>
+      </div>
+      <RowTrackerProvider>
+        <div className="section">
+          <h3>📋 Table with Tracked Rows</h3>
+          <p style={{ fontSize: "12px", margin: "0 0 10px 0", color: "#666" }}>
+            💡 Change colors using the dropdown in each row to trigger
+            individual row re-renders. Notice how only that specific row
+            re-renders and updates its tracked data.
+          </p>
+          <div className="table-container">
+            <table className="table">
+              <thead>
+                <tr>
+                  <th>Name</th>
+                  <th>Color</th>
+                  <th>Color Override</th>
+                </tr>
+              </thead>
+              <tbody>
+                {rows.map(({ id, name, color }) => (
+                  <TableRow key={id} name={name} color={color}>
+                    <TableCell column="name" />
+                    <TableCell column="color" />
+                    {/* Color selector is rendered directly in TableRow */}
+                  </TableRow>
+                ))}
+              </tbody>
+            </table>
+          </div>
+        </div>
+        <div className="section">
+          <h3>🔍 Tracked Items Debug</h3>
+          <TrackedRowsList />
+        </div>
+      </RowTrackerProvider>
+    </div>
+  );
+};
+// Simple logging
+const logContainer = document.getElementById("log");
+const log = (message) => {
+  const timestamp = new Date().toLocaleTimeString();
+  logContainer.textContent += `[${timestamp}] ${message}\n`;
+  logContainer.scrollTop = logContainer.scrollHeight;
+};
+const TableRowIndexContext = createContext();
+// Demo components
+const TableRow = ({ children, name, color: initialColor }) => {
+  // Local state for color override
+  const [localColor, setLocalColor] = useState(initialColor);
+  // Use local color if it differs from initial, otherwise use initial
+  const currentColor = localColor !== initialColor ? localColor : initialColor;
+  // Register this row and get its index
+  const rowIndex = useRegisterRow({ name, color: currentColor });
+  log(`🎬 TableRow ${rowIndex} render (${name}, color: ${currentColor})`);
+  const handleColorChange = (event) => {
+    const newColor = event.target.value;
+    setLocalColor(newColor);
+    log(`🎨 Row ${rowIndex} color changed to ${newColor}`);
+  };
+  return (
+    <tr className={`table-row table-row--${currentColor}`}>
+      <TableRowIndexContext.Provider value={rowIndex}>
+        {children}
+        <td>
+          <select
+            value={currentColor}
+            onChange={handleColorChange}
+            style={{ fontSize: "10px", padding: "2px" }}
+          >
+            <option value="red">Red</option>
+            <option value="blue">Blue</option>
+            <option value="green">Green</option>
+            <option value="yellow">Yellow</option>
+          </select>
+          {localColor !== initialColor && (
+            <small style={{ marginLeft: "4px", opacity: 0.7 }}>
+              (overridden)
+            </small>
+          )}
+        </td>
+      </TableRowIndexContext.Provider>
+    </tr>
+  );
+};
+const TableCell = ({ column }) => {
+  const rowIndex = useContext(TableRowIndexContext);
+  const rowData = useRow(rowIndex);
+  if (!rowData) {
+    return <td>❌ Row {rowIndex} not found</td>;
+  }
+  const cellContent = rowData[column] || `${column}?`;
+  return (
+    <td title={`Row ${rowIndex}, Column ${column}`}>
+      {cellContent}
+      <small style={{ opacity: 0.6, marginLeft: "4px" }}>
+        (row {rowIndex})
+      </small>
+    </td>
+  );
+};
+const TrackedRowsList = () => {
+  const rows = useRows();
+  return (
+    <div className="tracked-rows">
+      <strong>All Tracked Rows ({rows.length}):</strong>
+      {rows.map((item, index) => (
+        <div key={index} className="tracked-row-item">
+          <span>
+            #{index}: {item.name}
+          </span>
+          <span style={{ color: item.color, fontWeight: "bold" }}>
+            {item.color}
+          </span>
+        </div>
+      ))}
+      {rows.length === 0 && (
+        <div style={{ opacity: 0.6, fontStyle: "italic" }}>
+          No rows tracked yet
+        </div>
+      )}
+    </div>
+  );
+};

package/src/components/keyboard_shortcuts/active_keyboard_shortcuts.jsx ADDED Viewed

@@ -0,0 +1,87 @@
+import { generateAriaKeyShortcuts } from "./aria_key_shortcuts.js";
+import { activeShortcutsSignal } from "./keyboard_shortcuts.js";
+import.meta.css = /* css */ `
+  .navi_shortcut_container[data-visually-hidden] {
+    /* Visually hidden container - doesn't affect layout */
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+    /* Ensure it's not interactable */
+    opacity: 0;
+    pointer-events: none;
+  }
+  .navi_shortcut_button[data-visually-hidden] {
+    /* Visually hidden but accessible to screen readers */
+    position: absolute;
+    width: 1px;
+    height: 1px;
+    padding: 0;
+    margin: -1px;
+    overflow: hidden;
+    clip: rect(0, 0, 0, 0);
+    white-space: nowrap;
+    border: 0;
+    /* Ensure it's not focusable via tab navigation */
+    opacity: 0;
+    pointer-events: none;
+  }
+`;
+export const ActiveKeyboardShortcuts = ({ visible }) => {
+  const activeShortcuts = activeShortcutsSignal.value;
+  return (
+    <div
+      className="navi_shortcut_container"
+      data-visually-hidden={visible ? undefined : ""}
+    >
+      {activeShortcuts.map((shortcut) => {
+        return (
+          <KeyboardShortcutAriaElement
+            key={shortcut.key}
+            visible={visible}
+            keyCombination={shortcut.key}
+            description={shortcut.description}
+            enabled={shortcut.enabled}
+            data-action={shortcut.action ? shortcut.action.name : undefined}
+            data-confirm-message={shortcut.confirmMessage}
+          />
+        );
+      })}
+    </div>
+  );
+};
+const KeyboardShortcutAriaElement = ({
+  visible,
+  keyCombination,
+  description,
+  enabled,
+  ...props
+}) => {
+  if (typeof keyCombination === "function") {
+    return null;
+  }
+  const ariaKeyshortcuts = generateAriaKeyShortcuts(keyCombination);
+  return (
+    <button
+      className="navi_shortcut_button"
+      data-visually-hidden={visible ? undefined : ""}
+      aria-keyshortcuts={ariaKeyshortcuts}
+      tabIndex="-1"
+      disabled={!enabled}
+      {...props}
+    >
+      {description}
+    </button>
+  );
+};

package/src/components/keyboard_shortcuts/aria_key_shortcuts.js ADDED Viewed

@@ -0,0 +1,61 @@
+import { keyMapping } from "./keyboard_key_meta.js";
+import { isMac } from "./os.js";
+// http://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-keyshortcuts
+export const generateAriaKeyShortcuts = (key) => {
+  let actualCombination;
+  // Handle platform-specific combination objects
+  if (typeof key === "object" && key !== null) {
+    actualCombination = isMac ? key.mac : key.other;
+  } else {
+    actualCombination = key;
+  }
+  if (actualCombination) {
+    return normalizeKeyCombination(actualCombination);
+  }
+  return "";
+};
+const normalizeKeyCombination = (combination) => {
+  const lowerCaseCombination = combination.toLowerCase();
+  const keys = lowerCaseCombination.split("+");
+  // First normalize keys to their canonical form, then apply ARIA mapping
+  for (let i = 0; i < keys.length; i++) {
+    let key = normalizeKey(keys[i]);
+    // Then apply ARIA-specific mappings if they exist
+    if (keyToAriaKeyMapping[key]) {
+      key = keyToAriaKeyMapping[key];
+    }
+    keys[i] = key;
+  }
+  return keys.join("+");
+};
+const keyToAriaKeyMapping = {
+  // Platform-specific ARIA names
+  command: "meta",
+  option: "altgraph", // Mac option key uses "altgraph" in ARIA spec
+  // Regular keys - platform-specific normalization
+  delete: isMac ? "backspace" : "delete", // Mac delete key is backspace semantically
+  backspace: isMac ? "backspace" : "delete",
+};
+const normalizeKey = (key) => {
+  key = key.toLowerCase();
+  // Find the canonical form for this key
+  for (const [canonicalKey, config] of Object.entries(keyMapping)) {
+    const allKeys = [canonicalKey, ...config.alias];
+    if (allKeys.includes(key)) {
+      return canonicalKey;
+    }
+  }
+  return key;
+};