@12-apps/ui 5.0.0 → 5.0.1

package/dist/types/components/form/CategorySelect/CategorySelect.d.ts

@@ -0,0 +1,21 @@
+import type { CategorySelectProps } from './CategorySelect.types';
+/**
+ * A hierarchical category picker: categories as the frame, subcategories as the
+ * thing you choose.
+ *
+ * Two modes off one component. `multi` is the FILTER — ticks accumulate in a
+ * draft and reach `onChange` only on Apply, so the list behind the panel does not
+ * reload on every click. `single` is the "move to…" picker, where choosing a row
+ * commits immediately because there is nothing to batch.
+ *
+ * The tree opens fully expanded: nothing a search could match is hidden behind a
+ * disclosure. Selected categories pin above the list so they survive scrolling
+ * and searching, search is accent-insensitive (`agua` finds `Águas`), and the
+ * whole tree is keyboard-drivable — ↑↓ to move, → to open, ← to close, Space to
+ * mark, Enter to apply, Esc to cancel.
+ *
+ * Under {@link METRICS.sheetBreakpoint} the panel becomes a bottom sheet, which
+ * is the only way a 290px-tall list stays usable one-handed.
+ */
+export declare function CategorySelect(props: CategorySelectProps): React.JSX.Element;
+//# sourceMappingURL=CategorySelect.d.ts.map

package/dist/types/components/form/CategorySelect/CategorySelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategorySelect.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategorySelect.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAiB,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AA2EjF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+E5E"}

package/dist/types/components/form/CategorySelect/CategorySelect.styles.d.ts

@@ -0,0 +1,68 @@
+import { type CSSObject, type Theme } from '@mui/material';
+/**
+ * The prototype's METRICS, verbatim.
+ *
+ * Every number here is lifted from the approved design and is intentionally
+ * absolute rather than derived from `theme.spacing`: the design is specified on
+ * a half-pixel type scale (13.5px rows, 1.5px checkbox borders) that an 8px
+ * spacing grid cannot express without rounding the look away.
+ *
+ * COLOURS are the deliberate exception — they come from the theme, because a
+ * tenant can white-label the palette (a hard-coded indigo would survive the
+ * rebrand and the rest of the screen would not) and because the library ships a
+ * dark mode. On the default light indigo theme the tokens below resolve to the
+ * prototype's own values.
+ */
+export declare const METRICS: {
+    readonly triggerHeight: 38;
+    readonly triggerRadius: 10;
+    readonly panelWidth: 340;
+    readonly panelRadius: 14;
+    readonly listMaxHeight: 290;
+    readonly sheetListMaxHeight: 340;
+    readonly rowHeight: 36;
+    readonly sheetRowHeight: 42;
+    readonly rowRadius: 8;
+    readonly boxSize: 18;
+    readonly chevronButton: 22;
+    readonly footerButton: 32;
+    readonly sheetFooterButton: 38;
+    /** Below this width the panel becomes a bottom sheet. */
+    readonly sheetBreakpoint: 480;
+};
+/** The closed control. `selected` swaps it to the accent-tinted "has filter" skin. */
+export declare const triggerSx: (theme: Theme, selected: boolean, open: boolean) => CSSObject;
+/** The count pill inside the trigger. */
+export declare const triggerCountSx: (theme: Theme) => CSSObject;
+/** The trigger's inline clear (×) and the chevron. */
+export declare const triggerClearSx: CSSObject;
+export declare const triggerChevronSx: (open: boolean) => CSSObject;
+/** The floating panel. */
+export declare const panelSx: (theme: Theme) => CSSObject;
+/** Bottom-sheet skin, applied under {@link METRICS.sheetBreakpoint}. */
+export declare const sheetSx: (theme: Theme) => CSSObject;
+export declare const panelHeadSx: (theme: Theme, sheet: boolean) => CSSObject;
+export declare const pinnedSx: (theme: Theme) => CSSObject;
+export declare const pinnedLabelSx: (theme: Theme) => CSSObject;
+export declare const chipWrapSx: CSSObject;
+/** A selected-category chip, in the pinned tray and the applied bar alike. */
+export declare const chipSx: (theme: Theme) => CSSObject;
+export declare const listSx: (sheet: boolean) => CSSObject;
+/** A row. `active` is the KEYBOARD cursor — deliberately distinct from hover. */
+export declare const rowSx: (theme: Theme, active: boolean, sheet: boolean) => CSSObject;
+export declare const rowNameSx: (theme: Theme, isCategory: boolean) => CSSObject;
+export declare const rowMetaSx: (theme: Theme, selected: boolean) => CSSObject;
+/** The query hit inside a row label. */
+export declare const markSx: CSSObject;
+export declare const chevronButtonSx: (theme: Theme, open: boolean) => CSSObject;
+/** The tri-state checkbox: unchecked, checked, or the partial bar. */
+export declare const checkboxSx: (theme: Theme, state: "off" | "partial" | "on") => CSSObject;
+/** The partial bar drawn inside a half-selected checkbox. */
+export declare const checkboxBarSx: (theme: Theme) => CSSObject;
+export declare const radioSx: (theme: Theme, on: boolean) => CSSObject;
+export declare const sectionHeadSx: (theme: Theme) => CSSObject;
+export declare const footerSx: (theme: Theme) => CSSObject;
+export declare const emptySx: (theme: Theme) => CSSObject;
+/** Skeleton row used while the catalogue loads. */
+export declare const skeletonSx: CSSObject;
+//# sourceMappingURL=CategorySelect.styles.d.ts.map

