@widergy/energy-ui 3.173.2 → 3.173.4

package/dist/esm/components/UTCBUInput/versions/V1/README.md

@@ -1,46 +0,0 @@
-# UTCBUInput
-
-## Description
-
-`UTCBUInput` is a configurable input component for handling CBU (Clave Bancaria Uniforme) numbers, often used in banking contexts. It allows users to input a CBU number and automatically detects the corresponding entity (e.g., bank name) based on predefined rules. The component provides validation feedback, supports error messages, and can be customized through various props.
-
-## Props
-
-| Name                | Type                                                                       | Default | Description                                                                                                |
-| ------------------- | -------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
-| entityConfiguration | shape({ cbu_number_key: string, cbu_entity_key: string, entities: array }) |         | Configuration for handling CBU numbers, including keys for CBU number and entity, and entity list.         |
-| error               | string                                                                     |         | Error message to display below the input field.                                                            |
-| onChange            | func                                                                       |         | Callback function triggered when the input value changes. Returns an object containing the CBU and entity. |
-| value               | shape({ cbuNumber: string, entityName: string })                           | `{}`    | Initial value for the CBU input. Expected format is an object with `cbuNumber` and `entityName`.           |
-| ...props            | any                                                                        |         | Inherits all other props from `UTTextInput`.                                                               |
-
-### Entity Configuration
-
-The `entityConfiguration` prop defines the configuration for CBU numbers and includes the following keys:
-
-- **cbu_number_key**: The key for accessing the CBU number within the `value` object.
-- **cbu_entity_key**: The key for accessing the entity name within the `value` object.
-- **entities**: An array of objects, each containing `expression` (a regex pattern to match the CBU) and `entity_name` (the name of the entity to display).
-
-### Handling Errors and Validations
-
-Errors and validations are managed through the `error` and `validations` props:
-
-- The `error` prop will display an error message below the input if a validation fails.
-- The `validations` prop displays the detected entity name in a validation format if the CBU is valid.
-
-If the `error` prop is set, any entity-related validation message will be hidden, ensuring only one validation message appears at a time.
-
-### Example Configuration for entityConfiguration
-
-```javascript
-const fieldConfiguration = {
-  cbu_number_key: 'CBU',
-  cbu_entity_key: 'BANK',
-  entities: [
-    { expression: '^005', entity_name: 'A.B.N. AMRO BANK N.V.' },
-    { expression: '^006', entity_name: 'BANCO SUDAMERIS' }
-    // Additional entities...
-  ]
-};
-```

package/dist/esm/components/UTCarousel/README.md

