@mittwald/flow-react-components 0.2.0-experimental.776 → 1.0.0

package/dist/types/lib/controller/overlay/OverlayController.d.ts

@@ -1,3 +1,4 @@
+import { DependencyList } from 'react';
 import { FlowComponentName } from '../../../components/propTypes';
 export type OverlayOpenHandler = () => unknown;
 export type OverlayCloseHandler = () => unknown;
@@ -7,6 +8,9 @@ export interface CloseOverlayOptions {
     overlay: FlowComponentName | OverlayController;
     bypassConfirmation?: boolean;
 }
+export interface OnOverlayClosedOptions {
+    dependencies?: DependencyList;
+}
 export type CloseModalOptions = Omit<CloseOverlayOptions, "overlay">;
 type CloseOptions = CloseOverlayOptions | CloseModalOptions;
 export interface OverlayControllerOptions {
@@ -14,19 +18,56 @@ export interface OverlayControllerOptions {
     onOpen?: OverlayOpenHandler;
     onClose?: OverlayCloseHandler;
     onOpenChange?: OverlayOpenStateHandler;
+    /**
+     * Whether closing the overlay must be confirmed. `undefined` means "no
+     * opinion": the value is not contributed at all, so other sources (e.g. a
+     * `Modal`'s `confirmOnClose` prop or a dirty `Form`) still decide.
+     */
     confirmOnClose?: boolean;
 }
 type ConstructorOptions = Pick<OverlayControllerOptions, "isDefaultOpen" | "confirmOnClose">;
 export declare class OverlayController {
     isOpen: boolean;
+    isContentSuspended: boolean;
     private onOpenHandlers;
     private onCloseHandlers;
     private onOpenChangeHandlers;
     showConfirmationModal: boolean;
     closeIsConfirmed: boolean;
-    confirmOnCloseEnabled: boolean;
+    private readonly confirmOnCloseFromOptions;
+    /**
+     * Every mounted component that has an opinion on close confirmation
+     * contributes one entry here – e.g. a `Modal` with a `confirmOnClose` prop
+     * and a `Form` tracking its dirty state. Combining them instead of assigning
+     * a single flag keeps them from overwriting each other.
+     */
+    private confirmOnCloseSources;
+    /**
+     * Active grants that allow closing without a confirmation. Each entry is
+     * scoped to an ongoing operation that legitimately closes the overlay – e.g.
+     * a `Form` submit – and is dropped again when that operation has finished, so
+     * an operation that does _not_ close the overlay leaves the confirmation
+     * armed.
+     */
+    private closeWithoutConfirmationGrants;
     constructor(options?: ConstructorOptions);
+    /** Whether closing this overlay currently requires a confirmation. */
+    get confirmOnCloseEnabled(): boolean;
     useUpdateOptions(options?: OverlayControllerOptions): void;
+    /**
+     * Registers the calling component as a close confirmation source for as long
+     * as it is mounted. `undefined` contributes nothing at all.
+     */
+    private useConfirmOnCloseSource;
+    private setConfirmOnCloseSource;
+    private removeConfirmOnCloseSource;
+    /**
+     * Can be used to execute a callback when the Overlay has unmounted – means
+     * after any closing animation.
+     *
+     * NOTICE: This hook only works inside the corresponding Overlay!
+     */
+    useOnClosed(callback: () => unknown, options?: OnOverlayClosedOptions): void;
     static useNew(options?: OverlayControllerOptions): OverlayController;
     private addOpenStateHandler;
     private useOnHandler;
@@ -41,13 +82,25 @@ export declare class OverlayController {
     close(options?: CloseOptions): void;
     toggle(): void;
     setOpen(toOpen: boolean, options?: CloseOptions): void;
+    setIsContentSuspended(to: boolean): void;
     useIsOpen(): boolean;
+    useIsContentSuspended(): boolean;
     useShowConfirmationModal(): boolean;
+    useConfirmOnCloseEnabled(): boolean;
     useConfirmationController(): {
         readonly controller: OverlayController;
         readonly cancel: () => void;
         readonly confirm: () => void;
     } | undefined;
+    /**
+     * Allows closing this overlay without a confirmation until the returned
+     * disposer is called. Use it around an operation that may legitimately close
+     * the overlay – e.g. a `Form` submit, where a "discard unsaved changes?"
+     * prompt would be nonsense – and dispose it as soon as that operation has
+     * finished. An operation that ends without closing the overlay therefore
+     * leaves the confirmation armed (#2775).
+     */
+    grantCloseWithoutConfirmation(): DisposerFn;
     confirmClose(): void;
     cancelConfirmation(): void;
 }

package/dist/types/lib/controller/overlay/OverlayController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayController.d.ts","sourceRoot":"","sources":["../../../../../src/lib/controller/overlay/OverlayController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC;AAC/C,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC;AAChD,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;AAMnE,KAAK,UAAU,GAAG,MAAM,IAAI,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;AAErE,KAAK,YAAY,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,KAAK,kBAAkB,GAAG,IAAI,CAC5B,wBAAwB,EACxB,eAAe,GAAG,gBAAgB,CACnC,CAAC;AAEF,qBAAa,iBAAiB;IACrB,MAAM,UAAS;IACtB,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,oBAAoB,CAAsC;IAE3D,qBAAqB,UAAS;IAC9B,gBAAgB,UAAS;IACzB,qBAAqB,EAAE,OAAO,CAAC;gBAEnB,OAAO,GAAE,kBAAuB;IAe5C,gBAAgB,CAAC,OAAO,GAAE,wBAA6B,GAAG,IAAI;WAqBvD,MAAM,CAClB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB;IAMpB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,mBAAmB;IAIpB,UAAU,CAAC,OAAO,EAAE,mBAAmB;IAIvC,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAIrC,eAAe,CAAC,OAAO,EAAE,uBAAuB;IAIhD,IAAI,IAAI,IAAI;IAIZ,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAInC,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAiC1D,SAAS;IAIT,wBAAwB;IAIxB,yBAAyB;;;;;IAIzB,YAAY,IAAI,IAAI;IAKpB,kBAAkB,IAAI,IAAI;CAGlC"}
+{"version":3,"file":"OverlayController.d.ts","sourceRoot":"","sources":["../../../../../src/lib/controller/overlay/OverlayController.ts"],"names":[],"mappings":"AASA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,CAAC;AAC/C,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC;AAChD,MAAM,MAAM,uBAAuB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;AAInE,KAAK,UAAU,GAAG,MAAM,IAAI,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAAC;IAC/C,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,cAAc,CAAC;CAC/B;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;AAErE,KAAK,YAAY,GAAG,mBAAmB,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,wBAAwB;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,KAAK,kBAAkB,GAAG,IAAI,CAC5B,wBAAwB,EACxB,eAAe,GAAG,gBAAgB,CACnC,CAAC;AAEF,qBAAa,iBAAiB;IACrB,MAAM,UAAS;IACf,kBAAkB,UAAS;IAClC,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,oBAAoB,CAAsC;IAE3D,qBAAqB,UAAS;IAC9B,gBAAgB,UAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAU;IACpD;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB,CAAqC;IAClE;;;;;;OAMG;IACH,OAAO,CAAC,8BAA8B,CAAqB;gBAExC,OAAO,GAAE,kBAAuB;IAmBnD,sEAAsE;IACtE,IAAW,qBAAqB,IAAI,OAAO,CAK1C;IAEM,gBAAgB,CAAC,OAAO,GAAE,wBAA6B,GAAG,IAAI;IAgBrE;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,uBAAuB;IAI/B,OAAO,CAAC,0BAA0B;IAIlC;;;;;OAKG;IACI,WAAW,CAChB,QAAQ,EAAE,MAAM,OAAO,EACvB,OAAO,GAAE,sBAA2B;WAsBxB,MAAM,CAClB,OAAO,GAAE,wBAA6B,GACrC,iBAAiB;IAMpB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,mBAAmB;IAIpB,UAAU,CAAC,OAAO,EAAE,mBAAmB;IAIvC,SAAS,CAAC,OAAO,EAAE,kBAAkB;IAIrC,eAAe,CAAC,OAAO,EAAE,uBAAuB;IAIhD,IAAI,IAAI,IAAI;IAIZ,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI;IAInC,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,YAAiB,GAAG,IAAI;IAwC1D,qBAAqB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI;IAIxC,SAAS;IAIT,qBAAqB;IAIrB,wBAAwB;IAIxB,wBAAwB;IAIxB,yBAAyB;;;;;IAIhC;;;;;;;OAOG;IACI,6BAA6B,IAAI,UAAU;IAQ3C,YAAY,IAAI,IAAI;IAKpB,kBAAkB,IAAI,IAAI;CAGlC"}

package/dist/types/lib/dev/StoryBackground.d.ts

@@ -1,6 +1,7 @@
 import { FC, PropsWithChildren } from 'react';
 interface Props extends PropsWithChildren {
     color?: string;
+    theme: "dark" | "light";
 }
 export declare const StoryBackground: FC<Props>;
 export {};

package/dist/types/lib/dev/StoryBackground.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StoryBackground.d.ts","sourceRoot":"","sources":["../../../../src/lib/dev/StoryBackground.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAG/D,UAAU,KAAM,SAAQ,iBAAiB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,KAAK,CAmBrC,CAAC"}
+{"version":3,"file":"StoryBackground.d.ts","sourceRoot":"","sources":["../../../../src/lib/dev/StoryBackground.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAGxD,UAAU,KAAM,SAAQ,iBAAiB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC,KAAK,CAuBrC,CAAC"}

package/dist/types/lib/dom/createFrameResizeObserver.browser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createFrameResizeObserver.browser.test.d.ts.map

package/dist/types/lib/dom/createFrameResizeObserver.browser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFrameResizeObserver.browser.test.d.ts","sourceRoot":"","sources":["../../../../src/lib/dom/createFrameResizeObserver.browser.test.ts"],"names":[],"mappings":""}

package/dist/types/lib/dom/createFrameResizeObserver.d.ts

@@ -0,0 +1,27 @@
+export interface FrameResizeObserver {
+    /**
+     * (Re-)observe exactly the given targets. Any previously observed element is
+     * dropped first, so this can be called repeatedly with a changed target set.
+     */
+    observe: (targets: Iterable<Element>) => void;
+    /**
+     * Queue a measurement on the next animation frame. Repeated calls before the
+     * frame runs coalesce into a single measurement.
+     */
+    schedule: () => void;
+    /** Stop observing and cancel any queued measurement. */
+    disconnect: () => void;
+}
+/**
+ * Wraps a `ResizeObserver` whose measurements are deferred to the next
+ * animation frame. Deferring serves two purposes: it coalesces bursts of resize
+ * notifications into a single measurement, and it avoids "ResizeObserver loop"
+ * errors when the measurement itself mutates the layout of observed elements.
+ *
+ * Lifecycle (creating the observer, when to (re-)observe, when to disconnect)
+ * is left to the caller, because the consuming hooks drive it differently —
+ * some from a ref callback, some from a layout effect.
+ */
+export declare const createFrameResizeObserver: (measure: () => void) => FrameResizeObserver;
+export default createFrameResizeObserver;
+//# sourceMappingURL=createFrameResizeObserver.d.ts.map

package/dist/types/lib/dom/createFrameResizeObserver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createFrameResizeObserver.d.ts","sourceRoot":"","sources":["../../../../src/lib/dom/createFrameResizeObserver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;IAC9C;;;OAGG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,wDAAwD;IACxD,UAAU,EAAE,MAAM,IAAI,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,IAAI,KAClB,mBA+BF,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/types/lib/getContainerBreakpointSizeClassName.d.ts

@@ -1,3 +1,5 @@
 import { ContainerBreakpointSize } from './types/props';
-export declare const getContainerBreakpointSizeClassName: (containerBreakpointSize: ContainerBreakpointSize) => string;
+type ContainerBreakpointSizeClassName = `container-breakpoint-size-${ContainerBreakpointSize}`;
+export declare const getContainerBreakpointSizeClassName: (containerBreakpointSize: ContainerBreakpointSize) => ContainerBreakpointSizeClassName;
+export {};
 //# sourceMappingURL=getContainerBreakpointSizeClassName.d.ts.map

package/dist/types/lib/getContainerBreakpointSizeClassName.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getContainerBreakpointSizeClassName.d.ts","sourceRoot":"","sources":["../../../src/lib/getContainerBreakpointSizeClassName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,eAAO,MAAM,mCAAmC,GAC9C,yBAAyB,uBAAuB,WACS,CAAC"}
+{"version":3,"file":"getContainerBreakpointSizeClassName.d.ts","sourceRoot":"","sources":["../../../src/lib/getContainerBreakpointSizeClassName.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEjE,KAAK,gCAAgC,GACnC,6BAA6B,uBAAuB,EAAE,CAAC;AAEzD,eAAO,MAAM,mCAAmC,GAC9C,yBAAyB,uBAAuB,KAC/C,gCACqD,CAAC"}

package/dist/types/lib/hooks/dom/useKeepBrowserExtensionsInteractive.browser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useKeepBrowserExtensionsInteractive.browser.test.d.ts.map

package/dist/types/lib/hooks/dom/useKeepBrowserExtensionsInteractive.browser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeepBrowserExtensionsInteractive.browser.test.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/dom/useKeepBrowserExtensionsInteractive.browser.test.tsx"],"names":[],"mappings":""}

package/dist/types/lib/hooks/dom/useKeepBrowserExtensionsInteractive.d.ts

@@ -0,0 +1,17 @@
+/**
+ * While a modal overlay is open, react-aria isolates the rest of the document
+ * by setting `inert` on every sibling of the modal (see `ariaHideOutside`) —
+ * and it keeps doing so for nodes that appear afterwards via a
+ * `MutationObserver`. That also catches UI a browser extension injects while
+ * the modal is open, e.g. a password manager's autofill dropdown on a field, or
+ * its "save credentials" popover. An `inert` node stays visible but cannot be
+ * clicked, so the user sees the extension UI but cannot interact with it.
+ *
+ * This hook watches the document while `isActive` and re-enables such
+ * extension-injected, document-level nodes, so browser extensions keep working
+ * on top of modals. It targets the structural fingerprint of extension UI (see
+ * {@link isBrowserExtensionNode}) rather than a fixed list of vendors.
+ */
+export declare const useKeepBrowserExtensionsInteractive: (isActive: boolean) => void;
+export default useKeepBrowserExtensionsInteractive;
+//# sourceMappingURL=useKeepBrowserExtensionsInteractive.d.ts.map

package/dist/types/lib/hooks/dom/useKeepBrowserExtensionsInteractive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeepBrowserExtensionsInteractive.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/dom/useKeepBrowserExtensionsInteractive.ts"],"names":[],"mappings":"AA2CA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mCAAmC,GAC9C,UAAU,OAAO,KAChB,IA6BF,CAAC;AAEF,eAAe,mCAAmC,CAAC"}

package/dist/types/lib/hooks/dom/useObserveOverflow.d.ts

@@ -1,8 +1,13 @@
-import { RefObject } from 'react';
+import { RefCallback } from 'react';
 interface UseObserveOverflowReturn {
-    ref: RefObject<never>;
+    ref: RefCallback<HTMLElement>;
     isOverflowing: boolean;
 }
+/**
+ * Tracks whether the observed element overflows its parent horizontally.
+ * Re-measures when the element, its parent or any of its children resize, and
+ * when children are added or removed.
+ */
 export declare const useObserveOverflow: () => UseObserveOverflowReturn;
 export {};
 //# sourceMappingURL=useObserveOverflow.d.ts.map

package/dist/types/lib/hooks/dom/useObserveOverflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useObserveOverflow.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/dom/useObserveOverflow.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIvC,UAAU,wBAAwB;IAChC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,QAAO,wBA2CrC,CAAC"}
+{"version":3,"file":"useObserveOverflow.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/dom/useObserveOverflow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAKzC,UAAU,wBAAwB;IAChC,GAAG,EAAE,WAAW,CAAC,WAAW,CAAC,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,wBAkFrC,CAAC"}

package/dist/types/lib/hooks/dom/useVirtualKeyboardVisible.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Minimum shrinkage (px) of the visual viewport relative to the layout viewport
+ * that we treat as "the on-screen keyboard is open". Filters out the much
+ * smaller changes caused by mobile browser chrome (e.g. the address bar).
+ */
+export declare const VIRTUAL_KEYBOARD_MIN_HEIGHT = 150;
+/**
+ * Pure predicate: the visual viewport is at least `threshold` px shorter than
+ * the layout viewport (i.e. the on-screen keyboard is open).
+ */
+export declare const isVirtualKeyboardVisible: (layoutViewportHeight: number, visualViewportHeight: number, threshold?: number) => boolean;
+/**
+ * Tracks whether the on-screen (virtual) keyboard is currently open, using the
+ * VisualViewport API. On iOS and Android the layout viewport stays while the
+ * visual viewport shrinks by the keyboard height. Returns `false` where
+ * VisualViewport is unavailable (SSR, very old browsers).
+ */
+export declare const useVirtualKeyboardVisible: () => boolean;
+//# sourceMappingURL=useVirtualKeyboardVisible.d.ts.map

package/dist/types/lib/hooks/dom/useVirtualKeyboardVisible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualKeyboardVisible.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/dom/useVirtualKeyboardVisible.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,sBAAsB,MAAM,EAC5B,sBAAsB,MAAM,EAC5B,YAAW,MAAoC,KAC9C,OAAkE,CAAC;AAEtE;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,QAAO,OAqB5C,CAAC"}

package/dist/types/lib/hooks/dom/useVirtualKeyboardVisible.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useVirtualKeyboardVisible.test.d.ts.map

package/dist/types/lib/hooks/dom/useVirtualKeyboardVisible.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVirtualKeyboardVisible.test.d.ts","sourceRoot":"","sources":["../../../../../src/lib/hooks/dom/useVirtualKeyboardVisible.test.ts"],"names":[],"mappings":""}

package/dist/types/lib/hooks/public.d.ts

@@ -3,4 +3,5 @@ export { useOverlayController } from '../controller';
 export * from './useOnChange';
 export * from './useIsMounted';
 export { useProps } from './useProps';
+export { useLanguage } from './useLanguage';
 //# sourceMappingURL=public.d.ts.map

package/dist/types/lib/hooks/public.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"public.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/public.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/lib/hooks/useFieldComponent.d.ts

@@ -1,19 +1,23 @@
 import { FC, PropsWithChildren } from 'react';
 import { PropsContext } from '../propsContext';
 import { default as clsx, ClassValue } from 'clsx';
+import { FlowComponentName } from '../../components/propTypes';
 interface FieldComponentProps {
     className?: ClassValue;
     isRequired?: boolean;
     isDisabled?: boolean;
+    isInvalid?: boolean;
+    "aria-describedby"?: string;
 }
 export interface UseFieldComponent {
     FieldErrorCaptureContext: FC<PropsWithChildren>;
     FieldErrorView: FC;
     fieldPropsContext: PropsContext;
     fieldProps: {
+        "aria-describedby"?: string;
         className?: ReturnType<typeof clsx>;
     };
 }
-export declare const useFieldComponent: (props: FieldComponentProps) => UseFieldComponent;
+export declare const useFieldComponent: (props: FieldComponentProps, component: FlowComponentName) => UseFieldComponent;
 export {};
 //# sourceMappingURL=useFieldComponent.d.ts.map

package/dist/types/lib/hooks/useFieldComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFieldComponent.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useFieldComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AACnD,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,IAAI,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAE7C,UAAU,mBAAmB;IAC3B,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,wBAAwB,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAChD,cAAc,EAAE,EAAE,CAAC;IACnB,iBAAiB,EAAE,YAAY,CAAC;IAChC,UAAU,EAAE;QACV,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;KACrC,CAAC;CACH;AAED,eAAO,MAAM,iBAAiB,GAC5B,OAAO,mBAAmB,KACzB,iBAwBF,CAAC"}
+{"version":3,"file":"useFieldComponent.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useFieldComponent.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,iBAAiB,EAAS,MAAM,OAAO,CAAC;AAC/D,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,IAAI,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,UAAU,mBAAmB;IAC3B,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,wBAAwB,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC;IAChD,cAAc,EAAE,EAAE,CAAC;IACnB,iBAAiB,EAAE,YAAY,CAAC;IAChC,UAAU,EAAE;QACV,kBAAkB,CAAC,EAAE,MAAM,CAAC;QAC5B,SAAS,CAAC,EAAE,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;KACrC,CAAC;CACH;AAED,eAAO,MAAM,iBAAiB,GAC5B,OAAO,mBAAmB,EAC1B,WAAW,iBAAiB,KAC3B,iBA+BF,CAAC"}

package/dist/types/lib/hooks/useFieldError.d.ts

@@ -1,8 +1,14 @@
 import { default as React } from 'react';
-export declare const useFieldError: (tunnelIdFromProps?: string) => {
+import { FlowComponentName } from '../../components/propTypes';
+export interface UseFieldErrorOptions {
+    fieldErrorId: string;
+    tunnelId?: string;
+    component: FlowComponentName;
+}
+export declare const useFieldError: (options: UseFieldErrorOptions) => {
     readonly FieldErrorCaptureContext: React.FC<{
         children?: React.ReactNode | undefined;
     }>;
-    readonly FieldErrorView: () => import("react/jsx-runtime").JSX.Element | null;
+    readonly FieldErrorView: () => React.JSX.Element | null;
 };
 //# sourceMappingURL=useFieldError.d.ts.map

package/dist/types/lib/hooks/useFieldError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFieldError.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useFieldError.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0D,MAAM,OAAO,CAAC;AAO/E,eAAO,MAAM,aAAa,GAAI,oBAAoB,MAAM;;;;;CA6CvD,CAAC"}
+{"version":3,"file":"useFieldError.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useFieldError.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAMxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,oBAAoB;;;;;CA+C1D,CAAC"}

package/dist/types/lib/hooks/useImageSrc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useImageSrc.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useImageSrc.tsx"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,IAAI,WAwBhD,CAAC"}
+{"version":3,"file":"useImageSrc.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useImageSrc.tsx"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,IAAI,WAehD,CAAC"}

package/dist/types/lib/hooks/useLanguage.d.ts

@@ -0,0 +1,2 @@
+export declare const useLanguage: () => string;
+//# sourceMappingURL=useLanguage.d.ts.map

package/dist/types/lib/hooks/useLanguage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLanguage.d.ts","sourceRoot":"","sources":["../../../../src/lib/hooks/useLanguage.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,cAA2B,CAAC"}

package/dist/types/lib/propsContext/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/propsContext/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAErF,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;KAChC,CAAC,IAAI,iBAAiB,GAAG,qBAAqB,CAAC,CAAC,CAAC;CACnD,CAAC,GACA,iBAAiB,CAAC;AAEpB,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,iBAAiB,IAAI,OAAO,CAAC;KACtE,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAC1B,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,GAC3B,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;CACtB,CAAC,GACA,YAAY,CAAC;AAIf,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/propsContext/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAErF,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;KAChC,CAAC,IAAI,iBAAiB,GAAG,qBAAqB,CAAC,CAAC,CAAC;CACnD,CAAC,GACA,iBAAiB,CAAC;AAEpB,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,iBAAiB,IAAI,OAAO,CAAC;KACtE,CAAC,IAAI,qBAAqB,CAAC,CAAC,CAAC,GAC5B,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;CAClD,CAAC,GACA,YAAY,CAAC;AAIf,MAAM,MAAM,cAAc,GAAG,GAAG,CAAC"}

package/dist/types/lib/react/components/Render/Render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Render.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/react/components/Render/Render.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAG3C,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC;IAAE,QAAQ,EAAE,MAAM,SAAS,GAAG,IAAI,CAAA;CAAE,CAE3D,CAAC"}
+{"version":3,"file":"Render.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/react/components/Render/Render.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAE3C,eAAO,MAAM,MAAM,EAAE,EAAE,CAAC;IAAE,QAAQ,EAAE,MAAM,SAAS,GAAG,IAAI,CAAA;CAAE,CAE3D,CAAC"}

package/dist/types/lib/react/deepFindOfType.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deepFindOfType.d.ts","sourceRoot":"","sources":["../../../../src/lib/react/deepFindOfType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,wBAAwB,EACxB,SAAS,EACV,MAAM,OAAO,CAAC;AAsBf,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,WAAW,EAClD,UAAU,SAAS,EACnB,YAAY,CAAC,KACZ,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,SAGlC,CAAC;AAEhB,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,WAAW,EACpD,UAAU,SAAS,EACnB,YAAY,CAAC,KACZ,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAU7C,CAAC"}
+{"version":3,"file":"deepFindOfType.d.ts","sourceRoot":"","sources":["../../../../src/lib/react/deepFindOfType.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,wBAAwB,EACxB,SAAS,EACV,MAAM,OAAO,CAAC;AAsBf,eAAO,MAAM,cAAc,GAAI,CAAC,SAAS,WAAW,EAClD,UAAU,SAAS,EACnB,YAAY,CAAC,KACZ,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,SAEU,CAAC;AAE5D,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,WAAW,EACpD,UAAU,SAAS,EACnB,YAAY,CAAC,KACZ,wBAAwB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAU7C,CAAC"}

package/dist/types/lib/scss/selectors.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Look up a class name by a dynamic (runtime) key — a key that cannot be
+ * statically narrowed to one of `styles`' keys (e.g. built from a number, a
+ * `string`-typed prop, or a helper's return). Returns `undefined` when the key
+ * is not a class, which `clsx` safely ignores — unlike an `as keyof` cast,
+ * which lies about the result being present.
+ */
+export declare function styleClassname<T extends Record<string, string>>(styles: T, classname: string): string | undefined;
+//# sourceMappingURL=selectors.d.ts.map

package/dist/types/lib/scss/selectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../../../src/lib/scss/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7D,MAAM,EAAE,CAAC,EACT,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAEpB"}

package/dist/types/lib/theming/components/ThemedHtml.d.ts

@@ -0,0 +1,8 @@
+import { FC, HTMLAttributes } from 'react';
+import { Theme } from '../types';
+interface Props extends HTMLAttributes<HTMLHtmlElement> {
+    theme: Theme;
+}
+export declare const ThemedHtml: FC<Props>;
+export {};
+//# sourceMappingURL=ThemedHtml.d.ts.map

package/dist/types/lib/theming/components/ThemedHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThemedHtml.d.ts","sourceRoot":"","sources":["../../../../../src/lib/theming/components/ThemedHtml.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGtC,UAAU,KAAM,SAAQ,cAAc,CAAC,eAAe,CAAC;IACrD,KAAK,EAAE,KAAK,CAAC;CACd;AAED,eAAO,MAAM,UAAU,EAAE,EAAE,CAAC,KAAK,CAQhC,CAAC"}