@foris/avocado-not-front 8.0.0 → 8.0.2

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

@@ -2,6 +2,7 @@ import type { FC, ReactNode } from 'react';
 import type { ObjectNotFront } from '../../types';
 interface BodyProps extends ObjectNotFront {
     inputs: ReactNode[];
+    embedded?: boolean;
 }
 /**
  * Body component that renders a list of dynamic components inside a section.

package/dist/avocado-not-front/src/components/contextual-navigation/ContextualNavigation.d.ts

@@ -0,0 +1,9 @@
+import type { FC, ReactNode } from 'react';
+import type { ContextualNavigationNotFrontProps } from '../../types';
+export interface ContextualNavigationNotFrontExtendedProps extends ContextualNavigationNotFrontProps {
+    userFlow: string;
+    children: ReactNode;
+}
+/** JSON adapter for the page `contextualNavigation` slot. */
+declare const ContextualNavigationNotFront: FC<ContextualNavigationNotFrontExtendedProps>;
+export default ContextualNavigationNotFront;

package/dist/avocado-not-front/src/components/contextual-navigation/ContextualNavigation.test.d.ts

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

package/dist/avocado-not-front/src/components/contextual-navigation/useContextualNavigationActions.d.ts

@@ -0,0 +1,7 @@
+import type { MouseEvent } from 'react';
+import type { ContextualNavigationNotFrontProps } from '../../types';
+/** Maps JSON destinations to suite items and wires breadcrumb-style actions. */
+export declare const useContextualNavigationActions: (userFlow: string, responseKey: string, sections?: ContextualNavigationNotFrontProps['sections']) => {
+    sections: ContextualNavigationItem[][];
+    onItemClick: (item: ContextualNavigationItem, event: MouseEvent<HTMLElement>) => void;
+};

package/dist/avocado-not-front/src/components/contextual-navigation/useContextualNavigationActions.test.d.ts

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

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/hooks/builder/useBuilder.d.ts

@@ -7,6 +7,10 @@ import type { ObjectNotFront, ResolveComponentPropsMap } from '../../types';
  * @param pageId - The current page identifier.
  * @param type - Indicates whether to render a 'body', 'header'.
  * @param notFrontObject - The configuration object containing component data.
+ * @param options.embedded - Renders the body without its own page padding.
  * @returns A rendered Header, Body or Components with its child components or null if the type is unrecognized.
  */
-export declare const useBuilder: (userFlow: string, pageId: string, type: 'body' | 'header', notFrontObject: ObjectNotFront | null, onResolveComponentProps?: ResolveComponentPropsMap) => import("react/jsx-runtime").JSX.Element | null;
+export declare const useBuilder: (userFlow: string, pageId: string, type: 'body' | 'header', notFrontObject: ObjectNotFront | null, { onResolveComponentProps, embedded, }?: {
+    onResolveComponentProps?: ResolveComponentPropsMap | undefined;
+    embedded?: boolean | undefined;
+}) => import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,4 +1,4 @@
-import type { HeaderNavigationNotFrontProps, NotFrontComponent } from './components.type';
+import type { ContextualNavigationNotFrontProps, HeaderNavigationNotFrontProps, NotFrontComponent } from './components.type';
 import type { NotFrontDataSource } from './componentsCore.type';
 /**
  * Interface for the configuration required to interact with the API.
@@ -62,6 +62,8 @@ export type PageContent = {
     type: 'page';
     /** Full-width navigation banner, rendered after an explicit legacy header and before the body. */
     headerNavigation?: HeaderNavigationNotFrontProps | null;
+    /** Optional L2 sidebar navigation wrapping the built body. */
+    contextualNavigation?: ContextualNavigationNotFrontProps | 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 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, ContextualNavigationItem, 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';
@@ -11,8 +11,8 @@ export interface BoxNotFrontProps extends NotFrontBaseProps {
     component: 'box';
     content: NotFrontComponent[];
 }
-/** Navigation action using the existing breadcrumb field names. */
-export type HeaderNavigationBreadcrumbNotFront = Pick<BreadcrumbsItemNotFront, 'title'> & ({
+/** Navigation action shared by breadcrumbs and sidebar destinations; no action means inert. */
+export type NotFrontNavigationAction = {
     actionType?: never;
 } | {
     actionType: 'REDIRECT';
@@ -21,7 +21,9 @@ export type HeaderNavigationBreadcrumbNotFront = Pick<BreadcrumbsItemNotFront, '
     actionType: 'GO_TO_NEXT_UI';
     hashCode: string;
     responseKey?: string;
-});
+};
+/** Header breadcrumb using the existing breadcrumb field names. */
+export type HeaderNavigationBreadcrumbNotFront = Pick<BreadcrumbsItemNotFront, 'title'> & NotFrontNavigationAction;
 /** Serializable menu row, executed by the standard not-front button pipeline. */
 export type ButtonActionFields = Pick<ButtonNotFrontProps, 'responseKey' | 'actionType' | 'dependencies'> & {
     dataSource?: ButtonNotFrontProps['dataSource'];
@@ -47,6 +49,15 @@ export interface HeaderNavigationNotFrontProps extends NotFrontBaseProps {
     /** Additional content such as a stepper. */
     components?: NotFrontComponent[];
 }
+/** Serializable destination; `REDIRECT` becomes the suite item's `href`. */
+export type ContextualNavigationItemNotFront = Omit<ContextualNavigationItem, 'href'> & NotFrontNavigationAction;
+/** Page-slot sidebar navigation; not a `body.components` entry. */
+export interface ContextualNavigationNotFrontProps extends NotFrontBaseProps {
+    sections: ContextualNavigationItemNotFront[][];
+    activeId?: string;
+    persistenceKey?: string;
+    ariaLabel?: string;
+}
 /**
  * Interface for the props used in the ChartNotFront component.
  */
@@ -258,6 +269,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.
  */
@@ -1356,7 +1381,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.
@@ -1428,6 +1453,7 @@ export type NotFrontComponentTypeMap = {
     divider: DividerNotFrontProps;
     drawer: DrawerNotFrontProps;
     dropdownButton: DropdownButtonNotFrontProps;
+    fileUpload: FileUploadNotFrontProps;
     heading: HeadingNotFrontProps;
     link: LinkNotFrontProps;
     menu: MenuNotFrontProps;