bunmicro 0.8.2 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## [0.9.0] - 2026-06-03
+- Added more alt- key bindings
+- Alt-s for Selection mode
+- Alt-d for unindent/dedent/outdent
+- Updated help md documents
+- js/python builtin objects autocomplete
+- autocomplete includes language keywords
+- Fixed unicode/emoji for term and editor
+
+## [0.8.3] - 2026-06-02
+- Fixed Linux failed to parse php.yaml crashes the whole program
+- Fixed Linux espeak-ng args passing
+
 ## [0.8.2] - 2026-06-02
 - Fixed Windows TTS function
 - Added ttslang for Windows

package/README.md

@@ -21,6 +21,7 @@
 - Ctrl-E ttspitch 1.1
 ## Easy selection
 - Mouse click on line numbers to select a range of lines
+- Alt-s to enter selection mode
 - Useful without a mouse on Android
 - Also available: Ctrl-E act SelectRight
 ## js plugin
@@ -42,6 +43,13 @@
 - Press Tab and use arrow keys to select items
 ## action/js commands
 - A complete help is at the end
+## Portability
+- One codebase. One folder. 
+- Runs on Windows, Android, Linux
+- No per-platform builds
+- No native bindings
+- No recompilation
+- Just Copy folder -> Run with Bun
 ## Version shows backends
 - bunmicro --version shows http/clipboard/tts backends
 
@@ -120,8 +128,11 @@ bun x bunmicro
 - Common editor features such as undo/redo, line numbers, Unicode support, soft wrapping, etc
 
 # Useful key bindings:
+- For a detailed help:
+- Ctrl+E > help defaultkeys
 
 - `Ctrl-Q`: Close current tab/pane, quits if it is the last tab/pane; prompts if modified
+- `Alt-q`: Close current tab/pane, quits if it is the last tab/pane; prompts if modified
 - `Ctrl-S`: Save
 - `Ctrl-O`: Open
 - `Ctrl-G`: Toggle help pane
@@ -134,9 +145,13 @@ bun x bunmicro
 - `Ctrl-B`: Shell prompt
 - `Ctrl-D`: Duplicate Line/Selection
 - `Ctrl-T`: Open a new tab
-- `Alt-G`: Toggle nano-like key bindings menu 
+- `Alt-g`: Toggle nano-like key bindings menu 
+- `Alt-h`: replace [-l] `text1` `text2`
+- `Alt-c`: Toggle comment
+- `Alt-s`: Selection mode
 - `Alt-,` / `Alt-p`: Previous tab
 - `Alt-.` / `Alt-t`: Next tab
+- `Alt-k` / `Alt-j`: Move lines Up/Down
 - `Tab`: Triggers autocomplete
 - `Esc`: close command/shell prompt or terminal pane, rehighlight long lines
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bunmicro",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "description": "Bun JavaScript rewrite of the micro editor originally in Golang",
   "type": "module",
   "main": "./src/index.js",

package/runtime/help/defaultkeys.md

@@ -52,6 +52,8 @@ can change it!
 | Ctrl-n    | Find next instance of current search      |
 | Ctrl-p    | Find previous instance of current search  |
 
+| Alt-h     | Open command prompt to replace keywords   |
+
 Note: `Ctrl-n` and `Ctrl-p` should be used from the main buffer, not from inside
 the search prompt. After `Ctrl-f`, press enter to complete the search and then
 you can use `Ctrl-n` and `Ctrl-p` to cycle through matches.
@@ -87,7 +89,10 @@ you can use `Ctrl-n` and `Ctrl-p` to cycle through matches.
 | Alt-DownArrow Alt-j                 | Move current line or selected lines down  |
 | Alt-Backspace or Alt-Ctrl-h         | Delete word left                          |
 | Ctrl-a                              | Select all                                |
+| Alt-s                               | Enter Selection mode                      |
+| Alt-c                               | Toggle comment for lines                  |
 | Tab                                 | Indent selected text                      |
+| Alt-d                               | Dedent selected text                      |
 | Shift-Tab                           | Unindent selected text                    |
 
 ### Macros(not implemented yet)
