@foris/avocado-not-front 6.0.0 → 7.0.0

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

@@ -1,8 +1,5 @@
-import { BreadcrumbsNotFrontProps } from '../../types';
-/**
- * Extended props for NotFront Breadcrumbs component.
- * Includes context identifiers for the userFlow and pageId.
- */
+import type { BreadcrumbsNotFrontProps } from '../../types';
+/** Includes context identifiers for the NotFront action pipeline. */
 interface BreadcrumbsNotFrontExtendedProps extends BreadcrumbsNotFrontProps {
     userFlow: string;
     pageId: string;

package/dist/avocado-not-front/src/components/breadcrumbs/Breadcrumbs.test.d.ts

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

package/dist/avocado-not-front/src/components/header-navigation/HeaderNavigation.d.ts

@@ -0,0 +1,10 @@
+import type { FC } from 'react';
+import type { HeaderNavigationNotFrontProps, ResolveComponentPropsMap } from '../../types';
+export interface HeaderNavigationNotFrontExtendedProps extends HeaderNavigationNotFrontProps {
+    userFlow: string;
+    pageId: string;
+    onResolveComponentProps?: ResolveComponentPropsMap;
+}
+/** JSON adapter for both the page slot and nested component lists. */
+declare const HeaderNavigationNotFront: FC<HeaderNavigationNotFrontExtendedProps>;
+export default HeaderNavigationNotFront;

package/dist/avocado-not-front/src/components/header-navigation/HeaderNavigation.test.d.ts

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

package/dist/avocado-not-front/src/components/header-navigation/useHeaderNavigationActions.d.ts

@@ -0,0 +1,6 @@
+import type { HeaderNavigationNotFrontProps } from '../../types';
+/** Adapts header navigation without retaining stale page or action configuration. */
+export declare const useHeaderNavigationActions: (userFlow: string, pageId: string, responseKey: string, breadcrumbsItems: NonNullable<HeaderNavigationNotFrontProps['breadcrumbsItems']>, menuItems: NonNullable<HeaderNavigationNotFrontProps['menuItems']>) => {
+    breadcrumbs: BreadcrumbItem[];
+    menu: MenuItem[];
+};

package/dist/avocado-not-front/src/components/header-navigation/useHeaderNavigationActions.test.d.ts

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

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

@@ -21,6 +21,7 @@ import Divider from './divider/Divider';
 import Drawer from './drawer/Drawer';
 import DropdownButtonNotFront from './dropdown-button/DropdownButton';
 import Header from './header/Header';
+import HeaderNavigation from './header-navigation/HeaderNavigation';
 import Link from './link/Link';
 import MenuNotFront from './menu/Menu';
 import Modal from './modal/Modal';
@@ -40,4 +41,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, 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, 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/hooks/builder/useBuildComponentsList.test.d.ts

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

package/dist/avocado-not-front/src/hooks/useAction.d.ts

@@ -1,6 +1,19 @@
 import { AxiosResponse } from 'axios';
 import { NotFrontDataSource } from '../types/componentsCore.type';
 import { NextUIResponseData } from '../types/builder.type';
+type GetNextUIFn = (userFlow: string, pageHash: string, entries: Record<string, unknown>, responseKey: string, showLoading?: boolean) => Promise<AxiosResponse<NextUIResponseData> | undefined>;
+type FetchDataSourceFn = (dataSource: NotFrontDataSource, userFlow: string, showLoading?: boolean) => Promise<{
+    status?: number;
+    data?: unknown;
+} | undefined>;
+/**
+ * Runs the GET_DATA_SOURCE pipeline: next-ui fetch config, external request,
+ * session update, then next-ui re-render.
+ *
+ * Fetch results are stored under ``content.responseKey`` from the backend
+ * when present; otherwise the triggering component key is used.
+ */
+export declare function runGetDataSourceFlow(userFlow: string, pageHash: string, triggerKey: string, entries: Record<string, unknown>, getNextUI: GetNextUIFn, fetchDataSource: FetchDataSourceFn): Promise<void>;
 /**
  * Custom hook that encapsulates actions related to navigation and data fetching for dynamic UI flows.
  */
@@ -11,4 +24,6 @@ export declare const useAction: () => {
         data: {};
     } | undefined>;
     fetchAndGetNextUI: (userFlow: string, pageHash: string, entries: any, responseKey: string, dataSource: NotFrontDataSource) => Promise<AxiosResponse<NextUIResponseData, any> | undefined>;
+    runGetDataSource: (userFlow: string, pageHash: string, triggerKey: string, entries: Record<string, unknown>) => Promise<void>;
 };
+export {};

package/dist/avocado-not-front/src/hooks/useNotFrontBreadcrumbActionRunner.d.ts

@@ -0,0 +1,6 @@
+export interface BreadcrumbActionFields {
+    hashCode: string;
+    responseKey?: string;
+}
+/** Runs the shared next-UI pipeline for an interactive breadcrumb. */
+export declare const useNotFrontBreadcrumbActionRunner: (userFlow: string, fallbackResponseKey: string) => ({ hashCode, responseKey }: BreadcrumbActionFields) => Promise<void>;

package/dist/avocado-not-front/src/hooks/useNotFrontBreadcrumbActionRunner.test.d.ts

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

