Roc Plugin

This plugin Rocks! Hue, hue, hue!
No, but seriously, it does!

Installation

Install as you would any JetBrains-plugin.

Supported products

IntelliJ IDEA, PhpStorm, WebStorm, PyCharm, RubyMine, AppCode, CLion, Gogland and Rider.

Config-completions

1. Open roc.config.js.
2. Don't bother creating a newline, empty space or anything of the sort.
3. Move cursor to applicable node, or not. Cursor-position will filter available completions.
4. The cursor must however be somewhere within the settings-property.
5. Initiate completions (usually <ctrl-space>) or just start typing.
6. Search completions by typing relevant letters.
7. Press <enter> when ready.
8. Be amazed of how great this experience was.
9. Profit!

Config-sub-completions

1. Did you perhaps select an enumeration?
2. Expecto enumeration-completions!
2. You can also request autocomplete manually (<ctrl-space>).
3. Don't worry if the list seems a bit short. Default-values has been removed.

Documentation

1. Request quick-documentation (usually <ctrl-j>)
2. Know what the setting does.
3. Live a year longer as a result of lowered stress-levels.

Toolbar - Start Roc

1. The toolbar now has a cute little Roc-icon.
2. Click it to start dev-mode.
3. Think to yourself: "meh...".
4. Submit your much better idea to me.

Toolbar - Refresh completions

1. Despair when adding a new fancy plugin.
2. Despair if roc.config.js had syntax-errors on project-load.
3. Click the "refresh completions" icon.
4. Despair no more.

Gotchas

If you for some reason miss your regular completions, feel free to initiate completions a second time
while the dialogue is still visible.

If you attempt to start Roc via the toolbar and the terminal-tab just flickers, doublecheck that you actually
have Roc installed globally. Dumbass!

How did I know that? Uh... nevermind that...

Troubleshooting

Try running the command: "node .idea/getSettings.js roc-config" from your project root-directory.
Output should be valid json.

Known issues

Did autocomplete mess up your config? Make sure there is no syntax-errors before you attempt autocomplete. If there are, the completion will hit all the branches of your ugly config-tree, and come out wrong.

Current

Debugging: automatically add debugging for all environments.
- This should replace the run button.

Next version

Add tests!
Fix "missing dependency" inspection.
html.head.htmlAttributes refuses to be formatted properly.
- Bring in the Nashorn.
- Testing of default-value seems pretty broken too.
  - Should I perhaps make use of parallel-processing to prepare a formatted-version of the default-value?
  - Maybe Nashorn can help here?
Generate searchable documentation and show to the user.
- for "roc docs"
- and for available settings.
Inspections
- Registered dependency already exported by Roc.
- Wrong type for setting.
Add babel (object) and webpack (function or object) completions.
- Json-schemas as are available as part of the JavaScriptLanguage.jar
Notifications about new roc-versions with changelog.
Toggle auto-refresh of browser-tab after dev-build.
- Should be doable.
- Is there a Chrome-cli utility available in Java?
- How do I make a checkbox within the toolbar?
  - Just make an action and toggle the icon.
- Persist between restarts?
  - Maybe add as a setting?
Gather Roc-statistics. (config-settings, commands etc...)
- Should be optional.
Expose actions/hooks in a good way.

Future versions

Add auto-completion for available babel/webpack settings.
- Standalone plugin?
- Take a look at the internal-configuration validation present in WebPack.
completions and goto for:
- getSettings()
- Routes defined in configured middleware?
- Redux-state/props/actions.
  - Is it even possible to resolve composite redux-state?
- Yup... WebPack is on it's own node...
  - So... Where's that parsable documentation?

annitya/roc-completion