@proef/common-ui 0.0.0-stage → 2.2.1

package/dist/esm/legacy/utils/stringUtils.js

@@ -0,0 +1,35 @@
+function getAcronym(str) {
+  const words = str.split(" ");
+  const firstLetter = words[0] ? words[0].charAt(0).toUpperCase() : "";
+  const lastLetter = words.length > 1 ? words[words.length - 1].charAt(0).toUpperCase() : "";
+  const result = firstLetter + lastLetter;
+  return result;
+}
+function getFirstAndLastName(str) {
+  const words = str.split(" ");
+  let firstAndLast = "";
+  if (words.length > 0) {
+    firstAndLast += words[0];
+    if (words.length > 1) {
+      firstAndLast += " ";
+      firstAndLast += words[words.length - 1];
+    }
+  }
+  return firstAndLast;
+}
+function normalize(string) {
+  return string.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
+}
+function partialMatchWithUsername(search, username) {
+  if (search === "") return true;
+  const names = normalize(username).split(" ");
+  const searchNames = normalize(search).split(" ");
+  const matchAllNames = searchNames.every((searchName) => names.some((n) => n.includes(searchName)));
+  return matchAllNames;
+}
+export {
+  getAcronym,
+  getFirstAndLastName,
+  partialMatchWithUsername
+};
+//# sourceMappingURL=stringUtils.js.map

package/dist/esm/legacy/utils/stringUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringUtils.js","sources":["../../../../src/legacy/utils/stringUtils.ts"],"sourcesContent":["\r\n// Returns acronym from string\r\n/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */\r\nexport function getAcronym(str: string) {\r\n    const words = str.split(' ')\r\n    const firstLetter = words[0] ? words[0].charAt(0).toUpperCase() : ''\r\n    const lastLetter = words.length > 1 ? words[words.length - 1].charAt(0).toUpperCase() : ''\r\n    const result = firstLetter + lastLetter\r\n\r\n    return result\r\n}\r\n\r\n/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */\r\nexport function getFirstAndLastName(str: string) {\r\n    const words = str.split(' ')\r\n    let firstAndLast = ''\r\n\r\n    if (words.length > 0) {\r\n        firstAndLast += words[0]\r\n        if (words.length > 1) {\r\n            firstAndLast += \" \"\r\n            firstAndLast += words[words.length - 1]\r\n        }\r\n    }\r\n\r\n    return firstAndLast\r\n}\r\n\r\nfunction normalize(string: string) {\r\n    return string.normalize(\"NFD\").replace(/[\\u0300-\\u036f]/g, \"\").toLowerCase()\r\n}\r\n\r\n/** @deprecated Legacy — não usar em código novo. Ver Storybook › Legacy. */\r\nexport function partialMatchWithUsername(search: string, username: string) {\r\n    if (search === \"\") return true\r\n    const names = normalize(username).split(\" \")\r\n    const searchNames = normalize(search).split(\" \")\r\n\r\n    const matchAllNames = searchNames.every(searchName => names.some(n => n.includes(searchName)))\r\n\r\n    return matchAllNames\r\n}"],"names":[],"mappings":"AAGO,SAAS,WAAW,KAAa;AACpC,QAAM,QAAQ,IAAI,MAAM,GAAG;AAC3B,QAAM,cAAc,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,YAAA,IAAgB;AAClE,QAAM,aAAa,MAAM,SAAS,IAAI,MAAM,MAAM,SAAS,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB;AACxF,QAAM,SAAS,cAAc;AAE7B,SAAO;AACX;AAGO,SAAS,oBAAoB,KAAa;AAC7C,QAAM,QAAQ,IAAI,MAAM,GAAG;AAC3B,MAAI,eAAe;AAEnB,MAAI,MAAM,SAAS,GAAG;AAClB,oBAAgB,MAAM,CAAC;AACvB,QAAI,MAAM,SAAS,GAAG;AAClB,sBAAgB;AAChB,sBAAgB,MAAM,MAAM,SAAS,CAAC;AAAA,IAC1C;AAAA,EACJ;AAEA,SAAO;AACX;AAEA,SAAS,UAAU,QAAgB;AAC/B,SAAO,OAAO,UAAU,KAAK,EAAE,QAAQ,oBAAoB,EAAE,EAAE,YAAA;AACnE;AAGO,SAAS,yBAAyB,QAAgB,UAAkB;AACvE,MAAI,WAAW,GAAI,QAAO;AAC1B,QAAM,QAAQ,UAAU,QAAQ,EAAE,MAAM,GAAG;AAC3C,QAAM,cAAc,UAAU,MAAM,EAAE,MAAM,GAAG;AAE/C,QAAM,gBAAgB,YAAY,MAAM,CAAA,eAAc,MAAM,KAAK,CAAA,MAAK,EAAE,SAAS,UAAU,CAAC,CAAC;AAE7F,SAAO;AACX;"}

package/dist/esm/v1/capabilities/documents/QRScanning/scanQRCodes.js