@@ -1,65 +0,0 @@
-# UTCarousel
-
-Carousel de imágenes con soporte para autoplay, swipe táctil, flechas de navegación y puntos indicadores. Cada slide puede renderizar una imagen de fondo o contenido React custom.
-
-## Props
-
-| Prop | Tipo | Default | Descripción |
-|---|---|---|---|
-| `imgArray` | `array` | — | Array de slides. Ver estructura abajo. |
-| `autoPlay` | `bool` | `false` | Activa el avance automático entre slides. |
-| `autoPlayDelay` | `number` | `2000` | Milisegundos entre slides en autoplay. |
-| `height` | `string` | valor SCSS | Altura del carousel (ej. `'200px'`, `'var(--carousel-banner-height)'`). |
-| `legend` | `shape` | — | Configuración de puntos indicadores. `{ position: 'inside' \| 'outside' }`. Si no se pasa, no se muestran puntos. |
-| `arrow` | `shape` | — | Configuración de flechas. `{ position: 'inside' \| 'outside', arrowCustomLeft, arrowCustomRight, callbackLeft, callbackRight }`. |
-| `activeEvents` | `bool` | — | Habilita/deshabilita eventos de puntero. |
-| `borderSize` | `number` | — | Tamaño del borde entre slides. |
-| `className` | `string` | — | Clase CSS adicional para el contenedor. |
-| `classes` | `object` | — | Override de clases CSS internas (ej. `{ image: 'miClase' }`). |
-
-### Estructura de `imgArray`
-
-```js
-[
-  {
-    id: 1,           // recomendado para keys estables
-    imgSrc: '...',   // URL de imagen de fondo (cuando no se usa renderContent)
-    onClick: fn,     // handler de click (cuando no se usa renderContent)
-    renderContent: <MiComponente />  // contenido React custom (reemplaza imgSrc)
-  }
-]
-```
-
-Cuando se provee `renderContent`, el slide renderiza ese nodo directamente en lugar de la imagen de fondo. El componente pasado es responsable de manejar su propio click y dimensiones.
-
-## Uso básico — imágenes
-
-```jsx
-<UTCarousel
-  imgArray={[
-    { imgSrc: '/banner1.jpg', onClick: () => navigate('/promo1') },
-    { imgSrc: '/banner2.jpg', onClick: () => navigate('/promo2') }
-  ]}
-  autoPlay
-  autoPlayDelay={5000}
-  height="200px"
-/>
-```
-
-## Uso con contenido custom
-
-```jsx
-<UTCarousel
-  imgArray={[
-    { id: 1, renderContent: <BannerItem item={item1} onClick={fn1} /> },
-    { id: 2, renderContent: <BannerItem item={item2} onClick={fn2} /> }
-  ]}
-  autoPlay
-  autoPlayDelay={7000}
-  height="var(--carousel-banner-height)"
-/>
-```
-
-## Sin puntos indicadores
-
-No pasar la prop `legend` para ocultar los dots.

package/dist/esm/components/UTCheckbox/UTCheckbox.mdx

@@ -1,13 +0,0 @@
-import { ArgTypes, Canvas, Description, Meta, Title } from '@storybook/blocks';
-
-import * as UTCheckboxStories from './UTCheckbox.stories.js';
-
-<Meta of={UTCheckboxStories} />
-
-<Title>UTCheckbox</Title>
-
-<Description of={UTCheckboxStories} />
-
-<Canvas of={UTCheckboxStories.Playground} withToolbar />
-
-<ArgTypes exclude={['classes']} />

package/dist/esm/components/UTCheckbox/UTCheckbox.stories.js

