@axzydev/axzy_ui_system 1.4.8 → 1.5.0

package/src/components/molecules/form-header/form-header.stories.tsx

@@ -1,52 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import ITFormHeader from '@/components/molecules/form-header/form-header';
-
-const meta = {
-  title: 'Components/Feedback/ITFormHeader',
-  component: ITFormHeader,
-  parameters: { layout: 'centered' },
-  argTypes: {
-    title: { control: 'text', description: 'The title displayed in the header' },
-    onClose: { control: false, description: 'Optional close button handler' },
-    className: { control: 'text', description: 'Additional CSS classes' },
-  },
-} satisfies Meta<typeof ITFormHeader>;
-
-export default meta;
-type Story = StoryObj<typeof meta>;
-
-export const Default: Story = {
-  args: { title: 'Form Header' },
-  render: (args) => (
-    <div className="w-80">
-      <ITFormHeader {...args} />
-    </div>
-  ),
-};
-
-export const WithClose: Story = {
-  args: { title: 'Editable Form' },
-  render: (args) => (
-    <div className="w-80">
-      <ITFormHeader {...args} onClose={() => alert('Close clicked')} />
-    </div>
-  ),
-};
-
-export const LongTitle: Story = {
-  args: { title: 'Confirmación de Auditoría de Expediente Clínico' },
-  render: (args) => (
-    <div className="w-80">
-      <ITFormHeader {...args} />
-    </div>
-  ),
-};
-
-export const ShortTitle: Story = {
-  args: { title: 'Edit' },
-  render: (args) => (
-    <div className="w-80">
-      <ITFormHeader {...args} />
-    </div>
-  ),
-};

package/src/components/molecules/masked-input/masked-input.doc.mdx

@@ -1,78 +0,0 @@
-import { Meta, Title, Description, Primary, Controls, Stories } from '@storybook/blocks';
-import * as StoriesData from './masked-input.stories';
-
-<Meta of={StoriesData} />
-
-# ITMaskedInput
-
-Input con máscara de formato: defines un patrón y el usuario solo escribe los caracteres útiles; los separadores se insertan solos y los huecos se pintan con un carácter de relleno.
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `name` | `string` | required | Nombre del campo para formularios. |
-| `mask` | `string` | required | Patrón: `9`=dígito, `A`=letra (mayúscula), `a`=letra, `x`=alfanumérico, `*`=cualquiera. Cualquier otro carácter es un separador literal auto-insertado. |
-| `value` | `string` | — | Valor limpio (raw): solo caracteres útiles, sin separadores ni relleno. |
-| `onChange` | `(e) => void` | required | `e.target.value` es el valor raw. |
-| `onBlur` | `(e) => void` | — | Blur del input. |
-| `onComplete` | `(value) => void` | — | Dispara cuando la máscara queda llena. |
-| `pattern` | `RegExp` | — | Regex validada con full-match contra el raw en blur; si no cumple muestra error. |
-| `placeholderChar` | `string` | `"_"` | Carácter pintado en slots vacíos. |
-| `variant` | `ColorsTypes` | `"primary"` | Color de acento del tema. |
-| `size` | `"sm" \| "md" \| "lg"` | `"md"` | Tamaño del input. |
-| `label` | `string` | — | Etiqueta sobre el input. |
-| `disabled` | `boolean` | `false` | Desactiva el input. |
-| `required` | `boolean` | `false` | Marca el campo como requerido. |
-| `touched` | `boolean` | `false` | Indica si el campo fue tocado. |
-| `error` | `string \| boolean` | — | Estado de error. |
-| `className` | `string` | — | Clases del wrapper externo. |
-| `containerClassName` | `string` | — | Clases del contenedor del input. |
-| `iconLeft` / `iconRight` | `ReactNode` | — | Iconos laterales. |
-| `autoFocus` | `boolean` | `false` | Enfoca al montar. |
-
-## Tokens del mask
-
-| Token | Acepta |
-|-------|--------|
-| `9` | un dígito |
-| `A` | una letra (se guarda en mayúsculas) |
-| `a` | una letra (tal cual) |
-| `x` | un carácter alfanumérico |
-| `*` | cualquier carácter |
-| cualquier otro | literal insertado solo (p.ej. `-`, `/`, `(`, `)`, espacio) |
-
-## Usage
-
-```tsx
-import { ITMaskedInput } from '@axzydev/axzy_ui_system';
-
-// Código de activación
-<ITMaskedInput
-  name="code"
-  mask="xxxx-xxxx-xxxx"
-  label="Código"
-  onChange={(e) => setCode(e.target.value)}
-/>
-
-// Teléfono con validación regex sobre el valor limpio
-<ITMaskedInput
-  name="phone"
-  mask="(999) 999-9999"
-  pattern={/^\d{10}$/}
-  onChange={(e) => setPhone(e.target.value)}
-/>
-```
-
-## Notes
-
-- ¿El valor? **Solo caracteres útiles**: escribir `ABC1-2345-6789` devuelve `ABC123456789` en `onChange`.
-- El cursor salta a huecos vacíos con selección automática; borrar un separador lo vuelve a insertar.
-- `pattern` valida contra el raw completo (full-match); el mensaje de error genérico es "Formato inválido" salvo que pases `error` como string.
-- `onComplete` es ideal para tarjetas, CVV o códigos de un solo uso.
-
-## Stories
-
-<Primary />
-<Controls />
-<Stories />

