Card 89

Re-implement the behavior where new annotations
use the last-used privacy setting by default.

This was previously implemented in privacy.js
and the logic now lives in the replacement component,
publish-annotation-btn.js. However, the defaults
really shouldn't be set in the view but earlier when
the new annotation is created.

Card 89

The newer version of Angular UI bootstrap has
an optional keyboard-nav directive to
make dropdowns keyboard accessible.

Card 89

Using a <button> gives us keyboard accessibility and focus.

The downside is that additional styling is needed to suppress
default styling from the UA.

Card 89

This is a more descriptive name explaining what the component
is for.

Card 89

 * Move the annotation privacy label below the button. The label's
   height may vary depending on the selected option, so moving it
   below the button avoids changing the button's position when
   a different option is selected from the dropdown.

 * Remove the previous separate privacy dropdown and replace with
   the combined button.

 * Use flexbox to simplify layout of the annotation form actions

Card 89

This directive provides a button to publish an annotation
plus a dropdown-menu for changing its privacy settings.

Card 89

h/static/scripts/vendor/angular-bootstrap.js contains
a legacy version of the dropdown component

ui-bootstrap contains the current version with additional features
including the ability to open and close the dropdown via an
'is-open' attribute, keyboard navigation support and the ability
to use it via attribute directives.

This build has been lightly edited for Angular 1.2.x compatibility
(the original build requires a couple of features from Angular 1.3)

Card 89

Due to the existence of a 'p + p' selector in app.css, the <p>
element containing the 'This annotation is visible only to you'
label was displayed at a different vertical position to
the alternative labels.

Use ng-if rather than ng-show to remove the non-visible
labels so that the rendered <p> is always the first <p> child
of its parent and therefore always rendered at the same position.

The annotation action links were too small to be easily
legible, as was the 'This annotation will be visible to ...' label.

This sets the size of 'small' text to $body1-font-size which is
the smallest legible size for text in the app.

<primary-action-btn> is the purely visual component which
provides a button with a dropdown arrow menu that will open
an associated dropdown menu.

An additional component or controller will then wrap this
and provide the actual Save functionality.

Card 89

(see 9d57500)

(Because compiling assets is something we do in production.)

Fix comments (AKA "page notes") with search_normalized

Previously, an annotation with a selectorless target (such as a comment
or "page note") would be marked as an orphan.

This commit adjusts the orphan detection code so that an annotation is
marked as an orphan only if both of the following conditions are met:

- it has at least one target with selectors (an "anchorable target")
- none of the anchorable targets have successfully anchored

In order for comments (AKA "page notes") to be discoverable with the
search logic implemented in #2413 (cc4ca35), they need to have at least
one target with a source field.

Previously a comment was defined as an annotation

- with a `uri`
- without any targets
- without any references (no targets but with references == a reply)

Now comments have a single target with a single field, `source`. This
finally puts us in a position where we can consider deprecating the
`uri` field.

If one of these asserts fails, then this test will timeout (taking 2
seconds to do so).

By using a small helper (`timeoutPromise`) to implement the "next tick"
functionality that was previously achieved with `setTimeout`, this is
improved: we return a promise from the test function and a failure will
be reported immediately.

See https://mochajs.org/#working-with-promises for more on returning
promises from mocha test functions.

It's not at all clear from the code that the singular "selector" is in
fact an array of selectors referring to a single target. Add a few
comments to help understanding this until we can sort out a better
refactoring/naming.

The last thing that used this was removed in 7829cc1.

Change $anchored -> $orphan

Instead of setting $anchored=true on anchored annotations, set
$orphan=true on orphaned (i.e. unanchored) ones as we used to do.

Orphaned annotations are the exception: we don't show them, or if
show_unanchored_annotations is one then we show them with a warning.
It's simpler and less buggy to add $orphan=true onto the exceptional
annotations than to try to add $anchored=true onto all of the
unexceptional ones.

Fixes #2525.
Fixes #2541.

Fix document title and domain for local file PDF annotations

This fixes two issues on the annotation cards for some annotations:

1. If the annotated document has a non-http(s) URI (e.g. a local file://
   URI) then don't hyperlink the document's title to that URI

2. If the annotated document has no .domain value or its domain is the
   same as its title then don't display anything, instead of displaying
   a pair of emtpy braces ().

To fix this move the logic for formatting an annotation's document's title
and domain into AngularJS filters where it can be tested, instead of in
the template.

Use autoprefixer to add vendor prefixes to CSS

Translate annotation mapper

Hide unanchored warnings when not sidebar

Don't show the "We can't find the exact position of this annotation"
warnings on unanchored annotations when on the stream or individual
annotation pages - only show them in the sidebar.

Fix an issue where the group details container
could horizontally overflow the dropdown menu.

In IE 10 the text did not automatically wrap.

Add flex-shrink so that it will
collapse if necessary.

Card 87

In preparation for making some substantial changes to this piece of
code, I'm translating it to JS.

In preparation for making some substantial changes to this piece of
code, I'm translating it to JS.

Use postcss and the autoprefixer plugin to post-process
CSS to add vendor prefixes and remove use of compass
mixins which did the same thing.

This moves compatibility concerns out of our styling
and down to a post-processor whose options can be adjusted
as necessary and moves us a step towards removing the
build dependency on compass.

Looking at the generated output, it fixes several issues
where we were inconsistent about which prefixes were used.

Pyramid webassets does have an autoprefixer filter but
it was written for an older version of autoprefixer which
was a standalone tool rather than a postcss plugin. In future
this also paves the way to replacing the cleancss asset filter
with an optional step in the postcss-filter.js script.

Consolidate .gitignore files

Auto re-install Python, Node deps if out of date

Having these scattered about across the repository makes it hard to work
out where something is ignored, and most tools/editors that read
.gitignore files don't pay attention to those not in the repository
root.

T87 - Improve group scope dropdown ui

For IE 10 and Safari < 9 support, use prefixed flexbox.

For now, this duplicates the flexbox declarations as is
done in topbar.scss. I will look into using autoprefixer for
this separately.

Card 87

cf410d0 broke standalone annotation pages by changing
`threadRoot.children` from an array into a thread container.
Unsurprisingly, `children` is supposed to be an array.

 * Use the singular 'groupList' everywhere

 * Simplify the logic for stopping click propagation
   when toggling the selected group

 * Remove underscore prefix for Controller classes as per the PR
   discussion.

Card 87