package/dist/avocado-not-front/src/hooks/useNotFrontButtonActionRunner.d.ts

@@ -1,8 +1,5 @@
-import type { ButtonNotFrontProps } from '../types';
-export type ButtonActionFields = Pick<ButtonNotFrontProps, 'responseKey' | 'actionType' | 'dependencies'> & {
-    dataSource?: ButtonNotFrontProps['dataSource'];
-    redirectUrl?: string;
-};
+import type { ButtonActionFields } from '../types';
+export type { ButtonActionFields } from '../types';
 /**
  * Runs the same NotFront action pipeline as {@link ButtonNotFront} for a
  * single action bundle (e.g. one menu or dropdown row).

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

@@ -1,5 +1,5 @@
-import { NotFrontComponent } from './components.type';
-import { NotFrontDataSource } from './componentsCore.type';
+import type { HeaderNavigationNotFrontProps, NotFrontComponent } from './components.type';
+import type { NotFrontDataSource } from './componentsCore.type';
 /**
  * Interface for the configuration required to interact with the API.
  * This interface includes the necessary details for the API connection.
@@ -60,6 +60,8 @@ export interface ObjectNotFront {
  */
 export type PageContent = {
     type: 'page';
+    /** Full-width navigation banner, rendered after an explicit legacy header and before the body. */
+    headerNavigation?: HeaderNavigationNotFrontProps | null;
     /**
      * A collection of components to be rendered in the page.
      * These components make up the structure of the page content.

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

@@ -1,4 +1,4 @@
-import { AccordionProps, ButtonProps, CardAccordionProps, CardNotificationProps, CheckboxProps, DataCardPaletteIndex, DataCardV2HeaderStyle, DataCardV2Status, DividerProps, DrawerProps, HeadingProps, 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, 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';
@@ -11,6 +11,42 @@ export interface BoxNotFrontProps extends NotFrontBaseProps {
     component: 'box';
     content: NotFrontComponent[];
 }
+/** Navigation action using the existing breadcrumb field names. */
+export type HeaderNavigationBreadcrumbNotFront = Pick<BreadcrumbsItemNotFront, 'title'> & ({
+    actionType?: never;
+} | {
+    actionType: 'REDIRECT';
+    redirectUrl: string;
+} | {
+    actionType: 'GO_TO_NEXT_UI';
+    hashCode: string;
+    responseKey?: string;
+});
+/** Serializable menu row, executed by the standard not-front button pipeline. */
+export type ButtonActionFields = Pick<ButtonNotFrontProps, 'responseKey' | 'actionType' | 'dependencies'> & {
+    dataSource?: ButtonNotFrontProps['dataSource'];
+    redirectUrl?: string;
+};
+export interface HeaderNavigationMenuItemNotFront extends Omit<ButtonActionFields, 'actionType'>, Pick<ButtonNotFrontProps, 'content' | 'leftIcon'> {
+    label?: string;
+    actionType: Exclude<NotFrontActionType, 'GO_TO_NEXT_UI_WITHOUT_LOADING' | 'AUTOCLOSE_AND_REDIRECT'>;
+}
+/** Independent page banner; also usable inside component lists. */
+export interface HeaderNavigationNotFrontProps extends NotFrontBaseProps {
+    component: 'headerNavigation';
+    title: string;
+    description?: string;
+    background?: 'default' | 'brand';
+    leadingVisual?: HeaderNavigationVisual;
+    pattern?: boolean | string;
+    menuLabel?: string;
+    menuDisabled?: boolean;
+    className?: string;
+    breadcrumbsItems?: HeaderNavigationBreadcrumbNotFront[];
+    menuItems?: HeaderNavigationMenuItemNotFront[];
+    /** Additional content such as a stepper. */
+    components?: NotFrontComponent[];
+}
 /**
  * Interface for the props used in the ChartNotFront component.
  */
@@ -1302,7 +1338,7 @@ export interface AIPromptCodeEditorNotFrontProps extends NotFrontBaseProps {
 /**
  * Union type representing all possible NotFront component prop types.
  */
-export type NotFrontComponent = 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 | 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.
@@ -1353,6 +1389,7 @@ export type ResolveComponentPropsMap = {
  * Mapping of component identifiers (as strings) to their corresponding prop types.
  */
 export type NotFrontComponentTypeMap = {
+    headerNavigation: HeaderNavigationNotFrontProps;
     accordion: AccordionNotFrontProps;
     aiChatPanel: AIChatPanelNotFrontProps;
     aiPromptCodeEditor: AIPromptCodeEditorNotFrontProps;

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

@@ -9,7 +9,9 @@ export interface NotFrontBaseProps {
  * - `FETCH_AND_GO_TO_NEXT_UI`: fetches the component's `dataSource`, then
  *   requests the next UI and re-renders the page.
  * - `GET_DATA_SOURCE`: asks the backend for a fetch instruction via next-ui,
- *   executes it, and re-renders with the resulting next UI.
+ *   executes it, stores the result under the fetch payload's `responseKey`
+ *   (falling back to the triggering component key), then re-renders with the
+ *   resulting next UI.
  * - `FETCH_DATA_SOURCE`: side-effect only — fetches the component's
  *   `dataSource` and stores the result in entries as `{ status, content }`
  *   under the component's `responseKey`. No next-ui call, the current page