@hkdigital/lib-core 0.3.1

package/dist/themes/hkdev/theme.css

@@ -0,0 +1,219 @@
+[data-theme='hkdev'] {
+  --text-scaling: 1.067;
+  --base-font-color: var(--color-surface-950);
+  --base-font-color-dark: var(--color-surface-50);
+  --base-font-family: mulish, system-ui, sans-serif;
+  --base-font-size: inherit;
+  --base-line-height: inherit;
+  --base-font-weight: normal;
+  --base-font-style: normal;
+  --base-letter-spacing: 0em;
+  --heading-font-color: var(--color-surface-950);
+  --heading-font-color-dark: var(--color-surface-50);
+  --heading-font-family: 'Guyot-Sans', system-ui, sans-serif;
+  --heading-font-weight: 900;
+  --heading-font-style: normal;
+  --heading-letter-spacing: inherit;
+  --anchor-font-color: var(--color-primary-500);
+  --anchor-font-color-dark: var(--color-primary-500);
+  --anchor-font-family: inherit;
+  --anchor-font-size: inherit;
+  --anchor-line-height: inherit;
+  --anchor-font-weight: inherit;
+  --anchor-font-style: inherit;
+  --anchor-letter-spacing: inherit;
+  --anchor-text-decoration: none;
+  --anchor-text-decoration-hover: underline;
+  --anchor-text-decoration-active: none;
+  --anchor-text-decoration-focus: none;
+  --spacing: 0.25rem;
+  --radius-base: 6px;
+  --radius-container: 12px;
+  --default-border-width: 1px;
+  --default-divide-width: 1px;
+  --default-ring-width: 1px;
+  --body-background-color: var(--color-surface-50);
+  --body-background-color-dark: var(--color-surface-950);
+  
+  /* Primary Colors */
+	--color-primary-50: oklch(100% 0 none);
+	--color-primary-100: oklch(89.21% 0.06 344.59deg);
+	--color-primary-200: oklch(79.1% 0.13 346.59deg);
+	--color-primary-300: oklch(70.14% 0.19 348.99deg);
+	--color-primary-400: oklch(63.52% 0.23 352.85deg);
+	--color-primary-500: oklch(59.83% 0.24 358.78deg);
+	--color-primary-600: oklch(55.33% 0.22 358.81deg);
+	--color-primary-700: oklch(50.94% 0.2 359.11deg);
+	--color-primary-800: oklch(46.26% 0.18 359.76deg);
+	--color-primary-900: oklch(41.75% 0.16 0.47deg);
+	--color-primary-950: oklch(37.02% 0.14 1.33deg);
+  --color-primary-contrast-dark: var(--color-primary-950);
+  --color-primary-contrast-light: var(--color-primary-50);
+  --color-primary-contrast-50: var(--color-primary-contrast-dark);
+  --color-primary-contrast-100: var(--color-primary-contrast-dark);
+  --color-primary-contrast-200: var(--color-primary-contrast-dark);
+  --color-primary-contrast-300: var(--color-primary-contrast-dark);
+  --color-primary-contrast-400: var(--color-primary-contrast-light);
+  --color-primary-contrast-500: var(--color-primary-contrast-light);
+  --color-primary-contrast-600: var(--color-primary-contrast-light);
+  --color-primary-contrast-700: var(--color-primary-contrast-light);
+  --color-primary-contrast-800: var(--color-primary-contrast-light);
+  --color-primary-contrast-900: var(--color-primary-contrast-light);
+  --color-primary-contrast-950: var(--color-primary-contrast-light);
+  
+  /* Secondary Colors */
+	--color-secondary-50: oklch(100% 0 none);
+	--color-secondary-100: oklch(92.02% 0.04 56.93deg);
+	--color-secondary-200: oklch(84.06% 0.08 54.85deg);
+	--color-secondary-300: oklch(76.66% 0.12 53.95deg);
+	--color-secondary-400: oklch(69.69% 0.15 50.67deg);
+	--color-secondary-500: oklch(63.83% 0.18 44.57deg);
+	--color-secondary-600: oklch(60.17% 0.18 43.16deg);
+	--color-secondary-700: oklch(56.48% 0.17 41.6deg);
+	--color-secondary-800: oklch(52.69% 0.16 40.52deg);
+	--color-secondary-900: oklch(48.91% 0.15 38.6deg);
+	--color-secondary-950: oklch(45.09% 0.15 36.44deg);
+  --color-secondary-contrast-dark: var(--color-secondary-950);
+  --color-secondary-contrast-light: var(--color-secondary-50);
+  --color-secondary-contrast-50: var(--color-secondary-contrast-dark);
+  --color-secondary-contrast-100: var(--color-secondary-contrast-dark);
+  --color-secondary-contrast-200: var(--color-secondary-contrast-dark);
+  --color-secondary-contrast-300: var(--color-secondary-contrast-dark);
+  --color-secondary-contrast-400: var(--color-secondary-contrast-light);
+  --color-secondary-contrast-500: var(--color-secondary-contrast-light);
+  --color-secondary-contrast-600: var(--color-secondary-contrast-light);
+  --color-secondary-contrast-700: var(--color-secondary-contrast-light);
+  --color-secondary-contrast-800: var(--color-secondary-contrast-light);
+  --color-secondary-contrast-900: var(--color-secondary-contrast-light);
+  --color-secondary-contrast-950: var(--color-secondary-contrast-light);
+  
+  /* Tertiary Colors */
+	--color-tertiary-50: oklch(100% 0 none);
+	--color-tertiary-100: oklch(91.02% 0.03 239.84deg);
+	--color-tertiary-200: oklch(81.89% 0.07 242.23deg);
+	--color-tertiary-300: oklch(73.25% 0.1 243.03deg);
+	--color-tertiary-400: oklch(64.86% 0.14 246.03deg);
+	--color-tertiary-500: oklch(57.51% 0.16 250.54deg);
+	--color-tertiary-600: oklch(53.76% 0.16 252.89deg);
+	--color-tertiary-700: oklch(49.99% 0.16 255.29deg);
+	--color-tertiary-800: oklch(46.26% 0.16 257.75deg);
+	--color-tertiary-900: oklch(42.46% 0.16 260.05deg);
+	--color-tertiary-950: oklch(38.66% 0.16 262.13deg);
+  --color-tertiary-contrast-dark: var(--color-tertiary-950);
+  --color-tertiary-contrast-light: var(--color-tertiary-50);
+  --color-tertiary-contrast-50: var(--color-tertiary-contrast-dark);
+  --color-tertiary-contrast-100: var(--color-tertiary-contrast-dark);
+  --color-tertiary-contrast-200: var(--color-tertiary-contrast-dark);
+  --color-tertiary-contrast-300: var(--color-tertiary-contrast-dark);
+  --color-tertiary-contrast-400: var(--color-tertiary-contrast-light);
+  --color-tertiary-contrast-500: var(--color-tertiary-contrast-light);
+  --color-tertiary-contrast-600: var(--color-tertiary-contrast-light);
+  --color-tertiary-contrast-700: var(--color-tertiary-contrast-light);
+  --color-tertiary-contrast-800: var(--color-tertiary-contrast-light);
+  --color-tertiary-contrast-900: var(--color-tertiary-contrast-light);
+  --color-tertiary-contrast-950: var(--color-tertiary-contrast-light);
+  
+  /* Success Colors */
+	--color-success-50: oklch(100% 0 none);
+	--color-success-100: oklch(92.84% 0.04 120.75deg);
+	--color-success-200: oklch(85.91% 0.08 122.19deg);
+	--color-success-300: oklch(78.79% 0.12 123.79deg);
+	--color-success-400: oklch(72.08% 0.15 125.47deg);
+	--color-success-500: oklch(65.33% 0.17 127.94deg);
+	--color-success-600: oklch(60.9% 0.16 127.69deg);
+	--color-success-700: oklch(56.39% 0.14 127.39deg);
+	--color-success-800: oklch(51.72% 0.13 127.41deg);
+	--color-success-900: oklch(47.01% 0.12 127.01deg);
+	--color-success-950: oklch(42.19% 0.1 126.49deg);
+  --color-success-contrast-dark: var(--color-success-950);
+  --color-success-contrast-light: var(--color-success-50);
+  --color-success-contrast-50: var(--color-success-contrast-dark);
+  --color-success-contrast-100: var(--color-success-contrast-dark);
+  --color-success-contrast-200: var(--color-success-contrast-dark);
+  --color-success-contrast-300: var(--color-success-contrast-dark);
+  --color-success-contrast-400: var(--color-success-contrast-dark);
+  --color-success-contrast-500: var(--color-success-contrast-light);
+  --color-success-contrast-600: var(--color-success-contrast-light);
+  --color-success-contrast-700: var(--color-success-contrast-light);
+  --color-success-contrast-800: var(--color-success-contrast-light);
+  --color-success-contrast-900: var(--color-success-contrast-light);
+  --color-success-contrast-950: var(--color-success-contrast-light);
+  
+  /* Warning Colors */
+	--color-warning-50: oklch(100% 0 none);
+	--color-warning-100: oklch(94.18% 0.04 94.27deg);
+	--color-warning-200: oklch(88.37% 0.08 95.33deg);
+	--color-warning-300: oklch(82.58% 0.11 94.03deg);
+	--color-warning-400: oklch(77.04% 0.13 93.57deg);
+	--color-warning-500: oklch(71.79% 0.14 90.64deg);
+	--color-warning-600: oklch(67.54% 0.14 90.18deg);
+	--color-warning-700: oklch(63.12% 0.13 88.36deg);
+	--color-warning-800: oklch(58.72% 0.12 87.66deg);
+	--color-warning-900: oklch(54.14% 0.11 85.27deg);
+	--color-warning-950: oklch(49.57% 0.1 84.14deg);
+  --color-warning-contrast-dark: var(--color-warning-950);
+  --color-warning-contrast-light: var(--color-warning-50);
+  --color-warning-contrast-50: var(--color-warning-contrast-dark);
+  --color-warning-contrast-100: var(--color-warning-contrast-dark);
+  --color-warning-contrast-200: var(--color-warning-contrast-dark);
+  --color-warning-contrast-300: var(--color-warning-contrast-dark);
+  --color-warning-contrast-400: var(--color-warning-contrast-dark);
+  --color-warning-contrast-500: var(--color-warning-contrast-light);
+  --color-warning-contrast-600: var(--color-warning-contrast-light);
+  --color-warning-contrast-700: var(--color-warning-contrast-light);
+  --color-warning-contrast-800: var(--color-warning-contrast-light);
+  --color-warning-contrast-900: var(--color-warning-contrast-light);
+  --color-warning-contrast-950: var(--color-warning-contrast-light);
+  
+  /* Error Colors */
+	--color-error-50: oklch(100% 0 none);
+	--color-error-100: oklch(90.1% 0.04 12.28deg);
+	--color-error-200: oklch(80.53% 0.09 12.75deg);
+	--color-error-300: oklch(71.54% 0.14 14.79deg);
+	--color-error-400: oklch(63.85% 0.18 17.92deg);
+	--color-error-500: oklch(58.16% 0.21 22.85deg);
+	--color-error-600: oklch(53.02% 0.19 22.7deg);
+	--color-error-700: oklch(47.67% 0.17 22.71deg);
+	--color-error-800: oklch(42.25% 0.15 22.49deg);
+	--color-error-900: oklch(36.57% 0.13 22.46deg);
+	--color-error-950: oklch(30.75% 0.11 22.06deg);
+  --color-error-contrast-dark: var(--color-error-950);
+  --color-error-contrast-light: var(--color-error-50);
+  --color-error-contrast-50: var(--color-error-contrast-dark);
+  --color-error-contrast-100: var(--color-error-contrast-dark);
+  --color-error-contrast-200: var(--color-error-contrast-dark);
+  --color-error-contrast-300: var(--color-error-contrast-dark);
+  --color-error-contrast-400: var(--color-error-contrast-dark);
+  --color-error-contrast-500: var(--color-error-contrast-light);
+  --color-error-contrast-600: var(--color-error-contrast-light);
+  --color-error-contrast-700: var(--color-error-contrast-light);
+  --color-error-contrast-800: var(--color-error-contrast-light);
+  --color-error-contrast-900: var(--color-error-contrast-light);
+  --color-error-contrast-950: var(--color-error-contrast-light);
+  
+  /* Surface Colors */
+	--color-surface-50: oklch(100% 0 none);
+	--color-surface-100: oklch(89.43% 0.04 261.71deg);
+	--color-surface-200: oklch(78.91% 0.09 261.69deg);
+	--color-surface-300: oklch(68.77% 0.13 260.58deg);
+	--color-surface-400: oklch(59% 0.18 260.54deg);
+	--color-surface-500: oklch(50.57% 0.22 261.54deg);
+	--color-surface-600: oklch(46.58% 0.2 261.41deg);
+	--color-surface-700: oklch(42.51% 0.18 261.24deg);
+	--color-surface-800: oklch(38.37% 0.16 261.17deg);
+	--color-surface-900: oklch(34.11% 0.13 260.96deg);
+	--color-surface-950: oklch(29.76% 0.11 260.7deg);
+  --color-surface-contrast-dark: var(--color-surface-950);
+  --color-surface-contrast-light: var(--color-surface-50);
+  --color-surface-contrast-50: var(--color-surface-contrast-dark);
+  --color-surface-contrast-100: var(--color-surface-contrast-dark);
+  --color-surface-contrast-200: var(--color-surface-contrast-dark);
+  --color-surface-contrast-300: var(--color-surface-contrast-dark);
+  --color-surface-contrast-400: var(--color-surface-contrast-light);
+  --color-surface-contrast-500: var(--color-surface-contrast-light);
+  --color-surface-contrast-600: var(--color-surface-contrast-light);
+  --color-surface-contrast-700: var(--color-surface-contrast-light);
+  --color-surface-contrast-800: var(--color-surface-contrast-light);
+  --color-surface-contrast-900: var(--color-surface-contrast-light);
+  --color-surface-contrast-950: var(--color-surface-contrast-light);
+}

