@stackcraftmx/calcita 0.0.0-stage → 0.25.0

package/dist/excel/reportWorkbook.js

@@ -0,0 +1,299 @@
+const VALUE_FORMAT = Object.freeze({ count: "count", money: "money", percent: "percent" });
+const SHEET_ROW_KIND = Object.freeze({ section: "section", figures: "figures" });
+const NOT_APPLICABLE_TEXT = "—";
+const PERCENT_PER_UNIT = 100;
+const EXCEL_SIGNIFICANT_DIGITS = 15;
+const UTF8_BYTE_ORDER_MARK = "\uFEFF";
+const CSV_SEPARATOR = ",";
+const CSV_LINE_END = "\r\n";
+const EXCEL_SHEET_NAME_MAX_LENGTH = 31;
+const EXCEL_SHEET_NAME_FORBIDDEN_CHARACTERS = /[\\/?*[\]:]/g;
+const CSS_HEX_COLOR = /^#?([0-9a-f]{6})$/i;
+const EXCEL_OPAQUE_ALPHA = "FF";
+const DEFAULT_REPORT_STYLE = Object.freeze({
+  brandColor: "FF1976D2",
+  headerFontColor: "FFFFFFFF",
+  sectionFill: "FFF5F5F5",
+  totalsFill: "FFE3F2FD",
+  borderColor: "FFE0E0E0",
+  // en Datos cada sección empieza con una raya más marcada a su izquierda
+  sectionBorderColor: "FF9E9E9E",
+  secondaryFontColor: "FF757575",
+  titleFontSize: 14,
+  secondaryFontSize: 9,
+  // el encabezado alcanza para dos líneas: una columna de cifras se ensancha si su título no cabe en ellas (las letras en
+  // negritas ocupan más que la unidad de ancho de Excel, por eso el margen)
+  headerRowHeight: 30,
+  headerLineCount: 2,
+  headerWidthMargin: 4,
+  conceptColumnWidth: 36,
+  howColumnWidth: 22,
+  figureColumnWidth: 20,
+  // los conceptos van con sangría bajo el título de su sección
+  conceptIndent: 1,
+  // el concepto largo se dobla en su celda y su renglón crece: cuántas letras caben por línea en la columna (su ancho
+  // menos la sangría) y cuánto mide una línea. El alto va escrito porque no todos los programas lo calculan al abrir
+  conceptCharactersPerLine: 33,
+  lineHeightPoints: 15,
+  // el formato de Excel de cada VALUE_FORMAT; el del dinero lleva el signo de la moneda del proyecto
+  numberFormats: Object.freeze({
+    [VALUE_FORMAT.count]: "#,##0",
+    [VALUE_FORMAT.money]: '"$"#,##0.00',
+    [VALUE_FORMAT.percent]: "0%"
+  })
+});
+const EXCEL_DATA_SECTION_ROW = 1;
+const EXCEL_DATA_CONCEPT_ROW = 2;
+const EXCEL_DATA_HOW_ROW = 3;
+const EXCEL_DATA_PERIOD_COLUMN_WIDTH = 24;
+const EXCEL_DATA_CONCEPT_COLUMN_WIDTH = 20;
+const EXCEL_DATA_CONCEPT_ROW_HEIGHT = 45;
+const EXCEL_TITLE_ROW = 1;
+const EXCEL_SUBTITLE_ROW = 2;
+const EXCEL_HEADER_ROW = 4;
+function excelColorOf(cssColor) {
+  const match = CSS_HEX_COLOR.exec(cssColor.trim());
+  if (!match) {
+    throw new Error(`excelColorOf espera un color #rrggbb y recibió «${cssColor}»`);
+  }
+  return `${EXCEL_OPAQUE_ALPHA}${match[1].toUpperCase()}`;
+}
+function fileNameSlugOf(name) {
+  return name.normalize("NFD").replace(/[̀-ͯ]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+}
+function reportSheetOf({ conceptLabel, howColumnLabel, periodLabels, totalsLabel, sections, dataLabels }) {
+  const hasHowColumn = Boolean(howColumnLabel);
+  const hasTotals = Boolean(totalsLabel);
+  const periods = [...periodLabels, ...hasTotals ? [totalsLabel] : []];
+  const header = [conceptLabel, ...hasHowColumn ? [howColumnLabel] : [], ...periods];
+  const dataHeaderLabels = { section: dataLabels.section, concept: conceptLabel, period: dataLabels.period };
+  const rows = [];
+  for (const section of sections) {
+    rows.push({ kind: SHEET_ROW_KIND.section, label: section.label });
+    for (const row of section.rows) {
+      rows.push({
+        kind: SHEET_ROW_KIND.figures,
+        sectionLabel: section.label,
+        label: row.label,
+        howLabel: row.howLabel ?? "",
+        format: row.format,
+        isTotal: Boolean(row.isTotal),
+        values: row.values
+      });
+    }
+  }
+  return { header, dataHeaderLabels, periods, rows, hasHowColumn, hasTotals };
+}
+function reportDataTableOf(sheet) {
+  const concepts = sheet.rows.filter((row) => row.kind === SHEET_ROW_KIND.figures);
+  const periodRows = sheet.periods.map((period, position) => ({
+    period,
+    // el último periodo son los Totales, si el reporte los lleva
+    isTotals: sheet.hasTotals && position === sheet.periods.length - 1,
+    values: concepts.map((concept) => concept.values[position])
+  }));
+  return { concepts, periodRows };
+}
+function csvValueOf(value, format) {
+  if (value === null || value === void 0) {
+    return NOT_APPLICABLE_TEXT;
+  }
+  return format === VALUE_FORMAT.percent ? `${value}%` : String(value);
+}
+function csvFieldOf(field) {
+  return /[",\r\n]/.test(field) ? `"${field.replaceAll('"', '""')}"` : field;
+}
+function dataHeaderLinesOf(sheet, concepts) {
+  const sectionLine = [sheet.dataHeaderLabels.section, ...concepts.map((concept) => concept.sectionLabel)];
+  const conceptNames = concepts.map((concept) => concept.label);
+  if (!sheet.hasHowColumn) {
+    return [sectionLine, [sheet.dataHeaderLabels.period, ...conceptNames]];
+  }
+  return [
+    sectionLine,
+    [sheet.dataHeaderLabels.concept, ...conceptNames],
+    [sheet.dataHeaderLabels.period, ...concepts.map((concept) => concept.howLabel)]
+  ];
+}
+function reportCsvOf(sheet) {
+  const { concepts, periodRows } = reportDataTableOf(sheet);
+  const lines = dataHeaderLinesOf(sheet, concepts);
+  for (const periodRow of periodRows) {
+    lines.push([periodRow.period, ...periodRow.values.map((value, position) => csvValueOf(value, concepts[position].format))]);
+  }
+  return UTF8_BYTE_ORDER_MARK + lines.map((fields) => fields.map(csvFieldOf).join(CSV_SEPARATOR)).join(CSV_LINE_END) + CSV_LINE_END;
+}
+function excelValueOf(value, format) {
+  if (value === null || value === void 0) {
+    return NOT_APPLICABLE_TEXT;
+  }
+  if (format === VALUE_FORMAT.percent) {
+    return Number((Number(value) / PERCENT_PER_UNIT).toPrecision(EXCEL_SIGNIFICANT_DIGITS));
+  }
+  return Number(value);
+}
+function excelSheetNameOf(name) {
+  return name.replace(EXCEL_SHEET_NAME_FORBIDDEN_CHARACTERS, " ").slice(0, EXCEL_SHEET_NAME_MAX_LENGTH);
+}
+function wrapConceptOf(row, label, alignment, style) {
+  const lineCount = Math.ceil(label.length / style.conceptCharactersPerLine);
+  row.getCell(1).alignment = { ...alignment, wrapText: true, vertical: "middle" };
+  if (lineCount > 1) {
+    row.height = lineCount * style.lineHeightPoints;
+  }
+}
+function figureColumnWidthOf(headerTitle, style) {
+  return Math.max(style.figureColumnWidth, Math.ceil(headerTitle.length / style.headerLineCount) + style.headerWidthMargin);
+}
+function reportWorkbookOf(ExcelJS, sheet, { summarySheetName, dataSheetName, title, subtitle = "", style: customStyle = {} }) {
+  const style = {
+    ...DEFAULT_REPORT_STYLE,
+    ...customStyle,
+    numberFormats: { ...DEFAULT_REPORT_STYLE.numberFormats, ...customStyle.numberFormats }
+  };
+  const workbook = new ExcelJS.Workbook();
+  const leadingColumnWidths = sheet.hasHowColumn ? [style.conceptColumnWidth, style.howColumnWidth] : [style.conceptColumnWidth];
+  const worksheet = workbook.addWorksheet(excelSheetNameOf(summarySheetName), {
+    views: [{ state: "frozen", xSplit: leadingColumnWidths.length, ySplit: EXCEL_HEADER_ROW }],
+    pageSetup: { orientation: "landscape", fitToPage: true, fitToWidth: 1, fitToHeight: 0, printTitlesRow: `${EXCEL_HEADER_ROW}:${EXCEL_HEADER_ROW}` }
+  });
+  const columnCount = sheet.header.length;
+  const totalsColumnNumber = columnCount;
+  const firstFigureColumnNumber = leadingColumnWidths.length + 1;
+  const fillOf = (color) => ({ type: "pattern", pattern: "solid", fgColor: { argb: color } });
+  const thinBorder = { style: "thin", color: { argb: style.borderColor } };
+  const cellBorder = { top: thinBorder, left: thinBorder, bottom: thinBorder, right: thinBorder };
+  worksheet.columns = sheet.header.map((headerTitle, position) => ({
+    width: leadingColumnWidths[position] ?? figureColumnWidthOf(headerTitle, style)
+  }));
+  worksheet.getCell(EXCEL_TITLE_ROW, 1).value = title;
+  worksheet.getCell(EXCEL_TITLE_ROW, 1).font = { bold: true, size: style.titleFontSize, color: { argb: style.brandColor } };
+  worksheet.getCell(EXCEL_SUBTITLE_ROW, 1).value = subtitle;
+  worksheet.getCell(EXCEL_SUBTITLE_ROW, 1).font = { color: { argb: style.secondaryFontColor } };
+  const headerRow = worksheet.getRow(EXCEL_HEADER_ROW);
+  headerRow.values = sheet.header;
+  headerRow.height = style.headerRowHeight;
+  headerRow.eachCell((cell, columnNumber) => {
+    cell.font = { bold: true, color: { argb: style.headerFontColor } };
+    cell.fill = fillOf(style.brandColor);
+    cell.border = cellBorder;
+    cell.alignment = { vertical: "middle", wrapText: true, horizontal: columnNumber >= firstFigureColumnNumber ? "right" : "left" };
+  });
+  for (const row of sheet.rows) {
+    if (row.kind === SHEET_ROW_KIND.section) {
+      const sectionRow = worksheet.addRow([row.label]);
+      for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {
+        const cell = sectionRow.getCell(columnNumber);
+        cell.font = { bold: true };
+        cell.fill = fillOf(style.sectionFill);
+        cell.border = cellBorder;
+      }
+      wrapConceptOf(sectionRow, row.label, {}, style);
+      continue;
+    }
+    const figuresRow = worksheet.addRow([
+      row.label,
+      ...sheet.hasHowColumn ? [row.howLabel] : [],
+      ...row.values.map((value) => excelValueOf(value, row.format))
+    ]);
+    for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {
+      figuresRow.getCell(columnNumber).border = cellBorder;
+    }
+    figuresRow.getCell(1).font = { bold: row.isTotal };
+    wrapConceptOf(figuresRow, row.label, { indent: style.conceptIndent }, style);
+    if (sheet.hasHowColumn) {
+      figuresRow.getCell(2).font = { italic: true, size: style.secondaryFontSize, color: { argb: style.secondaryFontColor } };
+    }
+    row.values.forEach((value, position) => {
+      const cell = figuresRow.getCell(firstFigureColumnNumber + position);
+      cell.numFmt = style.numberFormats[row.format];
+      cell.alignment = { horizontal: "right" };
+      cell.font = { bold: row.isTotal };
+    });
+    if (sheet.hasTotals) {
+      const totalsCell = figuresRow.getCell(totalsColumnNumber);
+      totalsCell.font = { bold: true };
+      totalsCell.fill = fillOf(style.totalsFill);
+    }
+  }
+  addDataWorksheet(workbook, sheet, dataSheetName, { style, fillOf, cellBorder });
+  return workbook;
+}
+function addDataWorksheet(workbook, sheet, dataSheetName, { style, fillOf, cellBorder }) {
+  const { concepts, periodRows } = reportDataTableOf(sheet);
+  const headerLines = dataHeaderLinesOf(sheet, concepts);
+  const lastHeaderRow = headerLines.length;
+  const worksheet = workbook.addWorksheet(excelSheetNameOf(dataSheetName), { views: [{ state: "frozen", xSplit: 1, ySplit: lastHeaderRow }] });
+  const columnCount = concepts.length + 1;
+  const sectionBorder = { style: "medium", color: { argb: style.sectionBorderColor } };
+  const startsSectionAt = concepts.map((concept, position) => position === 0 || concept.sectionLabel !== concepts[position - 1].sectionLabel);
+  const periodColumnWidth = Math.max(
+    EXCEL_DATA_PERIOD_COLUMN_WIDTH,
+    ...periodRows.map((periodRow) => periodRow.period.length + style.headerWidthMargin)
+  );
+  worksheet.columns = [{ width: periodColumnWidth }, ...concepts.map(() => ({ width: EXCEL_DATA_CONCEPT_COLUMN_WIDTH }))];
+  headerLines.forEach((headerLine, position) => {
+    worksheet.getRow(EXCEL_DATA_SECTION_ROW + position).values = headerLine;
+  });
+  worksheet.getRow(EXCEL_DATA_CONCEPT_ROW).height = EXCEL_DATA_CONCEPT_ROW_HEIGHT;
+  for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {
+    const sectionCell = worksheet.getCell(EXCEL_DATA_SECTION_ROW, columnNumber);
+    sectionCell.font = { bold: true, color: { argb: style.headerFontColor } };
+    sectionCell.fill = fillOf(style.brandColor);
+    sectionCell.alignment = { vertical: "middle", horizontal: columnNumber === 1 ? "left" : "center" };
+    const conceptCell = worksheet.getCell(EXCEL_DATA_CONCEPT_ROW, columnNumber);
+    conceptCell.font = { bold: true };
+    conceptCell.fill = fillOf(style.sectionFill);
+    conceptCell.alignment = { vertical: "middle", wrapText: true, horizontal: columnNumber === 1 ? "left" : "right" };
+    if (!sheet.hasHowColumn) {
+      continue;
+    }
+    const howCell = worksheet.getCell(EXCEL_DATA_HOW_ROW, columnNumber);
+    howCell.font = columnNumber === 1 ? { bold: true } : { italic: true, size: style.secondaryFontSize, color: { argb: style.secondaryFontColor } };
+    howCell.alignment = { horizontal: columnNumber === 1 ? "left" : "right" };
+  }
+  for (const periodRow of periodRows) {
+    const dataRow = worksheet.addRow([periodRow.period, ...periodRow.values.map((value, position) => excelValueOf(value, concepts[position].format))]);
+    dataRow.font = { bold: periodRow.isTotals };
+    concepts.forEach((concept, position) => {
+      const cell = dataRow.getCell(position + 2);
+      cell.numFmt = style.numberFormats[concept.format];
+      cell.alignment = { horizontal: "right" };
+    });
+    if (periodRow.isTotals) {
+      dataRow.eachCell((cell) => {
+        cell.fill = fillOf(style.totalsFill);
+      });
+    }
+  }
+  for (let rowNumber = EXCEL_DATA_SECTION_ROW; rowNumber <= worksheet.rowCount; rowNumber += 1) {
+    for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {
+      const startsSection = columnNumber > 1 && startsSectionAt[columnNumber - 2];
+      worksheet.getCell(rowNumber, columnNumber).border = startsSection ? { ...cellBorder, left: sectionBorder } : cellBorder;
+    }
+  }
+  let sectionStartColumn = 2;
+  for (let position = 1; position <= concepts.length; position += 1) {
+    const sectionEnds = position === concepts.length || startsSectionAt[position];
+    if (sectionEnds) {
+      const sectionEndColumn = position + 1;
+      if (sectionEndColumn > sectionStartColumn) {
+        worksheet.mergeCells(EXCEL_DATA_SECTION_ROW, sectionStartColumn, EXCEL_DATA_SECTION_ROW, sectionEndColumn);
+      }
+      sectionStartColumn = sectionEndColumn + 1;
+    }
+  }
+  worksheet.autoFilter = { from: { row: lastHeaderRow, column: 1 }, to: { row: worksheet.rowCount, column: columnCount } };
+}
+export {
+  DEFAULT_REPORT_STYLE,
+  SHEET_ROW_KIND,
+  VALUE_FORMAT,
+  excelColorOf,
+  fileNameSlugOf,
+  reportCsvOf,
+  reportDataTableOf,
+  reportSheetOf,
+  reportWorkbookOf
+};
+//# sourceMappingURL=reportWorkbook.js.map

package/dist/excel/reportWorkbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportWorkbook.js","sources":["../../src/excel/reportWorkbook.js"],"sourcesContent":["// Un reporte de cifras por periodo como archivo: libro de Excel o CSV, armado en el navegador con lo que ya se ve en\n// pantalla (no se vuelve a contar nada).\n//\n// Primero se arma la «hoja» (reportSheetOf: encabezado y renglones ya con sus textos) y de ahí salen las dos hojas del\n// libro, así siempre dicen lo mismo. Van en dos formas, con los mismos números:\n//   A lo ancho (Resumen)  como una pantalla: un renglón por concepto y una columna por periodo, con los Totales al final\n//                         si el reporte los lleva. Para leer e imprimir.\n//   Hacia abajo (Datos)   la misma tabla volteada: un renglón por periodo y una columna por concepto. Lo que es fijo de\n//                         cada concepto (su sección, su nombre y cómo sale su total) va UNA vez arriba y no se repite en\n//                         cada renglón. Los filtros de Excel van en el último renglón del encabezado. El CSV va así.\n//\n// El Excel se arma con ExcelJS (MIT), el mismo que usa por dentro el DataGrid Premium de MUI. Pesa casi 1 MB: el paquete\n// no lo importa; quien llama lo carga solo al pedir el archivo (import dinámico) y se lo pasa a reportWorkbookOf.\n//\n// Los colores por omisión son los del tema por omisión de MUI (azul primary); cada proyecto pasa los de su tema en\n// `style` (excelColorOf convierte un color CSS #rrggbb al ARGB que pide Excel).\n//\n// Funciones puras, sin React: function (regla de la casa).\n\n/** Cómo se escribe cada cifra: conteo con miles, dinero con dos decimales o porcentaje. */\nexport const VALUE_FORMAT = Object.freeze({count: 'count', money: 'money', percent: 'percent'});\n\n/** Los dos tipos de renglón de la hoja: el título de una sección y un concepto con sus cifras. */\nexport const SHEET_ROW_KIND = Object.freeze({section: 'section', figures: 'figures'});\n\n// lo que se escribe cuando una celda no aplica: nunca un 0, que diría «no hubo»\nconst NOT_APPLICABLE_TEXT = '—';\n\n// el porcentaje llega como porcentaje (13 = 13 %); Excel lo guarda como fracción (0.13)\nconst PERCENT_PER_UNIT = 100;\n// Excel guarda 15 cifras significativas: se redondea a ellas para que no se cuele el ruido de los decimales de\n// JavaScript (5.2 / 100 = 0.052000000000000005)\nconst EXCEL_SIGNIFICANT_DIGITS = 15;\n\n// la marca que avisa a Excel que el CSV va en UTF-8: sin ella rompe los acentos y la ñ\nconst UTF8_BYTE_ORDER_MARK = '';\nconst CSV_SEPARATOR = ',';\nconst CSV_LINE_END = '\\r\\n';\n\n// Excel no acepta hojas con más de 31 letras en el nombre ni con estos signos\nconst EXCEL_SHEET_NAME_MAX_LENGTH = 31;\nconst EXCEL_SHEET_NAME_FORBIDDEN_CHARACTERS = /[\\\\/?*[\\]:]/g;\n\n// un color CSS de seis cifras (#1976d2) y la opacidad completa que Excel pone adelante (FF)\nconst CSS_HEX_COLOR = /^#?([0-9a-f]{6})$/i;\nconst EXCEL_OPAQUE_ALPHA = 'FF';\n\n/**\n * Cómo se ve el Excel, como un reporte: título arriba, encabezado del color principal con letra blanca, secciones con su\n * fondo, bordes delgados en toda la tabla y los Totales con su fondo. Los colores van en ARGB, como los pide Excel; por\n * omisión, los del tema por omisión de MUI (primary #1976d2, blue[50], grey).\n */\nexport const DEFAULT_REPORT_STYLE = Object.freeze({\n    brandColor: 'FF1976D2',\n    headerFontColor: 'FFFFFFFF',\n    sectionFill: 'FFF5F5F5',\n    totalsFill: 'FFE3F2FD',\n    borderColor: 'FFE0E0E0',\n    // en Datos cada sección empieza con una raya más marcada a su izquierda\n    sectionBorderColor: 'FF9E9E9E',\n    secondaryFontColor: 'FF757575',\n    titleFontSize: 14,\n    secondaryFontSize: 9,\n    // el encabezado alcanza para dos líneas: una columna de cifras se ensancha si su título no cabe en ellas (las letras en\n    // negritas ocupan más que la unidad de ancho de Excel, por eso el margen)\n    headerRowHeight: 30,\n    headerLineCount: 2,\n    headerWidthMargin: 4,\n    conceptColumnWidth: 36,\n    howColumnWidth: 22,\n    figureColumnWidth: 20,\n    // los conceptos van con sangría bajo el título de su sección\n    conceptIndent: 1,\n    // el concepto largo se dobla en su celda y su renglón crece: cuántas letras caben por línea en la columna (su ancho\n    // menos la sangría) y cuánto mide una línea. El alto va escrito porque no todos los programas lo calculan al abrir\n    conceptCharactersPerLine: 33,\n    lineHeightPoints: 15,\n    // el formato de Excel de cada VALUE_FORMAT; el del dinero lleva el signo de la moneda del proyecto\n    numberFormats: Object.freeze({\n        [VALUE_FORMAT.count]: '#,##0',\n        [VALUE_FORMAT.money]: '\"$\"#,##0.00',\n        [VALUE_FORMAT.percent]: '0%',\n    }),\n});\n\n// la hoja de Datos (hacia abajo): sin título; los renglones de encabezado (sección, concepto y, si el reporte la lleva,\n// cómo sale) y luego un renglón por periodo. La primera columna dice el periodo; las demás, un concepto cada una\nconst EXCEL_DATA_SECTION_ROW = 1;\nconst EXCEL_DATA_CONCEPT_ROW = 2;\nconst EXCEL_DATA_HOW_ROW = 3;\nconst EXCEL_DATA_PERIOD_COLUMN_WIDTH = 24;\nconst EXCEL_DATA_CONCEPT_COLUMN_WIDTH = 20;\n// el nombre del concepto se dobla en su celda: el renglón alcanza para tres líneas\nconst EXCEL_DATA_CONCEPT_ROW_HEIGHT = 45;\n\n// dónde va cada cosa en Resumen: el título y el subtítulo arriba, un renglón en blanco y luego la tabla\nconst EXCEL_TITLE_ROW = 1;\nconst EXCEL_SUBTITLE_ROW = 2;\nconst EXCEL_HEADER_ROW = 4;\n\n/**\n * Un color CSS de seis cifras (#017f31) como lo pide Excel (FF017F31). Sirve para pasar el color del tema de MUI a `style`.\n *\n * @param {string} cssColor #rrggbb\n * @returns {string} ARGB\n */\nexport function excelColorOf(cssColor) {\n    const match = CSS_HEX_COLOR.exec(cssColor.trim());\n    if (!match) {\n        throw new Error(`excelColorOf espera un color #rrggbb y recibió «${cssColor}»`);\n    }\n\n    return `${EXCEL_OPAQUE_ALPHA}${match[1].toUpperCase()}`;\n}\n\n/**\n * Un nombre como pedazo del nombre de un archivo: sin acentos, en minúsculas y con guiones («Plan Básico» →\n * plan-basico).\n *\n * @param {string} name\n * @returns {string}\n */\nexport function fileNameSlugOf(name) {\n    return name.normalize('NFD').replace(/[̀-ͯ]/g, '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '');\n}\n\n/**\n * La hoja del reporte: el encabezado y los renglones con sus textos, en el orden de la pantalla.\n *\n * @param {object} report\n * @param {string} report.conceptLabel título de la primera columna («Concepto»)\n * @param {string} [report.howColumnLabel] título de la columna que explica cómo sale cada total («Cómo salen los\n *     totales»); sin él no va esa columna\n * @param {string[]} report.periodLabels un título por periodo, en orden\n * @param {string} [report.totalsLabel] título de la columna de los Totales; sin él no va (y los renglones no traen su\n *     total)\n * @param {Object[]} report.sections las secciones en orden, cada una con sus renglones\n * @param {string} report.sections[].label\n * @param {Array<{label: string, howLabel?: string, format: string, isTotal?: boolean, values: Array<number|string|null>}>} report.sections[].rows\n *     values: una cifra por periodo y, si hay totalsLabel, al final la del total\n * @param {{section: string, period: string}} report.dataLabels lo que dice la primera columna de los Datos\n * @returns {{header: string[], dataHeaderLabels: {section: string, concept: string, period: string}, periods: string[], rows: Array<object>, hasHowColumn: boolean, hasTotals: boolean}}\n */\nexport function reportSheetOf({conceptLabel, howColumnLabel, periodLabels, totalsLabel, sections, dataLabels}) {\n    const hasHowColumn = Boolean(howColumnLabel);\n    const hasTotals = Boolean(totalsLabel);\n    // los periodos de cada concepto: cada periodo y al final los Totales\n    const periods = [...periodLabels, ...(hasTotals ? [totalsLabel] : [])];\n    const header = [conceptLabel, ...(hasHowColumn ? [howColumnLabel] : []), ...periods];\n    const dataHeaderLabels = {section: dataLabels.section, concept: conceptLabel, period: dataLabels.period};\n    const rows = [];\n\n    for (const section of sections) {\n        rows.push({kind: SHEET_ROW_KIND.section, label: section.label});\n\n        for (const row of section.rows) {\n            rows.push({\n                kind: SHEET_ROW_KIND.figures,\n                sectionLabel: section.label,\n                label: row.label,\n                howLabel: row.howLabel ?? '',\n                format: row.format,\n                isTotal: Boolean(row.isTotal),\n                values: row.values,\n            });\n        }\n    }\n\n    return {header, dataHeaderLabels, periods, rows, hasHowColumn, hasTotals};\n}\n\n/**\n * La tabla volteada de los Datos: un renglón por periodo y una columna por concepto.\n *\n * @param {{periods: string[], rows: Array<object>, hasTotals: boolean}} sheet de reportSheetOf\n * @returns {{concepts: Array<object>, periodRows: Array<{period: string, isTotals: boolean, values: Array<number|string|null>}>}}\n *          concepts: los renglones de cifras de la hoja, uno por columna (con su sección, nombre, cómo sale y formato)\n */\nexport function reportDataTableOf(sheet) {\n    const concepts = sheet.rows.filter((row) => row.kind === SHEET_ROW_KIND.figures);\n    const periodRows = sheet.periods.map((period, position) => ({\n        period,\n        // el último periodo son los Totales, si el reporte los lleva\n        isTotals: sheet.hasTotals && position === sheet.periods.length - 1,\n        values: concepts.map((concept) => concept.values[position]),\n    }));\n\n    return {concepts, periodRows};\n}\n\n/**\n * Una cifra como texto del CSV: sin separador de miles, para que Excel la lea como número.\n *\n * @param {number|string|null} value\n * @param {string} format VALUE_FORMAT\n * @returns {string}\n */\nfunction csvValueOf(value, format) {\n    if (value === null || value === undefined) {\n        return NOT_APPLICABLE_TEXT;\n    }\n\n    return format === VALUE_FORMAT.percent ? `${value}%` : String(value);\n}\n\n/**\n * Un campo del CSV entre comillas cuando lo necesita (una coma, unas comillas o un salto de renglón adentro).\n *\n * @param {string} field\n * @returns {string}\n */\nfunction csvFieldOf(field) {\n    return /[\",\\r\\n]/.test(field) ? `\"${field.replaceAll('\"', '\"\"')}\"` : field;\n}\n\n/**\n * Los renglones de encabezado de los Datos y del CSV: la sección y el concepto de cada columna y, si el reporte la\n * lleva, cómo sale. El primer campo dice qué es cada renglón; el del último encabeza la columna de los periodos (ahí van\n * los filtros de Excel), por eso dice «Periodo».\n *\n * @param {object} sheet de reportSheetOf\n * @param {Array<object>} concepts los conceptos de reportDataTableOf\n * @returns {string[][]}\n */\nfunction dataHeaderLinesOf(sheet, concepts) {\n    const sectionLine = [sheet.dataHeaderLabels.section, ...concepts.map((concept) => concept.sectionLabel)];\n    const conceptNames = concepts.map((concept) => concept.label);\n\n    // sin la columna de cómo sale, el renglón del concepto es el último del encabezado\n    if (!sheet.hasHowColumn) {\n        return [sectionLine, [sheet.dataHeaderLabels.period, ...conceptNames]];\n    }\n\n    return [\n        sectionLine,\n        [sheet.dataHeaderLabels.concept, ...conceptNames],\n        [sheet.dataHeaderLabels.period, ...concepts.map((concept) => concept.howLabel)],\n    ];\n}\n\n/**\n * El CSV de la hoja, igual que los Datos: sus renglones de encabezado y un renglón por periodo, con la marca de UTF-8 al\n * principio. La sección va en cada columna de su concepto: el CSV no une celdas.\n *\n * @param {object} sheet de reportSheetOf\n * @returns {string}\n */\nexport function reportCsvOf(sheet) {\n    const {concepts, periodRows} = reportDataTableOf(sheet);\n    const lines = dataHeaderLinesOf(sheet, concepts);\n\n    for (const periodRow of periodRows) {\n        lines.push([periodRow.period, ...periodRow.values.map((value, position) => csvValueOf(value, concepts[position].format))]);\n    }\n\n    return UTF8_BYTE_ORDER_MARK + lines.map((fields) => fields.map(csvFieldOf).join(CSV_SEPARATOR)).join(CSV_LINE_END) + CSV_LINE_END;\n}\n\n/**\n * Una cifra como la guarda Excel: número (el porcentaje como fracción) o el texto de «no aplica».\n *\n * @param {number|string|null} value\n * @param {string} format VALUE_FORMAT\n * @returns {number|string}\n */\nfunction excelValueOf(value, format) {\n    if (value === null || value === undefined) {\n        return NOT_APPLICABLE_TEXT;\n    }\n\n    if (format === VALUE_FORMAT.percent) {\n        return Number((Number(value) / PERCENT_PER_UNIT).toPrecision(EXCEL_SIGNIFICANT_DIGITS));\n    }\n\n    return Number(value);\n}\n\n/**\n * El nombre de la hoja de Excel: sin los signos que Excel no acepta y de 31 letras a lo más.\n *\n * @param {string} name\n * @returns {string}\n */\nfunction excelSheetNameOf(name) {\n    return name.replace(EXCEL_SHEET_NAME_FORBIDDEN_CHARACTERS, ' ').slice(0, EXCEL_SHEET_NAME_MAX_LENGTH);\n}\n\n/**\n * Dobla el concepto en su celda y le da a su renglón el alto de las líneas que ocupa.\n *\n * @param {object} row el renglón de ExcelJS\n * @param {string} label el concepto o el título de la sección\n * @param {object} alignment lo demás de su alineación (la sangría del concepto)\n * @param {object} style el estilo del reporte\n * @returns {void}\n */\nfunction wrapConceptOf(row, label, alignment, style) {\n    const lineCount = Math.ceil(label.length / style.conceptCharactersPerLine);\n    row.getCell(1).alignment = {...alignment, wrapText: true, vertical: 'middle'};\n\n    // con una sola línea se queda el alto de siempre\n    if (lineCount > 1) {\n        row.height = lineCount * style.lineHeightPoints;\n    }\n}\n\n/**\n * El ancho de una columna de cifras: el de siempre, o más si su título no cabe en las líneas del encabezado.\n *\n * @param {string} headerTitle el título de la columna\n * @param {object} style el estilo del reporte\n * @returns {number}\n */\nfunction figureColumnWidthOf(headerTitle, style) {\n    return Math.max(style.figureColumnWidth, Math.ceil(headerTitle.length / style.headerLineCount) + style.headerWidthMargin);\n}\n\n/**\n * El libro de Excel con sus dos hojas:\n *   Resumen  a lo ancho, con formato de reporte: el título, el encabezado del color principal, las secciones con su\n *            fondo, cada cifra con su formato (conteo, dinero, porcentaje), bordes, los Totales con su fondo y Concepto\n *            (y Cómo sale, si va) y el encabezado fijos. Se imprime acostado y ajustado al ancho, con el encabezado en\n *            cada hoja.\n *   Datos    hacia abajo, con los filtros de Excel en el encabezado (ahí sí sirven: por sección, concepto o periodo).\n *\n * @param {object} ExcelJS el paquete exceljs ya cargado\n * @param {object} sheet de reportSheetOf\n * @param {{summarySheetName: string, dataSheetName: string, title: string, subtitle?: string, style?: object}} texts\n *        los nombres de las dos hojas, lo que va arriba del Resumen y, si se quiere, lo que cambia de DEFAULT_REPORT_STYLE\n * @returns {{xlsx: {writeBuffer: () => Promise<ArrayBuffer>}} & Record<string, any>} el libro (ExcelJS.Workbook); se escribe\n *     con workbook.xlsx.writeBuffer(). Tipo propio y no el de ExcelJS: el paquete no depende de sus tipos\n */\nexport function reportWorkbookOf(ExcelJS, sheet, {summarySheetName, dataSheetName, title, subtitle = '', style: customStyle = {}}) {\n    const style = {\n        ...DEFAULT_REPORT_STYLE,\n        ...customStyle,\n        numberFormats: {...DEFAULT_REPORT_STYLE.numberFormats, ...customStyle.numberFormats},\n    };\n    const workbook = new ExcelJS.Workbook();\n    // las columnas antes de las cifras, que se quedan fijas al deslizar: Concepto y, si el reporte la lleva, cómo sale\n    const leadingColumnWidths = sheet.hasHowColumn ? [style.conceptColumnWidth, style.howColumnWidth] : [style.conceptColumnWidth];\n    const worksheet = workbook.addWorksheet(excelSheetNameOf(summarySheetName), {\n        views: [{state: 'frozen', xSplit: leadingColumnWidths.length, ySplit: EXCEL_HEADER_ROW}],\n        pageSetup: {orientation: 'landscape', fitToPage: true, fitToWidth: 1, fitToHeight: 0, printTitlesRow: `${EXCEL_HEADER_ROW}:${EXCEL_HEADER_ROW}`},\n    });\n    const columnCount = sheet.header.length;\n    const totalsColumnNumber = columnCount;\n    const firstFigureColumnNumber = leadingColumnWidths.length + 1;\n    const fillOf = (color) => ({type: 'pattern', pattern: 'solid', fgColor: {argb: color}});\n    const thinBorder = {style: 'thin', color: {argb: style.borderColor}};\n    const cellBorder = {top: thinBorder, left: thinBorder, bottom: thinBorder, right: thinBorder};\n\n    worksheet.columns = sheet.header.map((headerTitle, position) => ({\n        width: leadingColumnWidths[position] ?? figureColumnWidthOf(headerTitle, style),\n    }));\n\n    // arriba: el título y el subtítulo\n    worksheet.getCell(EXCEL_TITLE_ROW, 1).value = title;\n    worksheet.getCell(EXCEL_TITLE_ROW, 1).font = {bold: true, size: style.titleFontSize, color: {argb: style.brandColor}};\n    worksheet.getCell(EXCEL_SUBTITLE_ROW, 1).value = subtitle;\n    worksheet.getCell(EXCEL_SUBTITLE_ROW, 1).font = {color: {argb: style.secondaryFontColor}};\n\n    // el encabezado: el color principal con letra blanca; las cifras alineadas a la derecha\n    const headerRow = worksheet.getRow(EXCEL_HEADER_ROW);\n    headerRow.values = sheet.header;\n    headerRow.height = style.headerRowHeight;\n    headerRow.eachCell((cell, columnNumber) => {\n        cell.font = {bold: true, color: {argb: style.headerFontColor}};\n        cell.fill = fillOf(style.brandColor);\n        cell.border = cellBorder;\n        cell.alignment = {vertical: 'middle', wrapText: true, horizontal: columnNumber >= firstFigureColumnNumber ? 'right' : 'left'};\n    });\n\n    for (const row of sheet.rows) {\n        // el título de la sección, con su fondo a todo lo ancho\n        if (row.kind === SHEET_ROW_KIND.section) {\n            const sectionRow = worksheet.addRow([row.label]);\n            for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {\n                const cell = sectionRow.getCell(columnNumber);\n                cell.font = {bold: true};\n                cell.fill = fillOf(style.sectionFill);\n                cell.border = cellBorder;\n            }\n            wrapConceptOf(sectionRow, row.label, {}, style);\n            continue;\n        }\n\n        const figuresRow = worksheet.addRow([\n            row.label,\n            ...(sheet.hasHowColumn ? [row.howLabel] : []),\n            ...row.values.map((value) => excelValueOf(value, row.format)),\n        ]);\n        for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {\n            figuresRow.getCell(columnNumber).border = cellBorder;\n        }\n\n        figuresRow.getCell(1).font = {bold: row.isTotal};\n        wrapConceptOf(figuresRow, row.label, {indent: style.conceptIndent}, style);\n        // cómo sale el total: más chico y en gris, para que no compita con las cifras\n        if (sheet.hasHowColumn) {\n            figuresRow.getCell(2).font = {italic: true, size: style.secondaryFontSize, color: {argb: style.secondaryFontColor}};\n        }\n\n        row.values.forEach((value, position) => {\n            const cell = figuresRow.getCell(firstFigureColumnNumber + position);\n            cell.numFmt = style.numberFormats[row.format];\n            cell.alignment = {horizontal: 'right'};\n            cell.font = {bold: row.isTotal};\n        });\n\n        // la columna de los Totales, con su fondo y en negritas (si el reporte la lleva)\n        if (sheet.hasTotals) {\n            const totalsCell = figuresRow.getCell(totalsColumnNumber);\n            totalsCell.font = {bold: true};\n            totalsCell.fill = fillOf(style.totalsFill);\n        }\n    }\n\n    addDataWorksheet(workbook, sheet, dataSheetName, {style, fillOf, cellBorder});\n\n    return workbook;\n}\n\n/**\n * La hoja de Datos: la tabla volteada, un renglón por periodo y una columna por concepto. Arriba, lo fijo de cada\n * concepto: su sección (una sola celda a lo ancho de sus conceptos, del color principal), su nombre y, si el reporte la\n * lleva, cómo sale; abajo, cada periodo con su valor en el formato de su concepto, y el renglón de los Totales con su\n * fondo y en negritas como en el Resumen. Cada sección empieza con una raya más marcada; la columna del periodo y el\n * encabezado quedan fijos, y los filtros de Excel van en el último renglón del encabezado.\n *\n * @param {object} workbook el libro de ExcelJS\n * @param {object} sheet de reportSheetOf\n * @param {string} dataSheetName el nombre de la hoja\n * @param {{style: object, fillOf: Function, cellBorder: object}} look el estilo, el relleno y el borde del Resumen\n * @returns {void}\n */\nfunction addDataWorksheet(workbook, sheet, dataSheetName, {style, fillOf, cellBorder}) {\n    const {concepts, periodRows} = reportDataTableOf(sheet);\n    const headerLines = dataHeaderLinesOf(sheet, concepts);\n    const lastHeaderRow = headerLines.length;\n    const worksheet = workbook.addWorksheet(excelSheetNameOf(dataSheetName), {views: [{state: 'frozen', xSplit: 1, ySplit: lastHeaderRow}]});\n    const columnCount = concepts.length + 1;\n    const sectionBorder = {style: 'medium', color: {argb: style.sectionBorderColor}};\n    // por concepto, si con él empieza una sección (su columna en la hoja es su lugar + 2: la 1 es el periodo)\n    const startsSectionAt = concepts.map((concept, position) => position === 0 || concept.sectionLabel !== concepts[position - 1].sectionLabel);\n    // la columna del periodo se ensancha si un periodo no cabe\n    const periodColumnWidth = Math.max(\n        EXCEL_DATA_PERIOD_COLUMN_WIDTH,\n        ...periodRows.map((periodRow) => periodRow.period.length + style.headerWidthMargin),\n    );\n\n    worksheet.columns = [{width: periodColumnWidth}, ...concepts.map(() => ({width: EXCEL_DATA_CONCEPT_COLUMN_WIDTH}))];\n\n    headerLines.forEach((headerLine, position) => {\n        worksheet.getRow(EXCEL_DATA_SECTION_ROW + position).values = headerLine;\n    });\n    worksheet.getRow(EXCEL_DATA_CONCEPT_ROW).height = EXCEL_DATA_CONCEPT_ROW_HEIGHT;\n\n    for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {\n        const sectionCell = worksheet.getCell(EXCEL_DATA_SECTION_ROW, columnNumber);\n        sectionCell.font = {bold: true, color: {argb: style.headerFontColor}};\n        sectionCell.fill = fillOf(style.brandColor);\n        sectionCell.alignment = {vertical: 'middle', horizontal: columnNumber === 1 ? 'left' : 'center'};\n\n        const conceptCell = worksheet.getCell(EXCEL_DATA_CONCEPT_ROW, columnNumber);\n        conceptCell.font = {bold: true};\n        conceptCell.fill = fillOf(style.sectionFill);\n        conceptCell.alignment = {vertical: 'middle', wrapText: true, horizontal: columnNumber === 1 ? 'left' : 'right'};\n\n        // sin la columna de cómo sale no hay su renglón\n        if (!sheet.hasHowColumn) {\n            continue;\n        }\n\n        const howCell = worksheet.getCell(EXCEL_DATA_HOW_ROW, columnNumber);\n        howCell.font = columnNumber === 1\n            ? {bold: true}\n            : {italic: true, size: style.secondaryFontSize, color: {argb: style.secondaryFontColor}};\n        howCell.alignment = {horizontal: columnNumber === 1 ? 'left' : 'right'};\n    }\n\n    // un renglón por periodo, cada valor con el formato de su concepto; el de los Totales con su fondo y en negritas\n    for (const periodRow of periodRows) {\n        const dataRow = worksheet.addRow([periodRow.period, ...periodRow.values.map((value, position) => excelValueOf(value, concepts[position].format))]);\n        dataRow.font = {bold: periodRow.isTotals};\n\n        concepts.forEach((concept, position) => {\n            const cell = dataRow.getCell(position + 2);\n            cell.numFmt = style.numberFormats[concept.format];\n            cell.alignment = {horizontal: 'right'};\n        });\n\n        if (periodRow.isTotals) {\n            dataRow.eachCell((cell) => {\n                cell.fill = fillOf(style.totalsFill);\n            });\n        }\n    }\n\n    // bordes en toda la tabla, con la raya más marcada donde empieza cada sección (y a la derecha del periodo)\n    for (let rowNumber = EXCEL_DATA_SECTION_ROW; rowNumber <= worksheet.rowCount; rowNumber += 1) {\n        for (let columnNumber = 1; columnNumber <= columnCount; columnNumber += 1) {\n            const startsSection = columnNumber > 1 && startsSectionAt[columnNumber - 2];\n            worksheet.getCell(rowNumber, columnNumber).border = startsSection ? {...cellBorder, left: sectionBorder} : cellBorder;\n        }\n    }\n\n    // la sección va una sola vez a lo ancho de sus conceptos (es encabezado: unirla no estorba a los filtros, que van abajo)\n    let sectionStartColumn = 2;\n    for (let position = 1; position <= concepts.length; position += 1) {\n        const sectionEnds = position === concepts.length || startsSectionAt[position];\n        if (sectionEnds) {\n            const sectionEndColumn = position + 1;\n            if (sectionEndColumn > sectionStartColumn) {\n                worksheet.mergeCells(EXCEL_DATA_SECTION_ROW, sectionStartColumn, EXCEL_DATA_SECTION_ROW, sectionEndColumn);\n            }\n            sectionStartColumn = sectionEndColumn + 1;\n        }\n    }\n\n    // los filtros de Excel en el último renglón del encabezado (la flechita de cada columna para buscar y filtrar)\n    worksheet.autoFilter = {from: {row: lastHeaderRow, column: 1}, to: {row: worksheet.rowCount, column: columnCount}};\n}\n"],"names":[],"mappings":"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"}

package/dist/excel.js

@@ -0,0 +1,13 @@
+import { DEFAULT_REPORT_STYLE, SHEET_ROW_KIND, VALUE_FORMAT, excelColorOf, fileNameSlugOf, reportCsvOf, reportDataTableOf, reportSheetOf, reportWorkbookOf } from "./excel/reportWorkbook.js";
+export {
+  DEFAULT_REPORT_STYLE,
+  SHEET_ROW_KIND,
+  VALUE_FORMAT,
+  excelColorOf,
+  fileNameSlugOf,
+  reportCsvOf,
+  reportDataTableOf,
+  reportSheetOf,
+  reportWorkbookOf
+};
+//# sourceMappingURL=excel.js.map

package/dist/excel.js.map

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

package/dist/feedback/ConfirmDialog.js

@@ -0,0 +1,73 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useId } from "react";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import Alert from "@mui/material/Alert";
+import Button from "@mui/material/Button";
+import CircularProgress from "@mui/material/CircularProgress";
+import Dialog from "@mui/material/Dialog";
+import DialogActions from "@mui/material/DialogActions";
+import DialogContent from "@mui/material/DialogContent";
+import DialogContentText from "@mui/material/DialogContentText";
+import DialogTitle from "@mui/material/DialogTitle";
+function ConfirmDialog({
+  open,
+  title,
+  description,
+  confirmLabel,
+  cancelLabel,
+  tone = "primary",
+  isPending = false,
+  isConfirmDisabled = false,
+  errorMessage = null,
+  onConfirm,
+  onClose,
+  children,
+  texts
+}) {
+  const { t } = useToolkitTranslation("common", texts);
+  const dialogId = useId();
+  const handleClose = () => {
+    if (isPending) {
+      return;
+    }
+    onClose();
+  };
+  return /* @__PURE__ */ jsxs(
+    Dialog,
+    {
+      open,
+      onClose: handleClose,
+      maxWidth: "xs",
+      fullWidth: true,
+      "aria-labelledby": `${dialogId}-title`,
+      "aria-describedby": `${dialogId}-description`,
+      children: [
+        /* @__PURE__ */ jsx(DialogTitle, { id: `${dialogId}-title`, children: title }),
+        /* @__PURE__ */ jsxs(DialogContent, { children: [
+          errorMessage && /* @__PURE__ */ jsx(Alert, { severity: "error", role: "alert", sx: { mb: 2 }, children: errorMessage }),
+          description && /* @__PURE__ */ jsx(DialogContentText, { id: `${dialogId}-description`, children: description }),
+          children
+        ] }),
+        /* @__PURE__ */ jsxs(DialogActions, { sx: { px: 3, pb: 2.5 }, children: [
+          /* @__PURE__ */ jsx(Button, { variant: "outlined", color: "inherit", onClick: handleClose, disabled: isPending, children: cancelLabel ?? t("actions.cancel") }),
+          /* @__PURE__ */ jsx(
+            Button,
+            {
+              variant: "contained",
+              color: tone,
+              onClick: onConfirm,
+              disabled: isPending || isConfirmDisabled,
+              "aria-busy": isPending,
+              children: isPending ? /* @__PURE__ */ jsx(CircularProgress, { size: 20, color: "inherit" }) : confirmLabel ?? t("actions.confirm")
+            }
+          )
+        ] })
+      ]
+    }
+  );
+}
+export {
+  ConfirmDialog as default
+};
+//# sourceMappingURL=ConfirmDialog.js.map

package/dist/feedback/ConfirmDialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfirmDialog.js","sources":["../../src/feedback/ConfirmDialog.jsx"],"sourcesContent":["// Diálogo de confirmación: toda acción que cambia algo, manda un correo o descarga un archivo pasa por aquí antes de\n// ejecutarse (regla de tablas). Dice en lenguaje ciudadano QUÉ va a pasar y a QUÉ renglón («¿Dar de baja a Ana López?\n// Ya no podrá entrar; se puede reactivar después»).\n//\n// Recibe el estado de la petición por props (pending, error) en vez de hacerla él: core no conoce el API. Lo normal es\n// alimentarlo con useConfirmAction (máquina confirmActionMachine), que ya garantiza que cancelar no ejecuta y que un\n// doble clic no manda dos peticiones. Mientras la petición está en curso no se puede cerrar ni volver a confirmar.\n//\n// children: lo que el diálogo necesita pedir antes de confirmar (p. ej. el motivo de una baja), debajo del texto.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useId} from 'react';\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport Alert from '@mui/material/Alert';\nimport Button from '@mui/material/Button';\nimport CircularProgress from '@mui/material/CircularProgress';\nimport Dialog from '@mui/material/Dialog';\nimport DialogActions from '@mui/material/DialogActions';\nimport DialogContent from '@mui/material/DialogContent';\nimport DialogContentText from '@mui/material/DialogContentText';\nimport DialogTitle from '@mui/material/DialogTitle';\n\n/**\n * @param {object} props\n * @param {boolean} props.open\n * @param {string} props.title texto ya traducido, con el renglón («¿Dar de baja a Ana López?»)\n * @param {import('react').ReactNode} [props.description] qué va a pasar, en palabras normales\n * @param {string} [props.confirmLabel]\n * @param {string} [props.cancelLabel]\n * @param {'primary'|'error'|'warning'} [props.tone]\n * @param {boolean} [props.isPending]\n * @param {boolean} [props.isConfirmDisabled] la acción ya no aplica (p. ej. conflicto: el registro cambió)\n * @param {string|null} [props.errorMessage] mensaje ya traducido (ApiError.message)\n * @param {() => void} props.onConfirm\n * @param {() => void} props.onClose\n * @param {import('react').ReactNode} [props.children]\n * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete\n */\nexport default function ConfirmDialog({\n    open, title, description, confirmLabel, cancelLabel, tone = 'primary',\n    isPending = false, isConfirmDisabled = false, errorMessage = null, onConfirm, onClose, children, texts,\n}) {\n    const {t} = useToolkitTranslation('common', texts);\n    // ids propios: una pantalla puede tener varios diálogos montados y los aria-* no deben apuntar al de otro\n    const dialogId = useId();\n\n    const handleClose = () => {\n        // guard clause: no se cierra a media petición\n        if (isPending) {\n            return;\n        }\n        onClose();\n    };\n\n    return (\n        <Dialog open={open} onClose={handleClose} maxWidth=\"xs\" fullWidth\n                aria-labelledby={`${dialogId}-title`} aria-describedby={`${dialogId}-description`}>\n            <DialogTitle id={`${dialogId}-title`}>{title}</DialogTitle>\n            <DialogContent>\n                {errorMessage && <Alert severity=\"error\" role=\"alert\" sx={{mb: 2}}>{errorMessage}</Alert>}\n                {description && (\n                    <DialogContentText id={`${dialogId}-description`}>{description}</DialogContentText>\n                )}\n                {children}\n            </DialogContent>\n            <DialogActions sx={{px: 3, pb: 2.5}}>\n                <Button variant=\"outlined\" color=\"inherit\" onClick={handleClose} disabled={isPending}>\n                    {cancelLabel ?? t('actions.cancel')}\n                </Button>\n                <Button variant=\"contained\" color={tone} onClick={onConfirm} disabled={isPending || isConfirmDisabled}\n                        aria-busy={isPending}>\n                    {isPending ? <CircularProgress size={20} color=\"inherit\" /> : (confirmLabel ?? t('actions.confirm'))}\n                </Button>\n            </DialogActions>\n        </Dialog>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAsCA,SAAwB,cAAc;AAAA,EAClC;AAAA,EAAM;AAAA,EAAO;AAAA,EAAa;AAAA,EAAc;AAAA,EAAa,OAAO;AAAA,EAC5D,YAAY;AAAA,EAAO,oBAAoB;AAAA,EAAO,eAAe;AAAA,EAAM;AAAA,EAAW;AAAA,EAAS;AAAA,EAAU;AACrG,GAAG;AACC,QAAM,EAAC,EAAA,IAAK,sBAAsB,UAAU,KAAK;AAEjD,QAAM,WAAW,MAAA;AAEjB,QAAM,cAAc,MAAM;AAEtB,QAAI,WAAW;AACX;AAAA,IACJ;AACA,YAAA;AAAA,EACJ;AAEA,SACI;AAAA,IAAC;AAAA,IAAA;AAAA,MAAO;AAAA,MAAY,SAAS;AAAA,MAAa,UAAS;AAAA,MAAK,WAAS;AAAA,MACzD,mBAAiB,GAAG,QAAQ;AAAA,MAAU,oBAAkB,GAAG,QAAQ;AAAA,MACvE,UAAA;AAAA,QAAA,oBAAC,aAAA,EAAY,IAAI,GAAG,QAAQ,UAAW,UAAA,OAAM;AAAA,6BAC5C,eAAA,EACI,UAAA;AAAA,UAAA,gBAAgB,oBAAC,OAAA,EAAM,UAAS,SAAQ,MAAK,SAAQ,IAAI,EAAC,IAAI,EAAA,GAAK,UAAA,aAAA,CAAa;AAAA,UAChF,eACG,oBAAC,mBAAA,EAAkB,IAAI,GAAG,QAAQ,gBAAiB,UAAA,aAAY;AAAA,UAElE;AAAA,QAAA,GACL;AAAA,QACA,qBAAC,iBAAc,IAAI,EAAC,IAAI,GAAG,IAAI,OAC3B,UAAA;AAAA,UAAA,oBAAC,QAAA,EAAO,SAAQ,YAAW,OAAM,WAAU,SAAS,aAAa,UAAU,WACtE,UAAA,eAAe,EAAE,gBAAgB,GACtC;AAAA,UACA;AAAA,YAAC;AAAA,YAAA;AAAA,cAAO,SAAQ;AAAA,cAAY,OAAO;AAAA,cAAM,SAAS;AAAA,cAAW,UAAU,aAAa;AAAA,cAC5E,aAAW;AAAA,cACd,UAAA,YAAY,oBAAC,kBAAA,EAAiB,MAAM,IAAI,OAAM,UAAA,CAAU,IAAM,gBAAgB,EAAE,iBAAiB;AAAA,YAAA;AAAA,UAAA;AAAA,QACtG,EAAA,CACJ;AAAA,MAAA;AAAA,IAAA;AAAA,EAAA;AAGZ;"}

package/dist/feedback/ModalWaiting.js

@@ -0,0 +1,23 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import CircularProgress from "@mui/material/CircularProgress";
+import Dialog from "@mui/material/Dialog";
+import DialogContent from "@mui/material/DialogContent";
+import DialogContentText from "@mui/material/DialogContentText";
+import DialogTitle from "@mui/material/DialogTitle";
+import Stack from "@mui/material/Stack";
+function ModalWaiting({ open, title, text, texts }) {
+  const { t } = useToolkitTranslation("common", texts);
+  return /* @__PURE__ */ jsxs(Dialog, { open, disableEscapeKeyDown: true, "aria-busy": "true", sx: { zIndex: (theme) => theme.zIndex.tooltip + 10 }, children: [
+    /* @__PURE__ */ jsx(DialogTitle, { sx: { textAlign: "center" }, children: title ?? t("waiting.title") }),
+    /* @__PURE__ */ jsx(DialogContent, { children: /* @__PURE__ */ jsxs(Stack, { spacing: 2, sx: { alignItems: "center" }, children: [
+      /* @__PURE__ */ jsx(CircularProgress, { size: 28 }),
+      /* @__PURE__ */ jsx(DialogContentText, { sx: { textAlign: "center" }, children: text ?? t("waiting.text") })
+    ] }) })
+  ] });
+}
+export {
+  ModalWaiting as default
+};
+//# sourceMappingURL=ModalWaiting.js.map

package/dist/feedback/ModalWaiting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModalWaiting.js","sources":["../../src/feedback/ModalWaiting.jsx"],"sourcesContent":["// Bloqueo general \"espere un momento\" como diálogo modal, para una acción que no se puede interrumpir (p. ej. generar\n// un archivo grande).\n//\n// OJO zIndex: HASTA ARRIBA de todo, encima de modal (1300), snackbar (1400) y tooltip (1500), para que ningún elemento\n// de la interfaz se le monte mientras bloquea. No se cierra con Escape a propósito.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport CircularProgress from '@mui/material/CircularProgress';\nimport Dialog from '@mui/material/Dialog';\nimport DialogContent from '@mui/material/DialogContent';\nimport DialogContentText from '@mui/material/DialogContentText';\nimport DialogTitle from '@mui/material/DialogTitle';\nimport Stack from '@mui/material/Stack';\n\n/**\n * @param {object} props\n * @param {boolean} props.open\n * @param {string} [props.title] ya traducido; por omisión common:waiting.title\n * @param {string} [props.text] ya traducido; por omisión common:waiting.text\n * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete\n */\nexport default function ModalWaiting({open, title, text, texts}) {\n    const {t} = useToolkitTranslation('common', texts);\n\n    return (\n        <Dialog open={open} disableEscapeKeyDown aria-busy=\"true\" sx={{zIndex: (theme) => theme.zIndex.tooltip + 10}}>\n            <DialogTitle sx={{textAlign: 'center'}}>{title ?? t('waiting.title')}</DialogTitle>\n            <DialogContent>\n                <Stack spacing={2} sx={{alignItems: 'center'}}>\n                    <CircularProgress size={28} />\n                    <DialogContentText sx={{textAlign: 'center'}}>{text ?? t('waiting.text')}</DialogContentText>\n                </Stack>\n            </DialogContent>\n        </Dialog>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;;AAsBA,SAAwB,aAAa,EAAC,MAAM,OAAO,MAAM,SAAQ;AAC7D,QAAM,EAAC,EAAA,IAAK,sBAAsB,UAAU,KAAK;AAEjD,8BACK,QAAA,EAAO,MAAY,sBAAoB,MAAC,aAAU,QAAO,IAAI,EAAC,QAAQ,CAAC,UAAU,MAAM,OAAO,UAAU,MACrG,UAAA;AAAA,IAAA,oBAAC,aAAA,EAAY,IAAI,EAAC,WAAW,YAAY,UAAA,SAAS,EAAE,eAAe,EAAA,CAAE;AAAA,IACrE,oBAAC,eAAA,EACG,UAAA,qBAAC,OAAA,EAAM,SAAS,GAAG,IAAI,EAAC,YAAY,SAAA,GAChC,UAAA;AAAA,MAAA,oBAAC,kBAAA,EAAiB,MAAM,GAAA,CAAI;AAAA,MAC5B,oBAAC,mBAAA,EAAkB,IAAI,EAAC,WAAW,YAAY,UAAA,QAAQ,EAAE,cAAc,EAAA,CAAE;AAAA,IAAA,EAAA,CAC7E,EAAA,CACJ;AAAA,EAAA,GACJ;AAER;"}

package/dist/feedback/NewBuildNotice.js

@@ -0,0 +1,79 @@
+"use client";
+import { jsxs, jsx } from "react/jsx-runtime";
+import { useToolkitTranslation } from "../toolkit/useToolkitTranslation.js";
+import Alert from "@mui/material/Alert";
+import Box from "@mui/material/Box";
+import Button from "@mui/material/Button";
+import Typography from "@mui/material/Typography";
+import RefreshRoundedIcon from "@mui/icons-material/RefreshRounded";
+import { useNewBuildPublished } from "../observability/publishedBuild.js";
+import { aboveMobileTabBarOf, GLASS_PANEL_GAP_PIXELS } from "../appShell/shellSizes.js";
+import { minimalFloatingStylesOf } from "../theme/components/minimalComponents.js";
+import { isGlassTheme, glassStylesOf } from "../theme/glassSurface.js";
+import { APP_BAR_HEIGHT } from "../ui/layout/appBarHeight.js";
+const NEW_BUILD_NOTICE_VARIANT = Object.freeze({ ribbon: "ribbon", floating: "floating" });
+const FLOATING_GAP_PIXELS = 8;
+const FLOATING_ENTER_MILLISECONDS = 280;
+function reloadPage() {
+  window.location.reload();
+}
+function floatingSxOf(theme) {
+  return {
+    // con vidrio, cápsula de vidrio; con el minimalista (barra en cápsulas), sólida del gris de lo que flota
+    ...isGlassTheme(theme) ? glassStylesOf(theme) : minimalFloatingStylesOf(theme),
+    position: "fixed",
+    left: "50%",
+    transform: "translateX(-50%)",
+    zIndex: theme.zIndex.appBar,
+    display: "flex",
+    alignItems: "center",
+    gap: 1.5,
+    width: "max-content",
+    maxWidth: `calc(100% - ${GLASS_PANEL_GAP_PIXELS * 2}px)`,
+    borderRadius: "999px",
+    py: 0.75,
+    pl: 2,
+    pr: 0.75,
+    top: `calc(${APP_BAR_HEIGHT} + ${FLOATING_GAP_PIXELS}px)`,
+    ...aboveMobileTabBarOf(FLOATING_GAP_PIXELS),
+    // aparece subiendo un poco y aclarándose; sin movimiento si la persona lo pidió así en su equipo
+    "@keyframes calcitaNoticeEnter": {
+      from: { opacity: 0, transform: "translate(-50%, 8px) scale(0.96)" },
+      to: { opacity: 1, transform: "translate(-50%, 0) scale(1)" }
+    },
+    animation: `calcitaNoticeEnter ${FLOATING_ENTER_MILLISECONDS}ms ${theme.transitions.easing.easeOut}`,
+    "@media (prefers-reduced-motion: reduce)": { animation: "none" }
+  };
+}
+function NewBuildNotice({ message, reloadLabel, onReload = reloadPage, variant = NEW_BUILD_NOTICE_VARIANT.ribbon, texts }) {
+  const { t } = useToolkitTranslation("common", texts);
+  const isNewBuildPublished = useNewBuildPublished();
+  if (!isNewBuildPublished) {
+    return null;
+  }
+  const buttonLabel = reloadLabel ?? t("newBuild.reload");
+  if (variant === NEW_BUILD_NOTICE_VARIANT.floating) {
+    return /* @__PURE__ */ jsxs(Box, { role: "status", "aria-live": "polite", "aria-label": message ?? t("newBuild.message"), sx: floatingSxOf, children: [
+      /* @__PURE__ */ jsx(RefreshRoundedIcon, { fontSize: "small", sx: { color: "text.secondary" } }),
+      /* @__PURE__ */ jsx(Typography, { variant: "body2", noWrap: true, sx: { fontWeight: 500, minWidth: 0 }, children: message ?? t("newBuild.short") }),
+      /* @__PURE__ */ jsx(Button, { size: "small", variant: "contained", onClick: onReload, sx: { flexShrink: 0 }, children: buttonLabel })
+    ] });
+  }
+  return /* @__PURE__ */ jsx(
+    Alert,
+    {
+      severity: "warning",
+      square: true,
+      role: "status",
+      "aria-live": "polite",
+      sx: { py: 0, px: { xs: 2, md: 3 }, alignItems: "center" },
+      action: /* @__PURE__ */ jsx(Button, { size: "small", variant: "outlined", color: "inherit", onClick: onReload, sx: { flexShrink: 0 }, children: buttonLabel }),
+      children: message ?? t("newBuild.message")
+    }
+  );
+}
+export {
+  NEW_BUILD_NOTICE_VARIANT,
+  NewBuildNotice as default
+};
+//# sourceMappingURL=NewBuildNotice.js.map

package/dist/feedback/NewBuildNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NewBuildNotice.js","sources":["../../src/feedback/NewBuildNotice.jsx"],"sourcesContent":["// Aviso «Hay una versión nueva» con su botón de recargar.\n//\n// Sale cuando el servidor anuncia una compilación del front distinta a la que corre en la pestaña\n// (observability/publishedBuild.js) y se queda hasta que la persona recarga. No recarga solo: la persona puede estar a\n// media captura y decide cuándo.\n//\n// Dos formas, el mismo aviso:\n//   - «ribbon» (por omisión): una franja a todo lo ancho que el proyecto pone donde se vea siempre, normalmente dentro de\n//     su AppBar, debajo de la barra. Se arma con el Alert de MUI, que ya trae sus colores para claro y oscuro.\n//   - «floating»: una cápsula de vidrio que flota aparte, sin tocar la barra, como el reproductor chico que Apple pone\n//     encima de las pestañas en el iPhone. En escritorio, centrada debajo de la barra de arriba; en el teléfono, encima de\n//     la barra de pestañas. Es la que usa AppLayout con vidrio: dentro de la cápsula de la barra la franja la hacía crecer al\n//     doble, la curva cortaba el texto y el botón se salía por la orilla (lo reportaron).\n// Sin compilación nueva no pinta nada ni ocupa lugar.\n//\n// Genérico del paquete: function (regla de la casa).\nimport {useToolkitTranslation} from '@/toolkit/useToolkitTranslation.js';\nimport Alert from '@mui/material/Alert';\nimport Box from '@mui/material/Box';\nimport Button from '@mui/material/Button';\nimport Typography from '@mui/material/Typography';\nimport RefreshRoundedIcon from '@mui/icons-material/RefreshRounded';\n\nimport {useNewBuildPublished} from '@/observability/publishedBuild.js';\nimport {GLASS_PANEL_GAP_PIXELS, aboveMobileTabBarOf} from '@/appShell/shellSizes.js';\nimport {minimalFloatingStylesOf} from '@/theme/components/minimalComponents.js';\nimport {glassStylesOf, isGlassTheme} from '@/theme/glassSurface.js';\nimport {APP_BAR_HEIGHT} from '@/ui/layout/appBarHeight.js';\n\n/** Las formas del aviso: franja (dentro de la barra del proyecto) o cápsula flotante (la del marco con vidrio). */\nexport const NEW_BUILD_NOTICE_VARIANT = Object.freeze({ribbon: 'ribbon', floating: 'floating'});\n\n// lo que se separa la cápsula de la barra (px) y lo que tarda en aparecer (ms)\nconst FLOATING_GAP_PIXELS = 8;\nconst FLOATING_ENTER_MILLISECONDS = 280;\n\n/** Lo que hace el botón si el proyecto no dice otra cosa: recargar la página, que trae la compilación nueva. */\nfunction reloadPage() {\n    window.location.reload();\n}\n\n/**\n * La cápsula flotante: fija a la ventana y centrada. En escritorio queda debajo de la barra de arriba (su alto real,\n * APP_BAR_HEIGHT); en el teléfono, encima de la barra de pestañas (su alto, sus separaciones y la zona del gesto de inicio).\n *\n * Va centrada en la VENTANA, debajo del centro de la barra (que va de orilla a orilla): centrada en el contenido quedaba\n * corrida a la derecha respecto a la barra (lo reportaron).\n *\n * @param {object} theme\n * @returns {object}\n */\nfunction floatingSxOf(theme) {\n    return {\n        // con vidrio, cápsula de vidrio; con el minimalista (barra en cápsulas), sólida del gris de lo que flota\n        ...(isGlassTheme(theme) ? glassStylesOf(theme) : minimalFloatingStylesOf(theme)),\n        position: 'fixed',\n        left: '50%',\n        transform: 'translateX(-50%)',\n        zIndex: theme.zIndex.appBar,\n        display: 'flex',\n        alignItems: 'center',\n        gap: 1.5,\n        width: 'max-content',\n        maxWidth: `calc(100% - ${GLASS_PANEL_GAP_PIXELS * 2}px)`,\n        borderRadius: '999px',\n        py: 0.75,\n        pl: 2,\n        pr: 0.75,\n        top: `calc(${APP_BAR_HEIGHT} + ${FLOATING_GAP_PIXELS}px)`,\n        ...aboveMobileTabBarOf(FLOATING_GAP_PIXELS),\n        // aparece subiendo un poco y aclarándose; sin movimiento si la persona lo pidió así en su equipo\n        '@keyframes calcitaNoticeEnter': {\n            from: {opacity: 0, transform: 'translate(-50%, 8px) scale(0.96)'},\n            to: {opacity: 1, transform: 'translate(-50%, 0) scale(1)'},\n        },\n        animation: `calcitaNoticeEnter ${FLOATING_ENTER_MILLISECONDS}ms ${theme.transitions.easing.easeOut}`,\n        '@media (prefers-reduced-motion: reduce)': {animation: 'none'},\n    };\n}\n\n/**\n * @param {object} [props]\n * @param {string} [props.message] ya traducido; por omisión el del paquete (en la cápsula, el corto: common:newBuild.short)\n * @param {string} [props.reloadLabel] ya traducido; por omisión «Recargar»\n * @param {() => void} [props.onReload] por omisión recarga la página\n * @param {'ribbon'|'floating'} [props.variant] franja o cápsula flotante (NEW_BUILD_NOTICE_VARIANT); por omisión franja\n * @param {object} [props.texts] los textos que cambian, con la forma de `common` en los textos del paquete\n */\nexport default function NewBuildNotice({message, reloadLabel, onReload = reloadPage, variant = NEW_BUILD_NOTICE_VARIANT.ribbon, texts}) {\n    const {t} = useToolkitTranslation('common', texts);\n    const isNewBuildPublished = useNewBuildPublished();\n\n    // guard clause: la compilación de la pestaña sigue siendo la publicada; el aviso no ocupa lugar\n    if (!isNewBuildPublished) {\n        return null;\n    }\n\n    const buttonLabel = reloadLabel ?? t('newBuild.reload');\n\n    if (variant === NEW_BUILD_NOTICE_VARIANT.floating) {\n        // el texto largo va para el lector de pantalla; a la vista, el corto (una cápsula de un renglón)\n        return (\n            <Box role=\"status\" aria-live=\"polite\" aria-label={message ?? t('newBuild.message')} sx={floatingSxOf}>\n                <RefreshRoundedIcon fontSize=\"small\" sx={{color: 'text.secondary'}} />\n                <Typography variant=\"body2\" noWrap sx={{fontWeight: 500, minWidth: 0}}>{message ?? t('newBuild.short')}</Typography>\n                <Button size=\"small\" variant=\"contained\" onClick={onReload} sx={{flexShrink: 0}}>{buttonLabel}</Button>\n            </Box>\n        );\n    }\n\n    return (\n        <Alert severity=\"warning\" square role=\"status\" aria-live=\"polite\"\n               sx={{py: 0, px: {xs: 2, md: 3}, alignItems: 'center'}}\n               action={(\n                   <Button size=\"small\" variant=\"outlined\" color=\"inherit\" onClick={onReload} sx={{flexShrink: 0}}>\n                       {buttonLabel}\n                   </Button>\n               )}>\n            {message ?? t('newBuild.message')}\n        </Alert>\n    );\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;AA8BO,MAAM,2BAA2B,OAAO,OAAO,EAAC,QAAQ,UAAU,UAAU,YAAW;AAG9F,MAAM,sBAAsB;AAC5B,MAAM,8BAA8B;AAGpC,SAAS,aAAa;AAClB,SAAO,SAAS,OAAA;AACpB;AAYA,SAAS,aAAa,OAAO;AACzB,SAAO;AAAA;AAAA,IAEH,GAAI,aAAa,KAAK,IAAI,cAAc,KAAK,IAAI,wBAAwB,KAAK;AAAA,IAC9E,UAAU;AAAA,IACV,MAAM;AAAA,IACN,WAAW;AAAA,IACX,QAAQ,MAAM,OAAO;AAAA,IACrB,SAAS;AAAA,IACT,YAAY;AAAA,IACZ,KAAK;AAAA,IACL,OAAO;AAAA,IACP,UAAU,eAAe,yBAAyB,CAAC;AAAA,IACnD,cAAc;AAAA,IACd,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,IAAI;AAAA,IACJ,KAAK,QAAQ,cAAc,MAAM,mBAAmB;AAAA,IACpD,GAAG,oBAAoB,mBAAmB;AAAA;AAAA,IAE1C,iCAAiC;AAAA,MAC7B,MAAM,EAAC,SAAS,GAAG,WAAW,mCAAA;AAAA,MAC9B,IAAI,EAAC,SAAS,GAAG,WAAW,8BAAA;AAAA,IAA6B;AAAA,IAE7D,WAAW,sBAAsB,2BAA2B,MAAM,MAAM,YAAY,OAAO,OAAO;AAAA,IAClG,2CAA2C,EAAC,WAAW,OAAA;AAAA,EAAM;AAErE;AAUA,SAAwB,eAAe,EAAC,SAAS,aAAa,WAAW,YAAY,UAAU,yBAAyB,QAAQ,SAAQ;AACpI,QAAM,EAAC,EAAA,IAAK,sBAAsB,UAAU,KAAK;AACjD,QAAM,sBAAsB,qBAAA;AAG5B,MAAI,CAAC,qBAAqB;AACtB,WAAO;AAAA,EACX;AAEA,QAAM,cAAc,eAAe,EAAE,iBAAiB;AAEtD,MAAI,YAAY,yBAAyB,UAAU;AAE/C,WACI,qBAAC,KAAA,EAAI,MAAK,UAAS,aAAU,UAAS,cAAY,WAAW,EAAE,kBAAkB,GAAG,IAAI,cACpF,UAAA;AAAA,MAAA,oBAAC,sBAAmB,UAAS,SAAQ,IAAI,EAAC,OAAO,oBAAmB;AAAA,0BACnE,YAAA,EAAW,SAAQ,SAAQ,QAAM,MAAC,IAAI,EAAC,YAAY,KAAK,UAAU,KAAK,UAAA,WAAW,EAAE,gBAAgB,GAAE;AAAA,MACvG,oBAAC,QAAA,EAAO,MAAK,SAAQ,SAAQ,aAAY,SAAS,UAAU,IAAI,EAAC,YAAY,EAAA,GAAK,UAAA,YAAA,CAAY;AAAA,IAAA,GAClG;AAAA,EAER;AAEA,SACI;AAAA,IAAC;AAAA,IAAA;AAAA,MAAM,UAAS;AAAA,MAAU,QAAM;AAAA,MAAC,MAAK;AAAA,MAAS,aAAU;AAAA,MAClD,IAAI,EAAC,IAAI,GAAG,IAAI,EAAC,IAAI,GAAG,IAAI,KAAI,YAAY,SAAA;AAAA,MAC5C,QACI,oBAAC,QAAA,EAAO,MAAK,SAAQ,SAAQ,YAAW,OAAM,WAAU,SAAS,UAAU,IAAI,EAAC,YAAY,KACvF,UAAA,aACL;AAAA,MAEN,UAAA,WAAW,EAAE,kBAAkB;AAAA,IAAA;AAAA,EAAA;AAG5C;"}