PHPXRef 0.7.1 : WordPress : Detail view of block-editor.js

Calculate the `line-height` of a given node

param: {HTMLElement} node Element to calculate line height of. Must be in the DOM.
returns: {Number} `line-height` of the element in pixels

_extends() X-Ref

No description

_objectWithoutPropertiesLoose(source, excluded) X-Ref

No description

_extends() X-Ref

No description

_assertThisInitialized(self) X-Ref

No description

error(type) X-Ref

A generic error utility function.

param: {String} type The error type.
returns: {Error} Throws a `RangeError` with the applicable error message.

map(array, fn) X-Ref

A generic `Array#map` utility function.

param: {Array} array The array to iterate over.
param: {Function} callback The function that gets called for every array
returns: {Array} A new array of values returned by the callback function.

mapDomain(string, fn) X-Ref

A simple `Array#map`-like wrapper to work with domain name strings or email
addresses.

param: {String} domain The domain name or email address.
param: {Function} callback The function that gets called for every
returns: {Array} A new string of characters returned by the callback

ucs2decode(string) X-Ref

Creates an array containing the numeric code points of each Unicode
character in the string. While JavaScript uses UCS-2 internally,
this function will convert a pair of surrogate halves (each of which
UCS-2 exposes as separate characters) into a single code point,
matching UTF-16.

param: {String} string The Unicode input string (UCS-2).
returns: {Array} The new array of code points.

ucs2encode(array) X-Ref

Creates a string based on an array of numeric code points.

param: {Array} codePoints The array of numeric code points.
returns: {String} The new Unicode string (UCS-2).

basicToDigit(codePoint) X-Ref

Converts a basic code point into a digit/integer.

