@mercurjs/dashboard-shared 2.3.2-canary.0 → 2.3.2-canary.2

package/dist/index.d.ts

@@ -1,20 +1,23 @@
-import { QueryKey, UseQueryOptions } from '@tanstack/react-query';
-import { ProductChangeActionDTO, HttpTypes, AttributeType, ProductAttributeBatchInput, ProductAttributeDTO, OfferDTO } from '@mercurjs/types';
+import { QueryKey, UseQueryOptions, QueryClient } from '@tanstack/react-query';
+import { ProductChangeActionDTO, HttpTypes as HttpTypes$1, AttributeType, ProductAttributeBatchInput, ProductAttributeDTO, OfferDTO } from '@mercurjs/types';
+import { HttpTypes } from '@medusajs/types';
+import { z, ZodObject } from 'zod';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React$1 from 'react';
-import React__default, { ReactNode, PropsWithChildren, ComponentPropsWithoutRef, CSSProperties, ComponentType, Ref, RefCallback } from 'react';
-import { Tooltip, Heading, Text, DataTableColumnDef, DataTableFilter, DataTableCommand, DataTableEmptyStateProps, DataTableRowSelectionState, DataTableRow, Drawer, FocusModal, ProgressStatus } from '@medusajs/ui';
+import React__default, { ReactNode, PropsWithChildren, ComponentPropsWithoutRef, CSSProperties, ComponentType, ComponentProps, ForwardRefExoticComponent, Ref, RefAttributes, RefCallback } from 'react';
+import { Tooltip, Heading, Text, DataTableColumnDef, DataTableFilter, DataTableCommand, DataTableEmptyStateProps, DataTableRowSelectionState, DataTableRow, Select, Input, Table, Drawer, FocusModal, ProgressStatus } from '@medusajs/ui';
 import * as react_hook_form from 'react-hook-form';
 import { FieldValues, FieldPath, ControllerProps, UseFormReturn, Control, UseFormProps } from 'react-hook-form';
 import { Label, Slot } from 'radix-ui';
 import { Link, Path } from 'react-router-dom';
 import { UniqueIdentifier } from '@dnd-kit/core';
 import * as _tanstack_react_table from '@tanstack/react-table';
-import { CellContext, Row, ColumnDef, ColumnDefTemplate, HeaderContext, Table, RowSelectionState, OnChangeFn } from '@tanstack/react-table';
+import { CellContext, Row, ColumnDef, ColumnDefTemplate, HeaderContext, Table as Table$1, RowSelectionState, OnChangeFn } from '@tanstack/react-table';
 import { TFunction } from 'i18next';
-import { z, ZodObject } from 'zod';
 import { ClientError } from '@mercurjs/client';
