@atlaskit/pragmatic-drag-and-drop 1.1.10 → 1.1.12

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @atlaskit/pragmatic-drag-and-drop
 
+## 1.1.12
+
+### Patch Changes
+
+- [#109670](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/109670)
+  [`8eb3fe4136d55`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/8eb3fe4136d55) -
+  Internal consolidation of `once()` code
+
+## 1.1.11
+
+### Patch Changes
+
+- [#107751](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/107751)
+  [`ac9352b7e0ce`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/ac9352b7e0ce) -
+  Fixing timing issue with `preventUnhandled()` introduced in the prior release.
+  `preventUnhandled.stop()` called inside of `onDrop()` will now correctly cancel a native `"drop"`
+  event.
+
 ## 1.1.10
 
 ### Patch Changes

package/LICENSE.md

@@ -1,13 +1,11 @@
 Copyright 2022 Atlassian Pty Ltd
 
-Licensed under the Apache License, Version 2.0 (the "License");
-you may not use this file except in compliance with the License.
-You may obtain a copy of the License at
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in
+compliance with the License. You may obtain a copy of the License at
 
     http://www.apache.org/licenses/LICENSE-2.0
 
-Unless required by applicable law or agreed to in writing, software
-distributed under the License is distributed on an "AS IS" BASIS,
-WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-See the License for the specific language governing permissions and
-limitations under the License.
+Unless required by applicable law or agreed to in writing, software distributed under the License is
+distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied. See the License for the specific language governing permissions and limitations under the
+License.

package/dist/cjs/public-utils/prevent-unhandled.js

@@ -25,6 +25,7 @@ function acceptDrop(event) {
   event.preventDefault();
 }
 var unbindEvents = null;
+
 /**
  * Block drag operations outside of `@atlaskit/pragmatic-drag-and-drop`
  */
@@ -76,7 +77,30 @@ function cleanup() {
  * ```
  */
 
+function stop() {
+  var _window$event;
+  /**
+   * if `stop()` is called in a `"drop"` event, then `event.preventDefault()` won't be called.
+   * Our `"drop"` listener calls `event.preventDefault()` for handled drop events
+   * ("drop" events caused by dropping over a drop target)
+   * `preventUnhandled()` causes every element to become a drop target (according to the browser)
+   *
+   * To opt out of the default behaviour for a `"drop"` event, we need to make sure
+   * that we cancel it.
+   *
+   * The `"drop"` event listener in core is in the `capture` phase, so people calling
+   * `preventUnhandled.stop()` in `onDrop()` will remove the `"drop"` event listener in this
+   * file before it has the chance to cancel the event.
+   *
+   * Being sneaky and using the `window.event` global to sniff out the current event
+   */
+  if (((_window$event = window.event) === null || _window$event === void 0 ? void 0 : _window$event.type) === 'drop') {
+    var _window$event2;
+    (_window$event2 = window.event) === null || _window$event2 === void 0 || _window$event2.preventDefault();
+  }
+  cleanup();
+}
 var preventUnhandled = exports.preventUnhandled = {
   start: start,
-  stop: cleanup
+  stop: stop
 };

package/dist/cjs/util/android.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.isAndroid = exports.androidFallbackText = void 0;
-var _cacheFirst = require("./cache-first");
+var _once = require("../public-utils/once");
 // using `cache` as our `isAndroid()` result will not change in a browser
-var isAndroid = exports.isAndroid = (0, _cacheFirst.cacheFirst)(function isAndroid() {
+var isAndroid = exports.isAndroid = (0, _once.once)(function isAndroid() {
   return navigator.userAgent.toLocaleLowerCase().includes('android');
 });
 var androidFallbackText = exports.androidFallbackText = 'pdnd:android-fallback';

package/dist/cjs/util/is-firefox.js

@@ -4,13 +4,13 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.isFirefox = void 0;
-var _cacheFirst = require("./cache-first");
+var _once = require("../public-utils/once");
 // using `cache` as our `isFirefox()` result will not change in a browser
 
 /**
  * Returns `true` if a `Firefox` browser
  * */
-var isFirefox = exports.isFirefox = (0, _cacheFirst.cacheFirst)(function isFirefox() {
+var isFirefox = exports.isFirefox = (0, _once.once)(function isFirefox() {
   if (process.env.NODE_ENV === 'test') {
     return false;
   }

package/dist/cjs/util/is-safari.js

@@ -4,14 +4,14 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.isSafari = void 0;
-var _cacheFirst = require("./cache-first");
+var _once = require("../public-utils/once");
 // using `cache` as our `isSafari()` result will not change in a browser
 
 /**
  * Returns `true` if a `Safari` browser.
  * Returns `true` if the browser is running on iOS (they are all Safari).
  * */
-var isSafari = exports.isSafari = (0, _cacheFirst.cacheFirst)(function isSafari() {
+var isSafari = exports.isSafari = (0, _once.once)(function isSafari() {
   if (process.env.NODE_ENV === 'test') {
     return false;
   }

package/dist/es2019/public-utils/prevent-unhandled.js

@@ -17,6 +17,7 @@ function acceptDrop(event) {
   event.preventDefault();
 }
 let unbindEvents = null;
+
 /**
  * Block drag operations outside of `@atlaskit/pragmatic-drag-and-drop`
  */
@@ -68,7 +69,30 @@ function cleanup() {
  * ```
  */
 
+function stop() {
+  var _window$event;
+  /**
+   * if `stop()` is called in a `"drop"` event, then `event.preventDefault()` won't be called.
+   * Our `"drop"` listener calls `event.preventDefault()` for handled drop events
+   * ("drop" events caused by dropping over a drop target)
+   * `preventUnhandled()` causes every element to become a drop target (according to the browser)
+   *
+   * To opt out of the default behaviour for a `"drop"` event, we need to make sure
+   * that we cancel it.
+   *
+   * The `"drop"` event listener in core is in the `capture` phase, so people calling
+   * `preventUnhandled.stop()` in `onDrop()` will remove the `"drop"` event listener in this
+   * file before it has the chance to cancel the event.
+   *
+   * Being sneaky and using the `window.event` global to sniff out the current event
+   */
+  if (((_window$event = window.event) === null || _window$event === void 0 ? void 0 : _window$event.type) === 'drop') {
+    var _window$event2;
+    (_window$event2 = window.event) === null || _window$event2 === void 0 ? void 0 : _window$event2.preventDefault();
+  }
+  cleanup();
+}
 export const preventUnhandled = {
   start,
-  stop: cleanup
+  stop
 };

package/dist/es2019/util/android.js

@@ -1,7 +1,7 @@
-import { cacheFirst } from './cache-first';
+import { once } from '../public-utils/once';
 
 // using `cache` as our `isAndroid()` result will not change in a browser
-export const isAndroid = cacheFirst(function isAndroid() {
+export const isAndroid = once(function isAndroid() {
   return navigator.userAgent.toLocaleLowerCase().includes('android');
 });
 export const androidFallbackText = 'pdnd:android-fallback';

package/dist/es2019/util/is-firefox.js

@@ -1,11 +1,11 @@
-import { cacheFirst } from './cache-first';
+import { once } from '../public-utils/once';
 
 // using `cache` as our `isFirefox()` result will not change in a browser
 
 /**
  * Returns `true` if a `Firefox` browser
  * */
-export const isFirefox = cacheFirst(function isFirefox() {
+export const isFirefox = once(function isFirefox() {
   if (process.env.NODE_ENV === 'test') {
     return false;
   }

package/dist/es2019/util/is-safari.js

@@ -1,4 +1,4 @@
-import { cacheFirst } from './cache-first';
+import { once } from '../public-utils/once';
 
 // using `cache` as our `isSafari()` result will not change in a browser
 
@@ -6,7 +6,7 @@ import { cacheFirst } from './cache-first';
  * Returns `true` if a `Safari` browser.
  * Returns `true` if the browser is running on iOS (they are all Safari).
  * */
-export const isSafari = cacheFirst(function isSafari() {
+export const isSafari = once(function isSafari() {
   if (process.env.NODE_ENV === 'test') {
     return false;
   }

package/dist/esm/public-utils/prevent-unhandled.js

@@ -18,6 +18,7 @@ function acceptDrop(event) {
   event.preventDefault();
 }
 var unbindEvents = null;
+
 /**
  * Block drag operations outside of `@atlaskit/pragmatic-drag-and-drop`
  */
@@ -69,7 +70,30 @@ function cleanup() {
  * ```
  */
 
+function stop() {
+  var _window$event;
+  /**
+   * if `stop()` is called in a `"drop"` event, then `event.preventDefault()` won't be called.
+   * Our `"drop"` listener calls `event.preventDefault()` for handled drop events
+   * ("drop" events caused by dropping over a drop target)
+   * `preventUnhandled()` causes every element to become a drop target (according to the browser)
+   *
+   * To opt out of the default behaviour for a `"drop"` event, we need to make sure
+   * that we cancel it.
+   *
+   * The `"drop"` event listener in core is in the `capture` phase, so people calling
+   * `preventUnhandled.stop()` in `onDrop()` will remove the `"drop"` event listener in this
+   * file before it has the chance to cancel the event.
+   *
+   * Being sneaky and using the `window.event` global to sniff out the current event
+   */
+  if (((_window$event = window.event) === null || _window$event === void 0 ? void 0 : _window$event.type) === 'drop') {
+    var _window$event2;
+    (_window$event2 = window.event) === null || _window$event2 === void 0 || _window$event2.preventDefault();
+  }
+  cleanup();
+}
 export var preventUnhandled = {
   start: start,
-  stop: cleanup
+  stop: stop
 };

package/dist/esm/util/android.js

@@ -1,7 +1,7 @@
-import { cacheFirst } from './cache-first';
+import { once } from '../public-utils/once';
 
 // using `cache` as our `isAndroid()` result will not change in a browser
-export var isAndroid = cacheFirst(function isAndroid() {
+export var isAndroid = once(function isAndroid() {
   return navigator.userAgent.toLocaleLowerCase().includes('android');
 });
 export var androidFallbackText = 'pdnd:android-fallback';

package/dist/esm/util/is-firefox.js

@@ -1,11 +1,11 @@
-import { cacheFirst } from './cache-first';
+import { once } from '../public-utils/once';
 
 // using `cache` as our `isFirefox()` result will not change in a browser
 
 /**
  * Returns `true` if a `Firefox` browser
  * */
-export var isFirefox = cacheFirst(function isFirefox() {
+export var isFirefox = once(function isFirefox() {
   if (process.env.NODE_ENV === 'test') {
     return false;
   }

package/dist/esm/util/is-safari.js

@@ -1,4 +1,4 @@
-import { cacheFirst } from './cache-first';
+import { once } from '../public-utils/once';
 
 // using `cache` as our `isSafari()` result will not change in a browser
 
@@ -6,7 +6,7 @@ import { cacheFirst } from './cache-first';
  * Returns `true` if a `Safari` browser.
  * Returns `true` if the browser is running on iOS (they are all Safari).
  * */
-export var isSafari = cacheFirst(function isSafari() {
+export var isSafari = once(function isSafari() {
   if (process.env.NODE_ENV === 'test') {
     return false;
   }

package/dist/types/adapter/external-adapter.d.ts

@@ -1,5 +1,5 @@
 import { type BaseEventPayload, type CleanupFn, type DropTargetEventBasePayload, type DropTargetEventPayloadMap, type DropTargetGetFeedbackArgs, type EventPayloadMap, type ExternalDragType, type MonitorGetFeedbackArgs, type NativeMediaType } from '../internal-types';
-export declare function isAnAvailableType({ type, value, }: {
+export declare function isAnAvailableType({ type, value }: {
     type: string;
     value: string;
 }): boolean;

package/dist/types/entry-point/external/adapter.d.ts

@@ -1,3 +1,3 @@
-export { monitorForExternal, dropTargetForExternal, } from '../../adapter/external-adapter';
-export type { NativeMediaType, ExternalDragPayload, } from '../../internal-types';
+export { monitorForExternal, dropTargetForExternal } from '../../adapter/external-adapter';
+export type { NativeMediaType, ExternalDragPayload } from '../../internal-types';
 export type { ExternalEventBasePayload, ExternalEventPayloadMap, ElementDropTargetEventBasePayload, ExternalDropTargetEventPayloadMap, ExternalMonitorGetFeedbackArgs, ExternalDropTargetGetFeedbackArgs, } from '../../adapter/external-adapter';

package/dist/types/ledger/dispatch-consumer-event.d.ts

@@ -7,7 +7,7 @@ export declare function makeDispatch<DragType extends AllDragTypes>({ source, in
         payload: EventPayloadMap<DragType>[EventName];
     }) => void;
 }): {
-    start({ nativeSetDragImage, }: {
+    start({ nativeSetDragImage }: {
         nativeSetDragImage: DataTransfer['setDragImage'] | null;
     }): void;
     dragUpdate({ current }: {
@@ -19,8 +19,8 @@ export declare function makeDispatch<DragType extends AllDragTypes>({ source, in
     drop({ current, updatedSourcePayload, }: {
         current: DragLocation;
         /** When dragging from an external source, we need to collect the
-            drag source information again as it is often only available during
-            the "drop" event */
+      drag source information again as it is often only available during
+      the "drop" event */
         updatedSourcePayload: DragType['payload'] | null;
     }): void;
 };

package/dist/types/public-utils/element/custom-native-drag-preview/set-custom-native-drag-preview.d.ts

@@ -7,9 +7,9 @@ type CleanupFn = () => void;
 /** A function that will render a preview element into a `container` `HTMLElement` */
 type RenderFn = ({ container, }: {
     /** The `HTMLElement` that you need to render your preview element into.
-    `container` will be appended to the `document.body` and will be removed
-    after your `CleanupFn` is called
-    */
+  `container` will be appended to the `document.body` and will be removed
+  after your `CleanupFn` is called
+  */
     container: HTMLElement;
 }) => CleanupFn | void;
 /** This function provides the ability to mount an element for it to be used as the native drag preview

package/dist/types/public-utils/element/scroll-just-enough-into-view.d.ts

@@ -2,6 +2,6 @@
  * Scroll an `element` just enough into view so that the element becomes totally visible.
  * If the element is already totally visible then no scrolling will occur.
  */
-export declare function scrollJustEnoughIntoView({ element, }: {
+export declare function scrollJustEnoughIntoView({ element }: {
     element: Element;
 }): void;

package/dist/types/public-utils/prevent-unhandled.d.ts

@@ -2,7 +2,6 @@
  * Block drag operations outside of `@atlaskit/pragmatic-drag-and-drop`
  */
 declare function start(): void;
-declare function cleanup(): void;
 /**
  * TODO: for next major, we could look at do the following:
  *
@@ -12,8 +11,9 @@ declare function cleanup(): void;
  * + const stop = preventUnhandled();
  * ```
  */
+declare function stop(): void;
 export declare const preventUnhandled: {
     start: typeof start;
-    stop: typeof cleanup;
+    stop: typeof stop;
 };
 export {};

package/dist/types/util/android.d.ts

@@ -1,2 +1,2 @@
-export declare const isAndroid: () => boolean;
+export declare const isAndroid: (this: unknown) => boolean;
 export declare const androidFallbackText = "pdnd:android-fallback";

package/dist/types/util/changing-window/count-events-for-safari.d.ts

@@ -1,6 +1,6 @@
-export declare function isEnteringWindowInSafari({ dragEnter, }: {
+export declare function isEnteringWindowInSafari({ dragEnter }: {
     dragEnter: DragEvent;
 }): boolean;
-export declare function isLeavingWindowInSafari({ dragLeave, }: {
+export declare function isLeavingWindowInSafari({ dragLeave }: {
     dragLeave: DragEvent;
 }): boolean;

package/dist/types/util/changing-window/is-entering-window.d.ts

@@ -1,3 +1,3 @@
-export declare function isEnteringWindow({ dragEnter, }: {
+export declare function isEnteringWindow({ dragEnter }: {
     dragEnter: DragEvent;
 }): boolean;

package/dist/types/util/changing-window/is-leaving-window.d.ts

@@ -1,3 +1,3 @@
-export declare function isLeavingWindow({ dragLeave, }: {
+export declare function isLeavingWindow({ dragLeave }: {
     dragLeave: DragEvent;
 }): boolean;

package/dist/types/util/detect-broken-drag.d.ts

@@ -1,4 +1,4 @@
-export declare function getBindingsForBrokenDrags({ onDragEnd, }: {
+export declare function getBindingsForBrokenDrags({ onDragEnd }: {
     onDragEnd: () => void;
 }): readonly [{
     readonly type: "pointermove";

package/dist/types/util/is-firefox.d.ts

@@ -1,4 +1,4 @@
 /**
  * Returns `true` if a `Firefox` browser
  * */
-export declare const isFirefox: () => boolean;
+export declare const isFirefox: (this: unknown) => boolean;

package/dist/types/util/is-safari.d.ts

@@ -2,4 +2,4 @@
  * Returns `true` if a `Safari` browser.
  * Returns `true` if the browser is running on iOS (they are all Safari).
  * */
-export declare const isSafari: () => boolean;
+export declare const isSafari: (this: unknown) => boolean;

package/dist/types-ts4.5/adapter/external-adapter.d.ts

@@ -1,5 +1,5 @@
 import { type BaseEventPayload, type CleanupFn, type DropTargetEventBasePayload, type DropTargetEventPayloadMap, type DropTargetGetFeedbackArgs, type EventPayloadMap, type ExternalDragType, type MonitorGetFeedbackArgs, type NativeMediaType } from '../internal-types';
-export declare function isAnAvailableType({ type, value, }: {
+export declare function isAnAvailableType({ type, value }: {
     type: string;
     value: string;
 }): boolean;

package/dist/types-ts4.5/entry-point/external/adapter.d.ts

@@ -1,3 +1,3 @@
-export { monitorForExternal, dropTargetForExternal, } from '../../adapter/external-adapter';
-export type { NativeMediaType, ExternalDragPayload, } from '../../internal-types';
+export { monitorForExternal, dropTargetForExternal } from '../../adapter/external-adapter';
+export type { NativeMediaType, ExternalDragPayload } from '../../internal-types';
 export type { ExternalEventBasePayload, ExternalEventPayloadMap, ElementDropTargetEventBasePayload, ExternalDropTargetEventPayloadMap, ExternalMonitorGetFeedbackArgs, ExternalDropTargetGetFeedbackArgs, } from '../../adapter/external-adapter';

package/dist/types-ts4.5/ledger/dispatch-consumer-event.d.ts

@@ -7,7 +7,7 @@ export declare function makeDispatch<DragType extends AllDragTypes>({ source, in
         payload: EventPayloadMap<DragType>[EventName];
     }) => void;
 }): {
-    start({ nativeSetDragImage, }: {
+    start({ nativeSetDragImage }: {
         nativeSetDragImage: DataTransfer['setDragImage'] | null;
     }): void;
     dragUpdate({ current }: {
@@ -19,8 +19,8 @@ export declare function makeDispatch<DragType extends AllDragTypes>({ source, in
     drop({ current, updatedSourcePayload, }: {
         current: DragLocation;
         /** When dragging from an external source, we need to collect the
-            drag source information again as it is often only available during
-            the "drop" event */
+      drag source information again as it is often only available during
+      the "drop" event */
         updatedSourcePayload: DragType['payload'] | null;
     }): void;
 };

package/dist/types-ts4.5/public-utils/element/custom-native-drag-preview/set-custom-native-drag-preview.d.ts

@@ -7,9 +7,9 @@ type CleanupFn = () => void;
 /** A function that will render a preview element into a `container` `HTMLElement` */
 type RenderFn = ({ container, }: {
     /** The `HTMLElement` that you need to render your preview element into.
-    `container` will be appended to the `document.body` and will be removed
-    after your `CleanupFn` is called
-    */
+  `container` will be appended to the `document.body` and will be removed
+  after your `CleanupFn` is called
+  */
     container: HTMLElement;
 }) => CleanupFn | void;
 /** This function provides the ability to mount an element for it to be used as the native drag preview

package/dist/types-ts4.5/public-utils/element/scroll-just-enough-into-view.d.ts

@@ -2,6 +2,6 @@
  * Scroll an `element` just enough into view so that the element becomes totally visible.
  * If the element is already totally visible then no scrolling will occur.
  */
-export declare function scrollJustEnoughIntoView({ element, }: {
+export declare function scrollJustEnoughIntoView({ element }: {
     element: Element;
 }): void;

package/dist/types-ts4.5/public-utils/prevent-unhandled.d.ts

@@ -2,7 +2,6 @@
  * Block drag operations outside of `@atlaskit/pragmatic-drag-and-drop`
  */
 declare function start(): void;
-declare function cleanup(): void;
 /**
  * TODO: for next major, we could look at do the following:
  *
@@ -12,8 +11,9 @@ declare function cleanup(): void;
  * + const stop = preventUnhandled();
  * ```
  */
+declare function stop(): void;
 export declare const preventUnhandled: {
     start: typeof start;
-    stop: typeof cleanup;
+    stop: typeof stop;
 };
 export {};

package/dist/types-ts4.5/util/android.d.ts

@@ -1,2 +1,2 @@
-export declare const isAndroid: () => boolean;
+export declare const isAndroid: (this: unknown) => boolean;
 export declare const androidFallbackText = "pdnd:android-fallback";

package/dist/types-ts4.5/util/changing-window/count-events-for-safari.d.ts

@@ -1,6 +1,6 @@
-export declare function isEnteringWindowInSafari({ dragEnter, }: {
+export declare function isEnteringWindowInSafari({ dragEnter }: {
     dragEnter: DragEvent;
 }): boolean;
-export declare function isLeavingWindowInSafari({ dragLeave, }: {
+export declare function isLeavingWindowInSafari({ dragLeave }: {
     dragLeave: DragEvent;
 }): boolean;

package/dist/types-ts4.5/util/changing-window/is-entering-window.d.ts

@@ -1,3 +1,3 @@
-export declare function isEnteringWindow({ dragEnter, }: {
+export declare function isEnteringWindow({ dragEnter }: {
     dragEnter: DragEvent;
 }): boolean;

package/dist/types-ts4.5/util/changing-window/is-leaving-window.d.ts

@@ -1,3 +1,3 @@
-export declare function isLeavingWindow({ dragLeave, }: {
+export declare function isLeavingWindow({ dragLeave }: {
     dragLeave: DragEvent;
 }): boolean;

package/dist/types-ts4.5/util/detect-broken-drag.d.ts

@@ -1,4 +1,4 @@
-export declare function getBindingsForBrokenDrags({ onDragEnd, }: {
+export declare function getBindingsForBrokenDrags({ onDragEnd }: {
     onDragEnd: () => void;
 }): readonly [
     {

package/dist/types-ts4.5/util/is-firefox.d.ts

@@ -1,4 +1,4 @@
 /**
  * Returns `true` if a `Firefox` browser
  * */
-export declare const isFirefox: () => boolean;
+export declare const isFirefox: (this: unknown) => boolean;

package/dist/types-ts4.5/util/is-safari.d.ts

@@ -2,4 +2,4 @@
  * Returns `true` if a `Safari` browser.
  * Returns `true` if the browser is running on iOS (they are all Safari).
  * */
-export declare const isSafari: () => boolean;
+export declare const isSafari: (this: unknown) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/pragmatic-drag-and-drop",
-  "version": "1.1.10",
+  "version": "1.1.12",
   "description": "The core package for Pragmatic drag and drop - enabling fast drag and drop for any experience on any tech stack",
   "repository": "https://github.com/atlassian/pragmatic-drag-and-drop",
   "author": "Atlassian Pty Ltd",

package/report.api.md

@@ -2,7 +2,8 @@
 
 ## API Report File for "@atlaskit/pragmatic-drag-and-drop"
 
-> Do not edit this file. This report is auto-generated using [API Extractor](https://api-extractor.com/).
+> Do not edit this file. This report is auto-generated using
+> [API Extractor](https://api-extractor.com/).
 > [Learn more about API reports](https://hello.atlassian.net/wiki/spaces/UR/pages/1825484529/Package+API+Reports)
 
 ### Table of contents

package/dist/cjs/util/cache-first.js

@@ -1,31 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.cacheFirst = cacheFirst;
-/**
- * Create a new function that will cache the result of it's first call forever.
- * This is similar to `memoize-one`, except the cache for `memoize-one` can be
- * updated if the arguments change.
- *
- * @example
- * function sayHello(name: string): string {
- *   return `Hello ${name}`;
- * }
- * const cached = cacheFirst(sayHello);
- *
- * cached('Alex');
- * cached('Declan'); // original result of `sayHello` call is returned
- */
-function cacheFirst(fn) {
-  var result = null;
-  return function single() {
-    if (!result) {
-      result = {
-        value: fn.apply(void 0, arguments)
-      };
-    }
-    return result.value;
-  };
-}

package/dist/es2019/util/cache-first.js

@@ -1,25 +0,0 @@
-/**
- * Create a new function that will cache the result of it's first call forever.
- * This is similar to `memoize-one`, except the cache for `memoize-one` can be
- * updated if the arguments change.
- *
- * @example
- * function sayHello(name: string): string {
- *   return `Hello ${name}`;
- * }
- * const cached = cacheFirst(sayHello);
- *
- * cached('Alex');
- * cached('Declan'); // original result of `sayHello` call is returned
- */
-export function cacheFirst(fn) {
-  let result = null;
-  return function single(...args) {
-    if (!result) {
-      result = {
-        value: fn(...args)
-      };
-    }
-    return result.value;
-  };
-}

package/dist/esm/util/cache-first.js

@@ -1,25 +0,0 @@
-/**
- * Create a new function that will cache the result of it's first call forever.
- * This is similar to `memoize-one`, except the cache for `memoize-one` can be
- * updated if the arguments change.
- *
- * @example
- * function sayHello(name: string): string {
- *   return `Hello ${name}`;
- * }
- * const cached = cacheFirst(sayHello);
- *
- * cached('Alex');
- * cached('Declan'); // original result of `sayHello` call is returned
- */
-export function cacheFirst(fn) {
-  var result = null;
-  return function single() {
-    if (!result) {
-      result = {
-        value: fn.apply(void 0, arguments)
-      };
-    }
-    return result.value;
-  };
-}

package/dist/types/util/cache-first.d.ts

@@ -1,15 +0,0 @@
-/**
- * Create a new function that will cache the result of it's first call forever.
- * This is similar to `memoize-one`, except the cache for `memoize-one` can be
- * updated if the arguments change.
- *
- * @example
- * function sayHello(name: string): string {
- *   return `Hello ${name}`;
- * }
- * const cached = cacheFirst(sayHello);
- *
- * cached('Alex');
- * cached('Declan'); // original result of `sayHello` call is returned
- */
-export declare function cacheFirst<TFunc extends (...args: any[]) => any>(fn: TFunc): (...args: Parameters<TFunc>) => ReturnType<TFunc>;

package/dist/types-ts4.5/util/cache-first.d.ts

@@ -1,15 +0,0 @@
-/**
- * Create a new function that will cache the result of it's first call forever.
- * This is similar to `memoize-one`, except the cache for `memoize-one` can be
- * updated if the arguments change.
- *
- * @example
- * function sayHello(name: string): string {
- *   return `Hello ${name}`;
- * }
- * const cached = cacheFirst(sayHello);
- *
- * cached('Alex');
- * cached('Declan'); // original result of `sayHello` call is returned
- */
-export declare function cacheFirst<TFunc extends (...args: any[]) => any>(fn: TFunc): (...args: Parameters<TFunc>) => ReturnType<TFunc>;