package/dist/types/components/form/CategorySelect/CategorySelect.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategorySelect.styles.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategorySelect.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;IAclB,yDAAyD;;CAEjD,CAAC;AAWX,sFAAsF;AACtF,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,UAAU,OAAO,EAAE,MAAM,OAAO,KAAG,SA0B1E,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,cAAc,GAAI,OAAO,KAAK,KAAG,SAU5C,CAAC;AAEH,sDAAsD;AACtD,eAAO,MAAM,cAAc,EAAE,SAc5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,MAAM,OAAO,KAAG,SAO/C,CAAC;AAEH,0BAA0B;AAC1B,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAUrC,CAAC;AAEH,wEAAwE;AACxE,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAkBrC,CAAC;AAEH,eAAO,MAAM,WAAW,GAAI,OAAO,KAAK,EAAE,OAAO,OAAO,KAAG,SAGzD,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,KAAG,SAItC,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAQ3C,CAAC;AAEH,eAAO,MAAM,UAAU,EAAE,SAMxB,CAAC;AAEF,8EAA8E;AAC9E,eAAO,MAAM,MAAM,GAAI,OAAO,KAAK,KAAG,SA6BrC,CAAC;AAEF,eAAO,MAAM,MAAM,GAAI,OAAO,OAAO,KAAG,SAMtC,CAAC;AAEH,iFAAiF;AACjF,eAAO,MAAM,KAAK,GAAI,OAAO,KAAK,EAAE,QAAQ,OAAO,EAAE,OAAO,OAAO,KAAG,SAsBpE,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,YAAY,OAAO,KAAG,SAS5D,CAAC;AAEH,eAAO,MAAM,SAAS,GAAI,OAAO,KAAK,EAAE,UAAU,OAAO,KAAG,SAK1D,CAAC;AAEH,wCAAwC;AACxC,eAAO,MAAM,MAAM,EAAE,SAKpB,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,KAAK,EAAE,MAAM,OAAO,KAAG,SAc5D,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,UAAU,GAAI,OAAO,KAAK,EAAE,OAAO,KAAK,GAAG,SAAS,GAAG,IAAI,KAAG,SAWzE,CAAC;AAEH,6DAA6D;AAC7D,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAK3C,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,EAAE,IAAI,OAAO,KAAG,SAUlD,CAAC;AAEH,eAAO,MAAM,aAAa,GAAI,OAAO,KAAK,KAAG,SAQ3C,CAAC;AAEH,eAAO,MAAM,QAAQ,GAAI,OAAO,KAAK,KAAG,SAQtC,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,SAWrC,CAAC;AAEH,mDAAmD;AACnD,eAAO,MAAM,UAAU,EAAE,SAIxB,CAAC"}

package/dist/types/components/form/CategorySelect/CategorySelect.types.d.ts

