@design-factory/angular 21.0.4 → 21.1.0-next.0

package/node_modules/@agnos-ui/core/components/accordion/accordion.d.ts

@@ -0,0 +1,333 @@
+import type { TransitionFn } from '../../services/transitions/baseTransitions';
+import type { ConfigValidator, Directive, PropsConfig, Widget, WidgetFactory } from '../../types';
+import type { WidgetsCommonPropsAndState } from '../commonProps';
+/**
+ * Properties for the Accordion component.
+ */
+export interface AccordionProps extends WidgetsCommonPropsAndState {
+    /**
+     * If `true`, only one accordion-item at the time can stay open.
+     *
+     * @defaultValue `false`
+     */
+    closeOthers: boolean;
+    /**
+     * An event fired when an item is shown.
+     *
+     * Event payload is the id of the item.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    onItemShown: (itemId: string) => void;
+    /**
+     * An event fired when an item is hidden.
+     *
+     * Event payload is the id of the item.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    onItemHidden: (itemId: string) => void;
+    /**
+     * If `true`, the accordion-item body container will be removed from the DOM when the accordion-item is collapsed. It will be just hidden otherwise.
+     *
+     * @defaultValue `true`
+     */
+    itemDestroyOnHide: boolean;
+    /**
+     * If `true`, accordion-item will be animated.
+     *
+     * @defaultValue `true`
+     */
+    itemAnimated: boolean;
+    /**
+     * The transition to use for the accordion-item body-container when the accordion-item is toggled.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    itemTransition: TransitionFn;
+    /**
+     * CSS classes to add on the accordion-item DOM element.
+     *
+     * @defaultValue `''`
+     */
+    itemClassName: string;
+    /**
+     * CSS classes to add on the accordion-item header DOM element.
+     *
+     * @defaultValue `''`
+     */
+    itemHeaderClassName: string;
+    /**
+     * CSS classes to add on the accordion-item toggle button DOM element.
+     *
+     * @defaultValue `''`
+     */
+    itemButtonClassName: string;
+    /**
+     * CSS classes to add on the accordion-item body container DOM element.
+     * The accordion-item body container is the DOM element on what the itemTransition is applied.
+     *
+     * @defaultValue `''`
+     */
+    itemBodyContainerClassName: string;
+    /**
+     * CSS classes to add on the accordion-item body DOM element.
+     *
+     * @defaultValue `''`
+     */
+    itemBodyClassName: string;
+    /**
+     * The html heading level to use for the accordion-item-header.
+     *
+     * @defaultValue `2`
+     */
+    itemHeadingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+}
+/**
+ * Represents the state of an Accordion component.
+ */
+export interface AccordionState extends WidgetsCommonPropsAndState {
+    /**
+     * Array containing all the accordion-items contained in the accordion.
+     */
+    itemWidgets: AccordionItemWidget[];
+}
+/**
+ * Interface representing the API for an accordion component.
+ */
+export interface AccordionApi {
+    /**
+     * Given the itemId, will expand the corresponding accordion-item.
+     *
+     * If the itemId is not valid, nothing will happen.
+     * @returns A promise that resolves when the expand operation is completed.
+     */
+    expand(itemId: string, animated?: boolean): Promise<void>;
+    /**
+     * Given the itemId, will collapse the corresponding accordion-item.
+     *
+     * If the itemId is not valid, nothing will happen.
+     * @returns A promise that resolves when the collapse operation is completed.
+     */
+    collapse(itemId: string, animated?: boolean): Promise<void>;
+    /**
+     * Given the itemId, will toggle the corresponding accordion-item.
+     *
+     * @returns A promise that resolves when the toggle operation is completed.
+     * If the itemId is not valid, nothing will happen.
+     */
+    toggle(itemId: string): Promise<void>;
+    /**
+     * It will expand all the items in the accordion.
+     *
+     * If `closeOthers` is `true` it will expand only the last accordion-item.
+     *
+     * @returns A promise that resolves when all the expand operations are completed.
+     */
+    expandAll(animated?: boolean): Promise<void>;
+    /**
+     * It will collapse all the accordion-items in the accordion.
+     *
+     * @returns A promise that resolves when all the collapse operations are completed.
+     */
+    collapseAll(animated?: boolean): Promise<void>;
+    /**
+     * Creates a new accordionItem.
+     */
+    registerItem(itemConfig?: PropsConfig<AccordionItemProps>): AccordionItemWidget;
+}
+/**
+ * Interface representing the directives used in the Accordion component.
+ */
+export interface AccordionDirectives {
+    /**
+     * Directive to put on the accordion DOM element
+     */
+    accordionDirective: Directive;
+}
+/**
+ * Represents an Accordion widget with specific properties, state, API, and directives.
+ */
+export type AccordionWidget = Widget<AccordionProps, AccordionState, AccordionApi, AccordionDirectives>;
+/**
+ * Interface representing the API for an accordion item.
+ */
+export interface AccordionItemApi {
+    /**
+     * It will collapse the accordion-item.
+     * @returns A promise that resolves when the collapse operation is completed.
+     */
+    collapse(animated?: boolean): Promise<void>;
+    /**
+     * It will expand the accordion-item.
+     * @returns A promise that resolves when the expand operation is completed.
+     */
+    expand(animated?: boolean): Promise<void>;
+    /**
+     * It will toggle the accordion-item.
+     * @returns A promise that resolves when the toggle operation is completed.
+     */
+    toggle(animated?: boolean): Promise<void>;
+    /**
+     * Method to be called after the initialization to allow animations.
+     */
+    initDone(): void;
+}
+/**
+ * Interface representing the directives used in an accordion item.
+ */
+export interface AccordionItemDirectives {
+    /**
+     * Directive to use in special cases, if the accordion header does not use a button element to control the collapsing.
+     */
+    toggleDirective: Directive;
+    /**
+     * Directive to put on the button element that will control the collapsing of the accordion-item.
+     */
+    buttonDirective: Directive;
+    /**
+     * Directive to put on the accordion-item header that will contain the button element.
+     */
+    headerDirective: Directive;
+    /**
+     * Directive to put on the accordion-item body.
+     */
+    bodyDirective: Directive;
+    /**
+     * Directive to apply the itemTransition
+     */
+    transitionDirective: Directive;
+    /**
+     * Directive to apply aria attributes to the expanded body panel
+     */
+    bodyContainerAttrsDirective: Directive;
+    /**
+     * Directive to be put on the accordion-item body container. It will handle the animation.
+     */
+    bodyContainerDirective: Directive;
+    /**
+     * Directive to be put on the accordion-item. It will handle adding the accordion-item to the accordion.
+     */
+    itemDirective: Directive;
+}
+/**
+ * Interface representing the common properties and state for an accordion item.
+ */
+interface AccordionItemCommonPropsAndState extends WidgetsCommonPropsAndState {
+    /**
+     * If `true`, the accordion-item will be visible (expanded). Otherwise, it will be hidden (collapsed).
+     */
+    visible: boolean;
+    /**
+     * If `true`, the accordion-item will be disabled.
+     * It will not react to user's clicks, but still will be possible to toggle programmatically.
+     */
+    disabled: boolean;
+    /**
+     * The id of the accordion-item. It can be used for controlling the accordion-item via the accordion api.
+     */
+    id: string;
+    /**
+     * CSS classes to add on the accordion-item header DOM element.
+     */
+    headerClassName: string;
+    /**
+     * CSS classes to add on the accordion-item collapse DOM element.
+     */
+    buttonClassName: string;
+    /**
+     * CSS classes to add on the accordion-item body container DOM element.
+     * The accordion-item body container is the DOM element on what the itemTransition is applied.
+     */
+    bodyContainerClassName: string;
+    /**
+     * CSS classes to add on the accordion-item body DOM element.
+     */
+    bodyClassName: string;
+    /**
+     * The html heading level to use for the accordion-item-header.
+     */
+    headingLevel: 1 | 2 | 3 | 4 | 5 | 6;
+}
+/**
+ * Properties for an AccordionItem component.
+ */
+export interface AccordionItemProps extends AccordionItemCommonPropsAndState {
+    /**
+     * If `true`, accordion-item will be animated.
+     */
+    animated: boolean;
+    /**
+     * The transition to use for the accordion-item body-container when the accordion-item is toggled.
+     */
+    transition: TransitionFn;
+    /**
+     * If `true`, the accordion-item body container will be removed from the DOM when the accordion-item is collapsed. It will be just hidden otherwise.
+     */
+    destroyOnHide: boolean;
+    /**
+     * An event fired when an item is shown.
+     */
+    onShown: () => void;
+    /**
+     * An event fired when an item is hidden.
+     */
+    onHidden: () => void;
+    /**
+     * An event fired when the `visible` value changes.
+     *
+     * Event payload is the new value of visible.
+     */
+    onVisibleChange: (visible: boolean) => void;
+}
+/**
+ * Represents the state of an accordion item.
+ */
+export interface AccordionItemState extends AccordionItemCommonPropsAndState {
+    /**
+     * If `true` the content of the accordion-item collapse should be in DOM. Its value depends on the
+     * value of the `visible` and `destroyOnHide`.
+     */
+    shouldBeInDOM: boolean;
+}
+/**
+ * Represents a widget for an accordion item.
+ */
+export type AccordionItemWidget = Widget<AccordionItemProps, AccordionItemState, AccordionItemApi, AccordionItemDirectives>;
+/**
+ * Retrieve a shallow copy of the default accordion config
+ * @returns the default accordion config
+ */
+export declare function getAccordionDefaultConfig(): AccordionProps;
+/**
+ * Creates a new AccordionItem widget instance.
+ * @param config - config of the accordion item, either as a store or as an object containing values or stores.
+ * @returns a new accordion item widget instance
+ */
+export declare function createAccordionItem(config?: PropsConfig<AccordionItemProps>): AccordionItemWidget;
+/**
+ * Create an accordion WidgetFactory based on an item factory and the list of item props that should inherit from the parent accordion
+ *
+ * @param itemFactory - the item factory
+ * @param accordionItemProps - the list of item props
+ * @param accordionConfig - the default accordion config
+ * @param accordionValidator - the validator of props
+ * @returns the accordion widget factory
+ */
+export declare function factoryCreateAccordion(itemFactory?: WidgetFactory<AccordionItemWidget>, accordionItemProps?: string[], accordionConfig?: AccordionProps, accordionValidator?: ConfigValidator<AccordionProps>): WidgetFactory<AccordionWidget>;
+/**
+ * Creates a new Accordion widget instance.
+ * @param config - config of the accordion, either as a store or as an object containing values or stores.
+ * @returns a new accordion widget instance
+ */
+export declare const createAccordion: WidgetFactory<AccordionWidget>;
+export {};