@@ -119,6 +124,7 @@ you can use `Ctrl-n` and `Ctrl-p` to cycle through matches.
 | Ctrl-r    | Toggle the line number ruler                                                          |
 
 ### Emacs style actions
+- not implemented yet
 
 | Key       | Description of function   |
 |---------- |-------------------------- |
@@ -128,6 +134,7 @@ you can use `Ctrl-n` and `Ctrl-p` to cycle through matches.
 | Alt-e     | Move to end of line       |
 
 ### Function keys.
+- not implemented yet
 
 Warning! The function keys may not work in all terminals!
 

package/runtime/help/help.md

@@ -18,13 +18,16 @@ To quit, press `Ctrl-q`. Save by pressing `Ctrl-s`. Press `Ctrl-e`, as previousl
 mentioned, to start typing commands. To see which commands are available, at the
 prompt, press tab, or view the help topic with `> help commands`.
 
-Move the cursor around with the mouse or with the arrow keys. Enter text simply
-by pressing character keys.
+- Move the cursor around with the mouse or with the arrow keys.
+- Enter text simply by pressing character keys.
+
+- If the colorscheme doesn't look good, change it with either of the below:
+`> set colorscheme ...`
+`> theme ...` (bunmicro only)
+- You can press tab to see the available colorschemes, and preview with arrow keys
+- see more information about colorschemes and syntax highlighting with
+- `> help colors`
 
-If the colorscheme doesn't look good, you can change it with
-`> set colorscheme ...`. You can press tab to see the available colorschemes,
-or see more information about colorschemes and syntax highlighting with `> help
-colors`.
 
 Press `Ctrl-w` to move between splits, and type `> vsplit filename` or
 `> hsplit filename` to open a new split.
@@ -33,9 +36,11 @@ Press `Ctrl-w` to move between splits, and type `> vsplit filename` or
 
 Micro has a built-in help system which can be accessed with the `> help` command.
 
-To view help for the various available topics, press `Ctrl-e` to access command
-mode and type in `> help` followed by a topic. Typing just `> help` will open
-this page.
+- To view help for a specific topic, 
+- press `Ctrl-e` to access command mode and type in `> help` followed by a topic.
+- Use Tab to see available topics
+- Typing just `> help` will open this page.
+
 
 Here are the available help topics:
 

package/runtime/help/keybindings.md

@@ -1,18 +1,22 @@
 # Keybindings
 
-Micro has a plethora of hotkeys that make it easy and powerful to use and all
-hotkeys are fully customizable to your liking.
+- bunmicro has a plethora of hotkeys that make it easy and powerful to use.
 
-Custom keybindings are stored internally in micro if changed with the `> bind`
-command or can also be added in the file `~/.config/micro/bindings.json` as
-discussed below. For a list of the default keybindings in the json format used
-by micro, please see the end of this file. For a more user-friendly list with
-explanations of what the default hotkeys are and what they do, please see
-`> help defaultkeys` (a json formatted list of default keys is included
-at the end of this document).
+- Custom keybindings are not implemented in bunmicro for now
+- For a list of actions like CursorUp
+- Press Ctrl+E to show command prompt
+- `> help actions` 
+- It is recommended to use jsplugins to register a command for such purposes
+- Examples under runtime/jsplugins
+- If you really wish to rebind keys, edit src/index.js and look for things like alt-d
+
+
+- For a more user-friendly list with
+explanations of what the default hotkeys are and what they do
+- Press Ctrl+E to show command prompt
+- `> help defaultkeys` 
+- a json formatted list of default keys is included at the end of this document
 
-If `~/.config/micro/bindings.json` does not exist, you can simply create it.
-Micro will know what to do with it.
 
 You can use Ctrl + arrows to move word by word (Alt + arrows for Mac). Alt + left and right
 move the cursor to the start and end of the line (Ctrl + left/right for Mac), and Ctrl + up and down move the
@@ -20,171 +24,14 @@ cursor to the start and end of the buffer.
 
 You can hold shift with all of these movement actions to select while moving.
 
