shexjs / shex.js / 29320865913

75%

Build Type

push

github

Committed by Eric Prud'hommeaux

Commit Message

build: repair the shex meta-package, drop lerna, refresh READMEs

The shex meta-package was published broken: no main (so require('shex')
threw), a README documenting bins at paths that don't exist, and
@shexjs/cli@1.0.0-alpha.29 crashing on an undeclared
@shexjs/neighborhood-sparql.  Auditing for that failure class found 25
hoisting-masked undeclared dependencies across 9 packages (shape-map
missing @ts-jison/lexer, neighborhood-rdfjs missing neighborhood-api,
extension-map missing 8, ...), all now declared with ranges their
workspace versions satisfy.

packages/shex:
- shex.js: aggregate index (Parser, Writer, Validator, RdfJsDb, Loader,
  NodeLoader, Term, Util, Visitor, ShapeMap) with main set and explicit
  dependencies.
- test/meta-test.js: the aggregate API validates end-to-end; dependency
  ranges are satisfied by workspace versions.
- test/monorepo-deps-test.js: no workspace package may require a package
  its manifest doesn't declare (the class of bug that broke the CLI).
- README.md: consumer-focused rewrite; every example verified by
  execution (npx bin names, extension paths, live try-online link).

lerna removal (it was in fixed-versioning mode, not independent; npm
workspaces already does the linking, and 'lerna bootstrap' in the
rebuild script had been broken since lerna 7):
- tools/bumpVersions.js (npm run bump-versions -- [--dry-run] <version>)
  sets every workspace version and cross-workspace range; publishing is
  npm publish --workspaces.
- lerna.json removed; browserify-all.js reads package.json workspaces.
- node-fetch was only resolvable through lerna-era hoisting luck; the
  shared test infrastructure that requires it now gets it from a root
  devDependency.

README.md: 'npm workspaces monorepo' section with building, testing and
publishing instructions; stale examples fixed (npx bin names, working
loader examples, dead rawgit links replaced with the live
shex.io/webapps pages, Actions badges).

Co-Authored-By: Claude Fable ... (continued)

Coverage Stats

2210 of 3524 branches covered (62.71%)

Branch coverage included in aggregate %.

67 of 69 new or added lines in 3 files covered. (97.1%)

4655 of 5925 relevant lines covered (78.57%)

7501.75 hits per line