@agnos-ui/react-bootstrap 0.4.0-next.1 → 0.4.0

package/components/modal/modal.gen.d.ts

@@ -1,10 +1,17 @@
-import type { WidgetSlotContext, SlotContent, Widget, Directive } from '@agnos-ui/react-headless/types';
+import { modalOutsideClick, modalCloseButtonClick } from '@agnos-ui/core-bootstrap/components/modal';
+import type { WidgetSlotContext, SlotContent, Widget, PropsConfig, Directive } from '@agnos-ui/react-headless/types';
 import type { TransitionFn } from '@agnos-ui/react-headless/services/transitions/baseTransitions';
+/**
+ * Retrieve a shallow copy of the default modal config
+ * @returns the default modal config
+ */
+declare const export_getModalDefaultConfig: () => ModalProps<any>;
+export { export_getModalDefaultConfig as getModalDefaultConfig };
 export type ModalContext<Data> = WidgetSlotContext<ModalWidget<Data>>;
 export interface ModalState<Data> {
     /**
-     * Whether the backdrop is fully hidden. This can be true either because {@link ModalProps.backdropbackdrop} is false or
-     * because {@link ModalCommonPropsAndState.visiblevisible} is false and there is no current transition.
+     * Whether the backdrop is fully hidden. This can be true either because {@link ModalProps.backdrop|backdrop} is false or
+     * because {@link ModalProps.visible|visible} is false and there is no current transition.
      */
     backdropHidden: boolean;
     /**
@@ -21,28 +28,43 @@ export interface ModalState<Data> {
     modalElement: HTMLElement | null;
     /**
      * Value of the aria-label attribute to put on the close button.
+     *
+     * @defaultValue `'Close'`
      */
     ariaCloseButtonLabel: string;
     /**
      * Classes to add on the backdrop DOM element.
+     *
+     * @defaultValue `''`
      */
     backdropClass: string;
     /**
      * Whether to display the close button.
+     *
+     * @defaultValue `true`
      */
     closeButton: boolean;
     /**
      * Which element should contain the modal and backdrop DOM elements.
      * If it is not null, the modal and backdrop DOM elements are moved to the specified container.
      * Otherwise, they stay where the widget is located.
+     *
+     * @defaultValue
+     * ```ts
+     * typeof window !== 'undefined' ? document.body : null
+     * ```
      */
     container: HTMLElement | null;
     /**
      * Whether the modal should be visible when the transition is completed.
+     *
+     * @defaultValue `false`
      */
     visible: boolean;
     /**
      * CSS classes to be applied on the widget main container
+     *
+     * @defaultValue `''`
      */
     className: string;
     /**
@@ -58,12 +80,12 @@ export interface ModalState<Data> {
      */
     footer: SlotContent<ModalContext<Data>>;
     /**
-     * Header of the modal. The default header includes {@link ModalCommonPropsAndState.title title}.
+     * Header of the modal. The default header includes {@link ModalProps.title|title}.
      */
     header: SlotContent<ModalContext<Data>>;
     /**
      * Structure of the modal.
-     * The default structure uses {@link ModalCommonPropsAndState.header header}, {@link ModalCommonPropsAndState.children children} and {@link ModalCommonPropsAndState.footer footer}.
+     * The default structure uses {@link ModalProps.header|header}, {@link ModalProps.children|children} and {@link ModalProps.footer|footer}.
      */
     structure: SlotContent<ModalContext<Data>>;
     /**
@@ -72,70 +94,122 @@ export interface ModalState<Data> {
     title: SlotContent<ModalContext<Data>>;
     /**
      * Option to create a fullscreen modal, according to the bootstrap documentation.
+     *
+     * @defaultValue `false`
      */
     fullscreen: boolean;
 }
 export interface ModalProps<Data> {
+    /**
+     * The transition to use for the backdrop behind the modal (if present).
+     *
+     * @defaultValue `fadeTransition`
+     */
+    backdropTransition: TransitionFn;
+    /**
+     * The transition to use for the modal.
+     *
+     * @defaultValue `fadeTransition`
+     */
+    modalTransition: TransitionFn;
     /**
      * Whether the modal and its backdrop (if present) should be animated when shown or hidden.
+     *
+     * @defaultValue `true`
      */
     animated: boolean;
     /**
      * Whether a backdrop should be created behind the modal.
+     *
+     * @defaultValue `true`
      */
     backdrop: boolean;
-    /**
-     * The transition to use for the backdrop behind the modal (if present).
-     */
-    backdropTransition: TransitionFn;
     /**
      * Whether the modal should be closed when clicking on the viewport outside the modal.
+     *
+     * @defaultValue `true`
      */
     closeOnOutsideClick: boolean;
     /**
-     * The transition to use for the modal.
-     */
-    modalTransition: TransitionFn;
-    /**
-     * Event to be triggered when the modal is about to be closed (i.e. the {@link ModalApi.closeclose} method was called).
+     * Event to be triggered when the modal is about to be closed (i.e. the {@link ModalApi.close|close} method was called).
+     *
+     * @param event - event giving access to the argument given to the {@link ModalApi.close|close} method and allowing
+     * to cancel the close process.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
      */
     onBeforeClose: (event: ModalBeforeCloseEvent) => void;
     /**
      * Event to be triggered when the visible property changes.
+     *
+     * @param visible - new value of the visible propery
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
      */
     onVisibleChange: (visible: boolean) => void;
     /**
      * Event to be triggered when the transition is completed and the modal is not visible.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
      */
     onHidden: () => void;
     /**
      * Event to be triggered when the transition is completed and the modal is visible.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
      */
     onShown: () => void;
     /**
      * Value of the aria-label attribute to put on the close button.
+     *
+     * @defaultValue `'Close'`
      */
     ariaCloseButtonLabel: string;
     /**
      * Classes to add on the backdrop DOM element.
+     *
+     * @defaultValue `''`
      */
     backdropClass: string;
     /**
      * Whether to display the close button.
+     *
+     * @defaultValue `true`
      */
     closeButton: boolean;
     /**
      * Which element should contain the modal and backdrop DOM elements.
      * If it is not null, the modal and backdrop DOM elements are moved to the specified container.
      * Otherwise, they stay where the widget is located.
+     *
+     * @defaultValue
+     * ```ts
+     * typeof window !== 'undefined' ? document.body : null
+     * ```
      */
     container: HTMLElement | null;
     /**
      * Whether the modal should be visible when the transition is completed.
+     *
+     * @defaultValue `false`
      */
     visible: boolean;
     /**
      * CSS classes to be applied on the widget main container
+     *
+     * @defaultValue `''`
      */
     className: string;
     /**
@@ -151,12 +225,12 @@ export interface ModalProps<Data> {
      */
     footer: SlotContent<ModalContext<Data>>;
     /**
-     * Header of the modal. The default header includes {@link ModalCommonPropsAndState.title title}.
+     * Header of the modal. The default header includes {@link ModalProps.title|title}.
      */
     header: SlotContent<ModalContext<Data>>;
     /**
      * Structure of the modal.
-     * The default structure uses {@link ModalCommonPropsAndState.header header}, {@link ModalCommonPropsAndState.children children} and {@link ModalCommonPropsAndState.footer footer}.
+     * The default structure uses {@link ModalProps.header|header}, {@link ModalProps.children|children} and {@link ModalProps.footer|footer}.
      */
     structure: SlotContent<ModalContext<Data>>;
     /**
@@ -165,6 +239,8 @@ export interface ModalProps<Data> {
     title: SlotContent<ModalContext<Data>>;
     /**
      * Option to create a fullscreen modal, according to the bootstrap documentation.
+     *
+     * @defaultValue `false`
      */
     fullscreen: boolean;
 }
