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

@jsenv/navi 0.0.1

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 (123) hide show

package/index.js +51 -0
package/package.json +38 -0
package/src/action_private_properties.js +11 -0
package/src/action_proxy_test.html +353 -0
package/src/action_run_states.js +5 -0
package/src/actions.js +1377 -0
package/src/browser_integration/browser_integration.js +191 -0
package/src/browser_integration/document_back_and_forward.js +17 -0
package/src/browser_integration/document_loading_signal.js +100 -0
package/src/browser_integration/document_state_signal.js +9 -0
package/src/browser_integration/document_url_signal.js +9 -0
package/src/browser_integration/use_is_visited.js +19 -0
package/src/browser_integration/via_history.js +199 -0
package/src/browser_integration/via_navigation.js +168 -0
package/src/components/action_execution/form_context.js +8 -0
package/src/components/action_execution/render_actionable_component.jsx +27 -0
package/src/components/action_execution/use_action.js +330 -0
package/src/components/action_execution/use_execute_action.js +161 -0
package/src/components/action_renderer.jsx +136 -0
package/src/components/collect_form_element_values.js +79 -0
package/src/components/demos/0_button_demo.html +155 -0
package/src/components/demos/1_checkbox_demo.html +257 -0
package/src/components/demos/2_input_textual_demo.html +354 -0
package/src/components/demos/3_radio_demo.html +222 -0
package/src/components/demos/4_select_demo.html +104 -0
package/src/components/demos/5_list_scrollable_demo.html +153 -0
package/src/components/demos/action/0_button_demo.html +204 -0
package/src/components/demos/action/10_shortcuts_demo.html +189 -0
package/src/components/demos/action/11_nested_shortcuts_demo.html +401 -0
package/src/components/demos/action/1_input_text_demo.html +461 -0
package/src/components/demos/action/2_form_multiple.html +303 -0
package/src/components/demos/action/3_details_demo.html +172 -0
package/src/components/demos/action/4_input_checkbox_demo.html +611 -0
package/src/components/demos/action/6_checkbox_list_demo.html +109 -0
package/src/components/demos/action/7_radio_list_demo.html +217 -0
package/src/components/demos/action/8_editable_text_demo.html +442 -0
package/src/components/demos/action/9_link_demo.html +172 -0
package/src/components/demos/demo.md +0 -0
package/src/components/demos/route/basic/basic.html +14 -0
package/src/components/demos/route/basic/basic_route_demo.jsx +224 -0
package/src/components/demos/route/multi/multi.html +14 -0
package/src/components/demos/route/multi/multi_route_demo.jsx +277 -0
package/src/components/details/details.jsx +248 -0
package/src/components/details/summary_marker.jsx +141 -0
package/src/components/editable_text/editable_text.jsx +96 -0
package/src/components/error_boundary_context.js +9 -0
package/src/components/form.jsx +144 -0
package/src/components/input/button.jsx +333 -0
package/src/components/input/checkbox_list.jsx +294 -0
package/src/components/input/field.jsx +61 -0
package/src/components/input/field_css.js +118 -0
package/src/components/input/input.jsx +15 -0
package/src/components/input/input_checkbox.jsx +370 -0
package/src/components/input/input_radio.jsx +299 -0
package/src/components/input/input_textual.jsx +338 -0
package/src/components/input/radio_list.jsx +283 -0
package/src/components/input/select.jsx +273 -0
package/src/components/input/use_form_event.js +20 -0
package/src/components/input/use_on_change.js +12 -0
package/src/components/link/link.jsx +291 -0
package/src/components/loader/loader_background.jsx +324 -0
package/src/components/loader/loading_spinner.jsx +68 -0
package/src/components/loader/network_speed.js +83 -0
package/src/components/loader/rectangle_loading.jsx +225 -0
package/src/components/route.jsx +15 -0
package/src/components/selection/selection.js +5 -0
package/src/components/selection/selection_context.jsx +262 -0
package/src/components/shortcut/os.js +9 -0
package/src/components/shortcut/shortcut_context.jsx +390 -0
package/src/components/use_action_events.js +37 -0
package/src/components/use_auto_focus.js +43 -0
package/src/components/use_debounce_true.js +31 -0
package/src/components/use_focus_group.js +19 -0
package/src/components/use_initial_value.js +104 -0
package/src/components/use_is_visited.js +19 -0
package/src/components/use_ref_array.js +38 -0
package/src/components/use_signal_sync.js +50 -0
package/src/components/use_state_array.js +40 -0
package/src/docs/actions.md +228 -0
package/src/docs/demos/resource/action_status.jsx +42 -0
package/src/docs/demos/resource/demo.md +1 -0
package/src/docs/demos/resource/resource_demo_0.html +84 -0
package/src/docs/demos/resource/resource_demo_10_post_gc.html +364 -0
package/src/docs/demos/resource/resource_demo_11_describe_many.html +362 -0
package/src/docs/demos/resource/resource_demo_2.html +173 -0
package/src/docs/demos/resource/resource_demo_3_filtered_users.html +415 -0
package/src/docs/demos/resource/resource_demo_4_details.html +284 -0
package/src/docs/demos/resource/resource_demo_5_renderer_lazy.html +115 -0
package/src/docs/demos/resource/resource_demo_6_gc.html +217 -0
package/src/docs/demos/resource/resource_demo_7_child_gc.html +240 -0
package/src/docs/demos/resource/resource_demo_8_proxy_gc.html +319 -0
package/src/docs/demos/resource/resource_demo_9_describe_one.html +472 -0
package/src/docs/demos/resource/tata.jsx +3 -0
package/src/docs/demos/resource/toto.jsx +3 -0
package/src/docs/demos/user_nav/user_nav.html +12 -0
package/src/docs/demos/user_nav/user_nav.jsx +330 -0
package/src/docs/resource_dependencies.md +103 -0
package/src/docs/resource_with_params.md +80 -0
package/src/notes.md +13 -0
package/src/route/route.js +518 -0
package/src/route/route.test.html +228 -0
package/src/store/array_signal_store.js +537 -0
package/src/store/local_storage_signal.js +17 -0
package/src/store/resource_graph.js +1303 -0
package/src/store/tests/resource_graph_autoreload_demo.html +12 -0
package/src/store/tests/resource_graph_autoreload_demo.jsx +964 -0
package/src/store/tests/resource_graph_dependencies.test.js +95 -0
package/src/store/value_in_local_storage.js +187 -0
package/src/symbol_object_signal.js +1 -0
package/src/use_action_data.js +10 -0
package/src/use_action_status.js +47 -0
package/src/utils/add_many_event_listeners.js +15 -0
package/src/utils/array_add_remove.js +61 -0
package/src/utils/array_signal.js +15 -0
package/src/utils/compare_two_js_values.js +172 -0
package/src/utils/execute_with_cleanup.js +21 -0
package/src/utils/get_caller_info.js +85 -0
package/src/utils/iterable_weak_set.js +62 -0
package/src/utils/js_value_weak_map.js +162 -0
package/src/utils/js_value_weak_map_demo.html +690 -0
package/src/utils/merge_two_js_values.js +53 -0
package/src/utils/stringify_for_display.js +150 -0
package/src/utils/weak_effect.js +48 -0

