yourjs-box 1.5.0 → 1.6.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2023-present Christopher West
+Copyright (c) 2023-present Chris West
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -40,6 +40,7 @@ If the editor already has code in it you are asked before it is replaced.
 
 ### Toolbar
 
+- The **⋯** button opens a menu (see below).
 - **Clear** removes everything from the console.  Code can also call
   `console.clear()`.
 - The **layout** button switches between showing the editor beside or below
@@ -50,7 +51,15 @@ If the editor already has code in it you are asked before it is replaced.
 - **Run** runs the next block of code.
 - Clicking the **logo** opens the About window, which shows the version, this
   console's settings and keyboard shortcuts.
-- The **⋯** button opens a menu with:
+- **History** (or <kbd>Alt</kbd>/<kbd>&#8997;</kbd>+<kbd>H</kbd>) lists the code
+  that was run so it can be put back into the editor.  Like the browser's
+  console, pressing <kbd>&uarr;</kbd> when the cursor is at the very start of
+  the editor (with nothing selected) shows the previous code that was run and
+  <kbd>&darr;</kbd> at the very end goes forward again and eventually back to
+  the code that hasn't been run yet.  After running code from the history, the
+  code that hasn't been run yet comes back.  Hidden blocks aren't in the
+  history.
+- The **&#8943;** menu has:
   - **Text size**, which is remembered for every console on the same site.
   - **Open**, which loads a JavaScript file as the code that the console starts
     with (its hidden blocks are hidden and Reset goes back to it).
@@ -69,6 +78,22 @@ If the editor already has code in it you are asked before it is replaced.
     (eg. an infinite loop) by starting a new worker.
   - **About JS Box**
 
+### Right-Clicking Values
+
+Right-click any value in the output (including values inside of expanded
+objects and arrays) for a menu with:
+
+- **Copy as JSON** and **Save as JSON&hellip;**.  Maps and Sets become arrays
+  and BigInts become strings.  Circular references (an object inside of itself)
+  are left out and a message says how many were left out.
+- **Store as global variable**, which stores the actual value (not a copy) as
+  `temp1`, `temp2`, etc. so that later code can use it (in window mode it is
+  stored on the page's `window`).
+- **Copy property path** (for properties and array items), which copies the
+  path from the logged value like `people[0].name`.
+- **Refresh** (for objects, arrays, etc.), which shows the value as it is now
+  if the code has changed it.  Anything that was expanded stays expanded.
+
 ### Attributes
 
 | Attribute | Description |
@@ -234,8 +259,9 @@ between blocks.
 Install the development dependencies by running `npm install`.
 
 - `npm run dev` builds, rebuilds whenever one of the files in `src/` changes
-  and serves the examples at http://localhost:3000/examples/ with the browser
-  reloading automatically after each rebuild.
+  and serves the examples at http://localhost:3000/examples/ (opening them in
+  your default browser) with the browser reloading automatically after each
+  rebuild.  Use `BROWSER=none npm run dev` to keep it from opening a browser.
 - `npm run build` builds the files in `dist/` once.
 - `npm test` builds and then runs the browser tests in `test/run.js` using your
   installed copy of Google Chrome (set `CHROME_PATH` to use another Chromium
@@ -274,4 +300,4 @@ Released under the [MIT License](LICENSE).  You're free to use, modify and
 distribute it, including in commercial projects, as long as the copyright and
 license notice is kept.
 
-Copyright (c) 2023-present Christopher West
+Copyright (c) 2023-present Chris West