param: {Number} codePoint The basic numeric code point value.
returns: {Number} The numeric value of a basic code point (for use in

digitToBasic(digit, flag) X-Ref

Converts a digit/integer into a basic code point.

param: {Number} digit The numeric value of a basic code point.
returns: {Number} The basic code point whose value (when used for

adapt(delta, numPoints, firstTime) X-Ref

Bias adaptation function as per section 3.4 of RFC 3492.
http://tools.ietf.org/html/rfc3492#section-3.4

decode(input) X-Ref

Converts a Punycode string of ASCII-only symbols to a string of Unicode
symbols.

param: {String} input The Punycode string of ASCII-only symbols.
returns: {String} The resulting string of Unicode symbols.

encode(input) X-Ref

Converts a string of Unicode symbols (e.g. a domain name label) to a
Punycode string of ASCII-only symbols.

param: {String} input The string of Unicode symbols.
returns: {String} The resulting Punycode string of ASCII-only symbols.

toUnicode(input) X-Ref

Converts a Punycode string representing a domain name or an email address
to Unicode. Only the Punycoded parts of the input will be converted, i.e.
it doesn't matter if you call it on a string that has already been
converted to Unicode.

param: {String} input The Punycoded domain name or email address to
returns: {String} The Unicode representation of the given Punycode

toASCII(input) X-Ref

Converts a Unicode string representing a domain name or an email address to
Punycode. Only the non-ASCII parts of the domain name will be converted,
i.e. it doesn't matter if you call it with a domain that's already in
ASCII.

param: {String} input The domain name or email address to convert, as a
returns: {String} The Punycode representation of the given domain name or

hasOwnProperty(obj, prop) X-Ref

No description

map(xs, f) X-Ref

No description

_defineProperties(target, props) X-Ref

No description

_createClass(Constructor, protoProps, staticProps) X-Ref

No description

_classCallCheck(instance, Constructor) X-Ref

No description

_possibleConstructorReturn(self, call) X-Ref

No description

_getPrototypeOf(o) X-Ref

No description

_setPrototypeOf(o, p) X-Ref

No description

_inherits(subClass, superClass) X-Ref

No description

_arrayWithoutHoles(arr) X-Ref

No description

_nonIterableSpread() X-Ref

No description

_toConsumableArray(arr) X-Ref

No description

_objectWithoutProperties(source, excluded) X-Ref

No description

multi(_ref) X-Ref

Redux dispatch multiple actions

__webpack_require__(moduleId) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

Diff() X-Ref

No description

done(value) X-Ref

No description

execEditLength() X-Ref

No description

buildValues(diff, components, newString, oldString, useLongestToken) X-Ref

No description

clonePath(path) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

diffChars(oldStr, newStr, options) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

diffWords(oldStr, newStr, options) X-Ref

No description

diffWordsWithSpace(oldStr, newStr, options) X-Ref

No description

generateOptions(options, defaults) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

diffLines(oldStr, newStr, callback) X-Ref

No description

diffTrimmedLines(oldStr, newStr, callback) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

diffSentences(oldStr, newStr, callback) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

diffCss(oldStr, newStr, callback) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

diffJson(oldObj, newObj, options) X-Ref

No description

canonicalize(obj, stack, replacementStack, replacer, key) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

diffArrays(oldArr, newArr, callback) X-Ref

No description

_interopRequireDefault(obj) X-Ref

No description

applyPatch(source, uniDiff) X-Ref

No description

hunkFits(hunk, toPos) X-Ref

Checks if the hunk exactly fits on the provided location

applyPatches(uniDiff, options) X-Ref

No description

processIndex() X-Ref

No description

parsePatch(uniDiff) X-Ref

No description

parseIndex() X-Ref

No description

parseFileHeader(index) X-Ref

No description

parseHunk() X-Ref

No description

_toConsumableArray(arr) X-Ref

No description

calcLineCount(hunk) X-Ref

No description

merge(mine, theirs, base) X-Ref

No description

loadPatch(param, base) X-Ref

No description

fileNameChanged(patch) X-Ref

No description

selectField(index, mine, theirs) X-Ref

No description

hunkBefore(test, check) X-Ref

No description

cloneHunk(hunk, offset) X-Ref

No description

mergeLines(hunk, mineOffset, mineLines, theirOffset, theirLines) X-Ref

No description

mutualChange(hunk, mine, their) X-Ref

No description

removal(hunk, mine, their, swap) X-Ref

No description

conflict(hunk, mine, their) X-Ref

No description

insertLeading(hunk, insert, their) X-Ref

No description

insertTrailing(hunk, insert) X-Ref

No description

collectChange(state) X-Ref

No description

collectContext(state, matchChanges) X-Ref

No description

allRemoves(changes) X-Ref

No description

skipRemoveSuperset(state, removeChanges, delta) X-Ref

No description

calcOldNewLineCount(lines) X-Ref

No description

_toConsumableArray(arr) X-Ref

No description

structuredPatch(oldFileName, newFileName, oldStr, newStr, oldHeader, newHeader, options) X-Ref

No description

contextLines(lines) X-Ref

No description

createTwoFilesPatch(oldFileName, newFileName, oldStr, newStr, oldHeader, newHeader, options) X-Ref

No description

createPatch(fileName, oldStr, newStr, oldHeader, newHeader, options) X-Ref

No description

arrayEqual(a, b) X-Ref

No description

arrayStartsWith(array, start) X-Ref

No description

convertChangesToDMP(changes) X-Ref

No description

convertChangesToXML(changes) X-Ref

No description

escapeHTML(s) X-Ref

No description

Traverse(obj) X-Ref

No description

walk(root, cb, immutable) X-Ref

No description

updateState() X-Ref

No description

copy(src) X-Ref

No description

toS(obj) X-Ref

No description

isDate(obj) X-Ref

No description

isRegExp(obj) X-Ref

No description

isError(obj) X-Ref

No description

isBoolean(obj) X-Ref

No description

isNumber(obj) X-Ref

No description

isString(obj) X-Ref

No description

_iterableToArrayLimit(arr, i) X-Ref

No description

_slicedToArray(arr, i) X-Ref

No description

_iterableToArray(iter) X-Ref

No description

_typeof(obj) X-Ref

No description

arrayOf( value ) X-Ref

Returns the first argument as the sole entry in an array.

param: {*} value Value to return.
return: {Array} Value returned as entry in array.

isObjectLike( value ) X-Ref

Returns true if the value passed is object-like, or false otherwise. A value
is object-like if it can support property assignment, e.g. object or array.

param: {*} value Value to test.
return: {boolean} Whether value is object-like.

createCache() X-Ref

Creates and returns a new cache object.

return: {Object} Cache object.

isShallowEqual( a, b, fromIndex ) X-Ref

Returns true if entries within the two arrays are strictly equal by
reference from a starting index.

param: {Array} a First array.
param: {Array} b Second array.
param: {number} fromIndex Index from which to start comparison.
return: {boolean} Whether arrays are shallowly equal.

getRootCache() X-Ref

Returns the root cache. If WeakMap is supported, this is assigned to the
root WeakMap cache set, otherwise it is a shared instance of the default
cache object.

return: {(WeakMap|Object)} Root cache object.

getWeakMapCache( dependants ) X-Ref

Returns the cache for a given dependants array. When possible, a WeakMap
will be used to create a unique cache for each set of dependants. This
is feasible due to the nature of WeakMap in allowing garbage collection
to occur on entries where the key object is no longer referenced. Since
WeakMap requires the key to be an object, this is only possible when the
dependant is object-like. The root cache is created as a hierarchy where
each top-level key is the first entry in a dependants set, the value a
WeakMap where each key is the next dependant, and so on. This continues
so long as the dependants are object-like. If no dependants are object-
like, then the cache is shared across all invocations.

param: {Array} dependants Selector dependants.
return: {Object} Cache object.

clear() X-Ref

Resets root memoization cache.

callSelector( ) X-Ref

The augmented selector call, considering first whether dependants have
changed before passing it to underlying memoize function.

param: {Object} source Source object for derivation.
param: {...*} extraArgs Additional arguments to pass to selector.
return: {*} Selector result.

_arrayWithHoles(arr) X-Ref

No description

_nonIterableRest() X-Ref

No description

getColorClassName(colorContextName, colorSlug) X-Ref

Returns a class based on the context a color is being used and its slug.

param: {string} colorContextName Context/place where color is being used e.g: background, text etc...
param: {string} colorSlug Slug of the color.
return: {?string} String with the class corresponding to the color in the provided context.

utils_getMostReadableColor(colors, colorValue) X-Ref

Given an array of color objects and a color value returns the color value of the most readable color in the array.

param: {Array} colors Array of color objects as set by the theme or by the editor defaults.
param: {?string} colorValue A string containing the color value.
return: {string} String with the color value of the most readable color.

createColorHOC(colorTypes, withColorPalette) X-Ref

Helper function used with `createHigherOrderComponent` to create
higher order components for managing color logic.

param: {Array} colorTypes An array of color types (e.g. 'backgroundColor, borderColor).
param: {Function} withColorPalette A HOC for injecting the 'colors' prop into the WrappedComponent.
return: {WPComponent} The component that can be used as a HOC.

_class(props) X-Ref

No description

createCustomColorsHOC(colorsArray) X-Ref

A higher-order component factory for creating a 'withCustomColors' HOC, which handles color logic
for class generation color value, retrieval and color attribute setting.

Use this higher-order component to work with a custom set of colors.

param: {Array} colorsArray The array of color objects (name, slug, color, etc... ).
return: {Function} Higher-order component.

withColors() X-Ref

A higher-order component, which handles color logic for class generation color value, retrieval and color attribute setting.

For use with the default editor/theme color palette.

param: {...(Object|string)} colorTypes The arguments can be strings or objects. If the argument is an object,
return: {Function} Higher-order component.

useBlockEditContext() X-Ref

A hook that returns the block edit context.

return: {Object} Block edit context

BlockEdit() X-Ref

No description

__experimentalGetGradientClass(gradientSlug) X-Ref

Internal dependencies

getGradientValueBySlug(gradients, slug) X-Ref

No description

__experimentalGetGradientObjectByGradientValue(gradients, value) X-Ref

No description

getGradientSlugByValue(gradients, value) X-Ref

No description

__experimentalUseGradient() X-Ref

No description

VisualLabel(_ref) X-Ref

No description

ColorGradientControlInner(_ref2) X-Ref

No description

ColorGradientControlSelect(props) X-Ref

No description

ColorGradientControl(props) X-Ref

No description

ContrastCheckerMessage(_ref) X-Ref

No description

ContrastChecker(_ref2) X-Ref

No description

__experimentalUseColors(colorConfigs) X-Ref

No description

getFontSizeClass(fontSizeSlug) X-Ref

Returns a class based on fontSizeName.

param: {string} fontSizeSlug Slug of the fontSize.
return: {string} String with the class corresponding to the fontSize passed.

_class(props) X-Ref

No description

AlignmentToolbar(props) X-Ref

No description

applyOrUnset(align) X-Ref

No description

withFilteredAutocompleters(Autocomplete) X-Ref

Wrap the default Autocomplete component with one that
supports a filter hook for customizing its list of autocompleters.

This function is exported for unit test.

param: {Function} Autocomplete Original component.
return: {Function} Wrapped component

BlockAlignmentToolbar(_ref) X-Ref

No description

applyOrUnset(align) X-Ref

No description

BlockTitle(_ref) X-Ref

Renders the block's configured title as a string, or empty if the title
cannot be determined.

param: {Object} props
param: {?string} props.name Block name.
return: {?string} Block title.

BlockIcon(_ref) X-Ref

WordPress dependencies

BlockDropZone() X-Ref

No description

insertAt(array, elements, index) X-Ref

Insert one or multiple elements into a given position of an array.

param: {Array}  array    Source array.
param: {*}      elements Elements to insert.
param: {number} index    Insert Position.
return: {Array}          Result.

moveTo(array, from, to) X-Ref

Moves an element in an array.

param: {Array}  array Source array.
param: {number} from  Source index.
param: {number} to    Destination index.
param: {number} count Number of elements to move.
return: {Array}       Result.

mapBlockOrder(blocks) X-Ref

Given an array of blocks, returns an object where each key is a nesting
context, the value of which is an array of block client IDs existing within
that nesting context.

param: {Array} blocks Blocks to map.
param: {?string} rootClientId Assumed root client ID.
return: {Object} Block order map object.

mapBlockParents(blocks) X-Ref

Given an array of blocks, returns an object where each key contains
the clientId of the block and the value is the parent of the block.

param: {Array} blocks Blocks to map.
param: {?string} rootClientId Assumed root client ID.
return: {Object} Block order map object.

flattenBlocks(blocks) X-Ref

Helper method to iterate through all blocks, recursing into inner blocks,
applying a transformation function to each one.
Returns a flattened object with the transformed blocks.

param: {Array} blocks Blocks to flatten.
param: {Function} transform Transforming function to be applied to each block.
return: {Object} Flattened object.

getFlattenedBlocksWithoutAttributes(blocks) X-Ref

Given an array of blocks, returns an object containing all blocks, without
attributes, recursing into inner blocks. Keys correspond to the block client
ID, the value of which is the attributes object.

param: {Array} blocks Blocks to flatten.
return: {Object} Flattened block attributes object.

getFlattenedBlockAttributes(blocks) X-Ref

Given an array of blocks, returns an object containing all block attributes,
recursing into inner blocks. Keys correspond to the block client ID, the
value of which is the attributes object.

param: {Array} blocks Blocks to flatten.
return: {Object} Flattened block attributes object.

getNestedBlockClientIds(blocksOrder) X-Ref

Given a block order map object, returns *all* of the block client IDs that are
a descendant of the given root client ID.

Calling this with `rootClientId` set to `''` results in a list of client IDs
that are in the post. That is, it excludes blocks like fetched reusable
blocks which are stored into state but not visible.

param: {Object} blocksOrder Object that maps block client IDs to a list of
param: {?string} rootClientId The root client ID to search. Defaults to ''.
return: {Array} List of descendant client IDs.

getMutateSafeObject(original, working) X-Ref

Returns an object against which it is safe to perform mutating operations,
given the original object and its current working copy.

param: {Object} original Original object.
param: {Object} working Working object.
return: {Object} Mutation-safe object.

hasSameKeys(a, b) X-Ref

Returns true if the two object arguments have the same keys, or false
otherwise.

param: {Object} a First object.
param: {Object} b Second object.
return: {boolean} Whether the two objects have the same keys.

isUpdatingSameBlockAttribute(action, lastAction) X-Ref

Returns true if, given the currently dispatching action and the previously
dispatched action, the two actions are updating the same block attribute, or
false otherwise.

param: {Object} action Currently dispatching action.
param: {Object} lastAction Previously dispatched action.
return: {boolean} Whether actions are updating the same block attribute.

withPersistentBlockChange(reducer) X-Ref

Higher-order reducer intended to augment the blocks reducer, assigning an
`isPersistentChange` property value corresponding to whether a change in
state can be considered as persistent. All changes are considered persistent
except when updating the same block attribute as in the previous action.

param: {Function} reducer Original reducer function.
return: {Function} Enhanced reducer function.

withIgnoredBlockChange(reducer) X-Ref

Higher-order reducer intended to augment the blocks reducer, assigning an
`isIgnoredChange` property value corresponding to whether a change in state
can be considered as ignored. A change is considered ignored when the result
of an action not incurred by direct user interaction.

param: {Function} reducer Original reducer function.
return: {Function} Enhanced reducer function.

reducer_isTyping() X-Ref

No description

reducer_isDraggingBlocks() X-Ref

Reducer returning dragging state.

param: {boolean} state Current state.
param: {Object} action Dispatched action.
return: {boolean} Updated state.

reducer_isCaretWithinFormattedText() X-Ref

Reducer returning whether the caret is within formatted text.

param: {boolean} state Current state.
param: {Object} action Dispatched action.
return: {boolean} Updated state.

reducer_selection() X-Ref

Internal helper reducer for selectionStart and selectionEnd. Can hold a block
selection, represented by an object with property clientId.

param: {Object} state Current state.
param: {Object} action Dispatched action.
return: {Object} Updated state.

reducer_selectionStart() X-Ref

Reducer returning the block selection's start.

param: {Object} state Current state.
param: {Object} action Dispatched action.
return: {Object} Updated state.

reducer_selectionEnd() X-Ref

Reducer returning the block selection's end.

param: {Object} state Current state.
param: {Object} action Dispatched action.
return: {Object} Updated state.

reducer_isMultiSelecting() X-Ref

Reducer returning whether the user is multi-selecting.

param: {boolean} state Current state.
param: {Object} action Dispatched action.
return: {boolean} Updated state.

reducer_isSelectionEnabled() X-Ref

Reducer returning whether selection is enabled.

param: {boolean} state Current state.
param: {Object} action Dispatched action.
return: {boolean} Updated state.

reducer_initialPosition(state, action) X-Ref

Reducer returning the intial block selection.

Currently this in only used to restore the selection after block deletion.
This reducer should eventually be removed in favour of setting selection
directly.

param: {boolean} state Current state.
param: {Object} action Dispatched action.
return: {?number} Initial position: -1 or undefined.

blocksMode() X-Ref

No description

insertionPoint() X-Ref

Reducer returning the block insertion point visibility, either null if there
is not an explicit insertion point assigned, or an object of its `index` and
`rootClientId`.

param: {Object} state Current state.
param: {Object} action Dispatched action.
return: {Object} Updated state.

reducer_template() X-Ref

Reducer returning whether the post blocks match the defined template or not.

param: {Object} state Current state.
param: {Object} action Dispatched action.
return: {boolean} Updated state.

reducer_settings() X-Ref

Reducer returning the editor setting.

param: {Object} state Current state.
param: {Object} action Dispatched action.
return: {Object} Updated state.

preferences() X-Ref

Reducer returning the user preferences.

param: {Object} state Current state.
param: {Object} action Dispatched action.
return: {string} Updated state.

reducer_isNavigationMode() X-Ref

Reducer returning whether the navigation mode is enabled or not.

param: {string} state Current state.
param: {Object} action Dispatched action.
return: {string} Updated state.

lastBlockAttributesChange(state, action) X-Ref

Reducer return an updated state representing the most recent block attribute
update. The state is structured as an object where the keys represent the
client IDs of blocks, the values a subset of attributes from the most recent
block update. The state is always reset to null if the last action is
anything other than an attributes update.

param: {Object<string,Object>} state Current state.
param: {Object} action Action object.
return: {[string,Object]} Updated state.

automaticChangeStatus(state, action) X-Ref

Reducer returning automatic change state.

param: {boolean} state Current state.
param: {Object} action Dispatched action.
return: {string} Updated state.

controls_select(storeName, selectorName) X-Ref

Calls a selector using the current state.

param: {string} storeName Store name.
param: {string} selectorName Selector name.
param: {Array} args Selector arguments.
return: {Object} control descriptor.

ensureDefaultBlock() X-Ref

Generator which will yield a default block insert action if there
are no other blocks at the root of the editor. This generator should be used
in actions which may result in no blocks remaining in the editor (removal,
replacement, etc).

actions_resetBlocks(blocks) X-Ref

Returns an action object used in signalling that blocks state should be
reset to the specified array of blocks, taking precedence over any other
content reflected as an edit in state.

param: {Array} blocks Array of blocks.
return: {Object} Action object.

actions_resetSelection(selectionStart, selectionEnd) X-Ref

Returns an action object used in signalling that selection state should be
reset to the specified selection.

param: {WPBlockSelection} selectionStart The selection start.
param: {WPBlockSelection} selectionEnd The selection end.
return: {Object} Action object.

receiveBlocks(blocks) X-Ref

Returns an action object used in signalling that blocks have been received.
Unlike resetBlocks, these should be appended to the existing known set, not
replacing.

param: {Object[]} blocks Array of block objects.
return: {Object} Action object.

actions_updateBlockAttributes(clientId, attributes) X-Ref

Returns an action object used in signalling that the block attributes with
the specified client ID has been updated.

param: {string} clientId Block client ID.
param: {Object} attributes Block attributes to be merged.
return: {Object} Action object.

actions_updateBlock(clientId, updates) X-Ref

Returns an action object used in signalling that the block with the
specified client ID has been updated.

param: {string} clientId Block client ID.
param: {Object} updates Block attributes to be merged.
return: {Object} Action object.

actions_selectBlock(clientId) X-Ref

Returns an action object used in signalling that the block with the
specified client ID has been selected, optionally accepting a position
value reflecting its selection directionality. An initialPosition of -1
reflects a reverse selection.

param: {string} clientId Block client ID.
param: {?number} initialPosition Optional initial position. Pass as -1 to
return: {Object} Action object.

selectPreviousBlock(clientId) X-Ref

Yields action objects used in signalling that the block preceding the given
clientId should be selected.

param: {string} clientId Block client ID.

selectNextBlock(clientId) X-Ref

Yields action objects used in signalling that the block following the given
clientId should be selected.

param: {string} clientId Block client ID.

actions_startMultiSelect() X-Ref

Returns an action object used in signalling that a block multi-selection has started.

return: {Object} Action object.

actions_stopMultiSelect() X-Ref

Returns an action object used in signalling that block multi-selection stopped.

return: {Object} Action object.

actions_multiSelect(start, end) X-Ref

Returns an action object used in signalling that block multi-selection changed.

param: {string} start First block of the multi selection.
param: {string} end Last block of the multiselection.
return: {Object} Action object.

actions_clearSelectedBlock() X-Ref

Returns an action object used in signalling that the block selection is cleared.

return: {Object} Action object.

actions_toggleSelection() X-Ref

Returns an action object that enables or disables block selection.

param: {boolean} [isSelectionEnabled=true] Whether block selection should
return: {Object} Action object.

getBlocksWithDefaultStylesApplied(blocks, blockEditorSettings) X-Ref

No description

actions_replaceBlocks(clientIds, blocks, indexToSelect) X-Ref

Returns an action object signalling that a blocks should be replaced with
one or more replacement blocks.

param: {(string|string[])} clientIds     Block client ID(s) to replace.
param: {(Object|Object[])} blocks        Replacement block(s).
param: {number}            indexToSelect Index of replacement block to

replaceBlock(clientId, block) X-Ref

Returns an action object signalling that a single block should be replaced
with one or more replacement blocks.

param: {(string|string[])} clientId Block client ID to replace.
param: {(Object|Object[])} block Replacement block(s).
return: {Object} Action object.

createOnMove(type) X-Ref

Higher-order action creator which, given the action type to dispatch creates
an action creator for managing block movement.

param: {string} type Action type to dispatch.
return: {Function} Action creator.

moveBlockToPosition(clientId) X-Ref

Returns an action object signalling that an indexed block should be moved
to a new index.

param: {?string} clientId         The client ID of the block.
param: {?string} fromRootClientId Root client ID source.
param: {?string} toRootClientId   Root client ID destination.
param: {number}  index            The index to move the block into.

actions_insertBlock(block, index, rootClientId) X-Ref

Returns an action object used in signalling that a single block should be
inserted, optionally at a specific index respective a root block list.

param: {Object}  block            Block object to insert.
param: {?number} index            Index at which block should be inserted.
param: {?string} rootClientId     Optional root client ID of block list on which to insert.
param: {?boolean} updateSelection If true block selection will be updated. If false, block selection will not change. Defaults to true.
return: {Object} Action object.

actions_insertBlocks(blocks, index, rootClientId) X-Ref

Returns an action object used in signalling that an array of blocks should
be inserted, optionally at a specific index respective a root block list.

param: {Object[]} blocks          Block objects to insert.
param: {?number}  index           Index at which block should be inserted.
param: {?string}  rootClientId    Optional root client ID of block list on which to insert.
param: {?boolean} updateSelection If true block selection will be updated.  If false, block selection will not change. Defaults to true.
return: {Object} Action object.

actions_showInsertionPoint(rootClientId, index) X-Ref

Returns an action object used in signalling that the insertion point should
be shown.

param: {?string} rootClientId Optional root client ID of block list on
param: {?number} index Index at which block should be inserted.
return: {Object} Action object.

actions_hideInsertionPoint() X-Ref

Returns an action object hiding the insertion point.

return: {Object} Action object.

setTemplateValidity(isValid) X-Ref

Returns an action object resetting the template validity.

param: {boolean} isValid template validity flag.
return: {Object} Action object.

synchronizeTemplate() X-Ref

Returns an action object synchronize the template with the list of blocks

return: {Object} Action object.

actions_mergeBlocks(firstBlockClientId, secondBlockClientId) X-Ref

Returns an action object used in signalling that two blocks should be merged

param: {string} firstBlockClientId Client ID of the first block to merge.
param: {string} secondBlockClientId Client ID of the second block to merge.
return: {Object} Action object.

actions_removeBlocks(clientIds) X-Ref

Yields action objects used in signalling that the blocks corresponding to
the set of specified client IDs are to be removed.

param: {string|string[]} clientIds Client IDs of blocks to remove.
param: {boolean} selectPrevious True if the previous block should be

actions_removeBlock(clientId, selectPrevious) X-Ref

Returns an action object used in signalling that the block with the
specified client ID is to be removed.

param: {string} clientId Client ID of block to remove.
param: {boolean} selectPrevious True if the previous block should be
return: {Object} Action object.

actions_replaceInnerBlocks(rootClientId, blocks) X-Ref

Returns an action object used in signalling that the inner blocks with the
specified client ID should be replaced.

param: {string} rootClientId Client ID of the block whose InnerBlocks will re replaced.
param: {Object[]} blocks Block objects to insert as new InnerBlocks
param: {?boolean} updateSelection If true block selection will be updated. If false, block selection will not change. Defaults to true.
return: {Object} Action object.

toggleBlockMode(clientId) X-Ref

Returns an action object used to toggle the block editing mode between
visual and HTML modes.

param: {string} clientId Block client ID.
return: {Object} Action object.

startTyping() X-Ref

Returns an action object used in signalling that the user has begun to type.

return: {Object} Action object.

stopTyping() X-Ref

Returns an action object used in signalling that the user has stopped typing.

return: {Object} Action object.

actions_startDraggingBlocks() X-Ref

Returns an action object used in signalling that the user has begun to drag blocks.

return: {Object} Action object.

actions_stopDraggingBlocks() X-Ref

Returns an action object used in signalling that the user has stopped dragging blocks.

return: {Object} Action object.

enterFormattedText() X-Ref

Returns an action object used in signalling that the caret has entered formatted text.

return: {Object} Action object.

exitFormattedText() X-Ref

Returns an action object used in signalling that the user caret has exited formatted text.

return: {Object} Action object.

selectionChange(clientId, attributeKey, startOffset, endOffset) X-Ref

Returns an action object used in signalling that the user caret has changed
position.

param: {string} clientId     The selected block client ID.
param: {string} attributeKey The selected block attribute key.
param: {number} startOffset  The start offset.
param: {number} endOffset    The end offset.
return: {Object} Action object.

actions_insertDefaultBlock(attributes, rootClientId, index) X-Ref

Returns an action object used in signalling that a new block of the default
type should be added to the block list.

param: {?Object} attributes Optional attributes of the block to assign.
param: {?string} rootClientId Optional root client ID of block list on which
param: {?number} index Optional index where to insert the default block
return: {Object} Action object

updateBlockListSettings(clientId, settings) X-Ref

Returns an action object that changes the nested settings of a given block.

param: {string} clientId Client ID of the block whose nested setting are
param: {Object} settings Object with the new settings for the nested block.
return: {Object} Action object

actions_updateSettings(settings) X-Ref

No description

__unstableSaveReusableBlock(id, updatedId) X-Ref

Returns an action object used in signalling that a temporary reusable blocks have been saved
in order to switch its temporary id with the real id.

param: {string} id Reusable block's id.
param: {string} updatedId Updated block's id.
return: {Object} Action object.

actions_unstableMarkLastChangeAsPersistent() X-Ref

Returns an action object used in signalling that the last block change should be marked explicitely as persistent.

return: {Object} Action object.

__unstableMarkAutomaticChange() X-Ref

Returns an action object used in signalling that the last block change is
an automatic change, meaning it was not performed by the user, and can be
undone using the `Escape` and `Backspace` keys. This action must be called
after the change was made, and any actions that are a consequence of it, so
it is recommended to be called at the next idle period to ensure all
selection changes have been recorded.

return: {Object} Action object.

actions_setNavigationMode() X-Ref

Generators that triggers an action used to enable or disable the navigation mode.

param: {string} isNavigationMode Enable/Disable navigation mode.

actions_duplicateBlocks(clientIds) X-Ref

Generator that triggers an action used to duplicate a list of blocks.

param: {string[]} clientIds

actions_insertBeforeBlock(clientId) X-Ref

Generator used to insert an empty block after a given block.

param: {string} clientId

actions_insertAfterBlock(clientId) X-Ref

Generator used to insert an empty block before a given block.

param: {string} clientId

selectors_getBlockName(state, clientId) X-Ref

Returns a block's name given its client ID, or null if no block exists with
the client ID.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {string} Block name.

selectors_isBlockValid(state, clientId) X-Ref

Returns whether a block is valid or not.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {boolean} Is Valid.

getBlockAttributes(state, clientId) X-Ref

Returns a block's attributes given its client ID, or null if no block exists with
the client ID.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {Object?} Block attributes.

selectors_getBlockCount(state, rootClientId) X-Ref

Returns the number of blocks currently present in the post.

param: {Object} state Editor state.
param: {?string} rootClientId Optional root client ID of block list.
return: {number} Number of blocks in the post.

selectors_getSelectionStart(state) X-Ref

Returns the current selection start block client ID, attribute key and text
offset.

param: {Object} state Block editor state.
return: {WPBlockSelection} Selection start information.

selectors_getSelectionEnd(state) X-Ref

Returns the current selection end block client ID, attribute key and text
offset.

param: {Object} state Block editor state.
return: {WPBlockSelection} Selection end information.

getBlockSelectionStart(state) X-Ref

Returns the current block selection start. This value may be null, and it
may represent either a singular block selection or multi-selection start.
A selection is singular if its start and end match.

param: {Object} state Global application state.
return: {?string} Client ID of block selection start.

getBlockSelectionEnd(state) X-Ref

Returns the current block selection end. This value may be null, and it
may represent either a singular block selection or multi-selection end.
A selection is singular if its start and end match.

param: {Object} state Global application state.
return: {?string} Client ID of block selection end.

selectors_getSelectedBlockCount(state) X-Ref

Returns the number of blocks currently selected in the post.

param: {Object} state Global application state.
return: {number} Number of blocks selected in the post.

hasSelectedBlock(state) X-Ref

Returns true if there is a single selected block, or false otherwise.

param: {Object} state Editor state.
return: {boolean} Whether a single block is selected.

selectors_getSelectedBlockClientId(state) X-Ref

Returns the currently selected block client ID, or null if there is no
selected block.

param: {Object} state Editor state.
return: {?string} Selected block client ID.

selectors_getSelectedBlock(state) X-Ref

Returns the currently selected block, or null if there is no selected block.

param: {Object} state Global application state.
return: {?Object} Selected block.

selectors_getBlockRootClientId(state, clientId) X-Ref

Given a block client ID, returns the root block from which the block is
nested, an empty string for top-level blocks, or null if the block does not
exist.

param: {Object} state Editor state.
param: {string} clientId Block from which to find root client ID.
return: {?string} Root client ID, if exists

getBlockHierarchyRootClientId(state, clientId) X-Ref

Given a block client ID, returns the root of the hierarchy from which the block is nested, return the block itself for root level blocks.

param: {Object} state Editor state.
param: {string} clientId Block from which to find root client ID.
return: {string} Root client ID

getLowestCommonAncestorWithSelectedBlock(state, clientId) X-Ref

Given a block client ID, returns the lowest common ancestor with selected client ID.

param: {Object} state Editor state.
param: {string} clientId Block from which to find common ancestor client ID.
return: {string} Common ancestor client ID or undefined

getAdjacentBlockClientId(state, startClientId) X-Ref

Returns the client ID of the block adjacent one at the given reference
startClientId and modifier directionality. Defaults start startClientId to
the selected block, and direction as next block. Returns null if there is no
adjacent block.

param: {Object} state Editor state.
param: {?string} startClientId Optional client ID of block from which to
param: {?number} modifier Directionality multiplier (1 next, -1
return: {?string} Return the client ID of the block, or null if none exists.

getPreviousBlockClientId(state, startClientId) X-Ref

Returns the previous block's client ID from the given reference start ID.
Defaults start to the selected block. Returns null if there is no previous
block.

param: {Object} state Editor state.
param: {?string} startClientId Optional client ID of block from which to
return: {?string} Adjacent block's client ID, or null if none exists.

getNextBlockClientId(state, startClientId) X-Ref

Returns the next block's client ID from the given reference start ID.
Defaults start to the selected block. Returns null if there is no next
block.

param: {Object} state Editor state.
param: {?string} startClientId Optional client ID of block from which to
return: {?string} Adjacent block's client ID, or null if none exists.

selectors_getSelectedBlocksInitialCaretPosition(state) X-Ref

Returns the initial caret position for the selected block.
This position is to used to position the caret properly when the selected block changes.

param: {Object} state Global application state.
return: {?Object} Selected block.

getMultiSelectedBlockClientIds(state) X-Ref

Returns the current multi-selection set of block client IDs, or an empty
array if there is no multi-selection.

param: {Object} state Editor state.
return: {Array} Multi-selected block client IDs.

getFirstMultiSelectedBlockClientId(state) X-Ref

Returns the client ID of the first block in the multi-selection set, or null
if there is no multi-selection.

param: {Object} state Editor state.
return: {?string} First block client ID in the multi-selection set.

getLastMultiSelectedBlockClientId(state) X-Ref

Returns the client ID of the last block in the multi-selection set, or null
if there is no multi-selection.

param: {Object} state Editor state.
return: {?string} Last block client ID in the multi-selection set.

selectors_isFirstMultiSelectedBlock(state, clientId) X-Ref

Returns true if a multi-selection exists, and the block corresponding to the
specified client ID is the first block of the multi-selection set, or false
otherwise.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {boolean} Whether block is first in multi-selection.

selectors_isBlockMultiSelected(state, clientId) X-Ref

Returns true if the client ID occurs within the block multi-selection, or
false otherwise.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {boolean} Whether block is in multi-selection set.

getMultiSelectedBlocksStartClientId(state) X-Ref

Returns the client ID of the block which begins the multi-selection set, or
null if there is no multi-selection.

This is not necessarily the first client ID in the selection.

param: {Object} state Editor state.
return: {?string} Client ID of block beginning multi-selection.

getMultiSelectedBlocksEndClientId(state) X-Ref

Returns the client ID of the block which ends the multi-selection set, or
null if there is no multi-selection.

This is not necessarily the last client ID in the selection.

param: {Object} state Editor state.
return: {?string} Client ID of block ending multi-selection.

selectors_getBlockOrder(state, rootClientId) X-Ref

Returns an array containing all block client IDs in the editor in the order
they appear. Optionally accepts a root client ID of the block list for which
the order should be returned, defaulting to the top-level block order.

param: {Object} state Editor state.
param: {?string} rootClientId Optional root client ID of block list.
return: {Array} Ordered client IDs of editor blocks.

selectors_getBlockIndex(state, clientId, rootClientId) X-Ref

Returns the index at which the block corresponding to the specified client
ID occurs within the block order, or `-1` if the block does not exist.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
param: {?string} rootClientId Optional root client ID of block list.
return: {number} Index at which block exists in order.

selectors_isBlockSelected(state, clientId) X-Ref

Returns true if the block corresponding to the specified client ID is
currently selected and no multi-selection exists, or false otherwise.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {boolean} Whether block is selected and multi-selection exists.

selectors_hasSelectedInnerBlock(state, clientId) X-Ref

Returns true if one of the block's inner blocks is selected.

param: {Object}  state    Editor state.
param: {string}  clientId Block client ID.
param: {boolean} deep     Perform a deep check.
return: {boolean} Whether the block as an inner block selected

isBlockWithinSelection(state, clientId) X-Ref

Returns true if the block corresponding to the specified client ID is
currently selected but isn't the last of the selected blocks. Here "last"
refers to the block sequence in the document, _not_ the sequence of
multi-selection, which is why `state.selectionEnd` isn't used.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {boolean} Whether block is selected and not the last in the

selectors_hasMultiSelection(state) X-Ref

Returns true if a multi-selection has been made, or false otherwise.

param: {Object} state Editor state.
return: {boolean} Whether multi-selection has been made.

selectors_isMultiSelecting(state) X-Ref

Whether in the process of multi-selecting or not. This flag is only true
while the multi-selection is being selected (by mouse move), and is false
once the multi-selection has been settled.

param: {Object} state Global application state.
return: {boolean} True if multi-selecting, false if not.

selectors_isSelectionEnabled(state) X-Ref

Selector that returns if multi-selection is enabled or not.

param: {Object} state Global application state.
return: {boolean} True if it should be possible to multi-select blocks, false if multi-selection is disabled.

selectors_getBlockMode(state, clientId) X-Ref

Returns the block's editing mode, defaulting to "visual" if not explicitly
assigned.

param: {Object} state Editor state.
param: {string} clientId Block client ID.
return: {Object} Block editing mode.

selectors_isTyping(state) X-Ref

Returns true if the user is typing, or false otherwise.

param: {Object} state Global application state.
return: {boolean} Whether user is typing.

selectors_isDraggingBlocks(state) X-Ref

Returns true if the user is dragging blocks, or false otherwise.

param: {Object} state Global application state.
return: {boolean} Whether user is dragging blocks.

selectors_isCaretWithinFormattedText(state) X-Ref

Returns true if the caret is within formatted text, or false otherwise.

param: {Object} state Global application state.
return: {boolean} Whether the caret is within formatted text.

getBlockInsertionPoint(state) X-Ref

Returns the insertion point, the index at which the new inserted block would
be placed. Defaults to the last index.

param: {Object} state Editor state.
return: {Object} Insertion point object with `rootClientId`, `index`.

isBlockInsertionPointVisible(state) X-Ref

Returns true if we should show the block insertion point.

param: {Object} state Global application state.
return: {?boolean} Whether the insertion point is visible or not.

isValidTemplate(state) X-Ref

Returns whether the blocks matches the template or not.

param: {boolean} state
return: {?boolean} Whether the template is valid or not.

getTemplate(state) X-Ref

Returns the defined block template

param: {boolean} state
return: {?Array} Block Template

selectors_getTemplateLock(state, rootClientId) X-Ref

Returns the defined block template lock. Optionally accepts a root block
client ID as context, otherwise defaulting to the global context.

param: {Object} state Editor state.
param: {?string} rootClientId Optional block root client ID.
return: {?string} Block Template Lock

getInsertUsage(state, id) X-Ref

Returns information about how recently and frequently a block has been inserted.

param: {Object} state Global application state.
param: {string} id A string which identifies the insert, e.g. 'core/block/12'
return: {?{ time: number, count: number }} An object containing `time` which is when the last

selectors_getBlockListSettings(state, clientId) X-Ref

Returns the Block List settings of a block, if any exist.

param: {Object} state Editor state.
param: {?string} clientId Block client ID.
return: {?Object} Block settings of the block if set.

selectors_getSettings(state) X-Ref

Returns the editor settings.

param: {Object} state Editor state.
return: {Object} The editor settings object.

selectors_isLastBlockChangePersistent(state) X-Ref

Returns true if the most recent block change is be considered persistent, or
false otherwise. A persistent change is one committed by BlockEditorProvider
via its `onChange` callback, in addition to `onInput`.

param: {Object} state Block editor state.
return: {boolean} Whether the most recent block change was persistent.

selectors_unstableIsLastBlockChangeIgnored(state) X-Ref

Returns true if the most recent block change is be considered ignored, or
false otherwise. An ignored change is one not to be committed by
BlockEditorProvider, neither via `onChange` nor `onInput`.

param: {Object} state Block editor state.
return: {boolean} Whether the most recent block change was ignored.

__experimentalGetLastBlockAttributeChanges(state) X-Ref

Returns the block attributes changed as a result of the last dispatched
action.

param: {Object} state Block editor state.
return: {Object<string,Object>} Subsets of block attributes changed, keyed

getReusableBlocks(state) X-Ref

Returns the available reusable blocks

param: {Object} state Global application state.
return: {Array} Reusable blocks

selectors_isNavigationMode(state) X-Ref

Returns whether the navigation mode is enabled.

param: {Object} state Editor state.
return: {boolean} Is navigation mode enabled.

selectors_didAutomaticChange(state) X-Ref

Returns true if the last change was an automatic change, false otherwise.

param: {Object} state Global application state.
return: {boolean} Whether the last change was automatic.

validateBlocksToTemplate(action, store) X-Ref

Block validity is a function of blocks state (at the point of a
reset) and the template setting. As a compromise to its placement
across distinct parts of state, it is implemented here as a side-
effect of the block reset action.

param: {Object} action RESET_BLOCKS action.
param: {Object} store Store instance.
return: {?Object} New validity set action if validity has changed.

applyMiddlewares(store) X-Ref

Applies the custom middlewares used specifically in the editor module.

param: {Object} store Store Object.
return: {Object} Update Store Object.

BlockEditorProvider() X-Ref

No description

Warning(_ref) X-Ref

No description

BlockCompare() X-Ref

No description

BlockInvalidWarning(props) X-Ref

No description

BlockCrashBoundary() X-Ref

No description

BlockHTML(_ref) X-Ref

No description

NavigableToolbar(_ref) X-Ref

No description

BlockContextualToolbar(_ref) X-Ref

No description

BlockInsertionPoint(_ref) X-Ref

Internal dependencies

onFocus(event) X-Ref

No description

onBlur() X-Ref

No description

IgnoreNestedEvents() X-Ref

No description

getBlockDOMNode(clientId) X-Ref

Given a block client ID, returns the corresponding DOM node for the block,
if exists. As much as possible, this helper should be avoided, and used only
in cases where isolated behaviors need remote access to a block node.

param: {string} clientId Block client ID.
param: {Element} scope an optional DOM Element to which the selector should be scoped
return: {Element} Block DOM node.

getBlockPreviewContainerDOMNode(clientId, scope) X-Ref

No description

getBlockFocusableWrapper(clientId) X-Ref

Given a block client ID, returns the corresponding DOM node for the block
focusable wrapper, if exists. As much as possible, this helper should be
avoided, and used only in cases where isolated behaviors need remote access
to a block node.

param: {string} clientId Block client ID.
return: {Element} Block DOM node.

isBlockFocusStop(element) X-Ref

Returns true if the given HTMLElement is a block focus stop. Blocks without
their own text fields rely on the focus stop to be keyboard navigable.

param: {HTMLElement} element Element to test.
return: {boolean} Whether element is a block focus stop.

isInSameBlock(a, b) X-Ref

Returns true if two elements are contained within the same block.

param: {HTMLElement} a First element.
param: {HTMLElement} b Second element.
return: {boolean} Whether elements are in the same block.

isInsideRootBlock(blockElement, element) X-Ref

Returns true if an elements is considered part of the block and not its children.

param: {HTMLElement} blockElement Block container element.
param: {HTMLElement} element Element.
return: {boolean} Whether element is in the block Element but not its children.

hasInnerBlocksContext(element) X-Ref

Returns true if the given HTMLElement contains inner blocks (an InnerBlocks
element).

param: {HTMLElement} element Element to test.
return: {boolean} Whether element contains inner blocks.

useMovingAnimation(ref, isSelected, adjustScrolling, enableAnimation, triggerAnimationOnChange) X-Ref

Hook used to compute the styles required to move a div into a new position.

The way this animation works is the following:
- It first renders the element as if there was no animation.
- It takes a snapshot of the position of the block to use it
as a destination point for the animation.
- It restores the element to the previous position using a CSS transform
- It uses the "resetAnimation" flag to reset the animation
from the beginning in order to animate to the new destination point.

param: {Object}  ref                      Reference to the element to animate.
param: {boolean} isSelected               Whether it's the current block or not.
param: {boolean} adjustScrolling          Adjust the scroll position to the current block.
param: {boolean} enableAnimation          Enable/Disable animation.
param: {*}       triggerAnimationOnChange Variable used to trigger the animation if it changes.
return: {Object} Style object.

block_BlockListBlock(_ref) X-Ref

No description

default_block_appender_DefaultBlockAppender(_ref) X-Ref

No description

BlockListAppender(_ref) X-Ref

No description

getDeepestNode(node, type) X-Ref

Returns for the deepest node at the start or end of a container node. Ignores
any text nodes that only contain HTML formatting whitespace.

param: {Element} node Container to search.
param: {string} type 'start' or 'end'.

useMultiSelection(_ref) X-Ref

No description

selector(select) X-Ref

No description

BlockList(_ref) X-Ref

No description

selector(select) X-Ref

No description

ScaledBlockPreview(_ref) X-Ref

No description

BlockPreview(_ref2) X-Ref

No description

InserterListItem(_ref) X-Ref

No description

BlockTypesList(_ref) X-Ref

No description

BlockCard(_ref) X-Ref

Internal dependencies

ChildBlocks(_ref) X-Ref

No description

InserterMenu() X-Ref

No description

getInsertionIndex() X-Ref

No description

Inserter() X-Ref

No description

getInsertionIndex() X-Ref

No description

button_block_appender_ButtonBlockAppender(_ref) X-Ref

No description

getBlockDisplayName(blockType, attributes) X-Ref

Get the block display name, if it has one, or the block title if it doesn't.

param: {Object} blockType The block type.
param: {Object} attributes The values of the block's attributes
return: {string} The display name value.

BlockNavigationList(_ref) X-Ref

No description

BlockNavigation(_ref) X-Ref

No description

BlockNavigationDropdownToggle(_ref) X-Ref

No description

BlockNavigationDropdown(_ref2) X-Ref

No description

BlockPatternPicker(_ref) X-Ref

No description

BlockVerticalAlignmentToolbar(_ref) X-Ref

No description

applyOrUnset(align) X-Ref

No description

ColorPaletteControl(_ref) X-Ref

Internal dependencies

GradientPickerWithGradients(props) X-Ref

No description

GradientPanel(props) X-Ref

Internal dependencies

InnerBlocks() X-Ref

No description

LinkControl(_ref) X-Ref

No description

MediaUploadCheck(_ref) X-Ref

No description

URLInput(props) X-Ref

No description

LinkEditor(_ref) X-Ref

Internal dependencies

LinkViewerUrl(_ref) X-Ref

No description

LinkViewer(_ref2) X-Ref

No description

URLPopover() X-Ref

No description

MediaPlaceholder() X-Ref

No description

ResponsiveBlockControlLabel(_ref) X-Ref

No description

ResponsiveBlockControl(props) X-Ref

No description

filePasteHandler(files) X-Ref

WordPress dependencies

RichTextShortcut() X-Ref

No description

RichTextToolbarButton(_ref) X-Ref

WordPress dependencies

__unstableRichTextInputEvent() X-Ref

No description

getMultilineTag(multiline) X-Ref

Get the multiline tag based on the multiline prop.

param: {?(string|boolean)} multiline The multiline prop.
return: {?string} The multiline tag.

RichTextWrapper() X-Ref

No description

ToolSelector() X-Ref

No description

URLInputButton() X-Ref

No description

getActiveStyle(styles, className) X-Ref

Returns the active style from the given className.

param: {Array} styles Block style variations.
param: {string} className Class name
return: {Object?} The active style.

replaceActiveStyle(className, activeStyle, newStyle) X-Ref

Replaces the active style in the block's className.

param: {string} className Class name.
param: {Object?} activeStyle The replaced style.
param: {Object} newStyle The replacing style.
return: {string} The updated className.

BlockStyles(_ref) X-Ref

No description

updateClassName(style) X-Ref

No description

MultiSelectionInspector(_ref) X-Ref

No description

DefaultStylePicker(_ref) X-Ref

No description

getBlockMoverDescription(selectedCount, type, firstIndex, isFirst, isLast, dir, orientation, isRTL) X-Ref

Return a label for the block movement controls depending on block position.

param: {number}  selectedCount Number of blocks selected.
param: {string}  type          Block type - in the case of a single block, should
param: {number}  firstIndex    The index (position - 1) of the first block selected.
param: {boolean} isFirst       This is the first block.
param: {boolean} isLast        This is the last block.
param: {number}  dir           Direction of movement (> 0 is considered to be going
param: {string}  orientation   The orientation of the block movers, vertical or
param: {boolean} isRTL         True if current writing system is right to left.
return: {string} Label for the block movement controls.

getMultiBlockMoverDescription(selectedCount, firstIndex, isFirst, isLast, dir) X-Ref

Return a label for the block movement controls depending on block position.

param: {number}  selectedCount Number of blocks selected.
param: {number}  firstIndex    The index (position - 1) of the first block selected.
param: {boolean} isFirst       This is the first block.
param: {boolean} isLast        This is the last block.
param: {number}  dir           Direction of movement (> 0 is considered to be going
return: {string} Label for the block movement controls.

BlockMover() X-Ref

No description

BlockSelectionClearer() X-Ref

No description

BlockActions(_ref) X-Ref

No description

BlockModeToggle(_ref) X-Ref

No description

BlockConvertButton(_ref) X-Ref

WordPress dependencies

BlockSettingsMenu(_ref) X-Ref

No description

BlockSwitcher() X-Ref

No description

MultiBlocksSwitcher(_ref) X-Ref

Internal dependencies

BlockToolbar(_ref) X-Ref

No description

getPasteEventData(_ref) X-Ref

WordPress dependencies

CopyHandler(_ref) X-Ref

No description

KeyboardShortcuts() X-Ref

No description

KeyboardShortcutsRegister() X-Ref

No description

MultiSelectScrollIntoView() X-Ref

Scrolls the multi block selection end into view if not in view already. This
is important to do after selection by keyboard.

isKeyDownEligibleForStartTyping(event) X-Ref

Returns true if a given keydown event can be inferred as intent to start
typing, or false otherwise. A keydown is considered eligible if it is a
text navigation without shift active.

param: {KeyboardEvent} event Keydown event to test.
return: {boolean} Whether event is eligible to start typing.

ObserveTyping() X-Ref

No description

PreserveScrollInReorder() X-Ref

WordPress dependencies

Typewriter() X-Ref

No description

onFocus() X-Ref

No description

isNavigationCandidate(element, keyCode, hasModifier) X-Ref

Returns true if the element should consider edge navigation upon a keyboard
event of the given directional key code, or false otherwise.

param: {Element} element HTML element to test.
param: {number} keyCode KeyboardEvent keyCode to test.
param: {boolean} hasModifier Whether a modifier is pressed.
return: {boolean} Whether element should consider edge navigation.

getClosestTabbable(target, isReverse, containerElement) X-Ref

Returns the optimal tab target from the given focused element in the
desired direction. A preference is made toward text fields, falling back
to the block focus stop if no other candidates exist for the block.

param: {Element} target Currently focused text field.
param: {boolean} isReverse True if considering as the first field.
param: {Element} containerElement Element containing all blocks.
return: {?Element} Optimal tab target, if one exists.

isTabCandidate(node, i, array) X-Ref

No description

writing_flow_selector(select) X-Ref

No description

WritingFlow(_ref) X-Ref

No description

onMouseDown() X-Ref

No description

expandSelection(isReverse) X-Ref

No description

moveSelection(isReverse) X-Ref

No description

isTabbableEdge(target, isReverse) X-Ref

Returns true if the given target field is the last in its block which
can be considered for tab transition. For example, in a block with two
text fields, this would return true when reversing from the first of the
two fields, but false when reversing from the second.

param: {Element} target Currently focused text field.
param: {boolean} isReverse True if considering as the first field.
return: {boolean} Whether field is at edge for tab transition.

onKeyDown(event) X-Ref

No description

focusLastTextField() X-Ref

No description

getValidAlignments(blockAlign) X-Ref

Returns the valid alignments.
Takes into consideration the aligns supported by a block, if the block supports wide controls or not and if theme supports wide controls or not.
Exported just for testing purposes, not exported outside the module.

param: {?boolean|string[]} blockAlign          Aligns supported by the block.
param: {?boolean}          hasWideBlockSupport True if block supports wide alignments. And False otherwise.
param: {?boolean}          hasWideEnabled      True if theme supports wide alignments. And False otherwise.
return: {string[]} Valid alignments.

addAttribute(settings) X-Ref

Filters registered block settings, extending attributes to include `align`.

param: {Object} settings Original block settings
return: {Object} Filtered block settings

addAssignedAlign(props, blockType, attributes) X-Ref

Override props assigned to save component to inject alignment class name if
block supports it.

param: {Object} props      Additional props applied to save element
param: {Object} blockType  Block type
param: {Object} attributes Block attributes
return: {Object}            Filtered props applied to save element

anchor_addAttribute(settings) X-Ref

Filters registered block settings, extending attributes with anchor using ID
of the first node.

param: {Object} settings Original block settings.
return: {Object} Filtered block settings.

addSaveProps(extraProps, blockType, attributes) X-Ref

Override props assigned to save component to inject anchor ID, if block
supports anchor. This is only applied if the block's save result is an
element and not a markup string.

param: {Object} extraProps Additional props applied to save element.
param: {Object} blockType Block type.
param: {Object} attributes Current block attributes.
return: {Object} Filtered props applied to save element.

custom_class_name_addAttribute(settings) X-Ref

Filters registered block settings, extending attributes with anchor using ID
of the first node.

param: {Object} settings Original block settings.
return: {Object} Filtered block settings.

custom_class_name_addSaveProps(extraProps, blockType, attributes) X-Ref

getHTMLRootElementClasses(innerHTML) X-Ref

Given an HTML string, returns an array of class names assigned to the root
element in the markup.

param: {string} innerHTML Markup string from which to extract classes.
return: {string[]} Array of class names assigned to the root element.

addParsedDifference(blockAttributes, blockType, innerHTML) X-Ref

Given a parsed set of block attributes, if the block supports custom class
names and an unknown class (per the block's serialization behavior) is
found, the unknown classes are treated as custom classes. This prevents the
block from being considered as invalid.

param: {Object} blockAttributes Original block attributes.
param: {Object} blockType Block type settings.
param: {string} innerHTML Original block markup.
return: {Object} Filtered block attributes.

addGeneratedClassName(extraProps, blockType) X-Ref

Override props assigned to save component to inject generated className if
block supports it. This is only applied if the block's save result is an
element and not a markup string.

param: {Object} extraProps Additional props applied to save element.
param: {Object} blockType Block type.
return: {Object} Filtered props applied to save element.

updatePosition(str) X-Ref

Update lineno and column based on `str`.

position() X-Ref

Mark position and patch `node.position`.

Position(start) X-Ref

Store position information for a node

error(msg) X-Ref

No description

stylesheet() X-Ref

Parse stylesheet.

open() X-Ref

Opening brace.

close() X-Ref

Closing brace.

rules() X-Ref

Parse ruleset.

match(re) X-Ref

Match `re` and return captures.

whitespace() X-Ref

Parse whitespace.

comments(accumulator) X-Ref

Parse comments;

comment() X-Ref

Parse comment.

selector() X-Ref

Parse selector.

declaration() X-Ref

Parse declaration.

declarations() X-Ref

Parse declarations.

keyframe() X-Ref

Parse keyframe.

atkeyframes() X-Ref

Parse keyframes.

atsupports() X-Ref

Parse supports.

athost() X-Ref

Parse host.

atmedia() X-Ref

Parse media.

atcustommedia() X-Ref

Parse custom-media.

atpage() X-Ref

Parse paged media.

atdocument() X-Ref

Parse document.

atfontface() X-Ref

Parse font-face.

_compileAtrule(name) X-Ref

Parse non-block at-rules

atrule() X-Ref

Parse at rule.

rule() X-Ref

Parse rule.

trim(str) X-Ref

Trim `str`.

addParent(obj, parent) X-Ref

Adds non-enumerable parent node reference to each node.

Compiler(opts) X-Ref

Initialize a compiler.

compress_Compiler(options) X-Ref

Initialize a new `Compiler`.

identity_Compiler(options) X-Ref

Initialize a new `Compiler`.

traverseCSS(css, callback) X-Ref

No description

isRemotePath(filePath) X-Ref

Return `true` if the given path is http/https.

param: {string} filePath path
return: {boolean} is remote path.

isAbsolutePath(filePath) X-Ref

Return `true` if the given filePath is an absolute url.

param: {string} filePath path
return: {boolean} is absolute path.

isValidURL(meta) X-Ref

Whether or not the url should be inluded.

param: {Object} meta url meta info
return: {boolean} is valid.

getResourcePath(str, baseURL) X-Ref

Get the absolute path of the url, relative to the basePath

param: {string} str          the url
param: {string} baseURL      base URL
return: {string}              the full path to the file

processURL(baseURL) X-Ref

Process the single `url()` pattern

param: {string} baseURL the base URL for relative URLs
return: {Promise} the Promise

getURLs(value) X-Ref

Get all `url()`s, and return the meta info

param: {string} value decl.value
return: {Array} the urls

replaceURLs(raw, URLs) X-Ref

Replace the raw value's `url()` segment to the new value

param: {string} raw  the raw value
param: {Array}  URLs the URLs to replace
return: {string}     the new value

_objectWithoutPropertiesLoose(source, excluded) X-Ref

No description

memoized( ) X-Ref

No description

asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) X-Ref

No description

_asyncToGenerator(fn) X-Ref

No description

_next(value) X-Ref

No description

_throw(err) X-Ref

No description

tinycolor(color, opts) X-Ref

No description

inputToRGB(color) X-Ref

No description

rgbToRgb(r, g, b) X-Ref

No description

rgbToHsl(r, g, b) X-Ref

No description

hslToRgb(h, s, l) X-Ref

No description

hue2rgb(p, q, t) X-Ref

No description

rgbToHsv(r, g, b) X-Ref

No description

hsvToRgb(h, s, v) X-Ref

No description

rgbToHex(r, g, b, allow3Char) X-Ref

No description

rgbaToHex(r, g, b, a, allow4Char) X-Ref

No description

rgbaToArgbHex(r, g, b, a) X-Ref

No description

desaturate(color, amount) X-Ref

No description

saturate(color, amount) X-Ref

No description

greyscale(color) X-Ref

No description

lighten(color, amount) X-Ref

No description

brighten(color, amount) X-Ref

No description

darken(color, amount) X-Ref

No description

spin(color, amount) X-Ref

No description

complement(color) X-Ref

No description

triad(color) X-Ref

No description

tetrad(color) X-Ref

No description

splitcomplement(color) X-Ref

No description

analogous(color, results, slices) X-Ref

No description

monochromatic(color, results) X-Ref

No description

flip(o) X-Ref

No description

boundAlpha(a) X-Ref

No description

bound01(n, max) X-Ref

No description

clamp01(val) X-Ref

No description

parseIntFromHex(val) X-Ref

No description

isOnePointZero(n) X-Ref

No description

isPercentage(n) X-Ref

No description

pad2(c) X-Ref

No description

convertToPercentage(n) X-Ref

No description

convertDecimalToHex(d) X-Ref

No description

convertHexToDecimal(h) X-Ref

No description

isValidCSSUnit(color) X-Ref

No description

stringInputToObject(color) X-Ref

No description

validateWCAG2Parms(parms) X-Ref

No description

_objectSpread(target) X-Ref

No description

_interopDefault(ex) X-Ref

No description

merge(target, lowercase) X-Ref

No description

useForceUpdate() X-Ref

No description

withDefault(value, defaultValue) X-Ref

No description

toArray(a) X-Ref

No description

callProp(obj) X-Ref

No description

getForwardProps(props) X-Ref

No description

interpolateTo(props) X-Ref

No description

handleRef(ref, forward) X-Ref

No description

Animated() X-Ref

No description

AnimatedArray() X-Ref

No description

AnimatedObject() X-Ref

No description

injectApplyAnimatedValues(fn, transform) X-Ref

No description

injectColorNames(names) X-Ref

No description

injectFrame(raf, caf) X-Ref

No description

injectStringInterpolator(fn) X-Ref

No description

injectNow(nowFn) X-Ref

No description

injectDefaultElement(el) X-Ref

No description

injectAnimatedApi(fn) X-Ref

No description

injectCreateAnimatedStyle(factory) X-Ref

No description

injectManualFrameloop(callback) X-Ref

No description

AnimatedProps(props, callback) X-Ref

No description

createInterpolator(range, output, extrapolate) X-Ref

No description

interpolate(input, inputMin, inputMax, outputMin, outputMax, easing, extrapolateLeft, extrapolateRight, map) X-Ref

No description

findRange(input, inputRange) X-Ref

No description

AnimatedInterpolation(parents, range, output, extrapolate) X-Ref

No description

useChain(refs, timeSteps, timeFrame) X-Ref

No description

addAnimatedStyles(node, styles) X-Ref

Animated works by building a directed acyclic graph of dependencies
transparently when you render your Animated components.

new Animated.Value(0)
.interpolate()        .interpolate()    new Animated.Value(1)
opacity               translateY      scale
style                         transform
View#234                         style
View#123

A) Top Down phase
When an AnimatedValue is updated, we recursively go down through this
graph in order to find leaf nodes: the views that we flag as needing
an update.

B) Bottom Up phase
When a view is flagged as needing an update, we recursively go back up
in order to build the new value that it needs. The reason why we need
this two-phases process is to deal with composite props such as
transform which can receive values from multiple parents.

AnimatedValue(_value) X-Ref

No description

AnimatedValueArray(values) X-Ref

No description

Controller() X-Ref

No description

useTransition(input, keyTransform, config) X-Ref

No description

cleanUp(state, filterKey) X-Ref

No description

diffItems(_ref9, props) X-Ref

No description