package/dist/themes/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/themes/index.js

@@ -0,0 +1 @@
+export { default as hkdev } from './hkdev/theme.js';

package/dist/typedef/context.d.ts

@@ -0,0 +1,3 @@
+declare const _default: {};
+export default _default;
+export type ContextKey = Symbol | "default";

package/dist/typedef/context.js

@@ -0,0 +1,6 @@
+
+/**
+ * @typedef {Symbol|'default'} ContextKey
+ */
+
+export default {};

package/dist/typedef/drag.d.ts

@@ -0,0 +1,29 @@
+declare const _default: {};
+export default _default;
+export type DragData = {
+    draggableId: string;
+    offsetX: number;
+    offsetY: number;
+    /**
+     * - The item being dragged
+     */
+    item: any;
+    /**
+     * - Source identifier
+     */
+    source?: string;
+};
+export type SimulatedDragEvent = {
+    type: "dragstart" | "dragover" | "dragleave" | "drop" | "dragend";
+    clientX: number;
+    clientY: number;
+    dataTransfer: {
+        types: Array<string>;
+        getData: Function;
+        dropEffect: "none" | "copy" | "link" | "move";
+        effectAllowed: "none" | "copy" | "copyLink" | "copyMove" | "link" | "linkMove" | "move" | "all" | "uninitialized";
+        files: FileList | any[];
+    };
+    preventDefault: Function;
+    stopPropagation: Function;
+};

