@oracle/oraclejet-preact 14.0.0

package/types/utils/UNSAFE_keys/keys.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export declare type ImmutableSet<V> = {
+    size: number;
+    has(value: V): boolean;
+    values(): IterableIterator<V>;
+};
+/**
+ * Type for key set used mainly for selection and expansion
+ */
+export declare type Keys<K> = {
+    all: true;
+    keys?: never;
+    deletedKeys: ImmutableSet<K>;
+} | {
+    all: false;
+    keys: ImmutableSet<K>;
+    deletedKeys?: never;
+};
+/**
+ * Returns true if the key is contains in keys, false otherwise
+ */
+export declare const containsKey: <K>(keys: Keys<K>, key: K) => boolean;
+/**
+ * Returns a new Keys that includes the specified key.
+ * If the key is already in keys, then just return keys.
+ */
+export declare const addKey: <K>(keys: Keys<K>, key: K) => Keys<K>;
+/**
+ * Returns a new Keys that excludes the specified key.
+ * If the key is already in keys, then just return keys.
+ * disallowEmpty if set to true, will ensure that the returning keys will not be empty.
+ */
+export declare const removeKey: <K>(keys: Keys<K>, key: K, disallowEmpty: boolean) => Keys<K>;
+/**
+ * Helper function for checking for an undefined key
+ * Keys can be null or undefined when not set, but falsey check is not appropriate for this as 0 is a legitimate key
+ */
+export declare const isKeyDefined: <K>(key: K) => boolean;

package/types/utils/UNSAFE_lengthFilter/index.d.ts

@@ -0,0 +1 @@
+export * from './lengthFilter';

package/types/utils/UNSAFE_lengthFilter/lengthFilter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export declare type CountUnit = 'codePoint' | 'codeUnit';
+export declare function calcLength(text: string, countBy?: CountUnit): number;
+/**
+ * Filters the text based on the maximum length allowed.
+ *
+ * @param proposedText The proposed displayValue
+ * @param max The max characters allowed
+ * @param countBy The unit to be used for counting
+ * @returns The filtered display value
+ */
+export declare function filter(proposedText: string, max?: number, countBy?: CountUnit): string;

package/types/utils/UNSAFE_logger/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export * from './logger';

package/types/utils/UNSAFE_logger/logger.d.ts

@@ -0,0 +1 @@
+export declare const Logger: Pick<Console, "info" | "error" | "warn" | "log">;

package/types/utils/UNSAFE_matchTranslationBundle/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export * from './matchTranslationBundle';

package/types/utils/UNSAFE_matchTranslationBundle/matchTranslationBundle.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+/**
+ * @returns the best match for user's preferred locale or null if none is found
+ * @param preferredLocales - a list of user's preferred locales ordered from the most preferred to the least preferred
+ * @param supportedLocales - a set of locales supported by the application
+ * @ignore
+ */
+export declare function matchTranslationBundle(preferredLocales: Readonly<Array<string>>, supportedLocales: Set<string>): string | null;

package/types/utils/UNSAFE_mergeInterpolations/index.d.ts

@@ -0,0 +1 @@
+export * from './mergeInterpolations';

package/types/utils/UNSAFE_mergeInterpolations/mergeInterpolations.d.ts

@@ -0,0 +1,4 @@
+declare type Obj = Record<string, unknown>;
+declare type Interpolation<P> = (props: P) => Record<string, string> | object;
+declare const mergeInterpolations: <P extends Obj>(interpolations: Interpolation<P>[]) => (props: P) => Record<string, string>;
+export { mergeInterpolations };

package/types/utils/UNSAFE_mergeProps/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export * from './mergeProps';

package/types/utils/UNSAFE_mergeProps/mergeProps.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright (c) 2011 %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+declare type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
+/**
+ * Merges allProps together:
+ *  - duplicate className and class allProps concatenated
+ *  - duplicate style allProps merged - note that only style objects supported at this point
+ *  - duplicate functions chained
+ * @param allProps Props to merge together.
+ */
+export declare function mergeProps<T extends {
+    [key: string]: any;
+}[]>(...allProps: T): {
+    [K in keyof UnionToIntersection<T[number]>]: K extends 'class' ? string : K extends 'style' ? UnionToIntersection<T[number]>[K] : Exclude<Extract<T[number], {
+        [Q in K]: unknown;
+    }>[K], undefined>;
+};
+export {};

package/types/utils/UNSAFE_meterTypes/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export { Threshold, ReferenceLine, MeterSize, ThresholdDisplay, InputDetail, CommitDetail } from './meterTypes';