package/src/components/molecules/masked-input/masked-input.stories.tsx

@@ -1,126 +0,0 @@
-import type { Meta } from '@storybook/react';
-import { useState } from 'react';
-import ITMaskedInput from './masked-input';
-
-const meta = {
-  title: 'Components/Form Elements/ITMaskedInput',
-  component: ITMaskedInput,
-  parameters: { layout: 'padded' },
-  argTypes: {
-    mask: { control: 'text' },
-    placeholderChar: { control: 'text' },
-    onChange: { action: 'changed' },
-    onComplete: { action: 'completed' },
-    disabled: { control: 'boolean' },
-    error: { control: 'text' },
-    variant: {
-      control: 'select',
-      options: ['primary', 'secondary', 'success', 'danger', 'warning', 'info', 'purple', 'gray'],
-    },
-    size: { control: 'select', options: ['sm', 'md', 'lg'] },
-  },
-} satisfies Meta<typeof ITMaskedInput>;
-
-export default meta;
-
-function CodeMaskedWrapper(args: any) {
-  const [value, setValue] = useState<string>('');
-  return (
-    <div className="w-full max-w-xs">
-      <ITMaskedInput
-        {...args}
-        value={value}
-        onChange={(e) => {
-          setValue(e.target.value);
-          args.onChange(e);
-        }}
-      />
-      <p className="mt-2 text-xs font-mono text-slate-500">
-        raw: {value || '(vacío)'}
-      </p>
-    </div>
-  );
-}
-
-export const Alphanumeric: any = {
-  render: CodeMaskedWrapper,
-  args: {
-    name: 'code',
-    label: 'Código único',
-    mask: 'xxxx-xxxx-xxxx',
-  },
-};
-
-export const Phone: any = {
-  render: CodeMaskedWrapper,
-  args: {
-    name: 'phone',
-    label: 'Teléfono',
-    mask: '(999) 999-9999',
-  },
-};
-
-export const CreditCard: any = {
-  render: CodeMaskedWrapper,
-  args: {
-    name: 'card',
-    label: 'Número de tarjeta',
-    mask: '9999-9999-9999-9999',
-    onComplete: undefined,
-  },
-};
-
-const PhoneValidatedWrapper = (args: any) => {
-  const [value, setValue] = useState<string>('5512345678');
-  const [complete, setComplete] = useState<string | null>(null);
-  return (
-    <div className="w-full max-w-xs">
-      <ITMaskedInput
-        {...args}
-        value={value}
-        onChange={(e) => {
-          setValue(e.target.value);
-          args.onChange(e);
-          setComplete(null);
-        }}
-        onComplete={(v) => setComplete(v)}
-      />
-      {complete && (
-        <p className="mt-2 text-xs font-mono text-emerald-600">
-          ¡Completo! raw: {complete}
-        </p>
-      )}
-    </div>
-  );
-};
-
-export const WithPattern: any = {
-  render: PhoneValidatedWrapper,
-  args: {
-    name: 'validated_phone',
-    label: 'Teléfono válido (regex)',
-    mask: '999-999-9999',
-    pattern: /^\d{9}$/,
-  },
-};
-
-export const Sizes: any = {
-  render: () => (
-    <div className="flex flex-col gap-4 w-full max-w-xs">
-      <ITMaskedInput name="sz_sm" label="Small" mask="xxxx-xxxx" size="sm" onChange={() => {}} />
-      <ITMaskedInput name="sz_md" label="Medium" mask="xxxx-xxxx" size="md" onChange={() => {}} />
-      <ITMaskedInput name="sz_lg" label="Large" mask="xxxx-xxxx" size="lg" onChange={() => {}} />
-    </div>
-  ),
-};
-
-export const Disabled: any = {
-  args: {
-    name: 'disabled_code',
-    label: 'Deshabilitado',
-    mask: 'xxxx-xxxx',
-    value: 'abcd',
-    disabled: true,
-    onChange: () => {},
-  },
-};

