narrow

narrow something.
similar to unite.vim, emacs-helm

Development status

alpha

Features

• autoPreview items under cursor.
• Auto sync narrow-bounded-editor's cursor position to selected intem on narrow UI.
• vim-mode-plus integration.

Architecture(not settled yet)

• narrow:ui: handles user input and update view.
• narrow-provider: Provide items to narrow and action to jump to item selected.

Bundled providers

• search: provide matched text as items via ag search.
• lines: narrow current editors lines
• fold: provide fold-starting rows as item.
• git-diff: for core git-diff package
• bookmarks: for core bookmarks package
• symbols: provide symbols as item, equivalent to core symbols-views package's toggle-file-symbols command.

Gifs

narrow:lines

narrow:fold

narrow:search (require ag)

Commands

global Commands

• narrow:lines
• narrow:lines-by-current-word
• narrow:fold
• narrow:fold-by-current-word
• narrow:search: ag search. need install by your self.
• narrow:search-by-current-word
• narrow:search-current-project
• narrow:search-current-project-by-current-word
• narrow:focus
• narrow:symbols
• narrow:bookmarks
• narrow:git-diff

narrow-ui

• core:confirm
• narrow-ui:preview-item
• narrow-ui:toggle-auto-preview

Keymaps

No keyamp to invoke global command(e.g narrow:lines).
narrow-ui have limited default keymap, see default keymap.

• Mine(vim-mode-plus user) for global command.

'atom-text-editor.vim-mode-plus.normal-mode':
  'space o': 'narrow:fold'
  'space O': 'narrow:symbols'
  'space l': 'narrow:lines'
  'space L': 'narrow:lines-by-current-word'
  'space s': 'narrow:search-current-project'
  'space S': 'narrow:search-by-current-word'
  # 'space S': 'narrow:symbols'
  'space G': 'narrow:git-diff'
  'space B': 'narrow:bookmarks'

# available only when some narrow was opened.
'atom-workspace.has-narrow atom-text-editor.vim-mode-plus:not(.narrow)':
  'ctrl-cmd-f': 'narrow:focus'
  'ctrl-cmd-p': 'narrow:previous-item'
  'ctrl-cmd-n': 'narrow:next-item'
  'up': 'narrow:previous-item'
  'down': 'narrow:next-item'

vim-mode-plus integration.

If you are vim-mode-plus user, you can invoke lines, search directly from vim-mode-plus's search form.

Check keymap definition

vmpStartInInsertModeForUI settings.

default: true.

Other config

If you want to start insert-mode for narrow-ui, refer following configuration.

config.cson

"*":
  "autocomplete-plus":
    suppressActivationForEditorClasses: [
      # snip
      "narrow"
    ]
  "vim-mode-plus":
    highlightSearchExcludeScopes: [
      "narrow"
    ]