@@ -0,0 +1,157 @@
+import { loadPdfjs } from "../../../primitives/documents/PdfPreview/pdfjs.js";
+let wasmUrl = null;
+let enginesPromise = null;
+function configureQRScanner(options) {
+  wasmUrl = options.wasmUrl;
+}
+function loadEngines() {
+  if (!enginesPromise) {
+    enginesPromise = Promise.all([import("qr-scanner"), import("zxing-wasm/reader"), import("@zxing/library")]).then(([qrScanner, zxingWasm, zxingJs]) => {
+      if (wasmUrl) {
+        const url = wasmUrl;
+        zxingWasm.prepareZXingModule({ overrides: { locateFile: (path, prefix) => path.endsWith(".wasm") ? url : prefix + path } });
+      }
+      return { QrScanner: qrScanner.default, readBarcodes: zxingWasm.readBarcodes, zxingJs };
+    }).catch((e) => {
+      enginesPromise = null;
+      throw e;
+    });
+  }
+  return enginesPromise;
+}
+const UPSCALE_TARGET = 800;
+const BINARIZERS = ["LocalAverage", "GlobalHistogram", "FixedThreshold"];
+function loadImage(file) {
+  return new Promise((resolve, reject) => {
+    const img = new Image();
+    const url = URL.createObjectURL(file);
+    img.onload = () => {
+      URL.revokeObjectURL(url);
+      resolve(img);
+    };
+    img.onerror = () => {
+      URL.revokeObjectURL(url);
+      reject(new Error("Imagem ilegível"));
+    };
+    img.src = url;
+  });
+}
+async function drawVariant(file, contrast) {
+  const img = await loadImage(file);
+  const scale = Math.max(1, UPSCALE_TARGET / Math.min(img.naturalWidth, img.naturalHeight));
+  const canvas = document.createElement("canvas");
+  canvas.width = Math.round(img.naturalWidth * scale);
+  canvas.height = Math.round(img.naturalHeight * scale);
+  const ctx = canvas.getContext("2d", { willReadFrequently: true });
+  ctx.imageSmoothingEnabled = true;
+  ctx.imageSmoothingQuality = "high";
+  ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+  if (contrast) {
+    const d = ctx.getImageData(0, 0, canvas.width, canvas.height);
+    const px = d.data;
+    for (let i = 0; i < px.length; i += 4) {
+      const g = 0.299 * px[i] + 0.587 * px[i + 1] + 0.114 * px[i + 2];
+      px[i] = px[i + 1] = px[i + 2] = Math.max(0, Math.min(255, 128 + contrast * (g - 128)));
+    }
+    ctx.putImageData(d, 0, 0);
+  }
+  return canvas;
+}
+const pixels = (canvas) => canvas.getContext("2d", { willReadFrequently: true }).getImageData(0, 0, canvas.width, canvas.height);
+async function renderPdfFirstPage(file) {
+  const { getDocument } = await loadPdfjs();
+  const pdf = await getDocument({ data: new Uint8Array(await file.arrayBuffer()) }).promise;
+  try {
+    const page = await pdf.getPage(1);
+    const base = page.getViewport({ scale: 1 });
+    const viewport = page.getViewport({ scale: Math.min(4, Math.max(1, 2200 / Math.max(base.width, base.height))) });
+    const canvas = document.createElement("canvas");
+    canvas.width = Math.ceil(viewport.width);
+    canvas.height = Math.ceil(viewport.height);
+    const ctx = canvas.getContext("2d", { willReadFrequently: true });
+    ctx.fillStyle = "#fff";
+    ctx.fillRect(0, 0, canvas.width, canvas.height);
+    await page.render({ canvasContext: ctx, viewport }).promise;
+    return await new Promise((resolve, reject) => canvas.toBlob((b) => b ? resolve(b) : reject(new Error("toBlob falhou")), "image/png"));
+  } finally {
+    pdf.destroy();
+  }
+}
+async function scanQRCodes(file, options = {}) {
+  const until = options.until ?? (() => true);
+  const { QrScanner, readBarcodes, zxingJs } = await loadEngines();
+  let source = file;
+  if (file.type === "application/pdf") {
+    try {
+      source = await renderPdfFirstPage(file);
+    } catch {
+      return [];
+    }
+  }
+  const codes = [];
+  const add = (text) => {
+    if (text && !codes.includes(text)) codes.push(text);
+  };
+  const done = () => codes.some(until);
+  const qrScanner = async (input) => {
+    try {
+      add((await QrScanner.scanImage(input, { returnDetailedScanResult: true })).data);
+    } catch {
+    }
+  };
+  const zxingWasm = async (input, all = false) => {
+    for (const binarizer of BINARIZERS) {
+      try {
+        const texts = (await readBarcodes(input, { formats: ["QRCode"], tryHarder: true, tryDenoise: true, binarizer })).filter((r) => r.isValid).map((r) => r.text);
+        texts.forEach(add);
+        if (texts.length && !all) return;
+      } catch {
+      }
+    }
+  };
+  const zxingJsDecode = (canvas) => {
+    try {
+      const { data, width, height } = pixels(canvas);
+      const bitmap = new zxingJs.BinaryBitmap(new zxingJs.HybridBinarizer(new zxingJs.RGBLuminanceSource(data, width, height)));
+      add(new zxingJs.MultiFormatReader().decode(bitmap).getText());
+    } catch {
+    }
+  };
+  let upscaled = null;
+  const collectRemaining = async () => {
+    await zxingWasm(source, true);
+    upscaled ??= await drawVariant(source).catch(() => null);
+    if (upscaled) await zxingWasm(pixels(upscaled), true);
+    return codes;
+  };
+  try {
+    await qrScanner(source);
+    if (done()) return collectRemaining();
+    await zxingWasm(source);
+    if (done()) return collectRemaining();
+    upscaled = await drawVariant(source);
+    await qrScanner(upscaled);
+    if (done()) return collectRemaining();
+    await zxingWasm(pixels(upscaled));
+    if (done()) return collectRemaining();
+    zxingJsDecode(upscaled);
+    if (done()) return collectRemaining();
+    for (const contrast of [2.5, 5]) {
+      const canvas = await drawVariant(source, contrast);
+      await qrScanner(canvas);
+      if (done()) return collectRemaining();
+      await zxingWasm(pixels(canvas));
+      if (done()) return collectRemaining();
+      zxingJsDecode(canvas);
+      if (done()) return collectRemaining();
+    }
+  } catch {
+    return codes;
+  }
+  return codes.length ? collectRemaining() : codes;
+}
+export {
+  configureQRScanner,
+  scanQRCodes
+};
+//# sourceMappingURL=scanQRCodes.js.map

