pixelize-design-library 2.4.2-beta.66 → 2.4.2-beta.68

package/dist/Components/Modal/ModalProps.d.ts

@@ -3,11 +3,15 @@ import { ModalContentProps, ModalProps, ModalHeaderProps, ModalBodyProps, ModalF
 export type ChakraModelProps = Pick<ModalProps, "isOpen" | "onClose" | "finalFocusRef" | "blockScrollOnMount" | "initialFocusRef" | "closeOnOverlayClick" | "closeOnEsc" | "trapFocus" | "isCentered" | "motionPreset" | "scrollBehavior"> & {
     /** Overrides the theme scrim colour on ModalOverlay. */
     overlaybg?: string;
+    /** Chakra `backdropFilter` value applied to the scrim, e.g. `blur(4px)`. */
     overlaybackdropFilter?: string;
+    /** Chakra `backdropInvert` value applied to the scrim, e.g. `80%`. */
     overlaybackdropInvert?: string;
+    /** Chakra `backdropBlur` value applied to the scrim, e.g. `4px` or `sm`. */
     overlaybackdropBlur?: string;
+    /** Dialog width from `xs` to `6xl`; `full` fills the viewport. Required. */
     size: "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl" | "4xl" | "5xl" | "6xl" | "full";
-    /** Only ModalHeader/ModalBody/ModalFooter render, matched by type one fragment deep; any other child is dropped (dev console.warn) — use `portalChildren`. */
+    /** Only ModalHeader/ModalBody/ModalFooter render, matched by type through nested Fragments; any other child is dropped (dev console.warn) — use `portalChildren`. */
     children?: React.ReactNode;
     /** Spinner replaces body and footer; header and close button stay. */
     isLoading?: boolean;
@@ -15,6 +19,7 @@ export type ChakraModelProps = Pick<ModalProps, "isOpen" | "onClose" | "finalFoc
     title?: React.ReactNode;
     /** Muted line under the header; renders a header even without `title`. */
     subtitle?: React.ReactNode;
+    /** Hides the top-right close (X) button; Esc and overlay click still close unless disabled. */
     hideCloseButton?: boolean;
     /** Spread onto ModalContent last, so it overrides `aria-busy` and theme styles. */
     contentProps?: ModalContentProps;

package/dist/Components/MoreItems/MoreItemsProps.d.ts

@@ -1,7 +1,9 @@
 import { ReactNode } from "react";
 /** One row in the MoreItems popover grid — id, label and an optional dot color. */
 export interface MoreItem {
+    /** React key for the row; not shown or emitted. */
     id: string | number;
+    /** Row text, truncated with an ellipsis when it overflows the column. */
     label: string;
     /** Optional leading dot color. Falls back to colorResolver or a neutral gray. */
     color?: string;

package/dist/Components/MultiSelect/MultiSelect.d.ts

@@ -1,2 +1,3 @@
 import { MultiSelectProps } from "./MultiSelectProps";
+/** Email chip input: typed addresses are validated and committed on Enter, shown as removable chips. */
 export default function MultiSelect({ value, onValueChange, width, label, isRequired, isInformation, informationMessage, name, id, placeholderText, isDisabled, isReadOnly, addOnBlur, size, inputStyle, helperText, error, errorMessage, }: MultiSelectProps): import("react/jsx-runtime").JSX.Element;

package/dist/Components/MultiSelect/MultiSelect.js

@@ -25,6 +25,7 @@ const generateUniqueId = (() => {
         return `${Date.now()}-${counter}`;
     };
 })();
+/** Email chip input: typed addresses are validated and committed on Enter, shown as removable chips. */
 function MultiSelect({ value, onValueChange, width = "100%", label = "label", isRequired = true, isInformation = false, informationMessage = "", name, id, placeholderText = "Type valid email and press enter", isDisabled, isReadOnly, addOnBlur = false, size = controlSizes_1.DEFAULT_CONTROL_SIZE, inputStyle, helperText, error, errorMessage, }) {
     const theme = (0, useCustomTheme_1.useCustomTheme)();
     const s = (0, searchSelectSize_1.getSearchSelectSizeStyles)((size || controlSizes_1.DEFAULT_CONTROL_SIZE));

package/dist/Components/MultiSelect/MultiSelectProps.d.ts

@@ -1,18 +1,28 @@
 /** No `options` prop — typed text is validated as an email, not picked from a list; use `SearchSelect isMultiple`. */
 export type MultiSelectProps = {
+    /** Controlled list of entered chips; the component never keeps its own copy. */
     value: MultiSelectOption[];
+    /** Fires with the full new list when an email is added, a chip is removed, or Backspace on empty input drops the last chip. */
     onValueChange: (options: MultiSelectOption[]) => void;
+    /** CSS width of the whole field; defaults to "100%". */
     width?: string;
+    /** Label text above the field; defaults to the literal "label", and an empty string hides the label. */
     label?: string;
     /** DOM id of the input; the label's `for` and the message ids derive from it. Auto-generated when omitted. */
     id?: string;
+    /** Native `name` of the text input. */
     name?: string;
     /** Sets native `required` + `aria-required` on the field, and draws the label asterisk. Defaults to true. */
     isRequired?: boolean;
+    /** Shows an info icon beside the label; renders nothing unless `informationMessage` is also set. */
     isInformation?: boolean;
+    /** Tooltip text of the label's info icon; only read when `isInformation` is true. */
     informationMessage?: string;
+    /** Placeholder of the text input, shown only while no chips exist; defaults to "Type valid email and press enter". */
     placeholderText?: string;
+    /** Disables the text input and applies the disabled field styling. */
     isDisabled?: boolean;
+    /** Makes the text input read-only and stops `addOnBlur` from committing; chips can still be removed. */
     isReadOnly?: boolean;
     /** Also commits the typed email when the field loses focus, not just on Enter. Defaults to false. */
     addOnBlur?: boolean;
@@ -20,6 +30,7 @@ export type MultiSelectProps = {
     error?: boolean;
     /** Height on the field control scale (xs 32 · sm 38 · md 40 · lg 48px). Defaults to `sm`. */
     size?: "xs" | "sm" | "md" | "lg";
+    /** Inline style merged over the text input's own style (after a transparent background), not the outer field. */
     inputStyle?: object;
     /** Rendered only while `error` is true; a rejected email's internal "Invalid email address" text wins over this until the input changes. */
     errorMessage?: string;
@@ -28,7 +39,9 @@ export type MultiSelectProps = {
 };
 /** One entered chip — id is a generated key, label is the email text the user typed. */
 export type MultiSelectOption = {
+    /** Generated unique key for the chip; not derived from the email. */
     id: string;
+    /** The email address as typed; duplicates are rejected by comparing this. */
     label: string;
 };
 /** @deprecated Typo'd name — use `MultiSelectOption`. */

package/dist/Components/NavLauncher/NavLauncher.js

@@ -63,6 +63,7 @@ const LauncherTabs_1 = require("./LauncherTabs");
 const match_1 = require("./match");
 const NewTabLink_1 = __importDefault(require("./NewTabLink"));
 const PinToggle_1 = __importDefault(require("./PinToggle"));
+const launcherMotion_1 = require("./launcherMotion");
 const resultNavigation_1 = require("./resultNavigation");
 const ScopeBar_1 = require("./ScopeBar");
 const searchLayout_1 = require("./searchLayout");
@@ -243,6 +244,7 @@ function NavLauncher({ isOpen, onClose, sections: rawSections, pinnedIds, freque
     const isDesktop = (0, useMatchMedia_1.useMatchMedia)(MD_QUERY, true);
     const isLg = (0, useMatchMedia_1.useMatchMedia)(LG_QUERY, true);
     const isWide = (0, useMatchMedia_1.useMatchMedia)(XL_QUERY, false);
+    const isReducedMotion = (0, motion_1.usePrefersReducedMotion)();
     const columns = isWide ? 3 : isDesktop ? 2 : 1;
     const [innerQuery, setInnerQuery] = (0, react_2.useState)("");
     const [activeIndex, setActiveIndex] = (0, react_2.useState)(0);
@@ -828,6 +830,7 @@ function NavLauncher({ isOpen, onClose, sections: rawSections, pinnedIds, freque
                 borderBottomRightRadius: { base: 0, lg: "16px" },
                 boxShadow: colors.boxShadow.default,
                 overflow: "hidden",
+                motionProps: (0, launcherMotion_1.launcherSlide)(isReducedMotion),
                 onKeyDown: onContentKeyDown,
                 ...{ "data-testid": testId },
             }, children: [(0, jsx_runtime_1.jsxs)(Drawer_1.DrawerHeader, { p: 0, flexShrink: 0, children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { "data-testid": "launcher-header-row", align: "center", gap: { base: "8px", md: "12px" }, minH: { base: "60px", md: "68px" }, pl: { base: "12px", md: "18px" }, pr: { base: "8px", md: "12px" }, children: [(0, jsx_runtime_1.jsx)(react_1.VisuallyHidden, { as: "h2", id: titleId, children: labels.title }), (0, jsx_runtime_1.jsx)(SearchField, { inputRef: inputRef, value: query, onChange: setQuery, onKeyDown: onInputKeyDown, labels: labels, placeholder: (_c = currentScope === null || currentScope === void 0 ? void 0 : currentScope.placeholder) !== null && _c !== void 0 ? _c : labels.searchPlaceholder, hint: searchHint, listboxId: listboxId, activeId: isListView && hasResults ? optionId(active) : undefined, isExpanded: isListView, hasResults: hasResults, minW: inlineScopes ? FIELD_MIN_WIDTH : 0 }), inlineScopes, (0, jsx_runtime_1.jsx)(react_1.Box, { "aria-hidden": true, "data-testid": "launcher-count", display: { base: "none", sm: "block" }, flexShrink: 0, overflow: "hidden", w: countText ? "88px" : "0", opacity: countText ? 1 : 0, textAlign: "right", fontSize: "13px", whiteSpace: "nowrap", color: colors.textMuted, transition: (0, motion_2.transitionFor)(["width", "opacity"]), sx: { fontVariantNumeric: "tabular-nums", ...(0, motion_1.reducedMotionSx)() }, children: countText }), headerActions ? ((0, jsx_runtime_1.jsx)(react_1.Flex, { align: "center", gap: "4px", flexShrink: 0, children: headerActions })) : null, (0, jsx_runtime_1.jsx)(react_1.IconButton, { "aria-label": labels.close, icon: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: 18, "aria-hidden": true }), variant: "ghost", boxSize: { base: "40px", md: "44px" }, minW: { base: "40px", md: "44px" }, borderRadius: "10px", flexShrink: 0, color: colors.textMuted, onClick: onClose })] }), scopeRow ? ((0, jsx_runtime_1.jsx)(react_1.Box, { "data-testid": "launcher-scope-row", pl: "7px", pr: "3px", mt: "-6px", pb: "4px", children: scopeRow })) : null] }), (0, jsx_runtime_1.jsx)(Drawer_1.DrawerBody, { p: 0, display: "flex", flexDirection: "column", overflowY: "hidden", minH: 0, children: (0, jsx_runtime_1.jsxs)(react_1.Flex, { ref: bodyRef, direction: "column", flex: 1, minH: 0, minW: 0, children: [(0, jsx_runtime_1.jsx)(react_1.VisuallyHidden, { "data-testid": "launcher-live", "aria-live": "polite", "aria-atomic": "true", children: countText }), (0, jsx_runtime_1.jsx)(react_1.VisuallyHidden, { "data-testid": "launcher-announce", "aria-live": "polite", "aria-atomic": "true", children: (0, jsx_runtime_1.jsx)("span", { children: announcement.text }, announcement.n) }), isTabbed ? ((0, jsx_runtime_1.jsx)(LauncherTabs_1.LauncherTabs, { tabs: tabs, selected: activeTab, onSelect: setTab, idBase: baseId, label: labels.tabsLabel, onLeaveUp: () => focusField(), onLeaveDown: () => moveFocus("first") })) : null, isLg ? ((0, jsx_runtime_1.jsx)(react_1.Flex, { direction: "row", flex: 1, minH: 0, minW: 0, children: body })) : (compactBody), dock] }) }), (0, jsx_runtime_1.jsxs)(Drawer_1.DrawerFooter, { p: 0, minH: "32px", flexShrink: 0, px: "18px", py: "6px", gap: "6px 14px", flexWrap: "wrap", bg: colors.backgroundColor.subtle, fontSize: "xs-minus", color: colors.textMuted, whiteSpace: "nowrap", justifyContent: "flex-start", children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { display: { base: "none", md: "flex" }, gap: "6px 14px", align: "center", wrap: "wrap", "aria-hidden": true, sx: { "@media (hover: none)": { display: "none" } }, children: [(0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "span", align: "center", gap: "5px", children: [(0, jsx_runtime_1.jsx)(react_1.Flex, { as: "span", gap: "2px", children: ARROW_KEYS.map((arrow) => ((0, jsx_runtime_1.jsx)(Kbd_1.default, { size: "xs", children: arrow }, arrow))) }), labels.hintMove] }), (0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "span", align: "center", gap: "5px", children: [(0, jsx_runtime_1.jsx)(Kbd_1.KbdShortcut, { shortcut: "enter", size: "xs" }), (0, jsx_runtime_1.jsx)(launcherParts_1.HintLabel, { text: enterLabel, reserve: enterReserve })] }), (0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "span", align: "center", gap: "5px", opacity: canOpenInTab ? 1 : 0.45, transition: (0, motion_2.transitionFor)(["opacity"]), sx: (0, motion_1.reducedMotionSx)(), children: [modKeyLabel ? ((0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "span", gap: "4px", children: [(0, jsx_runtime_1.jsx)(Kbd_1.default, { size: "xs", children: modKeyLabel }), (0, jsx_runtime_1.jsx)(Kbd_1.default, { size: "xs", children: ENTER_KEY })] })) : ((0, jsx_runtime_1.jsx)(Kbd_1.KbdShortcut, { shortcut: "mod+enter", size: "xs" })), labels.hintNewTab] }), (0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "span", align: "center", gap: "5px", display: { base: "none", lg: "flex" }, children: [(0, jsx_runtime_1.jsx)(Kbd_1.default, { size: "xs", children: modKeyLabel !== null && modKeyLabel !== void 0 ? modKeyLabel : MOD_KEY }), labels.hintClickNewTab] }), onTogglePin ? ((0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "span", align: "center", gap: "5px", children: [(0, jsx_runtime_1.jsx)(Kbd_1.default, { size: "xs", children: "P" }), labels.hintPin] })) : null, (0, jsx_runtime_1.jsxs)(react_1.Flex, { as: "span", align: "center", gap: "5px", children: [(0, jsx_runtime_1.jsx)(Kbd_1.KbdShortcut, { shortcut: "esc", size: "xs" }), labels.hintClose] })] }), (0, jsx_runtime_1.jsx)(react_1.Text, { as: "span", ml: "auto", children: labels.footerNote })] })] }) }));