package/dist/typedef/drag.js

@@ -0,0 +1,25 @@
+/**
+ * @typedef {Object} DragData
+ * @property {string} draggableId
+ * @property {number} offsetX
+ * @property {number} offsetY
+ * @property {any} item - The item being dragged
+ * @property {string} [source] - Source identifier
+ */
+
+/**
+ * @typedef {Object} SimulatedDragEvent
+ * @property {'dragstart'|'dragover'|'dragleave'|'drop'|'dragend'} type
+ * @property {number} clientX
+ * @property {number} clientY
+ * @property {Object} dataTransfer
+ * @property {Array<string>} dataTransfer.types
+ * @property {Function} dataTransfer.getData
+ * @property {'none'|'copy'|'link'|'move'} dataTransfer.dropEffect
+ * @property {'none'|'copy'|'copyLink'|'copyMove'|'link'|'linkMove'|'move'|'all'|'uninitialized'} dataTransfer.effectAllowed
+ * @property {FileList|Array} dataTransfer.files
+ * @property {Function} preventDefault
+ * @property {Function} stopPropagation
+ */
+
+export default {}

package/dist/typedef/drop.d.ts

@@ -0,0 +1,15 @@
+declare const _default: {};
+export default _default;
+export type DropData = {
+    x: number;
+    y: number;
+    zone: string;
+    source: string;
+    item: any;
+    drag: import("./drag").DragData;
+    drop: {
+        offsetX: number;
+        offsetY: number;
+        target: Element;
+    };
+};

