@cwellt_software/cwellt-reactjs-lib 1.4.14 → 1.5.0

package/dist/src/common/hooks/useRovingSingleSelect.d.ts

@@ -0,0 +1,28 @@
+import React from "react";
+export interface RovingOption {
+    value: string;
+    disabled?: boolean;
+}
+export interface RovingSegmentProps {
+    /** Roving tabindex: 0 for the active segment, -1 for the rest (one tab stop). */
+    tabIndex: number;
+    /** Element ref used for programmatic focus during arrow-key navigation. */
+    ref: (element: HTMLElement | null) => void;
+    /** Arrow-key handler: move + select, wrapping and skipping disabled options. */
+    onKeyDown: (event: React.KeyboardEvent<HTMLElement>) => void;
+}
+/**
+ * Roving-tabindex single-select behaviour for a custom radio group (e.g. a segmented
+ * button strip that has no native grouping). The active segment is the selected one,
+ * or the first enabled option when nothing is selected. Arrow keys (Right/Down = next,
+ * Left/Up = previous) move focus and select, wrapping around and skipping disabled
+ * options; Space/Enter selects the focused segment.
+ *
+ * Native form controls (e.g. `<input type="radio">` sharing a name) already get this
+ * behaviour from the browser — use this hook only for non-native custom groups.
+ */
+export declare function useRovingSingleSelect<TOption extends RovingOption>(options: TOption[], value: string, onChange: (value: string) => void): {
+    activeIndex: number;
+    getSegmentProps: (index: number) => RovingSegmentProps;
+};
+//# sourceMappingURL=useRovingSingleSelect.d.ts.map

package/dist/src/common/hooks/useRovingSingleSelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRovingSingleSelect.d.ts","sourceRoot":"","sources":["../../../../src/common/hooks/useRovingSingleSelect.ts"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C,gFAAgF;IAChF,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;CAC7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,SAAS,YAAY,EACjE,OAAO,EAAE,OAAO,EAAE,EAClB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAC/B;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,kBAAkB,CAAA;CAAE,CAkEjF"}

package/dist/src/components/control/action/button/CwButton.d.ts

@@ -2,9 +2,12 @@
  * CwButton - Customizable button component with variant styles, color themes, and icon support
  *
  * @param text - Button text content (displayed in <strong> tag when no children)
- * @param variant - Button style: 'solid' (default), 'outline', or 'icon'
+ * @param variant - Button style: 'solid' (default), 'outline', 'icon', or 'ghost' (low-emphasis text button: transparent, fills with the container color on hover/press)
  * @param color - Color theme: 'primary' (default), 'danger', or 'neutral'
+ * @param size - Button size: 'small', 'medium' (default), or 'large'
  * @param icon - Icon identifier for CSS classes (cwi-{icon})
+ * @param iconPosition - Icon placement relative to the text: 'left' (default, icon-then-text) or 'right' (text-then-icon). Only affects the auto icon+text rendering, not the icon variant or custom children.
+ * @param pressed - Toggle/"on" state for a toggle button. When defined, sets `aria-pressed` and a selected fill; leave undefined for a normal (non-toggle) button. The consumer owns the state (`pressed` + `onClick`).
  * @param className - Additional CSS classes
  * @param title - Built-in tooltip
  * @param tooltipPosition - Tooltip position: 'top', 'bottom' (default), 'left', 'right'
@@ -12,18 +15,25 @@
  *
  * @example
  * <CwButton text="Save" />
+ * <CwButton text="Save" size="small" />
  * <CwButton text="Delete" variant="outline" color="danger" />
  * <CwButton variant="icon" icon="edit" title="Edit item" />
  * <CwButton icon="star" text="Favorite" color="primary" />
+ * <CwButton text="Next" icon="chevron-right" iconPosition="right" />
+ * <CwButton text="Export" icon="download" variant="ghost" />
+ * <CwButton variant="icon" icon="pin" pressed={isPinned} onClick={togglePinned} title="Pin" />
  * <CwButton className="custom-class">Custom content</CwButton>
  */
+import React from "react";
 export interface CwButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     text?: string;
-    variant?: 'solid' | 'outline' | 'icon';
+    variant?: 'solid' | 'outline' | 'icon' | 'ghost';
     color?: 'primary' | 'danger' | 'neutral';
+    size?: 'small' | 'medium' | 'large';
+    iconPosition?: 'left' | 'right';
+    pressed?: boolean;
     icon?: string;
     tooltipPosition?: 'top' | 'bottom' | 'left' | 'right';
-    ref?: React.LegacyRef<HTMLButtonElement>;
 }
