Use the default husky directory

Since the husky files are not part of the distribution, and RAT is run
only against the distribution files, it is not necessary to make husky
use a directory that is visible to RAT.

Remove non-dist files from .ratignore

Rat should be run on the dist directory to be sure that all files in the
distribution have proper license headers, so it does not need to include
files that are not in the distribution anyway.

Exclude .ratignore from git exports

Add .gitattributes to .ratignore

Move SPDX header comments and remove copyright dates

Keep the SPDX header comments, but move them underneath the ASF headers
to make files human-friendly first and machine-friendly second.

Remove copyright dates from header comments. The ASF recommends against
adding an ASF copyright in the header comment, but does not forbid it.
Keep the copyright headers for compliance with the REUSE specification,
but remove the dates to reduce maintenance burder.

Bump versions to 0.3.0

Exclude some repo-related files from exports

Replace rimraf with shx and skip husky install when not in git

Merge pull request #121 from apache/dependabot/npm_and_yarn/node-fetch-2.6.7

Bump node-fetch from 2.6.0 to 2.6.7

Merge pull request #122 from apache/dependabot/npm_and_yarn/trim-off-newlines-1.0.3

Bump trim-off-newlines from 1.0.1 to 1.0.3

Merge pull request #123 from apache/dependabot/npm_and_yarn/async-2.6.4

Bump async from 2.6.3 to 2.6.4

Bump trim-off-newlines from 1.0.1 to 1.0.3