@@ -175,39 +251,63 @@ export interface ModalApi<Data> {
     patch: ModalWidget<Data>['patch'];
     /**
      * Closes the modal with the given result.
+     *
+     * @param result - result of the modal, as passed in the {@link ModalBeforeCloseEvent.result|result} property of the event passed to the
+     * {@link ModalProps.onBeforeClose|onBeforeClose} event handler (and possibly changed by it) and resolved by the promise returned by the {@link ModalApi.open|open} method.
      */
     close(result?: any): void;
     /**
      * Opens the modal and returns a promise that is resolved when the modal is closed.
-     * The resolved value is the result passed to the {@link ModalApi.closeclose} method and possibly changed by the
-     * {@link ModalProps.onBeforeCloseonBeforeClose} event handler
+     * The resolved value is the result passed to the {@link ModalApi.close|close} method and possibly changed by the
+     * {@link ModalProps.onBeforeClose|onBeforeClose} event handler
      */
     open(): Promise<any>;
 }
 export type ModalWidget<Data> = Widget<ModalProps<Data>, ModalState<Data>, ModalApi<Data>, ModalActions, ModalDirectives>;
+/**
+ * Creates a new modal widget instance.
+ * @param config - config of the modal, either as a store or as an object containing values or stores.
+ * @returns a new modal widget instance
+ */
+declare const export_createModal: <Data>(config?: PropsConfig<ModalProps<Data>>) => ModalWidget<Data>;
+export { export_createModal as createModal };
+/**
+ * Value present in the {@link ModalBeforeCloseEvent.result|result} property of the {@link ModalProps.onBeforeClose|onBeforeClose} event
+ * and returned by the {@link ModalApi.open|open} method, when the modal is closed by a click inside the viewport but outside the modal.
+ */
+declare const export_modalOutsideClick: typeof modalOutsideClick;
+export { export_modalOutsideClick as modalOutsideClick };
+/**
+ * Value present in the {@link ModalBeforeCloseEvent.result|result} property of the {@link ModalProps.onBeforeClose|onBeforeClose} event
+ * and returned by the {@link ModalApi.open|open} method, when the modal is closed by a click on the close button.
+ */
+declare const export_modalCloseButtonClick: typeof modalCloseButtonClick;
+export { export_modalCloseButtonClick as modalCloseButtonClick };
 export interface ModalBeforeCloseEvent {
     /**
-     * Result of the modal, which is the value passed to the {@link ModalApi.closeclose} method
-     * and later resolved by the promise returned by the {@link ModalApi.openopen} method.
-     * If needed, it can be changed from the {@link ModalProps.onBeforeCloseonBeforeClose} event handler.
+     * Result of the modal, which is the value passed to the {@link ModalApi.close|close} method
+     * and later resolved by the promise returned by the {@link ModalApi.open|open} method.
+     * If needed, it can be changed from the {@link ModalProps.onBeforeClose|onBeforeClose} event handler.
      */
     result: any;
     /**
      * Whether to cancel the close of the modal.
-     * It can be changed from the {@link ModalProps.onBeforeCloseonBeforeClose} event handler.
+     * It can be changed from the {@link ModalProps.onBeforeClose|onBeforeClose} event handler.
      */
     cancel: boolean;
 }
 export interface ModalActions {
     /**
      * Action to be called when the user clicks on the close button. It closes the modal with the {@link modalCloseButtonClick} result.
+     * @param event - mouse event
      */
     closeButtonClick(event: Pick<MouseEvent, never>): void;
     /**
      * Action to be called when the user clicks on the modal DOM element (which is supposed to have the size of the full viewport).
      * If the click is not done on a descendant of the modal DOM element, it is considered to be done outside the modal
-     * and, depending on the value of the {@link ModalProps.closeOnOutsideClickcloseOnOutsideClick} prop, the modal is or isn't closed
+     * and, depending on the value of the {@link ModalProps.closeOnOutsideClick|closeOnOutsideClick} prop, the modal is or isn't closed
      * (with the {@link modalOutsideClick} result).
+     * @param event - mouse event
      */
     modalClick(event: Pick<MouseEvent, 'target' | 'currentTarget'>): void;
 }