-export declare function CwButton({ text, variant, color, className, icon, title, tooltipPosition, children, ...buttonProps }: CwButtonProps): import("react").JSX.Element;
+export declare const CwButton: React.ForwardRefExoticComponent<CwButtonProps & React.RefAttributes<HTMLButtonElement>>;
 //# sourceMappingURL=CwButton.d.ts.map

package/dist/src/components/control/action/button/CwButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CwButton.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/action/button/CwButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;IACtD,GAAG,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;CACzC;AAED,wBAAgB,QAAQ,CAAC,EACxB,IAAI,EACJ,OAAiB,EACjB,KAAiB,EACjB,SAAc,EACd,IAAS,EACT,KAAK,EACL,eAA0B,EAC1B,QAAQ,EACR,GAAG,WAAW,EACd,EAAE,aAAa,+BA6Cf"}
+{"version":3,"file":"CwButton.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/action/button/CwButton.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,WAAW,aAAc,SAAQ,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IACjD,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;CACtD;AAED,eAAO,MAAM,QAAQ,yFAoEnB,CAAC"}

package/dist/src/components/control/action/button/CwButtonSplit.d.ts

@@ -0,0 +1,52 @@
+import React from "react";
+export interface CwButtonSplitAction {
+    key: string;
+    label: string;
+    /** cwi icon name (verified against NewCwIcons.json) */
+    icon?: string;
+    disabled?: boolean;
+}
+export interface CwButtonSplitProps {
+    /** Main action label */
+    text: string;
+    /** Optional main-action icon */
+    icon?: string;
+    /** Default/main action */
+    onClick: () => void;
+    /** Alternative actions shown in the dropdown menu */
+    actions: CwButtonSplitAction[];
+    /** Fired when a menu item is chosen */
+    onSelect: (key: string) => void;
+    /** Shared visual style for both parts. @default 'solid' */
+    variant?: "solid" | "outline";
+    /** Shared color theme for both parts. @default 'primary' */
+    color?: "primary" | "danger" | "neutral";
+    /** Shared size for both parts. @default 'medium' */
+    size?: "small" | "medium" | "large";
+    /** Disables both parts */
+    disabled?: boolean;
+    /** Menu alignment relative to the control. @default 'bottom-end' */
+    placement?: "bottom-start" | "bottom-end";
+    "data-testid"?: string;
+}
+/**
+ * CwButtonSplit - A primary action joined to a dropdown of alternative actions.
+ *
+ * Composes a main {@link CwButton} with a {@link CwPopoverButton} chevron whose
+ * panel holds a vertical menu of alternatives (rendered as `variant="ghost"` rows).
+ * Both parts share variant, color and size and read as one joined control.
+ *
+ * @example
+ * <CwButtonSplit
+ *     text="Save"
+ *     icon="save"
+ *     onClick={handleSave}
+ *     actions={[
+ *         { key: "saveAs", label: "Save as…", icon: "copy" },
+ *         { key: "saveAndClose", label: "Save and close" },
+ *     ]}
+ *     onSelect={handleSelect}
+ * />
+ */
+export declare function CwButtonSplit({ text, icon, onClick, actions, onSelect, variant, color, size, disabled, placement, "data-testid": dataTestId, }: CwButtonSplitProps): React.JSX.Element;
+//# sourceMappingURL=CwButtonSplit.d.ts.map

package/dist/src/components/control/action/button/CwButtonSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CwButtonSplit.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/action/button/CwButtonSplit.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAK1B,MAAM,WAAW,mBAAmB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IAClC,wBAAwB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0BAA0B;IAC1B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,qDAAqD;IACrD,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,uCAAuC;IACvC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,4DAA4D;IAC5D,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,oDAAoD;IACpD,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oEAAoE;IACpE,SAAS,CAAC,EAAE,cAAc,GAAG,YAAY,CAAC;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,EAC7B,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,EACP,QAAQ,EACR,OAAiB,EACjB,KAAiB,EACjB,IAAe,EACf,QAAgB,EAChB,SAAwB,EACxB,aAAa,EAAE,UAAU,GACzB,EAAE,kBAAkB,qBA6CpB"}

package/dist/src/components/control/action/button/CwButtonSwitch.d.ts

