@m4l/components 8.2.3 → 9.0.0-beta-1

package/.storybook/constants.d.ts

@@ -0,0 +1,21 @@
+import { ThemeUserColor } from '@m4l/styles';
+export declare const MODES: {
+    light: string;
+    dark: string;
+};
+export declare const MODES_BACKGROUNDS: Record<keyof Omit<typeof MODES, 'both'>, string>;
+export declare const MODES_ITEMS: {
+    value: string;
+    title: string;
+}[];
+export declare const DEVICE_TYPES: {
+    automatic: string;
+    mobile: string;
+    desktop: string;
+};
+export declare const DEVICE_TYPES_ITEMS: {
+    value: string;
+    title: string;
+}[];
+export declare const COLORS_THEME: Record<ThemeUserColor, ThemeUserColor>;
+export declare const COLORS_THEME_ITEMS: Record<string, string>[];

package/.storybook/decorators/WithAppearanceContext/WithAppearanceContext.d.ts

@@ -0,0 +1,6 @@
+import { StoryFn } from '@storybook/react';
+/**
+ * Decorador que agrega el contexto de apariencia al story.
+ */
+declare const WithAppearanceContext: (Story: StoryFn) => import("react/jsx-runtime").JSX.Element;
+export default WithAppearanceContext;

package/.storybook/decorators/WithContexts/WithContexts.d.ts

@@ -0,0 +1,5 @@
+import { StoryContext, StoryFn } from '@storybook/react';
+/**
+ * Decorator that adds the context of the theme to the story.
+ */
+export declare const WithContexts: (Story: StoryFn, storyContext: StoryContext) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithContexts/constants.d.ts

@@ -0,0 +1,10 @@
+export declare const USER: string;
+export declare const PWD: string;
+export declare const DATABASE = "";
+export declare const ENVIRONMENT_ASSETS: string;
+export declare const HOST_API_LOCAL: string;
+export declare const HOST_API_REMOTE: string;
+export declare const HOST_STATIC_ASSETS: string;
+export declare const DOMAIN_TOKEN: string;
+export declare const STORYBOOK_MODULE_ID: string;
+export declare const STORYBOOK_ISOLATION_MODULE_ID: string;

package/.storybook/decorators/WithContexts/index.d.ts

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

package/.storybook/decorators/WithContexts/styles.d.ts

@@ -0,0 +1 @@
+export declare const RootStyle: import('@emotion/styled').StyledComponent<import('@mui/system').MUIStyledCommonProps<import('@mui/material/styles').Theme>, import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {}>;

package/.storybook/decorators/WithContexts/subcomponents/AppWithTheme.d.ts

@@ -0,0 +1,6 @@
+import { AppThemeProps } from '../types';
+/**
+ * AppWithTheme es un componente que se encarga de proveer el contexto de tema a la aplicación.
+ *
+ */
+export declare const AppWithTheme: ({ themeMode, themeColor, children }: AppThemeProps) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithContexts/types.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+import { ThemeSettingsType } from '@m4l/graphics';
+export type AppThemeProps = {
+    themeMode: ThemeSettingsType['themeMode'];
+    themeColor: ThemeSettingsType['themeColor'];
+    children: ReactNode;
+};

package/.storybook/decorators/WithDictionaryContext/WithDictionaryContext.d.ts

@@ -0,0 +1,21 @@
+import { default as React } from 'react';
+interface GlobalContextType {
+    data: any;
+    isLoading: boolean;
+    loadDataForFirstStory: () => Promise<void>;
+    checkIncomingData: () => Promise<void>;
+}
+/**
+ * Decorador usado para cargar el diccionario de componente.
+ * Si tiene varias historias, solo se cargará la primera,
+ * la demas esperaran a que la primera termine de llamar la API.
+ */
+export declare const WithDictionaryContext: React.FC<{
+    comps: string[];
+    children: React.ReactNode;
+}>;
+/**
+ * Contexto para extraer el value del contexto
+ */
+export declare const useStoryBookDictionaryContext: () => GlobalContextType;
+export {};

