@12-apps/ui 5.0.0 → 5.1.0

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

@@ -0,0 +1,299 @@
+import type { GridColumn, GridSort } from "../DataGrid";
+import type { DropdownMenuItem } from "../../navigation/DropdownMenu";
+import type { RangeValue } from "./data-views-range-types";
+/**
+ * Shared types for the reusable admin "DataViews" table (FUT-88): a filter bar
+ * (search-across-all + typed multi-select pills + column visibility) whose full
+ * state — filters + sort + visible columns — a saved view (FUT-89) can capture
+ * and restore. Each table declares its own columns + filter fields.
+ */
+/**
+ * A single, reusable row action. ONE definition drives BOTH the per-row "⋮"
+ * kebab menu and the bulk-actions menu (tabwoah model): `onSelect` receives the
+ * affected rows — `[row]` from a kebab, the whole selection from the bulk menu.
+ * Single-item-only actions (e.g. "Editar") set `bulk: false` so they never
+ * appear in the bulk menu.
+ */
+export interface RowAction<T extends Record<string, unknown>> {
+    /** Stable id (also the `data-testid` suffix). */
+    id: string;
+    /** Menu label. In the kebab, `rowLabel` overrides it per row when provided. */
+    label: string;
+    /** Menu-item colour (e.g. `"error"` for destructive). */
+    color?: DropdownMenuItem["color"];
+    /**
+     * Runs on the affected rows: `[row]` from the kebab, all selected from bulk.
+     * May be async — the bulk menu awaits it and only clears the selection once it
+     * settles (keeping the selection on failure so the user can retry).
+     */
+    onSelect: (rows: T[]) => void | Promise<void>;
+    /** Include in the bulk menu (2+ selected). Defaults to `true`. */
+    bulk?: boolean;
+    /** Include in the per-row kebab. Defaults to `true`. */
+    row?: boolean;
+    /** Per-row kebab label (e.g. `row.active ? "Inativar" : "Ativar"`). */
+    rowLabel?: (row: T) => string;
+    /**
+     * Per-row applicability (e.g. state-machine guards). `false` hides the
+     * kebab item for that row; in bulk the action runs only on the passing
+     * rows and is dropped when none pass. Defaults to applicable.
+     */
+    isVisible?: (row: T) => boolean;
+}
+/** Selection state handed to a card renderer so it can drive its own checkbox. */
+export interface DataViewCardSelection {
+    selected: boolean;
+    onToggleSelect: () => void;
+    /**
+     * Card SIZE multiplier from the toolbar zoom slider. The grid sizes the card's
+     * width to `base × scale`; a card passes this to {@link BaseCard} `scale` so its
+     * padding + typography grow by the same factor — the whole card scales together
+     * (scale 2 → ~2× size). The proportion (aspect ratio) stays constant.
+     */
+    scale: number;
+}
+/**
+ * The fixed proportions a {@link BaseCard} tile can take. The tile keeps this
+ * ratio and grows in BOTH width and height as the zoom slider widens its grid
+ * track, so a grid of cards stays visually uniform.
+ */
+export type CardAspectRatio = "1:1" | "4:3" | "16:9" | "9:16" | "3:4" | "3:1";
+/** Numeric width/height factor for each {@link CardAspectRatio} (CSS `aspect-ratio`). */
+export declare const CARD_ASPECT_RATIOS: Record<CardAspectRatio, number>;
+/** One selectable value inside a filter pill. */
+export interface FilterOption {
+    value: string;
+    label: string;
+    /**
+     * Parent option's `value`, for a hierarchical field (`control: "category"`).
+     * Ignored by the flat controls, so one option list serves both.
+     */
+    parentId?: string | null;
+}
+/** A typed, multi-select filter pill's configuration for a table. */
+export interface FilterFieldConfig<T extends Record<string, unknown>> {
+    /** Stable id; also the default row key when no `accessor` is given. */
+    id: string;
+    label: string;
+    options: FilterOption[];
+    /**
+     * How the field renders in the filter panel. `checkboxes` (default) is best for
+     * a few fixed options; `multiselect` is a compact dropdown for long option
+     * lists; `category` is the hierarchical picker, for an option set that nests
+     * via {@link FilterOption.parentId} — it renders parents as headings and
+     * their children as the selectable rows, rather than flattening the tree into
+     * one indistinguishable list.
+     */
+    control?: "checkboxes" | "multiselect" | "category";
+    /**
+     * Forces this filter to render as a searchable multi-select dropdown with the
+     * search box always shown, regardless of how many options are currently
+     * loaded. Use it when the option set can grow unbounded (e.g. a filter backed
+     * by a relation such as Roles or Categories). Omit it for a closed value set
+     * (an enum), which keeps the plain checkbox / "search only when long"
+     * behavior.
+     */
+    searchEnabled?: boolean;
+    /**
+     * Reads the row's value(s) for this field. A row matches the pill when any of
+     * its values is selected. Defaults to `String(row[id])`.
+     */
+    accessor?: (row: T) => string | string[];
+}
+/**
+ * The range types live in `data-views-range-types` (this file outgrew the
+ * size gate); they are re-exported here so `data-views-types` stays the one
+ * name every consumer imports the model from.
+ */
+export type { DayRangeFieldConfig, NumberRangeFieldConfig, RangeFieldConfig, RangeFieldKind, RangePreset, RangeValue, } from "./data-views-range-types";
+/** A grid column that can join the search scan and the column-visibility menu. */
+export interface DataViewColumn<T extends Record<string, unknown>> extends GridColumn<T> {
+    /** Included in "search across all columns" (needs a resolvable value). */
+    searchable?: boolean;
+    /** Toggleable in the column-visibility menu. Defaults to true; set false for
+     *  structural columns (image thumbnail, actions kebab) that must always show. */
+    hideable?: boolean;
+}
+/**
+ * The DataViews layout (view type): the dense "Tabela" grid, the "Grade" of
+ * cards, the "Lista" of full-width rows, or the "Quadro" board of state columns.
+ * Lives with the state types rather than with the toggle because a saved view
+ * CAPTURES it — see {@link DataViewState.layout}.
+ */
+export type DataViewsLayout = "cards" | "list" | "board" | "table";
+/** The full, serializable state a view captures. */
+export interface DataViewState {
+    /** Free text matched across every `searchable` column. */
+    search: string;
+    /** fieldId → selected option values (empty/absent = no constraint). */
+    pills: Record<string, string[]>;
+    /** fieldId → selected numeric range (min/max). Absent/empty = no constraint. */
+    ranges?: Record<string, RangeValue>;
+    sortBy: GridSort[];
+    /** Column ids kept visible; a hideable column not listed here is hidden. */
+    visibleColumns: string[];
+    /**
+     * Column ids in READING ORDER. Absent ⇒ the order the table declared them in.
+     *
+     * Order is view state for the same reason visibility is: reordering columns is
+     * an operator deciding what to read FIRST, and a saved view that restored the
+     * columns but not their order would restore half a decision. Ids the table no
+     * longer declares are ignored at render, and ids missing from a stale list
+     * fall in after it — so a column added since the view was saved appears rather
+     * than disappearing.
+     */
+    order?: string[];
+    /**
+     * The active SCOPE id — the page-level partition the scope tabs select (see
+     * `ScopeConfig`). Optional, so a table that declares no scopes is untouched
+     * and no view persisted before scopes existed breaks.
+     *
+     * Stored raw and RESOLVED at read time: the declared scopes change underneath
+     * a saved view, and a view naming a scope that has since been removed must
+     * fall back at render rather than break.
+     */
+    scope?: string;
+    /**
+     * The layout the view was saved in. Optional — absent means "whatever the user
+     * is currently using", which is the pre-existing behaviour.
+     *
+     * A LAYOUT FALLBACK IS NOT A LAYOUT CHANGE: a table rendered as stacked rows
+     * on a phone still has `"table"` stored here, so the view round-trips the
+     * stored layout regardless of the device that opened it.
+     */
+    layout?: DataViewsLayout;
+}
+/** A pristine view state showing every given column and no filters/sort. */
+export declare function emptyViewState(visibleColumns: string[]): DataViewState;
+/**
+ * The URL-driven slice of {@link DataViewState} — the controls a server-mode host
+ * mirrors from the address bar (search / pills / ranges / sort), WITHOUT
+ * `visibleColumns`. Supplying it re-applies those controls when its reference
+ * changes (e.g. browser back/forward or a deep-link on the same route), merging
+ * over the current state so a user's show/hide column choices are preserved —
+ * unlike `appliedState`, which fully replaces the state to apply a saved view.
+ */
+export type DataViewSyncState = Pick<DataViewState, "search" | "pills" | "ranges" | "sortBy" | "scope">;
+/**
+ * The query a SERVER-mode table emits whenever its filter/sort/page changes
+ * (FUT-180). The host translates this into a backend request (see
+ * `@12-apps/shared-helpers/search`) — in server mode the grid never filters,
+ * sorts, or paginates in the browser; it renders exactly the page the server
+ * returned. `page` is 1-based to match the backend contract.
+ */
+export interface DataViewQuery {
+    search: string;
+    pills: Record<string, string[]>;
+    ranges: Record<string, RangeValue>;
+    sortBy: GridSort[];
+    /**
+     * The RESOLVED active scope (see `resolveScope`), when the table declares
+     * scopes. The KEY IS ABSENT for a table that declares none — not present-and-
+     * undefined — so a host that never opted in sees a byte-identical query.
+     *
+     * It carries the resolved id, never the stored one: a deep link or a saved
+     * view naming a scope the table no longer declares must not put that id on the
+     * wire, where the backend would reject it and replace the page with an error.
+     */
+    scope?: string;
+    page: number;
+    pageSize: number;
+}
+/**
+ * Server-mode wiring for a DataViews table. Its PRESENCE flips the table from
+ * in-browser filtering/sorting/pagination to backend-driven: the rows handed in
+ * are already the current page, `totalCount` is the unpaginated total, and
+ * `onQueryChange` fires (search debounced by the host) whenever the user changes
+ * a filter, the sort, or the page. This is the ONLY way an admin list should run
+ * (see the app-side `DataViewsTable` wrapper, which requires it).
+ */
+export interface DataViewServer {
+    /** Total matched rows across all pages (drives the counter + page count). */
+    totalCount: number;
+    /** Current 1-based page. */
+    page: number;
+    /** Rows per page. */
+    pageSize: number;
+    /** Fired when the effective query changes; the host re-fetches the page. */
+    onQueryChange: (query: DataViewQuery) => void;
+    /**
+     * Per-scope totals for the scope tabs: `scopeId → count`. THE ONLY PIECE OF
+     * THIS CONTRACT THAT CANNOT BE DONE CLIENT-SIDE — a count computed from the
+     * loaded page is wrong the moment there is a second page, which is the
+     * concrete bug scopes exist to fix.
+     *
+     * Compute it over search + pills + ranges while IGNORING the active scope.
+     * Computed WITH the scope applied, every inactive tab reads zero, which is
+     * worse than no counts at all.
+     *
+     * Omit it and the tabs render with no numbers. Nothing is ever invented from
+     * the loaded rows to fill the gap.
+     */
+    scopeCounts?: Record<string, number>;
+}
+/**
+ * Coerce an opaque persisted state (a saved view's JSON) into a valid
+ * DataViewState, filling any missing part with a sane default. Guards against
+ * legacy/older shapes so applying a saved view never renders an empty grid.
+ */
+export declare function coerceViewState(raw: unknown, allColumnIds: string[]): DataViewState;
+/** Every layout this build knows how to render — the guard's single source. */
+export declare const DATA_VIEWS_LAYOUTS: readonly DataViewsLayout[];
+/** A saved view as consumed by the DataViews UI (FUT-89), with ownership flag. */
+export interface SavedViewSummary {
+    id: string;
+    name: string;
+    description: string | null;
+    state: DataViewState;
+    shared: boolean;
+    pinned: boolean;
+    isDefault: boolean;
+    /** True when the current user owns the view (may edit/delete/pin/share it). */
+    isOwner: boolean;
+}
+/** A saved-view repository record (opaque `state`), as returned to server pages. */
+interface SavedViewRecordLike {
+    id: string;
+    name: string;
+    description: string | null;
+    state: unknown;
+    shared: boolean;
+    pinned: boolean;
+    isDefault: boolean;
+    isOwner: boolean;
+}
+/** Map a repository record to the client summary (opaque state → DataViewState). */
+export declare function toSavedViewSummary(record: SavedViewRecordLike): SavedViewSummary;
+/**
+ * Dependency-injection contracts for the framework-agnostic DataViewsTableBase:
+ * the host app supplies saved-view persistence + router side-effects so the ui
+ * component imports neither a backend (server actions) nor a framework router.
+ */
+/** A saved view's editable fields, as the host persists them. */
+export interface DataViewSaveInput {
+    name: string;
+    description: string;
+    state: DataViewState;
+    shared: boolean;
+    pinned: boolean;
+    isDefault: boolean;
+}
+/** Result of a persistence call — mirrors the app's `Result` without importing it. */
+export type DataViewMutationResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+/** Injected saved-view persistence (create/update/delete), wired by the host. */
+export interface DataViewPersistence {
+    create: (input: DataViewSaveInput) => Promise<DataViewMutationResult>;
+    update: (id: string, input: DataViewSaveInput) => Promise<DataViewMutationResult>;
+    remove: (id: string) => Promise<DataViewMutationResult>;
+}
+/** Injected router side-effects: sync the `?view=` param and re-fetch on change. */
+export interface DataViewRouter {
+    syncViewParam: (viewId: string | null) => void;
+    refresh: () => void;
+}
+//# sourceMappingURL=data-views-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-types.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-types.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+import type { MutableRefObject } from "react";
+import type { DataViewPersistence, DataViewState, SavedViewSummary } from "./data-views-types";
+import { type SaveViewPayload } from "./SaveViewModal";
+export interface ViewMutations {
+    handleSave: (payload: SaveViewPayload) => Promise<void>;
+    patchView: (view: SavedViewSummary, changes: Partial<Pick<SavedViewSummary, "isDefault" | "pinned" | "shared">>) => Promise<void>;
+    handleDelete: (view: SavedViewSummary) => Promise<void>;
+}
+/** The SavedView persistence handlers (create/update/delete), via injected `persistence`. */
+export declare function useViewMutations(persistence: DataViewPersistence, editing: SavedViewSummary | null, currentRef: MutableRefObject<DataViewState>, onDone: (ok: boolean, error?: string) => void): ViewMutations;
+//# sourceMappingURL=data-views-view-mutations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-view-mutations.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-view-mutations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAE9C,OAAO,KAAK,EACV,mBAAmB,EAEnB,aAAa,EACb,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,SAAS,EAAE,CACT,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,KACxE,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,YAAY,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,mBAAmB,EAChC,OAAO,EAAE,gBAAgB,GAAG,IAAI,EAChC,UAAU,EAAE,gBAAgB,CAAC,aAAa,CAAC,EAC3C,MAAM,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,GAC5C,aAAa,CAwCf"}

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

