@foris/avocado-not-front 7.0.0 → 8.0.0

package/dist/avocado-not-front/src/components/pill/Pill.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/avocado-not-front/src/components/table/Table.d.ts

@@ -7,5 +7,5 @@ interface TableNotFrontExtendedProps extends TableNotFrontProps {
     userFlow: string;
     pageId: string;
 }
-declare const TableNotFront: ({ userFlow, pageId, responseKey, component, dataSource, rightActions, data: inlineData, pageSize, ...tableProps }: TableNotFrontExtendedProps) => import("react/jsx-runtime").JSX.Element;
+declare const TableNotFront: ({ userFlow, pageId, responseKey, component, dataSource, rightActions, data: inlineData, pageSize, showRowsPerPage, pageSizeOptions, labelRowsPerPage, autoHeight, ...tableProps }: TableNotFrontExtendedProps) => import("react/jsx-runtime").JSX.Element;
 export default TableNotFront;

package/dist/avocado-not-front/src/components/table/Table.viewport.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/avocado-not-front/src/components/table/table.constants.d.ts

@@ -0,0 +1,17 @@
+export declare const DEFAULT_TABLE_PAGE_SIZE = 10;
+export declare const DEFAULT_TABLE_PAGE_SIZE_OPTIONS: number[];
+/** Space reserved below the table for the offset pager (nav + rows-per-page row). */
+export declare const PAGER_RESERVED_HEIGHT = 72;
+/** Minimum scroll container height when the table sits low on the page. */
+export declare const MIN_TABLE_HEIGHT = 120;
+/**
+ * Resolves the initial rows-per-page value from JSON config and selectable options.
+ *
+ * Uses `pageSize` when it is listed in `pageSizeOptions`; otherwise falls back to
+ * the first option, or {@link DEFAULT_TABLE_PAGE_SIZE} when options are empty.
+ *
+ * @param pageSize - Optional page size from table JSON config.
+ * @param pageSizeOptions - Allowed values for the rows-per-page selector.
+ * @returns The page size used for the first fetch and pager display.
+ */
+export declare const resolveInitialPageSize: (pageSize: number | undefined, pageSizeOptions: number[]) => number;

package/dist/avocado-not-front/src/components/table/table.constants.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/avocado-not-front/src/components/table/tableAvailableHeight.util.d.ts

@@ -0,0 +1,12 @@
+type ComputeAvailableHeightArgs = {
+    viewportHeight: number;
+    elementTop: number;
+    pagerReservedHeight?: number;
+    minTableHeight?: number;
+};
+/**
+ * Computes how much vertical space the table scroll container can use so the
+ * pager stays within the viewport.
+ */
+export declare const computeAvailableHeight: ({ viewportHeight, elementTop, pagerReservedHeight, minTableHeight, }: ComputeAvailableHeightArgs) => number;
+export {};

package/dist/avocado-not-front/src/components/table/tableScroll.util.d.ts

@@ -0,0 +1,20 @@
+export type TableScrollLayout = {
+    maxHeight?: string | number;
+    stickyHeader: boolean;
+};
+type ResolveTableScrollLayoutArgs = {
+    maxHeight?: string | number;
+    stickyHeader?: boolean;
+    autoFitToViewport: boolean;
+    availableHeight?: number;
+};
+/**
+ * Resolves table scroll layout for EntityHub-style tables.
+ *
+ * David T.'s criterion: cap the table at the viewport space below it so the
+ * pager stays on screen. The suite scroll container grows with content up to
+ * that cap; overflow triggers internal scroll and the sticky header keeps
+ * column labels visible. Independent of rows-per-page (`autoFitToViewport`).
+ */
+export declare const resolveTableScrollLayout: ({ maxHeight, stickyHeader, autoFitToViewport, availableHeight, }: ResolveTableScrollLayoutArgs) => TableScrollLayout;
+export {};

package/dist/avocado-not-front/src/components/table/tableScroll.util.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/avocado-not-front/src/components/table/useAvailableHeight.d.ts

@@ -0,0 +1,17 @@
+type UseAvailableHeightArgs = {
+    enabled: boolean;
+};
+/**
+ * Measures the vertical space available for the table scroll container.
+ *
+ * EntityHub pages are JSON-driven and the table cannot assume a flex parent.
+ * David T.'s criterion: the table must not grow past the viewport — the pager
+ * stays visible and overflow scrolls inside the table. We measure from the
+ * container top to the viewport bottom, reserving {@link PAGER_RESERVED_HEIGHT}
+ * for the pager below. Recalculates on resize and layout changes, not scroll.
+ */
+export declare const useAvailableHeight: ({ enabled }: UseAvailableHeightArgs) => {
+    tableContainerRef: import("react").Dispatch<import("react").SetStateAction<HTMLDivElement | null>>;
+    availableHeight: number | undefined;
+};
+export {};

package/dist/avocado-not-front/src/components/table/useAvailableHeight.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/avocado-not-front/src/types/components.type.d.ts

@@ -399,8 +399,8 @@ export interface PillNotFrontProps extends NotFrontBaseProps, Omit<PillProps, 'c
     content: string;
     /**
      * Visual variant that applies predefined color schemes.
-     * Automatically sets color, textColor, and iconColor based on the variant.
-     * Default: 'neutral'
+     * Resolves color, textColor, and iconColor from the filled or outlined palette
+     * depending on `outlined`. Default: 'neutral'
      */
     variant?: 'success' | 'warning' | 'error' | 'info' | 'neutral';
 }
