@foris/avocado-not-front 7.0.0 → 8.0.1

package/dist/avocado-not-front/src/components/file-upload/FileUpload.d.ts

@@ -0,0 +1,9 @@
+import type { FC } from 'react';
+import type { FileUploadNotFrontProps } from '../../types';
+interface FileUploadNotFrontExtendedProps extends FileUploadNotFrontProps {
+    userFlow: string;
+    pageId: string;
+}
+/** Binds suite FileUpload to `entries[responseKey]`; see `.agents/rules/packages/avocado-not-front.md`. */
+declare const FileUploadNotFront: FC<FileUploadNotFrontExtendedProps>;
+export default FileUploadNotFront;

package/dist/avocado-not-front/src/components/file-upload/FileUpload.test.d.ts

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

package/dist/avocado-not-front/src/components/file-upload/fileUploadRules.util.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Maps not-front `rule1` / optional `rule2` JSON fields to suite `rules`.
+ * Empty or whitespace-only strings are omitted.
+ */
+export declare const buildFileUploadRules: (rule1: string, rule2?: string) => string[];

package/dist/avocado-not-front/src/components/file-upload/fileUploadRules.util.test.d.ts

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

package/dist/avocado-not-front/src/components/file-upload/index.d.ts

@@ -0,0 +1 @@
+export { default as FileUploadNotFront } from './FileUpload';

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

@@ -19,6 +19,7 @@ import ContentWrapper from './content-wrapper/ContentWrapper';
 import DataCard from './data-card/DataCard';
 import Divider from './divider/Divider';
 import Drawer from './drawer/Drawer';
+import FileUploadNotFront from './file-upload/FileUpload';
 import DropdownButtonNotFront from './dropdown-button/DropdownButton';
 import Header from './header/Header';
 import HeaderNavigation from './header-navigation/HeaderNavigation';
@@ -41,4 +42,4 @@ import Toast from './toast/Toast';
 import Tooltip from './tooltip/Tooltip';
 import { NotFrontPage } from './not-front-page/NotFrontPage';
 import { RenderNotFront, renderNotFront, extractNotFrontComponents } from './render-not-front';
-export { Accordion, AIChatPanel, AIPromptCodeEditor, AISummaryCard, Body, Box, RadioGroupNotFront, StepperNotFront, ProgressBarNotFront, Breadcrumbs, Button, CardAccordion, CardNotFront, CardNotification, Chart, Checkbox, CodeEditor, ContentWrapper, DataCard, Divider, Drawer, DropdownButtonNotFront, Header, HeaderNavigation, Link, MenuNotFront, Modal, NotFrontPage, OverlayRenderer, RenderNotFront, renderNotFront, extractNotFrontComponents, Pill, PreviewerMarkdown, RoundButton, Row, Select, Spacing, Switch, Table, Tabs, Textarea, TextField, Toast, Tooltip, };
+export { Accordion, AIChatPanel, AIPromptCodeEditor, AISummaryCard, Body, Box, RadioGroupNotFront, StepperNotFront, ProgressBarNotFront, Breadcrumbs, Button, CardAccordion, CardNotFront, CardNotification, Chart, Checkbox, CodeEditor, ContentWrapper, DataCard, Divider, Drawer, FileUploadNotFront, DropdownButtonNotFront, Header, HeaderNavigation, Link, MenuNotFront, Modal, NotFrontPage, OverlayRenderer, RenderNotFront, renderNotFront, extractNotFrontComponents, Pill, PreviewerMarkdown, RoundButton, Row, Select, Spacing, Switch, Table, Tabs, Textarea, TextField, Toast, Tooltip, };

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

@@ -1,4 +1,4 @@
-import type { AccordionProps, ButtonProps, CardAccordionProps, CardNotificationProps, CheckboxProps, DataCardPaletteIndex, DataCardV2HeaderStyle, DataCardV2Status, DividerProps, DrawerProps, HeadingProps, HeaderNavigationVisual, LinkProps, ModalProps, PillProps, PreviewerMarkdownProps, RoundButtonProps, SelectProps, SwitchProps, TableColumn, TableProps, TabsProps, TextareaProps, TextFieldProps, TextProps } from '../../../avocado-suite';
+import type { AccordionProps, ButtonProps, CardAccordionProps, CardNotificationProps, CheckboxProps, DataCardPaletteIndex, DataCardV2HeaderStyle, DataCardV2Status, DividerProps, DrawerProps, DropzoneUploadStatus, FileUploadProps, HeadingProps, HeaderNavigationVisual, LinkProps, ModalProps, PillProps, PreviewerMarkdownProps, RoundButtonProps, SelectProps, SwitchProps, TableColumn, TableProps, TabsProps, TextareaProps, TextFieldProps, TextProps } from '../../../avocado-suite';
 import type { AiAgentTheme, ChatPanelTranslations, SuggestionType, SupportedLocale } from '../../../ai-agent';
 import type { TooltipCoverageConfig } from '../components/chart/chart.types';
 import type { ChartSeriesConfig, ChartYAxisConfig } from '../components/chart/chart.types';