package/types/utils/UNSAFE_meterTypes/meterTypes.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export declare type MeterSize = 'sm' | 'md' | 'lg';
+export declare type ThresholdDisplay = 'all' | 'track' | 'indicator';
+export declare type Threshold = {
+    /**
+     * The max value of the threshold.
+     */
+    max: number;
+    /**
+     * The color for the threshold range.
+     */
+    color?: string;
+    /**
+     * The accessible label for the threshold range.
+     */
+    accessibleLabel?: string;
+};
+export declare type ReferenceLine = {
+    /**
+     * The color of the reference line.
+     */
+    color?: string;
+    /**
+     * The value of the reference line.
+     */
+    value: number;
+    /**
+     * The position of the reference line.
+     */
+    position?: 'start' | 'end';
+};
+export declare type CommitDetail = {
+    value: number;
+};
+export declare type InputDetail = {
+    value?: number;
+};

package/types/utils/UNSAFE_roles/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export * from './roles';

package/types/utils/UNSAFE_roles/roles.d.ts

@@ -0,0 +1,18 @@
+/**
+ * This file contains valid types and string literal arrays for aria roles
+ * https://www.w3.org/WAI/PF/aria/roles#role_definitions_header
+ */
+export declare type Role = typeof roles[number];
+export declare type CompositeWidgetRole = typeof compositeWidget[number];
+export declare type ContentRole = typeof content[number];
+export declare type LandmarkRole = typeof landmark[number];
+export declare type LiveRegionRole = typeof liveRegion[number];
+export declare type WidgetRole = typeof widget[number];
+declare const widget: ("button" | "checkbox" | "radio" | "menuitem" | "progressbar" | "tab" | "tabpanel" | "tooltip" | "treeitem" | "scrollbar" | "link" | "dialog" | "option" | "switch" | "gridcell" | "slider" | "textbox" | "menuitemcheckbox" | "menuitemradio" | "spinbutton" | "alertdialog")[];
+declare const button: ("checkbox" | "radio" | "menuitem" | "tab" | "link" | "switch" | "menuitemcheckbox" | "menuitemradio")[];
+declare const compositeWidget: ("listbox" | "grid" | "menu" | "menubar" | "treegrid" | "combobox" | "radiogroup" | "tablist" | "tree")[];
+declare const content: ("region" | "row" | "listitem" | "separator" | "toolbar" | "list" | "img" | "article" | "presentation" | "heading" | "group" | "columnheader" | "definition" | "directory" | "document" | "math" | "note" | "rowheader")[];
+declare const liveRegion: ("marquee" | "log" | "alert" | "status" | "timer")[];
+declare const landmark: ("form" | "search" | "main" | "banner" | "navigation" | "application" | "complementary" | "contentinfo")[];
+declare const roles: readonly ("button" | "checkbox" | "listbox" | "radio" | "region" | "grid" | "row" | "menu" | "listitem" | "menubar" | "menuitem" | "progressbar" | "separator" | "tab" | "tabpanel" | "toolbar" | "tooltip" | "treeitem" | "scrollbar" | "form" | "list" | "img" | "search" | "link" | "article" | "dialog" | "main" | "marquee" | "option" | "switch" | "banner" | "presentation" | "heading" | "log" | "group" | "alert" | "status" | "gridcell" | "slider" | "textbox" | "navigation" | "treegrid" | "menuitemcheckbox" | "menuitemradio" | "spinbutton" | "combobox" | "radiogroup" | "tablist" | "tree" | "application" | "columnheader" | "definition" | "directory" | "document" | "math" | "note" | "rowheader" | "complementary" | "contentinfo" | "timer" | "alertdialog")[];
+export { button, compositeWidget, content, landmark, liveRegion, widget };

package/types/utils/UNSAFE_selectUtils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export * from './selectUtils';

package/types/utils/UNSAFE_selectUtils/selectUtils.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+import { Item } from '../UNSAFE_dataProvider';
+export declare type ItemTextFunctionType<K, D> = (itemContext: Item<K, D>) => string;
+export declare type ItemTextType<K, D> = keyof D | ItemTextFunctionType<K, D>;

package/types/utils/UNSAFE_size/index.d.ts

@@ -0,0 +1 @@
+export * from './size';

package/types/utils/UNSAFE_size/size.d.ts

@@ -0,0 +1,8 @@
+export declare type Size = 0 | `--${string}` | `${number}%` | `${number}x` | `calc(${string})`;
+/**
+ * Given a value that is of type Size, transform the value into
+ * something that is usable in a css style property.
+ * @param {string | 0 } v - a value to transform
+ * @returns {string | 0}
+ */
+export declare const sizeToCSS: (v: Size) => string | 0;

package/types/utils/UNSAFE_soundUtils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export * from './soundUtils';