Bumps [trim-off-newlines](https://github.com/stevemao/trim-off-newlines) from 1.0.1 to 1.0.3.
- [Release notes](https://github.com/stevemao/trim-off-newlines/releases)
- [Commits](https://github.com/stevemao/trim-off-newlines/compare/v1.0.1...v1.0.3)

---
updated-dependencies:
- dependency-name: trim-off-newlines
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

Bump async from 2.6.3 to 2.6.4

Bumps [async](https://github.com/caolan/async) from 2.6.3 to 2.6.4.
- [Release notes](https://github.com/caolan/async/releases)
- [Changelog](https://github.com/caolan/async/blob/v2.6.4/CHANGELOG.md)
- [Commits](https://github.com/caolan/async/compare/v2.6.3...v2.6.4)

---
updated-dependencies:
- dependency-name: async
  dependency-type: indirect
...

Signed-off-by: dependabot[bot] <support@github.com>

Bump node-fetch from 2.6.0 to 2.6.7

Bumps [node-fetch](https://github.com/node-fetch/node-fetch) from 2.6.0 to 2.6.7.
- [Release notes](https://github.com/node-fetch/node-fetch/releases)
- [Commits](https://github.com/node-fetch/node-fetch/compare/v2.6.0...v2.6.7)

---
updated-dependencies:
- dependency-name: node-fetch
  dependency-type: direct:development
...

Signed-off-by: dependabot[bot] <support@github.com>

Upgrade Husky from v4 to v7

Better specify targets for modern code output

Set the esmodules target to eliminate browsers that are part of the
browserslist defaults but that do not support modules. Set the node
minimum node version.

Drop support for Node.js v12

Node.js version 12 is end of life soon.

Remove upper bound on Node.js version

Reduce Makefile repitition with dist variables

Consistently use tabs in Makefile

Use git archive instead of git clone

Including a git directory in the dist tarball is a convenient trick for
easing comparison between the archive and the release tag, but it is not
necessary and may be confusing.

Bump copyright year to 2022

Merge pull request #117 from apache/esm-tests

Fix module resolver alias to work on Windows again

Use simpler syntax for module resolution aliases

Report coverage for all files with c8

Allow Babel to use ECMAScript helpers in the test environment

Resolve extensions on relative imports for webpack

Configure babel-plugin-module-resolver to resolve relative import paths
from TypeScript source files of the workspace packages to the TypeScript
source file that corresponds to the import path.

Add Node.js v17 to workspace engines fields

Add Node.js v17 to top-level engines field

Run tests with real ECAMAScript modules

Compile to ECMAScript module syntax for tests.

- Replace nyt with c8

- Replace optimal-select with @medv/finder

- Replace custom babel-register with babel-register-esm

Require file extensions on relative imports

Add file extensions to all relative imports to better align with the
requirements of spec-compliant ECMAScript modules.

Replace chai with built-in strict assert

The chai package does not support named exports in a form that Node.js
can detect them statically. In order to prepare the tests to run as real
ECMAScript modules, switch to using the built-in assert module.

Upgrade Mocha from v8.0.1 to v9.1.3

Reflect branch rename master→main

Fix dependency: dom depends on selector

Bump v0.1.0 → v0.2.0 (better late than never?)

Fix linter resolutions

Restore the use of TypeScript project references to the TypeScript
ESLint plugin. Move the optimal-select module declaration to the root of
the dom package, where TypeScript will automatically find it. Disable
the import/no-unresolved rule for TypeScript files because TypeScript
itself will check that modules resolve.

Copyright like it’s 2021.

Update and merge PR #107 (REUSE compliance)

Reapply the SPDX header to current files, and some others that seem to
have been overlooked.

Copy LICENSE file instead of moving it (symlinking it breaks Rat, somehow).

Make clean command clean more stuff

Using gitignore as reference.
Is ‘/coverage’ still actually created by something?

Also making a tiny nitpick in gitignore.

Please linter

Satisfy the Rat

Add warning about issue #112.

Improve CssSelector docs

Tiny fixes

Dedupe & refactor range comparison code

Test all cases with DOM mutation

Add cases for matches in multiple nodes

In the case of DOM changes, a different error occurs depending on whether
the matches are in the same or different text nodes. With different nodes,
the infinite loop behaviour occurs.

Add failing test changing DOM (text quote match)

See issue #112 <https://github.com/apache/incubator-annotator/issues/112>

Forgotten rename

Make highlightRange accept Node, rename to highlightText

Fixes issue #111 <https://github.com/apache/incubator-annotator/issues/111>

Simplify tests

Possible since a Node is now accepted as the scope

Test for range without Text nodes (describe text quote)

…also in each package

Add node 16 to engines

tweak documentation

Use node as scope in demo

Declare types for optimal-select dependency

The linter does not seem to pick it up however..

Run linter

Merge branch 'allow-node-as-scope' (PR #110)

Rename range-node-conversion.ts → to-range.ts

Make all functions also accept a Node as scope

Make css matcher also accept a Node as scope

Make css matcher return an Element, not Range

Remove forgotten .only in tests

Document describeCss, tweak docs of describeText…

Make default scope of describeCss the whole document

Instead of just the body.

Accordingly, allow any Node as scope, not only Elements.

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.

tweak doc

Add short typedoc @module descriptions

It seems this needs to be done in packages/apache-annotator; if put in
the individual packages’ index.ts files, it does not show up in the docs.

Make Readme point to docs on website

It is helpful there, but too easily gets outdated if we have content
duplicated in multiple places.

Improve hot module reloading in demo

So that old highlights still get cleaned up.

Simplify the ESLint module resolver configuration

Lint cartesian.test.ts

Tweak typedoc config

Setting "disableSources" because the generated links incorrectly point
to generated files (lib/….d.ts) rather than their source files.
(why does it not use the declaration map to find the correct file&line?)

If we do get it to work, we could use typedoc-plugin-sourcefile-url to
point to the apache repo by adding:
  "sourcefile-url-prefix": "https://gitbox.apache.org/repos/asf?p=incubator-annotator.git;a=blob;hb=refs/heads/master;f=packages/"

Fix link to demo source code

Clean up remnants of in-browser tests

See commit 6a42375

Make web:build work again

Partially reverts commit 6a42375; which while removing the in-browser
tests (as advertised) also broke the build that our website relies on.

Close source iterators on cartesian exit

Add watch files to mocha configuration

Do not publish tsconfig.json and tsconfig.tsbuildinfo files

Do not publish declaration maps

Declaration map files are useful during development to enable navigation
to original sources inside an editor, but are not useful for end users.

Remove mocha tests from webpack build

The mocha-loader is unmaintained and running the tests in a real browser
in this way without a CI browser test matrix provides little value.

Enable experimental support for linting TypeScript project references

This change makes it possible to get correct linting results without
building the projects.

Emit source maps as separate files

Provide source maps as separate files in the build so that the common
case of importing the code without debugging it does not require reading
all those extra bytes.

Remove CommonJS build

Supporting two builds has been complicated and increasingly unnecessary.
Expect consumers to be using bundlers or versions of Node.js that have
support for ECMAScript Modules.

Merge pull request #108 from fredsterorg/master

Minor changes

Minor changes

Turn tsdoc into typedoc

More API documentation!

Actually, don’t always build the docs.

Also build docs *after* the type declarations, not concurrently.

We still want to remove the docs directory upon cleaning, I suppose.

Fix typedoc entrypoint

The entrypoint referred to was removed in commit 848dc3c

Add build:docs command, remove /docs in clean command

Enable the @typescript-eslint/no-duplicate-imports rule

Enable support for proposals in the babel runtime transformation

Enable support for proposals in @babel/plugin-transform-runtime because
ESLint and TypeScript will take care of rejecting syntax that is not
enabled by the configured language versions and library definitions, but
proposals that have shipped.

Move babel targets to the top level of the configuration

Upgrade babel dependencies from v7.12 to v7.13

Upgrade global-jsdom from v6.1.0 to v8.0.0

Opt into explicit TypeScript index property access

Opt into a new feature of TypeScript that restores an old behavior
wherein accessing properties that match an index signature requires
using bracket syntax. With this change, TypeScript will catch dotted
attributed access that might be incorrect, but allow access with bracket
notation that may be useful in certain scenarios.