@wordpress/components/build-types/slot-fill/types.d.ts

UI components for WordPress.

/**
 * External dependencies
 */
import type { ReactNode, RefObject } from 'react';
/**
 * WordPress dependencies
 */
import type { ObservableMap } from '@wordpress/compose';
export type DistributiveOmit<T, K extends keyof any> = T extends any ? Omit<T, K> : never;
export type SlotKey = string | symbol;
export type FillProps = Record<string, any>;
type SlotPropBase = {
    /**
     * Slot name.
     */
    name: SlotKey;
    /**
     * props to pass from `Slot` to `Fill`.
     *
     * @default {}
     */
    fillProps?: FillProps;
};
export type SlotComponentProps = (SlotPropBase & {
    /**
     * By default, events will bubble to their parents on the DOM hierarchy (native event bubbling).
     * If set to true, events will bubble to their virtual parent in the React elements hierarchy instead,
     * also accept an optional `className`, `id`, etc.  to add to the slot container.
     */
    bubblesVirtually: true;
    /**
     * A function that returns nodes to be rendered.
     * Supported only when `bubblesVirtually` is `false`.
     */
    children?: never;
    /**
     * Additional className for the `Slot` component.
     * Supported only when `bubblesVirtually` is `true`.
     */
    className?: string;
    /**
     * Additional styles for the `Slot` component.
     * Supported only when `bubblesVirtually` is `true`.
     */
    style?: React.CSSProperties;
}) | (SlotPropBase & {
    /**
     * By default, events will bubble to their parents on the DOM hierarchy (native event bubbling).
     * If set to true, events will bubble to their virtual parent in the React elements hierarchy instead,
     * also accept an optional `className`, `id`, etc.  to add to the slot container.
     */
    bubblesVirtually?: false;
    /**
     * A function that returns nodes to be rendered.
     * Supported only when `bubblesVirtually` is `false`.
     */
    children?: (fills: ReactNode) => ReactNode;
    /**
     * Additional className for the `Slot` component.
     * Supported only when `bubblesVirtually` is `true`.
     */
    className?: never;
    /**
     * Additional styles for the `Slot` component.
     * Supported only when `bubblesVirtually` is `true`.
     */
    style?: never;
});
export type FillChildren = ReactNode | ((fillProps: FillProps) => ReactNode);
export type FillComponentProps = {
    /**
     * The name of the slot to fill into.
     */
    name: SlotKey;
    /**
     * Children elements or render function.
     */
    children?: FillChildren;
};
export type SlotFillProviderProps = {
    /**
     * The children elements.
     */
    children: ReactNode;
    /**
     * Whether to pass slots to the parent provider if existent.
     */
    passthrough?: boolean;
};
export type SlotFillInstance = {};
export type SlotRef = RefObject<HTMLElement | null>;
export type SlotRecord = {
    instance: SlotFillInstance;
} & ({
    type: 'children';
} | {
    type: 'portal';
    ref: SlotRef;
    fillProps: FillProps;
});
export type FillRecord = {
    instance: SlotFillInstance;
    children: FillChildren;
};
export type SlotFillRegistry = {
    slots: ObservableMap<SlotKey, SlotRecord>;
    fills: ObservableMap<SlotKey, FillRecord[]>;
    registerSlot: (name: SlotKey, slot: SlotRecord) => void;
    unregisterSlot: (name: SlotKey, instance: SlotFillInstance) => void;
    updateSlot: (name: SlotKey, slot: SlotRecord) => void;
    registerFill: (name: SlotKey, fill: FillRecord) => void;
    unregisterFill: (name: SlotKey, instance: SlotFillInstance) => void;
    updateFill: (name: SlotKey, fill: FillRecord) => void;
    /**
     * This helps the provider know if it's using the default context value or not.
     */
    isDefault?: boolean;
};
export {};
//# sourceMappingURL=types.d.ts.map