@@ -1,231 +0,0 @@
-function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
-import React from 'react';
-import { useArgs } from '@storybook/preview-api';
-import { joinArgTypes } from 'stories/utils';
-import UTCheckbox from '.';
-export default {
-  title: 'Energy-UI/UTCheckbox',
-  component: UTCheckbox,
-  args: {
-    version: 'V1',
-    title: 'Checkbox Label'
-  },
-  argTypes: {
-    version: {
-      control: 'inline-radio',
-      options: ['V0', 'V1'],
-      description: 'Versión del componente a utilizar.',
-      table: {
-        defaultValue: {
-          summary: 'V1'
-        },
-        type: {
-          summary: joinArgTypes(['V0', 'V1'])
-        }
-      }
-    },
-    value: {
-      control: 'boolean',
-      description: 'Estado del checkbox (marcado/no marcado).',
-      table: {
-        defaultValue: {
-          summary: 'false'
-        },
-        type: {
-          summary: 'boolean'
-        }
-      }
-    },
-    disabled: {
-      control: 'boolean',
-      description: 'Determina si el checkbox está deshabilitado.',
-      table: {
-        defaultValue: {
-          summary: 'false'
-        },
-        type: {
-          summary: 'boolean'
-        }
-      }
-    },
-    label: {
-      control: 'text',
-      description: 'Texto de la etiqueta.',
-      table: {
-        type: {
-          summary: 'string'
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V0'
-      }
-    },
-    color: {
-      control: 'select',
-      options: ['primary', 'secondary'],
-      description: 'Color del componente (Material-UI).',
-      table: {
-        defaultValue: {
-          summary: 'primary'
-        },
-        type: {
-          summary: joinArgTypes(['primary', 'secondary'])
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V0'
-      }
-    },
-    title: {
-      control: 'text',
-      description: 'Label para el checkbox.',
-      table: {
-        type: {
-          summary: 'string'
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V1'
-      }
-    },
-    variant: {
-      control: 'select',
-      options: ['default', 'button'],
-      description: 'Variante de estilo.',
-      table: {
-        defaultValue: {
-          summary: 'default'
-        },
-        type: {
-          summary: joinArgTypes(['default', 'button'])
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V1'
-      }
-    },
-    required: {
-      control: 'boolean',
-      description: 'Indica si el campo es obligatorio.',
-      table: {
-        defaultValue: {
-          summary: 'false'
-        },
-        type: {
-          summary: 'boolean'
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V1'
-      }
-    },
-    indeterminate: {
-      control: 'boolean',
-      description: 'Determina si el checkbox está en estado indeterminado.',
-      table: {
-        defaultValue: {
-          summary: 'false'
-        },
-        type: {
-          summary: 'boolean'
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V1'
-      }
-    },
-    withUpperTitle: {
-      control: 'boolean',
-      description: 'Determina si se debe mostrar el título superior.',
-      table: {
-        defaultValue: {
-          summary: 'false'
-        },
-        type: {
-          summary: 'boolean'
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V1'
-      }
-    },
-    reversed: {
-      control: 'boolean',
-      description: 'Invierte el orden del checkbox y la etiqueta.',
-      table: {
-        defaultValue: {
-          summary: 'false'
-        },
-        type: {
-          summary: 'boolean'
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V1'
-      }
-    },
-    icon: {
-      control: 'text',
-      description: 'Icono accesorio.',
-      table: {
-        type: {
-          summary: 'string'
-        }
-      },
-      if: {
-        arg: 'version',
-        eq: 'V1'
-      }
-    }
-  },
-  parameters: {
-    docs: {
-      description: {
-        component: 'Componente de checkbox que soporta dos versiones (V0 y V1) con diferentes estilos y funcionalidades.'
-      }
-    }
-  }
-};
-const Template = args => {
-  const [{
-    value
-  }, updateArgs] = useArgs();
-  const handleChange = newValue => {
-    updateArgs({
-      value: newValue
-    });
-    if (args.onChange) args.onChange(newValue);
-  };
-  return /*#__PURE__*/React.createElement(UTCheckbox, _extends({}, args, {
-    value: value,
-    onChange: handleChange
-  }));
-};
-export const Playground = {
-  render: Template,
-  name: 'Playground'
-};
-export const VersionV0 = {
-  args: {
-    version: 'V0',
-    label: 'Versión V0'
-  },
-  render: Template,
-  name: 'Versión V0'
-};
-export const VersionV1 = {
-  args: {
-    version: 'V1',
-    title: 'Versión V1'
-  },
-  render: Template,
-  name: 'Versión V1'
-};

package/dist/esm/components/UTCheckbox/versions/V1/README.md

@@ -1,41 +0,0 @@
-# UTCheckbox
-
-## Description
-
-`UTCheckbox` is a customizable checkbox component. It supports various states such as checked, indeterminate, and disabled. Additionally, it includes the option to display a title and supports markdown for advanced formatting.
-
-## Props
-
-| Name               | Type             | Default   | Description                                                                           |
-| ------------------ | ---------------- | --------- | ------------------------------------------------------------------------------------- |
-| actions            | object           |           | Actions to render within `UTFieldLabel`.                                              |
-| checkboxDataTestId | string           |           | Box `data-testid`.                                                                    |
-| classNames         | objectOf(string) |           | Additional class names to apply for further styling.                                  |
-| CustomComponent    | elementType      |           | Custom component to render data next to the checkbox                                  |
-| dataTestId         | string           |           | Whole component `data-testid`.                                                        |
-| disabled           | bool             | false     | Disables the checkbox, making it unclickable.                                         |
-| indeterminate      | bool             | false     | Indicates if the checkbox is in an indeterminate state.                               |
-| isSimple           | bool             | false     | **Deprecated**: Please avoid using this property in future implementations.           |
-| onChange           | func             |           | Function to call when the checkbox state changes.                                     |
-| required           | bool             | false     | Indicates if the checkbox is required.                                                |
-| spacing            | string           | 'medium'  | Defines the spacing between the checkbox and the label. Can be 'small' or 'medium'.   |
-| title              | string           |           | Title to display next to the checkbox. Supports markdown when `withMarkdown` is true. |
-| value              | bool             | false     | Indicates if the checkbox is checked.                                                 |
-| variant            | string           | 'default' | Defines the visual variant of the checkbox.                                           |
-
-## Usage
-
-### Basic Example
-
-```jsx
-import React from 'react';
-import UTCheckbox from './UTCheckbox';
-
-const Example = () => {
-  const [checked, setChecked] = React.useState(false);
-
-  return <UTCheckbox value={checked} title="Check me" onChange={() => setChecked(!checked)} />;
-};
-
-export default Example;
-```

package/dist/esm/components/UTChip/README.md

@@ -1,208 +0,0 @@
-# UTChip Component
-
-## Overview
-
-`UTChip` is a compact, interactive component used to display information or actions in a condensed format. Chips are commonly used for tags, filters, selections, or quick actions. They can be interactive (clickable) or static, and support various visual states including active, disabled, and different variants.
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `active` | `bool` | `false` | Indicates whether the chip is in an active state. Affects styling and colors. |
-| `adornment` | `shape` | `undefined` | Optional decorative element displayed before the text. See [Adornments](#adornments) section. |
-| `children` | `string` | Required | The text content displayed inside the chip. |
-| `dataTestId` | `string` | `undefined` | Test ID for testing purposes. |
-| `disabled` | `bool` | `false` | Disables the chip, preventing interactions and changing its appearance. |
-| `isDragging` | `bool` | `false` | Indicates whether the chip is being dragged or moved. Useful for drag and drop interactions. |
-| `onClick` | `func` | `undefined` | Callback function triggered when the chip is clicked. If provided, the chip becomes interactive and displays a close button. |
-| `onClose` | `func` | `undefined` | Callback function triggered when the close button (X) is clicked. Only displayed if `onClick` is provided. |
-| `size` | `oneOf(['medium', 'small'])` | `'medium'` | The size of the chip. Affects padding and text size. |
-| `variant` | `oneOf(['default', 'outline'])` | `'default'` | Visual style variant. `default` uses filled background, `outline` uses border-only style. |
-
-## Adornments
-
-Chips can display optional decorative elements before the text. The `adornment` prop accepts an object with the following structure:
-
-```javascript
-{
-  type: 'icon' | 'avatar' | 'image',
-  props: { /* component-specific props */ }
-}
-```
-
-### Adornment Types
-
-| Type | Component | Description | Example Props |
-|------|-----------|-------------|----------------|
-| `icon` | `UTIcon` | Displays an icon from the icon library. | `{ name: 'IconCheck', size: 20 }` |
-| `avatar` | `UTAvatar` | Displays a user avatar. | `{ src: 'url', alt: 'User Name' }` |
-| `image` | `img` | Displays a custom image. | `{ src: 'url', alt: 'Image' }` |
-
-## Variants
-
-### Default Variant
-Filled background with solid colors. Best for primary actions or selections.
-
-### Outline Variant
-Border-only style with transparent background. Best for secondary actions or filters.
-
-## Sizes
-
-### Medium (default)
-Standard size suitable for most use cases.
-
-### Small
-Compact size for space-constrained layouts.
-
-## Color Themes
-
-The chip's colors change based on its state:
-
-- **Active + Default variant**: Light background with negative (red) close button
-- **Active + Outline variant**: Accent-colored border with primary (blue) close button
-- **Inactive**: Gray text and close button
-- **Disabled**: Gray appearance, no interactions
-
-## Usage Examples
-
-### Basic Chip
-```jsx
-<UTChip>Basic Chip</UTChip>
-```
-
-### Interactive Chip with Close Button
-```jsx
-<UTChip 
-  onClick={() => console.log('Chip clicked')}
-  onClose={() => console.log('Chip closed')}
->
-  Closeable Chip
-</UTChip>
-```
-
-### Active Chip
-```jsx
-<UTChip active>
-  Active Chip
-</UTChip>
-```
-
-### Chip with Icon Adornment
-```jsx
-<UTChip 
-  adornment={{
-    type: 'icon',
-    props: { name: 'IconCheck' }
-  }}
->
-  Chip with Icon
-</UTChip>
-```
-
-### Chip with Avatar Adornment
-```jsx
-<UTChip 
-  adornment={{
-    type: 'avatar',
-    props: { src: 'avatar-url', alt: 'User' }
-  }}
->
-  User Chip
-</UTChip>
-```
-
-### Chip with Image Adornment
-```jsx
-<UTChip 
-  adornment={{
-    type: 'image',
-    props: { src: 'image-url', alt: 'Image' }
-  }}
->
-  Image Chip
-</UTChip>
-```
-
-### Small Outline Variant
-```jsx
-<UTChip 
-  size="small"
-  variant="outline"
-  onClick={() => {}}
-  onClose={() => {}}
->
-  Filter Tag
-</UTChip>
-```
-
-### Disabled Chip
-```jsx
-<UTChip disabled>
-  Disabled Chip
-</UTChip>
-```
-
-### Dragging Chip
-```jsx
-<UTChip 
-  isDragging={true}
-  onClick={() => console.log('Chip clicked')}
-  onClose={() => console.log('Chip closed')}
->
-  Draggable Chip
-</UTChip>
-```
-
-### Multiple Chips (Tag List)
-```jsx
-const tags = ['React', 'JavaScript', 'UI'];
-
-{tags.map(tag => (
-  <UTChip 
-    key={tag}
-    onClick={() => selectTag(tag)}
-    onClose={() => removeTag(tag)}
-  >
-    {tag}
-  </UTChip>
-))}
-```
-
-## Behavior
-
-### Interactive Behavior
-- When `onClick` is provided, the chip becomes interactive and displays a close button (X)
-- The close button triggers the `onClose` callback
-- The chip's appearance changes based on the `active` state
-
-### Text Sizing
-- Text size automatically adjusts based on the `size` prop:
-  - `medium`: Uses `body` text variant
-  - `small`: Uses `small` text variant
-
-### Styling
-- The component uses CSS modules for styling
-- Classes are applied dynamically based on props: `size`, `variant`, `active`, and `disabled`
-- Adornments are styled to fit within the chip's layout
-
-## Accessibility
-
-- Use `dataTestId` for testing and accessibility testing
-- Ensure the chip text is descriptive and meaningful
-- When used as a filter or selection, provide clear visual feedback with the `active` state
-- Disabled chips should have appropriate visual indication
-
-## Related Components
-
-- **UTLabel**: Used internally for text rendering
-- **UTButton**: Used internally for the close button
-- **UTIcon**: Used for icon adornments
-- **UTAvatar**: Used for avatar adornments
-- **UTTouchableWithoutFeedback**: Used for interactive container when `onClick` is provided
-
-## Notes
-
-- The component is memoized for performance optimization
-- Adornment props are merged with default props specific to each adornment type
-- The close button only appears when `onClick` is provided
-- Color themes are automatically managed based on the `active` and `variant` states

package/dist/esm/components/UTChip/UTChip.mdx

@@ -1,11 +0,0 @@
-import { ArgTypes, Description, Meta, Title } from '@storybook/blocks';
-
-import * as UTChip from './UTChip.stories';
-
-<Meta of={UTChip} />
-
-<Title>UTChip</Title>
-
-<Description of={UTChip} />
-
-<ArgTypes />