@stackcraftmx/calcita 0.0.0-stage → 0.23.0

package/dist/auth/PasswordChecklist.js

@@ -0,0 +1,44 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import Box from "@mui/material/Box";
+import Typography from "@mui/material/Typography";
+import CheckCircleIcon from "@mui/icons-material/CheckCircle";
+import RadioButtonUncheckedIcon from "@mui/icons-material/RadioButtonUnchecked";
+import { passwordChecksOf, DEFAULT_PASSWORD_POLICY } from "./passwordRules.js";
+const SCREEN_READER_ONLY_SX = {
+  position: "absolute",
+  width: "1px",
+  height: "1px",
+  padding: 0,
+  margin: "-1px",
+  overflow: "hidden",
+  clip: "rect(0 0 0 0)",
+  whiteSpace: "nowrap",
+  border: 0
+};
+function PasswordChecklist({ password, policy = DEFAULT_PASSWORD_POLICY, id }) {
+  const { t } = useToolkitTranslation("auth");
+  return /* @__PURE__ */ jsxs(Box, { id, children: [
+    /* @__PURE__ */ jsx(Typography, { variant: "caption", color: "text.secondary", component: "p", sx: { mb: 0.5 }, children: t("passwordRules.title") }),
+    /* @__PURE__ */ jsx(Box, { component: "ul", sx: { listStyle: "none", m: 0, p: 0, display: "grid", gap: 0.5 }, children: passwordChecksOf(password, policy).map((check) => /* @__PURE__ */ jsxs(
+      Box,
+      {
+        component: "li",
+        "data-rule": check.rule,
+        "data-met": check.isMet,
+        sx: { display: "flex", alignItems: "center", gap: 1, color: check.isMet ? "text.primary" : "text.secondary" },
+        children: [
+          check.isMet ? /* @__PURE__ */ jsx(CheckCircleIcon, { fontSize: "small", color: "success", "aria-hidden": true }) : /* @__PURE__ */ jsx(RadioButtonUncheckedIcon, { fontSize: "small", color: "disabled", "aria-hidden": true }),
+          /* @__PURE__ */ jsx(Typography, { variant: "body2", component: "span", children: t(`passwordRules.${check.rule}`, check.values) }),
+          /* @__PURE__ */ jsx(Box, { component: "span", sx: SCREEN_READER_ONLY_SX, children: check.isMet ? t("passwordRules.met") : t("passwordRules.missing") })
+        ]
+      },
+      check.rule
+    )) })
+  ] });
+}
+export {
+  PasswordChecklist as default
+};
+//# sourceMappingURL=PasswordChecklist.js.map

package/dist/auth/PasswordChecklist.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PasswordChecklist.js","sources":["../../src/auth/PasswordChecklist.jsx"],"sourcesContent":["// La lista de lo que debe tener una contraseña nueva, que se va palomeando mientras la persona escribe: dice qué falta\n// ANTES de enviar, en lugar de un «contraseña inválida» después.\n//\n// Para el lector de pantalla cada renglón dice si ya cumple o falta (con el ícono solo, se oía la regla sin saber cómo\n// iba). Va justo debajo del campo de la contraseña nueva.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport Box from '@mui/material/Box';\nimport Typography from '@mui/material/Typography';\nimport CheckCircleIcon from '@mui/icons-material/CheckCircle';\nimport RadioButtonUncheckedIcon from '@mui/icons-material/RadioButtonUnchecked';\n\nimport {DEFAULT_PASSWORD_POLICY, passwordChecksOf} from '@/auth/passwordRules.js';\n\n// texto que solo oye el lector de pantalla (el mismo truco que usa MUI)\nconst SCREEN_READER_ONLY_SX = {\n    position: 'absolute', width: '1px', height: '1px', padding: 0, margin: '-1px', overflow: 'hidden', clip: 'rect(0 0 0 0)', whiteSpace: 'nowrap', border: 0,\n};\n\n/**\n * @param {object} props\n * @param {string} props.password lo que lleva escrito la persona\n * @param {object} [props.policy] las reglas; por omisión DEFAULT_PASSWORD_POLICY\n * @param {string} [props.id]\n */\nexport default function PasswordChecklist({password, policy = DEFAULT_PASSWORD_POLICY, id}) {\n    const {t} = useToolkitTranslation('auth');\n    return (\n        <Box id={id}>\n            <Typography variant=\"caption\" color=\"text.secondary\" component=\"p\" sx={{mb: 0.5}}>{t('passwordRules.title')}</Typography>\n            <Box component=\"ul\" sx={{listStyle: 'none', m: 0, p: 0, display: 'grid', gap: 0.5}}>\n                {passwordChecksOf(password, policy).map((check) => (\n                    <Box component=\"li\" key={check.rule} data-rule={check.rule} data-met={check.isMet}\n                         sx={{display: 'flex', alignItems: 'center', gap: 1, color: check.isMet ? 'text.primary' : 'text.secondary'}}>\n                        {check.isMet\n                            ? <CheckCircleIcon fontSize=\"small\" color=\"success\" aria-hidden />\n                            : <RadioButtonUncheckedIcon fontSize=\"small\" color=\"disabled\" aria-hidden />}\n                        <Typography variant=\"body2\" component=\"span\">{t(`passwordRules.${check.rule}`, check.values)}</Typography>\n                        <Box component=\"span\" sx={SCREEN_READER_ONLY_SX}>{check.isMet ? t('passwordRules.met') : t('passwordRules.missing')}</Box>\n                    </Box>\n                ))}\n            </Box>\n        </Box>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;AAgBA,MAAM,wBAAwB;AAAA,EAC1B,UAAU;AAAA,EAAY,OAAO;AAAA,EAAO,QAAQ;AAAA,EAAO,SAAS;AAAA,EAAG,QAAQ;AAAA,EAAQ,UAAU;AAAA,EAAU,MAAM;AAAA,EAAiB,YAAY;AAAA,EAAU,QAAQ;AAC5J;AAQA,SAAwB,kBAAkB,EAAC,UAAU,SAAS,yBAAyB,MAAK;AACxF,QAAM,EAAC,EAAA,IAAK,sBAAsB,MAAM;AACxC,SACI,qBAAC,OAAI,IACD,UAAA;AAAA,IAAA,oBAAC,YAAA,EAAW,SAAQ,WAAU,OAAM,kBAAiB,WAAU,KAAI,IAAI,EAAC,IAAI,IAAA,GAAO,UAAA,EAAE,qBAAqB,GAAE;AAAA,IAC5G,oBAAC,OAAI,WAAU,MAAK,IAAI,EAAC,WAAW,QAAQ,GAAG,GAAG,GAAG,GAAG,SAAS,QAAQ,KAAK,IAAA,GACzE,UAAA,iBAAiB,UAAU,MAAM,EAAE,IAAI,CAAC,UACrC;AAAA,MAAC;AAAA,MAAA;AAAA,QAAI,WAAU;AAAA,QAAsB,aAAW,MAAM;AAAA,QAAM,YAAU,MAAM;AAAA,QACvE,IAAI,EAAC,SAAS,QAAQ,YAAY,UAAU,KAAK,GAAG,OAAO,MAAM,QAAQ,iBAAiB,iBAAA;AAAA,QAC1F,UAAA;AAAA,UAAA,MAAM,QACD,oBAAC,iBAAA,EAAgB,UAAS,SAAQ,OAAM,WAAU,eAAW,KAAA,CAAC,wBAC7D,0BAAA,EAAyB,UAAS,SAAQ,OAAM,YAAW,eAAW,MAAC;AAAA,UAC9E,oBAAC,YAAA,EAAW,SAAQ,SAAQ,WAAU,QAAQ,UAAA,EAAE,iBAAiB,MAAM,IAAI,IAAI,MAAM,MAAM,GAAE;AAAA,UAC7F,oBAAC,KAAA,EAAI,WAAU,QAAO,IAAI,uBAAwB,UAAA,MAAM,QAAQ,EAAE,mBAAmB,IAAI,EAAE,uBAAuB,EAAA,CAAE;AAAA,QAAA;AAAA,MAAA;AAAA,MAN/F,MAAM;AAAA,IAAA,CAQlC,EAAA,CACL;AAAA,EAAA,GACJ;AAER;"}

package/dist/auth/passwordRules.js

