.gitignore

@@ -0,0 +1,21 @@
+node_modules
+npm-debug.log
+.DS_Store
+
+# Generated files
+
+ng-inspector.firefox/*.xpi
+ng-inspector.firefox/data/icons/
+ng-inspector.firefox/data/ng-inspector.js
+ng-inspector.firefox/data/stylesheet.css
+
+ng-inspector.safariextension/icons/
+ng-inspector.safariextension/ng-inspector.js
+ng-inspector.safariextension/stylesheet.css
+
+ng-inspector.chrome/icons/
+ng-inspector.chrome/ng-inspector.js
+ng-inspector.chrome/stylesheet.css
+
+test/e2e/lib/ng-inspector.js
+test/e2e/lib/stylesheet.css

.jshintrc

@@ -0,0 +1,7 @@
+{
+	"strict": false,
+	"expr": true,
+	"boss": true,
+	"shadow": true,
+	"predef": ["console"]
+}

.travis.yml

@@ -0,0 +1,12 @@
+language: node_js
+node_js:
+  - "0.12"
+sudo: false
+
+env:
+    global:
+      - SAUCE_USERNAME: rev087
+      - SAUCE_ACCESS_KEY: 8247a039-7c68-484e-ae27-a8f2ef94c47f
+
+addons:
+  sauce_connect: true

CONTRIBUTING.md

@@ -0,0 +1,76 @@
+# Contributing
+
+More tests are always welcome. Pull requests containing new features _must_ include tests for these features.
+
+## Installing development dependencies
+
+Run `npm install` (npm comes bundled with [node.js](http://nodejs.org)) to install all the development dependencies to build and test the project.
+
+## Building the extension
+
+JavaScript source is located at `/src`, and uses [gulp](http://gulpjs.com) to build for Chrome at `/ng-inspector.chrome`, Safari at `/ng-inspector.safariextension` and Firefox at `/ng-inspector.firefox`.
+
+### Gulp Tasks:
+
+- `default`: runs all the build tasks
+- `build:icons`: copies the icons over to each browser folders
+- `build:css`: compiles the less files over to each browser folders
+- `build:js`: concatenates the source JavaScript over to each browser folder
+- `bump:major`, `bump:minor`, `bump:patch`: bumps the version in the manifest files, stages the changes in git, commits with a "Prepare for vX.Y.Z" message and tag the commit with the version number. Manifest files updated:
+	- `package.json`
+	- `ng-inspector.safariextension/Info.plist` (Safari)
+	- `ng-inspector.chrome/manifest.json` (Chrome)
+	- `ng-inspector.firefox/package.json` (Firefox)
+
+## Packaging the extension
+
+Each of the supported browsers require a different packaging process. Begin by building the extension with the default `gulp` task, then follow the browser-specific instructions below.
+
+### Safari
+
+Make sure _Show Develop menu in menu bar_ is selected in _Preferences…_ > _Advanced_ tab. Navigate to _Develop_ > _Show Extension Builder_, click the `+` button and select the `ng-inspector.safariextension` directory to add the extension to Safari in development mode. Finally, click _Build Package…_.
+
+### Chrome
+
+Compress the `ng-inspector.chrome` directory in a _.zip_ file and upload to the _Chrome Web Store_.
+
+### Firefox
+
+For 30 <= Firefox < 38, use _CFX_:
+
+- Install addon-sdk 1.17 from https://ftp.mozilla.org/pub/mozilla.org/labs/jetpack/jetpack-sdk-latest.zip
+(Reference: https://developer.mozilla.org/en-US/Add-ons/SDK/Tutorials/Installation)
+- Activate cfx (e.g. source bin/activate)
+- In the terminal, navigate to the `ng-inspector.firefox` directory.
+	- To try the extension: `cfx run -b /path/to/firefox-30.0/firefox`
+	- To build the _xpi_: `cfx xpi`
+
+For Firefox >= 38, use _JPM_:
+
+- Make sure to have installed the npm dependencies via `npm install`
+- To try: `npm run run-xpi -- -b /path/to/firefox-38/firefox`
+- To build the _xpi_: `npm run build-xpi`
+
+## Testing
+
+### Prerequisites
+
+- JDK
+- Chrome & Firefox
+
+ng-inspector uses [Protractor](https://github.com/angular/protractor) to run e2e tests in Chrome and Firefox. Tests are run against several releases of Angular.
+
+### Running Tests
+
+There are two different options for running tests locally:
+
+* `npm test` - Will open as many browsers as possible when running tests
+* `npm run test-throttled` - Will limit tests to one browser at a time
+
+### Creating a new e2e test
+
+The protractor tests in this repo follow a specific pattern, that helps to automate testing against the different versions of Angular. To scaffold a basic new e2e test, run `gulp newtest --name test-name-here`. This will create the basic test files for you, and place them in a new directory under `test/e2e/tests`.
+
+### Angular Versions
+
+Tests are executed against multiple versions of Angular, and can be configured in `test/e2e/angular-versions.conf.js`.

README.md

@@ -1,15 +1,27 @@
-# ng-inspector
+![logo](logo.png?raw=true)
 
-__ng-inspector__ is a Safari extension that displays an inspector panel to display the AngularJS scope hierarchy in the current page in real time.
+![Travis CI Status](https://travis-ci.org/rev087/ng-inspector.svg?branch=master)
 
-Hovering over a scope in the inspector will highlight with a blue border the DOM element that scope is attached to, as well as any bindings with a red border. Clicking on a model will console.log that model's contents.
+__ng-inspector__ is a browser extension for Chrome and Safari that displays an inspector panel showing the AngularJS scope hierarchy in the current page in real time, as well as which controllers or directives are associated with which scope.
 
-The extension adds a toolbar icon with the AngularJS logo that toggles the pane on and off.
+Hovering over a scope in the inspector will highlight the DOM element that scope is attached to. Clicking on a model will console.log that model's contents.
+
+The extension adds a button next to the address bar with the AngularJS logo that toggles the pane on and off.
 
 ![screenshot](screenshot.png?raw=true)
 
-## Roadmap
+## Installing
+
+### Chrome
+
+Install it from the [Chrome Web Store](https://chrome.google.com/webstore/detail/ng-inspector/aadgmnobpdmgmigaicncghmmoeflnamj)
+
+### Safari
+
+Download the latest build from [ng-inspector.org](http://ng-inspector.org), then double click the `ng-inspector.safariextz` file to install.
+
+## License
 
-In the long term, I'd like to offer at least a larger subset of the features available in the [AngularJS Batarang](https://github.com/angular/angularjs-batarang) extension, but this project is not intended as a direct port. As far as I'm aware, it is not possible to extend the Safari Web Inspector, making a direct port impossible right out of the door.
+The MIT License (MIT)  
 
-The current priority is adding a control to change the docking position of the inspector from the right to the left, as it often stands on top of elements on the page making it impossible to interact with those elements while the inspector is visible.
+See [LICENSE.md](LICENSE.md) for details.

gulp/config.js

@@ -0,0 +1,16 @@
+var format = require('util').format;
+
+var testDir = 'test';
+
+module.exports = {
+	lessDir: 'src/less',
+	safariDir: 'ng-inspector.safariextension',
+	firefoxDir: 'ng-inspector.firefox',
+	chromeDir: 'ng-inspector.chrome',
+	iconsDir: 'src/icons',
+	jsDir: 'src/js',
+	browserifyEntry: 'src/js/bootstrap.js',
+	jsOutputName: 'ng-inspector.js',
+	testDir: testDir,
+	e2eDir: format('%s/e2e', testDir)
+};

gulp/tasks/build-css.js

@@ -0,0 +1,16 @@
+var gulp = require('gulp');
+var less = require('gulp-less');
+var replace = require('gulp-replace');
+var format = require('util').format;
+var config = require('../config');
+
+gulp.task('build:css', function() {
+	return gulp.src([format('%s/stylesheet.less', config.lessDir)])
+		.pipe(less())
+		.pipe(gulp.dest(format('%s/', config.safariDir)))
+		.pipe(gulp.dest(format('%s/data/', config.firefoxDir)))
+		.pipe(replace(/url\(/g, 'url(chrome-extension://__MSG_@@extension_id__/')) // Add path prefix for Chrome
+		.pipe(gulp.dest(format('%s/', config.chromeDir)))
+		.pipe(replace(/(\s*)(.+url\(.+)/g, '$1/* $2 */$1background-image: none !important;')) // Remove images from the test build
+		.pipe(gulp.dest(format('%s/lib/', config.e2eDir)));
+});