package/.storybook/decorators/WithDictionaryContext/contants.d.ts

@@ -0,0 +1,3 @@
+import { EnvironmentType, HostToolsType } from '@m4l/core';
+export declare const environmentDictionaryContext: EnvironmentType;
+export declare const hostToolsDictionaryContext: HostToolsType;

package/.storybook/decorators/WithDictionaryContext/index.d.ts

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

package/.storybook/decorators/WithForm/WithForm.d.ts

@@ -0,0 +1,8 @@
+import { StoryFn } from '@storybook/react';
+/**
+ * Decorator that adds the form context to the story and triggers validation after a delay.
+ */
+export declare const WithForms: ({ values, validationSchema }: {
+    values?: {} | undefined;
+    validationSchema?: {} | undefined;
+}) => (Story: StoryFn) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithForm/index.d.ts

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

package/.storybook/decorators/WithFormAutoValidation/WithFormAutoValidation.d.ts

@@ -0,0 +1,7 @@
+import { StoryFn } from '@storybook/react';
+/**
+ * Decorador para que el Story ejecute automaticamente las validaciones de react-hook-fom.
+ * Se debe usar con el decorador WithForm que es el que configura el formulario y su contexto.
+ * @param Story
+ */
+export declare const WithFormAutoValidation: (Story: StoryFn) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithFormAutoValidation/index.d.ts

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

package/.storybook/decorators/WithPopupsProvider/WithPopupsProvider.d.ts

@@ -0,0 +1,10 @@
+import { StoryFn, StoryContext } from '@storybook/react';
+/**
+ * Decora la historia con el proveedor de popups.
+ * Este decorador envuelve la historia en un `PopupsProvider` y un `WindowsContainer`,
+ * permitiendo que los popups se rendericen dentro de un contenedor específico.
+ * @param MyStory - La historia de Storybook que se está decorando.
+ * @param context - El contexto de la historia, que incluye los parámetros.
+ * @returns Un componente envuelto en el proveedor de popups.
+ */
+export declare const WithPopupsProvider: (MyStory: StoryFn, { parameters }: StoryContext) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithPopupsProvider/index.d.ts

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

package/.storybook/decorators/WithScaleIcons/WithScaleIcons.d.ts

@@ -0,0 +1,7 @@
+import { StoryFn } from '@storybook/react';
+/**
+ * Decorador para escalar íconos en las historias de Storybook.
+ * @param MyStory
+ * @param context
+ */
+export declare const WithScaleIcons: (Story: StoryFn) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithScaleIcons/index.d.ts

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

package/.storybook/decorators/WithWindowsContainer/WithWindowsContainer.d.ts

@@ -0,0 +1,5 @@
+import { StoryFn } from '@storybook/react';
+/**
+ * Decora la historia con el proveedor de popups, puede recibir initialPopups como parametro de ella
+ */
+export declare const WithWindowsContainer: (MyStory: StoryFn) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithWindowsContainer/index.d.ts

@@ -0,0 +1,2 @@
+export * from './WithWindowsContainer';
+export { WindowsContainer } from './subcomponents/WindowsContainer';

package/.storybook/decorators/WithWindowsContainer/subcomponents/WindowsContainer/WindowsContainer.d.ts

@@ -0,0 +1,5 @@
+import { WindowsContainerProps } from './types';
+/**
+ * Contendor de ventanas
+ */
+export declare const WindowsContainer: import('react').ForwardRefExoticComponent<WindowsContainerProps & import('react').RefAttributes<HTMLDivElement>>;

package/.storybook/decorators/WithWindowsContainer/subcomponents/WindowsContainer/index.d.ts

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

package/.storybook/decorators/WithWindowsContainer/subcomponents/WindowsContainer/types.d.ts

@@ -0,0 +1,4 @@
+export type WindowsContainerProps = {
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+};

package/.storybook/decorators/WithWindowsContainerSizer/WithWindowsContainerSizer.d.ts

