Release/absolute anaconda

[dxinteractive]

dataparcels

Contains #105, #117, #147, #150, #152, #154, #158, #159, #161, #162, #163, #164

Main points:

• Move from named exports (import {Foo} from 'bar';) to slash exports (import Foo from 'bar/Foo';) to allow people to have smaller bundle sizes when they use less features. This convention will become more important as optional features like Add: rekey #123 and Add: utils/segment #124 are added
• Clean up the modify methods API. This has been really confusing. Now we just have .modifyDown() and .modifyUp(). If shape editing / deep editing is required, then a parcel shape updater can be imported via import shape from 'dataparcels/shape and used like .modifyDown(shape(parcelShape => parcelShape))
• Use new change request reducer, and remove parts of the API that only existed to cope with the underlying flaws with the old reducer.

Fixes

• fix: Parcel.toObject() now turns arrays into objects as expected
• fix: prevent value from being removed if Parcel.initialMeta is set Bug: initialMeta deletes value #164
• fix: allow ParcelBoundary state to be ahead of the state of higher parcels even when debounce or hold aren't being used. Previously a regular ParcelBoundary was fully locked to props, but some freedom to have the ParcelBoundary's state move forward is safe and also necessary for the intended pattern of using modifyUp to cancel invalid values.
• amend: fix a bug where ChangeRequestReducer's "parent actions" (swapPrev, swapNext, delete etc) wouldn't run pre and post functions on last keypathmodifier

Exports

• BREAKING CHANGE removed all named exports in favour of slash exports, expect for type exports.
  • e.g. import {Action} from 'dataparcels'; becomes import Action from 'dataparcels/Action';
• BREAKING CHANGE ActionCreators is no longer exported from dataparcels
• BREAKING CHANGE removed type ParcelMetaUpdater from named exports Remove: Parcel.updateMeta #154
• Add: Added types to exports
  • {ParcelCreateConfigType}
  • {ParcelShapeSetMeta}
  • {ParcelShapeValueUpdater}
  • {ParcelShapeUpdater}
  • {ParcelShapeConfigInternal}
  • {ParentType}

Parcel methods

• BREAKING CHANGE removed Parcel config.debugRender Remove: ParcelBoundary and ParcelBoundaryHoc debugRender #159
• BREAKING CHANGE removed Parcel.updateMeta() Remove: Parcel.updateMeta #154
• BREAKING CHANGE removed Parcel.matchPipe() Remove: matchPipe() or replace it with branchPipe() and split out matcher #152
• BREAKING CHANGE removed Parcel.batch(). Use Parcel.update() with shape updaters instead
• BREAKING CHANGE removed Parcel.modifyChange(). Use Parcel.modifyUp() with shape updaters instead
• BREAKING CHANGE removed Parcel.batchAndReturn().
• BREAKING CHANGE removed Parcel.hasDispatched(). Nothing should ever rely on this information, no Parcel should ever ask questions of their children.
• BREAKING CHANGE removed Parcel.setChangeRequestMeta(). Seldom used feature that doesn't fit now that Parcel.batch() is gone.
  • The use case for this has disappeared since field validation is going to be better handled in a ParcelBoundaryHoc
• BREAKING CHANGE removed Parcel.ping() Remove: ping and synchronous actions #161
• Added Parcel.children() - returns the value's children as Parcels, in the current parent data container.
• add: Parcel.move() Add: IndexedParcel.move() and https://github.com/clauderic/react-sortable-hoc example #117
• Add: ability for Parcel.push(), Parcel.unshift(), ParcelShape.push() and ParcelShape.unshift() to accept multiple arguments Add: ability for push() and unshift() to take n arguments #163

Parcel modify functions

• BREAKING CHANGE Parcel.modifyValue is now called Parcel.modifyDown Add: Finalise and complete the modify methods #147
• BREAKING CHANGE Parcel.modifyChangeValue is now called Parcel.modifyUp Add: Finalise and complete the modify methods #147
• BREAKING CHANGE Parcel.modifyChangeBatch has been removed Add: Finalise and complete the modify methods #147
• Added ability for Parcel.update(), Parcel.modifyDown() and Parcel.modifyUp() to accept parcel shape updaters.
  • import shape from 'dataparcels/shape;
  • .modifyDown(shape(parcelShape => parcelShape))
• Added ability for Parcel.modifyUp() to return a CancelActionMarker to cancel an action.
  • import CancelActionMarker from 'dataparcels/CancelActionMarker;
  • .modifyUp(value => value !== "good" ? CancelActionMarker : value)

Actions, ChangeRequests and keyPathModifiers

• BREAKING CHANGE removed Action.shouldBeSynchronous() Remove: ping and synchronous actions #161
• BREAKING CHANGE removed ChangeRequest.shouldBeSynchronous() Remove: ping and synchronous actions #161
• Add: Action.toJS() now includes keyPathModifiers Add: Allow for functions as actions #105
• Refactor: "function modifiers" - actions and change requests and the reducer now use ActionKeyPathModifiers to store modifier functions directly on each action. This means that actions and change requests become truly re-runnable with different input data. A set of actions can be run through the reducer multiple times with different data and there wont be any accidental "caching" of derived data. Add: Allow for functions as actions #105
• Refactor: replace Reducer with ChangeRequestReducer which can handle keyPathModifiers. Add: Allow for functions as actions #105

ParcelShape

• Added ParcelShape (previously called StaticParcel) Add: StaticParcel #150

react-dataparcels

Exports

• BREAKING CHANGE removed all named exports in favour of slash exports, expect for type exports.
  • e.g. import {Action} from 'react-dataparcels'; becomes import Action from 'react-dataparcels/Action';
• BREAKING CHANGE ActionCreators is no longer exported from react-dataparcels
• BREAKING CHANGE removed type ParcelMetaUpdater from named exports Remove: Parcel.updateMeta #154

ParcelHoc

• BREAKING CHANGE removed ParcelHoc config.debugRender Remove: ParcelBoundary and ParcelBoundaryHoc debugRender #159
• Add: Added types to exports
  • {ParcelCreateConfigType}
  • {ParcelShapeSetMeta}
  • {ParcelShapeValueUpdater}
  • {ParcelShapeUpdater}
  • {ParcelShapeConfigInternal}
  • {ParentType}

ParcelBoundary

• add: Parcelboundary.keepState.

react-dataparcels-drag

• Added react-dataparcels-drag, a plugin for react-dataparcels that adds drag and drop re-ordering of elements, using the wonderful react-sortable-hoc.

Repo

• Add size-limit to keep an eye on library bloat. Addresses Add: size-limit #162