package/dist/esm/v1/capabilities/documents/QRScanning/scanQRCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanQRCodes.js","sources":["../../../../../../src/v1/capabilities/documents/QRScanning/scanQRCodes.ts"],"sourcesContent":["/**\n * Leitura de QR codes em imagens e PDFs, no browser.\n *\n * Só encontra os códigos e devolve o texto de cada um; o que fazer com eles\n * (ex: interpretar o QR de uma fatura) é da app.\n *\n * Adaptado de uma app interna. Os leitores\n * automáticos falham em imagens de baixa resolução (miniaturas arrastadas do\n * email ou do explorador), por isso tenta-se, por ordem do mais rápido ao mais\n * lento, três motores sobre quatro versões da imagem:\n *   - motores: qr-scanner, zxing-wasm (3 estratégias de binarização) e\n *     @zxing/library (o mais lento, último recurso);\n *   - imagem: original, ampliada, e ampliada a cinzento com contraste ×2,5 e ×5.\n * Os PDFs são primeiro desenhados (1.ª página) e lidos como imagem.\n *\n * As bibliotecas (~1 MB, com o WebAssembly) só são carregadas na primeira leitura.\n */\nimport { loadPdfjs } from '../../../primitives/documents/PdfPreview/pdfjs'\n\nexport interface ScanQRCodesOptions {\n  /**\n   * Continuar a procurar até um código satisfazer esta condição (ex: ser o QR\n   * de uma fatura). Um documento pode ter vários QR codes e o primeiro a ser\n   * lido é arbitrário. Por omissão, pára no primeiro código encontrado.\n   */\n  until?: (code: string) => boolean\n}\n\nlet wasmUrl: string | null = null\nlet enginesPromise: Promise<Engines> | null = null\n\n/**\n * Indica onde está o `zxing_reader.wasm` servido pela app. Chamar uma vez no\n * arranque, antes da primeira leitura. Sem isto, o ficheiro é descarregado da\n * CDN jsDelivr (pode ser bloqueado por redes ou políticas de segurança).\n */\nexport function configureQRScanner(options: { wasmUrl: string }) {\n  wasmUrl = options.wasmUrl\n}\n\ntype Engines = {\n  QrScanner: typeof import('qr-scanner').default\n  readBarcodes: typeof import('zxing-wasm/reader').readBarcodes\n  zxingJs: typeof import('@zxing/library')\n}\n\nfunction loadEngines(): Promise<Engines> {\n  if (!enginesPromise) {\n    enginesPromise = Promise.all([import('qr-scanner'), import('zxing-wasm/reader'), import('@zxing/library')])\n      .then(([qrScanner, zxingWasm, zxingJs]) => {\n        if (wasmUrl) {\n          const url = wasmUrl\n          zxingWasm.prepareZXingModule({ overrides: { locateFile: (path: string, prefix: string) => (path.endsWith('.wasm') ? url : prefix + path) } })\n        }\n        return { QrScanner: qrScanner.default, readBarcodes: zxingWasm.readBarcodes, zxingJs }\n      })\n      .catch((e) => {\n        enginesPromise = null\n        throw e\n      })\n  }\n  return enginesPromise\n}\n\n// Abaixo deste lado mais curto (px), a imagem é ampliada antes de ler.\nconst UPSCALE_TARGET = 800\nconst BINARIZERS = ['LocalAverage', 'GlobalHistogram', 'FixedThreshold'] as const\n\nfunction loadImage(file: Blob): Promise<HTMLImageElement> {\n  return new Promise((resolve, reject) => {\n    const img = new Image()\n    const url = URL.createObjectURL(file)\n    img.onload = () => {\n      URL.revokeObjectURL(url)\n      resolve(img)\n    }\n    img.onerror = () => {\n      URL.revokeObjectURL(url)\n      reject(new Error('Imagem ilegível'))\n    }\n    img.src = url\n  })\n}\n\n/** Imagem ampliada; com `contrast`, também a cinzento com o contraste esticado à volta de 128. */\nasync function drawVariant(file: Blob, contrast?: number): Promise<HTMLCanvasElement> {\n  const img = await loadImage(file)\n  const scale = Math.max(1, UPSCALE_TARGET / Math.min(img.naturalWidth, img.naturalHeight))\n  const canvas = document.createElement('canvas')\n  canvas.width = Math.round(img.naturalWidth * scale)\n  canvas.height = Math.round(img.naturalHeight * scale)\n  const ctx = canvas.getContext('2d', { willReadFrequently: true })!\n  ctx.imageSmoothingEnabled = true\n  ctx.imageSmoothingQuality = 'high'\n  ctx.drawImage(img, 0, 0, canvas.width, canvas.height)\n  if (contrast) {\n    const d = ctx.getImageData(0, 0, canvas.width, canvas.height)\n    const px = d.data\n    for (let i = 0; i < px.length; i += 4) {\n      const g = 0.299 * px[i] + 0.587 * px[i + 1] + 0.114 * px[i + 2]\n      px[i] = px[i + 1] = px[i + 2] = Math.max(0, Math.min(255, 128 + contrast * (g - 128)))\n    }\n    ctx.putImageData(d, 0, 0)\n  }\n  return canvas\n}\n\nconst pixels = (canvas: HTMLCanvasElement) => canvas.getContext('2d', { willReadFrequently: true })!.getImageData(0, 0, canvas.width, canvas.height)\n\n/** 1.ª página do PDF como PNG, numa escala que mantém o QR legível (lado maior ≈ 2200 px). */\nasync function renderPdfFirstPage(file: File): Promise<Blob> {\n  const { getDocument } = await loadPdfjs()\n  const pdf = await getDocument({ data: new Uint8Array(await file.arrayBuffer()) }).promise\n  try {\n    const page = await pdf.getPage(1)\n    const base = page.getViewport({ scale: 1 })\n    const viewport = page.getViewport({ scale: Math.min(4, Math.max(1, 2200 / Math.max(base.width, base.height))) })\n    const canvas = document.createElement('canvas')\n    canvas.width = Math.ceil(viewport.width)\n    canvas.height = Math.ceil(viewport.height)\n    const ctx = canvas.getContext('2d', { willReadFrequently: true })!\n    ctx.fillStyle = '#fff'\n    ctx.fillRect(0, 0, canvas.width, canvas.height)\n    await page.render({ canvasContext: ctx, viewport }).promise\n    return await new Promise<Blob>((resolve, reject) => canvas.toBlob((b) => (b ? resolve(b) : reject(new Error('toBlob falhou'))), 'image/png'))\n  } finally {\n    pdf.destroy()\n  }\n}\n\n/**\n * Lê os QR codes de uma imagem ou PDF (1.ª página).\n *\n * Devolve o texto de cada código encontrado, sem repetidos, pela ordem em que\n * foram lidos; vazio se não houver nenhum ou se o ficheiro não se puder ler.\n * Depois de encontrar o que procura, faz ainda uma passagem para recolher os\n * outros códigos da página (ex: QR do banco ao lado do QR fiscal).\n */\nexport async function scanQRCodes(file: File, options: ScanQRCodesOptions = {}): Promise<string[]> {\n  const until = options.until ?? (() => true)\n  const { QrScanner, readBarcodes, zxingJs } = await loadEngines()\n\n  let source: Blob = file\n  if (file.type === 'application/pdf') {\n    try {\n      source = await renderPdfFirstPage(file)\n    } catch {\n      return []\n    }\n  }\n\n  const codes: string[] = []\n  const add = (text: string | null | undefined) => {\n    if (text && !codes.includes(text)) codes.push(text)\n  }\n  const done = () => codes.some(until)\n\n  const qrScanner = async (input: Blob | HTMLCanvasElement) => {\n    try {\n      add((await QrScanner.scanImage(input, { returnDetailedScanResult: true })).data)\n    } catch {\n      /* nada encontrado */\n    }\n  }\n  // O único motor que devolve todos os códigos da imagem. `all`: correr todas as\n  // estratégias e juntar o que cada uma encontra (uma pode ver um código e falhar outro).\n  const zxingWasm = async (input: Blob | ImageData, all = false) => {\n    for (const binarizer of BINARIZERS) {\n      try {\n        const texts = (await readBarcodes(input, { formats: ['QRCode'], tryHarder: true, tryDenoise: true, binarizer }))\n          .filter((r) => r.isValid)\n          .map((r) => r.text)\n        texts.forEach(add)\n        if (texts.length && !all) return\n      } catch {\n        /* estratégia seguinte */\n      }\n    }\n  }\n  const zxingJsDecode = (canvas: HTMLCanvasElement) => {\n    try {\n      const { data, width, height } = pixels(canvas)\n      const bitmap = new zxingJs.BinaryBitmap(new zxingJs.HybridBinarizer(new zxingJs.RGBLuminanceSource(data, width, height)))\n      add(new zxingJs.MultiFormatReader().decode(bitmap).getText())\n    } catch {\n      /* nada encontrado */\n    }\n  }\n\n  let upscaled: HTMLCanvasElement | null = null\n  const collectRemaining = async () => {\n    await zxingWasm(source, true)\n    upscaled ??= await drawVariant(source).catch(() => null)\n    if (upscaled) await zxingWasm(pixels(upscaled), true)\n    return codes\n  }\n\n  try {\n    // 1–2. Original: o mais rápido primeiro.\n    await qrScanner(source)\n    if (done()) return collectRemaining()\n    await zxingWasm(source)\n    if (done()) return collectRemaining()\n\n    // 3. Ampliada (cores intactas): ajuda nas miniaturas.\n    upscaled = await drawVariant(source)\n    await qrScanner(upscaled)\n    if (done()) return collectRemaining()\n    await zxingWasm(pixels(upscaled))\n    if (done()) return collectRemaining()\n    zxingJsDecode(upscaled)\n    if (done()) return collectRemaining()\n\n    // 4. Ampliada a cinzento com contraste: para imagens difíceis.\n    for (const contrast of [2.5, 5]) {\n      const canvas = await drawVariant(source, contrast)\n      await qrScanner(canvas)\n      if (done()) return collectRemaining()\n      await zxingWasm(pixels(canvas))\n      if (done()) return collectRemaining()\n      zxingJsDecode(canvas)\n      if (done()) return collectRemaining()\n    }\n  } catch {\n    // Imagem ilegível: devolve o que já tiver encontrado.\n    return codes\n  }\n\n  return codes.length ? collectRemaining() : codes\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/v1/capabilities/overlay/useFloatingPanel.js