@@ -0,0 +1,43 @@
+const PASSWORD_RULE = Object.freeze({
+  minLength: "minLength",
+  lowercase: "lowercase",
+  uppercase: "uppercase",
+  number: "number",
+  symbol: "symbol"
+});
+const DEFAULT_PASSWORD_POLICY = Object.freeze({
+  minLength: 12,
+  lowercase: true,
+  uppercase: true,
+  number: true,
+  symbol: false
+});
+const RULE_PATTERNS = Object.freeze({
+  [PASSWORD_RULE.lowercase]: new RegExp("\\p{Ll}", "u"),
+  [PASSWORD_RULE.uppercase]: new RegExp("\\p{Lu}", "u"),
+  [PASSWORD_RULE.number]: new RegExp("\\p{Nd}", "u"),
+  [PASSWORD_RULE.symbol]: /[^\p{L}\p{Nd}\s]/u
+});
+function passwordChecksOf(password, policy = DEFAULT_PASSWORD_POLICY) {
+  const text = password ?? "";
+  const checks = [];
+  if (policy.minLength > 0) {
+    checks.push({ rule: PASSWORD_RULE.minLength, isMet: Array.from(text).length >= policy.minLength, values: { count: policy.minLength } });
+  }
+  [PASSWORD_RULE.lowercase, PASSWORD_RULE.uppercase, PASSWORD_RULE.number, PASSWORD_RULE.symbol].forEach((rule) => {
+    if (policy[rule]) {
+      checks.push({ rule, isMet: RULE_PATTERNS[rule].test(text), values: {} });
+    }
+  });
+  return checks;
+}
+function isPasswordAccepted(password, policy = DEFAULT_PASSWORD_POLICY) {
+  return passwordChecksOf(password, policy).every((check) => check.isMet);
+}
+export {
+  DEFAULT_PASSWORD_POLICY,
+  PASSWORD_RULE,
+  isPasswordAccepted,
+  passwordChecksOf
+};
+//# sourceMappingURL=passwordRules.js.map

package/dist/auth/passwordRules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"passwordRules.js","sources":["../../src/auth/passwordRules.js"],"sourcesContent":["// Las reglas de una contraseña nueva y su revisión, para la lista que se va palomeando mientras la persona escribe\n// (ChangePasswordForm) y para el esquema del formulario (passwordSchemaOf).\n//\n// Decisiones, con su porqué:\n//   - La política la elige el proyecto (DEFAULT_PASSWORD_POLICY es solo el punto de partida): hay clientes que exigen\n//     mayúsculas y números por norma interna. La guía del NIST (SP 800-63B) dice que el largo protege más que mezclar\n//     tipos de letra; por eso el largo por omisión es 12 y el símbolo no se exige.\n//   - Se cuenta por caracteres que ve la persona (Array.from), no por unidades de JavaScript: un emoji cuenta como uno.\n//   - Esto es para no gastar un viaje al servidor en lo obvio: la regla que protege es la del backend.\n//\n// Funciones puras, sin React: function (regla de la casa). Se prueban con node --test (passwordRules.test.js).\n\n/** Las reglas que se pueden pedir. */\nexport const PASSWORD_RULE = Object.freeze({\n    minLength: 'minLength',\n    lowercase: 'lowercase',\n    uppercase: 'uppercase',\n    number: 'number',\n    symbol: 'symbol',\n});\n\n/** La política por omisión: 12 caracteres, con minúscula, mayúscula y número. */\nexport const DEFAULT_PASSWORD_POLICY = Object.freeze({\n    minLength: 12,\n    lowercase: true,\n    uppercase: true,\n    number: true,\n    symbol: false,\n});\n\n// qué cuenta para cada tipo de caracter (con acentos y ñ: \\p{Ll} y \\p{Lu} son las minúsculas y mayúsculas de cualquier idioma)\nconst RULE_PATTERNS = Object.freeze({\n    [PASSWORD_RULE.lowercase]: /\\p{Ll}/u,\n    [PASSWORD_RULE.uppercase]: /\\p{Lu}/u,\n    [PASSWORD_RULE.number]: /\\p{Nd}/u,\n    [PASSWORD_RULE.symbol]: /[^\\p{L}\\p{Nd}\\s]/u,\n});\n\n/**\n * Cada regla que pide la política, con si ya se cumple: es la lista que se pinta palomeada.\n *\n * @param {string} password lo que lleva escrito la persona\n * @param {object} [policy] por omisión DEFAULT_PASSWORD_POLICY\n * @returns {Array<{rule: string, isMet: boolean, values: object}>} en el orden de PASSWORD_RULE\n */\nexport function passwordChecksOf(password, policy = DEFAULT_PASSWORD_POLICY) {\n    const text = password ?? '';\n    const checks = [];\n    if (policy.minLength > 0) {\n        checks.push({rule: PASSWORD_RULE.minLength, isMet: Array.from(text).length >= policy.minLength, values: {count: policy.minLength}});\n    }\n    [PASSWORD_RULE.lowercase, PASSWORD_RULE.uppercase, PASSWORD_RULE.number, PASSWORD_RULE.symbol].forEach((rule) => {\n        if (policy[rule]) {\n            checks.push({rule, isMet: RULE_PATTERNS[rule].test(text), values: {}});\n        }\n    });\n    return checks;\n}\n\n/**\n * @param {string} password\n * @param {object} [policy]\n * @returns {boolean} si cumple todas las reglas de la política\n */\nexport function isPasswordAccepted(password, policy = DEFAULT_PASSWORD_POLICY) {\n    return passwordChecksOf(password, policy).every((check) => check.isMet);\n}\n"],"names":[],"mappings":"AAaY,MAAC,gBAAgB,OAAO,OAAO;AAAA,EACvC,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,QAAQ;AACZ,CAAC;AAGW,MAAC,0BAA0B,OAAO,OAAO;AAAA,EACjD,WAAW;AAAA,EACX,WAAW;AAAA,EACX,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,QAAQ;AACZ,CAAC;AAGD,MAAM,gBAAgB,OAAO,OAAO;AAAA,EAChC,CAAC,cAAc,SAAS,GAAG,WAAA,WAAA,GAAS;AAAA,EACpC,CAAC,cAAc,SAAS,GAAG,WAAA,WAAA,GAAS;AAAA,EACpC,CAAC,cAAc,MAAM,GAAG,WAAA,WAAA,GAAS;AAAA,EACjC,CAAC,cAAc,MAAM,GAAG;AAC5B,CAAC;AASM,SAAS,iBAAiB,UAAU,SAAS,yBAAyB;AACzE,QAAM,OAAO,YAAY;AACzB,QAAM,SAAS,CAAA;AACf,MAAI,OAAO,YAAY,GAAG;AACtB,WAAO,KAAK,EAAC,MAAM,cAAc,WAAW,OAAO,MAAM,KAAK,IAAI,EAAE,UAAU,OAAO,WAAW,QAAQ,EAAC,OAAO,OAAO,UAAS,EAAC,CAAC;AAAA,EACtI;AACA,GAAC,cAAc,WAAW,cAAc,WAAW,cAAc,QAAQ,cAAc,MAAM,EAAE,QAAQ,CAAC,SAAS;AAC7G,QAAI,OAAO,IAAI,GAAG;AACd,aAAO,KAAK,EAAC,MAAM,OAAO,cAAc,IAAI,EAAE,KAAK,IAAI,GAAG,QAAQ,CAAA,EAAE,CAAC;AAAA,IACzE;AAAA,EACJ,CAAC;AACD,SAAO;AACX;AAOO,SAAS,mBAAmB,UAAU,SAAS,yBAAyB;AAC3E,SAAO,iBAAiB,UAAU,MAAM,EAAE,MAAM,CAAC,UAAU,MAAM,KAAK;AAC1E;"}

package/dist/calendar/EventCalendar.js