-import { CustomFieldsConfig, NavItemOverride, CustomFormField, CustomDisplayField, SectionAction, CustomListExtension } from '@mercurjs/dashboard-sdk';
+import * as react_currency_input_field from 'react-currency-input-field';
+import * as _mercurjs_dashboard_sdk from '@mercurjs/dashboard-sdk';
+import { PermissionsContextValue, UserPolicy, PermissionsRequirementsContextValue, Permission, PermissionResource, PermissionOperation, CustomFieldsConfig, NavItemOverride, CustomFormField, CustomDisplayField, SectionAction, CustomListExtension } from '@mercurjs/dashboard-sdk';
 
 type TQueryKey<TKey, TListQuery = any, TDetailQuery = string> = {
     all: readonly [TKey];
@@ -93,6 +96,130 @@ declare const formatFieldValue: (value: unknown, field?: string, booleanLabels?:
 declare const buildProductChangeView: (actions: ProductChangeActionDTO[]) => ProductChangeView;
 declare const productChangeViewHasContent: (view: ProductChangeView) => boolean;
 
+declare const isSameAddress: (a?: HttpTypes.AdminOrderAddress | null, b?: HttpTypes.AdminOrderAddress | null) => boolean;
+declare const getFormattedAddress: ({ address, }: {
+    address?: {
+        first_name?: string | null;
+        last_name?: string | null;
+        company?: string | null;
+        address_1?: string | null;
+        address_2?: string | null;
+        city?: string | null;
+        postal_code?: string | null;
+        province?: string | null;
+        country_code?: string | null;
+        country?: {
+            display_name?: string | null;
+        } | null;
+    } | null;
+}) => string[];
+declare const getFormattedCountry: (countryCode: string | null | undefined) => string;
+
+interface StaticCountry extends Required<Omit<HttpTypes.AdminRegionCountry, "id">> {
+}
+declare function getCountryByIso2(iso2: string | null): StaticCountry | undefined;
+declare const countries: StaticCountry[];
+
+/** This file is auto-generated. Do not modify it manually. */
+type CurrencyInfo = {
+    code: string;
+    name: string;
+    symbol_native: string;
+    decimal_digits: number;
+};
+declare const currencies: Record<string, CurrencyInfo>;
+declare function getCurrencySymbol(code: string): string;
+
+declare const getDecimalDigits: (currency: string) => number;
+/**
+ * Returns a formatted amount based on the currency code using the browser's locale
+ * @param amount - The amount to format
+ * @param currencyCode - The currency code to format the amount in
+ * @returns - The formatted amount
+ *
+ * @example
+ * getFormattedAmount(10, "usd") // '$10.00' if the browser's locale is en-US
+ * getFormattedAmount(10, "usd") // '10,00 $' if the browser's locale is fr-FR
+ */
+declare const getLocaleAmount: (amount: number, currencyCode: string) => string;
+declare const getNativeSymbol: (currencyCode: string) => string;
+/**
+ * In some cases we want to display the amount with the currency code and symbol,
+ * in the format of "symbol amount currencyCode". This breaks from the
+ * user's locale and is only used in cases where we want to display the
+ * currency code and symbol explicitly, e.g. for totals.
+ */
+declare const getStylizedAmount: (amount: number, currencyCode: string) => string;
+/**
+ * Returns true if the amount is less than the rounding error for the currency
+ * @param amount - The amount to check
+ * @param currencyCode - The currency code to check the amount in
+ * @returns - True if the amount is less than the rounding error, false otherwise
+ *
+ * For example returns true if amount is < 0.005 for a USD | EUR etc.
+ */
+declare const isAmountLessThenRoundingError: (amount: number, currencyCode: string) => boolean;
+
+declare const queryClient: QueryClient;
+
+declare const AddressSchema: z.ZodObject<{
+    first_name: z.ZodString;
+    last_name: z.ZodString;
+    company: z.ZodOptional<z.ZodString>;
+    address_1: z.ZodString;
+    address_2: z.ZodOptional<z.ZodString>;
+    city: z.ZodString;
+    postal_code: z.ZodString;
+    province: z.ZodOptional<z.ZodString>;
+    country_code: z.ZodString;
+    phone: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    first_name: string;
+    last_name: string;
+    address_1: string;
+    city: string;
+    postal_code: string;
+    country_code: string;
+    address_2?: string | undefined;
+    province?: string | undefined;
+    company?: string | undefined;
+    phone?: string | undefined;
+}, {
+    first_name: string;
+    last_name: string;
+    address_1: string;
+    city: string;
+    postal_code: string;
+    country_code: string;
+    address_2?: string | undefined;
+    province?: string | undefined;
+    company?: string | undefined;
+    phone?: string | undefined;
+}>;
+declare const EmailSchema: z.ZodObject<{
+    email: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+}, {
+    email: string;
+}>;
+declare const TransferOwnershipSchema: z.ZodEffects<z.ZodObject<{
+    current_owner_id: z.ZodString;
+    new_owner_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    current_owner_id: string;
+    new_owner_id: string;
+}, {
+    current_owner_id: string;
+    new_owner_id: string;
+}>, {
+    current_owner_id: string;
+    new_owner_id: string;
+}, {
+    current_owner_id: string;
+    new_owner_id: string;
+}>;
+
 type Action = {
     icon: ReactNode;
     label: string;
@@ -212,16 +339,16 @@ declare const ConfirmPrompt: ({ open, onOpenChange, variant, title, description,
 
 declare const CustomerInfo: {
     ID: ({ data }: {
-        data: HttpTypes.AdminOrder;
+        data: HttpTypes$1.AdminOrder;
     }) => react_jsx_runtime.JSX.Element;
     Company: ({ data }: {
-        data: HttpTypes.AdminOrder;
+        data: HttpTypes$1.AdminOrder;
     }) => react_jsx_runtime.JSX.Element | null;
     Contact: ({ data }: {
-        data: HttpTypes.AdminOrder;
+        data: HttpTypes$1.AdminOrder;
     }) => react_jsx_runtime.JSX.Element;
     Addresses: ({ data }: {
-        data: HttpTypes.AdminOrder;
+        data: HttpTypes$1.AdminOrder;
     }) => react_jsx_runtime.JSX.Element;
 };
 
@@ -709,8 +836,8 @@ declare function createDataGridHelper<TData, TFieldValues extends FieldValues>()
 
 type CreateDataGridPriceColumnsProps<TData, TFieldValues extends FieldValues> = {
     currencies?: string[];
-    regions?: HttpTypes.AdminRegion[];
-    pricePreferences?: HttpTypes.AdminPricePreference[];
+    regions?: HttpTypes$1.AdminRegion[];
+    pricePreferences?: HttpTypes$1.AdminPricePreference[];
     isReadyOnly?: (context: FieldContext<TData>) => boolean;
     getFieldName: (context: FieldContext<TData>, value: string) => FieldPath<TFieldValues> | null;
     t: TFunction;
@@ -802,52 +929,10 @@ type QueryProps = {
 };
 declare const Query: ({ placeholder }: QueryProps) => react_jsx_runtime.JSX.Element;
 
-declare const AddressSchema: z.ZodObject<{
-    first_name: z.ZodString;
-    last_name: z.ZodString;
-    company: z.ZodOptional<z.ZodString>;
-    address_1: z.ZodString;
-    address_2: z.ZodOptional<z.ZodString>;
-    city: z.ZodString;
-    postal_code: z.ZodString;
-    province: z.ZodOptional<z.ZodString>;
-    country_code: z.ZodString;
-    phone: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    first_name: string;
-    last_name: string;
-    address_1: string;
-    city: string;
-    postal_code: string;
-    country_code: string;
-    company?: string | undefined;
-    address_2?: string | undefined;
-    province?: string | undefined;
-    phone?: string | undefined;
-}, {
-    first_name: string;
-    last_name: string;
-    address_1: string;
-    city: string;
-    postal_code: string;
-    country_code: string;
-    company?: string | undefined;
-    address_2?: string | undefined;
-    province?: string | undefined;
-    phone?: string | undefined;
-}>;
-declare const EmailSchema: z.ZodObject<{
-    email: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    email: string;
-}, {
-    email: string;
-}>;
-
 type AddressFieldValues = z.infer<typeof AddressSchema>;
 type AddressFormProps = {
     control: Control<AddressFieldValues>;
-    countries?: HttpTypes.AdminRegionCountry[];
+    countries?: HttpTypes$1.AdminRegionCountry[];
     layout: "grid" | "stack";
 };
 declare const AddressForm: ({ control, countries, layout, }: AddressFormProps) => react_jsx_runtime.JSX.Element;
@@ -914,6 +999,93 @@ type AttributeValueInputProps = {
 };
 declare const AttributeValueInput: ({ type, value, onChange, availableValues, placeholder, }: AttributeValueInputProps) => react_jsx_runtime.JSX.Element;
 
+type ChipInputProps = {
+    value?: string[];
+    onChange?: (value: string[]) => void;
+    onBlur?: () => void;
+    name?: string;
+    disabled?: boolean;
+    allowDuplicates?: boolean;
+    showRemove?: boolean;
+    variant?: "base" | "contrast";
+    placeholder?: string;
+    className?: string;
+};
+declare const ChipInput: React$1.ForwardRefExoticComponent<ChipInputProps & React$1.RefAttributes<HTMLInputElement>>;
+
+type ComboboxOption = {
+    value: string;
+    label: string;
+    disabled?: boolean;
+};
+type Value = string[] | string;
+interface ComboboxProps<T extends Value = Value> extends Omit<ComponentPropsWithoutRef<"input">, "onChange" | "value"> {
+    value?: T;
+    onChange?: (value?: T) => void;
+    searchValue?: string;
+    onSearchValueChange?: (value: string) => void;
+    options: ComboboxOption[];
+    fetchNextPage?: () => void;
+    isFetchingNextPage?: boolean;
+    onCreateOption?: (value: string) => void;
+    noResultsPlaceholder?: ReactNode;
+    allowClear?: boolean;
+    forceHideInput?: boolean;
+}
+declare const Combobox: <T extends Value = string>(props: ComboboxProps<T> & React$1.RefAttributes<HTMLInputElement>) => ReactNode;
+
+type CountrySelectProps = ComponentPropsWithoutRef<typeof Select> & {
+    placeholder?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+};
+declare const CountrySelect: ComponentType<CountrySelectProps>;
+
+type HandleInputProps = ComponentProps<typeof Input> & {
+    prefix?: string;
+};
+declare const HandleInput: ComponentType<HandleInputProps>;
+
+type InputProps = ComponentProps<typeof Input>;
+declare const DeprecatedPercentageInput: ForwardRefExoticComponent<InputProps>;
+declare const PercentageInput: ForwardRefExoticComponent<Omit<Pick<Omit<React$1.DetailedHTMLProps<React$1.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & {
+    ref?: React$1.RefObject<HTMLInputElement> | ((instance: HTMLInputElement | null) => void | React$1.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof React$1.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | null | undefined;
+}, "list" | "title" | "name" | "is" | "style" | "type" | "ref" | "content" | "onClick" | "form" | "slot" | "pattern" | "key" | "defaultChecked" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "datatype" | "inlist" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "inputMode" | "exportparts" | "part" | "children" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChange" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "formAction" | "formEncType" | "formMethod" | "formNoValidate" | "formTarget" | "size" | "autoComplete" | "minLength" | "readOnly" | "required" | "multiple" | "accept" | "src" | "alt" | "height" | "max" | "min" | "width" | "capture" | "checked"> & {
+    allowDecimals?: boolean;
+    allowNegativeValue?: boolean;
+    id?: string;
+    maxLength?: number;
+    className?: string;
+    customInput?: React$1.ElementType;
+    decimalsLimit?: number;
+    decimalScale?: number;
+    defaultValue?: number | string;
+    disabled?: boolean;
+    fixedDecimalLength?: number;
+    onValueChange?: (value: string | undefined, name?: string | undefined, values?: react_currency_input_field.CurrencyInputOnChangeValues) => void;
+    placeholder?: string;
+    prefix?: string;
+    suffix?: string;
+    step?: number;
+    decimalSeparator?: string;
+    groupSeparator?: string;
+    disableGroupSeparators?: boolean;
+    disableAbbreviations?: boolean;
+    intlConfig?: react_currency_input_field.IntlConfig;
+    transformRawValue?: (rawValue: string) => string;
+    formatValueOnBlur?: boolean;
+    value?: string | number;
+}, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
+
+type ProvinceSelectProps = ComponentPropsWithoutRef<typeof Select> & {
+    placeholder?: string;
+    defaultValue?: string;
+    country_code: string;
+    valueAs?: "iso_2" | "name";
+    onChange?: (value: string) => void;
+};
+declare const ProvinceSelect: ComponentType<ProvinceSelectProps>;
+
 interface PageProps<TData> {
     children: ReactNode;
     data?: TData;
@@ -931,6 +1103,9 @@ declare const TwoColumnPage: (<TData>({ children, data, showJSON, showMetadata,
     Sidebar: ({ children, className, ...props }: ComponentPropsWithoutRef<"div">) => react_jsx_runtime.JSX.Element;
 };
 
+type LocalizedTablePaginationProps = Omit<ComponentPropsWithoutRef<typeof Table.Pagination>, "translations">;
+declare const LocalizedTablePagination: React$1.ForwardRefExoticComponent<LocalizedTablePaginationProps & React$1.RefAttributes<HTMLDivElement>>;
+
 type RouteModalFormProps<TFieldValues extends FieldValues> = PropsWithChildren<{
     form: UseFormReturn<TFieldValues>;
     blockSearchParams?: boolean;
@@ -1123,7 +1298,7 @@ interface DataTableRootProps<TData> {
     /**
      * The table instance to render
      */
-    table: Table<TData>;
+    table: Table$1<TData>;
     /**
      * The columns to render
      */
@@ -1261,6 +1436,17 @@ type HeaderProps = {
 declare const TextCell: ({ text, align, maxWidth }: CellProps) => react_jsx_runtime.JSX.Element;
 declare const TextHeader: ({ text, align }: HeaderProps) => react_jsx_runtime.JSX.Element;
 
+declare const ErrorBoundary: () => react_jsx_runtime.JSX.Element;
+
+declare function genericForwardRef<T, P = {}>(render: (props: P, ref: Ref<T>) => ReactNode): (props: P & RefAttributes<T>) => ReactNode;
+
+/**
+ * A form that can only be submitted when using the meta or control key.
+ */
+declare const KeyboundForm: React__default.ForwardRefExoticComponent<React__default.FormHTMLAttributes<HTMLFormElement> & React__default.RefAttributes<HTMLFormElement>>;
+
+declare const VisuallyHidden: ({ children }: PropsWithChildren) => react_jsx_runtime.JSX.Element;
+
 declare const useCombinedRefs: <T>(...refs: (Ref<T> | undefined)[]) => RefCallback<T>;
 
 /**
@@ -1323,6 +1509,151 @@ type QueryParams<T extends string> = {
 };
 declare function useQueryParams<T extends string>(keys: T[], prefix?: string): QueryParams<T>;
 
+declare const PermissionsContext: React$1.Context<PermissionsContextValue | null>;
+
+interface PermissionsProviderProps extends PropsWithChildren {
+    policy: UserPolicy | null;
+    isLoading?: boolean;
+    /**
+     * Whether the RBAC feature flag is enabled. When `false`, every permission
+     * check resolves to `true`.
+     */
+    isRbacEnabled?: boolean;
+}
+declare const PermissionsProvider: ({ policy, isLoading, isRbacEnabled, children, }: PermissionsProviderProps) => react_jsx_runtime.JSX.Element;
+
+declare const PermissionsRequirementsContext: React$1.Context<PermissionsRequirementsContextValue | null>;
+
+/**
+ * Collects the permission requirements declared by descendant guards so a
+ * page can surface them (see `RequiredPermissionsSection`). Mount it around a
+ * page body; guards work fine without it.
+ */
+declare const PermissionsRequirementsProvider: ({ children, }: PropsWithChildren) => react_jsx_runtime.JSX.Element;
+
+interface BasePermissionProps {
+    source?: string;
+    enabled?: boolean;
+}
+interface WithPermission extends BasePermissionProps {
+    permission: Permission;
+    permissions?: never;
+    resource?: never;
+    operation?: never;
+    requireAll?: never;
+}
+interface WithPermissions extends BasePermissionProps {
+    permissions: Permission[];
+    /** If true, ALL permissions are required. Defaults to ANY. */
+    requireAll?: boolean;
+    permission?: never;
+    resource?: never;
+    operation?: never;
+}
+interface WithResourceOperation extends BasePermissionProps {
+    resource: PermissionResource;
+    operation: PermissionOperation;
+    permission?: never;
+    permissions?: never;
+    requireAll?: never;
+}
+type PermissionProps = WithPermission | WithPermissions | WithResourceOperation;
+declare const resolvePermissionProps: (props: PermissionProps) => {
+    permissions: Permission[] | null;
+    requireAll: boolean;
+};
+
+type PermissionsRequirementProps = PropsWithChildren<PermissionProps>;
+/**
+ * Declares a permission requirement for the surrounding subtree without
+ * gating it. Use `PermissionGuard` when the children should be hidden.
+ */
+declare const PermissionsRequirement: ({ children, source, enabled, ...props }: PermissionsRequirementProps) => react_jsx_runtime.JSX.Element;
+
+type PermissionGuardProps = PropsWithChildren<PermissionProps & {
+    /** Rendered when access is denied. Nothing renders when omitted. */
+    fallback?: ReactNode;
+    showLoading?: boolean;
+    loadingComponent?: ReactNode;
+}>;
+/**
+ * Hides its children unless the actor holds the declared permission, and
+ * registers the requirement so the page can surface what is missing.
+ *
+ * @example
+ * ```tsx
+ * <PermissionGuard resource="product" operation="create">
+ *   <Button>Create</Button>
+ * </PermissionGuard>
+ * ```
+ */
+declare const PermissionGuard: ({ children, fallback, showLoading, loadingComponent, source, enabled, ...props }: PermissionGuardProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Route-level guard. Mount as a route's `element` and declare the requirement
+ * on the route's `handle`. Unlike `PermissionGuard`, `requireAll` defaults to
+ * `true` here.
+ *
+ * @example
+ * ```tsx
+ * {
+ *   path: "roles",
+ *   element: <RoutePermissionGuard />,
+ *   handle: { permissions: "rbac_role:read" },
+ *   children: [...],
+ * }
+ * ```
+ */
+declare const RoutePermissionGuard: () => react_jsx_runtime.JSX.Element;
+
+/**
+ * Renders the requirements that descendant guards registered with the nearest
+ * `PermissionsRequirementsProvider`. Renders nothing when RBAC is off.
+ */
+declare const RequiredPermissionsSection: () => react_jsx_runtime.JSX.Element | null;
+
+/**
+ * @example
+ * ```tsx
+ * const { can, hasPermission } = usePermissions()
+ *
+ * if (can("customer", "create")) { ... }
+ * if (hasPermission("customer:read")) { ... }
+ * ```
+ */
+declare const usePermissions: () => _mercurjs_dashboard_sdk.PermissionsContextValue;
+
+interface UseRegisterPermissionsOptions {
+    /** If true, ALL permissions are required. Defaults to ANY. */
+    requireAll?: boolean;
+    source?: string;
+    enabled?: boolean;
+}
+/**
+ * Declares what the calling subtree needs. No-ops when there is no
+ * `PermissionsRequirementsProvider` above it.
+ */
+declare const useRegisterPermissions: (permissions: Permission[] | null | undefined, options?: UseRegisterPermissionsOptions) => void;
+
+declare const useRequiredPermissions: () => _mercurjs_dashboard_sdk.PermissionRequirement[];
+
+/**
+ * @example
+ * ```tsx
+ * const { canCreate } = useResourcePermissions("product")
+ * {canCreate && <Button>Create</Button>}
+ * ```
+ */
+declare const useResourcePermissions: (resource: PermissionResource) => {
+    canRead: boolean;
+    canCreate: boolean;
+    canUpdate: boolean;
+    canDelete: boolean;
+    can: (operation: "read" | "create" | "update" | "delete") => boolean;
+    resource: PermissionResource;
+    isLoading: boolean;
+};
+
 type WidgetPlacement = "before" | "after";
 type Widget = {
     Component: ComponentType<{
@@ -1685,12 +2016,12 @@ declare const buildOfferGridData: (offers: OfferDTO[], products: ProductWithVari
     variantIdByOffer: Record<string, string>;
 };
 
-declare const getPriceListStatus: (t: TFunction<"translation">, priceList: HttpTypes.AdminPriceList) => {
+declare const getPriceListStatus: (t: TFunction<"translation">, priceList: HttpTypes$1.AdminPriceList) => {
     color: "green" | "grey" | "orange" | "red";
     text: string;
     status: string;
 };
-declare const isProductRow: (row: HttpTypes.AdminProduct | HttpTypes.AdminProductVariant) => row is HttpTypes.AdminProduct;
+declare const isProductRow: (row: HttpTypes$1.AdminProduct | HttpTypes$1.AdminProductVariant) => row is HttpTypes$1.AdminProduct;
 type OfferCurrencyPrice = {
     amount?: string | number;
 };
@@ -1705,7 +2036,7 @@ type ExtractableOffers = Record<string, ExtractableOffer>;
  * carries its `offer_id` rule so the override is scoped to that seller's offer
  * and never leaks onto another seller's offer of the same variant.
  */
-declare const extractPricesFromOffers: (offers: ExtractableOffers, regions: HttpTypes.AdminRegion[]) => {
+declare const extractPricesFromOffers: (offers: ExtractableOffers, regions: HttpTypes$1.AdminRegion[]) => {
     amount: number;
     rules: {
         region_id?: string | undefined;
@@ -1715,4 +2046,4 @@ declare const extractPricesFromOffers: (offers: ExtractableOffers, regions: Http
     variant_id: string;
 }[];
 
-export { type Action, type ActionGroup, ActionMenu, AddressForm, type AttributeChange, type AttributeChangeKind, AttributeValueInput, BadgeListSummary, ChipGroup, CodeCell, CodeHeader, type Command, ConditionalTooltip, ConfirmPrompt, type ConfirmPromptProps, type CoreNavItem, CreatedAtCell, CreatedAtHeader, type CustomFieldsModule, CustomerInfo, DataGrid, DataTable, DateCell, DateHeader, DateRangeDisplay, DisplayExtensionZone, type DisplayExtensionZoneProps, DisplayField, type DisplayFieldProps, DisplaySection, type DisplaySectionField, type DisplaySectionProps, type EditAttributeAttribute, EditAttributeForm, type EditAttributeFormProps, EmailCell, EmailForm, EmailHeader, type ExtendableTable, ExtensionProvider, type ExtensionProviderProps, ExtensionRegistry, type ExtractableOffer, type ExtractableOffers, type FieldDiff, FilePreview, type FileType, FileUpload, type FileUploadProps, type Filter, FilterGroup, Form, FormExtensionZone, type FormExtensionZoneProps, GeneralSectionSkeleton, HeadingSkeleton, IconAvatar, IconButtonSkeleton, ImageAvatar, type ImageRef, IncludesTaxTooltip, InfiniteList, JsonViewSection, JsonViewSectionSkeleton, LinkButton, ListBadge, ListSummary, Listicle, type ListicleProps, type MediaDiff, MetadataForm, MetadataSection, MoneyAmountCell, NameCell, NameHeader, type NavigationModule, NoRecords, type NoRecordsProps, NoResults, type NoResultsProps, OrderBy, PlaceholderCell, PriceListDateStatus, type PriceListGridGroupRow, type PriceListGridOfferRow, type PriceListGridRow, PriceListStatus, PriceListType, type ProductAttributeBatchPayload, ProductAttributeSection, type ProductAttributeSectionProps, type ProductChangeAttribute, ProductChangePanel, type ProductChangePanelProps, type ProductChangeProduct, type ProductChangeResolvers, type ProductChangeVariant, type ProductChangeView, ProgressBar, Query, REFERENCE_FIELDS, type ReferenceField, type ResolvedAttribute, type ResolvedDisplays, type ResolvedFormField, RouteDrawer, RouteFocusModal, SectionRow, type SectionRowProps, SegmentedControl, type SegmentedControlOption, SidebarLink, type SidebarLinkProps, SingleColumnPage, SingleColumnPageSkeleton, Skeleton, SortableList, SortableTree, StackedDrawer, StackedFocusModal, StatusCell, SwitchBox, type TQueryKey, type TabDefinition, TabbedForm, TableFooterSkeleton, TableSectionSkeleton, TableSkeleton, TextCell, TextHeader, TextSkeleton, Thumbnail, TwoColumnPage, TwoColumnPageSkeleton, type UseExtendableFormProps, type UseExtendableTableProps, type UseQueryOptionsWrapper, type VariantGroup, type Widget, type WidgetModule, type WidgetPlacement, WidgetZone, type WidgetZoneProps, type ZoneWidgets, _DataTable, applyNavOverrides, buildAdditionalDataDefaults, buildAdditionalDataSchema, buildOfferGridData, buildProductChangeView, createDataGridHelper, createDataGridPriceColumns, createFormHelper, extractPricesFromOffers, extractReferenceIds, formatFieldValue, getExtensionRegistry, getLinkQuery, getPriceListStatus, humanizeFieldName, isImageList, isPriceListGroupRow, isProductRow, isReferenceField, linkFields, productChangeViewHasContent, queryKeysFactory, useCombinedRefs, useCommandHistory, useDataTable, useDate, useDisplayFieldOverride, useDocumentDirection, useExtendableForm, useExtendableTable, useExtension, useLinkQuery, useQueryParams, useRouteModal, useStackedModal, useTabManagement, useTabbedForm, withLinkFields };
+export { type Action, type ActionGroup, ActionMenu, AddressForm, AddressSchema, type AttributeChange, type AttributeChangeKind, AttributeValueInput, BadgeListSummary, ChipGroup, ChipInput, CodeCell, CodeHeader, Combobox, type Command, ConditionalTooltip, ConfirmPrompt, type ConfirmPromptProps, type CoreNavItem, CountrySelect, CreatedAtCell, CreatedAtHeader, type CurrencyInfo, type CustomFieldsModule, CustomerInfo, DataGrid, DataTable, DateCell, DateHeader, DateRangeDisplay, DeprecatedPercentageInput, DisplayExtensionZone, type DisplayExtensionZoneProps, DisplayField, type DisplayFieldProps, DisplaySection, type DisplaySectionField, type DisplaySectionProps, type EditAttributeAttribute, EditAttributeForm, type EditAttributeFormProps, EmailCell, EmailForm, EmailHeader, EmailSchema, ErrorBoundary, type ExtendableTable, ExtensionProvider, type ExtensionProviderProps, ExtensionRegistry, type ExtractableOffer, type ExtractableOffers, type FieldDiff, FilePreview, type FileType, FileUpload, type FileUploadProps, type Filter, FilterGroup, Form, FormExtensionZone, type FormExtensionZoneProps, GeneralSectionSkeleton, HandleInput, HeadingSkeleton, IconAvatar, IconButtonSkeleton, ImageAvatar, type ImageRef, IncludesTaxTooltip, InfiniteList, JsonViewSection, JsonViewSectionSkeleton, KeyboundForm, LinkButton, ListBadge, ListSummary, Listicle, type ListicleProps, LocalizedTablePagination, type MediaDiff, MetadataForm, MetadataSection, MoneyAmountCell, NameCell, NameHeader, type NavigationModule, NoRecords, type NoRecordsProps, NoResults, type NoResultsProps, OrderBy, PercentageInput, PermissionGuard, type PermissionGuardProps, type PermissionProps, PermissionsContext, PermissionsProvider, type PermissionsProviderProps, PermissionsRequirement, type PermissionsRequirementProps, PermissionsRequirementsContext, PermissionsRequirementsProvider, PlaceholderCell, PriceListDateStatus, type PriceListGridGroupRow, type PriceListGridOfferRow, type PriceListGridRow, PriceListStatus, PriceListType, type ProductAttributeBatchPayload, ProductAttributeSection, type ProductAttributeSectionProps, type ProductChangeAttribute, ProductChangePanel, type ProductChangePanelProps, type ProductChangeProduct, type ProductChangeResolvers, type ProductChangeVariant, type ProductChangeView, ProgressBar, ProvinceSelect, Query, REFERENCE_FIELDS, type ReferenceField, RequiredPermissionsSection, type ResolvedAttribute, type ResolvedDisplays, type ResolvedFormField, RouteDrawer, RouteFocusModal, RoutePermissionGuard, SectionRow, type SectionRowProps, SegmentedControl, type SegmentedControlOption, SidebarLink, type SidebarLinkProps, SingleColumnPage, SingleColumnPageSkeleton, Skeleton, SortableList, SortableTree, StackedDrawer, StackedFocusModal, type StaticCountry, StatusCell, SwitchBox, type TQueryKey, type TabDefinition, TabbedForm, TableFooterSkeleton, TableSectionSkeleton, TableSkeleton, TextCell, TextHeader, TextSkeleton, Thumbnail, TransferOwnershipSchema, TwoColumnPage, TwoColumnPageSkeleton, type UseExtendableFormProps, type UseExtendableTableProps, type UseQueryOptionsWrapper, type UseRegisterPermissionsOptions, type VariantGroup, VisuallyHidden, type Widget, type WidgetModule, type WidgetPlacement, WidgetZone, type WidgetZoneProps, type ZoneWidgets, _DataTable, applyNavOverrides, buildAdditionalDataDefaults, buildAdditionalDataSchema, buildOfferGridData, buildProductChangeView, countries, createDataGridHelper, createDataGridPriceColumns, createFormHelper, currencies, extractPricesFromOffers, extractReferenceIds, formatFieldValue, genericForwardRef, getCountryByIso2, getCurrencySymbol, getDecimalDigits, getExtensionRegistry, getFormattedAddress, getFormattedCountry, getLinkQuery, getLocaleAmount, getNativeSymbol, getPriceListStatus, getStylizedAmount, humanizeFieldName, isAmountLessThenRoundingError, isImageList, isPriceListGroupRow, isProductRow, isReferenceField, isSameAddress, linkFields, productChangeViewHasContent, queryClient, queryKeysFactory, resolvePermissionProps, useCombinedRefs, useCommandHistory, useDataTable, useDate, useDisplayFieldOverride, useDocumentDirection, useExtendableForm, useExtendableTable, useExtension, useLinkQuery, usePermissions, useQueryParams, useRegisterPermissions, useRequiredPermissions, useResourcePermissions, useRouteModal, useStackedModal, useTabManagement, useTabbedForm, withLinkFields };