package/src/components/molecules/multi-select/multi-select.doc.mdx

@@ -1,55 +0,0 @@
-import { Meta, Title, Description, Primary, Controls, Stories } from '@storybook/blocks';
-import * as StoriesData from './multi-select.stories';
-
-<Meta of={StoriesData} />
-
-# ITMultiSelect
-
-Multi-value select with searchable dropdown, removable chips, and keyboard navigation.
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `options` | `ITMultiSelectOption[]` | — | Available options `{ label, value, ...custom }`. |
-| `value` | `(string \| number)[]` | — | Selected values (controlled). |
-| `onChange` | `(values, options) => void` | — | Fired with the next selected values. |
-| `label` | `string` | — | Label above the control. |
-| `placeholder` | `string` | `"Selecciona opciones"` | Placeholder when empty. |
-| `valueField` | `string` | `"value"` | Field used as the option value. |
-| `labelField` | `string` | `"label"` | Field used as the option label. |
-| `size` | `"sm" \| "md" \| "lg"` | `"md"` | Control size. |
-| `maxVisibleChips` | `number` | `3` | Chips shown before collapsing into `+N`. |
-| `clearable` | `boolean` | `true` | Shows a clear-all (X) button. |
-| `searchable` | `boolean` | `true` | Enables the search input. |
-| `onSearch` | `(query) => void` | — | Server-side search callback. |
-| `isLoading` | `boolean` | `false` | Loading state for remote options. |
-| `noResultsMessage` | `string` | `"No se encontraron resultados"` | Empty-results message. |
-| `renderOption` | `(option, { isSelected, searchTerm }) => ReactNode` | — | Custom option template. |
-| `disabled` / `readOnly` / `required` / `touched` / `error` | — | — | Standard form states. |
-
-## Usage
-
-```tsx
-import { ITMultiSelect } from '@axzydev/axzy_ui_system';
-
-<ITMultiSelect
-  label="Skills"
-  options={skills}
-  value={selected}
-  onChange={(values) => setSelected(values)}
-  maxVisibleChips={3}
-/>
-```
-
-## Notes
-
-- Keyboard: `ArrowUp`/`ArrowDown` navigate, `Enter` toggles, `Backspace` removes the last chip, `Esc` closes.
-- `role="combobox"` + `role="listbox"` (`aria-multiselectable`) for accessibility.
-- The dropdown is portaled, so it is not clipped inside cards or `overflow: hidden` ancestors.
-
-## Stories
-
-<Primary />
-<Controls />
-<Stories />