@@ -0,0 +1,138 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useRef, useState } from "react";
+import FullCalendar from "@fullcalendar/react";
+import dayGridPlugin from "@fullcalendar/daygrid";
+import interactionPlugin from "@fullcalendar/interaction";
+import listPlugin from "@fullcalendar/list";
+import timeGridPlugin from "@fullcalendar/timegrid";
+import spanishLocale from "@fullcalendar/core/locales/es";
+import Box from "@mui/material/Box";
+import Button from "@mui/material/Button";
+import IconButton from "@mui/material/IconButton";
+import Stack from "@mui/material/Stack";
+import Tooltip from "@mui/material/Tooltip";
+import Typography from "@mui/material/Typography";
+import { useTheme } from "@mui/material/styles";
+import ChevronLeftRoundedIcon from "@mui/icons-material/ChevronLeftRounded";
+import ChevronRightRoundedIcon from "@mui/icons-material/ChevronRightRounded";
+import { paletteOf } from "../theme/components/paletteOf.js";
+import { useToolkitSettings } from "../toolkit/toolkitContext.js";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import SegmentedControl from "../ui/filters/SegmentedControl.js";
+const CALENDAR_VIEW = Object.freeze({ month: "dayGridMonth", week: "timeGridWeek", day: "timeGridDay", list: "listWeek" });
+const VIEW_TEXT_KEY = Object.freeze({
+  [CALENDAR_VIEW.month]: "month",
+  [CALENDAR_VIEW.week]: "week",
+  [CALENDAR_VIEW.day]: "day",
+  [CALENDAR_VIEW.list]: "list"
+});
+const DAY_MAX_EVENTS = 3;
+const MONDAY = 1;
+function capitalizeFirst(text) {
+  return text ? text.charAt(0).toLocaleUpperCase() + text.slice(1) : text;
+}
+function calendarStylesOf(theme) {
+  const palette = paletteOf(theme);
+  return {
+    "--fc-border-color": palette.divider,
+    "--fc-page-bg-color": "transparent",
+    "--fc-neutral-bg-color": palette.action.hover,
+    "--fc-today-bg-color": `color-mix(in srgb, ${palette.primary.main} 8%, transparent)`,
+    "--fc-list-event-hover-bg-color": palette.action.hover,
+    "--fc-now-indicator-color": palette.error.main,
+    "--fc-highlight-color": `color-mix(in srgb, ${palette.primary.main} 14%, transparent)`,
+    "& .fc": { fontFamily: "inherit", fontSize: theme.typography.body2.fontSize },
+    // los números de los días y los encabezados son ligas en FullCalendar: sin subrayado y del color del texto
+    "& .fc a": { color: "inherit", textDecoration: "none" },
+    "& .fc-col-header-cell-cushion": { fontWeight: 600, py: 1 },
+    "& .fc-event": { borderRadius: "6px", px: 0.5 },
+    // la hora no se encoge: en un día angosto se recortaba («1C» en lugar de «10»); lo que se corta es el nombre
+    "& .fc-event-time": { flexShrink: 0, overflow: "visible" },
+    "& .fc-scrollgrid": { borderRadius: "12px", overflow: "hidden" },
+    "& .fc-list": { borderRadius: "12px" }
+  };
+}
+function EventCalendar({
+  events,
+  initialView = CALENDAR_VIEW.month,
+  views = Object.values(CALENDAR_VIEW),
+  onEventClick,
+  onDateSelect,
+  onEventChange,
+  height = "auto",
+  ariaLabel
+}) {
+  const theme = useTheme();
+  const palette = paletteOf(theme);
+  const { t } = useToolkitTranslation("calendar");
+  const { language } = useToolkitSettings();
+  const calendarRef = useRef(null);
+  const [title, setTitle] = useState("");
+  const [view, setView] = useState(initialView);
+  const calendarApi = () => calendarRef.current?.getApi();
+  const coloredEvents = events.map((event) => {
+    const color = palette[event.tone] ?? palette.primary;
+    return { ...event, backgroundColor: color.main, borderColor: color.main, textColor: color.contrastText };
+  });
+  const changeEvent = async ({ event, revert }) => {
+    try {
+      await onEventChange({ id: event.id, start: event.startStr, end: event.endStr || null, allDay: event.allDay });
+    } catch {
+      revert();
+    }
+  };
+  return /* @__PURE__ */ jsxs(Stack, { spacing: 2, role: "region", "aria-label": ariaLabel, children: [
+    /* @__PURE__ */ jsxs(Stack, { direction: { xs: "column", md: "row" }, spacing: 1.5, sx: { alignItems: { md: "center" }, justifyContent: "space-between" }, children: [
+      /* @__PURE__ */ jsxs(Stack, { direction: "row", spacing: 1, sx: { alignItems: "center" }, children: [
+        /* @__PURE__ */ jsx(Tooltip, { title: t("previous"), children: /* @__PURE__ */ jsx(IconButton, { "aria-label": t("previous"), onClick: () => calendarApi()?.prev(), children: /* @__PURE__ */ jsx(ChevronLeftRoundedIcon, {}) }) }),
+        /* @__PURE__ */ jsx(Tooltip, { title: t("next"), children: /* @__PURE__ */ jsx(IconButton, { "aria-label": t("next"), onClick: () => calendarApi()?.next(), children: /* @__PURE__ */ jsx(ChevronRightRoundedIcon, {}) }) }),
+        /* @__PURE__ */ jsx(Button, { variant: "outlined", size: "small", onClick: () => calendarApi()?.today(), children: t("today") }),
+        /* @__PURE__ */ jsx(Typography, { variant: "h6", component: "h2", sx: { pl: 1 }, "aria-live": "polite", children: capitalizeFirst(title) })
+      ] }),
+      views.length > 1 && /* @__PURE__ */ jsx(
+        SegmentedControl,
+        {
+          ariaLabel: t("view"),
+          value: view,
+          onChange: (nextView) => calendarApi()?.changeView(nextView),
+          options: views.map((value) => ({ value, label: t(`views.${VIEW_TEXT_KEY[value]}`) }))
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx(Box, { sx: calendarStylesOf, children: /* @__PURE__ */ jsx(
+      FullCalendar,
+      {
+        ref: calendarRef,
+        plugins: [dayGridPlugin, timeGridPlugin, listPlugin, interactionPlugin],
+        initialView,
+        headerToolbar: false,
+        locale: language === "es" ? spanishLocale : "en",
+        firstDay: MONDAY,
+        height,
+        nowIndicator: true,
+        dayMaxEvents: DAY_MAX_EVENTS,
+        events: coloredEvents,
+        eventDisplay: "block",
+        datesSet: (dateInfo) => {
+          setTitle(dateInfo.view.title);
+          setView(dateInfo.view.type);
+        },
+        eventClick: onEventClick ? (clickInfo) => onEventClick(clickInfo.event.id) : void 0,
+        selectable: Boolean(onDateSelect),
+        selectMirror: true,
+        select: onDateSelect ? (selectInfo) => {
+          onDateSelect({ start: selectInfo.startStr, end: selectInfo.endStr, allDay: selectInfo.allDay });
+          calendarApi()?.unselect();
+        } : void 0,
+        editable: Boolean(onEventChange),
+        eventChange: onEventChange ? changeEvent : void 0
+      }
+    ) })
+  ] });
+}
+export {
+  CALENDAR_VIEW,
+  EventCalendar as default
+};
+//# sourceMappingURL=EventCalendar.js.map

package/dist/calendar/EventCalendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventCalendar.js","sources":["../../src/calendar/EventCalendar.jsx"],"sourcesContent":["// Un calendario de eventos (@stackcraftmx/calcita/calendar): FullCalendar por dentro, con la barra del framework (anterior y\n// siguiente, «Hoy», el título y la vista con el control segmentado) y los colores del tema. En el idioma de\n// ToolkitProvider, la semana empieza en lunes y marca la hora actual. Las citas van en bloques de su color (el color es\n// información: el tipo de cita), no en puntitos.\n//\n//   <EventCalendar events={[{id: '1', title: 'Entrega P-2375', start: '2026-10-20T10:00', end: '2026-10-20T11:00', tone: 'info'}]}\n//                  onEventClick={openDetail} onDateSelect={openNewEvent} onEventChange={(change) => api.patch(...)} />\n//\n// Arrastrar un evento lo cambia de día u hora: onEventChange recibe lo nuevo y, si truena (el servidor dijo que no), el\n// evento regresa a donde estaba. Sin onEventChange no se puede arrastrar; sin onDateSelect no se pueden elegir días.\n//\n// OJO: las horas se pintan en la zona del navegador (FullCalendar pide un complemento aparte para zonas con nombre).\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useRef, useState} from 'react';\nimport FullCalendar from '@fullcalendar/react';\nimport dayGridPlugin from '@fullcalendar/daygrid';\nimport interactionPlugin from '@fullcalendar/interaction';\nimport listPlugin from '@fullcalendar/list';\nimport timeGridPlugin from '@fullcalendar/timegrid';\nimport spanishLocale from '@fullcalendar/core/locales/es';\nimport Box from '@mui/material/Box';\nimport Button from '@mui/material/Button';\nimport IconButton from '@mui/material/IconButton';\nimport Stack from '@mui/material/Stack';\nimport Tooltip from '@mui/material/Tooltip';\nimport Typography from '@mui/material/Typography';\nimport {useTheme} from '@mui/material/styles';\nimport ChevronLeftRoundedIcon from '@mui/icons-material/ChevronLeftRounded';\nimport ChevronRightRoundedIcon from '@mui/icons-material/ChevronRightRounded';\n\nimport {paletteOf} from '@/theme/components/paletteOf.js';\nimport {useToolkitSettings} from '@/toolkit/toolkitContext.js';\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport SegmentedControl from '@/ui/filters/SegmentedControl.jsx';\n\n/** Las vistas del calendario (los nombres de FullCalendar). */\nexport const CALENDAR_VIEW = Object.freeze({month: 'dayGridMonth', week: 'timeGridWeek', day: 'timeGridDay', list: 'listWeek'});\n\n// el texto de cada vista en los textos del paquete (calendar.views.*)\nconst VIEW_TEXT_KEY = Object.freeze({\n    [CALENDAR_VIEW.month]: 'month', [CALENDAR_VIEW.week]: 'week', [CALENDAR_VIEW.day]: 'day', [CALENDAR_VIEW.list]: 'list',\n});\n// cuántos eventos caben en un día del mes antes del «+2 más»\nconst DAY_MAX_EVENTS = 3;\nconst MONDAY = 1;\n\n/**\n * La primera letra en mayúscula y lo demás como viene: «octubre de 2026» → «Octubre de 2026». OJO: con CSS\n * (text-transform: capitalize) salía «Octubre De 2026»: en español solo va la primera.\n *\n * @param {string} text\n * @returns {string}\n */\nfunction capitalizeFirst(text) {\n    return text ? text.charAt(0).toLocaleUpperCase() + text.slice(1) : text;\n}\n\n/**\n * Los colores del calendario sobre el tema (las variables CSS de FullCalendar), en claro y en oscuro.\n *\n * @param {object} theme\n * @returns {object}\n */\nfunction calendarStylesOf(theme) {\n    const palette = paletteOf(theme);\n    return {\n        '--fc-border-color': palette.divider,\n        '--fc-page-bg-color': 'transparent',\n        '--fc-neutral-bg-color': palette.action.hover,\n        '--fc-today-bg-color': `color-mix(in srgb, ${palette.primary.main} 8%, transparent)`,\n        '--fc-list-event-hover-bg-color': palette.action.hover,\n        '--fc-now-indicator-color': palette.error.main,\n        '--fc-highlight-color': `color-mix(in srgb, ${palette.primary.main} 14%, transparent)`,\n        '& .fc': {fontFamily: 'inherit', fontSize: theme.typography.body2.fontSize},\n        // los números de los días y los encabezados son ligas en FullCalendar: sin subrayado y del color del texto\n        '& .fc a': {color: 'inherit', textDecoration: 'none'},\n        '& .fc-col-header-cell-cushion': {fontWeight: 600, py: 1},\n        '& .fc-event': {borderRadius: '6px', px: 0.5},\n        // la hora no se encoge: en un día angosto se recortaba («1C» en lugar de «10»); lo que se corta es el nombre\n        '& .fc-event-time': {flexShrink: 0, overflow: 'visible'},\n        '& .fc-scrollgrid': {borderRadius: '12px', overflow: 'hidden'},\n        '& .fc-list': {borderRadius: '12px'},\n    };\n}\n\n/**\n * @param {object} props\n * @param {Array<{id: string, title: string, start: string, end?: string, allDay?: boolean, tone?: string}>} props.events\n *     start y end como texto ISO; tone: un color del tema (por omisión primary)\n * @param {string} [props.initialView] una de CALENDAR_VIEW\n * @param {string[]} [props.views] las que se ofrecen en el control segmentado\n * @param {(eventId: string) => void} [props.onEventClick]\n * @param {(range: {start: string, end: string, allDay: boolean}) => void} [props.onDateSelect] al elegir días u horas\n * @param {(change: {id: string, start: string, end: string|null, allDay: boolean}) => Promise<unknown>|void} [props.onEventChange]\n *     al arrastrar un evento; si truena, el evento regresa\n * @param {number|'auto'} [props.height]\n * @param {string} props.ariaLabel ya traducido\n */\nexport default function EventCalendar({\n    events, initialView = CALENDAR_VIEW.month, views = Object.values(CALENDAR_VIEW), onEventClick, onDateSelect, onEventChange, height = 'auto', ariaLabel,\n}) {\n    const theme = useTheme();\n    const palette = paletteOf(theme);\n    const {t} = useToolkitTranslation('calendar');\n    const {language} = useToolkitSettings();\n    const calendarRef = useRef(null);\n    const [title, setTitle] = useState('');\n    const [view, setView] = useState(initialView);\n    const calendarApi = () => calendarRef.current?.getApi();\n\n    const coloredEvents = events.map((event) => {\n        const color = palette[event.tone] ?? palette.primary;\n        return {...event, backgroundColor: color.main, borderColor: color.main, textColor: color.contrastText};\n    });\n\n    const changeEvent = async ({event, revert}) => {\n        try {\n            await onEventChange({id: event.id, start: event.startStr, end: event.endStr || null, allDay: event.allDay});\n        } catch {\n            // el servidor dijo que no: el evento regresa a donde estaba (quien llama ya avisó el error)\n            revert();\n        }\n    };\n\n    return (\n        <Stack spacing={2} role=\"region\" aria-label={ariaLabel}>\n            <Stack direction={{xs: 'column', md: 'row'}} spacing={1.5} sx={{alignItems: {md: 'center'}, justifyContent: 'space-between'}}>\n                <Stack direction=\"row\" spacing={1} sx={{alignItems: 'center'}}>\n                    <Tooltip title={t('previous')}>\n                        <IconButton aria-label={t('previous')} onClick={() => calendarApi()?.prev()}><ChevronLeftRoundedIcon /></IconButton>\n                    </Tooltip>\n                    <Tooltip title={t('next')}>\n                        <IconButton aria-label={t('next')} onClick={() => calendarApi()?.next()}><ChevronRightRoundedIcon /></IconButton>\n                    </Tooltip>\n                    <Button variant=\"outlined\" size=\"small\" onClick={() => calendarApi()?.today()}>{t('today')}</Button>\n                    <Typography variant=\"h6\" component=\"h2\" sx={{pl: 1}} aria-live=\"polite\">{capitalizeFirst(title)}</Typography>\n                </Stack>\n                {views.length > 1 && (\n                    <SegmentedControl ariaLabel={t('view')} value={view} onChange={(nextView) => calendarApi()?.changeView(nextView)}\n                                      options={views.map((value) => ({value, label: t(`views.${VIEW_TEXT_KEY[value]}`)}))} />\n                )}\n            </Stack>\n            <Box sx={calendarStylesOf}>\n                <FullCalendar ref={calendarRef} plugins={[dayGridPlugin, timeGridPlugin, listPlugin, interactionPlugin]} initialView={initialView}\n                              headerToolbar={false} locale={language === 'es' ? spanishLocale : 'en'} firstDay={MONDAY} height={height}\n                              nowIndicator dayMaxEvents={DAY_MAX_EVENTS} events={coloredEvents} eventDisplay=\"block\"\n                              datesSet={(dateInfo) => {\n                                  setTitle(dateInfo.view.title);\n                                  setView(dateInfo.view.type);\n                              }}\n                              eventClick={onEventClick ? (clickInfo) => onEventClick(clickInfo.event.id) : undefined}\n                              selectable={Boolean(onDateSelect)} selectMirror\n                              select={onDateSelect ? (selectInfo) => {\n                                  onDateSelect({start: selectInfo.startStr, end: selectInfo.endStr, allDay: selectInfo.allDay});\n                                  calendarApi()?.unselect();\n                              } : undefined}\n                              editable={Boolean(onEventChange)} eventChange={onEventChange ? changeEvent : undefined} />\n            </Box>\n        </Stack>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAqCO,MAAM,gBAAgB,OAAO,OAAO,EAAC,OAAO,gBAAgB,MAAM,gBAAgB,KAAK,eAAe,MAAM,WAAA,CAAW;AAG9H,MAAM,gBAAgB,OAAO,OAAO;AAAA,EAChC,CAAC,cAAc,KAAK,GAAG;AAAA,EAAS,CAAC,cAAc,IAAI,GAAG;AAAA,EAAQ,CAAC,cAAc,GAAG,GAAG;AAAA,EAAO,CAAC,cAAc,IAAI,GAAG;AACpH,CAAC;AAED,MAAM,iBAAiB;AACvB,MAAM,SAAS;AASf,SAAS,gBAAgB,MAAM;AAC3B,SAAO,OAAO,KAAK,OAAO,CAAC,EAAE,sBAAsB,KAAK,MAAM,CAAC,IAAI;AACvE;AAQA,SAAS,iBAAiB,OAAO;AAC7B,QAAM,UAAU,UAAU,KAAK;AAC/B,SAAO;AAAA,IACH,qBAAqB,QAAQ;AAAA,IAC7B,sBAAsB;AAAA,IACtB,yBAAyB,QAAQ,OAAO;AAAA,IACxC,uBAAuB,sBAAsB,QAAQ,QAAQ,IAAI;AAAA,IACjE,kCAAkC,QAAQ,OAAO;AAAA,IACjD,4BAA4B,QAAQ,MAAM;AAAA,IAC1C,wBAAwB,sBAAsB,QAAQ,QAAQ,IAAI;AAAA,IAClE,SAAS,EAAC,YAAY,WAAW,UAAU,MAAM,WAAW,MAAM,SAAA;AAAA;AAAA,IAElE,WAAW,EAAC,OAAO,WAAW,gBAAgB,OAAA;AAAA,IAC9C,iCAAiC,EAAC,YAAY,KAAK,IAAI,EAAA;AAAA,IACvD,eAAe,EAAC,cAAc,OAAO,IAAI,IAAA;AAAA;AAAA,IAEzC,oBAAoB,EAAC,YAAY,GAAG,UAAU,UAAA;AAAA,IAC9C,oBAAoB,EAAC,cAAc,QAAQ,UAAU,SAAA;AAAA,IACrD,cAAc,EAAC,cAAc,OAAA;AAAA,EAAM;AAE3C;AAeA,SAAwB,cAAc;AAAA,EAClC;AAAA,EAAQ,cAAc,cAAc;AAAA,EAAO,QAAQ,OAAO,OAAO,aAAa;AAAA,EAAG;AAAA,EAAc;AAAA,EAAc;AAAA,EAAe,SAAS;AAAA,EAAQ;AACjJ,GAAG;AACC,QAAM,QAAQ,SAAA;AACd,QAAM,UAAU,UAAU,KAAK;AAC/B,QAAM,EAAC,EAAA,IAAK,sBAAsB,UAAU;AAC5C,QAAM,EAAC,SAAA,IAAY,mBAAA;AACnB,QAAM,cAAc,OAAO,IAAI;AAC/B,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAS,EAAE;AACrC,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,WAAW;AAC5C,QAAM,cAAc,MAAM,YAAY,SAAS,OAAA;AAE/C,QAAM,gBAAgB,OAAO,IAAI,CAAC,UAAU;AACxC,UAAM,QAAQ,QAAQ,MAAM,IAAI,KAAK,QAAQ;AAC7C,WAAO,EAAC,GAAG,OAAO,iBAAiB,MAAM,MAAM,aAAa,MAAM,MAAM,WAAW,MAAM,aAAA;AAAA,EAC7F,CAAC;AAED,QAAM,cAAc,OAAO,EAAC,OAAO,aAAY;AAC3C,QAAI;AACA,YAAM,cAAc,EAAC,IAAI,MAAM,IAAI,OAAO,MAAM,UAAU,KAAK,MAAM,UAAU,MAAM,QAAQ,MAAM,QAAO;AAAA,IAC9G,QAAQ;AAEJ,aAAA;AAAA,IACJ;AAAA,EACJ;AAEA,8BACK,OAAA,EAAM,SAAS,GAAG,MAAK,UAAS,cAAY,WACzC,UAAA;AAAA,IAAA,qBAAC,SAAM,WAAW,EAAC,IAAI,UAAU,IAAI,SAAQ,SAAS,KAAK,IAAI,EAAC,YAAY,EAAC,IAAI,YAAW,gBAAgB,mBACxG,UAAA;AAAA,MAAA,qBAAC,OAAA,EAAM,WAAU,OAAM,SAAS,GAAG,IAAI,EAAC,YAAY,SAAA,GAChD,UAAA;AAAA,QAAA,oBAAC,SAAA,EAAQ,OAAO,EAAE,UAAU,GACxB,UAAA,oBAAC,YAAA,EAAW,cAAY,EAAE,UAAU,GAAG,SAAS,MAAM,eAAe,KAAA,GAAQ,UAAA,oBAAC,wBAAA,EAAuB,GAAE,EAAA,CAC3G;AAAA,QACA,oBAAC,WAAQ,OAAO,EAAE,MAAM,GACpB,UAAA,oBAAC,cAAW,cAAY,EAAE,MAAM,GAAG,SAAS,MAAM,YAAA,GAAe,QAAQ,UAAA,oBAAC,yBAAA,EAAwB,EAAA,CAAE,EAAA,CACxG;AAAA,QACA,oBAAC,QAAA,EAAO,SAAQ,YAAW,MAAK,SAAQ,SAAS,MAAM,YAAA,GAAe,MAAA,GAAU,UAAA,EAAE,OAAO,GAAE;AAAA,QAC3F,oBAAC,YAAA,EAAW,SAAQ,MAAK,WAAU,MAAK,IAAI,EAAC,IAAI,KAAI,aAAU,UAAU,UAAA,gBAAgB,KAAK,EAAA,CAAE;AAAA,MAAA,GACpG;AAAA,MACC,MAAM,SAAS,KACZ;AAAA,QAAC;AAAA,QAAA;AAAA,UAAiB,WAAW,EAAE,MAAM;AAAA,UAAG,OAAO;AAAA,UAAM,UAAU,CAAC,aAAa,YAAA,GAAe,WAAW,QAAQ;AAAA,UAC7F,SAAS,MAAM,IAAI,CAAC,WAAW,EAAC,OAAO,OAAO,EAAE,SAAS,cAAc,KAAK,CAAC,EAAE,IAAG;AAAA,QAAA;AAAA,MAAA;AAAA,IAAG,GAE/G;AAAA,IACA,oBAAC,KAAA,EAAI,IAAI,kBACL,UAAA;AAAA,MAAC;AAAA,MAAA;AAAA,QAAa,KAAK;AAAA,QAAa,SAAS,CAAC,eAAe,gBAAgB,YAAY,iBAAiB;AAAA,QAAG;AAAA,QAC3F,eAAe;AAAA,QAAO,QAAQ,aAAa,OAAO,gBAAgB;AAAA,QAAM,UAAU;AAAA,QAAQ;AAAA,QAC1F,cAAY;AAAA,QAAC,cAAc;AAAA,QAAgB,QAAQ;AAAA,QAAe,cAAa;AAAA,QAC/E,UAAU,CAAC,aAAa;AACpB,mBAAS,SAAS,KAAK,KAAK;AAC5B,kBAAQ,SAAS,KAAK,IAAI;AAAA,QAC9B;AAAA,QACA,YAAY,eAAe,CAAC,cAAc,aAAa,UAAU,MAAM,EAAE,IAAI;AAAA,QAC7E,YAAY,QAAQ,YAAY;AAAA,QAAG,cAAY;AAAA,QAC/C,QAAQ,eAAe,CAAC,eAAe;AACnC,uBAAa,EAAC,OAAO,WAAW,UAAU,KAAK,WAAW,QAAQ,QAAQ,WAAW,OAAA,CAAO;AAC5F,sBAAA,GAAe,SAAA;AAAA,QACnB,IAAI;AAAA,QACJ,UAAU,QAAQ,aAAa;AAAA,QAAG,aAAa,gBAAgB,cAAc;AAAA,MAAA;AAAA,IAAA,EAAW,CAC1G;AAAA,EAAA,GACJ;AAER;"}

package/dist/calendar.js

@@ -0,0 +1,6 @@
+import { CALENDAR_VIEW, default as default2 } from "./calendar/EventCalendar.js";
+export {
+  CALENDAR_VIEW,
+  default2 as EventCalendar
+};
+//# sourceMappingURL=calendar.js.map

package/dist/calendar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/charts.js

@@ -0,0 +1,7 @@
+import { default as default2 } from "./ui/metrics/BarList.js";
+import { default as default3 } from "./ui/metrics/ColumnChart.js";
+export {
+  default2 as BarList,
+  default3 as ColumnChart
+};
+//# sourceMappingURL=charts.js.map

package/dist/charts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"charts.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/date-pickers.js

@@ -0,0 +1,8 @@
+import { CALENDAR_DATE_FORMAT, default as default2 } from "./datePickers/DateInput.js";
+import { default as default3 } from "./datePickers/FormDateField.js";
+export {
+  CALENDAR_DATE_FORMAT,
+  default2 as DateInput,
+  default3 as FormDateField
+};
+//# sourceMappingURL=date-pickers.js.map

package/dist/date-pickers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-pickers.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/dist/datePickers/DateInput.js

@@ -0,0 +1,75 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useId } from "react";
+import dayjs from "dayjs";
+import "dayjs/locale/es";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import { AdapterDayjs } from "@mui/x-date-pickers/AdapterDayjs";
+import { DatePicker } from "@mui/x-date-pickers/DatePicker";
+import { LocalizationProvider } from "@mui/x-date-pickers/LocalizationProvider";
+import { enUS, esES } from "@mui/x-date-pickers/locales";
+import { translateValidationMessage } from "../forms/validationMessages.js";
+import FieldFrame from "../inputs/FieldFrame.js";
+const CALENDAR_DATE_FORMAT = "YYYY-MM-DD";
+const DATE_LOOK_BY_LANGUAGE = Object.freeze({
+  es: { adapterLocale: "es", displayFormat: "DD/MM/YYYY", localeText: esES.components.MuiLocalizationProvider.defaultProps.localeText },
+  en: { adapterLocale: "en", displayFormat: "MM/DD/YYYY", localeText: enUS.components.MuiLocalizationProvider.defaultProps.localeText }
+});
+function pickerValueOf(calendarDate) {
+  return calendarDate ? dayjs(calendarDate) : null;
+}
+function DateInput({
+  name,
+  label,
+  value,
+  onChange,
+  onBlur,
+  error,
+  helperText = " ",
+  minDate,
+  maxDate,
+  disableFuture = false,
+  disablePast = false,
+  openTo = "day",
+  disabled = false,
+  inputRef
+}) {
+  const { t, language } = useToolkitTranslation("common");
+  const generatedId = useId();
+  const inputId = `${name ?? "date"}-${generatedId}`;
+  const errorText = translateValidationMessage(t, error);
+  const look = DATE_LOOK_BY_LANGUAGE[language] ?? DATE_LOOK_BY_LANGUAGE.es;
+  return /* @__PURE__ */ jsx(FieldFrame, { inputId, label, children: /* @__PURE__ */ jsx(LocalizationProvider, { dateAdapter: AdapterDayjs, adapterLocale: look.adapterLocale, localeText: look.localeText, children: /* @__PURE__ */ jsx(
+    DatePicker,
+    {
+      format: look.displayFormat,
+      value: pickerValueOf(value),
+      minDate: pickerValueOf(minDate) ?? void 0,
+      maxDate: pickerValueOf(maxDate) ?? void 0,
+      disableFuture,
+      disablePast,
+      disabled,
+      openTo,
+      views: openTo === "year" ? ["year", "month", "day"] : void 0,
+      inputRef,
+      onChange: (pickedDate) => onChange(pickedDate?.isValid() ? pickedDate.format(CALENDAR_DATE_FORMAT) : ""),
+      onClose: onBlur,
+      slotProps: {
+        textField: {
+          id: inputId,
+          name,
+          size: "small",
+          fullWidth: true,
+          onBlur,
+          error: Boolean(errorText),
+          helperText: errorText ?? helperText
+        }
+      }
+    }
+  ) }) });
+}
+export {
+  CALENDAR_DATE_FORMAT,
+  DateInput as default
+};
+//# sourceMappingURL=DateInput.js.map

package/dist/datePickers/DateInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateInput.js","sources":["../../src/datePickers/DateInput.jsx"],"sourcesContent":["// Campo de FECHA suelto con el DatePicker de MUI X (@stackcraftmx/calcita/date-pickers), con la etiqueta arriba como los\n// demás campos del paquete.\n//\n// Al formulario (y al servidor) viaja la fecha de calendario 'AAAA-MM-DD' en texto; en pantalla se ve DD/MM/AAAA en español\n// y MM/DD/AAAA en inglés, con el calendario y sus textos en el idioma activo. '' = sin fecha. Una fecha de calendario no\n// tiene hora ni zona: nunca se pasa por Date (que la movería de día según la zona).\n//\n// Cada campo trae su LocalizationProvider con dayjs: la pantalla no tiene que poner nada alrededor.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useId} from 'react';\nimport dayjs from 'dayjs';\nimport 'dayjs/locale/es';\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport {AdapterDayjs} from '@mui/x-date-pickers/AdapterDayjs';\nimport {DatePicker} from '@mui/x-date-pickers/DatePicker';\nimport {LocalizationProvider} from '@mui/x-date-pickers/LocalizationProvider';\nimport {enUS, esES} from '@mui/x-date-pickers/locales';\n\nimport {translateValidationMessage} from '@/forms/validationMessages.js';\nimport FieldFrame from '@/inputs/FieldFrame.jsx';\n\n/** Cómo viaja una fecha de calendario. */\nexport const CALENDAR_DATE_FORMAT = 'YYYY-MM-DD';\n\n// cómo se ve y con qué textos sale el calendario en cada idioma\nconst DATE_LOOK_BY_LANGUAGE = Object.freeze({\n    es: {adapterLocale: 'es', displayFormat: 'DD/MM/YYYY', localeText: esES.components.MuiLocalizationProvider.defaultProps.localeText},\n    en: {adapterLocale: 'en', displayFormat: 'MM/DD/YYYY', localeText: enUS.components.MuiLocalizationProvider.defaultProps.localeText},\n});\n\n/**\n * Una fecha de calendario 'AAAA-MM-DD' como la quiere el DatePicker; null si está vacía.\n *\n * @param {string|null|undefined} calendarDate\n * @returns {import('dayjs').Dayjs|null}\n */\nfunction pickerValueOf(calendarDate) {\n    // dayjs lee 'AAAA-MM-DD' como día local (a diferencia de new Date, que lo toma en UTC y lo mueve de día)\n    return calendarDate ? dayjs(calendarDate) : null;\n}\n\n/**\n * @param {object} props\n * @param {string} [props.name]\n * @param {string} props.label ya traducido\n * @param {string|null|undefined} props.value 'AAAA-MM-DD' o ''\n * @param {(value: string) => void} props.onChange recibe 'AAAA-MM-DD' ('' al borrar o con una fecha a medias)\n * @param {() => void} [props.onBlur]\n * @param {string|{key: string, values?: object}} [props.error]\n * @param {string} [props.helperText]\n * @param {string} [props.minDate] 'AAAA-MM-DD'\n * @param {string} [props.maxDate] 'AAAA-MM-DD'\n * @param {boolean} [props.disableFuture] p. ej. una fecha de nacimiento\n * @param {boolean} [props.disablePast] p. ej. una cita\n * @param {'day'|'month'|'year'} [props.openTo] por dónde abre el calendario (year para un nacimiento)\n * @param {boolean} [props.disabled]\n * @param {import('react').Ref<HTMLInputElement>} [props.inputRef]\n */\nexport default function DateInput({\n    name, label, value, onChange, onBlur, error, helperText = ' ', minDate, maxDate, disableFuture = false, disablePast = false,\n    openTo = 'day', disabled = false, inputRef,\n}) {\n    const {t, language} = useToolkitTranslation('common');\n    const generatedId = useId();\n    const inputId = `${name ?? 'date'}-${generatedId}`;\n    const errorText = translateValidationMessage(t, error);\n    const look = DATE_LOOK_BY_LANGUAGE[language] ?? DATE_LOOK_BY_LANGUAGE.es;\n\n    return (\n        <FieldFrame inputId={inputId} label={label}>\n            <LocalizationProvider dateAdapter={AdapterDayjs} adapterLocale={look.adapterLocale} localeText={look.localeText}>\n                <DatePicker\n                    format={look.displayFormat}\n                    value={pickerValueOf(value)}\n                    minDate={pickerValueOf(minDate) ?? undefined}\n                    maxDate={pickerValueOf(maxDate) ?? undefined}\n                    disableFuture={disableFuture}\n                    disablePast={disablePast}\n                    disabled={disabled}\n                    openTo={openTo}\n                    views={openTo === 'year' ? ['year', 'month', 'day'] : undefined}\n                    inputRef={inputRef}\n                    // una fecha a medias (25/1_/____) todavía no es fecha: viaja como vacía hasta que se complete\n                    onChange={(pickedDate) => onChange(pickedDate?.isValid() ? pickedDate.format(CALENDAR_DATE_FORMAT) : '')}\n                    onClose={onBlur}\n                    slotProps={{\n                        textField: {\n                            id: inputId, name, size: 'small', fullWidth: true, onBlur, error: Boolean(errorText), helperText: errorText ?? helperText,\n                        },\n                    }}\n                />\n            </LocalizationProvider>\n        </FieldFrame>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAuBO,MAAM,uBAAuB;AAGpC,MAAM,wBAAwB,OAAO,OAAO;AAAA,EACxC,IAAI,EAAC,eAAe,MAAM,eAAe,cAAc,YAAY,KAAK,WAAW,wBAAwB,aAAa,WAAA;AAAA,EACxH,IAAI,EAAC,eAAe,MAAM,eAAe,cAAc,YAAY,KAAK,WAAW,wBAAwB,aAAa,WAAA;AAC5H,CAAC;AAQD,SAAS,cAAc,cAAc;AAEjC,SAAO,eAAe,MAAM,YAAY,IAAI;AAChD;AAmBA,SAAwB,UAAU;AAAA,EAC9B;AAAA,EAAM;AAAA,EAAO;AAAA,EAAO;AAAA,EAAU;AAAA,EAAQ;AAAA,EAAO,aAAa;AAAA,EAAK;AAAA,EAAS;AAAA,EAAS,gBAAgB;AAAA,EAAO,cAAc;AAAA,EACtH,SAAS;AAAA,EAAO,WAAW;AAAA,EAAO;AACtC,GAAG;AACC,QAAM,EAAC,GAAG,aAAY,sBAAsB,QAAQ;AACpD,QAAM,cAAc,MAAA;AACpB,QAAM,UAAU,GAAG,QAAQ,MAAM,IAAI,WAAW;AAChD,QAAM,YAAY,2BAA2B,GAAG,KAAK;AACrD,QAAM,OAAO,sBAAsB,QAAQ,KAAK,sBAAsB;AAEtE,SACI,oBAAC,YAAA,EAAW,SAAkB,OAC1B,UAAA,oBAAC,sBAAA,EAAqB,aAAa,cAAc,eAAe,KAAK,eAAe,YAAY,KAAK,YACjG,UAAA;AAAA,IAAC;AAAA,IAAA;AAAA,MACG,QAAQ,KAAK;AAAA,MACb,OAAO,cAAc,KAAK;AAAA,MAC1B,SAAS,cAAc,OAAO,KAAK;AAAA,MACnC,SAAS,cAAc,OAAO,KAAK;AAAA,MACnC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,OAAO,WAAW,SAAS,CAAC,QAAQ,SAAS,KAAK,IAAI;AAAA,MACtD;AAAA,MAEA,UAAU,CAAC,eAAe,SAAS,YAAY,YAAY,WAAW,OAAO,oBAAoB,IAAI,EAAE;AAAA,MACvG,SAAS;AAAA,MACT,WAAW;AAAA,QACP,WAAW;AAAA,UACP,IAAI;AAAA,UAAS;AAAA,UAAM,MAAM;AAAA,UAAS,WAAW;AAAA,UAAM;AAAA,UAAQ,OAAO,QAAQ,SAAS;AAAA,UAAG,YAAY,aAAa;AAAA,QAAA;AAAA,MACnH;AAAA,IACJ;AAAA,EAAA,GAER,EAAA,CACJ;AAER;"}

package/dist/datePickers/FormDateField.js

@@ -0,0 +1,12 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import DateInput from "./DateInput.js";
+import { useFormikField } from "../forms/useFormikField.js";
+function FormDateField({ name, ...dateInputProps }) {
+  const fieldProps = useFormikField(name);
+  return /* @__PURE__ */ jsx(DateInput, { ...dateInputProps, ...fieldProps });
+}
+export {
+  FormDateField as default
+};
+//# sourceMappingURL=FormDateField.js.map

package/dist/datePickers/FormDateField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormDateField.js","sources":["../../src/datePickers/FormDateField.jsx"],"sourcesContent":["// Campo de fecha de formik: DateInput conectado a su campo. Al formulario llega 'AAAA-MM-DD'.\n//\n// Con react-hook-form no hay uno listo (esta puerta no pide react-hook-form): DateInput va dentro de un Controller.\n//\n// Genérico del paquete: function (regla de la casa).\nimport DateInput from '@/datePickers/DateInput.jsx';\nimport {useFormikField} from '@/forms/useFormikField.js';\n\n/**\n * @param {{name: string} & Omit<Parameters<typeof import('@/datePickers/DateInput.jsx').default>[0], 'name'|'value'|'onChange'|'onBlur'|'error'>} props las de\n *     DateInput (minDate, maxDate, disableFuture, openTo…), sin value / onChange / onBlur / error\n */\nexport default function FormDateField({name, ...dateInputProps}) {\n    const fieldProps = useFormikField(name);\n    return <DateInput {...dateInputProps} {...fieldProps} />;\n}\n"],"names":[],"mappings":";;;;AAYA,SAAwB,cAAc,EAAC,MAAM,GAAG,kBAAiB;AAC7D,QAAM,aAAa,eAAe,IAAI;AACtC,SAAO,oBAAC,WAAA,EAAW,GAAG,gBAAiB,GAAG,WAAA,CAAY;AAC1D;"}

package/dist/dates.js

@@ -0,0 +1,25 @@
+const PLAIN_DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+function parseInstant(value) {
+  if (value === null || value === void 0 || value === "") {
+    return null;
+  }
+  const instant = new Date(value);
+  return Number.isNaN(instant.getTime()) ? null : instant;
+}
+function parsePlainDate(value) {
+  const match = typeof value === "string" ? PLAIN_DATE_PATTERN.exec(value) : null;
+  if (!match) {
+    return null;
+  }
+  const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];
+  const calendarDate = new Date(Date.UTC(year, month - 1, day));
+  if (calendarDate.getUTCMonth() !== month - 1 || calendarDate.getUTCDate() !== day) {
+    return null;
+  }
+  return { year, month, day };
+}
+export {
+  parseInstant,
+  parsePlainDate
+};
+//# sourceMappingURL=dates.js.map

package/dist/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sources":["../src/dates.js"],"sourcesContent":["// Fechas que llegan del API, leídas sin librería (Date + Intl).\n//\n// La zona en que se pintan las horas es la del proveedor (`timeZone` de ToolkitProvider; por omisión la del navegador).\n// Un negocio que decide sus cortes en una zona fija la pasa ahí, para que alguien que abre la pantalla desde otra zona\n// vea la misma hora que ve operación.\n//\n// El backend manda instantes ISO con desfase (UTC) y fechas de calendario sin hora (\"2026-08-16\"). Son dos cosas\n// distintas:\n//   - un instante es un punto en el tiempo (parseInstant); la zona del negocio la aplica Intl con timeZone al\n//     pintarlo (formatting.js), así que aquí no se convierte nada;\n//   - una fecha de calendario NO tiene zona: pasarla por Date la podría correr un día (parsePlainDate la separa en\n//     año, mes y día).\n//\n// Funciones puras, no renderizan: function (regla de la casa).\n\nconst PLAIN_DATE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\n\n/**\n * Un instante (ISO con desfase, milisegundos o Date) como Date válido.\n *\n * @param {string|Date|number|null|undefined} value\n * @returns {Date|null} null si no hay dato o no es una fecha válida\n */\nexport function parseInstant(value) {\n    if (value === null || value === undefined || value === '') {\n        return null;\n    }\n    const instant = new Date(value);\n    return Number.isNaN(instant.getTime()) ? null : instant;\n}\n\n/**\n * Una fecha de calendario (\"2026-08-16\") en sus partes, sin moverla de zona.\n *\n * @param {string|null|undefined} value\n * @returns {{year: number, month: number, day: number}|null} null si no tiene la forma o no existe (2026-02-31)\n */\nexport function parsePlainDate(value) {\n    const match = typeof value === 'string' ? PLAIN_DATE_PATTERN.exec(value) : null;\n    if (!match) {\n        return null;\n    }\n    const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];\n    // guard clause: Date.UTC \"arregla\" el 31 de febrero pasándolo a marzo; si el día cambió, la fecha no existe\n    const calendarDate = new Date(Date.UTC(year, month - 1, day));\n    if (calendarDate.getUTCMonth() !== month - 1 || calendarDate.getUTCDate() !== day) {\n        return null;\n    }\n    return {year, month, day};\n}\n"],"names":[],"mappings":"AAeA,MAAM,qBAAqB;AAQpB,SAAS,aAAa,OAAO;AAChC,MAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,IAAI;AACvD,WAAO;AAAA,EACX;AACA,QAAM,UAAU,IAAI,KAAK,KAAK;AAC9B,SAAO,OAAO,MAAM,QAAQ,QAAO,CAAE,IAAI,OAAO;AACpD;AAQO,SAAS,eAAe,OAAO;AAClC,QAAM,QAAQ,OAAO,UAAU,WAAW,mBAAmB,KAAK,KAAK,IAAI;AAC3E,MAAI,CAAC,OAAO;AACR,WAAO;AAAA,EACX;AACA,QAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,GAAG,OAAO,MAAM,CAAC,CAAC,CAAC;AAEhF,QAAM,eAAe,IAAI,KAAK,KAAK,IAAI,MAAM,QAAQ,GAAG,GAAG,CAAC;AAC5D,MAAI,aAAa,YAAW,MAAO,QAAQ,KAAK,aAAa,WAAU,MAAO,KAAK;AAC/E,WAAO;AAAA,EACX;AACA,SAAO,EAAC,MAAM,OAAO,IAAG;AAC5B;"}

package/dist/dictionaries/dictionaries.js

@@ -0,0 +1,48 @@
+import { createLogger } from "../observability/logger.js";
+const log = createLogger("dictionaries");
+const NAMESPACE = "dictionaries";
+const UNKNOWN_ENTRY = Object.freeze({
+  value: null,
+  labelKey: `${NAMESPACE}:unknown.label`,
+  tooltipKey: `${NAMESPACE}:unknown.tooltip`,
+  color: "default",
+  isKnown: false
+});
+function dictionaryEntryOf(value, keyPrefix, color, { hasShortLabel = false } = {}) {
+  return Object.freeze({
+    value,
+    labelKey: `${NAMESPACE}:${keyPrefix}.label`,
+    tooltipKey: `${NAMESPACE}:${keyPrefix}.tooltip`,
+    ...hasShortLabel ? { shortLabelKey: `${NAMESPACE}:${keyPrefix}.shortLabel` } : {},
+    color,
+    isKnown: true
+  });
+}
+function lookup(dictionary, value) {
+  if (value !== null && value !== void 0 && Object.hasOwn(dictionary, value)) {
+    return dictionary[value];
+  }
+  if (value !== null && value !== void 0) {
+    log.warn("valor sin entrada en el diccionario", { value });
+  }
+  return { ...UNKNOWN_ENTRY, value: value ?? null };
+}
+function labelOf(dictionaryEntry, translate) {
+  if (dictionaryEntry.isKnown || dictionaryEntry.value === null) {
+    return translate(dictionaryEntry.labelKey);
+  }
+  return dictionaryEntry.value;
+}
+function shortLabelOf(dictionaryEntry, translate) {
+  if (dictionaryEntry.isKnown && dictionaryEntry.shortLabelKey) {
+    return translate(dictionaryEntry.shortLabelKey);
+  }
+  return labelOf(dictionaryEntry, translate);
+}
+export {
+  dictionaryEntryOf,
+  labelOf,
+  lookup,
+  shortLabelOf
+};
+//# sourceMappingURL=dictionaries.js.map

package/dist/dictionaries/dictionaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaries.js","sources":["../../src/dictionaries/dictionaries.js"],"sourcesContent":["// Diccionarios de valores cerrados que llegan del API → etiqueta, tooltip y color del chip (StatusChip, DictionaryText).\n//\n// El paquete trae el mecanismo; los diccionarios los arma cada proyecto con dictionaryEntryOf:\n//\n//   export const ORDER_STATUS = Object.freeze({\n//       pending: dictionaryEntryOf('pending', 'orderStatus.pending', 'warning'),\n//       paid: dictionaryEntryOf('paid', 'orderStatus.paid', 'success'),\n//   });\n//\n// Forma de cada entrada: {value, labelKey, tooltipKey, color, isKnown} y, solo en algunas, shortLabelKey\n//   - value: el código del API tal cual.\n//   - labelKey / tooltipKey: llaves de texto del namespace \"dictionaries\" (los textos los pone el proyecto con `texts` o\n//     `translate` de ToolkitProvider). El texto NUNCA va aquí: así cambia de idioma sin tocar el diccionario.\n//   - shortLabelKey: palabra corta para una columna angosta («Rechazada» por «Rechazada por estructura»). Solo la traen\n//     las entradas cuyo nombre completo no cabe; quien la pinta deja el nombre completo en el tooltip (StatusChip, short).\n//   - color: color de paleta de MUI (success, warning, error, info, default).\n//   - isKnown: false solo en la entrada \"unknown\"; sirve para pintar el código crudo cuando no hay texto (p. ej. un\n//     estatus nuevo que el backend empezó a mandar).\n//\n// Se congelan con Object.freeze para que nadie los mute por accidente desde una pantalla.\n// Un valor que el API mande y no esté en el diccionario no truena la pantalla: lookup regresa la entrada \"unknown\" y lo\n// anota en el log para agregarlo.\n//\n// Funciones puras, no renderizan: function (regla de la casa).\nimport {createLogger} from '@/observability/logger.js';\n\nconst log = createLogger('dictionaries');\n\nconst NAMESPACE = 'dictionaries';\n\nconst UNKNOWN_ENTRY = Object.freeze({\n    value: null,\n    labelKey: `${NAMESPACE}:unknown.label`,\n    tooltipKey: `${NAMESPACE}:unknown.tooltip`,\n    color: 'default',\n    isKnown: false,\n});\n\n/**\n * Una entrada de diccionario, congelada.\n *\n * @param {string} value el código del API\n * @param {string} keyPrefix dónde viven sus textos dentro del namespace dictionaries ('orderStatus.paid' → orderStatus.paid.label)\n * @param {string} color color de paleta de MUI\n * @param {{hasShortLabel?: boolean}} [options] hasShortLabel: trae palabra corta (keyPrefix.shortLabel)\n * @returns {{value: string, labelKey: string, tooltipKey: string, shortLabelKey?: string, color: string, isKnown: boolean}}\n */\nexport function dictionaryEntryOf(value, keyPrefix, color, {hasShortLabel = false} = {}) {\n    return Object.freeze({\n        value,\n        labelKey: `${NAMESPACE}:${keyPrefix}.label`,\n        tooltipKey: `${NAMESPACE}:${keyPrefix}.tooltip`,\n        ...(hasShortLabel ? {shortLabelKey: `${NAMESPACE}:${keyPrefix}.shortLabel`} : {}),\n        color,\n        isKnown: true,\n    });\n}\n\n/**\n * La entrada del diccionario para un valor del API.\n *\n * @param {Record<string, object>} dictionary p. ej. ORDER_STATUS\n * @param {string|null|undefined} value código del API\n * @returns {{value: string|null, labelKey: string, tooltipKey: string, color: string, isKnown: boolean}}\n */\nexport function lookup(dictionary, value) {\n    if (value !== null && value !== undefined && Object.hasOwn(dictionary, value)) {\n        return dictionary[value];\n    }\n    if (value !== null && value !== undefined) {\n        log.warn('valor sin entrada en el diccionario', {value});\n    }\n    return {...UNKNOWN_ENTRY, value: value ?? null};\n}\n\n/**\n * Texto que se pinta para una entrada: su etiqueta traducida o, si el valor no está en el diccionario, el código\n * crudo. Un estatus nuevo se lee con su código y no como \"Sin estatus\".\n *\n * @param {{value: string|null, labelKey: string, isKnown: boolean}} dictionaryEntry lo que regresa lookup\n * @param {(key: string) => string} translate el t de useToolkitTranslation\n * @returns {string}\n */\nexport function labelOf(dictionaryEntry, translate) {\n    if (dictionaryEntry.isKnown || dictionaryEntry.value === null) {\n        return translate(dictionaryEntry.labelKey);\n    }\n    return dictionaryEntry.value;\n}\n\n/**\n * La palabra corta de una entrada, para una columna angosta. Una entrada sin palabra corta regresa su etiqueta de siempre.\n *\n * @param {object} dictionaryEntry entrada del diccionario (lookup)\n * @param {Function} translate traductor\n * @returns {string}\n */\nexport function shortLabelOf(dictionaryEntry, translate) {\n    if (dictionaryEntry.isKnown && dictionaryEntry.shortLabelKey) {\n        return translate(dictionaryEntry.shortLabelKey);\n    }\n    return labelOf(dictionaryEntry, translate);\n}\n"],"names":[],"mappings":";AA0BA,MAAM,MAAM,aAAa,cAAc;AAEvC,MAAM,YAAY;AAElB,MAAM,gBAAgB,OAAO,OAAO;AAAA,EAChC,OAAO;AAAA,EACP,UAAU,GAAG,SAAS;AAAA,EACtB,YAAY,GAAG,SAAS;AAAA,EACxB,OAAO;AAAA,EACP,SAAS;AACb,CAAC;AAWM,SAAS,kBAAkB,OAAO,WAAW,OAAO,EAAC,gBAAgB,MAAK,IAAI,IAAI;AACrF,SAAO,OAAO,OAAO;AAAA,IACjB;AAAA,IACA,UAAU,GAAG,SAAS,IAAI,SAAS;AAAA,IACnC,YAAY,GAAG,SAAS,IAAI,SAAS;AAAA,IACrC,GAAI,gBAAgB,EAAC,eAAe,GAAG,SAAS,IAAI,SAAS,cAAa,IAAI;IAC9E;AAAA,IACA,SAAS;AAAA,EACjB,CAAK;AACL;AASO,SAAS,OAAO,YAAY,OAAO;AACtC,MAAI,UAAU,QAAQ,UAAU,UAAa,OAAO,OAAO,YAAY,KAAK,GAAG;AAC3E,WAAO,WAAW,KAAK;AAAA,EAC3B;AACA,MAAI,UAAU,QAAQ,UAAU,QAAW;AACvC,QAAI,KAAK,uCAAuC,EAAC,MAAK,CAAC;AAAA,EAC3D;AACA,SAAO,EAAC,GAAG,eAAe,OAAO,SAAS,KAAI;AAClD;AAUO,SAAS,QAAQ,iBAAiB,WAAW;AAChD,MAAI,gBAAgB,WAAW,gBAAgB,UAAU,MAAM;AAC3D,WAAO,UAAU,gBAAgB,QAAQ;AAAA,EAC7C;AACA,SAAO,gBAAgB;AAC3B;AASO,SAAS,aAAa,iBAAiB,WAAW;AACrD,MAAI,gBAAgB,WAAW,gBAAgB,eAAe;AAC1D,WAAO,UAAU,gBAAgB,aAAa;AAAA,EAClD;AACA,SAAO,QAAQ,iBAAiB,SAAS;AAC7C;"}