package/src/components/demos/action/11_nested_shortcuts_demo.html ADDED Viewed

@@ -0,0 +1,401 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" href="data:," />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Nested Keyboard Shortcuts Demo</title>
+    <style>
+      body {
+        font-family:
+          -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+        max-width: 900px;
+        margin: 0 auto;
+        padding: 40px 20px;
+        line-height: 1.6;
+        background: linear-gradient(135deg, #4facfe 0%, #00f2fe 100%);
+        min-height: 100vh;
+        color: #333;
+      }
+      .demo-container {
+        background: white;
+        border-radius: 12px;
+        padding: 40px;
+        box-shadow: 0 10px 30px rgba(0, 0, 0, 0.2);
+      }
+      .demo-title {
+        font-size: 2rem;
+        font-weight: 700;
+        margin: 0 0 30px 0;
+        color: #2d3748;
+        text-align: center;
+      }
+      .demo-description {
+        background: #e6fffa;
+        border-left: 4px solid #38b2ac;
+        padding: 20px;
+        margin: 0 0 30px 0;
+        border-radius: 0 8px 8px 0;
+      }
+      .demo-description h3 {
+        margin: 0 0 15px 0;
+        color: #2d3748;
+        font-size: 1.2rem;
+      }
+      .shortcut-section {
+        margin: 20px 0;
+      }
+      .shortcut-section h4 {
+        margin: 0 0 10px 0;
+        color: #2c7a7b;
+        font-size: 1rem;
+      }
+      .shortcut-list {
+        list-style: none;
+        padding: 0;
+        margin: 0;
+      }
+      .shortcut-item {
+        display: flex;
+        align-items: center;
+        margin: 8px 0;
+        padding: 6px 0;
+      }
+      .shortcut-key {
+        background: #2d3748;
+        color: white;
+        padding: 3px 10px;
+        border-radius: 5px;
+        font-family: "Monaco", "Menlo", monospace;
+        font-size: 0.8rem;
+        font-weight: 600;
+        margin-right: 12px;
+        min-width: 50px;
+        text-align: center;
+        box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+      }
+      .shortcut-description {
+        color: #4a5568;
+        flex: 1;
+        font-size: 0.9rem;
+      }
+      .file-explorer {
+        background: #f8f9fa;
+        border: 2px solid #e9ecef;
+        border-radius: 12px;
+        padding: 20px;
+        margin: 30px 0;
+      }
+      .explorer-title {
+        margin: 0 0 20px 0;
+        color: #2d3748;
+        font-size: 1.3rem;
+        text-align: center;
+      }
+      .file-list {
+        list-style: none;
+        padding: 0;
+        margin: 0;
+        border: 1px solid #d1d5db;
+        border-radius: 6px;
+        background: white;
+      }
+      .file-item {
+        border-bottom: 1px solid #e5e7eb;
+        padding: 0;
+      }
+      .file-item:last-child {
+        border-bottom: none;
+      }
+      .file-link {
+        display: block;
+        padding: 12px 16px;
+        text-decoration: none;
+        color: #374151;
+        transition: background-color 0.2s ease;
+      }
+      .file-link:hover {
+        background-color: #f3f4f6;
+      }
+      .file-link:focus {
+        outline: 2px solid #3b82f6;
+        outline-offset: -2px;
+        background-color: #dbeafe;
+      }
+      .file-icon {
+        margin-right: 10px;
+        font-size: 1.1rem;
+      }
+      .instructions {
+        background: #fef7ff;
+        border: 1px solid #e879f9;
+        border-radius: 8px;
+        padding: 20px;
+        margin-top: 30px;
+      }
+      .instructions h4 {
+        color: #a21caf;
+        margin: 0 0 10px 0;
+        font-size: 1rem;
+      }
+      .instructions p {
+        margin: 5px 0;
+        color: #744210;
+        font-size: 0.9rem;
+      }
+      .status-display {
+        background: #1f2937;
+        color: #f9fafb;
+        padding: 15px;
+        border-radius: 8px;
+        margin: 20px 0;
+        font-family: "Monaco", "Menlo", monospace;
+        font-size: 0.9rem;
+        min-height: 60px;
+      }
+      .status-title {
+        color: #9ca3af;
+        margin-bottom: 8px;
+        font-size: 0.8rem;
+        text-transform: uppercase;
+        letter-spacing: 0.5px;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" jsenv-type="module/jsx">
+      import { render } from "preact";
+      import { useState, useRef } from "preact/hooks";
+      import {
+        // eslint-disable-next-line no-unused-vars
+        Link,
+        // eslint-disable-next-line no-unused-vars
+        ShortcutProvider,
+        // eslint-disable-next-line no-unused-vars
+        SelectionProvider,
+      } from "@jsenv/navi";
+      // eslint-disable-next-line no-unused-vars
+      const App = () => {
+        const [status, setStatus] = useState("Ready - Try the shortcuts!");
+        const [selection, setSelection] = useState([]);
+        const [deletedFiles, setDeletedFiles] = useState([]);
+        const containerShortcuts = [
+          {
+            key: "a",
+            description: "Select all files",
+            action: () => {
+              setStatus("📋 Selected all files (container shortcut)");
+            },
+          },
+          {
+            key: "delete",
+            description: "Delete selected files",
+            action: async () => {
+              setStatus("🗑️ Start deleting files (container shortcut)");
+              await new Promise((resolve) => setTimeout(resolve, 2_000));
+              setStatus(
+                "🗑️ Selected files deletion done! (container shortcut)",
+              );
+            },
+            confirmMessage: "Are you sure you want to delete selected files?",
+          },
+          {
+            key: "r",
+            description: "Refresh file list",
+            action: () => {
+              setStatus("🔄 Refreshed file list (container shortcut)");
+            },
+          },
+        ];
+        const files = [
+          { name: "document.pdf", icon: "📄", type: "PDF Document" },
+          { name: "image.jpg", icon: "🖼️", type: "JPEG Image" },
+          { name: "video.mp4", icon: "🎥", type: "MP4 Video" },
+          { name: "archive.zip", icon: "📦", type: "ZIP Archive" },
+        ];
+        const elementRef = useRef();
+        return (
+          <div className="demo-container">
+            <h1 className="demo-title">🔗 Nested Shortcuts Demo</h1>
+            <div className="demo-description">
+              <h3>Container vs Link Shortcuts:</h3>
+              <div className="shortcut-section">
+                <h4>
+                  📁 Container Shortcuts (work anywhere in file explorer):
+                </h4>
+                <ul className="shortcut-list">
+                  <li className="shortcut-item">
+                    <span className="shortcut-key">a</span>
+                    <span className="shortcut-description">
+                      Select all files
+                    </span>
+                  </li>
+                  <li className="shortcut-item">
+                    <span className="shortcut-key">Delete</span>
+                    <span className="shortcut-description">
+                      Delete selected files
+                    </span>
+                  </li>
+                  <li className="shortcut-item">
+                    <span className="shortcut-key">r</span>
+                    <span className="shortcut-description">
+                      Refresh file list
+                    </span>
+                  </li>
+                </ul>
+              </div>
+              <div className="shortcut-section">
+                <h4>🔗 Link Shortcuts (work only when link is focused):</h4>
+                <ul className="shortcut-list">
+                  <li className="shortcut-item">
+                    <span className="shortcut-key">Enter</span>
+                    <span className="shortcut-description">
+                      Open/download file
+                    </span>
+                  </li>
+                  <li className="shortcut-item">
+                    <span className="shortcut-key">Space</span>
+                    <span className="shortcut-description">Preview file</span>
+                  </li>
+                  <li className="shortcut-item">
+                    <span className="shortcut-key">i</span>
+                    <span className="shortcut-description">Show file info</span>
+                  </li>
+                </ul>
+              </div>
+            </div>
+            <div className="status-display">
+              <div className="status-title">Action Status:</div>
+              <div>{status}</div>
+            </div>
+            <div className="file-explorer">
+              <h2 className="explorer-title">📁 File Explorer</h2>
+              <SelectionProvider
+                value={selection}
+                onChange={(value) => {
+                  setSelection(value);
+                }}
+              >
+                <ShortcutProvider
+                  elementRef={elementRef}
+                  shortcuts={containerShortcuts}
+                  onActionStart={() => {
+                    setDeletedFiles(selection);
+                  }}
+                  onActionEnd={() => {
+                    setDeletedFiles([]);
+                  }}
+                >
+                  <ul className="file-list" ref={elementRef}>
+                    {files.map((file) => (
+                      <li key={file.name} className="file-item">
+                        <Link
+                          className="file-link"
+                          href="#"
+                          value={file.name}
+                          readOnly={deletedFiles.includes(file.name)}
+                          loading={deletedFiles.includes(file.name)}
+                          shortcuts={[
+                            {
+                              key: "enter",
+                              description: `Open ${file.name}`,
+                              action: () => {
+                                setStatus(
+                                  `📂 Opening ${file.name} (link shortcut)`,
+                                );
+                              },
+                            },
+                            {
+                              key: "space",
+                              description: `Preview ${file.name}`,
+                              action: () => {
+                                setStatus(
+                                  `👁️ Previewing ${file.name} (link shortcut)`,
+                                );
+                              },
+                            },
+                            {
+                              key: "i",
+                              description: `Info for ${file.name}`,
+                              action: () => {
+                                setStatus(
+                                  `ℹ️ Info: ${file.name} - ${file.type} (link shortcut)`,
+                                );
+                              },
+                            },
+                          ]}
+                        >
+                          <span className="file-icon">{file.icon}</span>
+                          {file.name}
+                        </Link>
+                      </li>
+                    ))}
+                  </ul>
+                </ShortcutProvider>
+              </SelectionProvider>
+            </div>
+            <div className="instructions">
+              <h4>🎯 How to Test:</h4>
+              <p>
+                <strong>Container shortcuts:</strong> Click anywhere in the file
+                explorer area, then press 'a', 'Delete', or 'r'
+              </p>
+              <p>
+                <strong>Link shortcuts:</strong> Tab to focus a specific file,
+                then press 'Enter', 'Space', or 'i'
+              </p>
+              <p>
+                <strong>Precedence:</strong> When a link is focused, link
+                shortcuts take priority over container shortcuts
+              </p>
+              <p>
+                <strong>Status display:</strong> Watch the black box above to
+                see which shortcuts are triggered
+              </p>
+            </div>
+          </div>
+        );
+      };
+      render(<App />, document.getElementById("root"));
+    </script>
+  </body>
+</html>