@@ -0,0 +1,65 @@
+export interface CwButtonSwitchOption {
+    /** Value sent to onChange */
+    value: string;
+    /** Text displayed on the segment */
+    label: string;
+    /** Optional cwi icon name */
+    icon?: string;
+    /** Disables this specific segment */
+    disabled?: boolean;
+}
+export interface CwButtonSwitchProps {
+    /** Options rendered as joined segments */
+    options: CwButtonSwitchOption[];
+    /** Currently selected value */
+    value: string;
+    /** Callback when the selection changes */
+    onChange: (value: string) => void;
+    /** Segment size */
+    size?: "small" | "medium" | "large";
+    /** Shared color theme for every segment */
+    color?: "primary" | "danger" | "neutral";
+    /** Render only each option's icon (label becomes the tooltip + accessible name). Every option must have an `icon`. */
+    iconOnly?: boolean;
+    /**
+     * Orientation of the joined strip: "row" (default, horizontal) or "column" (vertical,
+     * stacked full-width segments). Only orientation is exposed because the segments are joined
+     * (no gap), so gap/align/justify are not meaningful.
+     */
+    direction?: "row" | "column";
+    /** Disables every segment */
+    disabled?: boolean;
+    /** Accessible name for the radiogroup (there is no visible label on this inline control). */
+    "aria-label"?: string;
+    /** Accessible name for the radiogroup (there is no visible label on this inline control). */
+    "aria-labelledby"?: string;
+    "data-testid"?: string;
+}
+/**
+ * CwButtonSwitch - Segmented single-select control: a strip of joined CwButtons.
+ *
+ * The selected segment renders `solid`, the others `outline`, both sharing the `color`
+ * theme (`primary` default, `danger`, or `neutral`). It is a proper ARIA radiogroup with
+ * roving tabindex (one tab stop) and arrow-key navigation, provided by
+ * {@link useRovingSingleSelect}. Use for 2–3 mutually-exclusive options that benefit from
+ * being shown side by side; for a longer list use CwRadioGroup.
+ *
+ * `direction="column"` renders the strip vertically (stacked, full-width segments) instead of
+ * the default horizontal `row`; arrow-key navigation handles both orientations.
+ *
+ * Set `iconOnly` to render just each option's icon; the option's `label` is still required
+ * and is passed as the segment title, so it becomes the tooltip and the accessible name.
+ *
+ * It is an inline control with no form label — if a caption is needed, place it next to the
+ * control at the call site, and pass `aria-label` (or `aria-labelledby`) to name the radiogroup
+ * for screen readers.
+ *
+ * @example
+ * <CwButtonSwitch
+ *     options={[{ value: "list", label: "List", icon: "list" }, { value: "grid", label: "Grid", icon: "grid" }]}
+ *     value={view}
+ *     onChange={setView}
+ * />
+ */
+export declare function CwButtonSwitch({ options, value, onChange, size, color, iconOnly, direction, disabled, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "data-testid": dataTestId, }: CwButtonSwitchProps): import("react").JSX.Element;
+//# sourceMappingURL=CwButtonSwitch.d.ts.map

package/dist/src/components/control/action/button/CwButtonSwitch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CwButtonSwitch.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/action/button/CwButtonSwitch.tsx"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACpC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IACnC,0CAA0C;IAC1C,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,mBAAmB;IACnB,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,sHAAsH;IACtH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,EAC9B,OAAO,EACP,KAAK,EACL,QAAQ,EACR,IAAe,EACf,KAAiB,EACjB,QAAgB,EAChB,SAAiB,EACjB,QAAgB,EAChB,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,aAAa,EAAE,UAAU,GACzB,EAAE,mBAAmB,+BAqCrB"}

package/dist/src/components/control/action/search/CwSearch.d.ts

