refactor JS API

[kfix]

Most of the API surface I want to use & support is now exposed, but its a bit clunky.

delegate:

• should take advantage of ES6 classes so that one can initialize an App object from a class constructor and return that. Then ESlint can check for oopsies and IDEs can do code completion.
  • delegate.{someNamedScriptMessageHandler} -> App().messageHandlers.{someName}(webview,...msg)
  • delegate.launchURL(str) -> App().selectors.launch(...arguments)
  • delegate.decideNavigationFoo(urlstr) -> App().webviewHooks.navigationFoo(webview, url)
  • ideally, one could attach hooks to specific web views from JS

$ is also vague and intones jQuery.

• export a MacPin singleton?
  • $.app -> MacPin.os, MacPin.process, MacPin.bundle
  • $.browser -> MacPin.window
  • $.browser.tabs -> MacPin.webviews

[kfix]

extend and JSExport NSURL()s as URL(), behaving roughly like the URL() in most browser DOMs. That would standardize all the delegate methods and launch()

JS polyfills:

• http://github.com/jsdom/whatwg-url
• http://github.com/Polymer/URL

[kfix]

this could be handy for aliasing some exported methods: https://gist.github.com/zeitiger/1387f7d996f64b493608

[kfix]

support fetch API instead of XMLHttpRequest??

[kfix]

Its possible to renamed exported vars/funcs with @objc(betterJSName:) and exclude overloads with @nonobjc https://developer.apple.com/library/prerelease/ios/documentation/Swift/Conceptual/BuildingCocoaApps/InteractingWithObjective-CAPIs.html#//apple_ref/doc/uid/TP40014216-CH4-ID55

[kfix]

another URI lib: https://github.com/medialize/URI.js Consider including SystemJS/jspm, and allowing module loads before MacPin API is extended in.

[kfix]

a good listing of available JS features: https://webkit.org/status/

[kfix]

Chrome's chrome.tabs API is not synchronous at all. Safari's is but doesn't support .push()ing a tab.

Both fire events for tab actions.

[kfix]

rather than app.js having to explicitly return an object that will become the jsdelegate, this should just be that object.

[kfix]

Firefox is going to support a majority of Chrome's API as 'chrome.'

https://github.com/mdn/webextensions-examples

[kfix]

expose NSUserDefaults to app.js as localStorage()

[kfix]

URL() is being added to WebCore (yay!) hopefully for Safari 10 macgap: https://github.com/MacGapProject/MacGap1/wiki/API-Reference

[kfix]

nodejs APIs can be shimmed in: https://github.com/nodekit-io/nodekit-darwin