-## Rebinding keys
-
-The bindings may be rebound using the `~/.config/micro/bindings.json` file.
-Each key is bound to an action.
-
-For example, to bind `Ctrl-y` to undo and `Ctrl-z` to redo, you could put the
-following in the `bindings.json` file.
-
-```json
-{
-    "Ctrl-y": "Undo",
-    "Ctrl-z": "Redo"
-}
-```
-
-**Note:** The syntax `<Modifier><key>` is equivalent to `<Modifier>-<key>`. In
-addition, `Ctrl-Shift` bindings are not supported by terminals, and are the same
-as simply `Ctrl` bindings. This means that `CtrlG`, `Ctrl-G`, and `Ctrl-g` all
-mean the same thing. However, for `Alt` this is not the case: `AltG` and `Alt-G`
-mean `Alt-Shift-g`, while `Alt-g` does not require the Shift modifier.
-
-In addition to editing your `~/.config/micro/bindings.json`, you can run
-`>bind <keycombo> <action>` For a list of bindable actions, see below.
-
-You can also chain commands when rebinding. For example, if you want `Alt-s` to
-save and quit you can bind it like so:
-
-```json
-{
-    "Alt-s": "Save,Quit"
-}
-```
-
-Each action will return a success flag. Actions can be chained such that
-the chain only continues when there are successes, or failures, or either.
-The `,` separator will always chain to the next action. The `|` separator
-will abort the chain if the action preceding it succeeds, and the `&` will
-abort the chain if the action preceding it fails. For example, in the default
-bindings, tab is bound as
-
-```
-"Tab": "Autocomplete|IndentSelection|InsertTab"
-```
-
-This means that if the `Autocomplete` action is successful, the chain will
-abort. Otherwise, it will try `IndentSelection`, and if that fails too, it
-will execute `InsertTab`. To use `,`, `|` or `&` in an action (as an argument
-to a command, for example), escape it with `\` or wrap it in single or double
-quotes.
-
-If the action has an `onAction` lua callback, for example `onAutocomplete` (see
-`> help plugins`), then the action is only considered successful if the action
-itself succeeded *and* the callback returned true. If there are multiple
-`onAction` callbacks for this action, registered by multiple plugins, then the
-action is only considered successful if the action itself succeeded and all the
-callbacks returned true.
-
-## Binding commands
-
-You can also bind a key to execute a command in command mode (see
-`help commands`). Simply prepend the binding with `command:`. For example:
 
-```json
-{
-    "Alt-p": "command:pwd"
-}
-```
-
-**Note for macOS**: By default, macOS terminals do not forward alt events and
+## Note for macOS
+- By default, macOS terminals do not forward alt events and
 instead insert unicode characters. To fix this, do the following:
 
 * iTerm2: select `Esc+` for `Left Option Key` in `Preferences->Profiles->Keys`.
 * Terminal.app: Enable `Use Option key as Meta key` in `Preferences->Profiles->Keyboard`.
 
-Now when you press `Alt-p` the `pwd` command will be executed which will show
-your working directory in the infobar.
-
-You can also bind an "editable" command with `command-edit:`. This means that
-micro won't immediately execute the command when you press the binding, but
-instead just place the string in the infobar in command mode. For example,
-you could rebind `Ctrl-g` to `> help`:
-
-```json
-{
-    "Ctrl-g": "command-edit:help "
-}
-```
-
-Now when you press `Ctrl-g`, `help` will appear in the command bar and your
-cursor will be placed after it (note the space in the json that controls the
-cursor placement).
-
-## Binding Lua functions
-
-You can also bind a key to a Lua function provided by a plugin, or by your own
-`~/.config/micro/init.lua`. For example:
-
-```json
-{
-    "Alt-q": "lua:foo.bar"
-}
-```
-
-where `foo` is the name of the plugin and `bar` is the name of the lua function
-in it, e.g.:
-
-```lua
-local micro = import("micro")
-
-function bar(bp)
-    micro.InfoBar():Message("Bar action triggered")
-    return true
-end
-```
-
-See `> help plugins` for more informations on how to write lua functions.
-
-For `~/.config/micro/init.lua` the plugin name is `initlua` (so the keybinding
-in this example would be `"Alt-q": "lua:initlua.bar"`).
-
-The currently active bufpane is passed to the lua function as the argument. If
-the key is a mouse button, e.g. `MouseLeft` or `MouseWheelUp`, the mouse event
-info is passed to the lua function as the second argument, of type
-`*tcell.EventMouse`. See https://pkg.go.dev/github.com/micro-editor/tcell/v2#EventMouse
-for the description of this type and its methods.
-
-The return value of the lua function defines whether the action has succeeded.
-This is used when chaining lua functions with other actions. They can be chained
-the same way as regular actions as described above, for example:
-
-```
-"Alt-q": "lua:initlua.bar|Quit"
-```
-
-## Binding raw escape sequences
-
-Only read this section if you are interested in binding keys that aren't on the
-list of supported keys for binding.
-
-One of the drawbacks of using a terminal-based editor is that the editor must
-get all of its information about key events through the terminal. The terminal
-sends these events in the form of escape sequences often (but not always)
-starting with `0x1b`.
-
-For example, if micro reads `\x1b[1;5D`, on most terminals this will mean the
-user pressed CtrlLeft.
-
-For many key chords though, the terminal won't send any escape code or will
-send an escape code already in use. For example for `CtrlBackspace`, my
-terminal sends `\u007f` (note this doesn't start with `0x1b`), which it also
-sends for `Backspace` meaning micro can't bind `CtrlBackspace`.
-
-However, some terminals do allow you to bind keys to send specific escape
-sequences you define. Then from micro you can directly bind those escape
-sequences to actions. For example, to bind `CtrlBackspace` you can instruct
-your terminal to send `\x1bctrlback` and then bind it in `bindings.json`:
-
-```json
-{
-    "\u001bctrlback": "DeleteWordLeft"
-}
-```
-
-Here are some instructions for sending raw escapes in different terminals
-
 ### iTerm2
 
 In iTerm2, you can do this in  `Preferences->Profiles->Keys` then click the
@@ -192,156 +39,8 @@ In iTerm2, you can do this in  `Preferences->Profiles->Keys` then click the
 For the above example your would type `ctrlback` into the box (the `\x1b`) is
 automatically sent by iTerm2.
 
-### Linux using loadkeys
-
-You can do this in linux using the loadkeys program.
-
-Coming soon!
-
-## Unbinding keys
-
-It is also possible to disable any of the default key bindings by use of the
-`None` action in the user's `bindings.json` file.
-
-## Bindable actions and bindable keys
 
-The list of default keybindings contains most of the possible actions and keys
-which you can use, but not all of them. Here is a full list of both.
-
-Full list of possible actions:
-
-```
-CursorUp
-CursorDown
-CursorPageUp
-CursorPageDown
-CursorLeft
-CursorRight
-CursorStart
-CursorEnd
-CursorToViewTop
-CursorToViewCenter
-CursorToViewBottom
-SelectToStart
-SelectToEnd
-SelectUp
-SelectDown
-SelectLeft
-SelectRight
-WordRight
-WordLeft
-SubWordRight
-SubWordLeft
-SelectWordRight
-SelectWordLeft
-SelectSubWordRight
-SelectSubWordLeft
-DeleteWordRight
-DeleteWordLeft
-DeleteSubWordRight
-DeleteSubWordLeft
-SelectLine
-SelectToStartOfLine
-SelectToStartOfText
-SelectToStartOfTextToggle
-SelectToEndOfLine
-ParagraphPrevious
-ParagraphNext
-SelectToParagraphPrevious
-SelectToParagraphNext
-InsertNewline
-Backspace
-Delete
-InsertTab
-Save
-SaveAll
-SaveAs
-Find
-FindLiteral
-FindNext
-FindPrevious
-DiffNext
-DiffPrevious
-Center
-Undo
-Redo
-Copy
-CopyLine
-Cut
-CutLine
-Duplicate
-DuplicateLine
-DeleteLine
-MoveLinesUp
-MoveLinesDown
-IndentSelection
-OutdentSelection
-Autocomplete
-CycleAutocompleteBack
-OutdentLine
-IndentLine
-Paste
-PastePrimary
-SelectAll
-OpenFile
-Start
-End
-PageUp
-PageDown
-SelectPageUp
-SelectPageDown
-HalfPageUp
-HalfPageDown
-StartOfText
-StartOfTextToggle
-StartOfLine
-EndOfLine
-ToggleHelp
-ToggleKeyMenu
-ToggleDiffGutter
-ToggleRuler
-ToggleHighlightSearch
-UnhighlightSearch
-ResetSearch
-ClearStatus
-ShellMode
-CommandMode
-ToggleOverwriteMode
-Escape
-Quit
-QuitAll
-ForceQuit
-AddTab
-PreviousTab
-NextTab
-FirstTab
-LastTab
-NextSplit
-PreviousSplit
-FirstSplit
-LastSplit
-Unsplit
-VSplit
-HSplit
-ToggleMacro
-PlayMacro
-Suspend (Unix only)
-ScrollUp
-ScrollDown
-SpawnMultiCursor
-SpawnMultiCursorUp
-SpawnMultiCursorDown
-SpawnMultiCursorSelect
-RemoveMultiCursor
-RemoveAllMultiCursors
-SkipMultiCursor
-SkipMultiCursorBack
-JumpToMatchingBrace
-JumpLine
-Deselect
-ClearInfo
-None
-```
+## Actions binding (not implemented)
 
 The `StartOfTextToggle` and `SelectToStartOfTextToggle` actions toggle between
 jumping to the start of the text (first) and start of the line.
@@ -511,10 +210,7 @@ MouseWheelLeft
 MouseWheelRight
 ```
 
-## Key sequences
 
-Key sequences can be bound by specifying valid keys one after another in brackets, such
-as `<Ctrl-x><Ctrl-c>`.
 
 # Default keybinding configuration.
 
@@ -601,17 +297,24 @@ conventions for text editing defaults.
     "Ctrl-q":         "Quit",
     "Ctrl-e":         "CommandMode",
     "Ctrl-w":         "NextSplit|FirstSplit",
+    
+    
+    // macro insert
+    // not implemented yet
     "Ctrl-u":         "ToggleMacro",
     "Ctrl-j":         "PlayMacro",
     "Insert":         "ToggleOverwriteMode",
+    
 
     // Emacs-style keybindings
+    // not implemented yet
     "Alt-f": "WordRight",
     "Alt-b": "WordLeft",
     "Alt-a": "StartOfLine",
     "Alt-e": "EndOfLine",
 
     // Integration with file managers
+    // not implemented yet
     "F2":  "Save",
     "F3":  "Find",
     "F4":  "Quit",
@@ -629,6 +332,7 @@ conventions for text editing defaults.
     "Ctrl-MouseLeft":   "MouseMultiCursor",
 
     // Multi-cursor bindings
+    // not implemented yet
     "Alt-n":        "SpawnMultiCursor",
     "AltShiftUp":   "SpawnMultiCursorUp",
     "AltShiftDown": "SpawnMultiCursorDown",
@@ -639,122 +343,13 @@ conventions for text editing defaults.
 }
 ```
 
-## Pane type bindings
-
-Keybindings can be specified for different pane types as well. For example, to
-make a binding that only affects the command bar, use the `command` subgroup:
-
-```
-{
-    "command": {
-        "Ctrl-w": "WordLeft"
-    }
-}
-```
-
-The possible pane types are `buffer` (normal buffer), `command` (command bar),
-and `terminal` (terminal pane). The defaults for the command and terminal panes
-are given below:
-
-```
-{
-    "terminal": {
-        "<Ctrl-q><Ctrl-q>": "Exit",
-        "<Ctrl-e><Ctrl-e>": "CommandMode",
-        "<Ctrl-w><Ctrl-w>": "NextSplit"
-    },
-
-    "command": {
-        "Up":             "HistoryUp",
-        "Down":           "HistoryDown",
-        "Right":          "CursorRight",
-        "Left":           "CursorLeft",
-        "ShiftUp":        "SelectUp",
-        "ShiftDown":      "SelectDown",
-        "ShiftLeft":      "SelectLeft",
-        "ShiftRight":     "SelectRight",
-        "AltLeft":        "StartOfTextToggle",
-        "AltRight":       "EndOfLine",
-        "AltUp":          "CursorStart",
-        "AltDown":        "CursorEnd",
-        "AltShiftRight":  "SelectWordRight",
-        "AltShiftLeft":   "SelectWordLeft",
-        "CtrlLeft":       "WordLeft",
-        "CtrlRight":      "WordRight",
-        "CtrlShiftLeft":  "SelectToStartOfTextToggle",
-        "ShiftHome":      "SelectToStartOfTextToggle",
-        "CtrlShiftRight": "SelectToEndOfLine",
-        "ShiftEnd":       "SelectToEndOfLine",
-        "CtrlUp":         "CursorStart",
-        "CtrlDown":       "CursorEnd",
-        "CtrlShiftUp":    "SelectToStart",
-        "CtrlShiftDown":  "SelectToEnd",
-        "Enter":          "ExecuteCommand",
-        "CtrlH":          "Backspace",
-        "Backspace":      "Backspace",
-        "OldBackspace":   "Backspace",
-        "Alt-CtrlH":      "DeleteWordLeft",
-        "Alt-Backspace":  "DeleteWordLeft",
-        "Tab":            "CommandComplete",
-        "Backtab":        "CycleAutocompleteBack",
-        "Ctrl-z":         "Undo",
-        "Ctrl-y":         "Redo",
-        "Ctrl-c":         "Copy",
-        "Ctrl-x":         "Cut",
-        "Ctrl-k":         "CutLine",
-        "Ctrl-v":         "Paste",
-        "Home":           "StartOfTextToggle",
-        "End":            "EndOfLine",
-        "CtrlHome":       "CursorStart",
-        "CtrlEnd":        "CursorEnd",
-        "Delete":         "Delete",
-        "Ctrl-q":         "AbortCommand",
-        "Ctrl-e":         "EndOfLine",
-        "Ctrl-a":         "StartOfLine",
-        "Ctrl-w":         "DeleteWordLeft",
-        "Insert":         "ToggleOverwriteMode",
-        "Ctrl-b":         "WordLeft",
-        "Ctrl-f":         "WordRight",
-        "Ctrl-d":         "DeleteWordLeft",
-        "Ctrl-m":         "ExecuteCommand",
-        "Ctrl-n":         "HistoryDown",
-        "Ctrl-p":         "HistoryUp",
-        "Ctrl-u":         "SelectToStart",
-
-        // Emacs-style keybindings
-        "Alt-f": "WordRight",
-        "Alt-b": "WordLeft",
-        "Alt-a": "StartOfText",
-        "Alt-e": "EndOfLine",
-
-        // Integration with file managers
-        "F10": "AbortCommand",
-        "Esc": "AbortCommand",
-
-        // Mouse bindings
-        "MouseWheelUp":     "HistoryUp",
-        "MouseWheelDown":   "HistoryDown",
-        "MouseLeft":        "MousePress",
-        "MouseLeftDrag":    "MouseDrag",
-        "MouseLeftRelease": "MouseRelease",
-        "MouseMiddle":      "PastePrimary"
-    }
-}
-```
 
 ## Final notes
 
-Note: On some old terminal emulators and on Windows machines, `Ctrl-h` should be
-used for backspace.
-
-Additionally, alt keys can be bound by using `Alt-key`. For example `Alt-a` or
-`Alt-Up`. Micro supports an optional `-` between modifiers like `Alt` and
-`Ctrl` so `Alt-a` could be rewritten as `Alta` (case matters for alt bindings).
-This is why in the default keybindings you can see `AltShiftLeft` instead of
-`Alt-ShiftLeft` (they are equivalent).
+- Note: On some old terminal emulators and on Windows machines, `Ctrl-h` should be used for backspace.
 
-Please note that terminal emulators are strange applications and micro only
-receives key events that the terminal decides to send. Some terminal emulators
-may not send certain events even if this document says micro can receive the
-event. To see exactly what micro receives from the terminal when you press a
-key, run the `> raw` command.
+- Please note that terminal emulators are strange applications and micro only receives key events that the terminal decides to send. 
+- Some terminal emulators may not send certain events even if this document says micro can receive the event. 
+- To see exactly what micro receives from the terminal when you press a key,
+- Press Ctrl+E to show command prompt
+- then run the `> raw` command.