Add test (commented out for now) which illustrates the fact that the scanner does not correctly deal with surrogate pairs when processing identifiers.
Add much-needed info to readme; remove redundant link element from ast doc generator.
Add a package.json file;  fix silly typo in README.