package/dist/Components/NavLauncher/NavLauncherProps.d.ts

@@ -5,59 +5,84 @@ import type { LauncherSynonyms } from "./engine";
 export type LauncherIcon = ElementType;
 /** One destination the launcher can open; screens are what pins, Frequent and Recent refer to. */
 export type LauncherScreen = {
+    /** Unique across all sections; the id that pins, Frequent and Recent refer to. */
     id: string;
+    /** Row text; also what search matches first. */
     label: string;
+    /** Destination of the row's link; Enter passes it to `onNavigate`. */
     href: string;
+    /** Row icon; falls back to the module's icon in search results. */
     icon?: LauncherIcon;
+    /** Count or short text shown on the row. */
     badge?: number | string;
+    /** Extra terms the query may match; never rendered. */
     keywords?: readonly string[];
     /** Listed on the module's second line (first `keyScreenLimit` of them). */
     isKey?: boolean;
 };
 /** A group of screens shown as one row in the browse view. */
 export type LauncherModule = {
+    /** Unique across sections. */
     id: string;
+    /** Row title; also what search matches first. */
     label: string;
     /** Normally its first visible screen's href. */
     href: string;
+    /** Icon beside the title. */
     icon?: LauncherIcon;
+    /** Count or short text shown on the module row. */
     badge?: number | string;
     /** Shows a small "New" tag after the name. */
     isNew?: boolean;
+    /** Extra terms the query may match; never rendered. */
     keywords?: readonly string[];
     /** Pinning the module pins `screens[0]`; a module with no screens is not rendered. */
     screens: readonly LauncherScreen[];
 };
 /** A labelled run of modules; a section with no renderable module is dropped. */
 export type LauncherSection = {
+    /** Unique key of the section. */
     id: string;
+    /** Section heading. */
     label: string;
+    /** Modules in display order; modules with no screens are skipped. */
     modules: readonly LauncherModule[];
 };
 /** One label/value pair of a result, e.g. PAN: ABCDE1234F; plain text only, never HTML. */
 export type LauncherFact = {
+    /** Name shown before the value, e.g. "PAN". */
     label: string;
+    /** Text shown, and copied when `copyable`. */
     value: string;
     /** Adds a Copy button; a blocked clipboard selects the value instead. */
     copyable?: boolean;
 };
 /** Direct-answer payload, e.g. label "Next holiday", value "24 Oct — Diwali". */
 export type LauncherAnswer = {
+    /** Heading of the answer card. */
     label: string;
+    /** The answer itself, shown large; plain text. */
     value: string;
+    /** Small line under the value. */
     hint?: string;
 };
 /** A search row that is not a screen: an action (`run`) or an entity result (`href`). */
 export type LauncherSearchItem = {
+    /** Unique within its list; prefixed internally with the group or "action". */
     id: string;
+    /** Row text; also what search matches first. */
     label: string;
     /** Second line, e.g. the module a result belongs to. */
     context?: string;
+    /** Row icon. */
     icon?: LauncherIcon;
     /** Extra terms the query may match; never rendered. Separate phrases with commas. */
     keywords?: string;
+    /** Short text appended to `context` on the second line, separated by a dot. */
     hint?: string;
+    /** Destination of an entity result; Enter passes it to `onNavigate`. */
     href?: string;
+    /** Action to perform; the launcher closes first, then calls it. */
     run?: () => void;
     /** Shown in the Preview pane for the active result; searchable in spotlight. */
     facts?: readonly LauncherFact[];
@@ -66,8 +91,11 @@ export type LauncherSearchItem = {
 };
 /** A titled batch of remote results, rendered after Screens in the order given. */
 export type LauncherResultGroup = {
+    /** Unique key of the group; also its default scope id. */
     id: string;
+    /** Group heading. */
     label: string;
+    /** Results in display order. */
     items: readonly LauncherSearchItem[];
     /** Scope chip this group belongs to; defaults to `id`. */
     scope?: string;
@@ -76,7 +104,9 @@ export type LauncherResultGroup = {
 };
 /** A filter chip; "screens" and "actions" are built in, others match `LauncherResultGroup.scope`. */
 export type LauncherScope = {
+    /** "all", "screens", "actions" or a `LauncherResultGroup.scope`. */
     id: string;
+    /** Chip text. */
     label: string;
     /** Field placeholder while this chip is selected, e.g. "Search legal name, PAN, GSTIN…"; the field's accessible name stays `labels.searchPlaceholder`. */
     placeholder?: string;
@@ -87,20 +117,35 @@ export type LauncherSearchMode = "classic" | "spotlight";
 export type LauncherLabels = {
     /** Accessible name of the dialog and the results list; no longer drawn as a header pill. */
     title: string;
+    /** Search field placeholder and accessible name. */
     searchPlaceholder: string;
+    /** Accessible name of the clear-query button. */
     clearSearch: string;
+    /** Accessible name of the close button. */
     close: string;
+    /** Heading of the Pinned section. */
     pinned: string;
+    /** Message shown in Pinned when nothing is pinned. */
     pinnedEmpty: string;
+    /** Heading of the Frequently visited section. */
     frequent: string;
+    /** Heading of the Recent section. */
     recent: string;
+    /** Name for a Screens result group; NavLauncher does not read it, hosts pass it as `screensLabel` to `searchLauncher`. */
     screensGroup: string;
+    /** Name of the group holding matching `actions` in search results. */
     actionsGroup: string;
+    /** Accessible name of a pin button for the named screen, e.g. "Pin Leave". */
     pin: (label: string) => string;
+    /** Accessible name of an unpin button for the named screen. */
     unpin: (label: string) => string;
+    /** Accessible name of the new-tab arrow beside the named row. */
     openInNewTab: (label: string) => string;
+    /** Heading of the empty state for the given query. */
     noResults: (query: string) => string;
+    /** Line under the empty-state heading when no `suggestions` are given. */
     noResultsHint: string;
+    /** Empty-state heading while `isSearching` and nothing local matched. */
     searching: string;
     /** Accessible name of the skeleton region while `isLoading`. */
     loading: string;
@@ -187,17 +232,22 @@ export type LauncherLabels = {
 };
 /** Passed to `onNavigate`; `newTab` is true for mod+Enter. */
 export type LauncherNavigateOptions = {
+    /** True when the open was requested in a new tab (mod+Enter). */
     newTab: boolean;
 };
 /** Full-height navigation launcher: browse every screen, search, pins, Frequent, Recent and optionally the suite's apps. */
 export interface NavLauncherProps {
+    /** Shows the launcher; the query resets when it closes. */
     isOpen: boolean;
+    /** Called on Escape with an empty query, the close button, a plain-click navigation, `run` and app selection. */
     onClose: () => void;
     /** Already permission-filtered by the app. Empty sections/modules are dropped, never rendered as gaps. */
     sections: readonly LauncherSection[];
     /** Screen ids in display order; ids not in `sections` are ignored silently. */
     pinnedIds: readonly string[];
+    /** Screen ids in display order; pinned ids are skipped and the list is cut at `frequentLimit`. */
     frequentIds: readonly string[];
+    /** Screen ids in display order; ids not in `sections` are ignored silently. */
     recentIds: readonly string[];
     /** Omit to hide every pin toggle (read-only launcher). */
     onTogglePin?: (screenId: string) => void;
@@ -205,6 +255,7 @@ export interface NavLauncherProps {
     onNavigate: (href: string, options: LauncherNavigateOptions) => void;
     /** Anchor-like component receiving `href`, `target`, `rel`, `onClick`, `ref`. Defaults to `"a"`. */
     linkAs?: ElementType;
+    /** Command rows matched by search under the Actions group; each has `run` or `href`. */
     actions?: readonly LauncherSearchItem[];
     /** Remote results, already filtered by the app; rendered after Screens in the given order. */
     extraResults?: readonly LauncherResultGroup[];
@@ -232,6 +283,7 @@ export interface NavLauncherProps {
     headerActions?: ReactNode;
     /** Panel width at `lg`+; always full width below `lg`. Defaults to "1080px". */
     maxWidth?: string;
+    /** Overrides for any `LauncherLabels` key; unset keys keep their English default. */
     labels?: Partial<LauncherLabels>;
     /** Other Pixelize apps, shown as an "Apps" section at the bottom of the right rail. Same shape as AppSwitcher. */
     apps?: AppOption[];
@@ -249,6 +301,7 @@ export interface NavLauncherProps {
     scopes?: readonly LauncherScope[];
     /** Controlled scope id; omit for uncontrolled ("all", reset on close). */
     activeScope?: string;
+    /** Called with the new scope id whenever the user picks a chip, controlled or not. */
     onScopeChange?: (scope: string) => void;
     /** Up to 5 pill buttons at the top of the menu while the query is empty and the scope is All; each runs or links like an action. */
     quickActions?: readonly LauncherSearchItem[];
@@ -256,13 +309,16 @@ export interface NavLauncherProps {
     answers?: readonly LauncherSearchItem[];
     /** Rows per group before "Show N more"; default 5 in spotlight, unlimited in classic. */
     groupLimit?: number;
+    /** Test id on the drawer content. */
     "data-testid"?: string;
 }
 /** Props for the star pin toggle used on launcher rows and reusable on a landing page; shows only while its row is hovered or focused. */
 export interface PinToggleProps {
+    /** Draws the star filled when true. */
     isPinned: boolean;
     /** Accessible name and tooltip, e.g. "Pin Leave". */
     label: string;
+    /** Called when the star is pressed. */
     onToggle: () => void;
     /** Tooltip text; defaults to `label`. */
     title?: string;
@@ -273,6 +329,7 @@ export interface PinToggleProps {
 }
 /** Props for the small "open in new tab" anchor beside a launcher row. */
 export interface NewTabLinkProps {
+    /** Link target, opened in a new tab. */
     href: string;
     /** Accessible name, e.g. "Open Leave in a new tab". */
     label: string;
@@ -280,5 +337,6 @@ export interface NewTabLinkProps {
     tip?: string;
     /** Anchor-like component receiving `href`, `target`, `rel`; defaults to `"a"`. */
     linkAs?: ElementType;
+    /** Pass -1 where the row itself is the tab stop. */
     tabIndex?: number;
 }

package/dist/Components/NavLauncher/engine/engine.d.ts

@@ -2,42 +2,59 @@ import { editDistance } from "./distance";
 import { foldText, splitWords, tokenize } from "./fold";
 /** One searchable string; `weight` scales its matches (label 1, keyword 0.75, context 0.4). */
 export type LauncherSearchField = {
+    /** Field identifier, reported back in `LauncherTokenMatch.field`. */
     name: string;
+    /** String to match, compared without case or accents. */
     text: string;
+    /** Scales this field's matches; defaults to 1. */
     weight?: number;
 };
 /** Anything searchable: an id plus its weighted fields, in the order results should tie-break. */
 export type LauncherSearchDocument = {
+    /** Identifier returned on the matching hit. */
     id: string;
+    /** Fields searched; each query token scores against its best field. */
     fields: readonly LauncherSearchField[];
 };
 /** How a query token matched a field, strongest first. */
 export type LauncherMatchKind = "exact" | "prefix" | "word" | "word-prefix" | "initialism" | "substring" | "fuzzy" | "subsequence";
 /** The field that gave a query token its best score. */
 export type LauncherTokenMatch = {
+    /** The query token this entry explains. */
     token: string;
+    /** `name` of the field that scored best for the token. */
     field: string;
+    /** Text of that field. */
     text: string;
+    /** How the token matched that field. */
     kind: LauncherMatchKind;
 };
 /** A ranked document: `index` is its input position, `synonym` the expansion used. */
 export type LauncherSearchHit = {
+    /** `id` of the matching document. */
     id: string;
+    /** Position of the document in the list that was indexed. */
     index: number;
+    /** Relevance, including any `boosts`; higher ranks first. */
     score: number;
+    /** Best match for each query token. */
     matches: LauncherTokenMatch[];
+    /** The synonym expansion that produced the hit; absent when the literal query matched. */
     synonym?: string;
 };
 /** Term -> equivalent phrases, matched both ways: `{ pf: ["provident fund"] }`. */
 export type LauncherSynonyms = Readonly<Record<string, readonly string[]>>;
 /** Ranking knobs; `boosts` adds points per document id to documents that already match. */
 export type LauncherSearchOptions = {
+    /** Equivalent terms expanded in both directions. */
     synonyms?: LauncherSynonyms;
+    /** Points added per document id to documents that already match; never adds a non-match. */
     boosts?: Readonly<Record<string, number>>;
     /** Typo tolerance; defaults to true. */
     fuzzy?: boolean;
     /** Drops hits under this share of the best score; 0 keeps all. */
     relativeCutoff?: number;
+    /** Maximum hits returned; unlimited when omitted. */
     limit?: number;
 };
 type IndexedField = {
@@ -60,7 +77,9 @@ type IndexedDocument = {
 };
 /** Pre-folded documents; build once with `createIndex`, query many times. */
 export type LauncherSearchIndex = {
+    /** Number of indexed documents. */
     readonly size: number;
+    /** Pre-folded records; internal shape, pass the index to the engine rather than reading it. */
     readonly documents: readonly IndexedDocument[];
 };
 export declare const createSearchIndex: (documents: readonly LauncherSearchDocument[]) => LauncherSearchIndex;

package/dist/Components/NavLauncher/launcherMotion.d.ts

@@ -0,0 +1,19 @@
+export declare const launcherSlide: (isReducedMotion: boolean) => {
+    variants: {
+        enter: {
+            x: number;
+            y: number;
+            transition: {
+                duration: number;
+            };
+        };
+        exit: {
+            x: string;
+            y: number;
+            transition: {
+                duration: number;
+                ease: (0 | 1 | 0.2 | 0.4)[];
+            };
+        };
+    };
+};

package/dist/Components/NavLauncher/launcherMotion.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launcherSlide = void 0;
+const react_1 = require("@chakra-ui/react");
+const motion_1 = require("../../Theme/tokens/primitives/motion");
+const ENTER = (0, motion_1.motionTransition)("enter", "out");
+const INSTANT = { duration: 0 };
+const EXIT = { duration: 0.15, ease: [...react_1.EASINGS.easeInOut] };
+const launcherSlide = (isReducedMotion) => ({
+    variants: {
+        enter: { x: 0, y: 0, transition: isReducedMotion ? INSTANT : ENTER },
+        exit: { x: "-100%", y: 0, transition: EXIT },
+    },
+});
+exports.launcherSlide = launcherSlide;

package/dist/Components/NavLauncher/match.d.ts

@@ -1,63 +1,97 @@
 import { type LauncherSynonyms } from "./engine/engine";
 import type { LauncherAnswer, LauncherFact, LauncherIcon, LauncherResultGroup, LauncherSearchItem, LauncherSection } from "./NavLauncherProps";
 export type LauncherResult = {
+    /** Unique within the result list; prefixed `screen:`, `module:`, `action:` or by the group id. */
     id: string;
+    /** Row text. */
     label: string;
+    /** Second line, such as the module a screen belongs to. */
     context?: string;
+    /** Row icon. */
     icon?: LauncherIcon;
+    /** Short text appended to `context`. */
     hint?: string;
+    /** Count or short text shown on the row. */
     badge?: number | string;
+    /** Destination of the row. */
     href?: string;
+    /** Action to perform instead of navigating. */
     run?: () => void;
+    /** Screen the row stands for, so it can be pinned and counted; a module row carries its first screen. */
     screenId?: string;
     /** Set on `searchLauncherSections` rows: a module row or one of its screens. */
     kind?: "module" | "screen";
     /** Keyword that matched a module or screen whose own name did not. */
     keywordHint?: string;
+    /** Shows the "New" tag after the label. */
     isNew?: boolean;
+    /** Label/value pairs shown in the Preview pane. */
     facts?: readonly LauncherFact[];
+    /** Direct-answer payload rendered as an answer card. */
     answer?: LauncherAnswer;
+    /** Relevance from the spotlight engine; higher ranks first. */
     score?: number;
 };
 export type LauncherResultView = {
+    /** Group id, e.g. "actions" or a `LauncherResultGroup.id`. */
     id: string;
+    /** Group heading. */
     label: string;
+    /** Matching rows in rank order. */
     items: LauncherResult[];
 };
 export declare function filterItems(items: readonly LauncherSearchItem[], query: string): LauncherSearchItem[];
 export declare function flattenScreens(sections: readonly LauncherSection[]): LauncherResult[];
 /** @deprecated Legacy flat search; NavLauncher uses searchLauncherSections (classic) or the spotlight engine. */
 export declare function searchLauncher(input: {
+    /** Text to match; all whitespace-separated tokens must appear. */
     query: string;
+    /** Sections whose screens are searched, flattened and de-duplicated by screen id. */
     sections: readonly LauncherSection[];
+    /** Command rows matched by label, context and keywords. */
     actions?: readonly LauncherSearchItem[];
+    /** Remote result groups appended unfiltered, in the given order. */
     extraResults?: readonly LauncherResultGroup[];
+    /** Heading of the Screens group. */
     screensLabel: string;
+    /** Heading of the Actions group. */
     actionsLabel: string;
 }): LauncherResultView[];
 export type LauncherSectionResult = {
+    /** Id of the source `LauncherSection`. */
     id: string;
+    /** Heading of the source section. */
     label: string;
+    /** Matching module rows, each followed by its matching screens. */
     items: LauncherResult[];
 };
 /** Search that keeps the sections: per section, matching modules, each followed by its matching screens. */
 export declare function searchLauncherSections(input: {
+    /** Text to match; all whitespace-separated tokens must appear. */
     query: string;
+    /** Sections whose modules and screens are searched. */
     sections: readonly LauncherSection[];
+    /** Command rows matched by label, context and keywords. */
     actions?: readonly LauncherSearchItem[];
+    /** Remote result groups appended unfiltered, in the given order. */
     extraResults?: readonly LauncherResultGroup[];
+    /** Heading of the Actions group. */
     actionsLabel: string;
 }): {
     sections: LauncherSectionResult[];
     groups: LauncherResultView[];
 };
 export type HighlightSegment = {
+    /** A slice of the original text. */
     text: string;
+    /** True when the slice matched the query. */
     isMatch: boolean;
 };
 /** Highlight options; `fuzzy` also marks prefix, typo, initial and accent-folded matches. */
 export type HighlightOptions = {
+    /** Also marks prefix, typo, initial and accent-folded matches; off marks plain substrings only. */
     fuzzy?: boolean;
+    /** Equivalent terms to mark too; only read when `fuzzy` is set. */
     synonyms?: LauncherSynonyms;
 };
 /** Splits `text` so every case-insensitive occurrence of a query token is its own matched segment. */

package/dist/Components/NavigationBar/NavigationBar.d.ts

@@ -1,2 +1,3 @@
 import { NavbarProps } from "./NavigationBarProps";
+/** Top bar with sidebar toggle, optional back button and title, a right-hand slot, and an avatar menu of navigation entries plus logout. */
 export default function NavBar({ userAvathar, userName, userRole, navMenu, moreIcon, handleNavOnClick, handleLogout, logoutText, navigationBarText, sideBarToggole, onSideBarToggole, forceSideBarToggle, onSideBarPeek, leading, }: NavbarProps): import("react/jsx-runtime").JSX.Element;

package/dist/Components/NavigationBar/NavigationBar.js

@@ -20,6 +20,7 @@ const motion_1 = require("../../Theme/tokens/primitives/motion");
 const BACKGROUND_TRANSITION = (0, motion_1.transitionFor)(["background"]);
 // Roomy enough to hover without aiming: the glyph is only 1.25rem.
 const SIDEBAR_TOGGLE_HIT = "2.5rem";
+/** Top bar with sidebar toggle, optional back button and title, a right-hand slot, and an avatar menu of navigation entries plus logout. */
 function NavBar({ userAvathar, userName, userRole, navMenu, moreIcon, handleNavOnClick, handleLogout, logoutText, navigationBarText, sideBarToggole, onSideBarToggole, forceSideBarToggle = false, onSideBarPeek, leading, }) {
     const theme = (0, useCustomTheme_1.useCustomTheme)();
     const rowBackgrounds = (0, rowStates_1.listRowBackgrounds)(theme.colors);

package/dist/Components/NavigationBar/NavigationBarProps.d.ts

@@ -3,19 +3,30 @@ import type { ReactNode } from "react";
 export type NavbarProps = {
     /** Prop name is spelled exactly this way ("Avathar") — not a typo to correct at the call site. */
     userAvathar?: string;
+    /** Name shown in the account menu header; also the avatar's initials source when no image is given. */
     userName: string;
+    /** Secondary line under the name in the account menu. */
     userRole?: string;
+    /** Entries listed in the account menu, in order, above the logout item. */
     navMenu: MenuProps[];
     /** Right-cluster slot before the avatar (org switcher, bell, launcher trigger). Its child may shrink; give icon buttons `flexShrink={0}`. */
     moreIcon?: ReactNode;
+    /** Called with a menu entry's `url` when it is chosen; the bar does not navigate itself. */
     handleNavOnClick: (url: string) => void;
+    /** Called when the logout item is chosen. */
     handleLogout: () => void;
+    /** Label of the logout item. */
     logoutText: string;
+    /** Page title shown on the left, with an optional back button. */
     navigationBarText?: {
+        /** Title content; truncated to one line, with a tooltip when the text is a string. */
         text: ReactNode;
+        /** Shows a "Go back" button before the title and calls this when pressed. */
         onIconClick?: () => void;
     };
+    /** Whether the sidebar is currently open; flips the hamburger icon and its accessible name. */
     sideBarToggole?: boolean;
+    /** Called when the hamburger is pressed. */
     onSideBarToggole?: () => void;
     /**
      * Force the sidebar hamburger to show at all widths (not just below `lg`).
@@ -34,8 +45,12 @@ export type NavbarProps = {
 };
 /** One navMenu entry (id/title/url/icon) — unrelated to Chakra's own MenuProps despite the shared name. */
 export type MenuProps = {
+    /** Optional key for the entry; falls back to `url`, then `title`. */
     id?: string | number;
+    /** Entry text, truncated to one line with a native title tooltip. */
     title: string;
+    /** Passed to `handleNavOnClick` when the entry is chosen. */
     url: string;
+    /** Leading icon, shown at 16px. */
     icon?: ReactNode;
 };

package/dist/Components/NoteTextArea/NoteTextAreaProps.d.ts

@@ -1,5 +1,6 @@
 /** Plain Chakra Textarea + title + file attach, not a rich text editor — no formatting toolbar despite the "note" naming. Use Editor for HTML content. */
 export type NoteTextAreaProps = {
+    /** Width of the whole composer; a number is px, a string is any CSS length. Defaults to "100%". */
     width?: number | string;
     /** Save click with note, title and files; `resetState` is never passed. */
     handleSubmit: (noteValue: string, titleValue: string, file: File[], 
@@ -21,7 +22,7 @@ export type NoteTextAreaProps = {
     maxFileSize?: number;
     /** Error prefix; the formatted limit and a full stop are appended. */
     maxFilesSizeError?: string;
-    /** Disables Save past this many words (default 15); the counter shows note words only. */
+    /** Disables Save when the note or the title exceeds this many words (default 15); the counter shows note words only. */
     maxNoteWordCount?: number;
     /** Note text after each edit; whitespace-only input is rejected and not reported. */
     onChange?: (value: string) => void;