@councilbox/councilbox-ui 2.0.57 → 2.0.59

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/dist/build-index.js +0 -7
  2. package/dist/components/1.Introduction.stories.mdx +579 -67
  3. package/dist/components/2.Changelog.stories.mdx +1392 -578
  4. package/dist/components/3.Guide.stories.mdx +570 -216
  5. package/dist/components/Accordion/Accordion.stories.js +55 -4
  6. package/dist/components/Alert/Alert.stories.js +50 -0
  7. package/dist/components/Avatar/Avatar.stories.js +69 -10
  8. package/dist/components/AvatarGroup/AvatarGroup.stories.js +51 -4
  9. package/dist/components/Block/Block.stories.js +23 -2
  10. package/dist/components/Button/Button.stories.js +47 -21
  11. package/dist/components/ButtonBasic/ButtonBasic.stories.js +80 -27
  12. package/dist/components/Checkbox/Checkbox.css +6 -0
  13. package/dist/components/Checkbox/Checkbox.js +3 -1
  14. package/dist/components/Checkbox/Checkbox.stories.js +73 -4
  15. package/dist/components/DatePicker/DatePicker.stories.js +1 -1
  16. package/dist/components/DateRangePicker/DateRangePicker.stories.js +1 -1
  17. package/dist/components/DateTimePicker/DateTimePicker.stories.js +1 -1
  18. package/dist/components/DragDrop/DragDrop.css +9 -8
  19. package/dist/components/DragDrop/DragDrop.js +3 -1
  20. package/dist/components/DragDrop/DragDrop.stories.js +116 -16
  21. package/dist/components/DrawerPanel/DrawerPanel.stories.js +227 -1
  22. package/dist/components/DropDown/DropDown.stories.js +198 -1
  23. package/dist/components/EnhancedTable/EnhancedTable.stories.js +218 -8
  24. package/dist/components/FabButton/FabButton.stories.js +102 -1
  25. package/dist/components/Grid/Grid.js +1 -0
  26. package/dist/components/Grid/Grid.stories.js +178 -4
  27. package/dist/components/Grid/GridItem.js +1 -0
  28. package/dist/components/Header/Header.stories.js +588 -13
  29. package/dist/components/IconButton/IconButton.stories.js +167 -2
  30. package/dist/components/IconButtonSquare/IconButtonSquare.stories.js +172 -2
  31. package/dist/components/InputAutocomplete/InputAutocomplete.stories.js +174 -13
  32. package/dist/components/InputPassword/InputPassword.stories.js +114 -4
  33. package/dist/components/InputText/InputText.stories.js +170 -9
  34. package/dist/components/InputTextArea/InputTextArea.stories.js +108 -2
  35. package/dist/components/LoadingSection/LoadingSection.stories.js +45 -3
  36. package/dist/components/MenuItem/MenuItem.stories.js +92 -7
  37. package/dist/components/MenuLateralLeft/MenuLateralLeft.stories.js +208 -2
  38. package/dist/components/MenuLateralRight/MenuLateralRight.stories.js +193 -2
  39. package/dist/components/Modal/Modal.stories.js +181 -19
  40. package/dist/components/PaginationFooter/PaginationFooter.stories.js +148 -5
  41. package/dist/components/RadioButton/Radio.stories.js +104 -4
  42. package/dist/components/RichTextInput/RichTextInput.stories.js +5 -0
  43. package/dist/components/Ripple/Ripple.stories.js +72 -4
  44. package/dist/components/Scrollbar/Scrollbar.stories.js +5 -0
  45. package/dist/components/ScrollbarOld/ScrollbarOld.stories.js +106 -3
  46. package/dist/components/SelectInput/SelectInput.stories.js +139 -8
  47. package/dist/components/Slider/Slider.stories.js +94 -3
  48. package/dist/components/Spacing/Spacing.stories.js +6 -1
  49. package/dist/components/Stars/Stars.stories.js +104 -3
  50. package/dist/components/Stepper/Stepper.stories.js +91 -1
  51. package/dist/components/Table/Table.stories.js +171 -9
  52. package/dist/components/Table/TableRow.js +1 -0
  53. package/dist/components/Tabs/Tabs.stories.js +122 -3
  54. package/dist/components/Tag/Tag.stories.js +105 -2
  55. package/dist/components/TextInput/TextInput.stories.js +92 -4
  56. package/dist/components/TimePicker/TimePicker.stories.js +1 -1
  57. package/dist/components/Timeline/Timeline.stories.js +93 -2
  58. package/dist/components/Toast/Toast.js +1 -1
  59. package/dist/components/Toast/Toast.stories.js +6 -0
  60. package/dist/components/Toggle/Toggle.stories.js +80 -4
  61. package/dist/components/Tooltip/Tooltip.stories.js +105 -3
  62. package/dist/components/Typography/Typography.stories.js +51 -10
  63. package/package.json +4 -5
  64. package/IconFont.js +0 -3
  65. package/dist/components/IconFont/IconFont.css +0 -0
  66. package/dist/components/IconFont/IconFont.js +0 -86
  67. package/dist/components/IconFont/IconFont.stories.js +0 -36
  68. package/dist/fonts/IconNames.json +0 -6848
@@ -3,23 +3,99 @@
3
3
  Object.defineProperty(exports, "__esModule", {
4
4
  value: true
5
5
  });
6
- exports["default"] = exports.DesignTagTemplate = void 0;
6
+ exports["default"] = exports.Playground = exports.DesignTagTemplate = void 0;
7
7
  var _react = _interopRequireDefault(require("react"));
