@oracle/oraclejet-core-pack 17.0.4 → 17.1.0

package/oj-c/types/progress-button/progress-button.d.ts

@@ -0,0 +1,101 @@
+import { JetElement, JetSettableProperties, JetElementCustomEventStrict, JetSetPropertyType } from 'ojs/index';
+import { GlobalProps } from 'ojs/ojvcomponent';
+import 'ojs/oj-jsx-interfaces';
+import { ExtendGlobalProps, Action, Bubbles, Slot } from 'ojs/ojvcomponent';
+import { ProgressButton as PreactProgressButton } from '@oracle/oraclejet-preact/UNSAFE_ProgressButton';
+import { Size } from '@oracle/oraclejet-preact/utils/UNSAFE_size';
+import { ComponentProps, Ref, ComponentType } from 'preact';
+import 'css!oj-c/progress-button/progress-button-styles.css';
+type PreactProgressButtonProps = ComponentProps<typeof PreactProgressButton>;
+type Props = {
+    label: string;
+    tooltip?: string;
+    startIcon?: Slot;
+    disabled?: boolean;
+    isLoading?: boolean;
+    width?: Size;
+    display?: 'all' | 'icons' | 'label';
+    size?: 'sm' | 'md' | 'lg';
+    edge?: PreactProgressButtonProps['edge'];
+    chroming?: PreactProgressButtonProps['variant'];
+    onOjAction?: Action & Bubbles;
+};
+type ProgressButtonHandle = {
+    focus: () => void;
+    blur: () => void;
+    click: () => void;
+};
+declare function ProgressButtonImpl({ chroming, disabled, size, display, startIcon, edge, tooltip, isLoading, width, label, onOjAction, ...otherProps }: Props, ref: Ref<ProgressButtonHandle>): import("preact").JSX.Element;
+export declare const ProgressButton: ComponentType<ExtendGlobalProps<ComponentProps<typeof ProgressButtonImpl>>>;
+export {};
+export interface CProgressButtonElement extends JetElement<CProgressButtonElementSettableProperties>, CProgressButtonElementSettableProperties {
+    addEventListener<T extends keyof CProgressButtonElementEventMap>(type: T, listener: (this: HTMLElement, ev: CProgressButtonElementEventMap[T]) => any, options?: (boolean | AddEventListenerOptions)): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: (boolean | AddEventListenerOptions)): void;
+    getProperty<T extends keyof CProgressButtonElementSettableProperties>(property: T): CProgressButtonElement[T];
+    getProperty(property: string): any;
+    setProperty<T extends keyof CProgressButtonElementSettableProperties>(property: T, value: CProgressButtonElementSettableProperties[T]): void;
+    setProperty<T extends string>(property: T, value: JetSetPropertyType<T, CProgressButtonElementSettableProperties>): void;
+    setProperties(properties: CProgressButtonElementSettablePropertiesLenient): void;
+    blur: () => void;
+    click: () => void;
+    focus: () => void;
+}
+export namespace CProgressButtonElement {
+    interface ojAction extends CustomEvent<{}> {
+    }
+    type chromingChanged = JetElementCustomEventStrict<CProgressButtonElement['chroming']>;
+    type disabledChanged = JetElementCustomEventStrict<CProgressButtonElement['disabled']>;
+    type displayChanged = JetElementCustomEventStrict<CProgressButtonElement['display']>;
+    type edgeChanged = JetElementCustomEventStrict<CProgressButtonElement['edge']>;
+    type isLoadingChanged = JetElementCustomEventStrict<CProgressButtonElement['isLoading']>;
+    type labelChanged = JetElementCustomEventStrict<CProgressButtonElement['label']>;
+    type sizeChanged = JetElementCustomEventStrict<CProgressButtonElement['size']>;
+    type tooltipChanged = JetElementCustomEventStrict<CProgressButtonElement['tooltip']>;
+    type widthChanged = JetElementCustomEventStrict<CProgressButtonElement['width']>;
+}
+export interface CProgressButtonElementEventMap extends HTMLElementEventMap {
+    'ojAction': CProgressButtonElement.ojAction;
+    'chromingChanged': JetElementCustomEventStrict<CProgressButtonElement['chroming']>;
+    'disabledChanged': JetElementCustomEventStrict<CProgressButtonElement['disabled']>;
+    'displayChanged': JetElementCustomEventStrict<CProgressButtonElement['display']>;
+    'edgeChanged': JetElementCustomEventStrict<CProgressButtonElement['edge']>;
+    'isLoadingChanged': JetElementCustomEventStrict<CProgressButtonElement['isLoading']>;
+    'labelChanged': JetElementCustomEventStrict<CProgressButtonElement['label']>;
+    'sizeChanged': JetElementCustomEventStrict<CProgressButtonElement['size']>;
+    'tooltipChanged': JetElementCustomEventStrict<CProgressButtonElement['tooltip']>;
+    'widthChanged': JetElementCustomEventStrict<CProgressButtonElement['width']>;
+}
+export interface CProgressButtonElementSettableProperties extends JetSettableProperties {
+    chroming?: Props['chroming'];
+    disabled?: Props['disabled'];
+    display?: Props['display'];
+    edge?: Props['edge'];
+    isLoading?: Props['isLoading'];
+    label: Props['label'];
+    size?: Props['size'];
+    tooltip?: Props['tooltip'];
+    width?: Props['width'];
+}
+export interface CProgressButtonElementSettablePropertiesLenient extends Partial<CProgressButtonElementSettableProperties> {
+    [key: string]: any;
+}
+export interface ProgressButtonIntrinsicProps extends Partial<Readonly<CProgressButtonElementSettableProperties>>, GlobalProps, Pick<preact.JSX.HTMLAttributes, 'ref' | 'key'> {
+    children?: import('preact').ComponentChildren;
+    onojAction?: (value: CProgressButtonElementEventMap['ojAction']) => void;
+    onchromingChanged?: (value: CProgressButtonElementEventMap['chromingChanged']) => void;
+    ondisabledChanged?: (value: CProgressButtonElementEventMap['disabledChanged']) => void;
+    ondisplayChanged?: (value: CProgressButtonElementEventMap['displayChanged']) => void;
+    onedgeChanged?: (value: CProgressButtonElementEventMap['edgeChanged']) => void;
+    onisLoadingChanged?: (value: CProgressButtonElementEventMap['isLoadingChanged']) => void;
+    onlabelChanged?: (value: CProgressButtonElementEventMap['labelChanged']) => void;
+    onsizeChanged?: (value: CProgressButtonElementEventMap['sizeChanged']) => void;
+    ontooltipChanged?: (value: CProgressButtonElementEventMap['tooltipChanged']) => void;
+    onwidthChanged?: (value: CProgressButtonElementEventMap['widthChanged']) => void;
+}
+declare global {
+    namespace preact.JSX {
+        interface IntrinsicElements {
+            'oj-c-progress-button': ProgressButtonIntrinsicProps;
+        }
+    }
+}

