summaryrefslogtreecommitdiffstats
path: root/wp-includes/js/dist/hooks.js
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-17 07:56:49 +0000
commita415c29efee45520ae252d2aa28f1083a521cd7b (patch)
treef4ade4b6668ecc0765de7e1424f7c1427ad433ff /wp-includes/js/dist/hooks.js
parentInitial commit. (diff)
downloadwordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.tar.xz
wordpress-a415c29efee45520ae252d2aa28f1083a521cd7b.zip
Adding upstream version 6.4.3+dfsg1.upstream/6.4.3+dfsg1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'wp-includes/js/dist/hooks.js')
-rw-r--r--wp-includes/js/dist/hooks.js594
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