8
8
  var _Tag = _interopRequireDefault(require("./Tag"));
9
9
  var _DesignTags = _interopRequireDefault(require("./DesignTags.stories"));
10
+ var _excluded = ["clickable", "closable", "onClick", "close"];
10
11
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
12
+ 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); }
13
+ function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) { o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } } return i; }
14
+ function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) { if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } } return t; }
11
15
  var _default = {
12
16
  title: 'Components/Tag',
13
17
  component: _Tag["default"],
14
18
  argTypes: {
19
+ text: {
20
+ control: 'text'
21
+ },
15
22
  variant: {
16
23
  control: {
17
24
  type: 'select'
18
25
  },
19
26
  options: ['primary', 'secondary', 'tertiary']
27
+ },
28
+ icon: {
29
+ control: 'select',
30
+ options: ['', 'ri-checkbox-circle-line', 'ri-time-line', 'ri-error-warning-line', 'ri-user-line']
31
+ },
32
+ iconText: {
33
+ control: 'text',
34
+ description: 'Texto corto en lugar del icono (por ejemplo, iniciales).'
35
+ },
36
+ background: {
37
+ control: 'color'
38
+ },
39
+ borderColor: {
40
+ control: 'color'
41
+ },
42
+ colorText: {
43
+ control: 'color'
44
+ },
45
+ clickable: {
46
+ control: 'boolean',
47
+ description: 'Solo demo: pasa onClick.',
48
+ table: {
49
+ category: 'Demo'
50
+ }
51
+ },
52
+ closable: {
53
+ control: 'boolean',
54
+ description: 'Solo demo: pasa close.',
55
+ table: {
56
+ category: 'Demo'
57
+ }
58
+ },
59
+ onClick: {
60
+ action: 'onClick'
61
+ },
62
+ close: {
63
+ action: 'close'
64
+ },
65
+ closeAriaLabel: {
66
+ control: 'text'
67
+ },
68
+ 'aria-label': {
69
+ control: 'text'
70
+ },
71
+ iconTypographyProps: {
72
+ control: 'object'
73
+ },
74
+ textTypographyProps: {
75
+ control: 'object'
76
+ },
77
+ id: {
78
+ control: 'text'
79
+ },
80
+ className: {
81
+ control: 'text'
82
+ },
83
+ style: {
84
+ control: 'object'
85
+ },
86
+ styles: {
87
+ control: 'object'
88
+ },
89
+ sx: {
90
+ control: 'object'
20
91
  }
21
92
  },
22
93
  parameters: {
94
+ docs: {
95
+ description: {
96
+ component: "\n## Tag\n\nEtiqueta compacta para mostrar estados, categor\xEDas o filtros aplicados. Puede ser informativa, clicable o eliminable.\n\n## Funcionamiento\n\n- `text`: texto de la etiqueta. Si no cabe, se corta con \"...\" y se muestra completo en un tooltip.\n- `variant`: `'primary'` (por defecto), `'secondary'` o `'tertiary'` (con borde y fondo claro).\n- `icon`: clase de icono o nodo React a la izquierda. `iconText`: texto corto en lugar del icono (por ejemplo, unas iniciales).\n- `onClick`: hace la etiqueta clicable.\n- `close`: muestra un bot\xF3n para eliminarla y se llama al pulsarlo.\n- `background`, `borderColor` y `colorText`: colores personalizados.\n- `iconTypographyProps` y `textTypographyProps`: props para los textos internos.\n\n## Accesibilidad\n\n### Etiqueta informativa\n\n- Sin `onClick`, la etiqueta es un `div` sin rol: se lee como texto normal y no recibe el foco.\n\n### Etiqueta clicable\n\n- Con `onClick`, recibe `role=\"button\"` y `tabIndex=\"0\"`: se enfoca con **Tab** y se activa con **Enter** o **Espacio**.\n- Integra `useA11yGuard`: en modo estricto, una etiqueta clicable exige `text` o `aria-label`.\n\n### Bot\xF3n de eliminar\n\n- Es un `button` nativo, enfocable y activable con teclado.\n- Su nombre accesible es `closeAriaLabel` o, si no se indica, \"close {text}\".\n- Sus pulsaciones de teclado no activan el `onClick` de la etiqueta.\n\n### Iconograf\xEDa\n\n- Los iconos de clase y el icono de cerrar son decorativos (`aria-hidden=\"true\"`).\n\n## Recomendaciones de uso\n\n- Pasar `closeAriaLabel` traducido y concreto (por ejemplo, \"Quitar filtro Pendientes\").\n- No usar el color como \xFAnica forma de transmitir el significado de la etiqueta: el texto debe ser suficiente.\n- Comprobar el contraste al usar `background` y `colorText` personalizados.\n\n## Consideraciones\n\n- Una etiqueta clicable con bot\xF3n de eliminar crea un bot\xF3n dentro de otro, lo que algunas herramientas de auditor\xEDa marcan como controles interactivos anidados.\n- El texto por defecto del bot\xF3n de eliminar (\"close ...\") est\xE1 en ingl\xE9s.\n- Si `icon` es un nodo React, el consumidor debe marcarlo como decorativo si no aporta informaci\xF3n."
97
+ }
98
+ },
23
99
  storybookCodePanel: {
24
100
  disabled: false,
25
101
  files: [{
@@ -35,11 +111,38 @@ var _default = {
35
111
  }
36
112
  };
37
113
  exports["default"] = _default;
114
+ var PlaygroundTemplate = function PlaygroundTemplate(_ref) {
115
+ var clickable = _ref.clickable,
116
+ closable = _ref.closable,
117
+ onClick = _ref.onClick,
118
+ close = _ref.close,
119
+ args = _objectWithoutProperties(_ref, _excluded);
120
+ return /*#__PURE__*/_react["default"].createElement(_Tag["default"], _extends({}, args, {
121
+ onClick: clickable ? onClick : undefined,
122
+ close: closable ? close : undefined
123
+ }));
124
+ };
125
+ PlaygroundTemplate.displayName = "PlaygroundTemplate";
126
+ var Playground = PlaygroundTemplate.bind({});
127
+ exports.Playground = Playground;
128
+ Playground.args = {
129
+ text: 'Pendiente',
130
+ variant: 'primary',
131
+ icon: 'ri-time-line',
132
+ iconText: '',
133
+ clickable: false,
134
+ closable: true,
135
+ closeAriaLabel: 'Quitar filtro Pendiente'
136
+ };
38
137
  var TemplateTag = function TemplateTag(args) {
39
138
  return /*#__PURE__*/_react["default"].createElement(_DesignTags["default"], args);
40
139
  };
41
140
  TemplateTag.displayName = "TemplateTag";
42
141
  var DesignTagTemplate = TemplateTag.bind({});
43
142
  exports.DesignTagTemplate = DesignTagTemplate;
44
- DesignTagTemplate.parameters = {};
143
+ DesignTagTemplate.parameters = {
144
+ controls: {
145
+ disable: true
146
+ }
147
+ };
45
148
  DesignTagTemplate.args = {};
@@ -6,11 +6,72 @@ Object.defineProperty(exports, "__esModule", {
6
6
  exports["default"] = exports.Success = exports.Helper = exports.ErrorTemplate = exports.Disabled = exports.Default = void 0;
7
7
  var _react = _interopRequireDefault(require("react"));
8
8
  var _TextInput = _interopRequireDefault(require("./TextInput"));
9
+ var _excluded = ["value", "onChange"];
9
10
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
11
+ 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); }
12
+ function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
13
+ function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
14
+ function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
15
+ function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) { n[e] = r[e]; } return n; }
16
+ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0) { ; } } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
17
+ function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
18
+ function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) { o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } } return i; }
19
+ function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) { if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } } return t; }
10
20
  var _default = {
11
21
  title: 'Components/TextInput',
12
22
  component: _TextInput["default"],
13
- argTypes: {},
23
+ argTypes: {
24
+ label: {
25
+ control: 'text'
26
+ },
27
+ value: {
28
+ control: 'text'
29
+ },
30
+ placeholder: {
31
+ control: 'text'
32
+ },
33
+ disabled: {
34
+ control: 'boolean'
35
+ },
36
+ error: {
37
+ control: 'text',
38
+ description: 'Mensaje de error (vacío para quitarlo).'
39
+ },
40
+ success: {
41
+ control: 'boolean'
42
+ },
43
+ helper: {
44
+ control: 'text'
45
+ },
46
+ helperText: {
47
+ control: 'text'
48
+ },
49
+ fullWidth: {
50
+ control: 'boolean'
51
+ },
52
+ width: {
53
+ control: 'text'
54
+ },
55
+ disableUnderline: {
56
+ control: 'boolean'
57
+ },
58
+ type: {
59
+ control: 'select',
60
+ options: ['text', 'number', 'email', 'password']
61
+ },
62
+ onChange: {
63
+ action: 'onChange'
64
+ },
65
+ id: {
66
+ control: 'text'
67
+ },
68
+ className: {
69
+ control: 'text'
70
+ },
71
+ sx: {
72
+ control: 'object'
73
+ }
74
+ },
14
75
  parameters: {
15
76
  storybookCodePanel: {
16
77
  disabled: false,
@@ -27,13 +88,40 @@ var _default = {
27
88
  }
28
89
  };
29
90
  exports["default"] = _default;
30
- var Template = function Template(args) {
31
- return /*#__PURE__*/_react["default"].createElement(_TextInput["default"], args);
91
+ var Template = function Template(_ref) {
92
+ var valueArg = _ref.value,
93
+ _onChange = _ref.onChange,
94
+ args = _objectWithoutProperties(_ref, _excluded);
95
+ var _React$useState = _react["default"].useState(valueArg !== null && valueArg !== void 0 ? valueArg : ''),
96
+ _React$useState2 = _slicedToArray(_React$useState, 2),
97
+ value = _React$useState2[0],
98
+ setValue = _React$useState2[1];
99
+ _react["default"].useEffect(function () {
100
+ return setValue(valueArg !== null && valueArg !== void 0 ? valueArg : '');
101
+ }, [valueArg]);
102
+ return /*#__PURE__*/_react["default"].createElement(_TextInput["default"], _extends({}, args, {
103
+ value: value,
104
+ onChange: function onChange(event) {
105
+ setValue(event.target.value);
106
+ _onChange === null || _onChange === void 0 ? void 0 : _onChange(event);
107
+ }
108
+ }));
32
109
  };
33
110
  Template.displayName = "Template";
34
111
  var Default = Template.bind({});
35
112
  exports.Default = Default;
36
- Default.args = {};
113
+ Default.args = {
114
+ label: 'Nombre',
115
+ value: '',
116
+ placeholder: '',
117
+ disabled: false,
118
+ error: '',
119
+ success: false,
120
+ helper: '',
121
+ fullWidth: false,
122
+ disableUnderline: false,
123
+ type: 'text'
124
+ };
37
125
  var Helper = Template.bind({});
38
126
  exports.Helper = Helper;
39
127
  Helper.args = {
@@ -20,7 +20,7 @@ var _default = {
20
20
  parameters: {
21
21
  docs: {
22
22
  description: {
23
- component: "\n## TimePicker\n\nSelector de hora (sin fecha) sin dependencias externas, con una API inspirada en el `TimePicker` de MUI: `value`/`onChange` son objetos `Date` (solo se usan/actualizan las horas, minutos y segundos; el resto de la fecha se conserva), columnas de hora/minuto (y AM/PM si `ampm`) igual que en `DateTimePicker`.\n\nTambi\xE9n acepta directamente un objeto moment/dayjs, una fecha ISO o un timestamp como `value`, `defaultValue`, `minTime` o `maxTime` (se normalizan internamente), para facilitar sustituir selectores basados en esas librer\xEDas sin tener que convertir manualmente en cada sitio.\n\n### Internacionalizaci\xF3n\n\nIgual que el resto de la familia: `locale` decide formato de hora (12h/24h), idioma de AM/PM y textos de UI v\xEDa `Intl` nativo, sobreescribible con `format`, `ampm` y `localeText`.\n"
23
+ component: "\n## TimePicker\n\nSelector de hora (sin fecha) sin dependencias externas, con una API inspirada en el `TimePicker` de MUI: `value`/`onChange` son objetos `Date` (solo se usan/actualizan las horas, minutos y segundos; el resto de la fecha se conserva), columnas de hora/minuto (y AM/PM si `ampm`) igual que en `DateTimePicker`.\n\nTambi\xE9n acepta directamente un objeto moment/dayjs, una fecha ISO o un timestamp como `value`, `defaultValue`, `minTime` o `maxTime` (se normalizan internamente), para facilitar sustituir selectores basados en esas librer\xEDas sin tener que convertir manualmente en cada sitio.\n\n### Internacionalizaci\xF3n\n\nIgual que el resto de la familia: `locale` decide formato de hora (12h/24h), idioma de AM/PM y textos de UI v\xEDa `Intl` nativo, sobreescribible con `format`, `ampm` y `localeText`.\n\n### Selecci\xF3n\n\n- En el popover, cada clic en una hora o minuto se aplica al momento, sin bot\xF3n de confirmar.\n- Con `isMobile` (o `showInModal`) se abre en un `Modal`: la hora se prepara en un borrador y solo se aplica con `saveButtonText`.\n- `minutesStep` limita los minutos a intervalos (por ejemplo, 5 o 15). `minTime` y `maxTime` deshabilitan las horas fuera de rango.\n\n## Accesibilidad\n\n### Etiqueta y nombre accesible\n\n- Integra `useA11yGuard`: en modo estricto exige `label` o `aria-label`.\n- `required`, `error` y `helperText` se heredan de `InputText` (`required`, `aria-invalid`, `aria-describedby` y `role=\"alert\"`).\n- El `placeholder` muestra por defecto el formato esperado (por ejemplo, `hh:mm`).\n\n### Campo de texto y teclado\n\n- `aria-haspopup=\"dialog\"` y `aria-expanded` indican que el campo abre el selector y si est\xE1 abierto.\n- La hora se puede escribir directamente en el campo, que es la alternativa completa a las columnas para teclado y lectores de pantalla.\n- **Flecha abajo** abre el selector y **Escape** lo cierra.\n- El bot\xF3n \"Abrir selector de hora\" tiene `aria-label` localizado. El de borrar est\xE1 fuera del orden de tabulaci\xF3n; con teclado se borra vaciando el campo.\n\n### Columnas de hora\n\n- El popover se expone como `role=\"dialog\"` con el `label` (o \"Selector de hora\") como nombre.\n- Cada columna (horas, minutos y AM/PM si `ampm`) es un `role=\"listbox\"` con opciones `role=\"option\"` y `aria-selected` en la seleccionada.\n- Las opciones no permitidas por `minTime` / `maxTime` usan `disabled` nativo.\n- La opci\xF3n seleccionada se centra autom\xE1ticamente en su columna al abrir o al cambiar el valor.\n\n### Modo modal\n\n- Con `isMobile` o `showInModal` se usa `Modal`, que gestiona el foco (lo mueve al di\xE1logo, lo mantiene dentro y lo devuelve al cerrar).\n\n## Recomendaciones de uso\n\n- Usar `minutesStep` siempre que sea posible: reduce las opciones de la columna de minutos y facilita la selecci\xF3n.\n- Pasar `cancelButtonText` y `saveButtonText` traducidos al usar el modo modal (por defecto en ingl\xE9s).\n- Usar `required` en lugar de a\xF1adir el asterisco a mano en `label`.\n\n## Consideraciones\n\n- En modo popover el foco no entra en las columnas ni queda atrapado (aunque el di\xE1logo declara `aria-modal=\"true\"`). Al renderizarse al final de `<body>`, con **Tab** no se llega desde el campo: con teclado, la v\xEDa real es escribir la hora.\n- Las columnas no tienen nombre accesible, as\xED que un lector de pantalla no distingue la lista de horas de la de minutos.\n- Las opciones son botones con `role=\"option\"`, sin navegaci\xF3n con flechas: cada valor es una parada de **Tab**.\n\n## Migraci\xF3n desde @mui/x-date-pickers\n\n### 1. Cambiar el import\n\n```jsx\n// Antes\nimport TimePicker from '../../UI/TimePicker'; // wrapper de OVAC sobre @mui/x-date-pickers\n\n// Despu\xE9s\nimport TimePicker from '@councilbox/councilbox-ui/dist/components/TimePicker/TimePicker';\n```\n\nNo necesita `LocalizationProvider` ni `AdapterMoment`.\n\n### 2. Valor y `onChange`\n\n- `value` admite `moment`, `dayjs`, `Date`, ISO o timestamp, as\xED que ya no hace falta envolverlo en `moment(value)`.\n- `onChange` entrega un `Date` nativo que conserva el d\xEDa del valor original y solo cambia horas, minutos y segundos. Si el c\xF3digo usa m\xE9todos de `moment` sobre el valor recibido, convertir: `onChange={date => setTime(date ? moment(date) : null)}`.\n\n### 3. Equivalencias de props\n\n| MUI / wrapper antiguo | Nuevo |\n| --- | --- |\n| `required` (el wrapper a\xF1ad\xEDa \" *\" al `label`) | `required` (asterisco y atributo `required` autom\xE1ticos) |\n| `ampm={false}` | `ampm={false}`, o nada: con `locale=\"es-ES\"` ya se usa formato de 24h |\n| `minutesStep` | Igual |\n| `minDate` (hora m\xEDnima) | `minTime` |\n| `clearable` / `clearText` / `clearLabel` | `clearable` (texto accesible en `localeText.clearText`) |\n| `okLabel` / `acceptText`, `cancelLabel` / `cancelText` | `saveButtonText` / `cancelButtonText` (solo en modo modal) |\n| `InputProps.endAdornment` con el icono de reloj | Ya incluido: eliminarlo |\n| `minDateMessage`, `errorText` (wrapper) | `error` / `helperText` |\n| `translate` (HOC `withTranslations`) | `localeText` con los textos traducidos |\n"
24
24
  }
25
25
  },
26
26
  storybookCodePanel: {
@@ -3,15 +3,61 @@
3
3
  Object.defineProperty(exports, "__esModule", {
4
4
  value: true
5
5
  });
6
- exports["default"] = exports.DesignTimelineTemplate = void 0;
6
+ exports["default"] = exports.Playground = exports.DesignTimelineTemplate = void 0;
7
7
  var _react = _interopRequireDefault(require("react"));
8
8
  var _Timeline = _interopRequireDefault(require("./Timeline"));
9
9
  var _DesignTimeline = _interopRequireDefault(require("./DesignTimeline.stories"));
10
+ var _Typography = _interopRequireDefault(require("../Typography/Typography"));
11
+ var _excluded = ["numberOfSteps"];
10
12
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
13
+ 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); }
14
+ function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) { o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } } return i; }
15
+ function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) { if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } } return t; }
11
16
  var _default = {
12
17
  title: 'Components/Timeline',
13
18
  component: _Timeline["default"],
19
+ argTypes: {
20
+ numberOfSteps: {
21
+ control: {
22
+ type: 'range',
23
+ min: 1,
24
+ max: 6,
25
+ step: 1
26
+ },
27
+ description: 'Solo demo: número de pasos.',
28
+ table: {
29
+ category: 'Demo'
30
+ }
31
+ },
32
+ last: {
33
+ control: false,
34
+ description: 'Oculta la línea al siguiente paso (la demo lo pone en el último).'
35
+ },
36
+ children: {
37
+ control: false,
38
+ description: 'Contenido del paso.'
39
+ },
40
+ className: {
41
+ control: 'text'
42
+ },
43
+ style: {
44
+ control: 'object'
45
+ },
46
+ sx: {
47
+ control: 'object'
48
+ },
49
+ prefixClass: {
50
+ table: {
51
+ disable: true
52
+ }
53
+ }
54
+ },
14
55
  parameters: {
56
+ docs: {
57
+ description: {
58
+ component: "\n## Timeline\n\nElemento de una l\xEDnea de tiempo vertical: un c\xEDrculo con una l\xEDnea que lo une al siguiente elemento y, a la derecha, el contenido. Varios `Timeline` seguidos forman la l\xEDnea de tiempo completa.\n\n## Funcionamiento\n\n- Cada `Timeline` renderiza un paso: `children` es su contenido (fecha, t\xEDtulo, descripci\xF3n...).\n- `last`: en el \xFAltimo paso oculta la l\xEDnea que lo une al siguiente.\n- `className`, `style` y `sx` para estilos propios. El resto de props se pasan a la lista (`ul`).\n\n```jsx\n<Timeline>Convocatoria enviada</Timeline>\n<Timeline>Reuni\xF3n iniciada</Timeline>\n<Timeline last>Acta firmada</Timeline>\n```\n\n## Accesibilidad\n\n### Estructura de lista\n\n- Cada paso es una lista (`ul`) con un elemento (`li`), por lo que el lector de pantalla lo anuncia como contenido de lista.\n- El componente calcula autom\xE1ticamente la posici\xF3n de cada paso entre sus hermanos y la expone con `aria-posinset` y `aria-setsize` en el `li`, para que se anuncie como \"paso 2 de 3\".\n- La posici\xF3n se recalcula si se a\xF1aden o quitan pasos (`MutationObserver`).\n\n### Iconograf\xEDa\n\n- El c\xEDrculo y la l\xEDnea son decorativos (`aria-hidden=\"true\"`): solo se lee el contenido.\n\n## Recomendaciones de uso\n\n- Colocar todos los `Timeline` de una misma l\xEDnea de tiempo como hermanos directos dentro del mismo contenedor, para que la posici\xF3n se calcule bien.\n- Incluir en el contenido de cada paso la informaci\xF3n que el c\xEDrculo o el color puedan sugerir (por ejemplo, \"Completado\" o la fecha).\n- Marcar el \xFAltimo paso con `last`.\n\n## Consideraciones\n\n- Cada paso es una lista independiente de un solo elemento: algunos lectores anuncian \"lista de 1 elemento\" en cada paso, aunque `aria-posinset` y `aria-setsize` indican su posici\xF3n en el conjunto.\n- El estado de cada paso (completado, actual, pendiente) no se expone de forma sem\xE1ntica: debe indicarse con texto en el contenido."
59
+ }
60
+ },
15
61
  storybookCodePanel: {
16
62
  disabled: false,
17
63
  files: [{
@@ -27,11 +73,56 @@ var _default = {
27
73
  }
28
74
  };
29
75
  exports["default"] = _default;
76
+ var TIMELINE_STEPS = [{
77
+ date: '01/10/2026 10:00',
78
+ text: 'Convocatoria enviada'
79
+ }, {
80
+ date: '05/10/2026 09:30',
81
+ text: 'Reunión iniciada'
82
+ }, {
83
+ date: '05/10/2026 11:15',
84
+ text: 'Votación cerrada'
85
+ }, {
86
+ date: '06/10/2026 12:00',
87
+ text: 'Acta generada'
88
+ }, {
89
+ date: '08/10/2026 16:45',
90
+ text: 'Acta firmada'
91
+ }, {
92
+ date: '09/10/2026 08:00',
93
+ text: 'Certificado enviado'
94
+ }];
95
+ var PlaygroundTemplate = function PlaygroundTemplate(_ref) {
96
+ var numberOfSteps = _ref.numberOfSteps,
97
+ args = _objectWithoutProperties(_ref, _excluded);
98
+ return /*#__PURE__*/_react["default"].createElement("div", null, TIMELINE_STEPS.slice(0, numberOfSteps).map(function (step, index) {
99
+ return /*#__PURE__*/_react["default"].createElement(_Timeline["default"], _extends({
100
+ key: step.text
101
+ }, args, {
102
+ last: index === numberOfSteps - 1
103
+ }), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
104
+ variant: "XS",
105
+ color: "var(--gray4)"
106
+ }, step.date), /*#__PURE__*/_react["default"].createElement(_Typography["default"], {
107
+ fontWeight: "700"
108
+ }, step.text));
109
+ }));
110
+ };
111
+ PlaygroundTemplate.displayName = "PlaygroundTemplate";
112
+ var Playground = PlaygroundTemplate.bind({});
113
+ exports.Playground = Playground;
114
+ Playground.args = {
115
+ numberOfSteps: 4
116
+ };
30
117
  var Template = function Template(args) {
31
118
  return /*#__PURE__*/_react["default"].createElement(_DesignTimeline["default"], args);
32
119
  };
33
120
  Template.displayName = "Template";
34
121
  var DesignTimelineTemplate = Template.bind({});
35
122
  exports.DesignTimelineTemplate = DesignTimelineTemplate;
36
- DesignTimelineTemplate.parameters = {};
123
+ DesignTimelineTemplate.parameters = {
124
+ controls: {
125
+ disable: true
126
+ }
127
+ };
37
128
  DesignTimelineTemplate.args = {};
@@ -30,7 +30,7 @@ var SEVERITY_CONFIG = {
30
30
  label: 'Éxito'
31
31
  },
32
32
  error: {
33
- icon: 'ri-close-circle-fill',
33
+ icon: 'ri-error-warning-line',
34
34
  label: 'Error'
35
35
  },
36
36
  warning: {
@@ -12,6 +12,12 @@ var _default = {
12
12
  title: 'Components/Toast',
13
13
  component: _ToastProvider["default"],
14
14
  parameters: {
15
+ docs: {
16
+ importStatement: "import { toast } from '@councilbox/councilbox-ui/toast';",
17
+ description: {
18
+ component: "\n## Toast\n\nSistema de notificaciones temporales que muestra mensajes breves de \xE9xito, error, aviso o informaci\xF3n en una esquina de la pantalla, sin interrumpir la tarea del usuario.\n\nNo necesita ning\xFAn provider: `toast()` se puede llamar desde cualquier componente, hook o incluso fuera de React (utilidades, manejadores de error de Apollo...). La primera llamada monta autom\xE1ticamente un contenedor propio en `<body>`.\n\n## Funcionamiento\n\n### Uso b\xE1sico\n\n```jsx\nimport { useToast } from '@councilbox/councilbox-ui/dist/components/Toast/useToast';\n\nconst { toast } = useToast();\ntoast({ message: 'Guardado correctamente.' });\ntoast({ title: 'Error al subir', message: 'El archivo supera el tama\xF1o m\xE1ximo.', severity: 'error' });\n```\n\nFuera de un componente se importa directamente la funci\xF3n:\n\n```js\nimport { toast } from '@councilbox/councilbox-ui/dist/components/Toast/toastStore';\n```\n\n### Opciones de `toast()`\n\n- `message` (obligatorio): texto o nodo React con el contenido.\n- `title`: t\xEDtulo opcional en negrita.\n- `severity`: `'success'` (por defecto), `'error'`, `'warning'` o `'info'`. Define el color y el icono.\n- `autoClose`: milisegundos hasta cerrarse solo (5000 por defecto) o `false` para que sea persistente. Los toasts de `error` son persistentes por defecto.\n- `vertical` (`'top'` / `'bottom'`) y `horizontal` (`'left'` / `'center'` / `'right'`): esquina donde aparece. Por defecto, arriba a la derecha.\n- `icon`: sustituye el icono de la severidad.\n- `color`: color de fondo personalizado.\n- `offset`: margen superior adicional (por ejemplo, para no tapar una cabecera fija).\n- `closeAriaLabel`: texto accesible del bot\xF3n de cerrar.\n\n`toast()` devuelve el `id` de la notificaci\xF3n creada.\n\n### Apilado y cierre\n\n- Se pueden mostrar varios toasts a la vez, apilados por esquina. Por defecto, como m\xE1ximo 5 por esquina: al superar el l\xEDmite se descarta el m\xE1s antiguo.\n- El l\xEDmite se cambia montando `<ToastProvider maxVisible={n}>` (es su \xFAnico uso; no es obligatorio).\n- Al pasar el rat\xF3n por encima se pausa el cierre autom\xE1tico, que se reinicia al salir.\n- Cada toast tiene un bot\xF3n para cerrarlo.\n\n### API de `useToast()`\n\n- `toast(opciones)`: crea una notificaci\xF3n y devuelve su `id`.\n- `closeToast(id)`: cierra una notificaci\xF3n concreta.\n- `closeAll()`: cierra todas.\n- `toasts`: lista de notificaciones visibles.\n\n## Accesibilidad\n\n### Anuncio en lectores de pantalla\n\n- **Errores**: `role=\"alert\"` con `aria-live=\"assertive\"`, para anunciarse de inmediato interrumpiendo la lectura.\n- **Resto de severidades**: `role=\"status\"` con `aria-live=\"polite\"`, que se anuncian cuando el lector termina lo que est\xE1 leyendo.\n- El toast no roba el foco: el usuario puede seguir trabajando sin perder su posici\xF3n.\n\n### Tiempo de lectura\n\n- Los errores no se cierran solos por defecto, para que el usuario tenga tiempo de leerlos (WCAG 2.2.1).\n- El cierre autom\xE1tico se pausa mientras el rat\xF3n est\xE1 encima.\n\n### Bot\xF3n de cerrar e iconograf\xEDa\n\n- El bot\xF3n de cerrar es un `IconButton` accesible por teclado, con el texto de `closeAriaLabel`.\n- Integra `useA11yGuard`: en modo estricto exige `closeAriaLabel`.\n- El icono de severidad es decorativo (`aria-hidden=\"true\"`).\n\n## Recomendaciones de uso\n\n- Pasar siempre `closeAriaLabel` traducido (por ejemplo, `translate.close`). Si no se indica, se usa el texto en ingl\xE9s \"Close notification\".\n- Escribir mensajes que se entiendan por s\xED solos y, si el tipo de aviso es importante, incluirlo en el texto o en `title`.\n- No usar toasts para informaci\xF3n que el usuario necesite consultar despu\xE9s o para acciones obligatorias. En esos casos, usar `Alert` o `Modal`.\n- Si se usa `color`, comprobar que el texto blanco mantiene un contraste suficiente.\n\n## Consideraciones\n\n- El tipo de aviso (\xE9xito, aviso, informaci\xF3n) solo se transmite con color e icono: el lector de pantalla anuncia \xFAnicamente `title` y `message`.\n- La pausa del cierre autom\xE1tico solo se activa con el rat\xF3n, no al enfocar el bot\xF3n de cerrar con teclado.\n- El contenedor de toasts es una ra\xEDz de React independiente: el contenido pasado en `message` o `title` no puede leer contextos de la aplicaci\xF3n (router, Apollo, traducciones por contexto...). Las variables CSS s\xED funcionan.\n- Las regiones `role=\"status\"` se insertan ya con su contenido, por lo que algunos lectores de pantalla pueden no anunciar los toasts que no son de error.\n\n## Migraci\xF3n desde el ToastContainer antiguo (OVAC)\n\nEl sistema antiguo de OVAC (`UI/ToastContainer` + `ToastContext`, basado en el `Snackbar` de MUI) usa las mismas opciones, as\xED que la mayor\xEDa de llamadas a `toast()` funcionan sin cambios.\n\n### 1. Cambiar el origen de `toast`\n\n```jsx\n// Antes\nconst toastContext = React.useContext(ToastContext);\ntoastContext.toast({ message, severity: 'error' });\n// o bien\nconst { toast } = useToast(); // hooks/useToast de OVAC\n\n// Despu\xE9s\nimport { useToast } from '@councilbox/councilbox-ui/dist/components/Toast/useToast';\n\nconst { toast } = useToast();\ntoast({ message, severity: 'error' });\n```\n\nCuando no quede ning\xFAn uso del contexto antiguo, se puede quitar `<ToastContainer>` de `App.js`. Los dos sistemas pueden convivir mientras dura la migraci\xF3n.\n\n### 2. Opciones que se mantienen igual\n\n`message`, `title`, `severity`, `autoClose`, `vertical`, `horizontal`, `icon`, `color` y `offset`.\n\n### 3. Diferencias de comportamiento\n\n| Antiguo | Nuevo |\n| --- | --- |\n| Un solo toast visible; el resto esperan en cola | Varios a la vez, apilados por esquina (m\xE1ximo 5) |\n| Los errores se cerraban a los 5 segundos | Los errores son persistentes. Para mantener el cierre, pasar `autoClose: 5000` |\n| Sin icono salvo que se pasara `icon` | Icono de severidad por defecto |\n| `toastContext.closeToast()` cerraba el toast actual | `closeToast(id)` con el `id` devuelto por `toast()`, o `closeAll()` |\n| `toastContext.actualToast` / `toastContext.open` | `toasts` de `useToast()` |\n| Se cerraba con dos clics fuera | Solo se cierra con el bot\xF3n, por tiempo o por c\xF3digo |\n| El contenido pod\xEDa usar contextos de la aplicaci\xF3n | El contenido no puede leer contextos de React (ver Consideraciones) |\n\n### 4. Bot\xF3n de cerrar\n\nA\xF1adir `closeAriaLabel` en las llamadas, por ejemplo `toast({ message, closeAriaLabel: translate.close })`, para que el bot\xF3n no se anuncie en ingl\xE9s."
19
+ }
20
+ },
15
21
  storybookCodePanel: {
16
22
  disabled: false,
17
23
  files: [{
@@ -6,11 +6,68 @@ Object.defineProperty(exports, "__esModule", {
6
6
  exports["default"] = exports.Default = void 0;
7
7
  var _react = _interopRequireDefault(require("react"));
8
8
  var _Toggle = _interopRequireDefault(require("./Toggle"));
9
+ var _excluded = ["checked", "onChange"];
9
10
  function _interopRequireDefault(e) { return e && e.__esModule ? e : { "default": e }; }
11
+ 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); }
12
+ function _slicedToArray(r, e) { return _arrayWithHoles(r) || _iterableToArrayLimit(r, e) || _unsupportedIterableToArray(r, e) || _nonIterableRest(); }
13
+ function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
14
+ function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
15
+ function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) { n[e] = r[e]; } return n; }
16
+ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0) { ; } } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
17
+ function _arrayWithHoles(r) { if (Array.isArray(r)) return r; }
18
+ function _objectWithoutProperties(e, t) { if (null == e) return {}; var o, r, i = _objectWithoutPropertiesLoose(e, t); if (Object.getOwnPropertySymbols) { var n = Object.getOwnPropertySymbols(e); for (r = 0; r < n.length; r++) { o = n[r], -1 === t.indexOf(o) && {}.propertyIsEnumerable.call(e, o) && (i[o] = e[o]); } } return i; }
19
+ function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) { if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } } return t; }
10
20
  var _default = {
11
21
  title: 'Components/Toggle',
12
22
  component: _Toggle["default"],
13
- argTypes: {},
23
+ argTypes: {
24
+ label: {
25
+ control: 'text'
26
+ },
27
+ checked: {
28
+ control: 'boolean'
29
+ },
30
+ disabled: {
31
+ control: 'boolean'
32
+ },
33
+ labelPlacement: {
34
+ control: 'radio',
35
+ options: ['end', 'start']
36
+ },
37
+ variant: {
38
+ control: 'select',
39
+ options: ['L', 'M', 'S', 'XS'],
40
+ description: 'Variante tipográfica de la etiqueta.'
41
+ },
42
+ controlled: {
43
+ control: 'boolean',
44
+ description: 'Si es true, el estado lo gestiona el consumidor con checked/onChange.'
45
+ },
46
+ ariaLabel: {
47
+ control: 'text'
48
+ },
49
+ value: {
50
+ control: 'text'
51
+ },
52
+ onChange: {
53
+ action: 'onChange'
54
+ },
55
+ onClick: {
56
+ action: 'onClick'
57
+ },
58
+ id: {
59
+ control: 'text'
60
+ },
61
+ className: {
62
+ control: 'text'
63
+ },
64
+ style: {
65
+ control: 'object'
66
+ },
67
+ sx: {
68
+ control: 'object'
69
+ }
70
+ },
14
71
  parameters: {
15
72
  docs: {
16
73
  description: {
@@ -28,8 +85,24 @@ var _default = {
28
85
  }
29
86
  };
30
87
  exports["default"] = _default;
31
- var Template = function Template(args) {
32
- return /*#__PURE__*/_react["default"].createElement(_Toggle["default"], args);
88
+ var Template = function Template(_ref) {
89
+ var checkedArg = _ref.checked,
90
+ _onChange = _ref.onChange,
91
+ args = _objectWithoutProperties(_ref, _excluded);
92
+ var _React$useState = _react["default"].useState(checkedArg),
93
+ _React$useState2 = _slicedToArray(_React$useState, 2),
94
+ checked = _React$useState2[0],
95
+ setChecked = _React$useState2[1];
96
+ _react["default"].useEffect(function () {
97
+ return setChecked(checkedArg);
98
+ }, [checkedArg]);
99
+ return /*#__PURE__*/_react["default"].createElement(_Toggle["default"], _extends({}, args, {
100
+ checked: checked,
101
+ onChange: function onChange(event, newChecked) {
102
+ setChecked(newChecked);
103
+ _onChange === null || _onChange === void 0 ? void 0 : _onChange(event, newChecked);
104
+ }
105
+ }));
33
106
  };
34
107
  Template.displayName = "Template";
35
108
  var Default = Template.bind({});
@@ -38,5 +111,8 @@ Default.args = {
38
111
  value: '',
39
112
  checked: true,
40
113
  label: 'Activado',
41
- controlled: true
114
+ controlled: true,
115
+ disabled: false,
116
+ labelPlacement: 'end',
117
+ variant: 'M'
42
118
  };