@@ -25,6 +25,8 @@ export interface CwSearchInputProps extends HTMLProps<HTMLDivElement> {
     error?: boolean;
     /** Custom renderer for each suggestion item. Receives the matching `CwSelectList` entry. */
     renderOption?: (option: CwSelectList) => React.ReactNode;
+    /** Focuses the internal `<input>` on mount when `true`. */
+    autoFocus?: boolean;
 }
 /**
  * Text input with a live-filtered suggestion dropdown backed by a local `CwSelectList` array.

package/dist/src/components/control/action/search/CwSearch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CwSearch.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/action/search/CwSearch.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA+B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAIvE,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,EAAW,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAW,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAEpF,uCAAuC;AACvC,MAAM,WAAW,kBAAmB,SAAQ,SAAS,CAAC,cAAc,CAAC;IACpE,oFAAoF;IACpF,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,iDAAiD;IACjD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,oDAAoD;IACpD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,uDAAuD;IACvD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACpC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;CACzD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,qBAuKtF"}
+{"version":3,"file":"CwSearch.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/action/search/CwSearch.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAsC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAClF,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAIvE,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAC/F,OAAO,EAAW,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAW,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAGpF,uCAAuC;AACvC,MAAM,WAAW,kBAAmB,SAAQ,SAAS,CAAC,cAAc,CAAC;IACpE,oFAAoF;IACpF,UAAU,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;IAChC,iDAAiD;IACjD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,oDAAoD;IACpD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,uDAAuD;IACvD,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,gEAAgE;IAChE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IACpC,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,KAAK,CAAC,SAAS,CAAC;IACzD,2DAA2D;IAC3D,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,qBAuNtF"}

package/dist/src/components/control/action/search/searchKeyboardNavigation.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Pure keyboard-navigation resolver shared by the `CwSearchInput` combobox.
+ * Kept side-effect-free so the arrow/home/end/enter/escape behaviour can be unit
+ * tested without a DOM (the library's vitest runs with `environment: "node"`).
+ */
+/** Action the combobox should perform in response to a key press. */
+export type SearchKeyAction = 
+/** Move the highlight to `index` (arrow / home / end). */
+{
+    type: "move";
+    index: number;
+}
+/** Commit the option at `index` (Enter on a highlighted row). */
+ | {
+    type: "select";
+    index: number;
+}
+/** Close the dropdown and reset the highlight (Escape). */
+ | {
+    type: "close";
+}
+/** Key is not handled — let it propagate untouched. */
+ | {
+    type: "none";
+};
+/**
+ * Resolves a key press against the current highlight into a {@link SearchKeyAction}.
+ * Arrow navigation wraps around; `Enter` selects only when a valid row is highlighted.
+ *
+ * @param key            `KeyboardEvent.key` value.
+ * @param currentIndex   Currently highlighted option index (`-1` = none).
+ * @param optionsLength  Number of options currently in the dropdown.
+ */
+export declare function resolveSearchKeyAction(key: string, currentIndex: number, optionsLength: number): SearchKeyAction;
+//# sourceMappingURL=searchKeyboardNavigation.d.ts.map

package/dist/src/components/control/action/search/searchKeyboardNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchKeyboardNavigation.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/action/search/searchKeyboardNavigation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qEAAqE;AACrE,MAAM,MAAM,eAAe;AAC1B,0DAA0D;AACxD;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACjC,iEAAiE;GAC/D;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AACnC,2DAA2D;GACzD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE;AACnB,uDAAuD;GACrD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpB;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACrC,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,GACnB,eAAe,CAqBjB"}

package/dist/src/components/control/choice/checkbox/CwCheck.d.ts

@@ -1,14 +1,15 @@
 import React from "react";
-import { CwIconProps } from "../../../../components/display/graphics/icon/CwIcon";
 import { CwLabelProps } from "../../../../components/display/text/label/CwLabel";
 export interface CwCheckProps extends Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "type"> {
     /** Props for the label component */
     labelProps?: CwLabelProps;
-    /** Text content for the checkbox label */
+    /** Text content for the checkbox label
+     * @deprecated Use `labelProps.text` instead. */
     labelText?: string;
-    /** Props for the icon component - iconId is required */
-    iconProps?: CwIconProps;
-    /** Layout alignment: "row" (side by side) | "column" (label above) @default "row" */
+    /** Layout of the input relative to its label: "row" (side by side, default) | "column" (label below) */
+    direction?: "row" | "column";
+    /** Layout alignment: "row" (side by side) | "column" (label below) @default "row"
+     * @deprecated Use `direction` instead. */
     alignment?: "row" | "column";
 }
 export declare function CwCheck(props: CwCheckProps): React.JSX.Element;

package/dist/src/components/control/choice/checkbox/CwCheck.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CwCheck.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/checkbox/CwCheck.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAU,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAGjF,MAAM,WAAW,YAChB,SAAQ,IAAI,CACX,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,EACtF,MAAM,CACN;IACD,oCAAoC;IACpC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,qFAAqF;IACrF,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,qBA4B1C"}
+{"version":3,"file":"CwCheck.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/checkbox/CwCheck.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAGjF,MAAM,WAAW,YAChB,SAAQ,IAAI,CACX,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,EACtF,MAAM,CACN;IACD,oCAAoC;IACpC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B;oDACgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wGAAwG;IACxG,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC7B;8CAC0C;IAC1C,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,qBA6B1C"}

package/dist/src/components/control/choice/checkbox/CwCheckboxGroup.d.ts

@@ -1,6 +1,7 @@
 import type { CwInputFeedback } from "../../../../common/interfaces/CwFormTypes";
+import type { CwGroupLayoutProps } from "../../../../common/interfaces/CwLayoutProps";
 import { CwLabelProps } from "../../../../components/display/text/label/CwLabel";