package/node_modules/@agnos-ui/core/components/accordion/index.cjs

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const accordion = require("../../accordion-BC_9xn23.cjs");
+exports.createAccordion = accordion.createAccordion;
+exports.createAccordionItem = accordion.createAccordionItem;
+exports.factoryCreateAccordion = accordion.factoryCreateAccordion;
+exports.getAccordionDefaultConfig = accordion.getAccordionDefaultConfig;

package/node_modules/@agnos-ui/core/components/accordion/index.d.ts

@@ -0,0 +1 @@
+export * from './accordion';

package/node_modules/@agnos-ui/core/components/accordion/index.js

@@ -0,0 +1,7 @@
+import { c, a, f, g } from "../../accordion-Ca_0T8Bc.js";
+export {
+  c as createAccordion,
+  a as createAccordionItem,
+  f as factoryCreateAccordion,
+  g as getAccordionDefaultConfig
+};

package/node_modules/@agnos-ui/core/components/alert/alert.d.ts

@@ -0,0 +1,37 @@
+import type { CommonAlertApi, CommonAlertDirectives, CommonAlertProps, CommonAlertState } from './common';
+import type { Widget, WidgetFactory } from '../../types';
+/**
+ * Represents the state of an alert component.
+ */
+export interface AlertState extends CommonAlertState {
+}
+/**
+ * Represents the properties for the alert component.
+ */
+export interface AlertProps extends CommonAlertProps {
+}
+/**
+ * Represents the API for an alert component.
+ */
+export interface AlertApi extends CommonAlertApi {
+}
+/**
+ * Represents the directives for an alert component.
+ */
+export interface AlertDirectives extends CommonAlertDirectives {
+}
+/**
+ * Represents an alert widget with specific properties, state, API, and directives.
+ */
+export type AlertWidget = Widget<AlertProps, AlertState, AlertApi, AlertDirectives>;
+/**
+ * Retrieve a shallow copy of the default alert config
+ * @returns the default alert config
+ */
+export declare function getAlertDefaultConfig(): AlertProps;
+/**
+ * Create an AlertWidget with given config props
+ * @param config - an optional alert config
+ * @returns an AlertWidget
+ */
+export declare const createAlert: WidgetFactory<AlertWidget>;

