@bazza-ui/react 0.0.0 → 0.1.0-canary.10

package/dist/separator-BiySI623.d.cts

@@ -0,0 +1,275 @@
+import * as React from 'react';
+import { C as ComponentProps } from './types-DT4FOOa2.cjs';
+import { aV as DataSurfaceProps } from './events-DPsuhBln.cjs';
+import { F as FilterFn, S as SearchNormalizer } from './ListboxStore-nmorsoqX.cjs';
+
+interface PopupMenuIconState extends Record<string, unknown> {
+    /**
+     * Whether the popup is currently open.
+     */
+    open: boolean;
+}
+interface PopupMenuIconProps extends ComponentProps<'span', PopupMenuIcon.State> {
+}
+/**
+ * An icon that indicates the trigger opens a popup.
+ * Typically used inside the trigger to show a chevron or dropdown arrow.
+ * Renders a `<span>` element.
+ */
+declare const PopupMenuIcon: React.ForwardRefExoticComponent<Omit<PopupMenuIcon.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+declare namespace PopupMenuIcon {
+    type State = PopupMenuIconState;
+    interface Props extends PopupMenuIconProps {
+    }
+}
+
+interface PopupMenuEmptyState extends Record<string, unknown> {
+    first: boolean;
+    last: boolean;
+}
+interface PopupMenuEmptyProps extends ComponentProps<'div', PopupMenuEmpty.State> {
+    children: React.ReactNode;
+}
+/**
+ * Renders when no items match the current search query.
+ * Only visible when there's an active search with zero results.
+ * Renders a `<div>` element.
+ */
+declare const PopupMenuEmpty: React.ForwardRefExoticComponent<Omit<PopupMenuEmpty.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuEmpty {
+    type State = PopupMenuEmptyState;
+    interface Props extends PopupMenuEmptyProps {
+    }
+}
+
+/**
+ * State passed to children render function.
+ */
+interface PopupMenuListChildrenState {
+    /** Current search query */
+    search: string;
+    /** Number of items matching the current filter */
+    filteredCount: number;
+}
+interface PopupMenuListState extends Record<string, unknown> {
+}
+interface PopupMenuListProps extends Omit<ComponentProps<'div', PopupMenuList.State>, 'children' | 'content'> {
+    /**
+     * Content to render inside the list.
+     * Can be a render function that receives the current search state.
+     */
+    children: React.ReactNode | ((state: PopupMenuListChildrenState) => React.ReactNode);
+    /**
+     * Accessible label for the listbox.
+     * @default 'Suggestions'
+     */
+    label?: string;
+    /**
+     * When true, measures row widths and applies `--row-width` CSS variable.
+     * Keeps the list at the maximum width seen while scrolling.
+     * Useful for virtualized lists where content width varies.
+     * @default true
+     */
+    measureRowWidth?: boolean;
+    /**
+     * Maximum width cap for row measurement (in pixels).
+     * Only used when `measureRowWidth` is true.
+     */
+    maxRowWidth?: number;
+    /**
+     * Ref to the element that owns the list's scroll position.
+     * Use when the semantic list is rendered inside another scroll container.
+     */
+    scrollContainerRef?: React.RefObject<HTMLElement | null>;
+    /**
+     * When any value in this array changes, previously-measured row IDs are
+     * cleared so rows re-measure (the sticky max width is kept — it only ever
+     * grows until the menu closes). Use for state that changes row content for
+     * the same IDs, e.g. tree rows that re-render as breadcrumb rows when deep
+     * search toggles. Values are compared with `Object.is`, so pass stable
+     * primitives — an inline object recreated each render would re-trigger
+     * every render.
+     */
+    remeasureDependencies?: React.DependencyList;
+}
+declare const PopupMenuList: React.ForwardRefExoticComponent<Omit<PopupMenuList.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuList {
+    type State = PopupMenuListState;
+    type ChildrenState = PopupMenuListChildrenState;
+    interface Props extends PopupMenuListProps {
+    }
+}
+
+interface PopupMenuSurfaceState extends Record<string, unknown> {
+}
+interface PopupMenuSurfaceProps extends Omit<ComponentProps<'div', PopupMenuSurface.State>, 'content'>, DataSurfaceProps {
+    /**
+     * Filter function for matching items against search query.
+     * Returns a score between 0 and 1 (0 = no match, > 0 = match).
+     * Pass `false` to disable filtering entirely.
+     * @default commandScore (fuzzy matching)
+     */
+    filter?: FilterFn | false;
+    /**
+     * Transforms search input before filtering and visibility logic.
+     * @default trim whitespace (`search.trim()`)
+     */
+    normalizeSearch?: SearchNormalizer;
+    /**
+     * Controlled search value.
+     */
+    search?: string;
+    /**
+     * Callback when search value changes.
+     */
+    onSearchChange?: (search: string) => void;
+    /**
+     * Default search value for uncontrolled usage.
+     * @default ''
+     */
+    defaultSearch?: string;
+    /**
+     * Whether navigation should loop from last to first item and vice versa.
+     * @default true
+     */
+    loop?: boolean;
+    /**
+     * Controls auto-highlighting behavior when the menu opens.
+     * - `true`: highlight the first item (default)
+     * - `false`: don't auto-highlight any item
+     * - `string`: highlight the item with this specific value
+     * @default true
+     */
+    autoHighlightFirst?: boolean | string;
+    /**
+     * Whether to clear the search query when the menu closes.
+     * - `'after-exit'`: clear after exit animation completes (default)
+     * - `true`: clear immediately when menu closes
+     * - `false`: preserve search when menu closes
+     * @default 'after-exit'
+     */
+    clearSearchOnClose?: boolean | 'after-exit';
+    /**
+     * Whether to reset the list scroll position when the search query changes.
+     * @default true
+     */
+    resetScrollOnSearch?: boolean;
+    /**
+     * Whether to skip auto-focusing the input/list when this surface becomes the focus owner.
+     * Useful for Combobox where the input is outside the popup and should retain focus.
+     * @default false
+     */
+    skipAutoFocus?: boolean;
+    /**
+     * Ordered list of item values when using `filter={false}`.
+     * This tells the store the intended display order for navigation/highlighting.
+     * Required when `filter={false}` - must always be provided with the current visible items.
+     */
+    orderedItems?: string[];
+    children: React.ReactNode;
+}
+/**
+ * Provides search context and manages item registration for popup menu.
+ * Place inside PopupMenu.Popup to enable search functionality.
+ * Renders a `<div>` element.
+ */
+declare const PopupMenuSurface: React.ForwardRefExoticComponent<Omit<PopupMenuSurface.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuSurface {
+    type State = PopupMenuSurfaceState;
+    interface Props extends PopupMenuSurfaceProps {
+    }
+}
+
+interface PopupMenuGroupState extends Record<string, unknown> {
+    /**
+     * Whether the group is hidden due to no matching items.
+     */
+    hidden: boolean;
+    /**
+     * Present when this is the first visible group in the list.
+     */
+    firstGroup: boolean;
+    /**
+     * Present when this is the last visible group in the list.
+     */
+    lastGroup: boolean;
+    first: boolean;
+    last: boolean;
+}
+interface PopupMenuGroupProps extends ComponentProps<'div', PopupMenuGroup.State> {
+    /**
+     * Whether to force render this group regardless of filter results.
+     * @default false
+     */
+    forceMount?: boolean;
+    children: React.ReactNode;
+}
+/**
+ * Groups related popup menu items together.
+ * Hidden when no child items match the current filter.
+ * Renders a `<div>` element with role="group".
+ */
+declare const PopupMenuGroup: React.ForwardRefExoticComponent<Omit<PopupMenuGroup.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuGroup {
+    type State = PopupMenuGroupState;
+    interface Props extends PopupMenuGroupProps {
+    }
+}
+
+interface PopupMenuGroupLabelState extends Record<string, unknown> {
+    /**
+     * Present when this label is the first row in the list.
+     */
+    first: boolean;
+    /**
+     * Present when this label is the last row in the list.
+     */
+    last: boolean;
+    /**
+     * Present when this label's parent group is the first visible group in the list.
+     */
+    firstGroup: boolean;
+    /**
+     * Present when this label's parent group is the last visible group in the list.
+     */
+    lastGroup: boolean;
+}
+interface PopupMenuGroupLabelProps extends ComponentProps<'div', PopupMenuGroupLabel.State> {
+    children: React.ReactNode;
+}
+/**
+ * A label/heading for a group of popup menu items.
+ * Renders a `<div>` element with role="presentation".
+ */
+declare const PopupMenuGroupLabel: React.ForwardRefExoticComponent<Omit<PopupMenuGroupLabel.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuGroupLabel {
+    type State = PopupMenuGroupLabelState;
+    interface Props extends PopupMenuGroupLabelProps {
+    }
+}
+
+interface PopupMenuSeparatorState extends Record<string, unknown> {
+    first: boolean;
+    last: boolean;
+}
+interface PopupMenuSeparatorProps extends ComponentProps<'div', PopupMenuSeparator.State> {
+    /**
+     * Whether to always render the separator, even during search.
+     * By default, separators are hidden when there's an active search query.
+     * @default false
+     */
+    alwaysRender?: boolean;
+}
+/**
+ * A visual separator between popup menu items.
+ * Hidden during active search unless `alwaysRender` is true.
+ * Renders a `<div>` element with role="separator".
+ */
+declare const PopupMenuSeparator: React.ForwardRefExoticComponent<Omit<PopupMenuSeparator.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuSeparator {
+    type State = PopupMenuSeparatorState;
+    interface Props extends PopupMenuSeparatorProps {
+    }
+}
+
+export { PopupMenuEmpty as P, PopupMenuGroup as a, PopupMenuGroupLabel as b, PopupMenuIcon as c, PopupMenuList as d, PopupMenuSeparator as e, PopupMenuSurface as f, type PopupMenuEmptyProps as g, type PopupMenuEmptyState as h, type PopupMenuGroupLabelProps as i, type PopupMenuGroupLabelState as j, type PopupMenuGroupProps as k, type PopupMenuGroupState as l, type PopupMenuIconProps as m, type PopupMenuIconState as n, type PopupMenuListChildrenState as o, type PopupMenuListProps as p, type PopupMenuListState as q, type PopupMenuSeparatorProps as r, type PopupMenuSeparatorState as s, type PopupMenuSurfaceProps as t, type PopupMenuSurfaceState as u };

