@12-apps/ui 5.0.0 → 5.0.1

package/dist/types/components/data-display/DataViews/base-list-card.d.ts

@@ -0,0 +1,128 @@
+import { type ReactNode } from "react";
+import type { DescriptionItemProps } from "../DescriptionItem";
+import { type CardSurfaceProps } from "./card-surface";
+import { type DataViewsDensity } from "./data-views-layout-context";
+import { type ListCardCellConfig } from "./list-card-cells";
+/**
+ * THE "LISTA" LAYOUT'S CARD — {@link BaseCard}'s horizontal sibling.
+ *
+ * `ListBody` always described the shape it wanted ("a marker, a title, a
+ * subtitle and a value on the right") and never provided it, so every host
+ * hand-rolled a `<Box>` flex row: a tint for selection with no checkbox, fixed
+ * `minWidth` columns that ignored density and never collapsed, no hover, no
+ * focus ring, and a `borderBottom` fighting the gap between rows.
+ *
+ * THE LIST OWNS THE COLUMNS. Inside a {@link ListCardGroup} this card is
+ * `grid-template-columns: subgrid` across the group's rails, so the value sits
+ * on its own edge and cannot be shunted about by the width of the status chip
+ * beside it. Standalone it falls back to the same template on its own. See
+ * `list-card-rails`.
+ *
+ * IT ANSWERS ITS OWN WIDTH, not the viewport — a container query, because the
+ * same row renders full-bleed on a phone, in a 300px board column, and beside a
+ * filter panel that opens and closes. Below `STACK_BREAK` it leaves the shared
+ * rails entirely and goes two-line, which is the standard mobile transaction
+ * row and beats truncating everything: title + value, then subtitle + status.
+ */
+export interface BaseListCardProps extends CardSurfaceProps {
+    /** A marker: avatar, thumbnail or status glyph. Earn the pixels — a generic
+     *  icon repeated down fifty rows is noise. */
+    leading?: ReactNode;
+    /** First-class title. Rendered as the link when `href` is set. */
+    title?: ReactNode;
+    /** Secondary line under the title. */
+    subtitle?: ReactNode;
+    /**
+     * Middle columns as labelled pairs — {@link DescriptionItem}s, not free-form
+     * nodes, so a screen reader reads "Data, 05/08/2026" rather than four
+     * unrelated strings. Stacked (label above value) by default.
+     *
+     * The FIRST rung of the collapse ladder: the only slot whose absence does not
+     * stop the row being identified or acted on.
+     */
+    meta?: DescriptionItemProps[];
+    /** Escape hatch for a middle section these pairs cannot express. */
+    metaSlot?: ReactNode;
+    /** The number this row is about. Its own rail, tabular figures, never truncated. */
+    value?: ReactNode;
+    /**
+     * Inline actions — the one or two things done often enough to deserve a
+     * button. Revealed on hover and `:focus-within` by default, so fifty rows of
+     * buttons are not the resting state of the page.
+     */
+    actions?: ReactNode;
+    /** Always show the inline actions, rather than on hover/focus. */
+    actionsAlwaysVisible?: boolean;
+    /** The 3-dots overflow menu, pinned to the end. Also opens on right-click. */
+    menu?: ReactNode;
+    /** What opens the overflow menu on right-click / long-press. */
+    onContextMenu?: (event: React.MouseEvent) => void;
+    /**
+     * THE EXPANDABLE BODY — and the whole reason this is a card and not a table
+     * row.
+     *
+     * A summary row of labelled columns is a table row with a border round it: it
+     * restates what the table already says and gives nobody a reason to switch to
+     * it. What a card can do that a table cell cannot is OPEN — carry the record's
+     * own detail underneath its summary, in whatever shape that record wants.
+     *
+     * So this container makes no claim about what goes in here. It spans every
+     * rail and imposes nothing: an order puts its line items and a totals ledger
+     * here, a cart adds its recovery actions, a role lists its permissions. The
+     * design of that area belongs entirely to the consumer, and none of it is the
+     * envelope's business.
+     *
+     * ABSENT ⇒ NO CHEVRON. A row given nothing to reveal renders no disclosure
+     * control at all, rather than one that opens onto an empty box, so a column of
+     * chevrons is a truthful index of which rows have more behind them.
+     */
+    children?: ReactNode;
+    /** Open on first render, for an uncontrolled card. Ignored when `expanded` is set. */
+    defaultExpanded?: boolean;
+    /**
+     * Open state, when the LIST wants to own it.
+     *
+     * Left unset the card keeps its own, and rows open independently — several at
+     * once, which is what comparing two records requires. Pass this (with
+     * `onExpandedChange`) to impose something else, an accordion being the usual
+     * reason.
+     */
+    expanded?: boolean;
+    /** Fired with the state the card is asking to move to. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Toggle this row's selection. Receives the raw event so a list can range-select. */
+    onToggleSelect?: (event?: React.MouseEvent) => void;
+    /** How much air the row gets. Vertical only — a full-width row cannot narrow. */
+    density?: DataViewsDensity;
+    /**
+     * Fine-grained size multiplier on top of `density` (1 = base).
+     *
+     * Applied as `zoom`, so it scales EVERYTHING the row draws — type, gutters,
+     * gaps, padding, the checkbox, the grip, the chip and the menu — not just the
+     * handful of font sizes it once multiplied.
+     */
+    scale?: number;
+    /** Flush style: a bottom rule instead of an outline. Row-only. */
+    divider?: boolean;
+    /** This row's id for drag purposes. Inert outside a `DragContainerProvider`. */
+    dragId?: string | number;
+    /**
+     * The record this row is about, read by the list's cell config.
+     *
+     * Required only when cells are configured — the config's `primary`/`secondary`
+     * are functions of the row, so without one there is nothing to render them
+     * from and the card falls back to its named slots.
+     */
+    row?: Record<string, unknown>;
+    /**
+     * A cell config for a STANDALONE card.
+     *
+     * Inside a `ListCardGroup` the list's config wins and this is ignored: one
+     * declaration of the list's shape is the whole point, and a row permitted to
+     * override it could put its columns somewhere no other row has them.
+     */
+    cells?: readonly ListCardCellConfig<never>[];
+}
+export declare function BaseListCard(props: BaseListCardProps): React.JSX.Element;
+export { META_BREAK, STACK_BREAK } from "./base-list-card-slots";
+//# sourceMappingURL=base-list-card.d.ts.map

