Add events and safe mode.

[davidlehn]

(This is a combination of "expanionMap" work and "events" work.)

• Experimental non-standard protectedMode option removed.
• Event handler system added.
  • Used for features to catch specific processing conditions.
  • Useful for debugging tools.
• Events emitted for spec warning cases, dropped data, and other conditions.
• "safe" mode added that uses specific events to stop processing. Very important for tooling that needs to protect against unintended data loss.

[codecov-commenter]

Codecov Report

Merging #481 (f7aad3d) into fix-expandmap (e37991f) will increase coverage by 68.34%. The diff coverage is 93.01%.

@@                Coverage Diff                 @@
##           fix-expandmap     #481       +/-   ##
==================================================
+ Coverage          25.23%   93.57%   +68.34%     
==================================================
  Files                 23       24        +1     
  Lines               2881     2959       +78     
==================================================
+ Hits                 727     2769     +2042     
+ Misses              2154      190     -1964     

Impacted Files	Coverage Δ
lib/compact.js	94.21% <50.00%> (+91.58%)	:arrow_up:
lib/events.js	79.06% <79.06%> (ø)
lib/jsonld.js	83.64% <83.33%> (+57.75%)	:arrow_up:
lib/expand.js	96.96% <98.36%> (+61.55%)	:arrow_up:
lib/context.js	95.05% <100.00%> (+56.93%)	:arrow_up:
lib/fromRdf.js	99.22% <100.00%> (+91.96%)	:arrow_up:
lib/graphTypes.js	96.15% <100.00%> (+52.15%)	:arrow_up:
lib/toRdf.js	100.00% <100.00%> (+89.71%)	:arrow_up:
lib/util.js	88.75% <100.00%> (+45.72%)	:arrow_up:
lib/url.js	95.76% <0.00%> (+41.52%)	:arrow_up:
... and 15 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[davidlehn]

• The compactionMap and expansionMap hooks were removed in favor of safe mode.
• The event system behind the scenes is not being exposed yet.