@aws-amplify/ui-react-storage 3.9.2 → 3.10.1

package/dist/types/components/StorageBrowser/{composables → components/composables}/DataTable/dataCells/TextDataCell.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { StorageBrowserIconType } from '../../../context/elements';
+import { StorageBrowserIconType } from '../../../elements';
 export interface TextDataCellProps {
     content: {
         icon?: StorageBrowserIconType;

package/dist/types/components/StorageBrowser/{composables → components/composables}/DataTable/index.d.ts

@@ -1,2 +1,2 @@
-export { DataTable, DataTableProps } from './DataTable';
+export { DataTable, DataTableProps, DataTableRow } from './DataTable';
 export { DataTableSortHeader, DataTableTextHeader, DataTableHeader, DataTableButtonDataCell, DataTableCheckboxDataCell, DataTableDateDataCell, DataTableNumberDataCell, DataTableTextDataCell, DataTableDataCell, SortDirection, } from './types';

package/dist/types/components/StorageBrowser/{composables → components/composables}/Message.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import { MessageVariant } from '../context/elements';
+import { MessageVariant } from '../elements';
 export type MessageType = MessageVariant;
 export interface MessageProps {
     content?: React.ReactNode;

package/dist/types/components/StorageBrowser/components/index.d.ts

@@ -0,0 +1,9 @@
+export { STORAGE_BROWSER_BLOCK, STORAGE_BROWSER_BLOCK_TO_BE_UPDATED, } from './base';
+export { Composables, DEFAULT_COMPOSABLES } from './composables';
+export { ActionListItem } from './composables/ActionsList';
+export * from './composables/DataTable';
+export { MessageProps, MessageType } from './composables/Message';
+export { ComponentsProvider, ComponentsProviderProps, StorageBrowserComponents, } from './ComponentsProvider';
+export { componentsDefault } from './defaults';
+export { StorageBrowserIconType, ViewElement } from './elements';
+export { WithKey } from './types';

package/dist/types/components/StorageBrowser/{providers/configuration → configuration}/index.d.ts

@@ -1,4 +1,3 @@
 export { createConfigurationProvider } from './createConfigurationProvider';
 export { useGetActionInput } from './context';
-export { CredentialsProviderProps, RegisterAuthListener } from './credentials';
 export { GetActionInput } from './types';

package/dist/types/components/StorageBrowser/{providers/configuration → configuration}/types.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { ActionInputConfig, LocationData } from '../../actions';
-import { CredentialsProviderProps } from './credentials';
+import { ActionInputConfig, LocationData } from '../actions';
+import { CredentialsProviderProps } from '../credentials';
 export type GetActionInput = (location?: LocationData) => ActionInputConfig;
 export interface GetActionInputProviderProps {
     accountId?: string;

package/dist/types/components/StorageBrowser/controls/hooks/compareFunctions/compareButtonData.d.ts

@@ -1,2 +1,2 @@
-import { DataTableButtonDataCell, SortDirection } from '../../../composables/DataTable';
+import { DataTableButtonDataCell, SortDirection } from '../../../components';
 export declare const compareButtonData: (a: DataTableButtonDataCell, b: DataTableButtonDataCell, direction: SortDirection) => number;

package/dist/types/components/StorageBrowser/controls/hooks/compareFunctions/compareDateData.d.ts

@@ -1,3 +1,3 @@
-import { DataTableDateDataCell, SortDirection } from '../../../composables/DataTable';
+import { DataTableDateDataCell, SortDirection } from '../../../components';
 export declare const compareContent: ({ value: a }: DataTableDateDataCell['content'], { value: b }: DataTableDateDataCell['content']) => number;
 export declare const compareDateData: (a: DataTableDateDataCell, b: DataTableDateDataCell, direction: SortDirection) => number;

package/dist/types/components/StorageBrowser/controls/hooks/compareFunctions/compareNumberData.d.ts

@@ -1,3 +1,3 @@
-import { DataTableNumberDataCell, SortDirection } from '../../../composables/DataTable';
+import { DataTableNumberDataCell, SortDirection } from '../../../components';
 export declare const compareContent: ({ value: a }: DataTableNumberDataCell['content'], { value: b }: DataTableNumberDataCell['content']) => number;
 export declare const compareNumberData: (a: DataTableNumberDataCell, b: DataTableNumberDataCell, direction: SortDirection) => number;

package/dist/types/components/StorageBrowser/controls/hooks/compareFunctions/compareTextData.d.ts

@@ -1,3 +1,3 @@
-import { DataTableTextDataCell, SortDirection } from '../../../composables/DataTable';
+import { DataTableTextDataCell, SortDirection } from '../../../components';
 export declare const compareContent: ({ text: a }: DataTableTextDataCell['content'], { text: b }: DataTableTextDataCell['content']) => number;
 export declare const compareTextData: (a: DataTableTextDataCell, b: DataTableTextDataCell, direction: SortDirection) => number;

package/dist/types/components/StorageBrowser/controls/hooks/getNavigationItems.d.ts

@@ -1,5 +1,5 @@
 import { LocationData } from '../../actions';
-import { NavigationProps } from '../../composables/Navigation';
+import { NavigationProps } from '../../components/composables/Navigation';
 interface GetNavigationItemsInput {
     destinationParts: string[];
     location: LocationData;

package/dist/types/components/StorageBrowser/controls/hooks/useActionCancel.d.ts

@@ -1,2 +1,2 @@
-import { ActionCancelProps } from '../../composables/ActionCancel';
+import { ActionCancelProps } from '../../components/composables/ActionCancel';
 export declare const useActionCancel: () => ActionCancelProps;

package/dist/types/components/StorageBrowser/controls/hooks/useActionDestination.d.ts

@@ -1,2 +1,2 @@
-import { ActionDestinationProps } from '../../composables/ActionDestination';
+import { ActionDestinationProps } from '../../components/composables/ActionDestination';
 export declare const useActionDestination: () => ActionDestinationProps;

package/dist/types/components/StorageBrowser/controls/hooks/useActionExit.d.ts

@@ -1,2 +1,2 @@
-import { ActionExitProps } from '../../composables/ActionExit';
+import { ActionExitProps } from '../../components/composables/ActionExit';
 export declare const useActionExit: () => ActionExitProps;

package/dist/types/components/StorageBrowser/controls/hooks/useActionStart.d.ts

@@ -1,2 +1,2 @@
-import { ActionStartProps } from '../../composables/ActionStart';
+import { ActionStartProps } from '../../components/composables/ActionStart';
 export declare const useActionStart: () => ActionStartProps;

package/dist/types/components/StorageBrowser/controls/hooks/useActionsList.d.ts

@@ -1,2 +1,2 @@
-import { ActionsListProps } from '../../composables/ActionsList';
+import { ActionsListProps } from '../../components/composables/ActionsList';
 export declare const useActionsList: () => ActionsListProps;

package/dist/types/components/StorageBrowser/controls/hooks/useAddFiles.d.ts

@@ -1,2 +1,2 @@
-import { AddFilesProps } from '../../composables/AddFiles';
+import { AddFilesProps } from '../../components/composables/AddFiles';
 export declare const useAddFiles: () => AddFilesProps;

package/dist/types/components/StorageBrowser/controls/hooks/useAddFolder.d.ts

@@ -1,2 +1,2 @@
-import { AddFolderProps } from '../../composables/AddFolder';
+import { AddFolderProps } from '../../components/composables/AddFolder';
 export declare const useAddFolder: () => AddFolderProps;

package/dist/types/components/StorageBrowser/controls/hooks/useDataRefresh.d.ts

@@ -1,2 +1,2 @@
-import { DataRefreshProps } from '../../composables/DataRefresh';
+import { DataRefreshProps } from '../../components/composables/DataRefresh';
 export declare const useDataRefresh: () => DataRefreshProps;

package/dist/types/components/StorageBrowser/controls/hooks/useDataTable.d.ts

@@ -1,2 +1,2 @@
-import { DataTableProps } from '../../composables/DataTable';
+import { DataTableProps } from '../../components';
 export declare const useDataTable: () => DataTableProps;

package/dist/types/components/StorageBrowser/controls/hooks/useDropZone.d.ts

@@ -1,4 +1,4 @@
-import { DropZoneProps } from '../../composables/DropZone';
+import { DropZoneProps } from '../../components/composables/DropZone';
 /**
  * This hook, not to be confused with the useDropZone vended from @aws-amplify/ui-react-core, is only intended for use
  * with its corresponding DropZone control.

package/dist/types/components/StorageBrowser/controls/hooks/useFolderNameField.d.ts

@@ -1,2 +1,2 @@
-import { FolderNameFieldProps } from '../../composables/FolderNameField';
+import { FolderNameFieldProps } from '../../components/composables/FolderNameField';
 export declare const useFolderNameField: () => FolderNameFieldProps;

package/dist/types/components/StorageBrowser/controls/hooks/useLoadingIndicator.d.ts

@@ -1,2 +1,2 @@
-import { LoadingIndicatorProps } from '../../composables/LoadingIndicator';
+import { LoadingIndicatorProps } from '../../components/composables/LoadingIndicator';
 export declare const useLoadingIndicator: () => LoadingIndicatorProps;

package/dist/types/components/StorageBrowser/controls/hooks/useMessage.d.ts

@@ -1,2 +1,2 @@
-import { MessageProps } from '../../composables/Message';
+import { MessageProps } from '../../components/composables/Message';
 export declare const useMessage: () => MessageProps;

package/dist/types/components/StorageBrowser/controls/hooks/useNavigation.d.ts

@@ -1,2 +1,2 @@
-import { NavigationProps } from '../../composables/Navigation';
+import { NavigationProps } from '../../components/composables/Navigation';
 export declare const useNavigation: () => NavigationProps;

package/dist/types/components/StorageBrowser/controls/hooks/useOverwriteToggle.d.ts

@@ -1,2 +1,2 @@
-import { OverwriteToggleProps } from '../../composables/OverwriteToggle';
+import { OverwriteToggleProps } from '../../components/composables/OverwriteToggle';
 export declare const useOverwriteToggle: () => OverwriteToggleProps;

package/dist/types/components/StorageBrowser/controls/hooks/usePagination.d.ts

@@ -1,2 +1,2 @@
-import { PaginationProps } from '../../composables/Pagination';
+import { PaginationProps } from '../../components/composables/Pagination';
 export declare const usePagination: () => PaginationProps;

package/dist/types/components/StorageBrowser/controls/hooks/useResolvedComposable.d.ts

@@ -1,3 +1,3 @@
 import React from 'react';
-import { Composables } from '../../composables/types';
+import { Composables } from '../../components/composables/types';
 export declare function useResolvedComposable<T extends React.ComponentType<any>, K extends keyof Composables>(DefaultComposable: T, name: K): (props: React.ComponentProps<T>) => React.JSX.Element;

package/dist/types/components/StorageBrowser/controls/hooks/useSearchField.d.ts

@@ -1,2 +1,2 @@
-import { SearchFieldProps } from '../../composables/SearchField';
+import { SearchFieldProps } from '../../components/composables/SearchField';
 export declare const useSearchField: () => SearchFieldProps;

package/dist/types/components/StorageBrowser/controls/hooks/useSearchSubfoldersToggle.d.ts

@@ -1,2 +1,2 @@
-import { SearchSubfoldersToggleProps } from '../../composables/SearchSubfoldersToggle';
+import { SearchSubfoldersToggleProps } from '../../components/composables/SearchSubfoldersToggle';
 export declare const useSearchSubfoldersToggle: () => SearchSubfoldersToggleProps;

package/dist/types/components/StorageBrowser/controls/hooks/useStatusDisplay.d.ts

@@ -1,2 +1,2 @@
-import { StatusDisplayProps } from '../../composables/StatusDisplay';
+import { StatusDisplayProps } from '../../components/composables/StatusDisplay';
 export declare const useStatusDisplay: () => StatusDisplayProps;

package/dist/types/components/StorageBrowser/controls/hooks/useTitle.d.ts

@@ -1,2 +1,2 @@
-import { TitleProps } from '../../composables/Title';
+import { TitleProps } from '../../components/composables/Title';
 export declare const useTitle: () => TitleProps;

package/dist/types/components/StorageBrowser/controls/index.d.ts

@@ -0,0 +1,22 @@
+export { ActionCancelControl } from './ActionCancelControl';
+export { ActionDestinationControl } from './ActionDestinationControl';
+export { ActionExitControl } from './ActionExitControl';
+export { ActionsListControl } from './ActionsListControl';
+export { ActionStartControl } from './ActionStartControl';
+export { AddFilesControl } from './AddFilesControl';
+export { AddFolderControl } from './AddFolderControl';
+export { ControlsContextProvider } from './context';
+export { DataRefreshControl } from './DataRefreshControl';
+export { DataTableControl } from './DataTableControl';
+export { DropZoneControl } from './DropZoneControl';
+export { FolderNameFieldControl } from './FolderNameFieldControl';
+export { LoadingIndicatorControl } from './LoadingIndicatorControl';
+export { MessageControl } from './MessageControl';
+export { NavigationControl } from './NavigationControl';
+export { OverwriteToggleControl } from './OverwriteToggleControl';
+export { PaginationControl } from './PaginationControl';
+export { SearchFieldControl } from './SearchFieldControl';
+export { SearchSubfoldersToggleControl } from './SearchSubfoldersToggleControl';
+export { StatusDisplayControl } from './StatusDisplayControl';
+export { TitleControl } from './TitleControl';
+export { ControlsContext } from './types';

package/dist/types/components/StorageBrowser/controls/types.d.ts

@@ -1,9 +1,6 @@
 import { LocationData } from '../actions';
-import { ActionListItem } from '../composables/ActionsList';
-import { DataTableSortHeader, DataTableProps } from '../composables/DataTable';
-import { MessageProps } from '../composables/Message';
-import { Composables } from '../composables/types';
-import { LocationState } from '../providers/store/location';
+import { ActionListItem, Composables, DataTableSortHeader, DataTableProps, MessageProps } from '../components';
+import { LocationState } from '../store';
 import { StatusCounts } from '../tasks';
 export interface Controls {
     props: React.ComponentProps<Composables[keyof Composables]>;

package/dist/types/components/StorageBrowser/{StorageBrowserDefault.d.ts → createStorageBrowser/StorageBrowserDefault.d.ts}

@@ -5,4 +5,4 @@ import React from 'react';
  * - render `LocationDetailView` on location selection
  * - render `ActionView` on action selection
  */
-export declare function StorageBrowserDefault(): React.JSX.Element;
+export default function StorageBrowserDefault(): React.JSX.Element;

package/dist/types/components/StorageBrowser/createStorageBrowser/createProvider.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import { CreateStorageBrowserInput, StorageBrowserProviderProps } from './types';
+export default function createProvider({ actions, components, config, }: CreateStorageBrowserInput): (props: StorageBrowserProviderProps) => React.JSX.Element;

package/dist/types/components/StorageBrowser/{createStorageBrowser.d.ts → createStorageBrowser/createStorageBrowser.d.ts}

@@ -1,4 +1,3 @@
-import { ExtendedActionConfigs } from './actions';
 import { CreateStorageBrowserInput, CreateStorageBrowserOutput } from './types';
 /**
  * Creates a `StorageBrowser` component and utility hooks from provided configuration `input`.
@@ -6,4 +5,4 @@ import { CreateStorageBrowserInput, CreateStorageBrowserOutput } from './types';
  * @param input - `StorageBrowser` auth, actions and ui configuration values
  * @returns `StorageBrowser` component, `useAction` and `useView` hooks
  */
-export declare function createStorageBrowser<Input extends CreateStorageBrowserInput, RInput extends Input['actions'] extends ExtendedActionConfigs ? Input['actions'] : ExtendedActionConfigs>(input: Input): CreateStorageBrowserOutput<RInput>;
+export default function createStorageBrowser<TInput extends CreateStorageBrowserInput, TActions extends NonNullable<TInput['actions']>>(input: TInput): CreateStorageBrowserOutput<TActions>;

package/dist/types/components/StorageBrowser/createStorageBrowser/index.d.ts

@@ -0,0 +1,2 @@
+export { default as createStorageBrowser } from './createStorageBrowser';
+export { CreateStorageBrowserInput, CreateStorageBrowserOutput, DerivedActionViews, DerivedActionViewType, StorageBrowserActions, StorageBrowserConfig, StorageBrowserProps, StorageBrowserProviderProps, StorageBrowserType, } from './types';

package/dist/types/components/StorageBrowser/createStorageBrowser/types.d.ts

@@ -0,0 +1,265 @@
+import React from 'react';
+import { CustomActionConfigs, DefaultActionConfigs, ExtendedActionConfigs, ListLocations, LocationData } from '../actions';
+import { StorageBrowserComponents } from '../components';
+import { GetLocationCredentials, RegisterAuthListener } from '../credentials';
+import { StorageBrowserDisplayText } from '../displayText';
+import { ErrorBoundaryType } from '../ErrorBoundary';
+import { StorageBrowserEventValue, StorageBrowserValue, StoreProviderProps } from '../store';
+import { DerivedActionHandlers, UseAction } from '../useAction';
+import { CopyViewType, CreateFolderViewType, DeleteViewType, UploadViewType, LocationActionViewType, LocationDetailViewType, LocationsViewType, UseView, StorageBrowserViews } from '../views';
+/**
+ * @description configuration properties
+ */
+export interface StorageBrowserConfig {
+    /**
+     * @description AWS account Id
+     */
+    accountId?: string;
+    /**
+     * @description custom S3 endpoint used in action handler calls
+     */
+    customEndpoint?: string;
+    /**
+     * @description location credentials retrieval handler
+     */
+    getLocationCredentials: GetLocationCredentials;
+    /**
+     * @description locations list handler
+     * @required
+     */
+    listLocations: ListLocations;
+    /**
+     *
+     * @description provided handler receives an `onStateChange` callback to be called from the consumer on auth status changes to clear in-memory credentials
+     * @required
+     *
+     * @example
+     * ```tsx
+     * // src/auth.ts
+     * class MyAuth {
+     *   // ...other private fields
+     *   private onStateChange: () => void | undefined;
+     *
+     *   registerAuthListener = (onStateChange: () => void) => {
+     *     // set `onStateChange` callback
+     *     this.onStateChange = onStateChange;
+     *   };
+     *
+     *   signOut() {
+     *     // ...do sign out stuff
+     *
+     *     // run `onStateChange` callback
+     *     this.onStateChange?.();
+     *   }
+     * }
+     *
+     * export const myAuth = new MyAuth();
+     *
+     * // src/storage-browser.ts
+     * import {
+     *   createStorageBrowser,
+     *   createManagedAuthAdapter
+     * } from '@aws-amplify/ui-react-storage/browser';
+     *
+     * import { myAuth } from '../auth.ts';
+     *
+     * const managedAuthAdapter = createManagedAuthAdapter({
+     *   accountId: myAuth.accountId,
+     *   credentialsProvider: myAuth.credentialsProvider,
+     *   region: myAuth.region,
+     *   registerAuthListener: myAuth.registerAuthListener,
+     * });
+     *
+     * export const { StorageBrowser } = createStorageBrowser({
+     *   config: managedAuthAdapter,
+     * });
+     * ```
+     */
+    registerAuthListener: RegisterAuthListener;
+    /**
+     * @description AWS account region
+     * @required
+     */
+    region: string;
+}
+export interface StorageBrowserActions {
+    default?: DefaultActionConfigs;
+    custom?: CustomActionConfigs;
+}
+/**
+ * @description configuration and options for `createStorageBrowser`
+ */
+export interface CreateStorageBrowserInput {
+    /**
+     * @description override and default `StorageBrowser` actions and action view configs
+     */
+    actions?: StorageBrowserActions;
+    /**
+     * @description `StorageBrowser` configuration properties
+     * @required
+     */
+    config: StorageBrowserConfig;
+    /**
+     * @description custom ErrorBoundary class. If omitted, a default ErrorBoundary is provided. To disable ErrorBoundary, set to `null`.
+     */
+    ErrorBoundary?: ErrorBoundaryType | null;
+    /**
+     * @description Overrides default `components` used within `StorageBrowser`
+     */
+    components?: StorageBrowserComponents;
+}
+/**
+ * `StorageBrowser` component properties
+ * @template TActionType Optional type of action names rendered by `LocationActionView`
+ * @template TViews Optional type of custom action view components.
+ */
+export interface StorageBrowserProps<TActionType = string, TViews = {}> {
+    /**
+     * @description provide to initialize the `StorageBrowser` with a default location, `actionType` or pagination values as an uncontrolled component
+     */
+    defaultValue?: StorageBrowserValue | null;
+    /**
+     * @description called on location and action change events. Provide with `value` prop for controlled component behavior or as a standalone prop
+     */
+    onValueChange?: (value: StorageBrowserEventValue) => void;
+    /**
+     * @description provide with `onValueChange` to use the `StorageBrowser` as a controlled component
+     */
+    value?: StorageBrowserValue | null;
+    /**
+     * @description Overrides default display string values. Supports resolving of static and dynamic text values and error messages
+     * @example
+     * ```tsx
+     * const myDisplayText = {
+     *   CreateFolderView: {
+     *     // static text
+     *     // default: "Create folder"
+     *     title: 'Add subfolder",
+     *
+     *     // dynamic text
+     *     // default: () => 'Folder name cannot contain "/", nor start or end with "."'
+     *     getValidationMessage?: (folderName) =>
+     *       `Folder name "${folderName}" cannot contain "/", nor start or end with "."`
+     *   }
+     * }
+     *
+     * <StorageBrowser displayText={{ displayText: myDisplayText }} />
+     * ```
+     */
+    displayText?: StorageBrowserDisplayText;
+    /**
+     * @description accepts default top level `views` overrides and custom `views` defined by the `actions` parameter of `createStorageBrowser`
+     */
+    views?: StorageBrowserViews<TActionType, TViews>;
+}
+/**
+ * @description `StorageBrowser.Provider` component properties
+ * @template TViews Optional type of custom action view components.
+ */
+export interface StorageBrowserProviderProps<TViews = {}> extends StoreProviderProps, Pick<StorageBrowserProps, 'defaultValue' | 'displayText' | 'onValueChange' | 'value'> {
+    /**
+     * @description accepts custom action views rendered by `LocationActionView`
+     */
+    views?: TViews;
+    /**
+     * @deprecated will be removed in a future major verison. Prefer `value` for controlled behavior or `defaultValue` for initializng `actionType`
+     * @description initial `actionType`, does not update
+     */
+    actionType?: string;
+    /**
+     * @deprecated will be removed in a future major verison. Prefer `value` for controlled behavior or `defaultValue` for initializng `actionType`
+     * @description initial `location` data, does not update
+     */
+    location?: LocationData;
+    /**
+     * @deprecated will be removed in a future major verison. Prefer `value` for controlled behavior or `defaultValue` for initializng `actionType`
+     * @description initial `location` subpath to establish navigation state, does not update
+     */
+    path?: string;
+}
+/**
+ * @description `StorageBrowser` component, provider and view components.
+ * @template TActionType Optional type of action names rendered by `LocationActionView`
+ * @template TViews Optional type of custom action view components.
+ */
+export interface StorageBrowserType<TActionType = string, TViews = {}> {
+    (props: StorageBrowserProps<TActionType, TViews>): React.JSX.Element;
+    displayName: string;
+    /**
+     * @description `StorageBrowser` React.Context provider. Composed `StorageBrowser` components must be a descendant of a `Provider` element
+     * @example
+     * ```tsx
+     * <StorageBrowser.Provider>
+     *   <Modal content={<StorageBrowser.UploadView />}>
+     * </StorageBrowser.Provider>
+     * ```
+     */
+    Provider: (props: StorageBrowserProviderProps<TViews>) => React.JSX.Element;
+    /**
+     * @description utility view aggregating all action views. Can be used to render a standalone action view
+     * @example
+     * ```tsx
+     * <StorageBrowser.LocationActionView type="copy" />
+     * ```
+     */
+    LocationActionView: LocationActionViewType<TActionType>;
+    /**
+     * @description displays data related to the selected or provided `location` and action selection
+     */
+    LocationDetailView: LocationDetailViewType;
+    /**
+     * @description entry point view displaying `locations` returned from `listLocations`
+     */
+    LocationsView: LocationsViewType;
+    /**
+     * @description standalone composable default action view components
+     */
+    CopyView: CopyViewType;
+    CreateFolderView: CreateFolderViewType;
+    DeleteView: DeleteViewType;
+    UploadView: UploadViewType;
+}
+type NonDefaultActionType<T = string> = Exclude<T, keyof DefaultActionConfigs>;
+/**
+ * @internal
+ * @unstable interface subject to change, not recommended for public use
+ * @description utility type resolving available custom action view component slots
+ */
+export type DerivedActionViews<T extends StorageBrowserActions> = {
+    [K in keyof T['custom'] as K extends NonDefaultActionType<K> ? T['custom'][K] extends {
+        viewName: `${string}View`;
+    } ? T['custom'][K]['viewName'] : never : never]?: () => React.JSX.Element | null;
+};
+/**
+ * @internal @unstable interface subject to change, not recommended for public use
+ * @description utility type of excluded action keys that do not have a corresponding action view
+ */
+type DefaultActionWithoutViewType = 'download';
+/**
+ * @internal @unstable interface subject to change, not recommended for public use
+ * @description utility type resolving available location action view types
+ */
+export type DerivedActionViewType<T extends StorageBrowserActions> = keyof {
+    [K in keyof T['custom'] as K extends NonDefaultActionType<K> ? T['custom'][K] extends {
+        viewName: `${string}View`;
+    } ? K : never : never]?: any;
+} | Exclude<keyof DefaultActionConfigs, DefaultActionWithoutViewType>;
+/**
+ * @description return values of `createStorageBrowser`
+ * @template TActions Type of `actions` passed to `createStorageBrowser`
+ */
+export interface CreateStorageBrowserOutput<TActions extends StorageBrowserActions = ExtendedActionConfigs> {
+    /**
+     * @description `StorageBrowser` component and subcomponents
+     */
+    StorageBrowser: StorageBrowserType<DerivedActionViewType<TActions>, DerivedActionViews<TActions>>;
+    /**
+     * @description action handler utility hook
+     */
+    useAction: UseAction<DerivedActionHandlers<TActions>>;
+    /**
+     * @description view state utility hook
+     */
+    useView: UseView;
+}
+export {};

package/dist/types/components/StorageBrowser/credentials/{store → credentialsStore}/create.d.ts

@@ -1,2 +1,2 @@
-import { CreateLocationCredentialsStoreInput, LocationCredentialsStore } from '../types';
+import { CreateLocationCredentialsStoreInput, LocationCredentialsStore } from './types';
 export declare const createLocationCredentialsStore: (input: CreateLocationCredentialsStoreInput) => LocationCredentialsStore;

package/dist/types/components/StorageBrowser/credentials/credentialsStore/index.d.ts

@@ -0,0 +1,2 @@
+export { createLocationCredentialsStore } from './create';
+export { GetLocationCredentials, GetLocationCredentialsInput, CredentialsLocation, CreateLocationCredentialsStoreInput, LocationCredentialsStore, } from './types';

package/dist/types/components/StorageBrowser/credentials/{store → credentialsStore}/registry.d.ts

@@ -1,5 +1,5 @@
 import { AWSTemporaryCredentials } from '../../storage-internal';
-import { GetLocationCredentials, CredentialsLocation } from '../types';
+import { GetLocationCredentials, CredentialsLocation } from './types';
 interface StoreRegistrySymbol {
     readonly value: symbol;
 }

package/dist/types/components/StorageBrowser/credentials/credentialsStore/store.d.ts

@@ -0,0 +1,15 @@
+import { AWSTemporaryCredentials } from '../../storage-internal';
+import { CredentialsLocation, GetLocationCredentials, LruLocationCredentialsStore } from './types';
+/**
+ * @internal
+ */
+export declare const initStore: (refreshHandler: GetLocationCredentials, size?: number) => LruLocationCredentialsStore;
+export declare const getCacheValue: (store: LruLocationCredentialsStore, location: CredentialsLocation) => AWSTemporaryCredentials | null;
+/**
+ * Fetch new credentials value with refresh handler and cache the result in
+ * LRU cache.
+ * @internal
+ */
+export declare const fetchNewValue: (store: LruLocationCredentialsStore, location: CredentialsLocation) => Promise<{
+    credentials: AWSTemporaryCredentials;
+}>;

package/dist/types/components/StorageBrowser/credentials/credentialsStore/types.d.ts

@@ -0,0 +1,44 @@
+import { LocationPermissions } from '../../actions';
+import { AWSTemporaryCredentials, LocationCredentialsProvider, LocationCredentials } from '../../storage-internal';
+export interface CredentialsLocation {
+    scope: string;
+    permissions: LocationPermissions;
+}
+export interface CreateLocationCredentialsStoreInput {
+    handler: GetLocationCredentials;
+}
+export interface LocationCredentialsStore {
+    /**
+     * Get location-specific credentials. It uses a cache internally to optimize performance when
+     * getting credentials for the same location. It will refresh credentials if they expire or
+     * when forced to.
+     */
+    getProvider(option: CredentialsLocation): LocationCredentialsProvider;
+    /**
+     * Invalidate cached credentials and force subsequent calls to get location-specific
+     * credentials to throw. It also makes subsequent calls to `getCredentialsProviderForLocation`
+     * to throw.
+     */
+    destroy(): void;
+}
+export type GetLocationCredentialsInput = CredentialsLocation;
+export type GetLocationCredentialsOutput = LocationCredentials;
+export type GetLocationCredentials = (input: GetLocationCredentialsInput) => Promise<GetLocationCredentialsOutput>;
+export interface CredentialsStoreValue extends CredentialsLocation {
+    credentials?: AWSTemporaryCredentials;
+    inflightCredentials?: Promise<{
+        credentials: AWSTemporaryCredentials;
+    }>;
+}
+export type CacheKey = `${string}_${string}`;
+/**
+ * LRU implementation for Location Credentials Store
+ * O(n) for get and set for simplicity.
+ *
+ * @internal
+ */
+export interface LruLocationCredentialsStore {
+    capacity: number;
+    refreshHandler: GetLocationCredentials;
+    values: Map<CacheKey, CredentialsStoreValue>;
+}

package/dist/types/components/StorageBrowser/credentials/index.d.ts

@@ -0,0 +1,3 @@
+export { CredentialsProvider, useCredentials } from './context';
+export { createLocationCredentialsStore, GetLocationCredentials, GetLocationCredentialsInput, CredentialsLocation, CreateLocationCredentialsStoreInput, LocationCredentialsStore, } from './credentialsStore';
+export { CredentialsProviderProps, GetCredentials, RegisterAuthListener, } from './types';