merges two trees guided with hints

import { merge } from "hinted-tree-merger";

const r = merge(
        [{ k:1, e:1}, { k:2}],
        [{ k:1, e:2}, { k:3}], // 2nd. array has precedence
        "",
      undefined,
      {
        "": { key: "k" } // identify slots by property "k"
      });

  // r := [{ k:1 e:2 }, { k:2 }, { k:3 }]

import { merge } from "hinted-tree-merger";

const r = merge( undefined, [ { k:1, e:2}, { k:3 }]);

  // r := [{ k:1 e:2 }, { k:2 }, { k:3 }]

• hintFor
  • Parameters
• Actions
  • Parameters
• mergeSkip
  • Parameters
• mergeArrays
  • Parameters
• merge
  • Parameters
• hasDeleteHint
  • Parameters
• isToBeRemoved
  • Parameters
• hintFreeValue
  • Parameters
• indexFor
  • Parameters
• keyFor
  • Parameters
• sortObjectsByKeys
  • Parameters
• compareWithDefinedOrder
  • Parameters
• matchingIndex
  • Parameters
• toRegexp
  • Parameters
• match
• cmp
  • Parameters
• compareVersion
  • Parameters
• unionVersion
  • Parameters
• VersionMapper
• mergeVersionsWithFilter
  • Parameters
• mergeVersions
  • Parameters
• mergeVersionsPreferNumeric
  • Parameters
• walk
  • Parameters

Construct hint for a given path.

• hints Object
• path string

Type: Function

• options Object
• hints Object

Skip merging use left side always.

• a
• b
• path
• actions
• hints

• a Array<any>
• b Array<any>
• path string
• actions Actions (optional, default nullAction)
• hints Object

Merge to values.

• a any
• b any
• path
• actions Actions (optional, default nullAction)
• hints any

Returns any merged value

• value any
• expected (string | Function)

Returns (string | boolean)

Should value be removed.

• value string
• fromTemplate string

Returns Object true if fromTemplate tells is to delete value

Remove hint(s) form a value.

• value (string | any)

Returns any value without hint

Find best insertion point for b[i] in a.

• b Array<any>
• i number
• a Array<any>

Deliver key value to identify object.

• object any
• hint Object

Returns (string | undefined)

Sort keys in source.

• source Object
• compare

Returns Object source with keys orderd by compare function

• a any
• b any
• definedOrder Array<(RegExp | string)>

• value any

Returns number

try to from a regexp from str. Str must start with '/' and end with '/'

• str string

Returns (RegExp | string)

url means highest version

• a Array<number>
• b Array<number>

Returns number

Compare two versions.

• a (string | number)
• b (string | number)

Returns number -1 if a < b, 0 if a == b and 1 if a > b

Forms union of two versions.

• a (string | number)
• b (string | number)

Returns (string | number)

maps version values (to number)

Type: Function

Merge and filter two sets of version (expressions).

• a (string | Array<string> | number | Array<number>)
• b (string | Array<string> | number | Array<number>)
• path string location in the tree
• actions Function cb to notify about the actual selection (optional, default nullAction)
• hints Object
• filter VersionMapper

Returns (string | Array<string> | number | Array<number>) merged set of version expressions

merge two sets of version (expressions)

• a (string | Array<string> | number | Array<number>)
• b (string | Array<string> | number | Array<number>)
• path string location in the tree
• actions Function cb to notify about the actual selection
• hints Object

Returns (string | Array<string> | number | Array<number>) merged set of version expressions

Same as mergeVersions but merge result are converted into numbers if possible

• a (string | Array<string> | number | Array<number>)
• b (string | Array<string> | number | Array<number>)
• path string location in the tree
• actions Function cb to notify about the actual selection
• hints Object

Returns (string | Array<string> | number | Array<number>) merged set of version expressions

Iterates over all members.

• value any
• path Array<any> (optional, default [])
• parents (optional, default [])

With npm do:

npm install hinted-tree-merger

BSD-2-Clause