@@ -0,0 +1,39 @@
+import type { DisplayPanelView } from "./data-views-display-panel";
+import type { SavedViewSummary } from "./data-views-types";
+/** What the panel needs to drive the views without owning any of them. */
+export interface ViewNavHandlers {
+    views: SavedViewSummary[];
+    activeViewId?: string | null;
+    /** `null` selects the built-in "Visão principal". */
+    onSelectView: (id: string | null) => void;
+    onEditView: (view: SavedViewSummary) => void;
+    onPatchView: (view: SavedViewSummary, changes: Partial<Pick<SavedViewSummary, "isDefault" | "pinned" | "shared">>) => void;
+    onDeleteView: (view: SavedViewSummary) => void;
+}
+/** The list: the built-in view, then each saved one with its own "⋮". */
+export declare function ViewsList({ handlers, onOpenActions, testIdPrefix, }: {
+    handlers: ViewNavHandlers;
+    onOpenActions: (view: SavedViewSummary) => void;
+    testIdPrefix: string;
+}): React.JSX.Element;
+/** One view's actions, reached from its "⋮" and left by the back row. */
+export declare function ViewActions({ view, handlers, onBack, testIdPrefix, }: {
+    view: SavedViewSummary;
+    handlers: ViewNavHandlers;
+    onBack: () => void;
+    testIdPrefix: string;
+}): React.JSX.Element;
+/** The VISÃO row above the tabs. */
+export declare function ViewHeader(props: {
+    view: DisplayPanelView;
+    open: boolean;
+    onToggle: () => void;
+    testIdPrefix: string;
+}): React.JSX.Element;
+/** Redefinir / Salvar como nova / Atualizar, pinned below the tabs. */
+export declare function ViewFooter({ view, onDone, testIdPrefix, }: {
+    view: DisplayPanelView;
+    onDone: () => void;
+    testIdPrefix: string;
+}): React.JSX.Element;
+//# sourceMappingURL=data-views-view-nav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-views-view-nav.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/data-views-view-nav.tsx"],"names":[],"mappings":"AA+BA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,0EAA0E;AAC1E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qDAAqD;IACrD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC1C,UAAU,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC7C,WAAW,EAAE,CACX,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAC,KACxE,IAAI,CAAC;IACV,YAAY,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;CAChD;AAoBD,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,aAAa,EACb,YAAY,GACb,EAAE;IACD,QAAQ,EAAE,eAAe,CAAC;IAC1B,aAAa,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAChD,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAkEpB;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,YAAY,GACb,EAAE;IACD,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,eAAe,CAAC;IAC1B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAmDpB;AAiFD,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,KAAK,EAAE;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAWpB;AAED,uEAAuE;AACvE,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,MAAM,EACN,YAAY,GACb,EAAE;IACD,IAAI,EAAE,gBAAgB,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA8DpB"}

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