-import { CwAlignProps } from "../../../../components/layout/align/CwAlign";
+import type { CwAlignProps } from "../../../../components/layout/align/CwAlign";
 export interface CheckboxOption {
     /** Value sent to onChange */
     value: string;
@@ -9,7 +10,17 @@ export interface CheckboxOption {
     /** Disables this specific option */
     disabled?: boolean;
 }
-export interface CwCheckboxGroupProps {
+/**
+ * Extends the shared {@link CwGroupLayoutProps} (`groupLayout` + `itemLayout`), the same layout
+ * interface {@link CwRadioGroup} and {@link CwKeyValueList} use:
+ * - `groupLayout` — label vs group block. `direction: "row"` (default, kept for backward
+ *   compatibility) = label beside the options; `"column"` = label above. Honors `align`/`gap`.
+ * - `itemLayout` — flow of the checkbox options. `direction: "column"` (default) = stacked;
+ *   `"row"` = inline with wrap. Honors `gap`. It also drives each checkbox's own box-to-text
+ *   layout to the OPPOSITE axis: stacked items get the box beside the text, side-by-side items
+ *   get the box above the text.
+ */
+export interface CwCheckboxGroupProps extends CwGroupLayoutProps {
     /** List of options to display */
     options: CheckboxOption[];
     /** Currently selected values */
@@ -18,18 +29,30 @@ export interface CwCheckboxGroupProps {
     onChange: (selected: string[]) => void;
     /** Props for the label component */
     labelProps?: CwLabelProps;
-    /** Props for alignment */
-    alignProps?: CwAlignProps;
     /** Marks the group as required */
     required?: boolean;
     /** Disables all options */
     disabled?: boolean;
-    /** Layout alignment of each individual checkbox: "row" (default) | "column" */
-    optionsAlignment?: "row" | "column";
     /** Additional CSS class for the container */
     className?: string;
     /** Error or info messages below the group */
     feedback?: CwInputFeedback | CwInputFeedback[];
+    /** Props for alignment
+     * @deprecated Use `groupLayout` instead. */
+    alignProps?: CwAlignProps;
+    /** Layout alignment of each individual checkbox: "row" (default) | "column"
+     * @deprecated Use `itemLayout` instead. */
+    optionsAlignment?: "row" | "column";
+    "data-testid"?: string;
 }
-export declare function CwCheckboxGroup({ options, value, onChange, labelProps, alignProps, required, disabled, optionsAlignment, className, feedback, }: CwCheckboxGroupProps): import("react").JSX.Element;
+/**
+ * CwCheckboxGroup - Multi-select group of native checkbox inputs.
+ *
+ * Use for selecting any number of values from a list of options. Layout follows the
+ * CwKeyValueList / CwRadioGroup convention with two nested {@link CwLayoutProps} axes applied as
+ * `data-*` attributes: `groupLayout` positions the label relative to the group block (root grid),
+ * `itemLayout` controls how the checkboxes flow among themselves (options container) and, on the
+ * opposite axis, each checkbox's own box-to-text layout.
+ */
+export declare function CwCheckboxGroup({ options, value, onChange, labelProps, groupLayout, itemLayout, required, disabled, className, feedback, alignProps, optionsAlignment, "data-testid": dataTestId, }: CwCheckboxGroupProps): import("react").JSX.Element;
 //# sourceMappingURL=CwCheckboxGroup.d.ts.map

package/dist/src/components/control/choice/checkbox/CwCheckboxGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CwCheckboxGroup.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/checkbox/CwCheckboxGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAW,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,EAAW,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAIpF,MAAM,WAAW,cAAc;IAC9B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACpC,iCAAiC;IACjC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACvC,oCAAoC;IACpC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,0BAA0B;IAC1B,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACpC,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;CAC/C;AAED,wBAAgB,eAAe,CAAC,EAC/B,OAAO,EACP,KAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,gBAAwB,EACxB,SAAS,EACT,QAAQ,GACR,EAAE,oBAAoB,+BA+CtB"}
+{"version":3,"file":"CwCheckboxGroup.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/checkbox/CwCheckboxGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAW,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAC1F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAIhF,MAAM,WAAW,cAAc;IAC9B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAqB,SAAQ,kBAAkB;IAC/D,iCAAiC;IACjC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,8EAA8E;IAC9E,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACvC,oCAAoC;IACpC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAC/C;gDAC4C;IAC5C,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B;+CAC2C;IAC3C,gBAAgB,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAC/B,OAAO,EACP,KAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,aAAa,EAAE,UAAU,GACzB,EAAE,oBAAoB,+BAyEtB"}

package/dist/src/components/control/choice/checkbox/CwRadio.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+export interface CwRadioProps extends Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "type"> {
+    /** Text content for the radio label */
+    label?: string;
+    /** Layout of the input relative to its text: "row" (side by side, default) | "column" (text below) */
+    direction?: "row" | "column";
+}
+/** Single native radio input. Building block for CwRadioGroup. */
+export declare function CwRadio({ label, direction, className, ...inputProps }: CwRadioProps): React.JSX.Element;
+//# sourceMappingURL=CwRadio.d.ts.map

package/dist/src/components/control/choice/checkbox/CwRadio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CwRadio.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/checkbox/CwRadio.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,YAChB,SAAQ,IAAI,CACX,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,EACtF,MAAM,CACN;IACD,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sGAAsG;IACtG,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC7B;AAED,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,EAAE,KAAK,EAAE,SAAiB,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,EAAE,YAAY,qBAO3F"}

package/dist/src/components/control/choice/checkbox/CwRadioGroup.d.ts

@@ -0,0 +1,58 @@
+import type { CwInputFeedback } from "../../../../common/interfaces/CwFormTypes";
+import type { CwGroupLayoutProps } from "../../../../common/interfaces/CwLayoutProps";
+import { CwLabelProps } from "../../../../components/display/text/label/CwLabel";
+export interface RadioOption {
+    /** Value sent to onChange */
+    value: string;
+    /** Text displayed next to the radio */
+    label: string;
+    /** Disables this specific option */
+    disabled?: boolean;
+}
+/**
+ * Extends the shared {@link CwGroupLayoutProps} (`groupLayout` + `itemLayout`), the same layout
+ * interface {@link CwKeyValueList} uses:
+ * - `groupLayout` — label vs radiogroup block. `direction: "column"` (default) = label above;
+ *   `"row"` = label beside the options. Honors `align`/`gap`.
+ * - `itemLayout` — flow of the radio options. `direction: "column"` (default) = stacked;
+ *   `"row"` = inline with wrap. Honors `gap`. It also drives each radio's own circle-to-text
+ *   layout to the OPPOSITE axis: stacked items get the circle beside the text, side-by-side
+ *   items get the circle above the text.
+ */
+export interface CwRadioGroupProps extends CwGroupLayoutProps {
+    /** List of options to display */
+    options: RadioOption[];
+    /** Currently selected value */
+    value?: string;
+    /** Callback when the selection changes - returns the selected value */
+    onChange: (value: string) => void;
+    /** Props for the label component */
+    labelProps?: CwLabelProps;
+    /** Marks the group as required */
+    required?: boolean;
+    /** Disables all options */
+    disabled?: boolean;
+    /** Additional CSS class for the container */
+    className?: string;
+    /** Error or info messages below the group */
+    feedback?: CwInputFeedback | CwInputFeedback[];
+    /** Accessible name for the radiogroup when no visible `labelProps` label is rendered (a11y fallback). */
+    "aria-label"?: string;
+    /** Accessible name for the radiogroup when no visible `labelProps` label is rendered (a11y fallback). */
+    "aria-labelledby"?: string;
+    "data-testid"?: string;
+}
+/**
+ * CwRadioGroup - Single-select group of native radio inputs.
+ *
+ * Built on `<input type="radio">` sharing one `name`, so the browser provides radio-group
+ * semantics (roving tabindex, arrow-key navigation) natively. Use for a single choice from a
+ * list of options; for 2–3 options shown as a strip use CwButtonSwitch.
+ *
+ * Layout follows the CwKeyValueList convention with two nested {@link CwLayoutProps} axes
+ * applied as `data-*` attributes: `groupLayout` positions the label relative to the radiogroup
+ * block (root grid), `itemLayout` controls how the radios flow among themselves (options
+ * container) and, on the opposite axis, each radio's own circle-to-text layout.
+ */
+export declare function CwRadioGroup({ options, value, onChange, labelProps, groupLayout, itemLayout, required, disabled, className, feedback, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, "data-testid": dataTestId, }: CwRadioGroupProps): import("react").JSX.Element;
+//# sourceMappingURL=CwRadioGroup.d.ts.map

package/dist/src/components/control/choice/checkbox/CwRadioGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CwRadioGroup.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/checkbox/CwRadioGroup.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACtF,OAAO,EAAW,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAI1F,MAAM,WAAW,WAAW;IAC3B,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,iBAAkB,SAAQ,kBAAkB;IAC5D,iCAAiC;IACjC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,oCAAoC;IACpC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,eAAe,GAAG,eAAe,EAAE,CAAC;IAC/C,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yGAAyG;IACzG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,EAC5B,OAAO,EACP,KAAK,EACL,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,aAAa,EAAE,UAAU,GACzB,EAAE,iBAAiB,+BA2DnB"}

package/dist/src/components/control/choice/nav-menu/CwNavMenu.d.ts

@@ -0,0 +1,78 @@
+import { HTMLAttributes, ReactNode } from "react";
+export interface CwNavItem {
+    /** Stable id, also the React key */
+    id: string;
+    /** Resolved display text — the consumer owns i18n / tenant naming */
+    label: string;
+    /** Link target for leaves; groups may omit it */
+    href?: string;
+    /** Resolved secondary text — not rendered by the menu, but searched alongside label and href */
+    description?: string;
+    /** CW icon name */
+    icon?: string;
+    /** Non-empty children make this item a collapsible group */
+    children?: CwNavItem[];
+}
+/** Remaining props land on the <nav> — `data-*` (CBT walkthrough targets), `aria-*`, `data-testid`. */
+export interface CwNavMenuProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    /** Already permission-filtered and ordered by the consumer */
+    items: CwNavItem[];
+    /** Renders placeholder rows instead of the tree */
+    loading?: boolean;
+    /**
+     * Router-agnostic active detection; nothing is highlighted when omitted. Injected because the
+     * library cannot depend on a router (WinOps: react-router-dom 6.28, Improve: a different one,
+     * playground: none) — the consumer answers "is this the current page?", the component owns the
+     * highlight. Revisitable: if the apps ever converge on one router, this could move inside.
+     */
+    isActive?: (item: CwNavItem) => boolean;
+    /** Inject a router link component; defaults to a plain <a href> */
+    renderLink?: (item: CwNavItem, children: ReactNode) => ReactNode;
+    /**
+     * Show a trailing chevron on **top-level** group rows. Nested groups (level 2+) always show it
+     * and ignore this flag — don't normalise the two cases: a level-1 group is already marked by
+     * its heavier type and [open] background, while a nested group is otherwise indistinguishable
+     * from its sibling leaf links.
+     */
+    showExpandIndicator?: boolean;
+    /**
+     * Filters the tree through `filterNavItems`: a group survives when it or any descendant matches.
+     * Quoted `"phrases"` match the label; loose words match label + description + href. Blank or
+     * omitted means no filtering.
+     */
+    search?: string;
+    /** Shown only while a search is active and nothing matched — an empty `items` still renders nothing */
+    emptyMessage?: string;
+    /**
+     * Sorts the **top level** alphabetically; nested lists keep the consumer's order. Off by default.
+     * Level-1-only is deliberate: a long list of modules is hard to scan, while the pages inside one
+     * are ordered on purpose.
+     */
+    sortAlphabetically?: boolean;
+    /**
+     * Rows for the sticky favourites section above the tree. Omit it and no section renders. The
+     * library owns the disclosure and its look; the rows are yours, so their markup, secondary text
+     * and any `data-*` stay under your control.
+     */
+    favoritesSlot?: ReactNode;
+    /** Header for the favourites section. Pass your own translation. */
+    favoritesLabel?: string;
+    /** Attributes for the favourites `<details>` — `data-tour`, or `open` to override the default. */
+    favoritesProps?: HTMLAttributes<HTMLDetailsElement>;
+    /**
+     * Marks a leaf as favourited with a star. Indicator only — toggling stays with the consumer
+     * (a context menu on the link, for instance), so no row gains a control it didn't have.
+     */
+    isFavorite?: (item: CwNavItem) => boolean;
+    /**
+     * An app-provided section between the favourites and the tree — WinOps's external "Places" links,
+     * for instance. Kept out of `items` on purpose: it is a parallel list, so it is not filtered by
+     * `search` or reordered by `sortAlphabetically`.
+     *
+     * A `<details>` placed here is styled as a top-level section automatically.
+     */
+    beforeTreeSlot?: ReactNode;
+}
+/** Sizes only its own icons — content injected via `renderLink` is styled by the consumer. */
+export declare function CwNavMenu({ items, loading, isActive, renderLink, showExpandIndicator, search, emptyMessage, sortAlphabetically, favoritesSlot, favoritesLabel, favoritesProps, isFavorite, beforeTreeSlot, className, ...navProps }: CwNavMenuProps): import("react").JSX.Element;
+//# sourceMappingURL=CwNavMenu.d.ts.map

package/dist/src/components/control/choice/nav-menu/CwNavMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CwNavMenu.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/nav-menu/CwNavMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMlD,MAAM,WAAW,SAAS;IACzB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,uGAAuG;AACvG,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,UAAU,CAAC;IACpF,8DAA8D;IAC9D,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC;IACxC,mEAAmE;IACnE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,KAAK,SAAS,CAAC;IACjE;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uGAAuG;IACvG,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;;;OAIG;IACH,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,oEAAoE;IACpE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kGAAkG;IAClG,cAAc,CAAC,EAAE,cAAc,CAAC,kBAAkB,CAAC,CAAC;IACpD;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC;IAC1C;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,SAAS,CAAC;CAC3B;AAQD,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,EACzB,KAAK,EACL,OAAe,EACf,QAAQ,EACR,UAA8B,EAC9B,mBAA2B,EAC3B,MAAM,EACN,YAAY,EACZ,kBAA0B,EAC1B,aAAa,EACb,cAA4B,EAC5B,cAAc,EACd,UAAU,EACV,cAAc,EACd,SAAS,EACT,GAAG,QAAQ,EACX,EAAE,cAAc,+BAmEhB"}

package/dist/src/components/control/choice/nav-menu/filterNavItems.d.ts

@@ -0,0 +1,9 @@
+import { CwNavItem } from "./CwNavMenu";
+/**
+ * Filters a nav tree by a search string, keeping a group whose descendants match.
+ *
+ * Supports `"quoted phrases"` (must appear in the label) alongside loose words (any field) — this is
+ * behaviour users are told about, so don't simplify it.
+ */
+export declare function filterNavItems(items: CwNavItem[], search?: string): CwNavItem[];
+//# sourceMappingURL=filterNavItems.d.ts.map

package/dist/src/components/control/choice/nav-menu/filterNavItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterNavItems.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/nav-menu/filterNavItems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoBxC;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,EAAE,CAmC/E"}

package/dist/src/components/control/choice/nav-menu/sortNavItems.d.ts

@@ -0,0 +1,9 @@
+import { CwNavItem } from "./CwNavMenu";
+/**
+ * Sorts the top level alphabetically, leaving every nested list in the order the consumer gave.
+ *
+ * Deliberately level 1 only: this exists because a long list of modules is hard to scan, while the
+ * pages inside a module are ordered on purpose. Returns the input untouched when not sorting.
+ */
+export declare function sortNavItems(items: CwNavItem[], alphabetically?: boolean): CwNavItem[];
+//# sourceMappingURL=sortNavItems.d.ts.map

package/dist/src/components/control/choice/nav-menu/sortNavItems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sortNavItems.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/nav-menu/sortNavItems.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,SAAS,EAAE,CAItF"}

package/dist/src/components/control/choice/toggle/CwToggle.d.ts

@@ -1,14 +1,15 @@
 import React from "react";
-import { CwIconProps } from "../../../../components/display/graphics/icon/CwIcon";
 import { CwLabelProps } from "../../../../components/display/text/label/CwLabel";
 export interface CwToggleProps extends Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "type"> {
     /** Props for the label component */
     labelProps?: CwLabelProps;
-    /** Text content for the toggle label */
+    /** Text content for the toggle label
+     * @deprecated Use `labelProps.text` instead. */
     labelText?: string;
-    /** Props for the icon component - iconId is required */
-    iconProps?: CwIconProps;
-    /** Layout alignment: "row" (side by side) | "column" (label above) @default "row" */
+    /** Layout of the input relative to its label: "row" (side by side, default) | "column" (label above) */
+    direction?: "row" | "column";
+    /** Layout alignment: "row" (side by side) | "column" (label above) @default "row"
+     * @deprecated Use `direction` instead. */
     alignment?: "row" | "column";
 }
 export declare function CwToggle(props: CwToggleProps): React.JSX.Element;

package/dist/src/components/control/choice/toggle/CwToggle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CwToggle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/toggle/CwToggle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAU,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAEjF,MAAM,WAAW,aAChB,SAAQ,IAAI,CACX,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,EACtF,MAAM,CACN;IAED,oCAAoC;IACpC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,wCAAwC;IACxC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,qFAAqF;IACrF,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAE7B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,qBA+B5C"}
+{"version":3,"file":"CwToggle.d.ts","sourceRoot":"","sources":["../../../../../../src/components/control/choice/toggle/CwToggle.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,mDAAmD,CAAC;AAEjF,MAAM,WAAW,aAChB,SAAQ,IAAI,CACX,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,mBAAmB,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC,EACtF,MAAM,CACN;IAED,oCAAoC;IACpC,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B;oDACgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wGAAwG;IACxG,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC7B;8CAC0C;IAC1C,SAAS,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAE7B;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,qBA+B5C"}