diff options
Diffstat (limited to 'wp-includes/js/dist/hooks.js')
-rw-r--r-- | wp-includes/js/dist/hooks.js | 594 |
1 files changed, 594 insertions, 0 deletions
diff --git a/wp-includes/js/dist/hooks.js b/wp-includes/js/dist/hooks.js new file mode 100644 index 0000000..43a4cd4 --- /dev/null +++ b/wp-includes/js/dist/hooks.js @@ -0,0 +1,594 @@ +/******/ (function() { // webpackBootstrap +/******/ "use strict"; +/******/ // The require scope +/******/ var __webpack_require__ = {}; +/******/ +/************************************************************************/ +/******/ /* webpack/runtime/define property getters */ +/******/ !function() { +/******/ // define getter functions for harmony exports +/******/ __webpack_require__.d = function(exports, definition) { +/******/ for(var key in definition) { +/******/ if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) { +/******/ Object.defineProperty(exports, key, { enumerable: true, get: definition[key] }); +/******/ } +/******/ } +/******/ }; +/******/ }(); +/******/ +/******/ /* webpack/runtime/hasOwnProperty shorthand */ +/******/ !function() { +/******/ __webpack_require__.o = function(obj, prop) { return Object.prototype.hasOwnProperty.call(obj, prop); } +/******/ }(); +/******/ +/******/ /* webpack/runtime/make namespace object */ +/******/ !function() { +/******/ // define __esModule on exports +/******/ __webpack_require__.r = function(exports) { +/******/ if(typeof Symbol !== 'undefined' && Symbol.toStringTag) { +/******/ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' }); +/******/ } +/******/ Object.defineProperty(exports, '__esModule', { value: true }); +/******/ }; +/******/ }(); +/******/ +/************************************************************************/ +var __webpack_exports__ = {}; +// ESM COMPAT FLAG +__webpack_require__.r(__webpack_exports__); + +// EXPORTS +__webpack_require__.d(__webpack_exports__, { + actions: function() { return /* binding */ actions; }, + addAction: function() { return /* binding */ addAction; }, + addFilter: function() { return /* binding */ addFilter; }, + applyFilters: function() { return /* binding */ applyFilters; }, + createHooks: function() { return /* reexport */ build_module_createHooks; }, + currentAction: function() { return /* binding */ currentAction; }, + currentFilter: function() { return /* binding */ currentFilter; }, + defaultHooks: function() { return /* binding */ defaultHooks; }, + didAction: function() { return /* binding */ didAction; }, + didFilter: function() { return /* binding */ didFilter; }, + doAction: function() { return /* binding */ doAction; }, + doingAction: function() { return /* binding */ doingAction; }, + doingFilter: function() { return /* binding */ doingFilter; }, + filters: function() { return /* binding */ filters; }, + hasAction: function() { return /* binding */ hasAction; }, + hasFilter: function() { return /* binding */ hasFilter; }, + removeAction: function() { return /* binding */ removeAction; }, + removeAllActions: function() { return /* binding */ removeAllActions; }, + removeAllFilters: function() { return /* binding */ removeAllFilters; }, + removeFilter: function() { return /* binding */ removeFilter; } +}); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/validateNamespace.js +/** + * Validate a namespace string. + * + * @param {string} namespace The namespace to validate - should take the form + * `vendor/plugin/function`. + * + * @return {boolean} Whether the namespace is valid. + */ +function validateNamespace(namespace) { + if ('string' !== typeof namespace || '' === namespace) { + // eslint-disable-next-line no-console + console.error('The namespace must be a non-empty string.'); + return false; + } + if (!/^[a-zA-Z][a-zA-Z0-9_.\-\/]*$/.test(namespace)) { + // eslint-disable-next-line no-console + console.error('The namespace can only contain numbers, letters, dashes, periods, underscores and slashes.'); + return false; + } + return true; +} +/* harmony default export */ var build_module_validateNamespace = (validateNamespace); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/validateHookName.js +/** + * Validate a hookName string. + * + * @param {string} hookName The hook name to validate. Should be a non empty string containing + * only numbers, letters, dashes, periods and underscores. Also, + * the hook name cannot begin with `__`. + * + * @return {boolean} Whether the hook name is valid. + */ +function validateHookName(hookName) { + if ('string' !== typeof hookName || '' === hookName) { + // eslint-disable-next-line no-console + console.error('The hook name must be a non-empty string.'); + return false; + } + if (/^__/.test(hookName)) { + // eslint-disable-next-line no-console + console.error('The hook name cannot begin with `__`.'); + return false; + } + if (!/^[a-zA-Z][a-zA-Z0-9_.-]*$/.test(hookName)) { + // eslint-disable-next-line no-console + console.error('The hook name can only contain numbers, letters, dashes, periods and underscores.'); + return false; + } + return true; +} +/* harmony default export */ var build_module_validateHookName = (validateHookName); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createAddHook.js +/** + * Internal dependencies + */ + + + +/** + * @callback AddHook + * + * Adds the hook to the appropriate hooks container. + * + * @param {string} hookName Name of hook to add + * @param {string} namespace The unique namespace identifying the callback in the form `vendor/plugin/function`. + * @param {import('.').Callback} callback Function to call when the hook is run + * @param {number} [priority=10] Priority of this hook + */ + +/** + * Returns a function which, when invoked, will add a hook. + * + * @param {import('.').Hooks} hooks Hooks instance. + * @param {import('.').StoreKey} storeKey + * + * @return {AddHook} Function that adds a new hook. + */ +function createAddHook(hooks, storeKey) { + return function addHook(hookName, namespace, callback, priority = 10) { + const hooksStore = hooks[storeKey]; + if (!build_module_validateHookName(hookName)) { + return; + } + if (!build_module_validateNamespace(namespace)) { + return; + } + if ('function' !== typeof callback) { + // eslint-disable-next-line no-console + console.error('The hook callback must be a function.'); + return; + } + + // Validate numeric priority + if ('number' !== typeof priority) { + // eslint-disable-next-line no-console + console.error('If specified, the hook priority must be a number.'); + return; + } + const handler = { + callback, + priority, + namespace + }; + if (hooksStore[hookName]) { + // Find the correct insert index of the new hook. + const handlers = hooksStore[hookName].handlers; + + /** @type {number} */ + let i; + for (i = handlers.length; i > 0; i--) { + if (priority >= handlers[i - 1].priority) { + break; + } + } + if (i === handlers.length) { + // If append, operate via direct assignment. + handlers[i] = handler; + } else { + // Otherwise, insert before index via splice. + handlers.splice(i, 0, handler); + } + + // We may also be currently executing this hook. If the callback + // we're adding would come after the current callback, there's no + // problem; otherwise we need to increase the execution index of + // any other runs by 1 to account for the added element. + hooksStore.__current.forEach(hookInfo => { + if (hookInfo.name === hookName && hookInfo.currentIndex >= i) { + hookInfo.currentIndex++; + } + }); + } else { + // This is the first hook of its type. + hooksStore[hookName] = { + handlers: [handler], + runs: 0 + }; + } + if (hookName !== 'hookAdded') { + hooks.doAction('hookAdded', hookName, namespace, callback, priority); + } + }; +} +/* harmony default export */ var build_module_createAddHook = (createAddHook); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createRemoveHook.js +/** + * Internal dependencies + */ + + + +/** + * @callback RemoveHook + * Removes the specified callback (or all callbacks) from the hook with a given hookName + * and namespace. + * + * @param {string} hookName The name of the hook to modify. + * @param {string} namespace The unique namespace identifying the callback in the + * form `vendor/plugin/function`. + * + * @return {number | undefined} The number of callbacks removed. + */ + +/** + * Returns a function which, when invoked, will remove a specified hook or all + * hooks by the given name. + * + * @param {import('.').Hooks} hooks Hooks instance. + * @param {import('.').StoreKey} storeKey + * @param {boolean} [removeAll=false] Whether to remove all callbacks for a hookName, + * without regard to namespace. Used to create + * `removeAll*` functions. + * + * @return {RemoveHook} Function that removes hooks. + */ +function createRemoveHook(hooks, storeKey, removeAll = false) { + return function removeHook(hookName, namespace) { + const hooksStore = hooks[storeKey]; + if (!build_module_validateHookName(hookName)) { + return; + } + if (!removeAll && !build_module_validateNamespace(namespace)) { + return; + } + + // Bail if no hooks exist by this name. + if (!hooksStore[hookName]) { + return 0; + } + let handlersRemoved = 0; + if (removeAll) { + handlersRemoved = hooksStore[hookName].handlers.length; + hooksStore[hookName] = { + runs: hooksStore[hookName].runs, + handlers: [] + }; + } else { + // Try to find the specified callback to remove. + const handlers = hooksStore[hookName].handlers; + for (let i = handlers.length - 1; i >= 0; i--) { + if (handlers[i].namespace === namespace) { + handlers.splice(i, 1); + handlersRemoved++; + // This callback may also be part of a hook that is + // currently executing. If the callback we're removing + // comes after the current callback, there's no problem; + // otherwise we need to decrease the execution index of any + // other runs by 1 to account for the removed element. + hooksStore.__current.forEach(hookInfo => { + if (hookInfo.name === hookName && hookInfo.currentIndex >= i) { + hookInfo.currentIndex--; + } + }); + } + } + } + if (hookName !== 'hookRemoved') { + hooks.doAction('hookRemoved', hookName, namespace); + } + return handlersRemoved; + }; +} +/* harmony default export */ var build_module_createRemoveHook = (createRemoveHook); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createHasHook.js +/** + * @callback HasHook + * + * Returns whether any handlers are attached for the given hookName and optional namespace. + * + * @param {string} hookName The name of the hook to check for. + * @param {string} [namespace] Optional. The unique namespace identifying the callback + * in the form `vendor/plugin/function`. + * + * @return {boolean} Whether there are handlers that are attached to the given hook. + */ +/** + * Returns a function which, when invoked, will return whether any handlers are + * attached to a particular hook. + * + * @param {import('.').Hooks} hooks Hooks instance. + * @param {import('.').StoreKey} storeKey + * + * @return {HasHook} Function that returns whether any handlers are + * attached to a particular hook and optional namespace. + */ +function createHasHook(hooks, storeKey) { + return function hasHook(hookName, namespace) { + const hooksStore = hooks[storeKey]; + + // Use the namespace if provided. + if ('undefined' !== typeof namespace) { + return hookName in hooksStore && hooksStore[hookName].handlers.some(hook => hook.namespace === namespace); + } + return hookName in hooksStore; + }; +} +/* harmony default export */ var build_module_createHasHook = (createHasHook); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createRunHook.js +/** + * Returns a function which, when invoked, will execute all callbacks + * registered to a hook of the specified type, optionally returning the final + * value of the call chain. + * + * @param {import('.').Hooks} hooks Hooks instance. + * @param {import('.').StoreKey} storeKey + * @param {boolean} [returnFirstArg=false] Whether each hook callback is expected to + * return its first argument. + * + * @return {(hookName:string, ...args: unknown[]) => undefined|unknown} Function that runs hook callbacks. + */ +function createRunHook(hooks, storeKey, returnFirstArg = false) { + return function runHooks(hookName, ...args) { + const hooksStore = hooks[storeKey]; + if (!hooksStore[hookName]) { + hooksStore[hookName] = { + handlers: [], + runs: 0 + }; + } + hooksStore[hookName].runs++; + const handlers = hooksStore[hookName].handlers; + + // The following code is stripped from production builds. + if (false) {} + if (!handlers || !handlers.length) { + return returnFirstArg ? args[0] : undefined; + } + const hookInfo = { + name: hookName, + currentIndex: 0 + }; + hooksStore.__current.push(hookInfo); + while (hookInfo.currentIndex < handlers.length) { + const handler = handlers[hookInfo.currentIndex]; + const result = handler.callback.apply(null, args); + if (returnFirstArg) { + args[0] = result; + } + hookInfo.currentIndex++; + } + hooksStore.__current.pop(); + if (returnFirstArg) { + return args[0]; + } + return undefined; + }; +} +/* harmony default export */ var build_module_createRunHook = (createRunHook); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createCurrentHook.js +/** + * Returns a function which, when invoked, will return the name of the + * currently running hook, or `null` if no hook of the given type is currently + * running. + * + * @param {import('.').Hooks} hooks Hooks instance. + * @param {import('.').StoreKey} storeKey + * + * @return {() => string | null} Function that returns the current hook name or null. + */ +function createCurrentHook(hooks, storeKey) { + return function currentHook() { + var _hooksStore$__current; + const hooksStore = hooks[storeKey]; + return (_hooksStore$__current = hooksStore.__current[hooksStore.__current.length - 1]?.name) !== null && _hooksStore$__current !== void 0 ? _hooksStore$__current : null; + }; +} +/* harmony default export */ var build_module_createCurrentHook = (createCurrentHook); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createDoingHook.js +/** + * @callback DoingHook + * Returns whether a hook is currently being executed. + * + * @param {string} [hookName] The name of the hook to check for. If + * omitted, will check for any hook being executed. + * + * @return {boolean} Whether the hook is being executed. + */ + +/** + * Returns a function which, when invoked, will return whether a hook is + * currently being executed. + * + * @param {import('.').Hooks} hooks Hooks instance. + * @param {import('.').StoreKey} storeKey + * + * @return {DoingHook} Function that returns whether a hook is currently + * being executed. + */ +function createDoingHook(hooks, storeKey) { + return function doingHook(hookName) { + const hooksStore = hooks[storeKey]; + + // If the hookName was not passed, check for any current hook. + if ('undefined' === typeof hookName) { + return 'undefined' !== typeof hooksStore.__current[0]; + } + + // Return the __current hook. + return hooksStore.__current[0] ? hookName === hooksStore.__current[0].name : false; + }; +} +/* harmony default export */ var build_module_createDoingHook = (createDoingHook); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createDidHook.js +/** + * Internal dependencies + */ + + +/** + * @callback DidHook + * + * Returns the number of times an action has been fired. + * + * @param {string} hookName The hook name to check. + * + * @return {number | undefined} The number of times the hook has run. + */ + +/** + * Returns a function which, when invoked, will return the number of times a + * hook has been called. + * + * @param {import('.').Hooks} hooks Hooks instance. + * @param {import('.').StoreKey} storeKey + * + * @return {DidHook} Function that returns a hook's call count. + */ +function createDidHook(hooks, storeKey) { + return function didHook(hookName) { + const hooksStore = hooks[storeKey]; + if (!build_module_validateHookName(hookName)) { + return; + } + return hooksStore[hookName] && hooksStore[hookName].runs ? hooksStore[hookName].runs : 0; + }; +} +/* harmony default export */ var build_module_createDidHook = (createDidHook); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/createHooks.js +/** + * Internal dependencies + */ + + + + + + + + +/** + * Internal class for constructing hooks. Use `createHooks()` function + * + * Note, it is necessary to expose this class to make its type public. + * + * @private + */ +class _Hooks { + constructor() { + /** @type {import('.').Store} actions */ + this.actions = Object.create(null); + this.actions.__current = []; + + /** @type {import('.').Store} filters */ + this.filters = Object.create(null); + this.filters.__current = []; + this.addAction = build_module_createAddHook(this, 'actions'); + this.addFilter = build_module_createAddHook(this, 'filters'); + this.removeAction = build_module_createRemoveHook(this, 'actions'); + this.removeFilter = build_module_createRemoveHook(this, 'filters'); + this.hasAction = build_module_createHasHook(this, 'actions'); + this.hasFilter = build_module_createHasHook(this, 'filters'); + this.removeAllActions = build_module_createRemoveHook(this, 'actions', true); + this.removeAllFilters = build_module_createRemoveHook(this, 'filters', true); + this.doAction = build_module_createRunHook(this, 'actions'); + this.applyFilters = build_module_createRunHook(this, 'filters', true); + this.currentAction = build_module_createCurrentHook(this, 'actions'); + this.currentFilter = build_module_createCurrentHook(this, 'filters'); + this.doingAction = build_module_createDoingHook(this, 'actions'); + this.doingFilter = build_module_createDoingHook(this, 'filters'); + this.didAction = build_module_createDidHook(this, 'actions'); + this.didFilter = build_module_createDidHook(this, 'filters'); + } +} + +/** @typedef {_Hooks} Hooks */ + +/** + * Returns an instance of the hooks object. + * + * @return {Hooks} A Hooks instance. + */ +function createHooks() { + return new _Hooks(); +} +/* harmony default export */ var build_module_createHooks = (createHooks); + +;// CONCATENATED MODULE: ./node_modules/@wordpress/hooks/build-module/index.js +/** + * Internal dependencies + */ + + +/** @typedef {(...args: any[])=>any} Callback */ + +/** + * @typedef Handler + * @property {Callback} callback The callback + * @property {string} namespace The namespace + * @property {number} priority The namespace + */ + +/** + * @typedef Hook + * @property {Handler[]} handlers Array of handlers + * @property {number} runs Run counter + */ + +/** + * @typedef Current + * @property {string} name Hook name + * @property {number} currentIndex The index + */ + +/** + * @typedef {Record<string, Hook> & {__current: Current[]}} Store + */ + +/** + * @typedef {'actions' | 'filters'} StoreKey + */ + +/** + * @typedef {import('./createHooks').Hooks} Hooks + */ + +const defaultHooks = build_module_createHooks(); +const { + addAction, + addFilter, + removeAction, + removeFilter, + hasAction, + hasFilter, + removeAllActions, + removeAllFilters, + doAction, + applyFilters, + currentAction, + currentFilter, + doingAction, + doingFilter, + didAction, + didFilter, + actions, + filters +} = defaultHooks; + + +(window.wp = window.wp || {}).hooks = __webpack_exports__; +/******/ })() +;
\ No newline at end of file |