package/node_modules/@agnos-ui/core/components/alert/common.d.ts

@@ -0,0 +1,138 @@
+import type { TransitionFn } from '../../services/transitions/baseTransitions';
+import type { WidgetsCommonPropsAndState } from '../commonProps';
+import type { Directive, PropsConfig, Widget } from '../../types';
+/**
+ * Interface representing the common properties and state for an alert component.
+ */
+export interface CommonAlertCommonPropsAndState extends WidgetsCommonPropsAndState {
+    /**
+     * If `true`, alert can be dismissed by the user.
+     * The close button (×) will be displayed and you can be notified of the event with the (close) output.
+     *
+     * @defaultValue `true`
+     */
+    dismissible: boolean;
+    /**
+     * If `true` the alert is visible to the user
+     *
+     * @defaultValue `true`
+     */
+    visible: boolean;
+    /**
+     * Accessibility close button label
+     *
+     * @defaultValue `'Close'`
+     */
+    ariaCloseButtonLabel: string;
+}
+/**
+ * Represents the state of a common alert component.
+ */
+export interface CommonAlertState extends CommonAlertCommonPropsAndState {
+    /**
+     * Is `true` when the alert is hidden. Compared to `visible`, this is updated after the transition is executed.
+     */
+    hidden: boolean;
+}
+/**
+ * Interface representing the common properties for an alert component.
+ */
+export interface CommonAlertProps extends CommonAlertCommonPropsAndState {
+    /**
+     * Callback called when the alert visibility changed.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    onVisibleChange: (visible: boolean) => void;
+    /**
+     * Callback called when the alert is hidden.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    onHidden: () => void;
+    /**
+     * Callback called when the alert is shown.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    onShown: () => void;
+    /**
+     * The transition function will be executed when the alert is displayed or hidden.
+     *
+     * Depending on the value of `animatedOnInit`, the animation can be optionally skipped during the showing process.
+     *
+     * @defaultValue
+     * ```ts
+     * () => {}
+     * ```
+     */
+    transition: TransitionFn;
+    /**
+     * If `true`, alert opening will be animated.
+     *
+     * Animation is triggered  when the `.open()` function is called
+     * or the visible prop is changed
+     *
+     * @defaultValue `false`
+     */
+    animatedOnInit: boolean;
+    /**
+     * If `true`, alert closing will be animated.
+     *
+     * Animation is triggered  when clicked on the close button (×),
+     * via the `.close()` function or the visible prop is changed
+     *
+     * @defaultValue `true`
+     */
+    animated: boolean;
+}
+/**
+ * Interface representing the common API for alert components.
+ */
+export interface CommonAlertApi {
+    /**
+     * Triggers alert closing programmatically (same as clicking on the close button (×)).
+     *
+     * @param animated - whether the transition should be animated. If the parameter is not defined, the `animated` property is used.
+     */
+    close(animated?: boolean): Promise<void>;
+    /**
+     * Triggers the alert to be displayed for the user.
+     *
+     * @param animated - whether the transition should be animated. If the parameter is not defined, the `animated` property is used.
+     */
+    open(animated?: boolean): Promise<void>;
+}
+/**
+ * Interface representing common alert directives.
+ */
+export interface CommonAlertDirectives {
+    /**
+     * the transition directive, piloting what is the visual effect of going from hidden to visible
+     */
+    transitionDirective: Directive;
+}
+/**
+ * Represents a common alert widget with specified properties, state, API, and directives.
+ */
+export type CommonAlertWidget = Widget<CommonAlertProps, CommonAlertState, CommonAlertApi, CommonAlertDirectives>;
+/**
+ * Retrieve a shallow copy of the default alert config
+ * @returns the default alert config
+ */
+export declare function getCommonAlertDefaultConfig(): CommonAlertProps;
+/**
+ * Create an AlertWidget with given config props
+ * @param config - an optional alert config
+ * @returns an AlertWidget
+ */
+export declare function createCommonAlert(config?: PropsConfig<CommonAlertProps>): CommonAlertWidget;

package/node_modules/@agnos-ui/core/components/alert/index.cjs

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const alert = require("../../alert-AhaliJ17.cjs");
+exports.createAlert = alert.createAlert;
+exports.getAlertDefaultConfig = alert.getAlertDefaultConfig;

package/node_modules/@agnos-ui/core/components/alert/index.d.ts

@@ -0,0 +1 @@
+export * from './alert';

package/node_modules/@agnos-ui/core/components/alert/index.js

@@ -0,0 +1,5 @@
+import { c, g } from "../../alert-Cb9FhbFQ.js";
+export {
+  c as createAlert,
+  g as getAlertDefaultConfig
+};