@mittwald/flow-react-components 1.6.0-next.5 → 1.6.0-next.50

package/dist/types/components/List/model/table/types.d.ts

@@ -1,4 +1,4 @@
-import { PropsWithChildren, ReactElement } from 'react';
+import { DependencyList, PropsWithChildren, ReactElement } from 'react';
 import { TableBodyProps, TableCellProps, TableColumnProps, TableHeaderProps, TableProps, TableRowProps } from '../../../Table';
 import { RenderItemFn } from '../..';
 /** Cell */
@@ -13,6 +13,22 @@ export type TableRowSupportedComponentProps = Omit<TableRowProps, "onAction" | "
 };
 export interface TableRowShape<T> extends TableRowSupportedComponentProps, PropsWithChildren {
     cells?: TableCellShape<T>[];
+    /**
+     * Everything the cells' render functions read besides the row's data.
+     *
+     * With `renderDependencies`, a row re-renders only when its data, one of
+     * these values, or a cell's props change. The render functions' identity does
+     * not count, so functions written inline in JSX keep the row from
+     * re-rendering on every render of its parent. List every value they read from
+     * outside the row, including state read through the `list` argument — one
+     * left out keeps the row on the value it last rendered.
+     *
+     * Row and cell props count by identity, so an inline `style` object or
+     * callback on `List.TableRow` or `List.TableCell` re-renders every row.
+     *
+     * Without it, every row re-renders whenever the list does.
+     */
+    renderDependencies?: DependencyList;
 }
 /** Column */
 export type TableColumnSupportedComponentProps = TableColumnProps;

package/dist/types/components/List/typedList.d.ts

@@ -127,6 +127,7 @@ export declare const typedList: <T, TMeta = unknown>() => {
         columns?: Iterable<never> | undefined;
         disabledBehavior?: import('react-stately').DisabledBehavior | undefined;
         hasChildItems?: boolean | undefined;
+        renderDependencies?: import('react').DependencyList | undefined;
     }) => null;
     TableCell: (ignoredProps: Omit<import('./model/table/types').TableCellShape<T>, "renderFn"> & {
         children: import('.').RenderItemFn<T>;

package/dist/types/components/Markdown/lib/isExternalHref.d.ts

@@ -0,0 +1 @@
+export declare const isExternalHref: (href: string | undefined) => boolean;

package/dist/types/components/ProgressBar/ProgressBar.d.ts

@@ -17,10 +17,7 @@ export interface ProgressBarProps extends PropsWithChildren<Omit<Aria.ProgressBa
         color?: CategoricalWithCustomColor;
         valueText?: string;
     }[];
-    /**
-     * Whether the legend component is shown when segments are used. @default:
-     * true
-     */
+    /** Whether the legend component is shown when segments are used. @default true */
     showLegend?: boolean;
 }
 /** @flr-generate all */

package/dist/types/components/Rating/Rating.d.ts