package/dist/types/components/data-display/DataViews/base-list-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-list-card.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/base-list-card.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG/D,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAKvD,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAA4C,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAQtG;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD;kDAC8C;IAC9C,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,kEAAkE;IAClE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,oBAAoB,EAAE,CAAC;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,oFAAoF;IACpF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,kEAAkE;IAClE,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,8EAA8E;IAC9E,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,gEAAgE;IAChE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IAClD;;;;;;;;;;;;;;;;;;OAkBG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,sFAAsF;IACtF,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0DAA0D;IAC1D,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/C,sFAAsF;IACtF,cAAc,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC;IACpD,iFAAiF;IACjF,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,SAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;CAC9C;AAkJD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+CxE;AAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/types/components/data-display/DataViews/card-surface.d.ts

@@ -0,0 +1,130 @@
+import { type CSSObject, type Theme } from "@mui/material";
+/**
+ * A plain style object, not MUI's `SxProps`.
+ *
+ * `SxProps` is a union including arrays and functions, so a value typed as one
+ * cannot be spread — and these fragments exist precisely to be merged. Note also
+ * that `Card` merges by SPREADING (`sx={{ ...defaults, ...sx }}`), so handing it
+ * a function yields nothing at all: resolve the theme with `useTheme` first.
+ */
+type CardSx = CSSObject | Record<string, unknown>;
+/**
+ * THE CONTRACT BOTH CARDS IMPLEMENT.
+ *
+ * `BaseCard` (a tile) and `BaseListCard` (a row) are one object seen from two
+ * angles, so the surface — variant, colour, selectability, draggability,
+ * emphasis and state — is declared once and spread into both.
+ */
+/**
+ * How much chrome the surface claims. Button's vocabulary, spelled Button's
+ * way: a card and a button are both surfaces the operator presses, and having
+ * one say `outline` while the other says `outlined` taxes everyone who writes
+ * both. Chip's `filled | outlined` was the wrong model — a chip is a token in a
+ * sentence and has only those two things to say.
+ */
+export type CardSurfaceVariant = "outline" | "ghost" | "text" | "glass";
+/** The theme colour a card's selection and emphasis are drawn in. */
+export type CardSurfaceColor = "primary" | "secondary" | "success" | "warning" | "error" | "info";
+/**
+ * Why this card is asking to be noticed.
+ *
+ * ONE union, not six booleans. `glow`/`pulse`/`animate`/`bounce`/`shimmer`
+ * combined into 32 states of which about three meant anything —
+ * `pulse + shimmer + bounce` is not a thing anyone wants, and every one of
+ * those combinations was a state somebody could reach by accident.
+ */
+export type CardEmphasis = 
+/** Nothing. The overwhelming default. */
+"none"
+/** Look here now: an accent bar, and a ring that beats six times and settles. */
+ | "attention"
+/** This just arrived: an accent bar and one fade-in. */
+ | "new";
+/** A row and a tile carry emphasis differently — see `emphasisSx`. */
+type CardShape = "row" | "tile";
+/**
+ * What this record IS, as opposed to how it looks.
+ *
+ * `dimmed` only greyed pixels, which left a cancelled row's buttons live and
+ * clickable. This carries the meaning, so the card can also stop offering
+ * actions on something that cannot be acted on.
+ */
+export type CardState = "default" | "cancelled" | "disabled";
+export interface CardSurfaceProps {
+    /** How much chrome the surface claims. Defaults to `outline`. */
+    variant?: CardSurfaceVariant;
+    /** Theme colour for selection and emphasis. Defaults to `primary`. */
+    color?: CardSurfaceColor;
+    /**
+     * Can this card be selected — and does it show it?
+     *
+     * The capability, separate from the handler. `selectable` gets the checkbox
+     * AND the selected treatment; `selectable={false}` has neither, however
+     * `selected` is set, so a stale flag arriving with the data cannot make a
+     * read-only row render as picked. Defaults to whether `onToggleSelect` exists.
+     */
+    selectable?: boolean;
+    /** Whether this card is currently in the selection. */
+    selected?: boolean;
+    /**
+     * Opt OUT of dragging even inside a drag container.
+     *
+     * Draggability is the container's decision (see `data-views-drag`); this is
+     * the card's veto — a pinned row, a summary line, a record that may not move.
+     */
+    draggable?: boolean;
+    /**
+     * Where this card leads.
+     *
+     * PREFER THIS TO `onClick`. A clickable `<div>` cannot be cmd-clicked,
+     * middle-clicked or "copy link address"'d, and wrapping interactive children
+     * in a click handler is the a11y violation it looks like. With `href` the
+     * title is a real `<a>` stretched over the card by a pseudo-element: one
+     * whole-row target, correct tab order, every browser affordance intact, and
+     * the buttons inside stay ordinary buttons.
+     */
+    href?: string;
+    /** Anchor target, when `href` is set. */
+    target?: string;
+    /** Card click, for a card that does not navigate. See `href` first. */
+    onClick?: () => void;
+    /** What this record is. `cancelled`/`disabled` also suppress the actions. */
+    state?: CardState;
+    /** Why this card is asking to be noticed. Defaults to `none`. */
+    emphasis?: CardEmphasis;
+    className?: string;
+    /**
+     * One id; the parts derive from it (`${testId}-checkbox`, `-drag`, `-menu`,
+     * `-value`). A prop per slot would have been `checkboxTestId`,
+     * `menuTestId`, `valueTestId`… one for every part anybody ever tested.
+     */
+    testId?: string;
+    "aria-label"?: string;
+}
+/**
+ * ONE RADIUS FOR BOTH SHAPES, off the token scale on purpose.
+ *
+ * `Card`'s own steps are 4px and 8px and its `lg` is 16px, all chosen for a
+ * surface nearly as tall as it is wide. A 56px row is not that shape — the
+ * corner runs most of the way down both ends and curves away from the square
+ * checkbox and square thumbnail inside it — and a tile that rounds harder than
+ * the row it sits beside in the same view reads as a different component.
+ *
+ * 3px takes the hard point off the corner without being seen as a curve.
+ * `divider` rows override it back to 0; a bottom rule has no corners to round.
+ */
+export declare const CARD_RADIUS = "3px";
+/** Every slot's test id, derived from the card's one. */
+export declare function slotTestIds(testId: string | undefined): (slot: string) => string | undefined;
+/** Is this card selectable? Explicit wins; otherwise a handler implies it. */
+export declare function isSelectable(props: Pick<CardSurfaceProps, "selectable"> & {
+    onToggleSelect?: () => void;
+}): boolean;
+/** Can this record be acted on at all? */
+export declare function isActionable(state: CardState | undefined): boolean;
+export declare function cardSurfaceStyles(props: CardSurfaceProps & {
+    selectable: boolean;
+    shape: CardShape;
+}, theme: Theme): CardSx;
+export {};
+//# sourceMappingURL=card-surface.d.ts.map