@@ -0,0 +1,52 @@
+import { useState, useRef, useCallback, useLayoutEffect, useEffect } from "react";
+const PANEL_CLASS = "fixed z-[60] min-w-[10rem] max-h-72 overflow-auto rounded-xl border border-slate-200 bg-white py-1 text-sm shadow-lg dark:border-slate-700 dark:bg-slate-900";
+const itemClass = (active, danger = false) => `w-full flex items-center gap-2.5 px-3 py-2 text-left cursor-pointer select-none ${danger ? "text-red-600 dark:text-red-300" : "text-slate-700 dark:text-slate-200"} ${active ? "bg-slate-100 dark:bg-slate-800" : "bg-transparent hover:bg-slate-50 dark:hover:bg-slate-800"}`;
+function useFloatingPanel(align = "left") {
+  const [open, setOpen] = useState(false);
+  const triggerRef = useRef(null);
+  const panelRef = useRef(null);
+  const [pos, setPos] = useState(null);
+  const close = useCallback(() => setOpen(false), []);
+  useLayoutEffect(() => {
+    if (!open || !triggerRef.current) {
+      setPos(null);
+      return;
+    }
+    const r = triggerRef.current.getBoundingClientRect();
+    const height = panelRef.current?.offsetHeight ?? 240;
+    const horizontal = align === "right" ? { right: window.innerWidth - r.right } : { left: r.left };
+    const fitsBelow = r.bottom + 4 + height <= window.innerHeight - 8;
+    setPos({
+      ...horizontal,
+      minWidth: r.width,
+      ...fitsBelow || r.top < height ? { top: r.bottom + 4 } : { bottom: window.innerHeight - r.top + 4 }
+    });
+  }, [open, align]);
+  useEffect(() => {
+    if (!open) return;
+    const click = (e) => {
+      const t = e.target;
+      if (!triggerRef.current?.contains(t) && !panelRef.current?.contains(t)) setOpen(false);
+    };
+    const scroll = (e) => {
+      if (!panelRef.current?.contains(e.target)) setOpen(false);
+    };
+    const resize = () => setOpen(false);
+    document.addEventListener("mousedown", click);
+    window.addEventListener("scroll", scroll, true);
+    window.addEventListener("resize", resize);
+    return () => {
+      document.removeEventListener("mousedown", click);
+      window.removeEventListener("scroll", scroll, true);
+      window.removeEventListener("resize", resize);
+    };
+  }, [open]);
+  const style = pos ?? { top: 0, left: 0, visibility: "hidden" };
+  return { open, setOpen, close, triggerRef, panelRef, style };
+}
+export {
+  PANEL_CLASS,
+  itemClass,
+  useFloatingPanel
+};
+//# sourceMappingURL=useFloatingPanel.js.map