@@ -0,0 +1,97 @@
+import type { SizeValue } from '../../../tokens/scales';
+/**
+ * One category as the caller already stores it: a FLAT row carrying its parent.
+ *
+ * Flat-with-`parentId` rather than a nested `children` array because that is the
+ * shape the API and the consuming admin lists already hold; nesting it at every
+ * call site would be work the component can do once, memoised, itself.
+ */
+export interface CategorySelectOption {
+    /** Stable identifier — what {@link CategorySelectProps.value} refers to. */
+    id: string;
+    /** The category's own name. Never pre-indented: the ROW draws the nesting. */
+    name: string;
+    /** Parent category id, or `null`/absent for a top-level category. */
+    parentId?: string | null;
+    /**
+     * Item count for this category, shown as a muted trailing number when
+     * {@link CategorySelectBaseProps.showCounts} is on.
+     */
+    count?: number;
+}
+/** A top-level category together with the subcategories nested under it. */
+export interface CategoryGroup {
+    category: CategorySelectOption;
+    subcategories: CategorySelectOption[];
+}
+/** One entry in the "selected" summary: a whole category, or a single leaf. */
+export interface CategorySelectionChip {
+    /** The id to remove when the chip's × is pressed. */
+    id: string;
+    /** Display label — the category name, or the subcategory name. */
+    label: string;
+    /** Set when the chip stands for EVERY subcategory of a category. */
+    whole: boolean;
+}
+/** Props shared by both selection modes. */
+export interface CategorySelectBaseProps {
+    /** The categories to choose from, flat, in display order. */
+    options: CategorySelectOption[];
+    /** Field label rendered above the trigger. */
+    label?: string;
+    /** Text on the trigger while nothing is selected. */
+    placeholder?: string;
+    /** Validation message; also flags the trigger as errored. */
+    error?: string;
+    /** Disables the trigger. */
+    disabled?: boolean;
+    /** Draws skeleton rows in place of the list (catalogue still loading). */
+    loading?: boolean;
+    /** Stretch to the container width (default: `false` — the trigger hugs). */
+    fullWidth?: boolean;
+    /** Control height, matching {@link Input}'s scale (default: `md`). */
+    size?: SizeValue;
+    /** Show each category's `count` as a trailing muted number (default: `false`). */
+    showCounts?: boolean;
+    /**
+     * Lets a top-level category be chosen in its own right. Off by default: the
+     * prototype's leaf-only default makes the category a HEADING and the
+     * subcategory the thing you pick, which is what removes the "did I select the
+     * parent or the group?" ambiguity.
+     */
+    allowParentSelection?: boolean;
+    /**
+     * Category creation, offered two ways when provided: as the empty-catalogue
+     * call to action, and as a `Criar "<termo>"` row when a search matches
+     * nothing — called with the typed text in that case.
+     *
+     * The second is what lets this replace a creatable combobox without losing
+     * create-as-you-type: an admin who searches for a category that does not
+     * exist yet is exactly the admin who wants to add it.
+     */
+    onCreateCategory?: (name?: string) => void;
+    /** Base test id; the trigger is `<dataTestId>-trigger`, the panel `-panel`. */
+    dataTestId?: string;
+}
+/**
+ * Multi-select mode: the filter. Edits accumulate in a DRAFT and only reach
+ * `onChange` when Apply is pressed, so the filtered list behind the panel does
+ * not reload on every tick.
+ */
+export interface CategoryMultiSelectProps extends CategorySelectBaseProps {
+    mode?: 'multi';
+    /** The APPLIED selection — subcategory ids. */
+    value: string[];
+    /** Fired with the new applied selection when Apply is pressed. */
+    onChange: (next: string[]) => void;
+}
+/** Single-select mode: the "move to…" picker. Choosing a row commits at once. */
+export interface CategorySingleSelectProps extends CategorySelectBaseProps {
+    mode: 'single';
+    /** The chosen category or subcategory id, or `null`. */
+    value: string | null;
+    /** Fired with the chosen id, or `null` when cleared. */
+    onChange: (next: string | null) => void;
+}
+export type CategorySelectProps = CategoryMultiSelectProps | CategorySingleSelectProps;
+//# sourceMappingURL=CategorySelect.types.d.ts.map

package/dist/types/components/form/CategorySelect/CategorySelect.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategorySelect.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategorySelect.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,4EAA4E;IAC5E,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,aAAa,EAAE,oBAAoB,EAAE,CAAC;CACvC;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB;IACpC,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,kFAAkF;IAClF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,+EAA+E;IAC/E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,uBAAuB;IACvE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,kEAAkE;IAClE,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACpC;AAED,iFAAiF;AACjF,MAAM,WAAW,yBAA0B,SAAQ,uBAAuB;IACxE,IAAI,EAAE,QAAQ,CAAC;IACf,wDAAwD;IACxD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,wDAAwD;IACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;CACzC;AAED,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,GAAG,yBAAyB,CAAC"}

package/dist/types/components/form/CategorySelect/CategoryTrigger.d.ts