@@ -578,14 +578,32 @@ export interface TableNotFrontProps extends NotFrontBaseProps, Omit<TableProps,
      */
     data?: TableProps['data'];
     /**
-     * Enables client-side pagination over static `data`. When provided and the
-     * number of rows exceeds `pageSize`, the table renders one page at a time
-     * with a pager. When omitted, all static rows are shown at once.
-     *
-     * Only applies to static `data`. It is ignored when `dataSource` is present
-     * (in that case pagination is server-driven via the response).
+     * Initial page size. For static `data`, enables client-side pagination when
+     * the number of rows exceeds this value. For `dataSource`, sent on the first
+     * request and kept in sync when the user changes rows per page.
      */
     pageSize?: number;
+    /**
+     * Shows the rows-per-page selector in the pager. Only applies to offset
+     * pagination (not cursor). Default: false.
+     */
+    showRowsPerPage?: boolean;
+    /**
+     * Caps the table scroll area to the viewport space below it so the pager
+     * stays on screen. Overflow uses internal scroll with a sticky header.
+     * Default: true (disabled for cursor pagination). Override with explicit
+     * `maxHeight` / `stickyHeader`.
+     */
+    autoHeight?: boolean;
+    /**
+     * Options for the rows-per-page selector. The backend may override the
+     * default list. Default when omitted: `[10, 20, 50, 100]`.
+     */
+    pageSizeOptions?: number[];
+    /**
+     * Label for the rows-per-page selector. Default: "Filas por página:".
+     */
+    labelRowsPerPage?: string;
     /**
      * Data source to load data for table. Required when not providing static data.
      */

package/dist/avocado-not-front/src/types/componentsCore.type.d.ts

@@ -24,10 +24,15 @@ interface BaseDataSource {
     headers?: Record<string, string>;
     params?: any;
 }
+export type NotFrontPaginationKeys = {
+    page?: string;
+    text?: string;
+    size?: string;
+};
 export interface NotFrontDataSourceRest extends BaseDataSource {
     type: 'rest';
     data?: any;
-    paginationKeys?: Record<string, string>;
+    paginationKeys?: NotFrontPaginationKeys;
 }
 export interface NotFrontDataSourceGraphQL extends BaseDataSource {
     type: 'graphql';

package/dist/avocado-not-front/src/utils/dataSource.util.d.ts

@@ -13,9 +13,10 @@ export declare const normalizeHttpMethod: (method: string | undefined) => NotFro
  * @param dataSource - The REST data source configuration.
  * @param page - The current pagination page number.
  * @param search - Optional search term to include as a query parameter.
+ * @param pageSize - Optional page size to include as a query parameter.
  * @returns {string} The complete URL with all query parameters combined.
  */
-export declare const buildQueryParams: (dataSource: NotFrontDataSourceRest, page: number, search?: string) => string;
+export declare const buildQueryParams: (dataSource: NotFrontDataSourceRest, page: number, search?: string, pageSize?: number) => string;
 /**
  * Utility to build a normalized NotFrontDataSource object for REST or GraphQL requests.
  *
@@ -28,8 +29,9 @@ export declare const buildQueryParams: (dataSource: NotFrontDataSourceRest, page
  * @param page - The page number for pagination (default: 1)
  * @param search - Optional search string (used for filtering, e.g., in selects)
  * @param cursorPayload - Optional cursor object built from the previous response; merged into the REST request `data` after the flow's original `data`.
+ * @param pageSize - Optional page size sent with pagination requests.
  * @returns A NotFrontDataSource object ready for fetchDataSource
  * @throws If the dataSource type is not supported
  */
-export declare const buildRequestDataSource: (dataSource: NotFrontDataSource, page: number, search?: string, cursorPayload?: Record<string, unknown> | null) => NotFrontDataSource;
+export declare const buildRequestDataSource: (dataSource: NotFrontDataSource, page: number, search?: string, cursorPayload?: Record<string, unknown> | null, pageSize?: number) => NotFrontDataSource;
 export {};

package/dist/avocado-not-front/src/utils/pillVariant.util.d.ts

@@ -15,6 +15,15 @@ export declare const PILL_VARIANT_COLORS: Record<TablePillVariant, TablePillColo
  * border. Each variant gets a solid border token and a readable text token.
  */
 export declare const PILL_OUTLINED_VARIANT_COLORS: Record<TablePillVariant, TablePillColors>;
+/**
+ * The tokens a pill of this variant needs, filled or outlined.
+ *
+ * `Pill` paints `color` as the border when `outlined` is set, so the two looks
+ * cannot share a table: the filled tokens would draw a border the user cannot
+ * see. Every caller that renders a pill from a variant has to go through here,
+ * or the outlined look silently degrades to an invisible outline.
+ */
+export declare const resolvePillColors: (variant: TablePillVariant, outlined?: boolean) => TablePillColors;
 export declare const TABLE_PILL_OUTLINED_TOKEN = "outlined";
 export declare const isTablePillVariant: (value: unknown) => value is "success" | "warning" | "error" | "info" | "neutral";
 export type ParsedTablePill = {