package/src/components/molecules/multi-select/multi-select.stories.tsx

@@ -1,59 +0,0 @@
-import type { Meta, StoryObj } from "@storybook/react";
-import { useState } from "react";
-import ITMultiSelect from "@/components/molecules/multi-select/multi-select";
-import { ITMultiSelectOption } from "./multi-select.props";
-
-const meta: Meta<typeof ITMultiSelect> = {
-  title: "Components/Form Elements/ITMultiSelect",
-  component: ITMultiSelect,
-  parameters: { layout: "centered" },
-};
-
-export default meta;
-type Story = StoryObj<typeof ITMultiSelect>;
-
-const options: ITMultiSelectOption[] = [
-  { value: "mx", label: "México" },
-  { value: "es", label: "España" },
-  { value: "co", label: "Colombia" },
-  { value: "ar", label: "Argentina" },
-  { value: "pe", label: "Perú" },
-  { value: "cl", label: "Chile" },
-];
-
-const Wrapper = (args: any) => {
-  const [value, setValue] = useState<(string | number)[]>(args.value ?? []);
-  return (
-    <div className="w-[400px]">
-      <ITMultiSelect {...args} value={value} onChange={(v) => setValue(v)} />
-    </div>
-  );
-};
-
-export const Default: Story = {
-  render: (args) => <Wrapper {...args} />,
-  args: { name: "countries", label: "Países", options, value: [] },
-};
-
-export const WithPreselected: Story = {
-  render: (args) => <Wrapper {...args} />,
-  args: { name: "countries", label: "Países", options, value: ["mx", "es", "co", "ar"] },
-};
-
-export const WithError: Story = {
-  render: (args) => <Wrapper {...args} />,
-  args: {
-    name: "countries",
-    label: "Países",
-    options,
-    value: [],
-    required: true,
-    touched: true,
-    error: true,
-  },
-};
-
-export const Disabled: Story = {
-  render: (args) => <Wrapper {...args} />,
-  args: { name: "countries", label: "Países", options, value: ["mx"], disabled: true },
-};

package/src/components/molecules/pagination/pagination.doc.mdx

@@ -1,62 +0,0 @@
-import { Meta, Title, Description, Primary, Controls, Stories } from '@storybook/blocks';
-import * as StoriesData from './pagination.stories';
-
-<Meta of={StoriesData} />
-
-# ITPagination
-
-Page navigation with current/total pages display, first/last buttons, sibling page count control, and an optional items-per-page selector with summary text.
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `currentPage` | `number` | — | Current active page (1-indexed). |
-| `totalPages` | `number` | — | Total number of pages available. |
-| `onPageChange` | `(page: number) => void` | — | Callback fired when a page is clicked or prev/next is activated. |
-| `siblingCount` | `number` | `1` | Number of visible page siblings before and after the current page. |
-| `color` | `"primary" \| "secondary" \| "success" \| "danger" \| "warning" \| "info" \| "purple"` | `"primary"` | Semantic color for active page and buttons. |
-| `className` | `string` | — | Additional CSS classes for the container. |
-| `itemsPerPageOptions` | `number[]` | — | Available options for the items-per-page selector dropdown. |
-| `itemsPerPage` | `number` | — | Current items per page value. Required if `itemsPerPageOptions` is provided. |
-| `onItemsPerPageChange` | `(value: number) => void` | — | Callback fired when the items per page value is changed. |
-| `totalItems` | `number` | — | Total number of items across all pages. Used for the "1-10 of 50" summary text. |
-
-## Usage
-
-```tsx
-import { ITPagination } from '@axzydev/axzy_ui_system';
-
-<ITPagination
-  currentPage={1}
-  totalPages={5}
-  onPageChange={(page) => setCurrentPage(page)}
-/>
-
-<ITPagination
-  currentPage={1}
-  totalPages={50}
-  siblingCount={2}
-  color="primary"
-  onPageChange={(page) => setCurrentPage(page)}
-  itemsPerPageOptions={[10, 20, 30, 50]}
-  itemsPerPage={10}
-  onItemsPerPageChange={(val) => setItemsPerPage(val)}
-  totalItems={500}
-/>
-```
-
-## Notes
-
-- First and last page buttons are always visible for quick navigation.
-- Ellipsis indicators appear when sibling gaps exceed the page range.
-- The `siblingCount` prop controls how many page numbers appear around the current page.
-- All seven semantic colors are supported for the active page highlight.
-- When `itemsPerPageOptions` is provided, a dropdown and summary text render alongside pagination.
-- Compatible with server-side pagination via the `currentPage` and `onPageChange` controlled pattern.
-
-## Stories
-
-<Primary />
-<Controls />
-<Stories />