package/dist/esm/v1/capabilities/overlay/useFloatingPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFloatingPanel.js","sources":["../../../../../src/v1/capabilities/overlay/useFloatingPanel.ts"],"sourcesContent":["import { useCallback, useEffect, useLayoutEffect, useRef, useState, type CSSProperties } from 'react'\r\n\r\n/**\r\n * Aspeto comum das listas suspensas (SelectInput, MenuAcoes): cartão arredondado com sombra, nos dois temas.\r\n * Um só sítio para ficarem iguais.\r\n */\r\nexport const PANEL_CLASS =\r\n  'fixed z-[60] min-w-[10rem] max-h-72 overflow-auto rounded-xl border border-slate-200 bg-white py-1 text-sm shadow-lg dark:border-slate-700 dark:bg-slate-900'\r\n\r\n/** Item de uma lista suspensa; `active` = o que o teclado tem selecionado. */\r\nexport const itemClass = (active: boolean, danger = false) =>\r\n  `w-full flex items-center gap-2.5 px-3 py-2 text-left cursor-pointer select-none ${\r\n    danger ? 'text-red-600 dark:text-red-300' : 'text-slate-700 dark:text-slate-200'\r\n  } ${active ? 'bg-slate-100 dark:bg-slate-800' : 'bg-transparent hover:bg-slate-50 dark:hover:bg-slate-800'}`\r\n\r\n/**\r\n * Painel flutuante preso a um botão: posição fixa (não é cortado por tabelas ou janelas com scroll), abre para\r\n * cima quando não cabe por baixo, fecha ao clicar fora, ao fazer scroll fora dele ou ao redimensionar.\r\n */\r\nexport function useFloatingPanel(align: 'left' | 'right' = 'left') {\r\n  const [open, setOpen] = useState(false)\r\n  const triggerRef = useRef<HTMLButtonElement>(null)\r\n  const panelRef = useRef<HTMLDivElement>(null)\r\n  const [pos, setPos] = useState<CSSProperties | null>(null)\r\n\r\n  const close = useCallback(() => setOpen(false), [])\r\n\r\n  useLayoutEffect(() => {\r\n    if (!open || !triggerRef.current) {\r\n      setPos(null)\r\n      return\r\n    }\r\n    const r = triggerRef.current.getBoundingClientRect()\r\n    const height = panelRef.current?.offsetHeight ?? 240\r\n    const horizontal = align === 'right' ? { right: window.innerWidth - r.right } : { left: r.left }\r\n    const fitsBelow = r.bottom + 4 + height <= window.innerHeight - 8\r\n    setPos({\r\n      ...horizontal,\r\n      minWidth: r.width,\r\n      ...(fitsBelow || r.top < height ? { top: r.bottom + 4 } : { bottom: window.innerHeight - r.top + 4 }),\r\n    })\r\n  }, [open, align])\r\n\r\n  useEffect(() => {\r\n    if (!open) return\r\n    const click = (e: MouseEvent) => {\r\n      const t = e.target as Node\r\n      if (!triggerRef.current?.contains(t) && !panelRef.current?.contains(t)) setOpen(false)\r\n    }\r\n    const scroll = (e: Event) => {\r\n      if (!panelRef.current?.contains(e.target as Node)) setOpen(false)\r\n    }\r\n    const resize = () => setOpen(false)\r\n    document.addEventListener('mousedown', click)\r\n    window.addEventListener('scroll', scroll, true)\r\n    window.addEventListener('resize', resize)\r\n    return () => {\r\n      document.removeEventListener('mousedown', click)\r\n      window.removeEventListener('scroll', scroll, true)\r\n      window.removeEventListener('resize', resize)\r\n    }\r\n  }, [open])\r\n\r\n  // Antes de medir, o painel desenha-se invisível (para se saber a altura).\r\n  const style: CSSProperties = pos ?? { top: 0, left: 0, visibility: 'hidden' }\r\n  return { open, setOpen, close, triggerRef, panelRef, style }\r\n}\r\n"],"names":[],"mappings":";AAMO,MAAM,cACX;AAGK,MAAM,YAAY,CAAC,QAAiB,SAAS,UAClD,mFACE,SAAS,mCAAmC,oCAC9C,IAAI,SAAS,mCAAmC,0DAA0D;AAMrG,SAAS,iBAAiB,QAA0B,QAAQ;AACjE,QAAM,CAAC,MAAM,OAAO,IAAI,SAAS,KAAK;AACtC,QAAM,aAAa,OAA0B,IAAI;AACjD,QAAM,WAAW,OAAuB,IAAI;AAC5C,QAAM,CAAC,KAAK,MAAM,IAAI,SAA+B,IAAI;AAEzD,QAAM,QAAQ,YAAY,MAAM,QAAQ,KAAK,GAAG,CAAA,CAAE;AAElD,kBAAgB,MAAM;AACpB,QAAI,CAAC,QAAQ,CAAC,WAAW,SAAS;AAChC,aAAO,IAAI;AACX;AAAA,IACF;AACA,UAAM,IAAI,WAAW,QAAQ,sBAAA;AAC7B,UAAM,SAAS,SAAS,SAAS,gBAAgB;AACjD,UAAM,aAAa,UAAU,UAAU,EAAE,OAAO,OAAO,aAAa,EAAE,MAAA,IAAU,EAAE,MAAM,EAAE,KAAA;AAC1F,UAAM,YAAY,EAAE,SAAS,IAAI,UAAU,OAAO,cAAc;AAChE,WAAO;AAAA,MACL,GAAG;AAAA,MACH,UAAU,EAAE;AAAA,MACZ,GAAI,aAAa,EAAE,MAAM,SAAS,EAAE,KAAK,EAAE,SAAS,EAAA,IAAM,EAAE,QAAQ,OAAO,cAAc,EAAE,MAAM,EAAA;AAAA,IAAE,CACpG;AAAA,EACH,GAAG,CAAC,MAAM,KAAK,CAAC;AAEhB,YAAU,MAAM;AACd,QAAI,CAAC,KAAM;AACX,UAAM,QAAQ,CAAC,MAAkB;AAC/B,YAAM,IAAI,EAAE;AACZ,UAAI,CAAC,WAAW,SAAS,SAAS,CAAC,KAAK,CAAC,SAAS,SAAS,SAAS,CAAC,WAAW,KAAK;AAAA,IACvF;AACA,UAAM,SAAS,CAAC,MAAa;AAC3B,UAAI,CAAC,SAAS,SAAS,SAAS,EAAE,MAAc,WAAW,KAAK;AAAA,IAClE;AACA,UAAM,SAAS,MAAM,QAAQ,KAAK;AAClC,aAAS,iBAAiB,aAAa,KAAK;AAC5C,WAAO,iBAAiB,UAAU,QAAQ,IAAI;AAC9C,WAAO,iBAAiB,UAAU,MAAM;AACxC,WAAO,MAAM;AACX,eAAS,oBAAoB,aAAa,KAAK;AAC/C,aAAO,oBAAoB,UAAU,QAAQ,IAAI;AACjD,aAAO,oBAAoB,UAAU,MAAM;AAAA,IAC7C;AAAA,EACF,GAAG,CAAC,IAAI,CAAC;AAGT,QAAM,QAAuB,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,YAAY,SAAA;AACnE,SAAO,EAAE,MAAM,SAAS,OAAO,YAAY,UAAU,MAAA;AACvD;"}

package/dist/esm/v1/capabilities/theme/useIsDark.js

@@ -0,0 +1,15 @@
+import { useState, useEffect } from "react";
+function useIsDark() {
+  const [isDark, setIsDark] = useState(() => typeof document !== "undefined" && document.documentElement.classList.contains("dark"));
+  useEffect(() => {
+    const el = document.documentElement;
+    const obs = new MutationObserver(() => setIsDark(el.classList.contains("dark")));
+    obs.observe(el, { attributes: true, attributeFilter: ["class"] });
+    return () => obs.disconnect();
+  }, []);
+  return isDark;
+}
+export {
+  useIsDark
+};
+//# sourceMappingURL=useIsDark.js.map

package/dist/esm/v1/capabilities/theme/useIsDark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsDark.js","sources":["../../../../../src/v1/capabilities/theme/useIsDark.ts"],"sourcesContent":["import { useEffect, useState } from 'react'\r\n\r\n/**\r\n * Se a app está em escuro agora (a classe `.dark` no `<html>`), e muda quando o\r\n * tema muda.\r\n *\r\n * Para o que não pode usar o `dark:` do Tailwind e precisa das cores em\r\n * JavaScript: gráficos, `<iframe>`, SVG com cores por props. O componente volta\r\n * a desenhar quando o tema muda.\r\n */\r\nexport function useIsDark(): boolean {\r\n  const [isDark, setIsDark] = useState(() => typeof document !== 'undefined' && document.documentElement.classList.contains('dark'))\r\n  useEffect(() => {\r\n    const el = document.documentElement\r\n    const obs = new MutationObserver(() => setIsDark(el.classList.contains('dark')))\r\n    obs.observe(el, { attributes: true, attributeFilter: ['class'] })\r\n    return () => obs.disconnect()\r\n  }, [])\r\n  return isDark\r\n}\r\n\r\nexport default useIsDark\r\n"],"names":[],"mappings":";AAUO,SAAS,YAAqB;AACnC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAS,MAAM,OAAO,aAAa,eAAe,SAAS,gBAAgB,UAAU,SAAS,MAAM,CAAC;AACjI,YAAU,MAAM;AACd,UAAM,KAAK,SAAS;AACpB,UAAM,MAAM,IAAI,iBAAiB,MAAM,UAAU,GAAG,UAAU,SAAS,MAAM,CAAC,CAAC;AAC/E,QAAI,QAAQ,IAAI,EAAE,YAAY,MAAM,iBAAiB,CAAC,OAAO,GAAG;AAChE,WAAO,MAAM,IAAI,WAAA;AAAA,EACnB,GAAG,CAAA,CAAE;AACL,SAAO;AACT;"}

package/dist/esm/v1/capabilities/theme/useTheme.js

@@ -0,0 +1,66 @@
+import { useState, useEffect, useCallback } from "react";
+const THEME_STORAGE_KEY = "theme";
+const LEGACY_KEY = "proef-theme";
+const isTheme = (v) => v === "light" || v === "dark" || v === "system";
+function readStored() {
+  try {
+    const v = localStorage.getItem(THEME_STORAGE_KEY);
+    if (isTheme(v)) return v;
+    const old = localStorage.getItem(LEGACY_KEY);
+    return isTheme(old) ? old : null;
+  } catch {
+    return null;
+  }
+}
+function persist(theme) {
+  try {
+    localStorage.setItem(THEME_STORAGE_KEY, theme);
+  } catch {
+  }
+}
+const systemPrefersDark = () => typeof window !== "undefined" && window.matchMedia?.("(prefers-color-scheme: dark)").matches;
+function applyTheme(theme) {
+  if (typeof document === "undefined") return;
+  document.documentElement.classList.toggle("dark", theme === "dark" || theme === "system" && systemPrefersDark());
+}
+const themeBootScript = `(function(){try{var k='${THEME_STORAGE_KEY}',o='${LEGACY_KEY}',v=localStorage.getItem(k)||localStorage.getItem(o)||'system';if(v==='dark'||(v==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches))document.documentElement.classList.add('dark')}catch(e){}})();`;
+const ORDER = ["system", "light", "dark"];
+function useTheme() {
+  const [theme, setThemeState] = useState(() => readStored() ?? "system");
+  useEffect(() => {
+    applyTheme(theme);
+  }, [theme]);
+  useEffect(() => {
+    if (theme !== "system" || typeof window === "undefined" || !window.matchMedia) return;
+    const mq = window.matchMedia("(prefers-color-scheme: dark)");
+    const onChange = () => applyTheme("system");
+    mq.addEventListener("change", onChange);
+    return () => mq.removeEventListener("change", onChange);
+  }, [theme]);
+  useEffect(() => {
+    const onStorage = (e) => {
+      if (e.key === THEME_STORAGE_KEY) setThemeState(readStored() ?? "system");
+    };
+    window.addEventListener("storage", onStorage);
+    return () => window.removeEventListener("storage", onStorage);
+  }, []);
+  const setTheme = useCallback((t) => {
+    persist(t);
+    setThemeState(t);
+  }, []);
+  const cycle = useCallback(() => {
+    setThemeState((prev) => {
+      const next = ORDER[(ORDER.indexOf(prev) + 1) % ORDER.length];
+      persist(next);
+      return next;
+    });
+  }, []);
+  return { theme, setTheme, cycle };
+}
+export {
+  THEME_STORAGE_KEY,
+  applyTheme,
+  themeBootScript,
+  useTheme
+};
+//# sourceMappingURL=useTheme.js.map

package/dist/esm/v1/capabilities/theme/useTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTheme.js","sources":["../../../../../src/v1/capabilities/theme/useTheme.ts"],"sourcesContent":["import { useCallback, useEffect, useState } from 'react'\r\n\r\nexport type Theme = 'light' | 'dark' | 'system'\r\n\r\n/** Chave da escolha no localStorage. A mesma nos portais (Tickets, AuditoriasIT). */\r\nexport const THEME_STORAGE_KEY = 'theme'\r\n/** Chave antiga do `useTheme` legacy: lida só quando a nova ainda não existe. */\r\nconst LEGACY_KEY = 'proef-theme'\r\n\r\nconst isTheme = (v: string | null): v is Theme => v === 'light' || v === 'dark' || v === 'system'\r\n\r\n/** A escolha guardada, ou `null` se não houver (ou o storage estiver bloqueado). */\r\nfunction readStored(): Theme | null {\r\n  try {\r\n    const v = localStorage.getItem(THEME_STORAGE_KEY)\r\n    if (isTheme(v)) return v\r\n    const old = localStorage.getItem(LEGACY_KEY)\r\n    return isTheme(old) ? old : null\r\n  } catch {\r\n    return null\r\n  }\r\n}\r\n\r\nfunction persist(theme: Theme) {\r\n  try {\r\n    localStorage.setItem(THEME_STORAGE_KEY, theme)\r\n  } catch {\r\n    // Sem storage (ex: janela privada): o tema aplica-se só nesta sessão.\r\n  }\r\n}\r\n\r\nconst systemPrefersDark = () => typeof window !== 'undefined' && window.matchMedia?.('(prefers-color-scheme: dark)').matches\r\n\r\n/** Põe ou tira a classe `.dark` no `<html>`: é a ela que os componentes e os tokens reagem. */\r\nexport function applyTheme(theme: Theme) {\r\n  if (typeof document === 'undefined') return\r\n  document.documentElement.classList.toggle('dark', theme === 'dark' || (theme === 'system' && systemPrefersDark()))\r\n}\r\n\r\n/**\r\n * Script para pôr no `<head>` do `index.html`, antes do CSS: aplica o tema\r\n * guardado antes da primeira pintura (sem o clarão branco ao abrir em escuro).\r\n *\r\n * O build também o põe em `dist/theme-boot.js`, para a app o injetar no\r\n * `index.html` sem o copiar (ex: num plugin `transformIndexHtml` do Vite).\r\n */\r\nexport const themeBootScript = `(function(){try{var k='${THEME_STORAGE_KEY}',o='${LEGACY_KEY}',v=localStorage.getItem(k)||localStorage.getItem(o)||'system';if(v==='dark'||(v==='system'&&window.matchMedia('(prefers-color-scheme: dark)').matches))document.documentElement.classList.add('dark')}catch(e){}})();`\r\n\r\nconst ORDER: Theme[] = ['system', 'light', 'dark']\r\n\r\n/**\r\n * Tema da app: claro, escuro ou o do sistema. Guarda a escolha (sozinho, a cada\r\n * mudança), aplica a classe `.dark` no `<html>`, segue o sistema em `system` e\r\n * acompanha a escolha feita noutro separador.\r\n *\r\n *   const { theme, setTheme } = useTheme()\r\n *   <AppShell theme={theme} onThemeChange={setTheme} …/>\r\n *\r\n * Para não haver clarão ao abrir, pôr o `themeBootScript` no `index.html`.\r\n */\r\nexport function useTheme(): { theme: Theme; setTheme: (t: Theme) => void; cycle: () => void } {\r\n  const [theme, setThemeState] = useState<Theme>(() => readStored() ?? 'system')\r\n\r\n  useEffect(() => {\r\n    applyTheme(theme)\r\n  }, [theme])\r\n\r\n  // Em `system`, segue as mudanças do sistema ao vivo.\r\n  useEffect(() => {\r\n    if (theme !== 'system' || typeof window === 'undefined' || !window.matchMedia) return\r\n    const mq = window.matchMedia('(prefers-color-scheme: dark)')\r\n    const onChange = () => applyTheme('system')\r\n    mq.addEventListener('change', onChange)\r\n    return () => mq.removeEventListener('change', onChange)\r\n  }, [theme])\r\n\r\n  // A escolha feita noutro separador ou janela.\r\n  useEffect(() => {\r\n    const onStorage = (e: StorageEvent) => {\r\n      if (e.key === THEME_STORAGE_KEY) setThemeState(readStored() ?? 'system')\r\n    }\r\n    window.addEventListener('storage', onStorage)\r\n    return () => window.removeEventListener('storage', onStorage)\r\n  }, [])\r\n\r\n  const setTheme = useCallback((t: Theme) => {\r\n    persist(t)\r\n    setThemeState(t)\r\n  }, [])\r\n\r\n  const cycle = useCallback(() => {\r\n    setThemeState((prev) => {\r\n      const next = ORDER[(ORDER.indexOf(prev) + 1) % ORDER.length]\r\n      persist(next)\r\n      return next\r\n    })\r\n  }, [])\r\n\r\n  return { theme, setTheme, cycle }\r\n}\r\n\r\nexport default useTheme\r\n"],"names":[],"mappings":";AAKO,MAAM,oBAAoB;AAEjC,MAAM,aAAa;AAEnB,MAAM,UAAU,CAAC,MAAiC,MAAM,WAAW,MAAM,UAAU,MAAM;AAGzF,SAAS,aAA2B;AAClC,MAAI;AACF,UAAM,IAAI,aAAa,QAAQ,iBAAiB;AAChD,QAAI,QAAQ,CAAC,EAAG,QAAO;AACvB,UAAM,MAAM,aAAa,QAAQ,UAAU;AAC3C,WAAO,QAAQ,GAAG,IAAI,MAAM;AAAA,EAC9B,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,QAAQ,OAAc;AAC7B,MAAI;AACF,iBAAa,QAAQ,mBAAmB,KAAK;AAAA,EAC/C,QAAQ;AAAA,EAER;AACF;AAEA,MAAM,oBAAoB,MAAM,OAAO,WAAW,eAAe,OAAO,aAAa,8BAA8B,EAAE;AAG9G,SAAS,WAAW,OAAc;AACvC,MAAI,OAAO,aAAa,YAAa;AACrC,WAAS,gBAAgB,UAAU,OAAO,QAAQ,UAAU,UAAW,UAAU,YAAY,mBAAoB;AACnH;AASO,MAAM,kBAAkB,0BAA0B,iBAAiB,QAAQ,UAAU;AAE5F,MAAM,QAAiB,CAAC,UAAU,SAAS,MAAM;AAY1C,SAAS,WAA8E;AAC5F,QAAM,CAAC,OAAO,aAAa,IAAI,SAAgB,MAAM,WAAA,KAAgB,QAAQ;AAE7E,YAAU,MAAM;AACd,eAAW,KAAK;AAAA,EAClB,GAAG,CAAC,KAAK,CAAC;AAGV,YAAU,MAAM;AACd,QAAI,UAAU,YAAY,OAAO,WAAW,eAAe,CAAC,OAAO,WAAY;AAC/E,UAAM,KAAK,OAAO,WAAW,8BAA8B;AAC3D,UAAM,WAAW,MAAM,WAAW,QAAQ;AAC1C,OAAG,iBAAiB,UAAU,QAAQ;AACtC,WAAO,MAAM,GAAG,oBAAoB,UAAU,QAAQ;AAAA,EACxD,GAAG,CAAC,KAAK,CAAC;AAGV,YAAU,MAAM;AACd,UAAM,YAAY,CAAC,MAAoB;AACrC,UAAI,EAAE,QAAQ,kBAAmB,eAAc,WAAA,KAAgB,QAAQ;AAAA,IACzE;AACA,WAAO,iBAAiB,WAAW,SAAS;AAC5C,WAAO,MAAM,OAAO,oBAAoB,WAAW,SAAS;AAAA,EAC9D,GAAG,CAAA,CAAE;AAEL,QAAM,WAAW,YAAY,CAAC,MAAa;AACzC,YAAQ,CAAC;AACT,kBAAc,CAAC;AAAA,EACjB,GAAG,CAAA,CAAE;AAEL,QAAM,QAAQ,YAAY,MAAM;AAC9B,kBAAc,CAAC,SAAS;AACtB,YAAM,OAAO,OAAO,MAAM,QAAQ,IAAI,IAAI,KAAK,MAAM,MAAM;AAC3D,cAAQ,IAAI;AACZ,aAAO;AAAA,IACT,CAAC;AAAA,EACH,GAAG,CAAA,CAAE;AAEL,SAAO,EAAE,OAAO,UAAU,MAAA;AAC5B;"}

package/dist/esm/v1/components/data/Pagination/Pagination.js

@@ -0,0 +1,66 @@
+import { jsxs, Fragment, jsx } from "react/jsx-runtime";
+import Button from "../../../primitives/buttons/Button/Button.js";
+import { SelectInput } from "../../../primitives/forms/SelectInput/SelectInput.js";
+const DEFAULT_PAGINATION_LABELS = {
+  page: "Page {page} of {pages}",
+  total: "{count} results",
+  perPage: "Per page",
+  prev: "Previous",
+  next: "Next"
+};
+function ChevronLeft() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": true, viewBox: "0 0 24 24", width: 13, height: 13, fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx("path", { d: "m15 18-6-6 6-6" }) });
+}
+function ChevronRight() {
+  return /* @__PURE__ */ jsx("svg", { "aria-hidden": true, viewBox: "0 0 24 24", width: 12, height: 12, fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", children: /* @__PURE__ */ jsx("path", { d: "m9 18 6-6-6-6" }) });
+}
+function Pagination({
+  page,
+  pages,
+  onPageChange,
+  total,
+  pageSize,
+  pageSizeOptions,
+  onPageSizeChange,
+  labels,
+  className = ""
+}) {
+  const L = { ...DEFAULT_PAGINATION_LABELS, ...labels };
+  const totalPaginas = Math.max(1, pages);
+  const opcoes = pageSizeOptions && pageSize != null ? [.../* @__PURE__ */ new Set([...pageSizeOptions, pageSize])].sort((a, b) => a - b) : [];
+  return /* @__PURE__ */ jsxs("nav", { "aria-label": L.page.replace("{page}", String(page)).replace("{pages}", String(totalPaginas)), className: `flex flex-wrap items-center justify-between gap-2 ${className}`, children: [
+    /* @__PURE__ */ jsxs("span", { className: "text-[10px] font-black uppercase tracking-widest text-muted-foreground", children: [
+      total != null && /* @__PURE__ */ jsxs(Fragment, { children: [
+        L.total.replace("{count}", total.toLocaleString()),
+        " · "
+      ] }),
+      L.page.replace("{page}", String(page)).replace("{pages}", String(totalPaginas))
+    ] }),
+    /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap items-center gap-1.5", children: [
+      opcoes.length > 0 && onPageSizeChange && /* @__PURE__ */ jsxs("label", { className: "mr-2 flex items-center gap-1.5 text-[10px] font-black uppercase tracking-widest text-muted-foreground", children: [
+        L.perPage,
+        /* @__PURE__ */ jsx(
+          SelectInput,
+          {
+            "aria-label": L.perPage,
+            value: String(pageSize),
+            onChange: (e) => onPageSizeChange(Number(e.target.value)),
+            className: "w-20 normal-case tracking-normal font-normal",
+            children: opcoes.map((n) => /* @__PURE__ */ jsx("option", { value: n, children: n }, n))
+          }
+        )
+      ] }),
+      /* @__PURE__ */ jsx(Button, { variant: "secondary", size: "sm", icon: /* @__PURE__ */ jsx(ChevronLeft, {}), disabled: page <= 1, onClick: () => onPageChange(page - 1), children: L.prev }),
+      /* @__PURE__ */ jsxs(Button, { variant: "secondary", size: "sm", disabled: page >= totalPaginas, onClick: () => onPageChange(page + 1), children: [
+        L.next,
+        /* @__PURE__ */ jsx(ChevronRight, {})
+      ] })
+    ] })
+  ] });
+}
+export {
+  DEFAULT_PAGINATION_LABELS,
+  Pagination,
+  Pagination as default
+};
+//# sourceMappingURL=Pagination.js.map

package/dist/esm/v1/components/data/Pagination/Pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pagination.js","sources":["../../../../../../src/v1/components/data/Pagination/Pagination.tsx"],"sourcesContent":["import React from 'react'\r\nimport Button from '../../../primitives/buttons/Button/Button'\r\nimport SelectInput from '../../../primitives/forms/SelectInput/SelectInput'\r\n\r\nexport interface PaginationLabels {\r\n  /** \"{page}\" e \"{pages}\" são substituídos (ex: \"Página {page} de {pages}\"). */\r\n  page: string\r\n  /** \"{count}\" é substituído pelo total de registos (ex: \"{count} resultados\"). */\r\n  total: string\r\n  perPage: string\r\n  prev: string\r\n  next: string\r\n}\r\n\r\nexport const DEFAULT_PAGINATION_LABELS: PaginationLabels = {\r\n  page: 'Page {page} of {pages}',\r\n  total: '{count} results',\r\n  perPage: 'Per page',\r\n  prev: 'Previous',\r\n  next: 'Next',\r\n}\r\n\r\nexport interface PaginationProps {\r\n  /** Página atual, a contar de 1. */\r\n  page: number\r\n  /** Número de páginas. */\r\n  pages: number\r\n  onPageChange: (page: number) => void\r\n  /** Total de registos (mostrado à esquerda). */\r\n  total?: number\r\n  /** Registos por página e as opções do seletor (sem opções, não há seletor). */\r\n  pageSize?: number\r\n  pageSizeOptions?: number[]\r\n  onPageSizeChange?: (size: number) => void\r\n  labels?: Partial<PaginationLabels>\r\n  className?: string\r\n}\r\n\r\nfunction ChevronLeft() {\r\n  return (\r\n    <svg aria-hidden viewBox=\"0 0 24 24\" width={13} height={13} fill=\"none\" stroke=\"currentColor\" strokeWidth={2} strokeLinecap=\"round\" strokeLinejoin=\"round\">\r\n      <path d=\"m15 18-6-6 6-6\" />\r\n    </svg>\r\n  )\r\n}\r\n\r\nfunction ChevronRight() {\r\n  return (\r\n    <svg aria-hidden viewBox=\"0 0 24 24\" width={12} height={12} fill=\"none\" stroke=\"currentColor\" strokeWidth={2} strokeLinecap=\"round\" strokeLinejoin=\"round\">\r\n      <path d=\"m9 18 6-6-6-6\" />\r\n    </svg>\r\n  )\r\n}\r\n\r\n/**\r\n * Paginação por baixo de uma lista: \"Página 1 de 4\", o total, quantos por página e\r\n * Anterior/Seguinte. É a mesma que a `DataTable` mostra; usar esta quando a app pagina\r\n * no servidor (a tabela recebe só a página atual).\r\n */\r\nexport default function Pagination({\r\n  page,\r\n  pages,\r\n  onPageChange,\r\n  total,\r\n  pageSize,\r\n  pageSizeOptions,\r\n  onPageSizeChange,\r\n  labels,\r\n  className = '',\r\n}: PaginationProps) {\r\n  const L = { ...DEFAULT_PAGINATION_LABELS, ...labels }\r\n  const totalPaginas = Math.max(1, pages)\r\n  const opcoes = pageSizeOptions && pageSize != null ? [...new Set([...pageSizeOptions, pageSize])].sort((a, b) => a - b) : []\r\n  return (\r\n    <nav aria-label={L.page.replace('{page}', String(page)).replace('{pages}', String(totalPaginas))} className={`flex flex-wrap items-center justify-between gap-2 ${className}`}>\r\n      <span className=\"text-[10px] font-black uppercase tracking-widest text-muted-foreground\">\r\n        {total != null && <>{L.total.replace('{count}', total.toLocaleString())} · </>}\r\n        {L.page.replace('{page}', String(page)).replace('{pages}', String(totalPaginas))}\r\n      </span>\r\n      <div className=\"flex flex-wrap items-center gap-1.5\">\r\n        {opcoes.length > 0 && onPageSizeChange && (\r\n          <label className=\"mr-2 flex items-center gap-1.5 text-[10px] font-black uppercase tracking-widest text-muted-foreground\">\r\n            {L.perPage}\r\n            <SelectInput\r\n              aria-label={L.perPage}\r\n              value={String(pageSize)}\r\n              onChange={(e) => onPageSizeChange(Number(e.target.value))}\r\n              className=\"w-20 normal-case tracking-normal font-normal\"\r\n            >\r\n              {opcoes.map((n) => (\r\n                <option key={n} value={n}>\r\n                  {n}\r\n                </option>\r\n              ))}\r\n            </SelectInput>\r\n          </label>\r\n        )}\r\n        <Button variant=\"secondary\" size=\"sm\" icon={<ChevronLeft />} disabled={page <= 1} onClick={() => onPageChange(page - 1)}>\r\n          {L.prev}\r\n        </Button>\r\n        <Button variant=\"secondary\" size=\"sm\" disabled={page >= totalPaginas} onClick={() => onPageChange(page + 1)}>\r\n          {L.next}\r\n          <ChevronRight />\r\n        </Button>\r\n      </div>\r\n    </nav>\r\n  )\r\n}\r\n\r\nexport { Pagination }\r\n"],"names":[],"mappings":";;;AAcO,MAAM,4BAA8C;AAAA,EACzD,MAAM;AAAA,EACN,OAAO;AAAA,EACP,SAAS;AAAA,EACT,MAAM;AAAA,EACN,MAAM;AACR;AAkBA,SAAS,cAAc;AACrB,SACE,oBAAC,OAAA,EAAI,eAAW,MAAC,SAAQ,aAAY,OAAO,IAAI,QAAQ,IAAI,MAAK,QAAO,QAAO,gBAAe,aAAa,GAAG,eAAc,SAAQ,gBAAe,SACjJ,UAAA,oBAAC,QAAA,EAAK,GAAE,iBAAA,CAAiB,EAAA,CAC3B;AAEJ;AAEA,SAAS,eAAe;AACtB,SACE,oBAAC,OAAA,EAAI,eAAW,MAAC,SAAQ,aAAY,OAAO,IAAI,QAAQ,IAAI,MAAK,QAAO,QAAO,gBAAe,aAAa,GAAG,eAAc,SAAQ,gBAAe,SACjJ,UAAA,oBAAC,QAAA,EAAK,GAAE,gBAAA,CAAgB,EAAA,CAC1B;AAEJ;AAOA,SAAwB,WAAW;AAAA,EACjC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,YAAY;AACd,GAAoB;AAClB,QAAM,IAAI,EAAE,GAAG,2BAA2B,GAAG,OAAA;AAC7C,QAAM,eAAe,KAAK,IAAI,GAAG,KAAK;AACtC,QAAM,SAAS,mBAAmB,YAAY,OAAO,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAG,iBAAiB,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAA;AAC1H,SACE,qBAAC,SAAI,cAAY,EAAE,KAAK,QAAQ,UAAU,OAAO,IAAI,CAAC,EAAE,QAAQ,WAAW,OAAO,YAAY,CAAC,GAAG,WAAW,qDAAqD,SAAS,IACzK,UAAA;AAAA,IAAA,qBAAC,QAAA,EAAK,WAAU,0EACb,UAAA;AAAA,MAAA,SAAS,QAAQ,qBAAA,UAAA,EAAG,UAAA;AAAA,QAAA,EAAE,MAAM,QAAQ,WAAW,MAAM,gBAAgB;AAAA,QAAE;AAAA,MAAA,GAAG;AAAA,MAC1E,EAAE,KAAK,QAAQ,UAAU,OAAO,IAAI,CAAC,EAAE,QAAQ,WAAW,OAAO,YAAY,CAAC;AAAA,IAAA,GACjF;AAAA,IACA,qBAAC,OAAA,EAAI,WAAU,uCACZ,UAAA;AAAA,MAAA,OAAO,SAAS,KAAK,oBACpB,qBAAC,SAAA,EAAM,WAAU,yGACd,UAAA;AAAA,QAAA,EAAE;AAAA,QACH;AAAA,UAAC;AAAA,UAAA;AAAA,YACC,cAAY,EAAE;AAAA,YACd,OAAO,OAAO,QAAQ;AAAA,YACtB,UAAU,CAAC,MAAM,iBAAiB,OAAO,EAAE,OAAO,KAAK,CAAC;AAAA,YACxD,WAAU;AAAA,YAET,UAAA,OAAO,IAAI,CAAC,MACX,oBAAC,YAAe,OAAO,GACpB,UAAA,EAAA,GADU,CAEb,CACD;AAAA,UAAA;AAAA,QAAA;AAAA,MACH,GACF;AAAA,MAEF,oBAAC,UAAO,SAAQ,aAAY,MAAK,MAAK,0BAAO,aAAA,EAAY,GAAI,UAAU,QAAQ,GAAG,SAAS,MAAM,aAAa,OAAO,CAAC,GACnH,YAAE,MACL;AAAA,MACA,qBAAC,QAAA,EAAO,SAAQ,aAAY,MAAK,MAAK,UAAU,QAAQ,cAAc,SAAS,MAAM,aAAa,OAAO,CAAC,GACvG,UAAA;AAAA,QAAA,EAAE;AAAA,4BACF,cAAA,CAAA,CAAa;AAAA,MAAA,EAAA,CAChB;AAAA,IAAA,EAAA,CACF;AAAA,EAAA,GACF;AAEJ;"}