package/dist/typedef/drop.js

@@ -0,0 +1,12 @@
+/**
+ * @typedef {Object} DropData
+ * @property {number} x
+ * @property {number} y
+ * @property {string} zone
+ * @property {string} source
+ * @property {any} item
+ * @property {import('./drag').DragData} drag
+ * @property {{offsetX: number, offsetY: number, target: Element}} drop
+ */
+
+export default {};

package/dist/typedef/image.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {};
+export default _default;
+export type ImageMeta = {
+    src: string;
+    width: number;
+    height: number;
+};
+/**
+ * Single ImageMeta object or array of ImageMeta objects
+ */
+export type ImageSource = ImageMeta | ImageMeta[];
+export type ObjectPosition = "center" | "top" | "bottom" | "left" | "right" | "left top" | "left center" | "left bottom" | "center top" | "center center" | "center bottom" | "right top" | "right center" | "right bottom" | string;

package/dist/typedef/image.js

@@ -0,0 +1,38 @@
+/**
+ * @typedef {object} ImageMeta
+ * @property {string} src
+ * @property {number} width
+ * @property {number} height
+ */
+
+/**
+ * @typedef {ImageMeta | ImageMeta[]} ImageSource
+ * Single ImageMeta object or array of ImageMeta objects
+ */
+
+/**
+ * @typedef {"center" | "top" | "bottom" | "left" | "right" |
+ *          "left top" | "left center" | "left bottom" |
+ *          "center top" | "center center" | "center bottom" |
+ *          "right top" | "right center" | "right bottom" |
+ *          string} ObjectPosition
+ *
+ * @description Accepts valid CSS object-position values including:
+ * - Keywords: "center", "top", "bottom", "left", "right"
+ * - Length values: "10px", "2em", "50%", etc.
+ * - Percentage values: "25%", "100%", etc.
+ * - Two-value combinations: "left top", "center bottom", "25% 75%"
+ * - Mixed units: "left 20px", "10% center", "2em 50%"
+ *
+ * @example
+ * "center"           // Single keyword (centers both axes)
+ * "top"              // Single keyword
+ * "left center"      // Two keywords
+ * "25% 75%"          // Two percentages
+ * "10px 20px"        // Two lengths
+ * "left 25%"         // Keyword + percentage
+ * "50% top"          // Percentage + keyword
+ * "2em center"       // Length + keyword
+ */
+
+export default {};

