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/demos/10_column_reordering_debug.html ADDED Viewed

@@ -0,0 +1,277 @@
+<!doctype html>
+<html>
+  <head>
+    <title>Column Reordering Debug Demo</title>
+    <meta charset="utf-8" />
+    <link rel="icon" href="data:," />
+    <style>
+      body {
+        font-family: Arial, sans-serif;
+        margin: 20px;
+        background: #f5f5f5;
+      }
+      .debug-section {
+        background: white;
+        padding: 15px;
+        margin: 10px 0;
+        border-radius: 4px;
+        box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+      }
+      .controls {
+        margin: 10px 0;
+        display: flex;
+        gap: 10px;
+        align-items: center;
+      }
+      button {
+        padding: 8px 16px;
+        border: none;
+        border-radius: 4px;
+        cursor: pointer;
+        font-size: 14px;
+      }
+      .btn-primary {
+        background: #007bff;
+        color: white;
+      }
+      .btn-success {
+        background: #28a745;
+        color: white;
+      }
+      .btn-warning {
+        background: #ffc107;
+        color: black;
+      }
+      .log {
+        background: #2d3748;
+        color: #68d391;
+        padding: 12px;
+        border-radius: 4px;
+        font-family: "Courier New", monospace;
+        font-size: 12px;
+        max-height: 300px;
+        overflow-y: auto;
+        white-space: pre-wrap;
+        margin: 10px 0;
+      }
+      .state-display {
+        background: #f7fafc;
+        border: 1px solid #e2e8f0;
+        border-radius: 4px;
+        padding: 12px;
+        margin: 10px 0;
+      }
+      pre {
+        margin: 0;
+        font-size: 12px;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>Column Reordering Debug Demo</h1>
+    <p>
+      Simple demo with 3 columns and 1 row to debug column reordering issues.
+    </p>
+    <div class="debug-section">
+      <h2>Debug Log</h2>
+      <div id="log" class="log"></div>
+      <button onclick="clearLog()" class="btn-warning">Clear Log</button>
+    </div>
+    <div class="debug-section">
+      <h2>Demo</h2>
+      <div id="root"></div>
+    </div>
+    <script type="module" jsenv-type="module/jsx">
+      import { render } from "preact";
+      import { useState } from "preact/hooks";
+      /* eslint-disable no-unused-vars */
+      import {
+        Table,
+        Colgroup,
+        Col,
+        RowNumberCol,
+        Thead,
+        Tbody,
+        Tr,
+        TableCell,
+        RowNumberTableCell,
+      } from "../table/table.jsx";
+      /* eslint-enable no-unused-vars */
+      import { useCellsAndColumns } from "../table/use_cells_and_columns.js";
+      window.clearLog = () => {
+        document.getElementById("log").textContent = "";
+      };
+      const log = (message) => {
+        const timestamp = new Date().toLocaleTimeString();
+        const logElement = document.getElementById("log");
+        logElement.textContent += `[${timestamp}] ${message}\n`;
+        logElement.scrollTop = logElement.scrollHeight;
+        console.log(`[DEBUG] ${message}`);
+      };
+      // eslint-disable-next-line no-unused-vars
+      const ColumnReorderingDemo = () => {
+        // Initial column configuration
+        const [columnConfig] = useState([
+          { id: "col1", name: "Column A", backgroundColor: "#ffebee" },
+          { id: "col2", name: "Column B", backgroundColor: "#e8f5e8" },
+          { id: "col3", name: "Column C", backgroundColor: "#e3f2fd" },
+        ]);
+        // Simple single row of data
+        const initialCellData = [["A1", "B1", "C1"]];
+        const { cells, setCellValue, columns, setColumnOrder } =
+          useCellsAndColumns(initialCellData, columnConfig);
+        // Get current column order for logging and display
+        const columnOrderedIds = columns.map((col) => col.id);
+        log(`🎬 Demo render - columnOrder: [${columnOrderedIds.join(", ")}]`);
+        const handleColumnOrderChange = (newColumnOrder) => {
+          log(
+            `🔄 Column order changing from [${columnOrderedIds.join(", ")}] to [${newColumnOrder.join(", ")}]`,
+          );
+          setColumnOrder(newColumnOrder);
+        };
+        const handleCellEdit = ({ rowIndex, columnIndex }, value) => {
+          log(
+            `✏️ Cell edit: row=${rowIndex}, col=${columnIndex}, value="${value}"`,
+          );
+          setCellValue({ rowIndex, columnIndex }, value);
+        };
+        // Test buttons for manual reordering
+        const moveFirstToLast = () => {
+          const newOrder = [
+            columnOrderedIds[1],
+            columnOrderedIds[2],
+            columnOrderedIds[0],
+          ];
+          handleColumnOrderChange(newOrder);
+        };
+        const moveLastToFirst = () => {
+          const newOrder = [
+            columnOrderedIds[2],
+            columnOrderedIds[0],
+            columnOrderedIds[1],
+          ];
+          handleColumnOrderChange(newOrder);
+        };
+        const resetOrder = () => {
+          handleColumnOrderChange(["col1", "col2", "col3"]);
+        };
+        return (
+          <div>
+            <div className="controls">
+              <button onClick={moveFirstToLast} className="btn-primary">
+                Move First → Last
+              </button>
+              <button onClick={moveLastToFirst} className="btn-primary">
+                Move Last → First
+              </button>
+              <button onClick={resetOrder} className="btn-success">
+                Reset Order
+              </button>
+            </div>
+            <div className="state-display">
+              <h3>Current State</h3>
+              <div>
+                <strong>Column Order:</strong> [{columnOrderedIds.join(", ")}]
+              </div>
+              <div>
+                <strong>Cell Values:</strong>
+              </div>
+              <pre>{JSON.stringify(cells, null, 2)}</pre>
+            </div>
+            <Table
+              onColumnOrderChange={handleColumnOrderChange}
+              maxWidth={600}
+              maxHeight={400}
+            >
+              <Colgroup>
+                <RowNumberCol width={50} />
+                {columns.map((col) => {
+                  log(`🏗️ Rendering Col: id=${col.id}, width=${col?.width}`);
+                  return (
+                    <Col
+                      key={col.id}
+                      id={col.id}
+                      width={col?.width}
+                      backgroundColor={col.backgroundColor}
+                    />
+                  );
+                })}
+              </Colgroup>
+              <Thead>
+                <Tr>
+                  <RowNumberTableCell />
+                  {columns.map((col) => {
+                    log(`🏗️ Rendering Header: id=${col.id}, name=${col?.name}`);
+                    const rowId = "header";
+                    const columnId = col.id;
+                    const tableCellKey = `${columnId}-${rowId}`;
+                    return (
+                      <TableCell key={tableCellKey}>
+                        {col?.name} (id: {col.id})
+                      </TableCell>
+                    );
+                  })}
+                </Tr>
+              </Thead>
+              <Tbody>
+                {cells.map((rowValues, rowIndex) => (
+                  <Tr key={rowIndex}>
+                    <RowNumberTableCell />
+                    {rowValues.map((cellValue, columnIndex) => {
+                      log(
+                        `🏗️ Rendering Cell: rowIndex=${rowIndex}, columnIndex=${columnIndex},  value="${cellValue}"`,
+                      );
+                      const rowId = rowIndex;
+                      const columnId = columns[columnIndex].id;
+                      // const tableCellKey = columnId;
+                      const tableCellKey = `${columnId}-${rowId}`;
+                      return (
+                        <TableCell
+                          key={tableCellKey}
+                          action={(value) =>
+                            handleCellEdit({ rowIndex, columnIndex }, value)
+                          }
+                        >
+                          {cellValue}
+                        </TableCell>
+                      );
+                    })}
+                  </Tr>
+                ))}
+              </Tbody>
+            </Table>
+            <div className="state-display">
+              <h3>Column Configuration</h3>
+              <pre>{JSON.stringify(columnConfig, null, 2)}</pre>
+            </div>
+          </div>
+        );
+      };
+      // Initial render
+      log("🚀 Starting Column Reordering Demo");
+      render(<ColumnReorderingDemo />, document.getElementById("root"));
+    </script>
+  </body>
+</html>

package/src/components/demos/11_table_selection_debug.html ADDED Viewed

@@ -0,0 +1,432 @@
+<!doctype html>
+<html>
+  <head>
+    <title>Table Selection Debug Demo</title>
+    <meta charset="utf-8" />
+    <link rel="icon" href="data:," />
+    <style>
+      body {
+        font-family: Arial, sans-serif;
+        margin: 20px;
+        background: #f5f5f5;
+      }
+      .debug-section {
+        background: white;
+        padding: 15px;
+        margin: 10px 0;
+        border-radius: 4px;
+        box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+      }
+      .controls {
+        margin: 10px 0;
+        display: flex;
+        gap: 10px;
+        align-items: center;
+        flex-wrap: wrap;
+      }
+      button {
+        padding: 8px 16px;
+        border: none;
+        border-radius: 4px;
+        cursor: pointer;
+        font-size: 14px;
+      }
+      .btn-primary {
+        background: #007bff;
+        color: white;
+      }
+      .btn-success {
+        background: #28a745;
+        color: white;
+      }
+      .btn-warning {
+        background: #ffc107;
+        color: black;
+      }
+      .btn-danger {
+        background: #dc3545;
+        color: white;
+      }
+      .log {
+        background: #2d3748;
+        color: #68d391;
+        padding: 12px;
+        border-radius: 4px;
+        font-family: "Courier New", monospace;
+        font-size: 12px;
+        max-height: 300px;
+        overflow-y: auto;
+        white-space: pre-wrap;
+        margin: 10px 0;
+      }
+      .state-display {
+        background: #f7fafc;
+        border: 1px solid #e2e8f0;
+        border-radius: 4px;
+        padding: 12px;
+        margin: 10px 0;
+      }
+      pre {
+        margin: 0;
+        font-size: 12px;
+      }
+      .selection-info {
+        background: #fff3cd;
+        border: 1px solid #ffeeba;
+        border-radius: 4px;
+        padding: 10px;
+        margin: 10px 0;
+      }
+      .coordinate-buttons {
+        display: grid;
+        grid-template-columns: repeat(3, 1fr);
+        gap: 5px;
+        max-width: 250px;
+      }
+      .coord-label {
+        font-weight: bold;
+        text-align: center;
+        background: #e9ecef;
+        padding: 5px;
+        border-radius: 3px;
+      }
+    </style>
+  </head>
+  <body>
+    <h1>Table Selection Debug Demo</h1>
+    <p>Simple 2x2 table to debug selection behavior and external control.</p>
+    <div class="debug-section">
+      <h2>External Selection Controls</h2>
+      <div class="controls">
+        <button id="select-none" class="btn-danger">Clear Selection</button>
+        <button id="select-all" class="btn-primary">Select All</button>
+        <button id="select-row-0" class="btn-primary">Select Row 0</button>
+        <button id="select-row-1" class="btn-primary">Select Row 1</button>
+        <button id="select-col-0" class="btn-primary">Select Column 0</button>
+        <button id="select-col-1" class="btn-primary">Select Column 1</button>
+      </div>
+      <h3>Select Individual Cells</h3>
+      <div class="coordinate-buttons">
+        <button id="select-header-rownumber" class="btn-success">Row#</button>
+        <button id="select-header-0" class="btn-success">H(0)</button>
+        <button id="select-header-1" class="btn-success">H(1)</button>
+        <button id="select-rownumber-0" class="btn-success">R#1</button>
+        <button id="select-0-0" class="btn-success">(1,1)</button>
+        <button id="select-0-1" class="btn-success">(1,2)</button>
+        <button id="select-rownumber-1" class="btn-success">R#2</button>
+        <button id="select-1-0" class="btn-success">(2,1)</button>
+        <button id="select-1-1" class="btn-success">(2,2)</button>
+      </div>
+    </div>
+    <div class="debug-section">
+      <h2>Demo Table (2x2)</h2>
+      <div id="root"></div>
+    </div>
+    <div class="debug-section">
+      <h2>Selection State</h2>
+      <div id="selection-state" class="selection-info">
+        No selection data yet...
+      </div>
+    </div>
+    <div class="debug-section">
+      <h2>Debug Log</h2>
+      <div id="log" class="log"></div>
+      <button onclick="clearLog()" class="btn-warning">Clear Log</button>
+    </div>
+    <script type="module" jsenv-type="module/jsx">
+      import { render } from "preact";
+      import { useState, useEffect } from "preact/hooks";
+      /* eslint-disable no-unused-vars */
+      import {
+        Table,
+        Colgroup,
+        Col,
+        RowNumberCol,
+        Thead,
+        Tbody,
+        Tr,
+        TableCell,
+        RowNumberTableCell,
+      } from "../table/table.jsx";
+      /* eslint-enable no-unused-vars */
+      import { useCellsAndColumns } from "../table/use_cells_and_columns.js";
+      import {
+        stringifyTableSelectionValue,
+        isCellSelected,
+      } from "../table/selection/table_selection.js";
+      window.clearLog = () => {
+        document.getElementById("log").textContent = "";
+      };
+      const log = (message) => {
+        const timestamp = new Date().toLocaleTimeString();
+        const logElement = document.getElementById("log");
+        logElement.textContent += `[${timestamp}] ${message}\n`;
+        logElement.scrollTop = logElement.scrollHeight;
+        console.log(`[DEBUG] ${message}`);
+      };
+      const updateSelectionDisplay = (selection) => {
+        const selectionElement = document.getElementById("selection-state");
+        if (!selection || selection.size === 0) {
+          selectionElement.innerHTML = "<strong>No selection</strong>";
+          return;
+        }
+        const selectionArray = Array.from(selection);
+        const cellSelections = [];
+        const rowSelections = [];
+        const columnSelections = [];
+        selectionArray.forEach((item) => {
+          if (item.startsWith("row:")) {
+            rowSelections.push(item.slice(4));
+          } else if (item.startsWith("column:")) {
+            columnSelections.push(item.slice(7));
+          } else {
+            cellSelections.push(`(${item})`);
+          }
+        });
+        let displayParts = [];
+        if (cellSelections.length > 0)
+          displayParts.push(`Cells: ${cellSelections.join(", ")}`);
+        if (rowSelections.length > 0)
+          displayParts.push(`Rows: ${rowSelections.join(", ")}`);
+        if (columnSelections.length > 0)
+          displayParts.push(`Columns: ${columnSelections.join(", ")}`);
+        selectionElement.innerHTML = `
+          <strong>Selection:</strong> ${displayParts.join(" | ")}<br>
+          <strong>Total count:</strong> ${selection.size}<br>
+          <strong>Raw values:</strong> ${selectionArray.join(", ")}
+        `;
+      };
+      // eslint-disable-next-line no-unused-vars
+      const TableSelectionDemo = () => {
+        // Simple 2x2 table configuration
+        const [columnConfig] = useState([
+          { id: "col1", name: "Column A" },
+          { id: "col2", name: "Column B" },
+        ]);
+        // 2x2 cell data
+        const initialCellData = [
+          ["A1", "B1"],
+          ["A2", "B2"],
+        ];
+        const { cells, setCellValue, columns } = useCellsAndColumns(
+          initialCellData,
+          columnConfig,
+        );
+        // Selection state (controlled from outside)
+        const [selectedCells, setSelectedCells] = useState([]);
+        // Log selection changes
+        useEffect(() => {
+          log(
+            `🎯 Selection changed: ${Array.from(selectedCells).join(", ") || "none"}`,
+          );
+          updateSelectionDisplay(selectedCells);
+        }, [selectedCells]);
+        const handleCellEdit = ({ rowIndex, columnIndex }, value) => {
+          log(
+            `✏️ Cell edit: row=${rowIndex}, col=${columnIndex}, value="${value}"`,
+          );
+          setCellValue({ rowIndex, columnIndex }, value);
+        };
+        const handleSelectionChange = (newSelection) => {
+          log(`🔄 Selection changing from internal table interaction`);
+          setSelectedCells(newSelection);
+        };
+        // External control functions
+        const selectNone = () => {
+          log(`🚫 External: Clear selection`);
+          setSelectedCells([]);
+        };
+        const selectAll = () => {
+          log(`📱 External: Select all cells`);
+          const allCells = [
+            stringifyTableSelectionValue("cell", {
+              rowIndex: 0,
+              columnIndex: 0,
+            }),
+            stringifyTableSelectionValue("cell", {
+              rowIndex: 0,
+              columnIndex: 1,
+            }),
+            stringifyTableSelectionValue("cell", {
+              rowIndex: 1,
+              columnIndex: 0,
+            }),
+            stringifyTableSelectionValue("cell", {
+              rowIndex: 1,
+              columnIndex: 1,
+            }),
+          ];
+          setSelectedCells(allCells);
+        };
+        const selectRow = (rowIndex) => {
+          log(`📏 External: Select row ${rowIndex}`);
+          const rowValue = stringifyTableSelectionValue("row", rowIndex);
+          setSelectedCells([rowValue]);
+        };
+        const selectColumn = (columnIndex) => {
+          log(`📐 External: Select column ${columnIndex}`);
+          const columnValue = stringifyTableSelectionValue(
+            "column",
+            columnIndex,
+          );
+          setSelectedCells([columnValue]);
+        };
+        const selectCell = (rowIndex, columnIndex) => {
+          log(`🎯 External: Select single cell (${rowIndex},${columnIndex})`);
+          const cellValue = stringifyTableSelectionValue("cell", {
+            rowIndex,
+            columnIndex,
+          });
+          setSelectedCells([cellValue]);
+        };
+        const selectHeaderCell = (columnIndex) => {
+          log(`📋 External: Select header cell for column ${columnIndex}`);
+          // Headers are at row index -1 in the visual table
+          const headerValue = stringifyTableSelectionValue("cell", {
+            rowIndex: 0,
+            columnIndex,
+          });
+          setSelectedCells([headerValue]);
+        };
+        const selectRowNumberCell = (rowIndex) => {
+          log(`🔢 External: Select row number cell for row ${rowIndex}`);
+          // Row numbers are at column index -1 in the visual table
+          const rowNumberValue = stringifyTableSelectionValue("cell", {
+            rowIndex,
+            columnIndex: 0,
+          });
+          setSelectedCells([rowNumberValue]);
+        };
+        const selectHeaderRowNumberCell = () => {
+          log(`🏠 External: Select header row number cell`);
+          // Corner cell is at (-1, -1) in the visual table
+          const cornerValue = stringifyTableSelectionValue("cell", {
+            rowIndex: 0,
+            columnIndex: 0,
+          });
+          setSelectedCells([cornerValue]);
+        };
+        // Setup external control button handlers
+        useEffect(() => {
+          const setupButton = (id, handler) => {
+            const button = document.getElementById(id);
+            if (button) {
+              button.onclick = handler;
+            }
+          };
+          setupButton("select-none", selectNone);
+          setupButton("select-all", selectAll);
+          setupButton("select-row-0", () => selectRow(0));
+          setupButton("select-row-1", () => selectRow(1));
+          setupButton("select-col-0", () => selectColumn(0));
+          setupButton("select-col-1", () => selectColumn(1));
+          setupButton("select-0-0", () => selectCell(1, 1));
+          setupButton("select-0-1", () => selectCell(1, 2));
+          setupButton("select-1-0", () => selectCell(2, 1));
+          setupButton("select-1-1", () => selectCell(2, 2));
+          // Header cells: visual column 0 and 1 at header row -1
+          setupButton("select-header-rownumber", selectHeaderRowNumberCell);
+          setupButton("select-header-0", () => selectHeaderCell(1));
+          setupButton("select-header-1", () => selectHeaderCell(2));
+          // Row number cells: visual row 0 and 1 at row number column -1
+          setupButton("select-rownumber-0", () => selectRowNumberCell(1));
+          setupButton("select-rownumber-1", () => selectRowNumberCell(2));
+        }, []);
+        log(`🎬 Demo render - cells: ${cells.length}x${cells[0]?.length}`);
+        return (
+          <div>
+            <Table
+              selection={selectedCells}
+              onSelectionChange={handleSelectionChange}
+              maxWidth={400}
+              maxHeight={300}
+            >
+              <Colgroup>
+                <RowNumberCol width={60} />
+                {columns.map((col) => {
+                  log(`🏗️ Rendering Col: id=${col.id}`);
+                  return <Col key={col.id} id={col.id} width={120} />;
+                })}
+              </Colgroup>
+              <Thead>
+                <Tr>
+                  <RowNumberTableCell />
+                  {columns.map((col) => {
+                    log(`🏗️ Rendering Header: id=${col.id}, name=${col?.name}`);
+                    return <TableCell key={col.id}>{col?.name}</TableCell>;
+                  })}
+                </Tr>
+              </Thead>
+              <Tbody>
+                {cells.map((rowValues, rowIndex) => (
+                  <Tr key={rowIndex}>
+                    <RowNumberTableCell />
+                    {rowValues.map((cellValue, columnIndex) => {
+                      const isSelected = isCellSelected(selectedCells, {
+                        rowIndex,
+                        columnIndex,
+                      });
+                      log(
+                        `🏗️ Rendering Cell: (${rowIndex},${columnIndex}) value="${cellValue}" selected=${isSelected}`,
+                      );
+                      return (
+                        <TableCell
+                          key={columnIndex}
+                          action={(value) =>
+                            handleCellEdit({ rowIndex, columnIndex }, value)
+                          }
+                          backgroundColor="yellow"
+                        >
+                          {cellValue}
+                        </TableCell>
+                      );
+                    })}
+                  </Tr>
+                ))}
+              </Tbody>
+            </Table>
+          </div>
+        );
+      };
+      // Initial render
+      log("🚀 Starting Table Selection Demo");
+      render(<TableSelectionDemo />, document.getElementById("root"));
+    </script>
+  </body>
+</html>