@@ -0,0 +1,23 @@
+/**
+ * DataViews — the reusable admin table/grid machinery (FUT-88/89): a filter bar,
+ * saved views, sort, column visibility, select-all + bulk actions, and an opt-in
+ * "Grade" (cards) layout. Framework-agnostic: {@link DataViewsTableBase} takes its
+ * saved-view persistence + router side-effects as injected props, so a host app
+ * wires them to its backend and framework router.
+ */
+export { BaseCard } from "./base-card";
+export { BaseListCard, type BaseListCardProps } from "./base-list-card";
+export { ListCardGroup, DEFAULT_RAILS, RAIL_COUNT, type ListRails, } from "./list-card-rails";
+export { type ListCardCellConfig, DEFAULT_CELL_WIDTH, } from "./list-card-cells";
+export type { ListGroupConfig } from "./list-card-rails";
+export { DropIndicator } from "./data-views-drag";
+export { DragContainerProvider, useDragItem, type DragContainerValue, type DragItemProps, } from "./data-views-drag";
+export { DataViewsGrid } from "./DataViewsGrid";
+export { DataViewsTableBase, type DataViewsTableBaseProps } from "./DataViewsTableBase";
+export { toSavedViewSummary, CARD_ASPECT_RATIOS, DATA_VIEWS_LAYOUTS } from "./data-views-types";
+export { cardScaleForZoom, cardMinWidthForZoom } from "./data-views-layout-context";
+export { DataViewsBoard, type BoardConfig, type BoardGroup } from "./DataViewsBoard";
+export type { DataViewExport, DataViewExportFormat, DataViewExportRequest, } from "./data-views-export";
+export { DataViewsScopeTabs, resolveScope, assertNoScopePillOverlap, type ScopeConfig, } from "./data-views-scopes";
+export type { RowAction, DataViewCardSelection, CardAspectRatio, SavedViewSummary, DataViewState, DataViewSyncState, DataViewsLayout, DataViewColumn, FilterFieldConfig, RangeFieldConfig, RangeFieldKind, RangeValue, RangePreset, NumberRangeFieldConfig, DayRangeFieldConfig, DataViewPersistence, DataViewRouter, DataViewSaveInput, DataViewMutationResult, DataViewQuery, DataViewServer, } from "./data-views-types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMxE,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,KAAK,SAAS,GACf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,kBAAkB,EACvB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAI3B,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EACL,qBAAqB,EACrB,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACrF,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,wBAAwB,EACxB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,cAAc,GACf,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,64 @@
+import { type ReactNode } from "react";
+/**
+ * THE CELL CONFIG — the list declares its columns once, every row obeys them.
+ *
+ * The row used to name its middle slots: a title, a subtitle beneath it, then
+ * labelled `meta` pairs, then a value, then a status. That vocabulary was the
+ * mistake twice over. It reads as a description of every list, and no list is
+ * quite that shape — so a consumer wanting a date over a time, or an order
+ * number over the client who placed it, had to pick whichever named slot was
+ * least wrong and take its styling with it. And because each row decided its own
+ * content, alignment across a list was a convention the rows could break.
+ *
+ * So cells are CONFIGURED, the way a data grid's columns are: the list declares
+ * them once, and every card renders the same columns in the same tracks from its
+ * own row. Two cards cannot disagree about the shape of the list, because
+ * neither of them is deciding it.
+ *
+ * THE SECOND LINE IS AN OPTION, NOT A SUBTITLE. `secondary` is not "the small
+ * grey text under the title" — it is the cell's second line, for whatever pairs
+ * naturally in this list: date over time, name over e-mail, pedido over cliente.
+ * It carries no meaning the config did not put there, and a cell that wants one
+ * line simply omits it.
+ */
+export interface ListCardCellConfig<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** Stable key. Also the cell's `data-slot`, so a test can find it by name. */
+    id: string;
+    /** The cell's first line, from the row. */
+    primary: (row: T) => ReactNode;
+    /** An optional second line beneath it. Anything that pairs with the first. */
+    secondary?: (row: T) => ReactNode;
+    /**
+     * Which edge the lines sit on. `end` is what a column of numbers wants, so its
+     * digits line up with the values above and below it — and it switches the cell
+     * to tabular figures, since nothing else ever asks for that alignment.
+     */
+    align?: "start" | "center" | "end";
+    /**
+     * This cell's track, as a `grid-template-columns` entry. Defaults to an even
+     * share of the spare width.
+     *
+     * A cell holding a number usually wants `max-content`: the rail is then as
+     * wide as the widest amount in the list and no wider, and its right edge does
+     * not move when a longer row arrives.
+     */
+    width?: string;
+    /** Emphasise the first line — for the one figure the row is really about. */
+    strong?: boolean;
+}
+/** The default track: an even share of whatever width the row has spare. */
+export declare const DEFAULT_CELL_WIDTH = "minmax(0, 1fr)";
+/** The tracks a cell config asks for, in order. */
+export declare function cellTracks(cells: readonly ListCardCellConfig<never>[] | undefined): string[];
+export declare function CellConfigProvider({ cells, children, }: {
+    cells: readonly ListCardCellConfig<never>[] | undefined;
+    children: ReactNode;
+}): React.JSX.Element;
+/** The list's cell config, if it declared one. */
+export declare function useCellConfig(): readonly ListCardCellConfig<never>[] | null;
+/** Every configured cell of a row, in the list's declared order. */
+export declare function ListCardCells<T extends Record<string, unknown>>({ cells, row, }: {
+    cells: readonly ListCardCellConfig<T>[];
+    row: T;
+}): React.JSX.Element;
+//# sourceMappingURL=list-card-cells.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"list-card-cells.d.ts","sourceRoot":"","sources":["../../../../../src/components/data-display/DataViews/list-card-cells.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlE;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7F,8EAA8E;IAC9E,EAAE,EAAE,MAAM,CAAC;IACX,2CAA2C;IAC3C,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC;IAC/B,8EAA8E;IAC9E,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,SAAS,CAAC;IAClC;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAKD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAE5F;AAWD,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,SAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,SAAS,CAAC;IACxD,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAEpB;AAED,kDAAkD;AAClD,wBAAgB,aAAa,IAAI,SAAS,kBAAkB,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAE3E;AAyDD,oEAAoE;AACpE,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/D,KAAK,EACL,GAAG,GACJ,EAAE;IACD,KAAK,EAAE,SAAS,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC;CACR,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAQpB"}