package/dist/typedef/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./context.js";
+export * from "./drag.js";
+export * from "./drop.js";
+export * from "./image.js";

package/dist/typedef/index.js

@@ -0,0 +1,4 @@
+export * from './context.js';
+export * from './drag.js';
+export * from './drop.js';
+export * from './image.js';

package/dist/util/array/index.d.ts

@@ -0,0 +1,183 @@
+/**
+ * Convert a value to an array
+ * - Converts an Arguments object to plain JS array
+ * - If the value is undefined or null, an empty array is returned
+ * - A primitive value is "wrapped" in an array
+ *
+ * @param {any} value - Item to convert
+ *
+ * @param {number} [start]
+ *   Index of the array to start extraction.
+ *   (the first element of the array is at index 0)
+ *
+ * @param {number} [end]
+ *   Index of the array where the extraction should end
+ *
+ * --
+ *
+ * @returns {Array} array
+ *
+ * --
+ *
+ * @example
+ *   toArray( [ 1, 2, 3, 4, 5 ], 2, 4 ) returns [ 3, 4 ]
+ */
+export function toArray(value: any, start?: number, end?: number): any[];
+/**
+ * Convert an async iterator to an array
+ * - If no async iterator is passed, the value will be processed by `from()`
+ *
+ * @param {AsyncIterator|any} value
+ *   Async iterator or value to convert to array
+ *
+ * @returns {Promise<Array>} list of items returned by the iterator
+ */
+export function toArrayAsync(value: AsyncIterator<any, any, any> | any): Promise<any[]>;
+/**
+ * Convert a path string to an array path
+ * - The path string will be spit at the `pathSeparator` token
+ * - If the supplied path is already an array, the original array will
+ *   be returned
+ *
+ * @param {string|string[]} path
+ *   String or array path (e.g. "some.path.to")
+ *
+ * @param {string} [pathSeparator=PATH_SEPARATOR]
+ *   A custom path separator to use instead of the default "."
+ *
+ * @returns {string[]} array path (e.g. ["some", "path", "to"])
+ */
+export function toArrayPath(path: string | string[], pathSeparator?: string): string[];
+/**
+ * Push a value to an array if it is not null, undefined or an empty string
+ *
+ * @template {array} T
+ * @param {T} arr
+ * @param {any} value
+ *
+ * @returns {T} arr
+ */
+export function pushNotEmpty<T extends any[]>(arr: T, value: any): T;
+/**
+ * Loop over the supplied array and call the callback for every element
+ * - The callback will receive the current element of the array as
+ *   first argument
+ * - Via [additionalArguments], additional arguments may be supplied that
+ *   will be passed to the callback function
+ *
+ * @param {array} arr - The array to loop
+ * @param {function} callback - Callback to call for every element
+ * @param {array} additionalArguments  The additional arguments
+ */
+export function loop(arr: any[], callback: Function, additionalArguments: any[]): void;
+/**
+ * Get a list of all values from the items in the array at the
+ * specified path
+ *
+ * @param {object[]} items
+ *
+ * @param {object} [options]
+ *
+ * @param {boolean} [options.outputAsSet=false]
+ *   Output a Set instead of an array
+ *
+ * @param {string} [options.pathSeparator=PATH_SEPARATOR]
+ *   A custom path separator to use instead of the default "."
+ *
+ *
+ *
+ * @returns {any[]|Set<any>} values
+ */
+export function pathValues(items: object[], path: any, options?: {
+    outputAsSet?: boolean;
+    pathSeparator?: string;
+}): any[] | Set<any>;
+/**
+ * Sort function that sorts a list of objects by values encountered at the
+ * specified key values of the object.
+ * - Sorts array inline (no new array is returned)
+ * - This method is faster than `sortByPathValue` since the value lookup in the
+ *   items can be done faster
+ *
+ * @param {Object[]} items - List of items to sort
+ *
+ * @param {string} key
+ *   Object key to use for getting the values in the items to compare.
+ *
+ * @param {function} [compareFn=smallestFirst]
+ *   Function to use to compare values. See `compare.js`.
+ */
+export function sortByKeyValue(items: any[], key: string, compareFn?: Function): void;
+/**
+ * Sort function that sorts a list of objects by values encountered at the
+ * specified key values of the object.
+ * - Sorts array inline (no new array is returned)
+ * - This method is faster than `sortByPathValue` since the value lookup in the
+ *   items can be done faster
+ *
+ * @param {Object[]} items - List of items to sort
+ *
+ * @param {string} key
+ *   Object key to use for getting the values in the items to compare.
+ *
+ * @param {function} [compareFn=smallestFirst]
+ *   Function to use to compare values. See `compare.js`.
+ */
+export function sortByKeyValueReversed(items: any[], key: string, compareFn?: Function): void;
+/**
+ * Sort function that sorts a list of objects by values encountered at the
+ * specified object path.
+ * - Sorts array inline (no new array is returned)
+ *
+ * @param {Object[]} items - List of items to sort
+ *
+ * @param {string[]|string} path
+ *   Path to use for getting the values in the items to compare.
+ *   If a string path has been supplied, the default path separator
+ *   (PATH_SEPARATOR) is assumed. Use `toArrayPath` to convert paths with
+ *   custom path separators.
+ *
+ * @param {function} [compareFn=smallestFirst]
+ *   Function to use to compare values. See `compare.js`.
+ */
+export function sortByPathValue(items: any[], path: string[] | string, compareFn?: Function): void;
+/**
+ * Find the first item in the list of objects that matches the selector
+ * - All items in the supplied array must be objects
+ *
+ * @template {object} T
+ * @param {T[]} arr
+ * @param {object|null} selector
+ *
+ * @returns {T|null} first matched item
+ */
+export function findFirst<T extends unknown>(arr: T[], selector: object | null): T | null;
+/**
+ * Returns all items from the list of items that match the selector
+ * - All items in the supplied array must be objects
+ *
+ * @template {object} T
+ * @param {T[]} arr
+ * @param {object|null} selector
+ *
+ * @returns {T[]} matching items
+ */
+export function findAll<T extends unknown>(arr: T[], selector: object | null): T[];
+/**
+ * Convert array to an object using a list of keys for each index
+ *
+ * @param {array} arr
+ * @param {string[]} keys
+ *
+ * @returns {object}
+ */
+export function arrayToObject(arr: any[], keys: string[]): object;
+export { PATH_SEPARATOR } from "../object/index.js";
+import { smallestFirst } from '../compare/index.js';
+import { largestFirst } from '../compare/index.js';
+export const arraySlice: (start?: number, end?: number) => any[];
+export const arrayConcat: {
+    (...items: ConcatArray<any>[]): any[];
+    (...items: any[]): any[];
+};
+export { smallestFirst, largestFirst };