gulp/tasks/build-icons.js

@@ -0,0 +1,10 @@
+var gulp = require('gulp');
+var config = require('../config');
+var format = require('util').format;
+
+gulp.task('build:icons', function() {
+	return gulp.src([format('%s/*.png', config.iconsDir)])
+		.pipe(gulp.dest(format('%s/icons/', config.safariDir)))
+		.pipe(gulp.dest(format('%s/icons/', config.chromeDir)))
+		.pipe(gulp.dest(format('%s/data/icons/', config.firefoxDir)));
+});

gulp/tasks/build-js.js

@@ -0,0 +1,23 @@
+var browserify = require('browserify');
+var gulp = require('gulp');
+var source = require('vinyl-source-stream');
+var buffer = require('vinyl-buffer');
+var gutil = require('gulp-util');
+var format = require('util').format;
+var config = require('../config');
+
+gulp.task('build:js', function () {
+  var b = browserify({
+    entries: config.browserifyEntry,
+    debug: true
+  });
+
+  return b.bundle()
+    .pipe(source(config.jsOutputName))
+    .pipe(buffer())
+    .on('error', gutil.log)
+    .pipe(gulp.dest(format('%s/', config.safariDir)))
+    .pipe(gulp.dest(format('%s/', config.chromeDir)))
+    .pipe(gulp.dest(format('%s/data/', config.firefoxDir)))
+    .pipe(gulp.dest(format('%s/lib/', config.e2eDir)));
+});

gulp/tasks/build-safari.js

@@ -0,0 +1,6 @@
+// Here would be a good place to build the Safari archive. But it requires a
+// custom build of the `xar` executable to extract certificates from a
+// Safari-built .safariextz, then signing the .xar archive (renamed .safariextz)
+
+// Steps to build from the command line:
+// http://developer.streak.com/2013/01/how-to-build-safari-extension-using.html