package/dist/types/components/data-display/DataViews/card-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"card-surface.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/card-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AAI7E;;;;;;;GAOG;AACH,KAAK,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AASlD;;;;;;GAMG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAExE,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,WAAW,GACX,SAAS,GACT,SAAS,GACT,OAAO,GACP,MAAM,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY;AACtB,yCAAyC;AACvC,MAAM;AACR,iFAAiF;GAC/E,WAAW;AACb,wDAAwD;GACtD,KAAK,CAAC;AAEV,sEAAsE;AACtE,KAAK,SAAS,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhC;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,sEAAsE;IACtE,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;;;;OASG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAE5F;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAC1B,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,YAAY,CAAC,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,GAC5E,OAAO,CAET;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAElE;AAsMD,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,GAAG;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,EACnE,KAAK,EAAE,KAAK,GACX,MAAM,CAoBR"}

package/dist/types/components/data-display/DataViews/data-views-bar-controls.d.ts

@@ -0,0 +1,35 @@
+/**
+ * "Limpar" — one gesture back to the unfiltered list.
+ *
+ * Present ONLY while something is applied, and last in the cluster, because it
+ * is destructive and must never be where a filter control was a moment ago.
+ * Each pill already carries its own ✕; this is the other job — six applied
+ * filters is six ✕ hunts, and the operator who wants "show me everything
+ * again" has no way to say it.
+ *
+ * Loses its label on the same rung Exibir/Exportar lose theirs, and keeps a
+ * tooltip when it does: it is one of the two controls (with the search) whose
+ * icon has to carry the whole meaning on a phone.
+ */
+export declare function ClearAllControl({ onClearAll, compact, testIdPrefix, }: {
+    onClearAll: () => void;
+    compact: boolean;
+    testIdPrefix: string;
+}): React.JSX.Element;
+/**
+ * The way out of a search takeover.
+ *
+ * A phone has no Escape key, and without this the takeover is a one-way door
+ * onto a bar with no filters on it.
+
+/**
+ * The way out of a search takeover.
+ *
+ * A phone has no Escape key, and without this the takeover is a one-way door
+ * onto a bar with no filters on it.
+ */
+export declare function CloseSearchControl({ onClose, testIdPrefix, }: {
+    onClose: () => void;
+    testIdPrefix: string;
+}): React.JSX.Element;
+//# sourceMappingURL=data-views-bar-controls.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-bar-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-bar-controls.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-bar-controls.tsx"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,EAC9B,UAAU,EACV,OAAO,EACP,YAAY,GACb,EAAE;IACD,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiCpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,YAAY,GACb,EAAE;IACD,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0BpB"}