@@ -0,0 +1,5 @@
+import { StoryContext, StoryFn } from '@storybook/react';
+/**
+ * con contenedor extendido
+ */
+export declare const WithWindowsContainerSizer: (MyStory: StoryFn, context: StoryContext) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithWrapper/WithWrapper.d.ts

@@ -0,0 +1,24 @@
+import { StoryFn } from '@storybook/react';
+import { WithWrapperParameters } from './types';
+/**
+ * Un decorador de Storybook que envuelve una historia dentro de un contenedor centrado con
+ * altura, ancho y otros parámetros de estilo personalizables.
+ * @param {StoryFn} Story - La función de la historia que renderiza el componente.
+ * @param {object} context - El objeto de contexto que contiene los parámetros de Storybook.
+ * @param {Parameters} context.parameters - Parámetros personalizados para el contenedor, incluyendo `height` y `width`.
+ * @returns {JSX.Element} - Un elemento `div` que envuelve y centra la historia.
+ * @example
+ * // Uso en una historia de Storybook:
+ * export default {
+ *   title: 'MiComponente',
+ *   decorators: [WithWrapper],
+ * };
+ *
+ * const Template = (args) => <MiComponente {...args} />;
+ *
+ * export const Default = Template.bind({});
+ * Default.parameters = { height: '200px', width: '200px' };
+ */
+export declare const WithWrapper: (Story: StoryFn, { parameters }: {
+    parameters: WithWrapperParameters;
+}) => import("react/jsx-runtime").JSX.Element;

package/.storybook/decorators/WithWrapper/index.d.ts

@@ -0,0 +1 @@
+export { WithWrapper } from './WithWrapper';

package/.storybook/decorators/WithWrapper/types.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Interfaz que define los parámetros personalizados aceptados por el decorador `WithWrapper`.
+ * [height] - Altura opcional del contenedor. Por defecto es '100px'.
+ * [width] - Ancho opcional del contenedor. Por defecto es '100px'.
+ * [key: string] - Propiedades adicionales opcionales que se aplicarán al estilo del contenedor.
+ */
+export interface WithWrapperParameters {
+    height?: string;
+    width?: string;
+    [key: string]: any;
+}

package/.storybook/decorators/index.d.ts

@@ -0,0 +1,7 @@
+export * from './WithContexts';
+export * from './WithPopupsProvider';
+export * from './WithForm';
+export * from './WithFormAutoValidation';
+export * from './WithWindowsContainer';
+export * from './WithScaleIcons';
+export * from './WithWrapper';

package/.storybook/main.d.ts

@@ -0,0 +1,3 @@
+import { StorybookConfig } from '@storybook/react-vite';
+declare const config: StorybookConfig;
+export default config;

package/.storybook/mocks/config-msw.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Initializes Mock Service Worker (MSW) for Storybook
+ *
+ * MSW is used to intercept and mock network requests during development and testing.
+ * This initialization configures MSW to work with Storybook's environment.
+ *
+ * Configuration details:
+ * - Sets up the service worker with the correct path based on the environment
+ * - Handles unhandled requests by bypassing them
+ * - Configures the service worker scope
+ *
+ * Environment-specific paths:
+ * - Development: /mockServiceWorker.js
+ * - Review (MR): /{library_name}/{branch_name}/mockServiceWorker.js
+ *
+ * The path is determined by the VITE_STORYBOOK_BASE_PATH environment variable:
+ * - If set, prepends the value to the service worker path
+ * - If not set, uses the root path
+ * @see https://github.com/mswjs/msw-storybook-addon#configuring-msw
+ */
+export declare const initializeMSW: () => void;

package/.storybook/mocks/index.d.ts

@@ -0,0 +1,2 @@
+export * from './network-mocks';
+export * from './config-msw';

package/.storybook/mocks/network-mocks.d.ts

@@ -0,0 +1 @@
+export declare const mswHandlers: import('msw').HttpHandler[];

package/.storybook/storybook.vite.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vite').UserConfig;
+export default _default;

package/.storybook/utils/getGlobalsFromSearchParams.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Función que obtiene los parametros de la URL
+ */
+export declare function getGlobalsUrlParams(): {
+    mode: any;
+    preset: any;
+};