package/types/utils/UNSAFE_soundUtils/soundUtils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+/**
+ * Plays an audio using the URL specified.
+ *
+ * @param url The URL of the audio file
+ * @returns A promise that resolves when the audio is play or rejects if there are any issues
+ */
+export declare function playAudioFromURL(url: string): Promise<void | Error>;
+/**
+ * Plays a notification sound using WebAudio API
+ *
+ * @throws {Error} Throws an error if WebAudio is not supported
+ */
+export declare function playDefaultNotificationSound(): void;

package/types/utils/UNSAFE_stringUtils/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright (c) %FIRST_YEAR% %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+export * from './stringUtils';

package/types/utils/UNSAFE_stringUtils/stringUtils.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright (c) 2004 %CURRENT_YEAR%, Oracle and/or its affiliates.
+ * Licensed under The Universal Permissive License (UPL), Version 1.0
+ * as shown at https://oss.oracle.com/licenses/upl/
+ * @ignore
+ */
+/**
+ * Returns true if the value is null or if the trimmed value is of zero length.
+ *
+ * @param {Object|string|null} value
+ * @returns true if the string or Object (e.g., Array) is of zero length.
+ */
+export declare function isEmpty(value: object | string | null): boolean;
+/**
+ * Returns true if the value is null, undefined or if the trimmed value is of zero length.
+ *
+ * @param {Object|string|null=} value
+ * @returns true if the string or Object (e.g., Array) is of zero length.
+ */
+export declare function isEmptyOrUndefined(value?: object | string | null): boolean;
+/**
+ * Test if an object is a string (either a string constant or a string object)
+ * @param {Object|string|null} obj object to test
+ * @return true if a string constant or string object
+ */
+export declare function isString(obj: object | string | null): boolean;
+/**
+ * Remove leading and trailing whitespace
+ * @param {Object|string|null} data to trim
+ * @returns trimmed input
+ */
+export declare function trim(data: object | string | null): string | object | null;
+/**
+ * Port of the Java String.hashCode method.
+ * http://erlycoder.com/49/javascript-hash-functions-to-convert-string-into-integer-hash-
+ *
+ * @param {string} str
+ * @returns The hashCode of the string
+ */
+export declare function hashCode(str: string): number;

package/types/utils/UNSAFE_typeUtils/index.d.ts

@@ -0,0 +1 @@
+export * from './typeUtils';

package/types/utils/UNSAFE_typeUtils/typeUtils.d.ts

@@ -0,0 +1,18 @@
+import { ComponentProps, ComponentType, JSX, Ref } from 'preact';
+import { ExcludeSignalLike, HTMLAttributesSignalExcluded } from '../../utils/UNSAFE_attributeUtils';
+/**
+ * Extracts the type of the ref prop of the component
+ * @typedef C The type of the component
+ * @typedef P The property of the component that holds the handle ref
+ */
+export declare type Handle<C extends ComponentType<any>, P extends keyof ComponentProps<C>> = Pick<ComponentProps<C>, P>[P] extends Ref<infer T> | undefined ? T : never;
+declare type Obj = Record<string, unknown>;
+export declare type Merge<P1 = Obj, P2 = Obj> = Omit<P1, keyof P2> & P2;
+export declare type ElementType = keyof JSX.IntrinsicElements;
+export declare type IntrinsicElement<T extends ElementType> = ExcludeSignalLike<JSX.IntrinsicElements[T]>;
+export declare type StyleProps = Pick<HTMLAttributesSignalExcluded, 'class' | 'className' | 'style'>;
+export declare type StyledComponentProps<E extends ElementType, OwnProps = Obj> = Merge<IntrinsicElement<E>, OwnProps & StyleProps>;
+export declare type WithRequired<T, K extends keyof T> = T & {
+    [P in K]-?: T[P];
+};
+export {};

package/types/utils/UNSAFE_units/index.d.ts

@@ -0,0 +1 @@
+export * from './units';

package/types/utils/UNSAFE_units/units.d.ts

@@ -0,0 +1,5 @@
+declare const isNumber: (val: any) => boolean;
+declare const isZero: (n: any) => boolean;
+declare const hasUnit: (val: any) => boolean;
+declare const px: (n: string | number) => string | number;
+export { isNumber, isZero, hasUnit, px };

package/types/utils/UNSAFE_valueUpdateDetail/index.d.ts

@@ -0,0 +1 @@
+export * from './valueUpdateDetail';

package/types/utils/UNSAFE_valueUpdateDetail/valueUpdateDetail.d.ts

@@ -0,0 +1,4 @@
+export declare type ValueUpdateDetail<T> = {
+    previousValue?: T;
+    value?: T;
+};

package/types/utils/index.d.ts

@@ -0,0 +1 @@
+