@@ -258,6 +258,20 @@ export interface DividerNotFrontProps extends NotFrontBaseProps, DividerProps {
     /** Set the position vertical */
     vertical?: boolean;
 }
+/**
+ * Interface for the props used in the FileUploadNotFront component.
+ */
+export interface FileUploadNotFrontProps extends NotFrontBaseProps, Omit<FileUploadProps, 'file' | 'rules' | 'onFileChange' | 'onRemove' | 'onTemplateLinkClick' | 'templateHref' | 'disabled' | 'uploadStatus' | 'notificationVisible'> {
+    component: 'fileUpload';
+    rule1: string;
+    rule2?: string;
+    disabled?: boolean;
+    uploadStatus?: DropzoneUploadStatus;
+    notificationVisible?: boolean;
+    templateRedirectUrl?: string;
+    templateTarget?: '_blank' | '_self';
+    dependencies?: NotFrontDependency[];
+}
 /**
  * Interface for the props used in the HeadingNotFront component.
  */
@@ -399,8 +413,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 +592,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.
      */
@@ -1338,7 +1370,7 @@ export interface AIPromptCodeEditorNotFrontProps extends NotFrontBaseProps {
 /**
  * Union type representing all possible NotFront component prop types.
  */
-export type NotFrontComponent = HeaderNavigationNotFrontProps | AccordionNotFrontProps | AIChatPanelNotFrontProps | AIPromptCodeEditorNotFrontProps | AISummaryCardNotFrontProps | BoxNotFrontProps | BreadcrumbsNotFrontProps | ButtonNotFrontProps | CardAccordionNotFrontProps | CardNotFrontProps | CardNotificationNotFrontProps | ChartNotFrontProps | CheckboxNotFrontProps | CodeEditorNotFrontProps | DataCardNotFrontProps | DividerNotFrontProps | DrawerNotFrontProps | DropdownButtonNotFrontProps | HeadingNotFrontProps | LinkNotFrontProps | MenuNotFrontProps | ModalNotFrontProps | PillNotFrontProps | PreviewerMarkdownNotFrontProps | RadioGroupNotFrontProps | RoundButtonNotFrontProps | RowNotFrontProps | SelectNotFrontProps | SpacingNotFrontProps | StepperNotFrontProps | ProgressBarNotFrontProps | SwitchNotFrontProps | TableNotFrontProps | TabsNotFrontProps | TextareaNotFrontProps | TextFieldNotFrontProps | TextNotFrontProps | ToastNotFrontProps | TooltipNotFrontProps;
+export type NotFrontComponent = HeaderNavigationNotFrontProps | AccordionNotFrontProps | AIChatPanelNotFrontProps | AIPromptCodeEditorNotFrontProps | AISummaryCardNotFrontProps | BoxNotFrontProps | BreadcrumbsNotFrontProps | ButtonNotFrontProps | CardAccordionNotFrontProps | CardNotFrontProps | CardNotificationNotFrontProps | ChartNotFrontProps | CheckboxNotFrontProps | CodeEditorNotFrontProps | DataCardNotFrontProps | DividerNotFrontProps | DrawerNotFrontProps | DropdownButtonNotFrontProps | FileUploadNotFrontProps | HeadingNotFrontProps | LinkNotFrontProps | MenuNotFrontProps | ModalNotFrontProps | PillNotFrontProps | PreviewerMarkdownNotFrontProps | RadioGroupNotFrontProps | RoundButtonNotFrontProps | RowNotFrontProps | SelectNotFrontProps | SpacingNotFrontProps | StepperNotFrontProps | ProgressBarNotFrontProps | SwitchNotFrontProps | TableNotFrontProps | TabsNotFrontProps | TextareaNotFrontProps | TextFieldNotFrontProps | TextNotFrontProps | ToastNotFrontProps | TooltipNotFrontProps;
 /**
  * Resolved props for ChatPanel when delegated via onResolveComponentProps.
  * These are the props that the consumer receives to render ChatPanel externally.
@@ -1410,6 +1442,7 @@ export type NotFrontComponentTypeMap = {
     divider: DividerNotFrontProps;
     drawer: DrawerNotFrontProps;
     dropdownButton: DropdownButtonNotFrontProps;
+    fileUpload: FileUploadNotFrontProps;
     heading: HeadingNotFrontProps;
     link: LinkNotFrontProps;
     menu: MenuNotFrontProps;

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 = {