@oliasoft-open-source/react-ui-library 6.13.0 → 6.14.0-beta-2

package/dist/helpers/overlay-trigger/index.d.ts

@@ -0,0 +1,5 @@
+export { OverlayTriggerChild } from './overlay-trigger-child';
+export type { IOverlayTriggerChildProps, OverlayTriggerBehavior, } from './overlay-trigger-child';
+export { getLegacyTriggerStyle, getOverlayPortalRoot, getPageLayersRoot, hasOverlayTriggerChild, isDirectTriggerChild, isDisabledTrigger, isDomElementChild, isNativeFocusableChild, PAGE_LAYERS_ID, toAriaPlacement, } from './utils';
+export type { OverlayTriggerElementProps } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/overlay-trigger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/overlay-trigger/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EACV,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,eAAe,GAChB,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC"}

package/dist/helpers/overlay-trigger/overlay-trigger-child.d.ts

@@ -0,0 +1,28 @@
+import { CSSProperties, HTMLAttributes, ReactElement, ReactNode, Ref } from 'react';
+import { OverlayTriggerElementProps } from './utils';
+export type OverlayTriggerBehavior = 'press' | 'focus';
+export interface IOverlayTriggerChildProps {
+    children?: ReactNode;
+    /** `press` for DialogTrigger/Popover; `focus` for TooltipTrigger. */
+    behavior: OverlayTriggerBehavior;
+    isDisabled?: boolean;
+    testId?: string;
+    triggerRef?: Ref<HTMLElement | null>;
+    /** Merge extra props onto an attachable child (e.g. close-on-click). */
+    enhanceChild?: (child: ReactElement<OverlayTriggerElementProps>) => ReactElement<OverlayTriggerElementProps>;
+    fallbackStyle?: CSSProperties;
+    fallbackProps?: HTMLAttributes<HTMLSpanElement>;
+    /**
+     * When true, attach to any forwardRef/DOM child (Tooltip).
+     * When false, only DOM elements and `safeComponents` (Popover).
+     */
+    attachToForwardRef?: boolean;
+    /** Components known to forwardRef and spread DOM props (e.g. Button). */
+    safeComponents?: readonly unknown[];
+}
+/**
+ * Makes arbitrary children a valid React Aria overlay trigger without an
+ * unnecessary layout wrapper when the child can accept ref + DOM props.
+ */
+export declare const OverlayTriggerChild: ({ children, behavior, isDisabled, testId, triggerRef, enhanceChild, fallbackStyle, fallbackProps, attachToForwardRef, safeComponents, }: IOverlayTriggerChildProps) => import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=overlay-trigger-child.d.ts.map

package/dist/helpers/overlay-trigger/overlay-trigger-child.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-trigger-child.d.ts","sourceRoot":"","sources":["../../../src/helpers/overlay-trigger/overlay-trigger-child.tsx"],"names":[],"mappings":"AAAA,OAAc,EAGZ,aAAa,EACb,cAAc,EAEd,YAAY,EACZ,SAAS,EACT,GAAG,EACJ,MAAM,OAAO,CAAC;AAEf,OAAO,EAIL,0BAA0B,EAC3B,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,qEAAqE;IACrE,QAAQ,EAAE,sBAAsB,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IACrC,wEAAwE;IACxE,YAAY,CAAC,EAAE,CACb,KAAK,EAAE,YAAY,CAAC,0BAA0B,CAAC,KAC5C,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAC9C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,aAAa,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;IAChD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yEAAyE;IACzE,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,yIAWjC,yBAAyB,mDAgF3B,CAAC"}

package/dist/helpers/overlay-trigger/utils.d.ts

@@ -0,0 +1,30 @@
+import { ComponentProps, CSSProperties, MouseEvent, ReactElement, ReactNode } from 'react';
+import { Tooltip as AriaTooltip } from 'react-aria-components';
+import { Placement } from '../floating-layer';
+export declare const PAGE_LAYERS_ID = "layers";
+type AriaPlacement = NonNullable<ComponentProps<typeof AriaTooltip>['placement']>;
+export declare const toAriaPlacement: (placement?: Placement) => AriaPlacement;
+export declare const getPageLayersRoot: () => HTMLElement | undefined;
+export declare const getOverlayPortalRoot: (triggerElement?: Element | null) => HTMLElement | undefined;
+export type OverlayTriggerElementProps = {
+    onClick?: (event: MouseEvent) => void;
+    disabled?: boolean;
+    'aria-disabled'?: boolean | 'true' | 'false';
+    testId?: string;
+    'data-testid'?: string;
+    role?: string;
+    tabIndex?: number;
+};
+export declare const isNativeFocusableChild: (child: ReactNode) => child is ReactElement<OverlayTriggerElementProps>;
+export declare const isDomElementChild: (child: ReactNode) => child is ReactElement<OverlayTriggerElementProps>;
+export declare const isDirectTriggerChild: (child: ReactNode) => boolean;
+export declare const isDisabledTrigger: (trigger: ReactElement<OverlayTriggerElementProps>) => boolean;
+/**
+ * True when `children` includes at least one renderable element.
+ * Prefer this over `Children.count` — in React 19, `Children.count(false) === 1`
+ * and `Children.only(false)` throws, which breaks `{show && <Trigger />}`.
+ */
+export declare const hasOverlayTriggerChild: (children?: ReactNode) => boolean;
+export declare const getLegacyTriggerStyle: (display?: string, flex?: string, triggerStyle?: CSSProperties) => CSSProperties;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/helpers/overlay-trigger/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/helpers/overlay-trigger/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,EACV,MAAM,OAAO,CAAC;AAEf,OAAO,KAAK,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,KAAK,aAAa,GAAG,WAAW,CAC9B,cAAc,CAAC,OAAO,WAAW,CAAC,CAAC,WAAW,CAAC,CAChD,CAAC;AAkBF,eAAO,MAAM,eAAe,GAAI,YAAW,SAAwB,kBAChC,CAAC;AAEpC,eAAO,MAAM,iBAAiB,QAAO,WAAW,GAAG,SAclD,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC/B,iBAAiB,OAAO,GAAG,IAAI,KAC9B,WAAW,GAAG,SAShB,CAAC;AAUF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,SAAS,KACf,KAAK,IAAI,YAAY,CAAC,0BAA0B,CAGZ,CAAC;AAExC,eAAO,MAAM,iBAAiB,GAC5B,OAAO,SAAS,KACf,KAAK,IAAI,YAAY,CAAC,0BAA0B,CACM,CAAC;AAQ1D,eAAO,MAAM,oBAAoB,GAAI,OAAO,SAAS,YAGS,CAAC;AAE/D,eAAO,MAAM,iBAAiB,GAC5B,SAAS,YAAY,CAAC,0BAA0B,CAAC,YAIR,CAAC;AAE5C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,WAAW,SAAS,KAAG,OACb,CAAC;AAElD,eAAO,MAAM,qBAAqB,GAChC,UAAU,MAAM,EAChB,OAAO,MAAM,EACb,eAAe,aAAa,KAC3B,aAID,CAAC"}