package/oj-c/types/radioset/radioset.d.ts

@@ -11,6 +11,7 @@ import { LayoutColumnSpan } from '@oracle/oraclejet-preact/utils/UNSAFE_styles/L
 type RadiosetArrayDataItem<V extends string | number> = RadiosetDataItem & {
     value: V;
 };
+type DisplayOptionsProps = Pick<DisplayOptions, 'messages'>;
 type RadiosetDataItem = {
     label: string;
     assistiveText?: string;
@@ -24,7 +25,7 @@ type RadiosetProps<V extends string | number, D extends RadiosetDataItem> = Obse
     columnSpan?: LayoutColumnSpan;
     direction?: PreactRadioSetProps['direction'];
     disabled?: boolean;
-    displayOptions?: Pick<DisplayOptions, 'messages'>;
+    displayOptions?: DisplayOptionsProps;
     help?: Help;
     helpHints?: HelpHints;
     labelHint: string;
@@ -43,7 +44,7 @@ type RadiosetProps<V extends string | number, D extends RadiosetDataItem> = Obse
     value?: V | null;
 };
 export declare const Radioset: ComponentType<ExtendGlobalProps<RadiosetProps<string | number, RadiosetDataItem>>>;
-export {};
+export type { RadiosetDataItem, RadiosetProps };
 export interface CRadiosetElement<V extends string | number, D extends RadiosetDataItem> extends JetElement<CRadiosetElementSettableProperties<V, D>>, CRadiosetElementSettableProperties<V, D> {
     readonly valid?: Parameters<Required<RadiosetProps<V, D>>['onValidChanged']>[0];
     addEventListener<T extends keyof CRadiosetElementEventMap<V, D>>(type: T, listener: (this: HTMLElement, ev: CRadiosetElementEventMap<V, D>[T]) => any, options?: (boolean | AddEventListenerOptions)): void;

package/oj-c/types/radioset/useRadiosetPreact.d.ts

@@ -1,11 +1,9 @@
-import { ComponentProps } from 'preact';
-import { Radioset } from './radioset';
-type RadiosetProps = ComponentProps<typeof Radioset>;
-export declare function useRadiosetPreact({ direction, disabled, displayOptions, labelEdge, labelHint, labelStartWidth, messagesCustom, readonly, requiredMessageDetail: propRequiredMessageDetail, required, userAssistanceDensity, value: propValue, onMessagesCustomChanged, onValidChanged, onValueChanged, ...otherProps }: RadiosetProps, addBusyState: (desc?: string) => () => void): {
+import { RadiosetDataItem, RadiosetProps } from './radioset';
+export declare function useRadiosetPreact<V extends string | number, D extends RadiosetDataItem>({ direction, disabled, displayOptions, labelEdge, labelHint, labelStartWidth, messagesCustom, readonly, requiredMessageDetail: propRequiredMessageDetail, required, userAssistanceDensity, value: propValue, onMessagesCustomChanged, onValidChanged, onValueChanged, ...otherProps }: RadiosetProps<V, D>, addBusyState: (desc?: string) => () => void): {
     methods: {
         reset: () => void;
-        validate: () => Promise<"invalid" | "valid">;
         showMessages: () => void;
+        validate: () => Promise<"invalid" | "valid">;
     };
     radiosetProps: import("preact/compat").PropsWithoutRef<import("@oracle/oraclejet-preact/hooks/UNSAFE_useTestId").TestIdProps & {
         'aria-describedby'?: string | undefined;
@@ -29,4 +27,3 @@ export declare function useRadiosetPreact({ direction, disabled, displayOptions,
         ref?: import("preact").Ref<import("@oracle/oraclejet-preact/hooks/UNSAFE_useFocusableTextField").FocusableHandle> | undefined;
     };
 };
-export {};

package/oj-c/types/rating-gauge/rating-gauge.d.ts

@@ -10,7 +10,7 @@ type PreactRatingGaugeProps = ComponentProps<typeof PreactRatingGauge>;
 type DatatipContext = {
     value: number;
 };
-export declare const RatingGauge: import("preact").ComponentType<import("ojs/ojvcomponent").ExtendGlobalProps<ObservedGlobalProps<"aria-label"> & {
+export declare const RatingGauge: import("preact").ComponentType<import("ojs/ojvcomponent").ExtendGlobalProps<ObservedGlobalProps<"aria-label" | "aria-labelledby" | "aria-describedby"> & {
     max?: number | undefined;
     readonly?: boolean | undefined;
     disabled?: boolean | undefined;

package/oj-c/types/select-common/PRIVATE_DebouncingDataProviderView/Debouncer.d.ts

@@ -0,0 +1,11 @@
+export declare class Debouncer {
+    private readonly _responseTimes;
+    private readonly _requestTime;
+    private _lastRequestTime;
+    debounce(callback: (...args: any) => void, filterTextLength: number): (...args: any) => void;
+    recordResponseTime(time: number, filterTextLength: number): void;
+    recordRequestTime(): void;
+    private _getResponseTime;
+    private _getRequestTime;
+    protected GetDebounceTime(filterTextLength: number): number;
+}

package/oj-c/types/select-common/PRIVATE_DebouncingDataProviderView/DebouncingDataProviderView.d.ts

@@ -0,0 +1,16 @@
+import { DataProvider, ContainsKeysResults, FetchByKeysParameters, FetchByKeysResults, FetchByOffsetParameters, FetchByOffsetResults, FetchListParameters, FetchListResult } from 'ojs/ojdataprovider';
+export declare class DebouncingDataProviderView<K, D> implements DataProvider<K, D> {
+    private _debouncer;
+    protected readonly dataProvider: DataProvider<K, D>;
+    constructor(dataProvider: DataProvider<K, D>);
+    fetchFirst<F extends FetchListResult<K, D>>(params?: FetchListParameters<D>): AsyncIterable<F>;
+    fetchByKeys(params: FetchByKeysParameters<K>): Promise<FetchByKeysResults<K, D>>;
+    containsKeys(params: FetchByKeysParameters<K>): Promise<ContainsKeysResults<K>>;
+    fetchByOffset(params: FetchByOffsetParameters<D>): Promise<FetchByOffsetResults<K, D>>;
+    getTotalSize(): Promise<number>;
+    isEmpty(): 'yes' | 'no' | 'unknown';
+    getCapability(capabilityName: string): any;
+    addEventListener(eventType: string, listener: EventListener): void;
+    removeEventListener(eventType: string, listener: EventListener): void;
+    dispatchEvent(event: Event): boolean;
+}

package/oj-c/types/select-common/PRIVATE_useCache/index.d.ts

@@ -0,0 +1 @@
+export { useCache } from './useCache';

package/oj-c/types/select-common/PRIVATE_useCache/useCache.d.ts

@@ -0,0 +1 @@
+export declare function useCache(): <T>(key: string, value: T, deps: unknown[]) => T;

package/oj-c/types/select-common/PRIVATE_useSelectData/CollectionTemplateDataProviderView.d.ts

@@ -0,0 +1,43 @@
+import type { ListDataState } from 'oj-c/hooks/UNSAFE_useListData/useListData';
+import { FetchByKeysResults, type ContainsKeysResults, type DataFilter, type DataProvider, type FetchByKeysParameters, type FetchByOffsetParameters, type FetchByOffsetResults, type FetchListParameters, type FetchListResult } from 'ojs/ojdataprovider';
+export declare const SELECT_INTERNALS: unique symbol;
+export type SelectInternals = {
+    cause?: 'filterCriterionChanged' | 'dataOverrideChanged';
+};
+type CollectionTemplateDataProviderViewOptions<K, D> = {
+    onInitializeFetch?: () => void;
+    onNextIteration?: (details: {
+        results: FetchListResult<K, D>;
+        offset: number;
+        done: boolean;
+    }) => void;
+    onOffsetFetch?: (details: {
+        results: FetchByOffsetResults<K, D>;
+    }) => void;
+    onRefresh?: () => void;
+};
+export declare class CollectionTemplateDataProviderView<K, D> implements DataProvider<K, D> {
+    private originalDataProvider;
+    private overrideDataProvider?;
+    private dataStateOverride?;
+    private filterCriterion?;
+    private options;
+    private get currentDataProvider();
+    setFilterCriterion(filter?: DataFilter.Filter<D>): void;
+    setDataStateOverride(dataStateOverride?: ListDataState<K, D>): void;
+    private compareFilter;
+    constructor(dataProvider: DataProvider<K, D>, options: CollectionTemplateDataProviderViewOptions<K, D>);
+    fetchByOffset(parameters: FetchByOffsetParameters<D>): Promise<FetchByOffsetResults<K, D>>;
+    fetchFirst(parameters?: FetchListParameters<D> | undefined): AsyncIterable<FetchListResult<K, D>>;
+    createOptimizedKeyMap?(initialMap?: Map<K, D> | undefined): Map<K, D>;
+    createOptimizedKeySet?(initialSet?: Set<K> | undefined): Set<K>;
+    addEventListener(eventType: string, listener: EventListener): void;
+    containsKeys(parameters: FetchByKeysParameters<K>): Promise<ContainsKeysResults<K>>;
+    dispatchEvent(event: Event): boolean;
+    fetchByKeys(parameters: FetchByKeysParameters<K>): Promise<FetchByKeysResults<K, D>>;
+    getCapability(capabilityName: string): any;
+    getTotalSize(): Promise<number>;
+    isEmpty(): "unknown" | "no" | "yes";
+    removeEventListener(eventType: string, listener: EventListener): void;
+}
+export {};

package/oj-c/types/select-common/PRIVATE_useSelectData/index.d.ts

@@ -0,0 +1,2 @@
+export { useSelectData } from './useSelectData';
+export { SELECT_INTERNALS, type SelectInternals } from './CollectionTemplateDataProviderView';

package/oj-c/types/select-common/PRIVATE_useSelectData/useCollectionTemplateDataProviderView.d.ts

@@ -0,0 +1,15 @@
+import { type ListDataState } from 'oj-c/hooks/UNSAFE_useListData/useListData';
+import { type DataFilter, type DataProvider } from 'ojs/ojdataprovider';
+export type UseCollectionTemplateDataProviderViewParams<K, D> = {
+    dataProvider?: DataProvider<K, D> | null;
+    options: {
+        dataStateOverride?: ListDataState<K, D>;
+        filterCriterion?: DataFilter.Filter<D>;
+    };
+};
+type UseCollectionTemplateDataProviderViewResult<K, D> = {
+    dataProvider?: DataProvider<K, D> | null;
+    dataState: ListDataState<K, D>;
+};
+export declare function useCollectionTemplateDataProviderView<K, D>({ dataProvider, options: { dataStateOverride, filterCriterion } }: UseCollectionTemplateDataProviderViewParams<K, D>): UseCollectionTemplateDataProviderViewResult<K, D>;
+export {};

package/oj-c/types/select-common/PRIVATE_useSelectData/useSelectData.d.ts

@@ -0,0 +1,15 @@
+import type { DataState } from '@oracle/oraclejet-preact/UNSAFE_Collection';
+import { type ListDataState } from 'oj-c/hooks/UNSAFE_useListData/useListData';
+import type { DataFilter, DataProvider } from 'ojs/ojdataprovider';
+type UseSelectDataParams<K, D> = {
+    data?: DataProvider<K, D> | null;
+    dataStateOverride?: DataState<K, D>;
+    filterCriterion?: DataFilter.Filter<D>;
+    hasCollectionTemplate: boolean;
+};
+export declare const useSelectData: <K, D>({ data, dataStateOverride: propDataStateOverride, filterCriterion, hasCollectionTemplate }: UseSelectDataParams<K, D>) => {
+    dataProvider: DataProvider<K, D> | import("../PRIVATE_DebouncingDataProviderView/DebouncingDataProviderView").DebouncingDataProviderView<K, D> | null | undefined;
+    dataState: ListDataState<K, D>;
+    onLoadRange: (range: import("@oracle/oraclejet-preact/UNSAFE_Collection").Range) => void;
+};
+export {};

package/oj-c/types/select-common/UNSAFE_useDataProviderListeners/useDataProviderListeners.d.ts

@@ -1,7 +1,7 @@
-import { ItemContext } from 'ojs/ojcommontypes';
-import { DataProvider } from 'ojs/ojdataprovider';
-import { Dispatch, StateUpdater } from 'preact/hooks';
-import { Optional } from '../utils/utils';
+import type { ItemContext } from 'ojs/ojcommontypes';
+import type { DataProvider } from 'ojs/ojdataprovider';
+import { type Dispatch, type StateUpdater } from 'preact/hooks';
+import { type Optional } from '../utils/utils';
 export type UseDataProviderListenerProps<K extends string | number, D extends Record<string, any>, V extends K | Set<K>, VI extends ItemContext<K, D> | Map<K, ItemContext<K, D>>> = {
     dataProvider?: Optional<DataProvider<K, D>>;
     setValue: Dispatch<StateUpdater<Optional<V>>>;

package/oj-c/types/select-common/UNSAFE_useWrapDataProvider/useWrapDataProvider.d.ts

@@ -1,3 +1,4 @@
 import { DataProvider } from 'ojs/ojdataprovider';
 import { Optional } from '../utils/utils';
-export declare function useWrapDataProvider<K, D>(data?: Optional<DataProvider<K, D>>): DataProvider<K, D> | null | undefined;
+import { DebouncingDataProviderView } from '../PRIVATE_DebouncingDataProviderView/DebouncingDataProviderView';
+export declare function useWrapDataProvider<K, D>(data?: Optional<DataProvider<K, D>>): DataProvider<K, D> | DebouncingDataProviderView<K, D> | null | undefined;

package/oj-c/types/select-multiple/select-multiple.d.ts

@@ -2,16 +2,17 @@ import { JetElement, JetSettableProperties, JetElementCustomEventStrict, JetSetP
 import { GlobalProps } from 'ojs/ojvcomponent';
 import 'ojs/oj-jsx-interfaces';
 import { SelectMultiple as PreactSelectMultiple } from '@oracle/oraclejet-preact/UNSAFE_SelectMultiple';
-import { ItemContext } from 'ojs/ojcommontypes';
-import { DataProvider, Item, TextFilter } from 'ojs/ojdataprovider';
-import { ImmutableKeySet } from 'ojs/ojkeyset';
-import { ExtendGlobalProps, ObservedGlobalProps, PropertyChanged, ReadOnlyPropertyChanged, TemplateSlot } from 'ojs/ojvcomponent';
-import { ComponentProps, ComponentType } from 'preact';
-import { DisplayOptions, Help, HelpHints } from 'oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText';
-import { Size } from '@oracle/oraclejet-preact/utils/UNSAFE_size';
-import { LayoutColumnSpan } from '@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout';
+import type { Size } from '@oracle/oraclejet-preact/utils/UNSAFE_size';
+import { type LayoutColumnSpan } from '@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout';
+import { type DisplayOptions, type Help, type HelpHints } from 'oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText';
+import type { ItemContext } from 'ojs/ojcommontypes';
+import type { DataProvider, Item, TextFilter } from 'ojs/ojdataprovider';
+import type { ImmutableKeySet } from 'ojs/ojkeyset';
+import { type ExtendGlobalProps, type ObservedGlobalProps, type PropertyChanged, type ReadOnlyPropertyChanged, type TemplateSlot } from 'ojs/ojvcomponent';
+import type { ComponentProps, ComponentType } from 'preact';
 import 'css!oj-c/select-multiple/select-multiple-styles.css';
 type PreactSelectMultipleProps = ComponentProps<typeof PreactSelectMultiple>;
+type DisplayOptionsProps = Omit<DisplayOptions, 'converterHint' | 'validatorHint'>;
 type ItemTemplateContext<K extends string | number, D extends Record<string, any>> = Pick<Parameters<NonNullable<PreactSelectMultipleProps['itemRenderer']>>[0], 'searchText'> & {
     item: Item<K, D>;
     selectedKeys: ImmutableKeySet<K>;
@@ -19,13 +20,28 @@ type ItemTemplateContext<K extends string | number, D extends Record<string, any
         value: ImmutableKeySet<K>;
     }>) => void);
 };
+export type CollectionTemplateContext<K extends string | number, D extends Record<string, any>> = {
+    data?: DataProvider<K, D> | null;
+    searchText?: string;
+    currentRowOverride?: {
+        rowKey: K;
+    };
+    onCurrentRowChanged: (detail: {
+        rowKey?: K;
+    }) => void;
+    selected: ImmutableKeySet<K>;
+    onSelectedChanged: (detail: {
+        value?: ImmutableKeySet<K>;
+    }) => void;
+};
 type ValidState = 'valid' | 'pending' | 'invalidHidden' | 'invalidShown';
 type Props<K extends string | number, D extends Record<string, any>> = ObservedGlobalProps<'aria-describedby' | 'id'> & {
+    collectionTemplate?: TemplateSlot<CollectionTemplateContext<K, D>>;
     columnSpan?: LayoutColumnSpan;
     containerReadonly?: boolean;
     data?: DataProvider<K, D> | null;
     disabled?: boolean;
-    displayOptions?: Omit<DisplayOptions, 'converterHint' | 'validatorHint'>;
+    displayOptions?: DisplayOptionsProps;
     help?: Help;
     helpHints?: HelpHints;
     itemTemplate?: TemplateSlot<ItemTemplateContext<K, D>>;
@@ -94,6 +110,7 @@ export namespace CSelectMultipleElement {
     type valueChanged<K extends string | number, D extends Record<string, any>> = JetElementCustomEventStrict<CSelectMultipleElement<K, D>['value']>;
     type valueItemsChanged<K extends string | number, D extends Record<string, any>> = JetElementCustomEventStrict<CSelectMultipleElement<K, D>['valueItems']>;
     type virtualKeyboardChanged<K extends string | number, D extends Record<string, any>> = JetElementCustomEventStrict<CSelectMultipleElement<K, D>['virtualKeyboard']>;
+    type RenderCollectionTemplate<K extends string | number, D extends Record<string, any>> = import('ojs/ojvcomponent').TemplateSlot<CollectionTemplateContext<K, D>>;
     type RenderItemTemplate<K extends string | number, D extends Record<string, any>> = import('ojs/ojvcomponent').TemplateSlot<ItemTemplateContext<K, D>>;
 }
 export interface CSelectMultipleElementEventMap<K extends string | number, D extends Record<string, any>> extends HTMLElementEventMap {

package/oj-c/types/select-multiple/useSelectMultiplePreact.d.ts

@@ -1,46 +1,38 @@
-import { ValueUpdateDetail } from '@oracle/oraclejet-preact/utils/UNSAFE_valueUpdateDetail';
+import type { DataState } from '@oracle/oraclejet-preact/UNSAFE_Collection';
+import type { ValueUpdateDetail } from '@oracle/oraclejet-preact/utils/UNSAFE_valueUpdateDetail';
+import type { ItemContext } from 'ojs/ojcommontypes';
 import type { SelectMultipleProps } from './select-multiple';
-export declare function useSelectMultiplePreact<K extends string | number, D extends Record<string, any>>({ data: propData, disabled, displayOptions, itemTemplate, itemText, labelEdge, labelHint, labelStartWidth, matchBy: propMatchBy, messagesCustom, placeholder, readonly, required, requiredMessageDetail: propRequiredMessageDetail, textAlign, userAssistanceDensity, value: propValue, valueItems: propValueItems, virtualKeyboard, onMessagesCustomChanged, onValidChanged, onValueChanged, onValueItemsChanged, ...otherProps }: SelectMultipleProps<K, D>, addBusyState: (desc?: string) => () => void): {
+export declare function useSelectMultiplePreact<K extends string | number, D extends Record<string, any>>({ collectionTemplate, data, disabled, displayOptions, itemTemplate, itemText, labelEdge, labelHint, labelStartWidth, matchBy: propMatchBy, messagesCustom, placeholder, readonly, required, requiredMessageDetail: propRequiredMessageDetail, textAlign, userAssistanceDensity, value: propValue, valueItems: propValueItems, virtualKeyboard, onMessagesCustomChanged, onValidChanged, onValueChanged, onValueItemsChanged, ...otherProps }: SelectMultipleProps<K, D>, addBusyState: (desc?: string) => () => void): {
     methods: {
         reset: () => void;
         validate: () => Promise<"invalid" | "valid">;
         showMessages: () => void;
     };
-    selectMultipleProps: import("preact/compat").PropsWithoutRef<import("@oracle/oraclejet-preact/hooks/UNSAFE_useTestId").TestIdProps & {
-        addToList?: "off" | "on" | undefined;
-        'aria-describedby'?: string | undefined;
-        assistiveText?: string | undefined;
-        columnSpan?: import("@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout").LayoutColumns | undefined;
-        data?: import("@oracle/oraclejet-preact/UNSAFE_Collection").DataState<string | number, Record<string, any>> | null | undefined;
-        helpSourceLink?: string | undefined;
-        helpSourceText?: string | undefined;
-        isDisabled?: boolean | undefined;
-        isLoading?: boolean | undefined;
-        isReadonly?: boolean | undefined;
-        isRequired?: boolean | undefined;
-        isRequiredShown?: boolean | undefined;
-        itemRenderer?: ((itemRendererProps: import("@oracle/oraclejet-preact/UNSAFE_SelectMultiple/SelectMultiple.types").ItemRendererProps<string | number, Record<string, any>>) => import("preact").ComponentChildren) | undefined;
-        itemText: import("@oracle/oraclejet-preact/utils/UNSAFE_selectUtils").ItemTextType<string | number, Record<string, any>>;
+    selectMultipleProps: {
+        'aria-describedby': string | undefined;
+        collectionRenderer: ((collectionRendererProps: import("@oracle/oraclejet-preact/UNSAFE_SelectMultiple/SelectMultiple.types").CollectionRendererProps<K, D>) => import("preact").ComponentChildren) | undefined;
+        data: DataState<K, D> | null;
+        isDisabled: boolean | undefined;
+        isLoading: boolean;
+        isReadonly: boolean | undefined;
+        isRequired: boolean | undefined;
+        isRequiredShown: boolean | undefined;
+        itemRenderer: ((itemRendererProps: import("@oracle/oraclejet-preact/UNSAFE_SelectMultiple/SelectMultiple.types").ItemRendererProps<K, D>) => import("preact").ComponentChildren) | undefined;
+        itemText: keyof D | ((itemContext: ItemContext<K, D>) => string);
         label: string;
-        labelEdge?: "none" | "start" | "top" | "inside" | undefined;
-        labelStartWidth?: import("@oracle/oraclejet-preact/utils/UNSAFE_size").Size | undefined;
-        messages?: import("@oracle/oraclejet-preact/UNSAFE_ComponentMessage").ComponentMessageItem[] | undefined;
-        placeholder?: string | undefined;
-        textAlign?: "end" | "start" | "right" | undefined;
-        userAssistanceDensity?: import("@oracle/oraclejet-preact/UNSAFE_UserAssistance").UserAssistanceDensityType | undefined;
-        valueItems?: import("@oracle/oraclejet-preact/utils/UNSAFE_dataProvider").Item<string | number, Record<string, any>>[] | undefined;
-        variant?: "default" | "embedded" | undefined;
-        virtualKeyboard?: "number" | "search" | "auto" | "url" | "text" | "email" | "tel" | undefined;
-        onAddToListAction?: (({ searchText }: {
-            searchText?: string | undefined;
-        }) => void) | undefined;
-        onCommit: (detail: ValueUpdateDetail<Set<string | number>>) => void;
-        onFilter?: (({ searchText }: {
-            searchText?: string | undefined;
-        }) => void) | undefined;
-        onLoadRange?: ((range: import("@oracle/oraclejet-preact/UNSAFE_Collection").Range) => void) | undefined;
-    }> & {
-        ref?: import("preact").Ref<import("@oracle/oraclejet-preact/hooks/UNSAFE_useFocusableTextField").FocusableHandle> | undefined;
+        labelEdge: "none" | "start" | "top" | "inside" | undefined;
+        labelStartWidth: import("@oracle/oraclejet-preact/utils/UNSAFE_size").Size | undefined;
+        messages: import("@oracle/oraclejet-preact/UNSAFE_ComponentMessage").ComponentMessageItem[] | undefined;
+        onCommit: ({ value }: ValueUpdateDetail<Set<K>>) => Promise<void>;
+        onFilter: ({ searchText }: {
+            searchText?: string;
+        }) => void;
+        onLoadRange: (range: import("@oracle/oraclejet-preact/UNSAFE_Collection").Range) => void;
+        placeholder: string | undefined;
+        textAlign: "end" | "start" | "right" | undefined;
+        userAssistanceDensity: import("@oracle/oraclejet-preact/UNSAFE_UserAssistance").UserAssistanceDensityType | undefined;
+        valueItems: ItemContext<K, D>[] | undefined;
+        virtualKeyboard: "number" | "search" | "auto" | "url" | "text" | "email" | "tel" | undefined;
     };
     _selectItemsByValue: (value: Set<K> | null) => Promise<void>;
 };

package/oj-c/types/select-single/select-single.d.ts

@@ -2,18 +2,34 @@ import { JetElement, JetSettableProperties, JetElementCustomEventStrict, JetSetP
 import { GlobalProps } from 'ojs/ojvcomponent';
 import 'ojs/oj-jsx-interfaces';
 import { SelectSingle as PreactSelectSingle } from '@oracle/oraclejet-preact/UNSAFE_SelectSingle';
-import { DisplayOptions, Help, HelpHints } from 'oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText';
-import { ItemContext } from 'ojs/ojcommontypes';
-import { DataProvider, Item, TextFilter } from 'ojs/ojdataprovider';
-import { Action, ExtendGlobalProps, ObservedGlobalProps, PropertyChanged, ReadOnlyPropertyChanged, TemplateSlot } from 'ojs/ojvcomponent';
-import { ComponentProps, ComponentType } from 'preact';
-import { Size } from '@oracle/oraclejet-preact/utils/UNSAFE_size';
-import { LayoutColumnSpan } from '@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout';
+import type { Size } from '@oracle/oraclejet-preact/utils/UNSAFE_size';
+import { type LayoutColumnSpan } from '@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout';
+import { type DisplayOptions, type Help, type HelpHints } from 'oj-c/editable-value/UNSAFE_useAssistiveText/useAssistiveText';
+import type { ItemContext } from 'ojs/ojcommontypes';
+import type { DataProvider, Item, TextFilter } from 'ojs/ojdataprovider';
+import type { ImmutableKeySet } from 'ojs/ojkeyset';
+import { type Action, type ExtendGlobalProps, type ObservedGlobalProps, type PropertyChanged, type ReadOnlyPropertyChanged, type TemplateSlot } from 'ojs/ojvcomponent';
+import type { ComponentProps, ComponentType } from 'preact';
 import 'css!oj-c/select-single/select-single-styles.css';
 type PreactSelectSingleProps = ComponentProps<typeof PreactSelectSingle>;
+type DisplayOptionsProps = Omit<DisplayOptions, 'converterHint' | 'validatorHint'>;
 type ItemTemplateContext<K extends string | number, D extends Record<string, any>> = Pick<Parameters<NonNullable<PreactSelectSingleProps['itemRenderer']>>[0], 'searchText'> & {
     item: Item<K, D>;
 };
+export type CollectionTemplateContext<K extends string | number, D extends Record<string, any>> = {
+    data?: DataProvider<K, D> | null;
+    searchText?: string;
+    currentRowOverride?: {
+        rowKey: K;
+    };
+    onCurrentRowChanged: (detail: {
+        rowKey?: K;
+    }) => void;
+    selected: ImmutableKeySet<K>;
+    onRowAction: (detail: {
+        item: Item<K, D>;
+    }) => void;
+};
 type ValidState = 'valid' | 'pending' | 'invalidHidden' | 'invalidShown';
 type AdvancedSearchActionPayload = Parameters<NonNullable<PreactSelectSingleProps['onAdvancedSearchAction']>>[0];
 type ValueActionPayload<V, D> = {
@@ -23,11 +39,12 @@ type ValueActionPayload<V, D> = {
 };
 type Props<V extends string | number, D extends Record<string, any>> = ObservedGlobalProps<'aria-describedby' | 'id'> & {
     advancedSearch?: PreactSelectSingleProps['advancedSearch'];
+    collectionTemplate?: TemplateSlot<CollectionTemplateContext<V, D>>;
     columnSpan?: LayoutColumnSpan;
     containerReadonly?: boolean;
     data?: DataProvider<V, D> | null;
     disabled?: boolean;
-    displayOptions?: Omit<DisplayOptions, 'converterHint' | 'validatorHint'>;
+    displayOptions?: DisplayOptionsProps;
     help?: Help;
     helpHints?: HelpHints;
     itemTemplate?: TemplateSlot<ItemTemplateContext<V, D>>;
@@ -106,6 +123,7 @@ export namespace CSelectSingleElement {
     type valueChanged<V extends string | number, D extends Record<string, any>> = JetElementCustomEventStrict<CSelectSingleElement<V, D>['value']>;
     type valueItemChanged<V extends string | number, D extends Record<string, any>> = JetElementCustomEventStrict<CSelectSingleElement<V, D>['valueItem']>;
     type virtualKeyboardChanged<V extends string | number, D extends Record<string, any>> = JetElementCustomEventStrict<CSelectSingleElement<V, D>['virtualKeyboard']>;
+    type RenderCollectionTemplate<V extends string | number, D extends Record<string, any>> = import('ojs/ojvcomponent').TemplateSlot<CollectionTemplateContext<V, D>>;
     type RenderItemTemplate<V extends string | number, D extends Record<string, any>> = import('ojs/ojvcomponent').TemplateSlot<ItemTemplateContext<V, D>>;
 }
 export interface CSelectSingleElementEventMap<V extends string | number, D extends Record<string, any>> extends HTMLElementEventMap {

package/oj-c/types/select-single/useSelectSinglePreact.d.ts

@@ -1,64 +1,41 @@
-import { ValueUpdateDetail } from '@oracle/oraclejet-preact/utils/UNSAFE_valueUpdateDetail';
+import type { ValueUpdateDetail } from '@oracle/oraclejet-preact/utils/UNSAFE_valueUpdateDetail';
+import type { ItemContext } from 'ojs/ojcommontypes';
 import type { SelectSingleProps } from './select-single';
-export declare function useSelectSinglePreact<V extends string | number, D extends Record<string, any>>({ advancedSearch, data: propData, disabled, displayOptions, itemTemplate, itemText, labelEdge, labelHint, labelStartWidth, matchBy: propMatchBy, messagesCustom, placeholder, readonly, requiredMessageDetail: propRequiredMessageDetail, required, textAlign, userAssistanceDensity, value: propValue, valueItem: propValueItem, virtualKeyboard, onMessagesCustomChanged, onOjAdvancedSearchAction, onOjValueAction, onValidChanged, onValueChanged, onValueItemChanged, ...otherProps }: SelectSingleProps<V, D>, addBusyState: (desc?: string) => () => void): {
+export declare function useSelectSinglePreact<V extends string | number, D extends Record<string, any>>({ advancedSearch, collectionTemplate, data, disabled, displayOptions, itemTemplate, itemText, labelEdge, labelHint, labelStartWidth, matchBy: propMatchBy, messagesCustom, placeholder, readonly, requiredMessageDetail: propRequiredMessageDetail, required, textAlign, userAssistanceDensity, value: propValue, valueItem: propValueItem, virtualKeyboard, onMessagesCustomChanged, onOjAdvancedSearchAction, onOjValueAction, onValidChanged, onValueChanged, onValueItemChanged, ...otherProps }: SelectSingleProps<V, D>, addBusyState: (desc?: string) => () => void): {
     methods: {
         reset: () => void;
         validate: () => Promise<"invalid" | "valid">;
         showMessages: () => void;
     };
-    selectSingleProps: import("preact/compat").PropsWithoutRef<import("@oracle/oraclejet-preact/hooks/UNSAFE_useTestId").TestIdProps & {
-        addToList?: "off" | "on" | undefined;
-        advancedSearch?: "off" | "on" | undefined;
-        'aria-describedby'?: string | undefined;
-        assistiveText?: string | undefined;
-        columnSpan?: import("@oracle/oraclejet-preact/utils/UNSAFE_styles/Layout").LayoutColumns | undefined;
-        data?: import("@oracle/oraclejet-preact/UNSAFE_Collection").DataState<string | number, Record<string, any>> | null | undefined;
-        helpSourceLink?: string | undefined;
-        helpSourceText?: string | undefined;
-        isDisabled?: boolean | undefined;
-        isLoading?: boolean | undefined;
-        isReadonly?: boolean | undefined;
-        isRequired?: boolean | undefined;
-        isRequiredShown?: boolean | undefined;
-        itemRenderer?: ((itemRendererProps: {
-            index: number;
-            data: Record<string, any>;
-        } & {
-            metadata: {
-                key: string | number;
-                suggestion?: Record<string, any> | undefined;
-            };
-            searchText?: string | undefined;
-            selectedKeys?: Set<string | number> | undefined;
-            onSelectionChange: (detail: {
-                value: Set<string | number>;
-                target: EventTarget | null;
-            }) => void;
-        }) => import("preact").ComponentChildren) | undefined;
-        itemText: import("@oracle/oraclejet-preact/utils/UNSAFE_selectUtils").ItemTextType<string | number, Record<string, any>>;
+    selectSingleProps: {
+        advancedSearch: "off" | "on" | undefined;
+        'aria-describedby': string | undefined;
+        collectionRenderer: ((collectionRendererProps: import("@oracle/oraclejet-preact/UNSAFE_SelectSingle/SelectSingle.types").CollectionRendererProps<V, D>) => import("preact").ComponentChildren) | undefined;
+        data: import("@oracle/oraclejet-preact/UNSAFE_Collection").DataState<V, D> | null;
+        isDisabled: boolean | undefined;
+        isLoading: boolean;
+        isReadonly: boolean | undefined;
+        isRequired: boolean | undefined;
+        isRequiredShown: boolean | undefined;
+        itemRenderer: ((itemRendererProps: import("@oracle/oraclejet-preact/UNSAFE_SelectSingle/SelectSingle.types").ItemRendererProps<V, D>) => import("preact").ComponentChildren) | undefined;
+        itemText: keyof D | ((itemContext: ItemContext<V, D>) => string);
         label: string;
-        labelEdge?: "none" | "start" | "top" | "inside" | undefined;
-        labelStartWidth?: import("@oracle/oraclejet-preact/utils/UNSAFE_size").Size | undefined;
-        messages?: import("@oracle/oraclejet-preact/UNSAFE_ComponentMessage").ComponentMessageItem[] | undefined;
-        placeholder?: string | undefined;
-        textAlign?: "end" | "start" | "right" | undefined;
-        userAssistanceDensity?: import("@oracle/oraclejet-preact/UNSAFE_UserAssistance").UserAssistanceDensityType | undefined;
-        valueItem?: import("@oracle/oraclejet-preact/utils/UNSAFE_dataProvider").Item<string | number, Record<string, any>> | undefined;
-        variant?: "default" | "embedded" | undefined;
-        virtualKeyboard?: "number" | "search" | "auto" | "url" | "text" | "email" | "tel" | undefined;
-        onAddToListAction?: (({ searchText }: {
-            searchText?: string | undefined;
-        }) => void) | undefined;
-        onAdvancedSearchAction?: (({ searchText }: {
-            searchText?: string | undefined;
-        }) => void) | undefined;
-        onCommit: (detail: ValueUpdateDetail<string | number>) => void;
-        onFilter?: (({ searchText }: {
+        labelEdge: "none" | "start" | "top" | "inside" | undefined;
+        labelStartWidth: import("@oracle/oraclejet-preact/utils/UNSAFE_size").Size | undefined;
+        messages: import("@oracle/oraclejet-preact/UNSAFE_ComponentMessage").ComponentMessageItem[] | undefined;
+        onAdvancedSearchAction: ({ searchText }: {
             searchText?: string | undefined;
-        }) => void) | undefined;
-        onLoadRange?: ((range: import("@oracle/oraclejet-preact/UNSAFE_Collection").Range) => void) | undefined;
-    }> & {
-        ref?: import("preact").Ref<import("@oracle/oraclejet-preact/hooks/UNSAFE_useFocusableTextField").FocusableHandle> | undefined;
+        }) => void;
+        onCommit: ({ previousValue, value }: ValueUpdateDetail<V>) => Promise<void>;
+        onFilter: ({ searchText }: {
+            searchText?: string;
+        }) => void;
+        onLoadRange: (range: import("@oracle/oraclejet-preact/UNSAFE_Collection").Range) => void;
+        placeholder: string | undefined;
+        textAlign: "end" | "start" | "right" | undefined;
+        userAssistanceDensity: import("@oracle/oraclejet-preact/UNSAFE_UserAssistance").UserAssistanceDensityType | undefined;
+        valueItem: ItemContext<V, D> | undefined;
+        virtualKeyboard: "number" | "search" | "auto" | "url" | "text" | "email" | "tel" | undefined;
     };
     _doAdvancedSearchAction: (searchText: string) => void;
     _selectItemByValue: (value: V | null) => Promise<void>;