package/dist/separator-De8l8DKO.d.ts

@@ -0,0 +1,275 @@
+import * as React from 'react';
+import { C as ComponentProps } from './types-DT4FOOa2.js';
+import { aV as DataSurfaceProps } from './events-DOGItflK.js';
+import { F as FilterFn, S as SearchNormalizer } from './ListboxStore-BYBpGrOz.js';
+
+interface PopupMenuIconState extends Record<string, unknown> {
+    /**
+     * Whether the popup is currently open.
+     */
+    open: boolean;
+}
+interface PopupMenuIconProps extends ComponentProps<'span', PopupMenuIcon.State> {
+}
+/**
+ * An icon that indicates the trigger opens a popup.
+ * Typically used inside the trigger to show a chevron or dropdown arrow.
+ * Renders a `<span>` element.
+ */
+declare const PopupMenuIcon: React.ForwardRefExoticComponent<Omit<PopupMenuIcon.Props, "ref"> & React.RefAttributes<HTMLSpanElement>>;
+declare namespace PopupMenuIcon {
+    type State = PopupMenuIconState;
+    interface Props extends PopupMenuIconProps {
+    }
+}
+
+interface PopupMenuEmptyState extends Record<string, unknown> {
+    first: boolean;
+    last: boolean;
+}
+interface PopupMenuEmptyProps extends ComponentProps<'div', PopupMenuEmpty.State> {
+    children: React.ReactNode;
+}
+/**
+ * Renders when no items match the current search query.
+ * Only visible when there's an active search with zero results.
+ * Renders a `<div>` element.
+ */
+declare const PopupMenuEmpty: React.ForwardRefExoticComponent<Omit<PopupMenuEmpty.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuEmpty {
+    type State = PopupMenuEmptyState;
+    interface Props extends PopupMenuEmptyProps {
+    }
+}
+
+/**
+ * State passed to children render function.
+ */
+interface PopupMenuListChildrenState {
+    /** Current search query */
+    search: string;
+    /** Number of items matching the current filter */
+    filteredCount: number;
+}
+interface PopupMenuListState extends Record<string, unknown> {
+}
+interface PopupMenuListProps extends Omit<ComponentProps<'div', PopupMenuList.State>, 'children' | 'content'> {
+    /**
+     * Content to render inside the list.
+     * Can be a render function that receives the current search state.
+     */
+    children: React.ReactNode | ((state: PopupMenuListChildrenState) => React.ReactNode);
+    /**
+     * Accessible label for the listbox.
+     * @default 'Suggestions'
+     */
+    label?: string;
+    /**
+     * When true, measures row widths and applies `--row-width` CSS variable.
+     * Keeps the list at the maximum width seen while scrolling.
+     * Useful for virtualized lists where content width varies.
+     * @default true
+     */
+    measureRowWidth?: boolean;
+    /**
+     * Maximum width cap for row measurement (in pixels).
+     * Only used when `measureRowWidth` is true.
+     */
+    maxRowWidth?: number;
+    /**
+     * Ref to the element that owns the list's scroll position.
+     * Use when the semantic list is rendered inside another scroll container.
+     */
+    scrollContainerRef?: React.RefObject<HTMLElement | null>;
+    /**
+     * When any value in this array changes, previously-measured row IDs are
+     * cleared so rows re-measure (the sticky max width is kept — it only ever
+     * grows until the menu closes). Use for state that changes row content for
+     * the same IDs, e.g. tree rows that re-render as breadcrumb rows when deep
+     * search toggles. Values are compared with `Object.is`, so pass stable
+     * primitives — an inline object recreated each render would re-trigger
+     * every render.
+     */
+    remeasureDependencies?: React.DependencyList;
+}
+declare const PopupMenuList: React.ForwardRefExoticComponent<Omit<PopupMenuList.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuList {
+    type State = PopupMenuListState;
+    type ChildrenState = PopupMenuListChildrenState;
+    interface Props extends PopupMenuListProps {
+    }
+}
+
+interface PopupMenuSurfaceState extends Record<string, unknown> {
+}
+interface PopupMenuSurfaceProps extends Omit<ComponentProps<'div', PopupMenuSurface.State>, 'content'>, DataSurfaceProps {
+    /**
+     * Filter function for matching items against search query.
+     * Returns a score between 0 and 1 (0 = no match, > 0 = match).
+     * Pass `false` to disable filtering entirely.
+     * @default commandScore (fuzzy matching)
+     */
+    filter?: FilterFn | false;
+    /**
+     * Transforms search input before filtering and visibility logic.
+     * @default trim whitespace (`search.trim()`)
+     */
+    normalizeSearch?: SearchNormalizer;
+    /**
+     * Controlled search value.
+     */
+    search?: string;
+    /**
+     * Callback when search value changes.
+     */
+    onSearchChange?: (search: string) => void;
+    /**
+     * Default search value for uncontrolled usage.
+     * @default ''
+     */
+    defaultSearch?: string;
+    /**
+     * Whether navigation should loop from last to first item and vice versa.
+     * @default true
+     */
+    loop?: boolean;
+    /**
+     * Controls auto-highlighting behavior when the menu opens.
+     * - `true`: highlight the first item (default)
+     * - `false`: don't auto-highlight any item
+     * - `string`: highlight the item with this specific value
+     * @default true
+     */
+    autoHighlightFirst?: boolean | string;
+    /**
+     * Whether to clear the search query when the menu closes.
+     * - `'after-exit'`: clear after exit animation completes (default)
+     * - `true`: clear immediately when menu closes
+     * - `false`: preserve search when menu closes
+     * @default 'after-exit'
+     */
+    clearSearchOnClose?: boolean | 'after-exit';
+    /**
+     * Whether to reset the list scroll position when the search query changes.
+     * @default true
+     */
+    resetScrollOnSearch?: boolean;
+    /**
+     * Whether to skip auto-focusing the input/list when this surface becomes the focus owner.
+     * Useful for Combobox where the input is outside the popup and should retain focus.
+     * @default false
+     */
+    skipAutoFocus?: boolean;
+    /**
+     * Ordered list of item values when using `filter={false}`.
+     * This tells the store the intended display order for navigation/highlighting.
+     * Required when `filter={false}` - must always be provided with the current visible items.
+     */
+    orderedItems?: string[];
+    children: React.ReactNode;
+}
+/**
+ * Provides search context and manages item registration for popup menu.
+ * Place inside PopupMenu.Popup to enable search functionality.
+ * Renders a `<div>` element.
+ */
+declare const PopupMenuSurface: React.ForwardRefExoticComponent<Omit<PopupMenuSurface.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuSurface {
+    type State = PopupMenuSurfaceState;
+    interface Props extends PopupMenuSurfaceProps {
+    }
+}
+
+interface PopupMenuGroupState extends Record<string, unknown> {
+    /**
+     * Whether the group is hidden due to no matching items.
+     */
+    hidden: boolean;
+    /**
+     * Present when this is the first visible group in the list.
+     */
+    firstGroup: boolean;
+    /**
+     * Present when this is the last visible group in the list.
+     */
+    lastGroup: boolean;
+    first: boolean;
+    last: boolean;
+}
+interface PopupMenuGroupProps extends ComponentProps<'div', PopupMenuGroup.State> {
+    /**
+     * Whether to force render this group regardless of filter results.
+     * @default false
+     */
+    forceMount?: boolean;
+    children: React.ReactNode;
+}
+/**
+ * Groups related popup menu items together.
+ * Hidden when no child items match the current filter.
+ * Renders a `<div>` element with role="group".
+ */
+declare const PopupMenuGroup: React.ForwardRefExoticComponent<Omit<PopupMenuGroup.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuGroup {
+    type State = PopupMenuGroupState;
+    interface Props extends PopupMenuGroupProps {
+    }
+}
+
+interface PopupMenuGroupLabelState extends Record<string, unknown> {
+    /**
+     * Present when this label is the first row in the list.
+     */
+    first: boolean;
+    /**
+     * Present when this label is the last row in the list.
+     */
+    last: boolean;
+    /**
+     * Present when this label's parent group is the first visible group in the list.
+     */
+    firstGroup: boolean;
+    /**
+     * Present when this label's parent group is the last visible group in the list.
+     */
+    lastGroup: boolean;
+}
+interface PopupMenuGroupLabelProps extends ComponentProps<'div', PopupMenuGroupLabel.State> {
+    children: React.ReactNode;
+}
+/**
+ * A label/heading for a group of popup menu items.
+ * Renders a `<div>` element with role="presentation".
+ */
+declare const PopupMenuGroupLabel: React.ForwardRefExoticComponent<Omit<PopupMenuGroupLabel.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuGroupLabel {
+    type State = PopupMenuGroupLabelState;
+    interface Props extends PopupMenuGroupLabelProps {
+    }
+}
+
+interface PopupMenuSeparatorState extends Record<string, unknown> {
+    first: boolean;
+    last: boolean;
+}
+interface PopupMenuSeparatorProps extends ComponentProps<'div', PopupMenuSeparator.State> {
+    /**
+     * Whether to always render the separator, even during search.
+     * By default, separators are hidden when there's an active search query.
+     * @default false
+     */
+    alwaysRender?: boolean;
+}
+/**
+ * A visual separator between popup menu items.
+ * Hidden during active search unless `alwaysRender` is true.
+ * Renders a `<div>` element with role="separator".
+ */
+declare const PopupMenuSeparator: React.ForwardRefExoticComponent<Omit<PopupMenuSeparator.Props, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare namespace PopupMenuSeparator {
+    type State = PopupMenuSeparatorState;
+    interface Props extends PopupMenuSeparatorProps {
+    }
+}
+
+export { PopupMenuEmpty as P, PopupMenuGroup as a, PopupMenuGroupLabel as b, PopupMenuIcon as c, PopupMenuList as d, PopupMenuSeparator as e, PopupMenuSurface as f, type PopupMenuEmptyProps as g, type PopupMenuEmptyState as h, type PopupMenuGroupLabelProps as i, type PopupMenuGroupLabelState as j, type PopupMenuGroupProps as k, type PopupMenuGroupState as l, type PopupMenuIconProps as m, type PopupMenuIconState as n, type PopupMenuListChildrenState as o, type PopupMenuListProps as p, type PopupMenuListState as q, type PopupMenuSeparatorProps as r, type PopupMenuSeparatorState as s, type PopupMenuSurfaceProps as t, type PopupMenuSurfaceState as u };