@@ -4,28 +4,28 @@ import * as Aria from "react-aria-components";
 export interface RatingProps extends FlowComponentProps, PropsWithChildren, Omit<Aria.RadioGroupProps, "children" | "value" | "defaultValue"> {
     /**
      * The value sets the amount of filled stars. Decimals are rounded to the
-     * nearest whole star. @default: 0
+     * nearest whole star. @default 0
      */
     value?: number;
     /**
      * The defaultValue sets the amount of default filled stars. Decimals are
-     * rounded to the nearest whole star. @default: 0
+     * rounded to the nearest whole star. @default 0
      */
     defaultValue?: number;
-    /** The size of the component. @default: "m" */
+    /** The size of the component. @default "m" */
     size?: "s" | "m";
     /**
      * The number of segments the rating consists of. Ignored when the rating has
      * `RatingSegment` children — those define the number of segments themselves.
      *
-     * @default: 5
+     * @default 5
      */
     maxValue?: number;
     /**
      * How the segments are filled. `cumulative` fills every segment up to the
      * value, `single` fills only the selected segment.
      *
-     * @default: cumulative
+     * @default "cumulative"
      */
     fill?: "cumulative" | "single";
     /** An alternative icon for the empty state */

package/dist/types/components/Section/context.d.ts

@@ -0,0 +1,28 @@
+import { FC, PropsWithChildren } from 'react';
+interface SectionHeading {
+    /** The id the surrounding `Section` gives its heading. */
+    id: string;
+    /** Whether a heading currently renders with that id. */
+    isRendered: boolean;
+    /** Called by a heading that renders with the id; returns the cleanup. */
+    register: () => () => void;
+}
+/** The heading state a `Section` provides for the given heading id. */
+export declare const useSectionHeading: (id: string) => SectionHeading;
+export declare const SectionHeadingProvider: import('react').Provider<SectionHeading | undefined>;
+/**
+ * Ends the surrounding `Section`'s heading scope, for content that has a
+ * heading of its own (`Accordion`, `Alert`, an overlay, …).
+ */
+export declare const SectionHeadingReset: FC<PropsWithChildren>;
+/** Marks the section heading as rendered while a heading carries its id. */
+export declare const useRegisterSectionHeading: (id: string | undefined) => void;
+/**
+ * The `aria-labelledby` of a grid or table: its own label, else the heading of
+ * the surrounding `Section` once that heading renders.
+ */
+export declare const useLabelledBySectionHeading: (props: {
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+}) => string | undefined;
+export {};

package/dist/types/components/Table/components/TableCell/TableCell.d.ts

@@ -1,7 +1,10 @@
 import { FC, PropsWithChildren } from 'react';
 import * as Aria from "react-aria-components";
 export interface TableCellProps extends Omit<Aria.CellProps, "children" | "style" | "render">, PropsWithChildren {
-    /** Use cell as row header */
+    /**
+     * Styles the cell as a row header. Its semantics come from the column: the
+     * first column, or the one with `isRowHeader`.
+     */
     rowHeader?: boolean;
     /** Horizontal alignment of the cell content @default "start" */
     horizontalAlign?: "start" | "center" | "end";

package/dist/types/components/Table/components/TableHeader/context.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Whether a column is the first of its `TableHeader`. Undefined outside a
+ * header that can tell, e.g. with dynamic `columns`.
+ */
+export declare const IsFirstColumnContext: import('react').Context<boolean | undefined>;
+export declare const useIsFirstColumn: () => boolean | undefined;

package/dist/types/components/Wrap/Wrap.d.ts

@@ -1,6 +1,11 @@
 import { FC, PropsWithChildren, ReactElement } from 'react';
 export interface WrapProps {
+    /**
+     * Whether the child element is rendered. Any truthy value keeps it, a falsy
+     * one renders only its children.
+     */
     if: unknown;
+    /** The element that wraps the content, with the content as its children. */
     children: ReactElement<PropsWithChildren>;
 }
 export declare const Wrap: FC<WrapProps>;

package/dist/types/index/flr-universal.d.ts

@@ -1,5 +1,5 @@
 export * from '../components/Icon/components/icons';
-export { Action, ActionBatch, type ActionFn, type ActionProps, BrowserOnly, type BrowserOnlyProps, ComponentDefaultsProvider, type ComponentDefaultsProviderProps, CountryOptions, type CountryOptionsProps, DeprecationWarningProvider, type DeprecationWarningHandler, type DeprecationWarningProviderProps, IntlProvider, LightBox, type LightBoxProps, LightBoxTrigger, type LightBoxTriggerProps, List, type ListProps, ListItemView, type ListItemViewProps, Modal, type ModalProps, ModalTrigger, type ModalTriggerProps, Popover, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, SettingsProvider, typedList, NotificationProvider, type NotificationProviderProps, Wrap, type WrapProps, } from '../components/public';
+export { Action, ActionBatch, type ActionFn, type ActionProps, BrowserOnly, type BrowserOnlyProps, ComponentDefaultsProvider, type ComponentDefaultsProviderProps, CountryOptions, type CountryOptionsProps, DeprecationWarningProvider, type DeprecationWarningHandler, type DeprecationWarningProviderProps, IntlProvider, LightBox, type LightBoxProps, LightBoxTrigger, type LightBoxTriggerProps, List, type ListProps, ListItemView, type ListItemViewProps, Modal, type ModalProps, ModalTrigger, type ModalTriggerProps, Popover, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, resolveDateRangeFilterValue, type DateRangeFilterValue, SettingsProvider, typedList, NotificationProvider, type NotificationProviderProps, Wrap, type WrapProps, } from '../components/public';
 export * from '../lib/controller/public';
 export * from '../lib/hooks/public';
 export { useControlledRemoteValueProps } from '../lib/remote/useControlledRemoteValueProps';

package/dist/types/integrations/react-hook-form/components/FormSettingsProvider/FormSettingsProvider.d.ts

@@ -1,8 +1,14 @@
-import { PropsWithChildren } from 'react';
+import { BaseSyntheticEvent, PropsWithChildren } from 'react';
 import { FieldValues, UseFormReturn } from 'react-hook-form';
 import { FormOnSubmitHandler } from '../Form/Form';
 export interface SubmitInterceptorContext<F extends FieldValues = FieldValues> {
     form: UseFormReturn<F>;
+    /**
+     * The submit event, if the form was submitted by one. Pass it on to `submit`
+     * so the handler can read the pressed submit button
+     * (`event.nativeEvent.submitter`).
+     */
+    event?: BaseSyntheticEvent;
 }
 export type SubmitInterceptor = <F extends FieldValues = FieldValues>(submit: FormOnSubmitHandler<F>, values: F, context: SubmitInterceptorContext<F>) => ReturnType<FormOnSubmitHandler<F>>;
 interface Context {

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

@@ -1,16 +1,13 @@
+import { OverlayState, OverlayCloseHandler, OverlayCloseOptions, OverlayOpenHandler, OverlayOpenStateHandler } from '../../../_bundled/flow-components-base/index';
 import { DependencyList } from 'react';
 import { FlowComponentName } from '../../../components/propTypes';
-export type OverlayOpenHandler = () => unknown;
-export type OverlayCloseHandler = () => unknown;
-export type OverlayOpenStateHandler = (isOpen: boolean) => unknown;
-type DisposerFn = () => void;
-export interface CloseOverlayOptions {
+export type { OverlayCloseHandler, OverlayOpenHandler, OverlayOpenStateHandler, } from '../../../_bundled/flow-components-base/index';
+export interface CloseOverlayOptions extends OverlayCloseOptions {
     /**
      * The overlay to close. Omitted, the nearest enclosing overlay is closed –
      * the same thing `closeOverlay={true}` means.
      */
     overlay?: FlowComponentName | OverlayController;
-    bypassConfirmation?: boolean;
 }
 export interface OnOverlayClosedOptions {
     dependencies?: DependencyList;
@@ -35,48 +32,17 @@ export interface OverlayControllerOptions {
      */
     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;
-    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;
-    /**
-     * The open state a `setOpen` call is currently applying. Handlers run before
-     * `isOpen` is assigned, so a handler that calls `setOpen` again would not be
-     * caught by the equality check at the top and would recurse.
-     */
-    private openStateInFlight;
-    constructor(options?: ConstructorOptions);
-    /** Whether closing this overlay currently requires a confirmation. */
-    get confirmOnCloseEnabled(): boolean;
+/**
+ * The state is `OverlayState` from `@mittwald/flow-components-base`, shared
+ * with every remote binding; this adds the hooks.
+ */
+export declare class OverlayController extends OverlayState<CloseOptions> {
     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.
@@ -85,27 +51,7 @@ export declare class OverlayController {
      */
     useOnClosed(callback: () => unknown, options?: OnOverlayClosedOptions): void;
     static useNew(options?: OverlayControllerOptions): OverlayController;
-    private addOpenStateHandler;
     private useOnHandler;
-    private executeHandlers;
-    private executeOnClose;
-    private executeOnOpen;
-    private executeOnOpenChange;
-    addOnClose(handler: OverlayCloseHandler): DisposerFn;
-    addOnOpen(handler: OverlayOpenHandler): DisposerFn;
-    addOnOpenChange(handler: OverlayOpenStateHandler): DisposerFn;
-    open(): void;
-    close(options?: CloseOptions): void;
-    toggle(): void;
-    setOpen(toOpen: boolean, options?: CloseOptions): void;
-    /**
-     * Sets the open state without running any handler. Use it to mirror a
-     * controlled `isOpen` prop, whose change comes from the consumer – notifying
-     * them of their own state would echo it back.
-     */
-    syncOpen(toOpen: boolean): void;
-    private applyOpenState;
-    setIsContentSuspended(to: boolean): void;
     useIsOpen(): boolean;
     useIsContentSuspended(): boolean;
     useShowConfirmationModal(): boolean;
@@ -115,16 +61,4 @@ export declare class 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;
 }
-export {};

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

@@ -0,0 +1,2 @@
+import { ReactNode } from 'react';
+export declare const hydrateServerMarkup: (element: ReactNode) => Promise<unknown[]>;

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

@@ -14,5 +14,8 @@ export declare const isVirtualKeyboardVisible: (layoutViewportHeight: number, vi
  * 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).
+ *
+ * Reading the viewport height forces a synchronous layout, so the hook neither
+ * reads nor listens while `isEnabled` is `false`, and returns `false` then.
  */
-export declare const useVirtualKeyboardVisible: () => boolean;
+export declare const useVirtualKeyboardVisible: (isEnabled?: boolean) => boolean;

package/dist/types/lib/object/isPlainObjectDeepEqual.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Compares plain objects recursively and every other value by identity.
+ * Functions, arrays, class instances, React elements and ref objects (`{
+ * current }`) only count as equal when they are the same value, so a value
+ * created during render counts as a change.
+ */
+export declare const isPlainObjectDeepEqual: (first: unknown, second: unknown) => boolean;
+export default isPlainObjectDeepEqual;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/flow-react-components",
-  "version": "1.6.0-next.5",
+  "version": "1.6.0-next.50",
   "type": "module",
   "description": "A React implementation of Flow, mittwald’s design system",
   "homepage": "https://flow.mittwald.de",
@@ -84,9 +84,9 @@
     "@internationalized/string-compiler": "^3.4.1",
     "@lezer/common": "^1.5.2",
     "@lezer/highlight": "^1.2.3",
-    "@mittwald/flow-icons": "^1.6.0-next.5",
+    "@mittwald/flow-icons": "^1.6.0-next.50",
     "@mittwald/password-tools-js": "^3.0.0",
-    "@mittwald/react-tunnel": "^1.6.0-next.5",
+    "@mittwald/react-tunnel": "^1.6.0-next.50",
     "@mittwald/react-use-promise": "^4.2.2",
     "@react-aria/form": "^3.2.1",
     "@react-aria/i18n": "^3.13.1",
@@ -139,13 +139,13 @@
     "@internationalized/date": "^3.12.3",
     "@lezer/generator": "^1.8.0",
     "@lezer/lr": "^1.4.10",
-    "@mittwald/flow-components-base": "1.6.0-next.5",
-    "@mittwald/flow-core": "1.6.0-next.5",
-    "@mittwald/flow-design-tokens": "1.6.0-next.5",
-    "@mittwald/flow-icons-base": "1.6.0-next.5",
+    "@mittwald/flow-components-base": "1.6.0-next.50",
+    "@mittwald/flow-core": "1.6.0-next.50",
+    "@mittwald/flow-design-tokens": "1.6.0-next.50",
+    "@mittwald/flow-icons-base": "1.6.0-next.50",
     "@mittwald/react-use-promise": "^4.2.2",
     "@mittwald/remote-dom-react": "1.2.2-mittwald.10",
-    "@mittwald/typescript-config": "1.6.0-next.5",
+    "@mittwald/typescript-config": "1.6.0-next.50",
     "@nx/storybook": "^22.7.6",
     "@storybook/addon-a11y": "^10.5.10",
     "@storybook/addon-actions": "^9.0.8",
@@ -155,7 +155,7 @@
     "@storybook/react-vite": "^10.5.10",
     "@tabler/icons-react": "^3.46.0",
     "@teispace/next-themes": "^2.0.4",
-    "@types/node": "25.9.8",
+    "@types/node": "25.9.9",
     "@typescript/native": "npm:typescript@^7.0.2",
     "@vitejs/plugin-react": "5.2.0",
     "@vitest/browser": "^4.1.11",
@@ -170,7 +170,7 @@
     "happy-dom": "^20.11.6",
     "next": "^16.3.2",
     "nx": "^22.7.5",
-    "postcss": "8.5.28",
+    "postcss": "8.5.30",
     "postcss-nested-import": "^1.3.0",
     "postcss-nesting": "^14.0.1",
     "postcss-scss": "^4.0.9",
@@ -199,7 +199,7 @@
   },
   "peerDependencies": {
     "@internationalized/date": "^3.12.2",
-    "@mittwald/flow-icons-pro": "1.6.0-next.5",
+    "@mittwald/flow-icons-pro": "1.6.0-next.50",
     "@mittwald/react-use-promise": "^4.2.2",
     "next": "^16.2.3",
     "react": "^19.2.0",
@@ -223,5 +223,5 @@
   "browserslist": [
     "baseline widely available"
   ],
-  "gitHead": "740150500bab2cd36aa92f13894892e4629f8f7c"
+  "gitHead": "a0fb5378707e92fe9a240a3c453b549cd2499734"
 }