package/src/components/molecules/pagination/pagination.stories.tsx

@@ -1,110 +0,0 @@
-import type { Meta, StoryObj } from "@storybook/react";
-import ITPagination from "@/components/molecules/pagination/pagination";
-import { useState } from "react";
-
-const meta: Meta<typeof ITPagination> = {
-  title: "Components/Data Display/ITPagination",
-  component: ITPagination,
-  parameters: {
-    layout: "centered",
-  },
-  argTypes: {
-    currentPage: { control: "number" },
-    totalPages: { control: "number" },
-    siblingCount: { control: "number" },
-    color: {
-      control: "select",
-      options: ["primary", "secondary", "success", "danger", "warning", "info", "purple"],
-    },
-  },
-};
-
-export default meta;
-type Story = StoryObj<typeof ITPagination>;
-
-const PaginationWrapper = (args: any) => {
-  const [currentPage, setCurrentPage] = useState(args.currentPage || 1);
-
-  return (
-    <ITPagination
-      {...args}
-      currentPage={currentPage}
-      onPageChange={(page) => setCurrentPage(page)}
-    />
-  );
-};
-
-export const Default: Story = {
-  render: (args) => <PaginationWrapper {...args} />,
-  args: {
-    currentPage: 1,
-    totalPages: 5,
-    color: "primary",
-  },
-};
-
-export const ManyPages: Story = {
-  render: (args) => <PaginationWrapper {...args} />,
-  args: {
-    currentPage: 1,
-    totalPages: 50,
-    siblingCount: 1,
-    color: "primary",
-  },
-};
-
-export const MiddlePageOpened: Story = {
-  render: (args) => <PaginationWrapper {...args} />,
-  args: {
-    currentPage: 25,
-    totalPages: 50,
-    siblingCount: 1,
-    color: "primary",
-  },
-};
-
-export const WithItemsPerPage: Story = {
-  render: (args) => {
-    const [currentPage, setCurrentPage] = useState(1);
-    const [itemsPerPage, setItemsPerPage] = useState(10);
-    const totalItems = 500;
-    const totalPages = Math.ceil(totalItems / itemsPerPage);
-
-    return (
-      <ITPagination
-        {...args}
-        currentPage={currentPage}
-        totalPages={totalPages}
-        onPageChange={(page) => setCurrentPage(page)}
-        itemsPerPageOptions={[10, 20, 30, 50]}
-        itemsPerPage={itemsPerPage}
-        onItemsPerPageChange={(val) => {
-          setItemsPerPage(val);
-          setCurrentPage(1);
-        }}
-        totalItems={totalItems}
-      />
-    );
-  },
-  args: {
-    color: "primary",
-    className: "w-[600px]" // Make it wide enough to see the layout
-  },
-};
-
-export const Colors: Story = {
-  render: (args) => (
-    <div className="flex flex-col gap-4">
-      {(['primary', 'secondary', 'success', 'danger', 'warning', 'info', 'purple'] as const).map((color) => (
-        <div key={color} className="flex gap-4 items-center">
-            <span className="w-20 text-sm font-bold text-gray-500 capitalize">{color}</span>
-             <PaginationWrapper {...args} color={color} />
-        </div>
-      ))}
-    </div>
-  ),
-  args: {
-    currentPage: 1,
-    totalPages: 5,
-  },
-};

