Add describeCss & tests, document spec ambiguity

I tried a few css selector generators, listed here:
<https://github.com/fczbkk/css-selector-generator-benchmark>

- css-selector-generator failed when a root (= scope) is passed; see
  issue <https://github.com/fczbkk/css-selector-generator/issues/65>.

- using @mdev/finder instead gave syntax errors due to ‘export’ token.
  (perhaps because we don’t transpile dependencies; worth considering?)

- optimal-select seemed to work; whatever works is good enough for now.

I made describeCss accept an Element, not a Range, for its scope and
target, as Ranges make little sense for a CssSelector; I figured we may
want to change this in the matcher too, and perhaps more widely.
6 files changed
tree: 8d2669e0edbdae698f9c0e0d56fa4a3c970620c9
  1. packages/
  2. test/
  3. web/
  4. .asf.yaml
  5. .editorconfig
  6. .eslintignore
  7. .eslintrc.js
  8. .gitignore
  9. .lintstagedrc
  10. .mocharc.js
  11. .ratignore
  12. .travis.yml
  13. babel-register.js
  14. babel.config.js
  15. CODE_OF_CONDUCT.md
  16. DISCLAIMER-WIP
  17. husky.config.js
  18. lerna.json
  19. LICENSE
  20. Makefile
  21. NOTICE
  22. nyc.config.js
  23. package.json
  24. README.md
  25. repolinter.json
  26. SECURITY.md
  27. tsconfig.base.json
  28. tsconfig.json
  29. tsconfig.test.json
  30. typedoc.json
  31. yarn.lock
README.md

Apache Annotator (incubating) Build Status

Apache Annotator (incubating) provides libraries to enable annotation related software, with an initial focus on identification of textual fragments in browser environments.

Installation, usage, API documentation

See documentation on the website: https://annotator.apache.org/docs/

Getting Involved

License

Apache License 2.0

Disclaimer

Apache Annotator is currently undergoing incubation at The Apache Software Foundation.

See the accompanying DISCLAIMER file for details.