package/components/pagination/index.cjs

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const pagination = require("../../pagination-DeZ2Eb3e.cjs");
+const pagination = require("../../pagination-ChA90-py.cjs");
 exports.DefaultPages = pagination.DefaultPages;
 exports.DefaultStructure = pagination.DefaultStructure;
 exports.NavButton = pagination.NavButton;
 exports.PageItem = pagination.PageItem;
 exports.Pagination = pagination.Pagination;
-exports.createPagination = pagination.createPagination;
-exports.getPaginationDefaultConfig = pagination.getPaginationDefaultConfig;
+exports.createPagination = pagination.export_createPagination;
+exports.getPaginationDefaultConfig = pagination.export_getPaginationDefaultConfig;

package/components/pagination/index.d.ts

@@ -1 +1,3 @@
+export * from './pageItem';
 export * from './pagination';
+export * from './pagination.gen';

package/components/pagination/index.js

@@ -1,10 +1,10 @@
-import { D, a, N, b, P, c, g } from "../../pagination-B76wbKhG.js";
+import { D, a, N, P, b, c, e } from "../../pagination-BDq1dOoH.js";
 export {
   D as DefaultPages,
   a as DefaultStructure,
   N as NavButton,
-  b as PageItem,
-  P as Pagination,
+  P as PageItem,
+  b as Pagination,
   c as createPagination,
-  g as getPaginationDefaultConfig
+  e as getPaginationDefaultConfig
 };

package/components/pagination/pagination.d.ts

@@ -1,9 +1,4 @@
-import type { WidgetFactory } from '@agnos-ui/react-headless/types';
-import type { PaginationContext, PaginationProps, PaginationWidget } from './pagination.gen';
-export type * from './pagination.gen';
-export declare const createPagination: WidgetFactory<PaginationWidget>;
-export declare const getPaginationDefaultConfig: () => PaginationProps;
-export * from './pageItem';
+import type { PaginationContext, PaginationProps } from './pagination.gen';
 export declare function DefaultPages(slotContext: PaginationContext): import("react/jsx-runtime").JSX.Element | null;
 export declare function DefaultStructure(slotContext: PaginationContext): import("react/jsx-runtime").JSX.Element;
 export declare function Pagination(props: Partial<PaginationProps>): import("react/jsx-runtime").JSX.Element;