package/src/components/molecules/search-select/search-select.doc.mdx

@@ -1,77 +0,0 @@
-import { Meta, Title, Description, Primary, Controls, Stories } from '@storybook/blocks';
-import * as StoriesData from './search-select.stories';
-
-<Meta of={StoriesData} />
-
-# ITSearchSelect
-
-Searchable dropdown select with support for local client-side filtering and remote API search. Includes validation error display, label support, and customizable field mapping.
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| `name` | `string` | — | Name attribute for form integrations. |
-| `label` | `string` | — | Label displayed above the select input. |
-| `placeholder` | `string` | — | Placeholder text shown when no value is selected. |
-| `value` | `string \| number` | — | Currently selected value (controlled). |
-| `options` | `ITSearchSelectOption[]` | — | Array of options for static or remote data. `{ label, value, ...custom }`. |
-| `valueField` | `string` | `"value"` | Field used as the option value. |
-| `labelField` | `string` | `"label"` | Field used as the option display label. |
-| `onChange` | `(value: string \| number, option?: ITSearchSelectOption) => void` | — | Callback fired when selection changes. |
-| `onBlur` | `(e: FocusEvent<any>) => void` | — | Callback fired when input loses focus. |
-| `disabled` | `boolean` | `false` | Whether the component is disabled. |
-| `className` | `string` | — | Additional CSS classes for the container. |
-| `touched` | `boolean` | — | Whether the field has been touched (for form validation). |
-| `required` | `boolean` | `false` | Whether the field is required. Shows a red asterisk. |
-| `error` | `string \| boolean` | — | Error message or boolean indicating an error state. |
-| `readOnly` | `boolean` | `false` | Whether the field is read-only. |
-| `onSearch` | `(query: string) => void` | — | Callback for server-side search. Receives the search query string. |
-| `isLoading` | `boolean` | `false` | Whether options are being loaded from an external API. |
-| `noResultsMessage` | `string` | `"No se encontraron resultados"` | Message displayed when no results match the search. |
-| `renderOption` | `(option, state: { isSelected, searchTerm }) => ReactNode` | — | Custom template for each dropdown option. |
-| `clearable` | `boolean` | `true` | Shows a clear (X) button inside the input. |
-| `onClear` | `() => void` | — | Callback fired when the clear button is pressed. |
-
-## Usage
-
-```tsx
-import { ITSearchSelect } from '@axzydev/axzy_ui_system';
-
-<ITSearchSelect
-  name="user"
-  label="Select User"
-  placeholder="Search user..."
-  options={users}
-  value={selected}
-  onChange={(val) => setSelected(val)}
-/>
-
-<ITSearchSelect
-  name="remote"
-  label="API Search"
-  placeholder="Type to search..."
-  options={remoteOptions}
-  isLoading={loading}
-  onSearch={(query) => fetchResults(query)}
-  value={selected}
-  onChange={(val) => setSelected(val)}
-/>
-```
-
-## Notes
-
-- **Static mode**: provide an `options` array and the component filters client-side as the user types.
-- **Remote mode**: provide an `onSearch` callback and manage `options`/`isLoading` externally for API-driven searches.
-- `valueField` and `labelField` allow custom option object structures beyond `{ value, label }`.
-- Validation states: `error` string displays inline, `touched` gates error visibility, `required` adds a red asterisk.
-- `readOnly` mode renders the selected value as non-interactive text.
-- Supports `className` for style overrides and width control.
-- **Custom options**: `renderOption` replaces the default option rendering and receives `{ isSelected, searchTerm }`.
-- **Clear button**: an (X) button appears inside the input when there is a search term or a selected value; `clearable={false}` disables it. Clearing resets the search and selection, and calls `onSearch("")` / `onClear()`.
-
-## Stories
-
-<Primary />
-<Controls />
-<Stories />