@@ -0,0 +1,27 @@
+interface CategoryTriggerProps {
+    /** Text shown when nothing is selected. */
+    placeholder: string;
+    /** Resolved label when there IS a selection (single mode shows "Pai › Filha"). */
+    selectionLabel?: string;
+    /** Selection size — rendered as the count pill in multi-select. */
+    count?: number;
+    open: boolean;
+    disabled?: boolean;
+    fullWidth: boolean;
+    onOpen: () => void;
+    /** Absent when there is nothing to clear. */
+    onClear?: () => void;
+    triggerRef: React.RefObject<HTMLButtonElement | null>;
+    dataTestId: string;
+}
+/**
+ * The closed control.
+ *
+ * The clear (×) is a real button nested in the trigger button, so "remove the
+ * filter" is one click from the closed state — without it, clearing means open,
+ * find Clear, apply. Its click is stopped from reaching the trigger, which would
+ * otherwise open the panel on the way out.
+ */
+export declare function CategoryTrigger({ placeholder, selectionLabel, count, open, disabled, fullWidth, onOpen, onClear, triggerRef, dataTestId, }: CategoryTriggerProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=CategoryTrigger.d.ts.map

package/dist/types/components/form/CategorySelect/CategoryTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryTrigger.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/CategoryTrigger.tsx"],"names":[],"mappings":"AAYA,UAAU,oBAAoB;IAC5B,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAC9B,WAAW,EACX,cAAc,EACd,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,MAAM,EACN,OAAO,EACP,UAAU,EACV,UAAU,GACX,EAAE,oBAAoB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA4D1C"}

package/dist/types/components/form/CategorySelect/category-keyboard.d.ts

@@ -0,0 +1,30 @@
+import type { CategoryRowRef } from './category-tree';
+import type { CategoryGroup } from './CategorySelect.types';
+/** What a key handler is allowed to do to the panel. */
+export interface CategoryKeyContext {
+    rows: CategoryRowRef[];
+    activeIndex: number;
+    groups: CategoryGroup[];
+    /** Single-select mode picks on Enter/Space instead of toggling a draft. */
+    single: boolean;
+    /** Categories are headings, not checkboxes, unless parents are selectable. */
+    allowParentSelection: boolean;
+    setActiveIndex: (next: number) => void;
+    toggleExpanded: (categoryId: string) => void;
+    expand: (categoryId: string) => void;
+    collapse: (categoryId: string) => void;
+    toggleCategory: (group: CategoryGroup) => void;
+    toggleSubcategory: (id: string) => void;
+    commit: () => void;
+    cancel: () => void;
+    pick: (id: string) => void;
+}
+/**
+ * Drive the tree from the keyboard.
+ *
+ * Returns `true` when the key was consumed, so the caller can `preventDefault`
+ * only for keys this actually handled — an unhandled key must still reach the
+ * search input untouched.
+ */
+export declare function handleCategoryKeyDown(key: string, editingSearchText: boolean, context: CategoryKeyContext): boolean;
+//# sourceMappingURL=category-keyboard.d.ts.map

package/dist/types/components/form/CategorySelect/category-keyboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-keyboard.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/category-keyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,wDAAwD;AACxD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC;IAChB,8EAA8E;IAC9E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5B;AAiGD;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,iBAAiB,EAAE,OAAO,EAC1B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAMT"}

package/dist/types/components/form/CategorySelect/category-tree.d.ts

@@ -0,0 +1,73 @@
+import type { CategoryGroup, CategorySelectionChip, CategorySelectOption } from './CategorySelect.types';
+/**
+ * Fold a string to its comparison form: no diacritics, lower case.
+ *
+ * Portuguese category names are full of them ("Águas", "Cápsulas", "Grãos"), and
+ * an admin typing "agua" or "graos" on a hurried phone keyboard means the same
+ * thing. Comparing folded forms on both sides makes the search accent-blind in
+ * both directions.
+ */
+export declare function foldText(text: string): string;
+/**
+ * Group a flat `parentId` list into top level + children, preserving input order.
+ *
+ * An option whose `parentId` names no top-level row is promoted to top level
+ * rather than dropped — a category is never invisible just because its parent
+ * was filtered out of the payload, or because the tree is deeper than two levels.
+ */
+export declare function buildCategoryGroups(options: CategorySelectOption[]): CategoryGroup[];
+/** Every selectable leaf id across all groups, in display order. */
+export declare function collectLeafIds(groups: CategoryGroup[]): string[];
+/** The leaves a category stands for — its subcategories, or itself when childless. */
+export declare function leavesOf(group: CategoryGroup): string[];
+export type CategoryCheckState = 'off' | 'partial' | 'on';
+/** Whether none, some, or all of a category's leaves are selected. */
+export declare function categoryCheckState(group: CategoryGroup, selected: ReadonlySet<string>): CategoryCheckState;
+/** Select every leaf of a category, or clear them all when already complete. */
+export declare function toggleCategoryLeaves(group: CategoryGroup, selected: ReadonlySet<string>): Set<string>;
+/** Add an id when absent, remove it when present. */
+export declare function toggleLeaf(id: string, selected: ReadonlySet<string>): Set<string>;
+/**
+ * Collapse a raw id set into the chips a human reads: a category that is fully
+ * selected becomes ONE chip bearing the category's name, rather than one chip
+ * per subcategory — "Bebidas" instead of six drinks.
+ */
+export declare function summarizeSelection(groups: CategoryGroup[], selected: ReadonlySet<string>): CategorySelectionChip[];
+/**
+ * Drop the leaves a chip stands for. A `whole` chip removes the whole category;
+ * any other chip removes just that leaf.
+ */
+export declare function removeChip(groups: CategoryGroup[], chipId: string, selected: ReadonlySet<string>): Set<string>;
+/**
+ * Search across BOTH levels, keeping every hit under its parent.
+ *
+ * A category that matches keeps all of its subcategories, so "Bebidas" shows the
+ * whole group. A category that does not match keeps only the subcategories that
+ * do — the hit still arrives with its parent visible above it, which is the
+ * context that tells "Massas" (mercearia) from "Massas" (pratos principais).
+ */
+export declare function filterCategoryGroups(groups: CategoryGroup[], query: string): CategoryGroup[];
+/** A run of text, flagged when it is the part that matched the query. */
+interface HighlightSegment {
+    text: string;
+    match: boolean;
+}
+/**
+ * Split a label around the query hit so the view can mark it.
+ *
+ * Slicing uses indices from the FOLDED text but cuts the ORIGINAL, which is safe
+ * because folding is per-character here: NFD-stripping combining marks and
+ * lower-casing both preserve offsets for the scripts these names use.
+ */
+export declare function highlightSegments(text: string, query: string): HighlightSegment[];
+/** A flattened row, so keyboard navigation can walk what is actually on screen. */
+export interface CategoryRowRef {
+    kind: 'category' | 'subcategory';
+    id: string;
+    /** Owning category id — lets ← jump from a subcategory back to its parent. */
+    parentId?: string;
+}
+/** The visible rows, in order, honouring which categories are expanded. */
+export declare function flattenRows(groups: CategoryGroup[], isExpanded: (categoryId: string) => boolean): CategoryRowRef[];
+export {};
+//# sourceMappingURL=category-tree.d.ts.map

package/dist/types/components/form/CategorySelect/category-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-tree.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/category-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,aAAa,EAAE,CAmBpF;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAMhE;AAED,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,EAAE,CAIvD;AAED,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;AAE1D,sEAAsE;AACtE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,kBAAkB,CAKpB;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,GAAG,CAAC,MAAM,CAAC,CAMb;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAIjF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EAAE,EACvB,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,qBAAqB,EAAE,CAWzB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,GAC5B,GAAG,CAAC,MAAM,CAAC,CASb;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAU5F;AAED,yEAAyE;AACzE,UAAU,gBAAgB;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAUjF;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,UAAU,GAAG,aAAa,CAAC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CACzB,MAAM,EAAE,aAAa,EAAE,EACvB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,GAC1C,cAAc,EAAE,CAelB"}

package/dist/types/components/form/CategorySelect/index.d.ts

@@ -0,0 +1,4 @@
+export { CategorySelect } from './CategorySelect';
+export type { CategoryGroup, CategoryMultiSelectProps, CategorySelectBaseProps, CategorySelectionChip, CategorySelectOption, CategorySelectProps, CategorySingleSelectProps, } from './CategorySelect.types';
+export { buildCategoryGroups, categoryCheckState, collectLeafIds, filterCategoryGroups, foldText, leavesOf, summarizeSelection, } from './category-tree';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/form/CategorySelect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACR,QAAQ,EACR,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/types/components/form/CategorySelect/useCategoryCommit.d.ts

@@ -0,0 +1,29 @@
+import type { CategoryGroup, CategorySelectProps } from './CategorySelect.types';
+import type { CategorySelectState } from './useCategorySelect';
+/** The verbs a row, a footer button or a key press can invoke. */
+export interface CategoryActions {
+    /** Publish the draft to the caller and close (multi-select). */
+    commit: () => void;
+    /** Choose one id and close (single-select). */
+    pick: (id: string) => void;
+    /** Close without publishing, returning focus to the trigger. */
+    cancel: () => void;
+    /** Empty the APPLIED selection straight from the closed trigger. */
+    clearSelection: () => void;
+    activateCategory: (group: CategoryGroup) => void;
+    activateSubcategory: (id: string) => void;
+}
+interface UseCategoryCommitArgs {
+    props: CategorySelectProps;
+    state: CategorySelectState;
+    single: boolean;
+    allowParentSelection: boolean;
+}
+/**
+ * The commit semantics, which are the one thing the two modes genuinely differ
+ * on: multi-select batches into a draft and publishes on Apply, single-select
+ * publishes the moment a row is chosen.
+ */
+export declare function useCategoryCommit({ props, state, single, allowParentSelection, }: UseCategoryCommitArgs): CategoryActions;
+export {};
+//# sourceMappingURL=useCategoryCommit.d.ts.map

package/dist/types/components/form/CategorySelect/useCategoryCommit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCategoryCommit.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/useCategoryCommit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,+CAA+C;IAC/C,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3B,gEAAgE;IAChE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,oEAAoE;IACpE,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACjD,mBAAmB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED,UAAU,qBAAqB;IAC7B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,KAAK,EACL,MAAM,EACN,oBAAoB,GACrB,EAAE,qBAAqB,GAAG,eAAe,CAgEzC"}

package/dist/types/components/form/CategorySelect/useCategoryKeyHandler.d.ts

@@ -0,0 +1,17 @@
+import type { CategoryActions } from './useCategoryCommit';
+import type { CategorySelectState } from './useCategorySelect';
+interface UseCategoryKeyHandlerArgs {
+    state: CategorySelectState;
+    single: boolean;
+    allowParentSelection: boolean;
+    actions: CategoryActions;
+}
+/**
+ * Bind the panel's keydown to the tree navigator.
+ *
+ * `preventDefault` fires only for keys the navigator actually consumed, so an
+ * unhandled key still reaches the search box — otherwise typing would be dead.
+ */
+export declare function useCategoryKeyHandler({ state, single, allowParentSelection, actions, }: UseCategoryKeyHandlerArgs): (event: React.KeyboardEvent) => void;
+export {};
+//# sourceMappingURL=useCategoryKeyHandler.d.ts.map

package/dist/types/components/form/CategorySelect/useCategoryKeyHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCategoryKeyHandler.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/useCategoryKeyHandler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,UAAU,yBAAyB;IACjC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,KAAK,EACL,MAAM,EACN,oBAAoB,EACpB,OAAO,GACR,EAAE,yBAAyB,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,aAAa,KAAK,IAAI,CAyClE"}

package/dist/types/components/form/CategorySelect/useCategorySelect.d.ts

@@ -0,0 +1,48 @@
+import { type CategoryRowRef } from './category-tree';
+import type { CategoryGroup, CategorySelectOption } from './CategorySelect.types';
+/** Which categories are unfolded, and the ways that set changes. */
+interface ExpansionState {
+    isExpanded: (categoryId: string) => boolean;
+    toggleExpanded: (categoryId: string) => void;
+    setAllExpanded: (expanded: boolean) => void;
+    expandAll: (groups: CategoryGroup[]) => void;
+}
+/** The pending selection and the two ways a row changes it. */
+interface DraftState {
+    draft: ReadonlySet<string>;
+    setDraft: (next: ReadonlySet<string>) => void;
+    toggleCategory: (group: CategoryGroup) => void;
+    toggleSubcategory: (id: string) => void;
+}
+/** Everything the panel and trigger need to render and drive one select. */
+export interface CategorySelectState extends ExpansionState, DraftState {
+    open: boolean;
+    query: string;
+    /** Groups after the search filter — what is actually on screen. */
+    visibleGroups: CategoryGroup[];
+    /** All groups, unfiltered — the basis for chips and "select all". */
+    allGroups: CategoryGroup[];
+    rows: CategoryRowRef[];
+    activeIndex: number;
+    setQuery: (next: string) => void;
+    setActiveIndex: (next: number) => void;
+    openPanel: () => void;
+    closePanel: () => void;
+    triggerRef: React.RefObject<HTMLButtonElement | null>;
+}
+interface UseCategorySelectArgs {
+    options: CategorySelectOption[];
+    /** The applied selection to seed the draft from each time the panel opens. */
+    selected: readonly string[];
+}
+/**
+ * Panel state for one CategorySelect.
+ *
+ * The DRAFT is the load-bearing idea. Ticks land here, not on the caller's
+ * `value`, so the list behind the panel does not refetch on every click; Apply
+ * publishes, dismissing discards. Opening re-seeds the draft from the applied
+ * value, which is what makes "cancel" mean cancel.
+ */
+export declare function useCategorySelect({ options, selected, }: UseCategorySelectArgs): CategorySelectState;
+export {};
+//# sourceMappingURL=useCategorySelect.d.ts.map

package/dist/types/components/form/CategorySelect/useCategorySelect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCategorySelect.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CategorySelect/useCategorySelect.ts"],"names":[],"mappings":"AAEA,OAAO,EAML,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAElF,oEAAoE;AACpE,UAAU,cAAc;IACtB,UAAU,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;CAC9C;AA0CD,+DAA+D;AAC/D,UAAU,UAAU;IAClB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAC9C,cAAc,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC/C,iBAAiB,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC;AAkBD,4EAA4E;AAC5E,MAAM,WAAW,mBAAoB,SAAQ,cAAc,EAAE,UAAU;IACrE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,aAAa,EAAE,aAAa,EAAE,CAAC;IAC/B,qEAAqE;IACrE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;CACvD;AAED,UAAU,qBAAqB;IAC7B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,8EAA8E;IAC9E,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,OAAO,EACP,QAAQ,GACT,EAAE,qBAAqB,GAAG,mBAAmB,CAqD7C"}

package/dist/types/components/form/CepField/CepField.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { CepFieldProps } from './CepField.types';
+/**
+ * A CEP input that fills the rest of the address in.
+ *
+ * The pattern every Brazilian form has used for twenty years: type eight
+ * digits, and logradouro/bairro/cidade/UF arrive on their own. This is the
+ * reusable half — masking, validation, debouncing, race-safety and status —
+ * with the actual lookup injected via `onLookup`, so the same component serves
+ * a supplier form, a store-location form or a delivery checkout without
+ * knowing anything about providers or auth.
+ *
+ * Resolution is best-effort by design. A provider outage, an unknown CEP or a
+ * timeout leaves the field exactly as usable as a plain text input — the user
+ * types the address themselves. Autofill never blocks.
+ *
+ * @example
+ * ```tsx
+ * <CepField
+ *   value={cep}
+ *   onChange={setCep}
+ *   onLookup={(c) => fetch(`/api/…/lookup/cep/${c}`).then((r) => r.json()).then((b) => b.data)}
+ *   onResolved={(a) => { setStreet(a.street ?? ''); setCity(a.city ?? ''); }}
+ * />
+ * ```
+ */
+export declare function CepField({ value, onChange, onLookup, onResolved, onNotFound, label, placeholder, error, disabled, debounceMs, name, dataTestId, }: CepFieldProps): React.ReactElement;
+export default CepField;
+//# sourceMappingURL=CepField.d.ts.map

package/dist/types/components/form/CepField/CepField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CepField.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CepField/CepField.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAMxE,OAAO,KAAK,EAAc,aAAa,EAAmB,MAAM,kBAAkB,CAAC;AAkHnF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,KAAa,EACb,WAAyB,EACzB,KAAK,EACL,QAAgB,EAChB,UAAgB,EAChB,IAAmB,EACnB,UAAU,GACX,EAAE,aAAa,GAAG,KAAK,CAAC,YAAY,CAiDpC;AAED,eAAe,QAAQ,CAAC"}

package/dist/types/components/form/CepField/CepField.types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Types for {@link CepField} — the reusable CEP auto-completer.
+ */
+/**
+ * A resolved CEP.
+ *
+ * Structurally identical to what the app's `/lookup/cep` endpoint returns, but
+ * declared here so the component stays independent of any particular backend:
+ * anything that can produce this shape can drive the field.
+ *
+ * `número` and `complemento` are deliberately absent — no CEP database holds
+ * them, so they are always the user's to type.
+ */
+export interface CepAddress {
+    /** The CEP that resolved, bare digits. */
+    cep: string;
+    /** Logradouro (street name, no number). */
+    street: string | null;
+    /** Bairro. */
+    neighborhood: string | null;
+    /** Município. */
+    city: string | null;
+    /** UF. */
+    state: string | null;
+}
+/** What the field is currently doing, surfaced as a status line. */
+export type CepLookupStatus = 'idle' | 'loading' | 'found' | 'notfound';
+export interface CepFieldProps {
+    /** Current field value. Masked (`01310-100`) or bare — the field re-masks. */
+    value: string;
+    /**
+     * Called on every keystroke with the MASKED value, so the caller's state and
+     * what the user sees never diverge.
+     */
+    onChange: (masked: string) => void;
+    /**
+     * Resolve a complete CEP to an address, or `null` when it is unknown.
+     *
+     * Injected rather than hard-wired: the component knows nothing about
+     * providers, transport or auth. Omit it to get a masked, validated CEP input
+     * with no lookup at all.
+     */
+    onLookup?: (cep: string) => Promise<CepAddress | null>;
+    /**
+     * Called once a CEP resolves — this is where the caller fills the address
+     * fields. Never called for an incomplete, unchanged or unknown CEP.
+     */
+    onResolved?: (address: CepAddress) => void;
+    /**
+     * Called when a COMPLETE CEP fails to resolve (unknown, or every provider
+     * down). The counterpart to `onResolved`: a caller that auto-filled from a
+     * previous CEP should undo that here, so the form never shows one CEP's
+     * street under a different CEP.
+     */
+    onNotFound?: () => void;
+    /** Visible label. Defaults to `CEP`. */
+    label?: string;
+    /** Placeholder. Defaults to `00000-000`. */
+    placeholder?: string;
+    /** Validation error from the caller's form, shown below the input. */
+    error?: string;
+    /** Disables the input and suppresses lookups. */
+    disabled?: boolean;
+    /** Milliseconds to wait after the last keystroke before looking up. */
+    debounceMs?: number;
+    /** Field name / input id. Defaults to `postalCode`. */
+    name?: string;
+    /** Test id for the input. Defaults to `cep-field-<name>`. */
+    dataTestId?: string;
+}
+//# sourceMappingURL=CepField.types.d.ts.map

package/dist/types/components/form/CepField/CepField.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CepField.types.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CepField/CepField.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,cAAc;IACd,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU;IACV,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACvD;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/components/form/CepField/index.d.ts

@@ -0,0 +1,3 @@
+export { CepField } from './CepField';
+export type { CepAddress, CepFieldProps, CepLookupStatus } from './CepField.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/components/form/CepField/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/CepField/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/types/components/form/Checkbox/Checkbox.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+import type { CheckboxProps } from './Checkbox.types';
+export declare const Checkbox: React.ForwardRefExoticComponent<Omit<CheckboxProps, "ref"> & React.RefAttributes<HTMLButtonElement>>;
+//# sourceMappingURL=Checkbox.d.ts.map

package/dist/types/components/form/Checkbox/Checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Checkbox/Checkbox.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AA0FtD,eAAO,MAAM,QAAQ,sGAqEpB,CAAC"}

package/dist/types/components/form/Checkbox/Checkbox.helpers.d.ts

@@ -0,0 +1,7 @@
+import type { CheckboxProps } from './Checkbox.types';
+type CheckboxDefaultedKeys = 'variant' | 'ripple' | 'glow' | 'pulse';
+type ResolvedCheckboxProps = CheckboxProps & Required<Pick<CheckboxProps, CheckboxDefaultedKeys>>;
+export declare const resolveCheckboxProps: (props: CheckboxProps) => ResolvedCheckboxProps;
+export declare const makeTestId: (dataTestId?: string) => (suffix: string) => string;
+export {};
+//# sourceMappingURL=Checkbox.helpers.d.ts.map

package/dist/types/components/form/Checkbox/Checkbox.helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.helpers.d.ts","sourceRoot":"","sources":["../../../../../src/components/form/Checkbox/Checkbox.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,KAAK,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAErE,KAAK,qBAAqB,GAAG,aAAa,GACxC,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,qBAAqB,CAAC,CAAC,CAAC;AAgBvD,eAAO,MAAM,oBAAoB,GAAI,OAAO,aAAa,KAAG,qBACiB,CAAC;AAE9E,eAAO,MAAM,UAAU,GACpB,aAAa,MAAM,MACnB,QAAQ,MAAM,KAAG,MAC6C,CAAC"}