package/dist/surface-context-ClmxshBW.d.ts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import { b as ListboxStore } from './ListboxStore-BYBpGrOz.js';
+
+interface SurfaceContextValue {
+    /** The Listbox store instance */
+    store: ListboxStore;
+    /** Unique identifier for this surface */
+    surfaceId: string;
+}
+declare const SurfaceContext: React.Context<SurfaceContextValue | null>;
+declare function useSurfaceContext(): SurfaceContextValue;
+declare function useMaybeSurfaceContext(): SurfaceContextValue | null;
+
+export { type SurfaceContextValue as S, useSurfaceContext as a, SurfaceContext as b, useMaybeSurfaceContext as u };

package/dist/surface-context-DF-L-30G.d.cts

@@ -0,0 +1,14 @@
+import * as React from 'react';
+import { b as ListboxStore } from './ListboxStore-nmorsoqX.cjs';
+
+interface SurfaceContextValue {
+    /** The Listbox store instance */
+    store: ListboxStore;
+    /** Unique identifier for this surface */
+    surfaceId: string;
+}
+declare const SurfaceContext: React.Context<SurfaceContextValue | null>;
+declare function useSurfaceContext(): SurfaceContextValue;
+declare function useMaybeSurfaceContext(): SurfaceContextValue | null;
+
+export { type SurfaceContextValue as S, useSurfaceContext as a, SurfaceContext as b, useMaybeSurfaceContext as u };