package/dist/types/components/data-display/DataViews/data-views-category-pill.d.ts

@@ -0,0 +1,31 @@
+import type { FilterFieldConfig } from "./data-views-types";
+/**
+ * Diff a whole-array selection back into per-value toggles.
+ *
+ * The filter state's only channel is `onTogglePill(field, value, checked)`, but
+ * a tree hands back the entire selection at once. Diffing here keeps that one
+ * channel the single way a pill ever changes, rather than giving the
+ * hierarchical control a private path into the state.
+ */
+export declare function emitPillDiff(fieldId: string, before: readonly string[], after: readonly string[], onTogglePill: (fieldId: string, value: string, checked: boolean) => void): void;
+interface PillControlProps<T extends Record<string, unknown>> {
+    fieldId: string;
+    pill: FilterFieldConfig<T>;
+    selected: string[];
+    onTogglePill: (fieldId: string, value: string, checked: boolean) => void;
+    onClearField: (fieldId: string) => void;
+    onOpenChange?: (open: boolean) => void;
+    testIdPrefix: string;
+    /** `stacked` in the filter panel, `pill` on the inline bar. */
+    layout?: "stacked" | "pill";
+}
+/**
+ * One filter pill: the hierarchical category tree, or the flat multi-select.
+ *
+ * A category set nests, and flattening it into one list is what made "Massas"
+ * (mercearia) indistinguishable from "Massas" (pratos principais). `control:
+ * "category"` opts a field into the tree, which shows each hit under its parent.
+ */
+export declare function PillControl<T extends Record<string, unknown>>({ fieldId, pill, selected, onTogglePill, onClearField, onOpenChange, testIdPrefix, layout, }: PillControlProps<T>): React.JSX.Element;
+export {};
+//# sourceMappingURL=data-views-category-pill.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-category-pill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-category-pill.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-category-pill.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAgB,MAAM,oBAAoB,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GACvE,IAAI,CASN;AASD,UAAU,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACzE,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC7B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC7D,OAAO,EACP,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,MAAe,GAChB,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+BzC"}

package/dist/types/components/data-display/DataViews/data-views-columns-tab.d.ts

@@ -0,0 +1,21 @@
+import type { HideableColumn } from "./data-views-columns";
+interface ColumnsTabProps {
+    columns: HideableColumn[];
+    /** Every column id in the CURRENT order (including non-hideable ones). */
+    order: string[];
+    visibleColumns: string[];
+    onToggle: (id: string, visible: boolean) => void;
+    onReorder: (order: string[]) => void;
+    onShowAll: () => void;
+    onReset: () => void;
+    testIdPrefix: string;
+}
+/**
+ * Visibility AND order in one list, because they are the same decision: an
+ * operator reordering columns is deciding what to read first, and hiding one is
+ * deciding not to read it at all. Drag the grip, or use the arrows — the arrows
+ * exist because drag-and-drop is unusable by keyboard and awkward on a phone.
+ */
+export declare function ColumnsTab({ columns, order, visibleColumns, onToggle, onReorder, onShowAll, onReset, testIdPrefix, }: ColumnsTabProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=data-views-columns-tab.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-columns-tab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-columns-tab.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-columns-tab.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,UAAU,eAAe;IACvB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,0EAA0E;IAC1E,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACjD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACrC,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,KAAK,EACL,cAAc,EACd,QAAQ,EACR,SAAS,EACT,SAAS,EACT,OAAO,EACP,YAAY,GACb,EAAE,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqDrC"}

package/dist/types/components/data-display/DataViews/data-views-columns.d.ts

@@ -0,0 +1,36 @@
+import { type GridColumn } from "../DataGrid";
+import type { DataViewColumn, RowAction } from "./data-views-types";
+/**
+ * Every column derivation the DataViews grid needs, in one place: the auto kebab
+ * actions column, the id list that seeds a pristine view state, what the grid
+ * actually renders once visibility is applied, and the show/hide menu's list.
+ */
+/** A column the user may show/hide via the toolbar's ColumnsMenu. */
+export interface HideableColumn {
+    id: string;
+    label: string;
+}
+/** Options {@link appendActionsColumn} needs to build the auto kebab column. */
+type ActionsColumnOpts<T extends Record<string, unknown>> = {
+    rowActions?: RowAction<T>[];
+    rowActionsLeading?: (row: T) => React.ReactNode;
+    renderRowMenu?: (row: T) => React.ReactNode;
+    testIdPrefix: string;
+    getRowId: (row: T) => string | number;
+};
+/**
+ * The declared columns plus the auto kebab column (unless the page defines its
+ * own), and every column id — which is what seeds a pristine view state's
+ * `visibleColumns`, so it is derived BEFORE the state exists.
+ */
+export declare function useColumnsWithActions<T extends Record<string, unknown>>(columns: DataViewColumn<T>[], opts: ActionsColumnOpts<T>): {
+    columnsWithActions: DataViewColumn<T>[];
+    allColumnIds: string[];
+};
+/** What the grid actually renders: order + visibility applied, plus the menu's list. */
+export declare function useRenderedColumns<T extends Record<string, unknown>>(columnsWithActions: DataViewColumn<T>[], visibleColumns: string[], onRowClick: ((row: T) => void) | undefined, order?: string[]): {
+    gridColumns: GridColumn<T>[];
+    hideableColumns: HideableColumn[];
+};
+export {};
+//# sourceMappingURL=data-views-columns.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-columns.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-columns.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAO9C,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpE;;;;GAIG;AAEH,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AA4CD,gFAAgF;AAChF,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC1D,UAAU,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAChD,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,KAAK,CAAC,SAAS,CAAC;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC;CACvC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EAC5B,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACzB;IAAE,kBAAkB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAAC,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CASrE;AAqBD,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,kBAAkB,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,EACvC,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,EAC1C,KAAK,CAAC,EAAE,MAAM,EAAE,GACf;IAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IAAC,eAAe,EAAE,cAAc,EAAE,CAAA;CAAE,CAOrE"}

package/dist/types/components/data-display/DataViews/data-views-day-input.d.ts

@@ -0,0 +1,41 @@
+import React from 'react';
+/** `AAAA-MM-DD` (the wire) → `dd/mm/aaaa` (what the merchant reads). */
+export declare function isoToBr(iso: string): string;
+/**
+ * `dd/mm/aaaa` → `AAAA-MM-DD`, but ONLY for a day that exists. `31/02/2026`
+ * parses fine as three numbers and is not a date, and `Date` would silently
+ * roll it into March rather than reject it — so the round trip through UTC is
+ * the check: if the month or day comes back changed, the input was not a day.
+ */
+export declare function brToIso(text: string): string;
+/**
+ * Digits only, capped at eight, with the separators put back as you type.
+ *
+ * Deriving the whole string from the digits — rather than editing the text in
+ * place — is what makes backspace behave. Four digits render as `06/08`, not
+ * `06/08/`, so deleting the first digit of the year removes the trailing
+ * separator with it instead of leaving a dead keystroke that changes nothing.
+ */
+export declare function maskBrDate(raw: string): string;
+/**
+ * One end of a day window. The BOUND stays `AAAA-MM-DD` — the form the backend's
+ * inclusive day comparison already speaks, and the form the chip label reads —
+ * so only the typing surface changes.
+ */
+export declare function DayBoundInput({ label, value, onChange, testId, error, describedBy, }: {
+    label: string;
+    /** The applied bound, `AAAA-MM-DD`, or undefined when this end is open. */
+    value: string | undefined;
+    onChange: (bound: string | undefined) => void;
+    testId: string;
+    /**
+     * Paint the field as rejected. It only ever writes a real day by itself, so
+     * this is for a caller judging the PAIR: a window whose end precedes its
+     * start is two valid days and one impossible period, and the field it was
+     * typed into is the only place to say which half is being complained about.
+     */
+    error?: boolean;
+    /** Id of the element carrying that complaint, so it is read WITH the field. */
+    describedBy?: string;
+}): React.JSX.Element;
+//# sourceMappingURL=data-views-day-input.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-day-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-day-input.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-day-input.tsx"],"names":[],"mappings":"AA8BA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAEnD,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK9C;AAgCD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,KAAa,EACb,WAAW,GACZ,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2CpB"}

package/dist/types/components/data-display/DataViews/data-views-dirty.d.ts

@@ -0,0 +1,10 @@
+import type { DataViewState } from "./data-views-types";
+/**
+ * Everything a saved view stores, in a stable shape.
+ *
+ * `visibleColumns` is SORTED — it is a set, and its array order carries no
+ * meaning (reading order lives in `order`). `order` is not sorted, for the
+ * opposite reason.
+ */
+export declare function viewStateKey(state: DataViewState): string;
+//# sourceMappingURL=data-views-dirty.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-dirty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-dirty.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-dirty.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,oBAAoB,CAAC;AA2CpE;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAWzD"}

package/dist/types/components/data-display/DataViews/data-views-display-panel.d.ts

@@ -0,0 +1,38 @@
+import { type ViewNavHandlers } from "./data-views-view-nav";
+import type { DataViewsController } from "./use-data-views-state";
+/** The saved-view chrome the panel brackets its tabs with, when a host supplies it. */
+export interface DisplayPanelView {
+    /** The applied view's name, or undefined for the built-in "Visão principal". */
+    activeViewName?: string;
+    /** True when the live state differs from the applied view (or from pristine). */
+    dirty: boolean;
+    /** Restore the applied view (or the pristine default) — discards local changes. */
+    onReset: () => void;
+    /** Persist the live state over the applied view. Absent ⇒ no update affordance. */
+    onUpdate?: () => void;
+    /** Persist the live state as a NEW view. */
+    onSaveAs: () => void;
+    /**
+     * The saved views themselves, rendered INLINE in this panel's body when the
+     * VISÃO header is opened — not as a dropdown of their own. The panel stays
+     * data-free: the host owns the views and every mutation, this only decides
+     * where they appear.
+     */
+    nav?: ViewNavHandlers;
+}
+interface DisplayPanelProps<T extends Record<string, unknown>> {
+    c: DataViewsController<T>;
+    testIdPrefix: string;
+    /** Per-sort-field value kind, so directions read in the column's own terms. */
+    sortKinds?: Record<string, string>;
+    view?: DisplayPanelView;
+    /** Icon only — step 2 of the toolbar's measured degradation ladder. */
+    compact?: boolean;
+}
+/**
+ * The toolbar's "Exibir" control: one button, one popover, three tabs, and the
+ * view bracketing all of it.
+ */
+export declare function DataViewsDisplayPanel<T extends Record<string, unknown>>({ c, testIdPrefix, sortKinds, view, compact, }: DisplayPanelProps<T>): React.JSX.Element;
+export {};
+//# sourceMappingURL=data-views-display-panel.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-display-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-display-panel.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-display-panel.tsx"],"names":[],"mappings":"AAaA,OAAO,EAKL,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAyBlE,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,KAAK,EAAE,OAAO,CAAC;IACf,mFAAmF;IACnF,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,eAAe,CAAC;CACvB;AAED,UAAU,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAsND;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EACvE,CAAC,EACD,YAAY,EACZ,SAAS,EACT,IAAI,EACJ,OAAO,GACR,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAuD1C"}

package/dist/types/components/data-display/DataViews/data-views-display-tabs.d.ts

@@ -0,0 +1,17 @@
+import type { SortFieldDefinition } from "../../layout/ContentToolbar";
+interface SortTabProps {
+    fields: SortFieldDefinition[];
+    activeField: string;
+    activeOrder: "asc" | "desc";
+    onChange: (field: string, order: "asc" | "desc") => void;
+    /** Per-field value kind, so the direction can be phrased in its own terms. */
+    sortKinds?: Record<string, string>;
+    testIdPrefix: string;
+}
+/** Direction first (two tiles), then the field list — the order they are decided in. */
+export declare function SortTab({ fields, activeField, activeOrder, onChange, sortKinds, testIdPrefix, }: SortTabProps): React.JSX.Element;
+export declare function DisplayTab({ testIdPrefix }: {
+    testIdPrefix: string;
+}): React.JSX.Element;
+export {};
+//# sourceMappingURL=data-views-display-tabs.d.ts.map

package/dist/types/components/data-display/DataViews/data-views-display-tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-display-tabs.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-display-tabs.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAiGvE,UAAU,YAAY;IACpB,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;IAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,KAAK,IAAI,CAAC;IACzD,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wFAAwF;AACxF,wBAAgB,OAAO,CAAC,EACtB,MAAM,EACN,WAAW,EACX,WAAW,EACX,QAAQ,EACR,SAAS,EACT,YAAY,GACb,EAAE,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0ClC;AAkKD,wBAAgB,UAAU,CAAC,EAAE,YAAY,EAAE,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2DxF"}