acai-ui 1.65.5

package/dist/index94.cjs

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const PROPRIEDADES_PINTURA = [
+  "fill",
+  "fill-opacity",
+  "fill-rule",
+  "stroke",
+  "stroke-width",
+  "stroke-opacity",
+  "stroke-dasharray",
+  "stroke-dashoffset",
+  "stroke-linecap",
+  "stroke-linejoin",
+  "stroke-miterlimit",
+  "opacity",
+  "display",
+  "visibility",
+  "color",
+  "font-family",
+  "font-size",
+  "font-style",
+  "font-weight",
+  "letter-spacing",
+  "text-anchor",
+  "dominant-baseline",
+  "paint-order"
+];
+const CLASSES_DESCARTADAS = ["acai-chart__foco"];
+function inlinarEstilos(origem, destino) {
+  const computado = window.getComputedStyle(origem);
+  let css = "";
+  for (const propriedade of PROPRIEDADES_PINTURA) {
+    const valor = computado.getPropertyValue(propriedade);
+    if (valor) css += `${propriedade}:${valor};`;
+  }
+  if (css) destino.setAttribute("style", css);
+  const filhosOrigem = origem.children;
+  const filhosDestino = destino.children;
+  for (let i = 0; i < filhosOrigem.length; i++) {
+    const filhoOrigem = filhosOrigem[i];
+    const filhoDestino = filhosDestino[i];
+    if (filhoOrigem && filhoDestino) inlinarEstilos(filhoOrigem, filhoDestino);
+  }
+}
+function serializarSvgChart(svg) {
+  const clone = svg.cloneNode(true);
+  inlinarEstilos(svg, clone);
+  for (const classe of CLASSES_DESCARTADAS) {
+    clone.querySelectorAll(`.${classe}`).forEach((el) => el.remove());
+  }
+  const caixa = svg.getBoundingClientRect();
+  const largura = Number(svg.getAttribute("width")) || caixa.width || 640;
+  const altura = Number(svg.getAttribute("height")) || caixa.height || 320;
+  clone.setAttribute("xmlns", "http://www.w3.org/2000/svg");
+  clone.setAttribute("xmlns:xlink", "http://www.w3.org/1999/xlink");
+  clone.setAttribute("width", String(largura));
+  clone.setAttribute("height", String(altura));
+  if (!clone.getAttribute("viewBox")) {
+    clone.setAttribute("viewBox", `0 0 ${largura} ${altura}`);
+  }
+  clone.removeAttribute("tabindex");
+  clone.removeAttribute("role");
+  return { texto: new XMLSerializer().serializeToString(clone), largura, altura };
+}
+function resolverCorCss(valor, contexto, reserva) {
+  const pai = contexto.parentElement ?? document.body;
+  const sonda = document.createElement("span");
+  sonda.style.cssText = `position:absolute;width:0;height:0;visibility:hidden;background-color:${valor}`;
+  pai.appendChild(sonda);
+  const resolvida = window.getComputedStyle(sonda).backgroundColor;
+  sonda.remove();
+  if (!resolvida || resolvida === "rgba(0, 0, 0, 0)" || resolvida === "transparent") {
+    return reserva;
+  }
+  return resolvida;
+}
+const TIMEOUT_MS = 8e3;
+function carregarImagem(dataUrl) {
+  return new Promise((resolver, rejeitar) => {
+    const img = new Image();
+    const relogio = setTimeout(() => {
+      rejeitar(new Error("acai-ui-chart: tempo esgotado ao rasterizar o SVG do gráfico."));
+    }, TIMEOUT_MS);
+    img.onload = () => {
+      clearTimeout(relogio);
+      resolver(img);
+    };
+    img.onerror = () => {
+      clearTimeout(relogio);
+      rejeitar(new Error("acai-ui-chart: o navegador recusou o SVG serializado do gráfico."));
+    };
+    img.src = dataUrl;
+  });
+}
+async function svgChartParaImagem(svg, opcoes = {}) {
+  if (typeof document === "undefined") {
+    throw new Error("acai-ui-chart: export de imagem exige navegador.");
+  }
+  const escala = Math.max(0.1, opcoes.escala ?? 2);
+  const fundo = opcoes.fundo === void 0 ? resolverCorCss("var(--acai-chart-surface)", svg, "#ffffff") : opcoes.fundo;
+  const { texto, largura, altura } = serializarSvgChart(svg);
+  const img = await carregarImagem(
+    `data:image/svg+xml;charset=utf-8,${encodeURIComponent(texto)}`
+  );
+  const canvas = document.createElement("canvas");
+  canvas.width = Math.max(1, Math.round(largura * escala));
+  canvas.height = Math.max(1, Math.round(altura * escala));
+  const ctx = canvas.getContext("2d");
+  if (!ctx) throw new Error("acai-ui-chart: canvas 2d indisponível.");
+  if (fundo) {
+    ctx.fillStyle = fundo;
+    ctx.fillRect(0, 0, canvas.width, canvas.height);
+  }
+  ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+  return {
+    dataUrl: canvas.toDataURL("image/png"),
+    largura,
+    altura,
+    proporcao: altura > 0 ? largura / altura : 1
+  };
+}
+exports.serializarSvgChart = serializarSvgChart;
+exports.svgChartParaImagem = svgChartParaImagem;
+//# sourceMappingURL=index94.cjs.map

package/dist/index94.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index94.cjs","sources":["../src/components/chart/chart-imagem.ts"],"sourcesContent":["// Export de imagem — SVG desenhado na tela → PNG (data URL).\n//\n// Existe porque gerador de relatório (Book/PDF) precisa da FIGURA, não do\n// componente: o jspdf recebe um `dataUrl` e o desenha na folha. Sem isto, um app\n// que já usa o `<acai-ui-chart>` na tela é obrigado a manter uma segunda lib de\n// gráfico só pra conseguir a imagem — e ficar com duas é pior que ficar com uma.\n//\n// ⚠️ A armadilha central: um `<img src=\"data:image/svg+xml,…\">` é um DOCUMENTO\n// SEPARADO. Ele não vê a folha de estilo da página, nem as custom properties\n// `--acai-*`, nem as classes `scoped` do componente. Serializar o SVG cru\n// produziria um retângulo com tudo preto (ou nada). Por isso todo estilo COMPUTADO\n// é inlinado no clone antes de serializar: é o que carrega a paleta já resolvida\n// para o tema em vigor (claro, escuro, daltônico ou alto contraste).\n\nexport interface OpcoesImagemChart {\n  /**\n   * Multiplicador de pixels. Default 2 — o PDF é impresso e 1× sai serrilhado.\n   * O `dataUrl` sai com `largura × escala` pixels, mas as dimensões devolvidas\n   * continuam em CSS px, que é o que o jspdf usa pra calcular a proporção.\n   */\n  escala?: number\n  /**\n   * Cor de fundo do PNG.\n   *\n   * Omitido, usa a **superfície do tema em vigor** (`--acai-chart-surface`) já\n   * resolvida — o que estava atrás do gráfico na tela. Não é preciosismo: o SVG é\n   * transparente, e no tema escuro a tinta do texto é CLARA. Chapar branco por\n   * padrão produziria texto claro sobre fundo branco, ilegível justamente no\n   * relatório, que é o único lugar onde ninguém vai reconferir.\n   *\n   * Passe `'#ffffff'` quando o destino é folha branca — e nesse caso gere o\n   * relatório com o tema claro, senão o gráfico não vai combinar com a página.\n   * `null` preserva a transparência.\n   */\n  fundo?: string | null\n}\n\nexport interface ImagemChart {\n  /** `data:image/png;base64,…` — pronto pro `jspdf.addImage`. */\n  dataUrl: string\n  /** Dimensões em CSS px (não multiplicadas pela escala). */\n  largura: number\n  altura: number\n  /** `largura / altura`. É o que o gerador de PDF usa pra encaixar na folha. */\n  proporcao: number\n}\n\n/**\n * Propriedades copiadas do estilo computado para o clone.\n *\n * Lista fechada de propósito: copiar o `cssText` inteiro do computado emitiria\n * ~340 declarações POR NÓ, e o data URL de um gráfico de 300 elementos passaria\n * de 1 MB — grande o bastante para o `<img>` engasgar. Aqui está só o que pinta.\n */\nconst PROPRIEDADES_PINTURA: readonly string[] = [\n  'fill',\n  'fill-opacity',\n  'fill-rule',\n  'stroke',\n  'stroke-width',\n  'stroke-opacity',\n  'stroke-dasharray',\n  'stroke-dashoffset',\n  'stroke-linecap',\n  'stroke-linejoin',\n  'stroke-miterlimit',\n  'opacity',\n  'display',\n  'visibility',\n  'color',\n  'font-family',\n  'font-size',\n  'font-style',\n  'font-weight',\n  'letter-spacing',\n  'text-anchor',\n  'dominant-baseline',\n  'paint-order',\n]\n\n/** Só na tela: o anel de foco não pode aparecer na figura do relatório. */\nconst CLASSES_DESCARTADAS = ['acai-chart__foco']\n\n/**\n * Copia o estilo computado da árvore ORIGINAL para a clonada, nó a nó.\n *\n * Percorre os dois em paralelo em vez de reconsultar o DOM: o clone está fora do\n * documento, então `getComputedStyle` nele devolveria valores iniciais — é o erro\n * que faz o export sair todo preto.\n */\nfunction inlinarEstilos(origem: Element, destino: Element): void {\n  const computado = window.getComputedStyle(origem)\n\n  let css = ''\n  for (const propriedade of PROPRIEDADES_PINTURA) {\n    const valor = computado.getPropertyValue(propriedade)\n    if (valor) css += `${propriedade}:${valor};`\n  }\n  if (css) destino.setAttribute('style', css)\n\n  const filhosOrigem = origem.children\n  const filhosDestino = destino.children\n  for (let i = 0; i < filhosOrigem.length; i++) {\n    const filhoOrigem = filhosOrigem[i]\n    const filhoDestino = filhosDestino[i]\n    if (filhoOrigem && filhoDestino) inlinarEstilos(filhoOrigem, filhoDestino)\n  }\n}\n\nexport interface SvgSerializado {\n  texto: string\n  largura: number\n  altura: number\n}\n\n/**\n * SVG autossuficiente: estilos resolvidos, namespace declarado e dimensões\n * explícitas. Serve tanto pro raster quanto pra quem quiser o `.svg` puro.\n */\nexport function serializarSvgChart(svg: SVGSVGElement): SvgSerializado {\n  const clone = svg.cloneNode(true) as SVGSVGElement\n  inlinarEstilos(svg, clone)\n\n  for (const classe of CLASSES_DESCARTADAS) {\n    clone.querySelectorAll(`.${classe}`).forEach((el) => el.remove())\n  }\n\n  const caixa = svg.getBoundingClientRect()\n  // O atributo vem do próprio componente (ele desenha 1:1, sem esticar viewBox);\n  // a caixa medida é a rede de segurança pra SVG sem atributo.\n  const largura = Number(svg.getAttribute('width')) || caixa.width || 640\n  const altura = Number(svg.getAttribute('height')) || caixa.height || 320\n\n  // Sem os namespaces o documento carregado pelo `<img>` não é SVG válido e o\n  // `onerror` dispara sem mensagem útil.\n  clone.setAttribute('xmlns', 'http://www.w3.org/2000/svg')\n  clone.setAttribute('xmlns:xlink', 'http://www.w3.org/1999/xlink')\n  clone.setAttribute('width', String(largura))\n  clone.setAttribute('height', String(altura))\n  if (!clone.getAttribute('viewBox')) {\n    clone.setAttribute('viewBox', `0 0 ${largura} ${altura}`)\n  }\n  // Atributos de interação não fazem sentido numa figura estática.\n  clone.removeAttribute('tabindex')\n  clone.removeAttribute('role')\n\n  return { texto: new XMLSerializer().serializeToString(clone), largura, altura }\n}\n\n/**\n * Resolve um valor de cor que pode ser `var(--token)`.\n *\n * ⚠️ `getComputedStyle(el).getPropertyValue('--acai-chart-surface')` **não serve**:\n * custom property devolve o valor ESPECIFICADO, e aqui isso é a string literal\n * `var(--acai-surface)` — que o canvas não entende. A sonda existe pra o motor de\n * CSS fazer a substituição: atribuir a uma propriedade real (`background-color`) e\n * ler o computado devolve `rgb(...)`.\n *\n * A sonda entra ao lado do gráfico, e não no `<body>`, porque o token pode ter\n * sido sobrescrito num contêiner intermediário (é assim que a documentação pinta\n * a própria identidade).\n */\nfunction resolverCorCss(valor: string, contexto: Element, reserva: string): string {\n  const pai = contexto.parentElement ?? document.body\n  const sonda = document.createElement('span')\n  sonda.style.cssText = `position:absolute;width:0;height:0;visibility:hidden;background-color:${valor}`\n  pai.appendChild(sonda)\n  const resolvida = window.getComputedStyle(sonda).backgroundColor\n  sonda.remove()\n\n  // Token inexistente computa como transparente — aí a reserva é melhor do que\n  // devolver um PNG sem fundo achando que tem.\n  if (!resolvida || resolvida === 'rgba(0, 0, 0, 0)' || resolvida === 'transparent') {\n    return reserva\n  }\n  return resolvida\n}\n\n/** Acima disso desistimos: melhor erro claro que promessa que nunca resolve. */\nconst TIMEOUT_MS = 8000\n\nfunction carregarImagem(dataUrl: string): Promise<HTMLImageElement> {\n  return new Promise((resolver, rejeitar) => {\n    const img = new Image()\n    const relogio = setTimeout(() => {\n      rejeitar(new Error('acai-ui-chart: tempo esgotado ao rasterizar o SVG do gráfico.'))\n    }, TIMEOUT_MS)\n\n    img.onload = () => {\n      clearTimeout(relogio)\n      resolver(img)\n    }\n    img.onerror = () => {\n      clearTimeout(relogio)\n      rejeitar(new Error('acai-ui-chart: o navegador recusou o SVG serializado do gráfico.'))\n    }\n    img.src = dataUrl\n  })\n}\n\n/**\n * Rasteriza o SVG de um gráfico já desenhado.\n *\n * Data URL e não `URL.createObjectURL`: o blob de SVG **suja o canvas** em parte\n * dos navegadores, e aí o `toDataURL` estoura `SecurityError`. E `encodeURIComponent`\n * e não `btoa`: `btoa` quebra em qualquer caractere fora do Latin-1, ou seja em\n * qualquer rótulo com acento — \"Ananindeua\", \"Órgão\", \"Óbidos\".\n */\nexport async function svgChartParaImagem(\n  svg: SVGSVGElement,\n  opcoes: OpcoesImagemChart = {},\n): Promise<ImagemChart> {\n  if (typeof document === 'undefined') {\n    throw new Error('acai-ui-chart: export de imagem exige navegador.')\n  }\n\n  const escala = Math.max(0.1, opcoes.escala ?? 2)\n  const fundo =\n    opcoes.fundo === undefined\n      ? resolverCorCss('var(--acai-chart-surface)', svg, '#ffffff')\n      : opcoes.fundo\n\n  const { texto, largura, altura } = serializarSvgChart(svg)\n  const img = await carregarImagem(\n    `data:image/svg+xml;charset=utf-8,${encodeURIComponent(texto)}`,\n  )\n\n  const canvas = document.createElement('canvas')\n  canvas.width = Math.max(1, Math.round(largura * escala))\n  canvas.height = Math.max(1, Math.round(altura * escala))\n\n  const ctx = canvas.getContext('2d')\n  if (!ctx) throw new Error('acai-ui-chart: canvas 2d indisponível.')\n\n  if (fundo) {\n    ctx.fillStyle = fundo\n    ctx.fillRect(0, 0, canvas.width, canvas.height)\n  }\n  ctx.drawImage(img, 0, 0, canvas.width, canvas.height)\n\n  return {\n    dataUrl: canvas.toDataURL('image/png'),\n    largura,\n    altura,\n    proporcao: altura > 0 ? largura / altura : 1,\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/index94.mjs

@@ -0,0 +1,124 @@
+const PROPRIEDADES_PINTURA = [
+  "fill",
+  "fill-opacity",
+  "fill-rule",
+  "stroke",
+  "stroke-width",
+  "stroke-opacity",
+  "stroke-dasharray",
+  "stroke-dashoffset",
+  "stroke-linecap",
+  "stroke-linejoin",
+  "stroke-miterlimit",
+  "opacity",
+  "display",
+  "visibility",
+  "color",
+  "font-family",
+  "font-size",
+  "font-style",
+  "font-weight",
+  "letter-spacing",
+  "text-anchor",
+  "dominant-baseline",
+  "paint-order"
+];
+const CLASSES_DESCARTADAS = ["acai-chart__foco"];
+function inlinarEstilos(origem, destino) {
+  const computado = window.getComputedStyle(origem);
+  let css = "";
+  for (const propriedade of PROPRIEDADES_PINTURA) {
+    const valor = computado.getPropertyValue(propriedade);
+    if (valor) css += `${propriedade}:${valor};`;
+  }
+  if (css) destino.setAttribute("style", css);
+  const filhosOrigem = origem.children;
+  const filhosDestino = destino.children;
+  for (let i = 0; i < filhosOrigem.length; i++) {
+    const filhoOrigem = filhosOrigem[i];
+    const filhoDestino = filhosDestino[i];
+    if (filhoOrigem && filhoDestino) inlinarEstilos(filhoOrigem, filhoDestino);
+  }
+}
+function serializarSvgChart(svg) {
+  const clone = svg.cloneNode(true);
+  inlinarEstilos(svg, clone);
+  for (const classe of CLASSES_DESCARTADAS) {
+    clone.querySelectorAll(`.${classe}`).forEach((el) => el.remove());
+  }
+  const caixa = svg.getBoundingClientRect();
+  const largura = Number(svg.getAttribute("width")) || caixa.width || 640;
+  const altura = Number(svg.getAttribute("height")) || caixa.height || 320;
+  clone.setAttribute("xmlns", "http://www.w3.org/2000/svg");
+  clone.setAttribute("xmlns:xlink", "http://www.w3.org/1999/xlink");
+  clone.setAttribute("width", String(largura));
+  clone.setAttribute("height", String(altura));
+  if (!clone.getAttribute("viewBox")) {
+    clone.setAttribute("viewBox", `0 0 ${largura} ${altura}`);
+  }
+  clone.removeAttribute("tabindex");
+  clone.removeAttribute("role");
+  return { texto: new XMLSerializer().serializeToString(clone), largura, altura };
+}
+function resolverCorCss(valor, contexto, reserva) {
+  const pai = contexto.parentElement ?? document.body;
+  const sonda = document.createElement("span");
+  sonda.style.cssText = `position:absolute;width:0;height:0;visibility:hidden;background-color:${valor}`;
+  pai.appendChild(sonda);
+  const resolvida = window.getComputedStyle(sonda).backgroundColor;
+  sonda.remove();
+  if (!resolvida || resolvida === "rgba(0, 0, 0, 0)" || resolvida === "transparent") {
+    return reserva;
+  }
+  return resolvida;
+}
+const TIMEOUT_MS = 8e3;
+function carregarImagem(dataUrl) {
+  return new Promise((resolver, rejeitar) => {
+    const img = new Image();
+    const relogio = setTimeout(() => {
+      rejeitar(new Error("acai-ui-chart: tempo esgotado ao rasterizar o SVG do gráfico."));
+    }, TIMEOUT_MS);
+    img.onload = () => {
+      clearTimeout(relogio);
+      resolver(img);
+    };
+    img.onerror = () => {
+      clearTimeout(relogio);
+      rejeitar(new Error("acai-ui-chart: o navegador recusou o SVG serializado do gráfico."));
+    };
+    img.src = dataUrl;
+  });
+}
+async function svgChartParaImagem(svg, opcoes = {}) {
+  if (typeof document === "undefined") {
+    throw new Error("acai-ui-chart: export de imagem exige navegador.");
+  }
+  const escala = Math.max(0.1, opcoes.escala ?? 2);
+  const fundo = opcoes.fundo === void 0 ? resolverCorCss("var(--acai-chart-surface)", svg, "#ffffff") : opcoes.fundo;
+  const { texto, largura, altura } = serializarSvgChart(svg);
+  const img = await carregarImagem(
+    `data:image/svg+xml;charset=utf-8,${encodeURIComponent(texto)}`
+  );
+  const canvas = document.createElement("canvas");
+  canvas.width = Math.max(1, Math.round(largura * escala));
+  canvas.height = Math.max(1, Math.round(altura * escala));
+  const ctx = canvas.getContext("2d");
+  if (!ctx) throw new Error("acai-ui-chart: canvas 2d indisponível.");
+  if (fundo) {
+    ctx.fillStyle = fundo;
+    ctx.fillRect(0, 0, canvas.width, canvas.height);
+  }
+  ctx.drawImage(img, 0, 0, canvas.width, canvas.height);
+  return {
+    dataUrl: canvas.toDataURL("image/png"),
+    largura,
+    altura,
+    proporcao: altura > 0 ? largura / altura : 1
+  };
+}
+export {
+  serializarSvgChart,
+  svgChartParaImagem
+};
+//# sourceMappingURL=index94.mjs.map

package/dist/index94.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index94.mjs","sources":["../src/components/chart/chart-imagem.ts"],"sourcesContent":["// Export de imagem — SVG desenhado na tela → PNG (data URL).\n//\n// Existe porque gerador de relatório (Book/PDF) precisa da FIGURA, não do\n// componente: o jspdf recebe um `dataUrl` e o desenha na folha. Sem isto, um app\n// que já usa o `<acai-ui-chart>` na tela é obrigado a manter uma segunda lib de\n// gráfico só pra conseguir a imagem — e ficar com duas é pior que ficar com uma.\n//\n// ⚠️ A armadilha central: um `<img src=\"data:image/svg+xml,…\">` é um DOCUMENTO\n// SEPARADO. Ele não vê a folha de estilo da página, nem as custom properties\n// `--acai-*`, nem as classes `scoped` do componente. Serializar o SVG cru\n// produziria um retângulo com tudo preto (ou nada). Por isso todo estilo COMPUTADO\n// é inlinado no clone antes de serializar: é o que carrega a paleta já resolvida\n// para o tema em vigor (claro, escuro, daltônico ou alto contraste).\n\nexport interface OpcoesImagemChart {\n  /**\n   * Multiplicador de pixels. Default 2 — o PDF é impresso e 1× sai serrilhado.\n   * O `dataUrl` sai com `largura × escala` pixels, mas as dimensões devolvidas\n   * continuam em CSS px, que é o que o jspdf usa pra calcular a proporção.\n   */\n  escala?: number\n  /**\n   * Cor de fundo do PNG.\n   *\n   * Omitido, usa a **superfície do tema em vigor** (`--acai-chart-surface`) já\n   * resolvida — o que estava atrás do gráfico na tela. Não é preciosismo: o SVG é\n   * transparente, e no tema escuro a tinta do texto é CLARA. Chapar branco por\n   * padrão produziria texto claro sobre fundo branco, ilegível justamente no\n   * relatório, que é o único lugar onde ninguém vai reconferir.\n   *\n   * Passe `'#ffffff'` quando o destino é folha branca — e nesse caso gere o\n   * relatório com o tema claro, senão o gráfico não vai combinar com a página.\n   * `null` preserva a transparência.\n   */\n  fundo?: string | null\n}\n\nexport interface ImagemChart {\n  /** `data:image/png;base64,…` — pronto pro `jspdf.addImage`. */\n  dataUrl: string\n  /** Dimensões em CSS px (não multiplicadas pela escala). */\n  largura: number\n  altura: number\n  /** `largura / altura`. É o que o gerador de PDF usa pra encaixar na folha. */\n  proporcao: number\n}\n\n/**\n * Propriedades copiadas do estilo computado para o clone.\n *\n * Lista fechada de propósito: copiar o `cssText` inteiro do computado emitiria\n * ~340 declarações POR NÓ, e o data URL de um gráfico de 300 elementos passaria\n * de 1 MB — grande o bastante para o `<img>` engasgar. Aqui está só o que pinta.\n */\nconst PROPRIEDADES_PINTURA: readonly string[] = [\n  'fill',\n  'fill-opacity',\n  'fill-rule',\n  'stroke',\n  'stroke-width',\n  'stroke-opacity',\n  'stroke-dasharray',\n  'stroke-dashoffset',\n  'stroke-linecap',\n  'stroke-linejoin',\n  'stroke-miterlimit',\n  'opacity',\n  'display',\n  'visibility',\n  'color',\n  'font-family',\n  'font-size',\n  'font-style',\n  'font-weight',\n  'letter-spacing',\n  'text-anchor',\n  'dominant-baseline',\n  'paint-order',\n]\n\n/** Só na tela: o anel de foco não pode aparecer na figura do relatório. */\nconst CLASSES_DESCARTADAS = ['acai-chart__foco']\n\n/**\n * Copia o estilo computado da árvore ORIGINAL para a clonada, nó a nó.\n *\n * Percorre os dois em paralelo em vez de reconsultar o DOM: o clone está fora do\n * documento, então `getComputedStyle` nele devolveria valores iniciais — é o erro\n * que faz o export sair todo preto.\n */\nfunction inlinarEstilos(origem: Element, destino: Element): void {\n  const computado = window.getComputedStyle(origem)\n\n  let css = ''\n  for (const propriedade of PROPRIEDADES_PINTURA) {\n    const valor = computado.getPropertyValue(propriedade)\n    if (valor) css += `${propriedade}:${valor};`\n  }\n  if (css) destino.setAttribute('style', css)\n\n  const filhosOrigem = origem.children\n  const filhosDestino = destino.children\n  for (let i = 0; i < filhosOrigem.length; i++) {\n    const filhoOrigem = filhosOrigem[i]\n    const filhoDestino = filhosDestino[i]\n    if (filhoOrigem && filhoDestino) inlinarEstilos(filhoOrigem, filhoDestino)\n  }\n}\n\nexport interface SvgSerializado {\n  texto: string\n  largura: number\n  altura: number\n}\n\n/**\n * SVG autossuficiente: estilos resolvidos, namespace declarado e dimensões\n * explícitas. Serve tanto pro raster quanto pra quem quiser o `.svg` puro.\n */\nexport function serializarSvgChart(svg: SVGSVGElement): SvgSerializado {\n  const clone = svg.cloneNode(true) as SVGSVGElement\n  inlinarEstilos(svg, clone)\n\n  for (const classe of CLASSES_DESCARTADAS) {\n    clone.querySelectorAll(`.${classe}`).forEach((el) => el.remove())\n  }\n\n  const caixa = svg.getBoundingClientRect()\n  // O atributo vem do próprio componente (ele desenha 1:1, sem esticar viewBox);\n  // a caixa medida é a rede de segurança pra SVG sem atributo.\n  const largura = Number(svg.getAttribute('width')) || caixa.width || 640\n  const altura = Number(svg.getAttribute('height')) || caixa.height || 320\n\n  // Sem os namespaces o documento carregado pelo `<img>` não é SVG válido e o\n  // `onerror` dispara sem mensagem útil.\n  clone.setAttribute('xmlns', 'http://www.w3.org/2000/svg')\n  clone.setAttribute('xmlns:xlink', 'http://www.w3.org/1999/xlink')\n  clone.setAttribute('width', String(largura))\n  clone.setAttribute('height', String(altura))\n  if (!clone.getAttribute('viewBox')) {\n    clone.setAttribute('viewBox', `0 0 ${largura} ${altura}`)\n  }\n  // Atributos de interação não fazem sentido numa figura estática.\n  clone.removeAttribute('tabindex')\n  clone.removeAttribute('role')\n\n  return { texto: new XMLSerializer().serializeToString(clone), largura, altura }\n}\n\n/**\n * Resolve um valor de cor que pode ser `var(--token)`.\n *\n * ⚠️ `getComputedStyle(el).getPropertyValue('--acai-chart-surface')` **não serve**:\n * custom property devolve o valor ESPECIFICADO, e aqui isso é a string literal\n * `var(--acai-surface)` — que o canvas não entende. A sonda existe pra o motor de\n * CSS fazer a substituição: atribuir a uma propriedade real (`background-color`) e\n * ler o computado devolve `rgb(...)`.\n *\n * A sonda entra ao lado do gráfico, e não no `<body>`, porque o token pode ter\n * sido sobrescrito num contêiner intermediário (é assim que a documentação pinta\n * a própria identidade).\n */\nfunction resolverCorCss(valor: string, contexto: Element, reserva: string): string {\n  const pai = contexto.parentElement ?? document.body\n  const sonda = document.createElement('span')\n  sonda.style.cssText = `position:absolute;width:0;height:0;visibility:hidden;background-color:${valor}`\n  pai.appendChild(sonda)\n  const resolvida = window.getComputedStyle(sonda).backgroundColor\n  sonda.remove()\n\n  // Token inexistente computa como transparente — aí a reserva é melhor do que\n  // devolver um PNG sem fundo achando que tem.\n  if (!resolvida || resolvida === 'rgba(0, 0, 0, 0)' || resolvida === 'transparent') {\n    return reserva\n  }\n  return resolvida\n}\n\n/** Acima disso desistimos: melhor erro claro que promessa que nunca resolve. */\nconst TIMEOUT_MS = 8000\n\nfunction carregarImagem(dataUrl: string): Promise<HTMLImageElement> {\n  return new Promise((resolver, rejeitar) => {\n    const img = new Image()\n    const relogio = setTimeout(() => {\n      rejeitar(new Error('acai-ui-chart: tempo esgotado ao rasterizar o SVG do gráfico.'))\n    }, TIMEOUT_MS)\n\n    img.onload = () => {\n      clearTimeout(relogio)\n      resolver(img)\n    }\n    img.onerror = () => {\n      clearTimeout(relogio)\n      rejeitar(new Error('acai-ui-chart: o navegador recusou o SVG serializado do gráfico.'))\n    }\n    img.src = dataUrl\n  })\n}\n\n/**\n * Rasteriza o SVG de um gráfico já desenhado.\n *\n * Data URL e não `URL.createObjectURL`: o blob de SVG **suja o canvas** em parte\n * dos navegadores, e aí o `toDataURL` estoura `SecurityError`. E `encodeURIComponent`\n * e não `btoa`: `btoa` quebra em qualquer caractere fora do Latin-1, ou seja em\n * qualquer rótulo com acento — \"Ananindeua\", \"Órgão\", \"Óbidos\".\n */\nexport async function svgChartParaImagem(\n  svg: SVGSVGElement,\n  opcoes: OpcoesImagemChart = {},\n): Promise<ImagemChart> {\n  if (typeof document === 'undefined') {\n    throw new Error('acai-ui-chart: export de imagem exige navegador.')\n  }\n\n  const escala = Math.max(0.1, opcoes.escala ?? 2)\n  const fundo =\n    opcoes.fundo === undefined\n      ? resolverCorCss('var(--acai-chart-surface)', svg, '#ffffff')\n      : opcoes.fundo\n\n  const { texto, largura, altura } = serializarSvgChart(svg)\n  const img = await carregarImagem(\n    `data:image/svg+xml;charset=utf-8,${encodeURIComponent(texto)}`,\n  )\n\n  const canvas = document.createElement('canvas')\n  canvas.width = Math.max(1, Math.round(largura * escala))\n  canvas.height = Math.max(1, Math.round(altura * escala))\n\n  const ctx = canvas.getContext('2d')\n  if (!ctx) throw new Error('acai-ui-chart: canvas 2d indisponível.')\n\n  if (fundo) {\n    ctx.fillStyle = fundo\n    ctx.fillRect(0, 0, canvas.width, canvas.height)\n  }\n  ctx.drawImage(img, 0, 0, canvas.width, canvas.height)\n\n  return {\n    dataUrl: canvas.toDataURL('image/png'),\n    largura,\n    altura,\n    proporcao: altura > 0 ? largura / altura : 1,\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/index95.cjs

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const vue = require("vue");
+function useContadorSessao(expiraEm, opcoes = {}) {
+  const minutosAlerta = opcoes.minutosAlerta ?? 5;
+  const expiracaoMs = vue.computed(() => {
+    const v = vue.toValue(expiraEm);
+    if (v instanceof Date) return v.getTime();
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+    return null;
+  });
+  const restanteMs = vue.ref(null);
+  let intervalo = null;
+  let expirouEmitido = false;
+  function parar() {
+    if (intervalo === null) return;
+    window.clearInterval(intervalo);
+    intervalo = null;
+  }
+  function tick() {
+    var _a;
+    if (expiracaoMs.value === null) {
+      restanteMs.value = null;
+      return;
+    }
+    const restante = expiracaoMs.value - Date.now();
+    restanteMs.value = Math.max(0, restante);
+    if (restante <= 0) {
+      parar();
+      if (!expirouEmitido) {
+        expirouEmitido = true;
+        (_a = opcoes.aoExpirar) == null ? void 0 : _a.call(opcoes);
+      }
+    }
+  }
+  vue.watch(
+    expiracaoMs,
+    (novo) => {
+      parar();
+      expirouEmitido = false;
+      if (novo === null) {
+        restanteMs.value = null;
+        return;
+      }
+      tick();
+      intervalo = window.setInterval(tick, 1e3);
+    },
+    { immediate: true }
+  );
+  vue.onBeforeUnmount(parar);
+  const doisDigitos = (n) => String(n).padStart(2, "0");
+  const horasMinutos = vue.computed(() => {
+    if (restanteMs.value === null) return "--";
+    const totalSegundos = Math.floor(restanteMs.value / 1e3);
+    return `${doisDigitos(Math.floor(totalSegundos / 3600))}:${doisDigitos(Math.floor(totalSegundos % 3600 / 60))}`;
+  });
+  const horasMinutosSegundos = vue.computed(() => {
+    if (restanteMs.value === null) return "--";
+    const s = Math.floor(restanteMs.value / 1e3);
+    return `${doisDigitos(Math.floor(s / 3600))}:${doisDigitos(Math.floor(s % 3600 / 60))}:${doisDigitos(s % 60)}`;
+  });
+  const emAlerta = vue.computed(
+    () => restanteMs.value !== null && restanteMs.value <= minutosAlerta * 6e4
+  );
+  return { restanteMs, horasMinutos, horasMinutosSegundos, emAlerta };
+}
+exports.useContadorSessao = useContadorSessao;
+//# sourceMappingURL=index95.cjs.map

package/dist/index95.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index95.cjs","sources":["../src/hooks/use-contador-sessao.ts"],"sourcesContent":["import { computed, onBeforeUnmount, ref, toValue, watch, type MaybeRefOrGetter } from 'vue'\n\nexport interface OpcoesContadorSessao {\n  /** Minutos restantes a partir dos quais `emAlerta` fica true. Default 5. */\n  minutosAlerta?: number\n  /** Chamado UMA vez quando o tempo zera. */\n  aoExpirar?: () => void\n}\n\n/**\n * Contagem regressiva de sessão a partir de um instante de expiração.\n * Aceita epoch em MILISSEGUNDOS ou `Date` (de um JWT: `exp * 1000`).\n * Reativo — reinicia sozinho quando `expiraEm` muda; limpa o intervalo no unmount.\n *\n * @example\n * const { horasMinutos, emAlerta } = useContadorSessao(() => usuario.value?.exp ? usuario.value.exp * 1000 : null)\n */\nexport function useContadorSessao(\n  expiraEm: MaybeRefOrGetter<number | Date | null | undefined>,\n  opcoes: OpcoesContadorSessao = {},\n) {\n  const minutosAlerta = opcoes.minutosAlerta ?? 5\n\n  const expiracaoMs = computed<number | null>(() => {\n    const v = toValue(expiraEm)\n    if (v instanceof Date) return v.getTime()\n    if (typeof v === 'number' && Number.isFinite(v)) return v\n    return null\n  })\n\n  const restanteMs = ref<number | null>(null)\n  let intervalo: number | null = null\n  let expirouEmitido = false\n\n  function parar(): void {\n    if (intervalo === null) return\n    window.clearInterval(intervalo)\n    intervalo = null\n  }\n\n  function tick(): void {\n    if (expiracaoMs.value === null) {\n      restanteMs.value = null\n      return\n    }\n    const restante = expiracaoMs.value - Date.now()\n    restanteMs.value = Math.max(0, restante)\n    if (restante <= 0) {\n      parar()\n      if (!expirouEmitido) {\n        expirouEmitido = true\n        opcoes.aoExpirar?.()\n      }\n    }\n  }\n\n  watch(\n    expiracaoMs,\n    (novo) => {\n      parar()\n      expirouEmitido = false\n      if (novo === null) {\n        restanteMs.value = null\n        return\n      }\n      tick()\n      intervalo = window.setInterval(tick, 1000)\n    },\n    { immediate: true },\n  )\n\n  onBeforeUnmount(parar)\n\n  const doisDigitos = (n: number): string => String(n).padStart(2, '0')\n\n  /** Tempo restante em HH:MM (ex.: \"03:42\"). \"--\" quando não há expiração. */\n  const horasMinutos = computed(() => {\n    if (restanteMs.value === null) return '--'\n    const totalSegundos = Math.floor(restanteMs.value / 1000)\n    return `${doisDigitos(Math.floor(totalSegundos / 3600))}:${doisDigitos(Math.floor((totalSegundos % 3600) / 60))}`\n  })\n\n  /** Tempo restante em HH:MM:SS (ex.: \"03:42:07\"). */\n  const horasMinutosSegundos = computed(() => {\n    if (restanteMs.value === null) return '--'\n    const s = Math.floor(restanteMs.value / 1000)\n    return `${doisDigitos(Math.floor(s / 3600))}:${doisDigitos(Math.floor((s % 3600) / 60))}:${doisDigitos(s % 60)}`\n  })\n\n  const emAlerta = computed(\n    () => restanteMs.value !== null && restanteMs.value <= minutosAlerta * 60_000,\n  )\n\n  return { restanteMs, horasMinutos, horasMinutosSegundos, emAlerta }\n}\n"],"names":["computed","toValue","ref","watch","onBeforeUnmount"],"mappings":";;;AAiBO,SAAS,kBACd,UACA,SAA+B,IAC/B;AACA,QAAM,gBAAgB,OAAO,iBAAiB;AAE9C,QAAM,cAAcA,IAAAA,SAAwB,MAAM;AAChD,UAAM,IAAIC,IAAAA,QAAQ,QAAQ;AAC1B,QAAI,aAAa,KAAM,QAAO,EAAE,QAAA;AAChC,QAAI,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,EAAG,QAAO;AACxD,WAAO;AAAA,EACT,CAAC;AAED,QAAM,aAAaC,IAAAA,IAAmB,IAAI;AAC1C,MAAI,YAA2B;AAC/B,MAAI,iBAAiB;AAErB,WAAS,QAAc;AACrB,QAAI,cAAc,KAAM;AACxB,WAAO,cAAc,SAAS;AAC9B,gBAAY;AAAA,EACd;AAEA,WAAS,OAAa;;AACpB,QAAI,YAAY,UAAU,MAAM;AAC9B,iBAAW,QAAQ;AACnB;AAAA,IACF;AACA,UAAM,WAAW,YAAY,QAAQ,KAAK,IAAA;AAC1C,eAAW,QAAQ,KAAK,IAAI,GAAG,QAAQ;AACvC,QAAI,YAAY,GAAG;AACjB,YAAA;AACA,UAAI,CAAC,gBAAgB;AACnB,yBAAiB;AACjB,qBAAO,cAAP;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEAC,MAAAA;AAAAA,IACE;AAAA,IACA,CAAC,SAAS;AACR,YAAA;AACA,uBAAiB;AACjB,UAAI,SAAS,MAAM;AACjB,mBAAW,QAAQ;AACnB;AAAA,MACF;AACA,WAAA;AACA,kBAAY,OAAO,YAAY,MAAM,GAAI;AAAA,IAC3C;AAAA,IACA,EAAE,WAAW,KAAA;AAAA,EAAK;AAGpBC,MAAAA,gBAAgB,KAAK;AAErB,QAAM,cAAc,CAAC,MAAsB,OAAO,CAAC,EAAE,SAAS,GAAG,GAAG;AAGpE,QAAM,eAAeJ,IAAAA,SAAS,MAAM;AAClC,QAAI,WAAW,UAAU,KAAM,QAAO;AACtC,UAAM,gBAAgB,KAAK,MAAM,WAAW,QAAQ,GAAI;AACxD,WAAO,GAAG,YAAY,KAAK,MAAM,gBAAgB,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,MAAO,gBAAgB,OAAQ,EAAE,CAAC,CAAC;AAAA,EACjH,CAAC;AAGD,QAAM,uBAAuBA,IAAAA,SAAS,MAAM;AAC1C,QAAI,WAAW,UAAU,KAAM,QAAO;AACtC,UAAM,IAAI,KAAK,MAAM,WAAW,QAAQ,GAAI;AAC5C,WAAO,GAAG,YAAY,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,MAAO,IAAI,OAAQ,EAAE,CAAC,CAAC,IAAI,YAAY,IAAI,EAAE,CAAC;AAAA,EAChH,CAAC;AAED,QAAM,WAAWA,IAAAA;AAAAA,IACf,MAAM,WAAW,UAAU,QAAQ,WAAW,SAAS,gBAAgB;AAAA,EAAA;AAGzE,SAAO,EAAE,YAAY,cAAc,sBAAsB,SAAA;AAC3D;;"}

package/dist/index95.mjs

@@ -0,0 +1,68 @@
+import { computed, toValue, ref, watch, onBeforeUnmount } from "vue";
+function useContadorSessao(expiraEm, opcoes = {}) {
+  const minutosAlerta = opcoes.minutosAlerta ?? 5;
+  const expiracaoMs = computed(() => {
+    const v = toValue(expiraEm);
+    if (v instanceof Date) return v.getTime();
+    if (typeof v === "number" && Number.isFinite(v)) return v;
+    return null;
+  });
+  const restanteMs = ref(null);
+  let intervalo = null;
+  let expirouEmitido = false;
+  function parar() {
+    if (intervalo === null) return;
+    window.clearInterval(intervalo);
+    intervalo = null;
+  }
+  function tick() {
+    var _a;
+    if (expiracaoMs.value === null) {
+      restanteMs.value = null;
+      return;
+    }
+    const restante = expiracaoMs.value - Date.now();
+    restanteMs.value = Math.max(0, restante);
+    if (restante <= 0) {
+      parar();
+      if (!expirouEmitido) {
+        expirouEmitido = true;
+        (_a = opcoes.aoExpirar) == null ? void 0 : _a.call(opcoes);
+      }
+    }
+  }
+  watch(
+    expiracaoMs,
+    (novo) => {
+      parar();
+      expirouEmitido = false;
+      if (novo === null) {
+        restanteMs.value = null;
+        return;
+      }
+      tick();
+      intervalo = window.setInterval(tick, 1e3);
+    },
+    { immediate: true }
+  );
+  onBeforeUnmount(parar);
+  const doisDigitos = (n) => String(n).padStart(2, "0");
+  const horasMinutos = computed(() => {
+    if (restanteMs.value === null) return "--";
+    const totalSegundos = Math.floor(restanteMs.value / 1e3);
+    return `${doisDigitos(Math.floor(totalSegundos / 3600))}:${doisDigitos(Math.floor(totalSegundos % 3600 / 60))}`;
+  });
+  const horasMinutosSegundos = computed(() => {
+    if (restanteMs.value === null) return "--";
+    const s = Math.floor(restanteMs.value / 1e3);
+    return `${doisDigitos(Math.floor(s / 3600))}:${doisDigitos(Math.floor(s % 3600 / 60))}:${doisDigitos(s % 60)}`;
+  });
+  const emAlerta = computed(
+    () => restanteMs.value !== null && restanteMs.value <= minutosAlerta * 6e4
+  );
+  return { restanteMs, horasMinutos, horasMinutosSegundos, emAlerta };
+}
+export {
+  useContadorSessao
+};
+//# sourceMappingURL=index95.mjs.map

package/dist/index95.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index95.mjs","sources":["../src/hooks/use-contador-sessao.ts"],"sourcesContent":["import { computed, onBeforeUnmount, ref, toValue, watch, type MaybeRefOrGetter } from 'vue'\n\nexport interface OpcoesContadorSessao {\n  /** Minutos restantes a partir dos quais `emAlerta` fica true. Default 5. */\n  minutosAlerta?: number\n  /** Chamado UMA vez quando o tempo zera. */\n  aoExpirar?: () => void\n}\n\n/**\n * Contagem regressiva de sessão a partir de um instante de expiração.\n * Aceita epoch em MILISSEGUNDOS ou `Date` (de um JWT: `exp * 1000`).\n * Reativo — reinicia sozinho quando `expiraEm` muda; limpa o intervalo no unmount.\n *\n * @example\n * const { horasMinutos, emAlerta } = useContadorSessao(() => usuario.value?.exp ? usuario.value.exp * 1000 : null)\n */\nexport function useContadorSessao(\n  expiraEm: MaybeRefOrGetter<number | Date | null | undefined>,\n  opcoes: OpcoesContadorSessao = {},\n) {\n  const minutosAlerta = opcoes.minutosAlerta ?? 5\n\n  const expiracaoMs = computed<number | null>(() => {\n    const v = toValue(expiraEm)\n    if (v instanceof Date) return v.getTime()\n    if (typeof v === 'number' && Number.isFinite(v)) return v\n    return null\n  })\n\n  const restanteMs = ref<number | null>(null)\n  let intervalo: number | null = null\n  let expirouEmitido = false\n\n  function parar(): void {\n    if (intervalo === null) return\n    window.clearInterval(intervalo)\n    intervalo = null\n  }\n\n  function tick(): void {\n    if (expiracaoMs.value === null) {\n      restanteMs.value = null\n      return\n    }\n    const restante = expiracaoMs.value - Date.now()\n    restanteMs.value = Math.max(0, restante)\n    if (restante <= 0) {\n      parar()\n      if (!expirouEmitido) {\n        expirouEmitido = true\n        opcoes.aoExpirar?.()\n      }\n    }\n  }\n\n  watch(\n    expiracaoMs,\n    (novo) => {\n      parar()\n      expirouEmitido = false\n      if (novo === null) {\n        restanteMs.value = null\n        return\n      }\n      tick()\n      intervalo = window.setInterval(tick, 1000)\n    },\n    { immediate: true },\n  )\n\n  onBeforeUnmount(parar)\n\n  const doisDigitos = (n: number): string => String(n).padStart(2, '0')\n\n  /** Tempo restante em HH:MM (ex.: \"03:42\"). \"--\" quando não há expiração. */\n  const horasMinutos = computed(() => {\n    if (restanteMs.value === null) return '--'\n    const totalSegundos = Math.floor(restanteMs.value / 1000)\n    return `${doisDigitos(Math.floor(totalSegundos / 3600))}:${doisDigitos(Math.floor((totalSegundos % 3600) / 60))}`\n  })\n\n  /** Tempo restante em HH:MM:SS (ex.: \"03:42:07\"). */\n  const horasMinutosSegundos = computed(() => {\n    if (restanteMs.value === null) return '--'\n    const s = Math.floor(restanteMs.value / 1000)\n    return `${doisDigitos(Math.floor(s / 3600))}:${doisDigitos(Math.floor((s % 3600) / 60))}:${doisDigitos(s % 60)}`\n  })\n\n  const emAlerta = computed(\n    () => restanteMs.value !== null && restanteMs.value <= minutosAlerta * 60_000,\n  )\n\n  return { restanteMs, horasMinutos, horasMinutosSegundos, emAlerta }\n}\n"],"names":[],"mappings":";AAiBO,SAAS,kBACd,UACA,SAA+B,IAC/B;AACA,QAAM,gBAAgB,OAAO,iBAAiB;AAE9C,QAAM,cAAc,SAAwB,MAAM;AAChD,UAAM,IAAI,QAAQ,QAAQ;AAC1B,QAAI,aAAa,KAAM,QAAO,EAAE,QAAA;AAChC,QAAI,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,EAAG,QAAO;AACxD,WAAO;AAAA,EACT,CAAC;AAED,QAAM,aAAa,IAAmB,IAAI;AAC1C,MAAI,YAA2B;AAC/B,MAAI,iBAAiB;AAErB,WAAS,QAAc;AACrB,QAAI,cAAc,KAAM;AACxB,WAAO,cAAc,SAAS;AAC9B,gBAAY;AAAA,EACd;AAEA,WAAS,OAAa;;AACpB,QAAI,YAAY,UAAU,MAAM;AAC9B,iBAAW,QAAQ;AACnB;AAAA,IACF;AACA,UAAM,WAAW,YAAY,QAAQ,KAAK,IAAA;AAC1C,eAAW,QAAQ,KAAK,IAAI,GAAG,QAAQ;AACvC,QAAI,YAAY,GAAG;AACjB,YAAA;AACA,UAAI,CAAC,gBAAgB;AACnB,yBAAiB;AACjB,qBAAO,cAAP;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA;AAAA,IACE;AAAA,IACA,CAAC,SAAS;AACR,YAAA;AACA,uBAAiB;AACjB,UAAI,SAAS,MAAM;AACjB,mBAAW,QAAQ;AACnB;AAAA,MACF;AACA,WAAA;AACA,kBAAY,OAAO,YAAY,MAAM,GAAI;AAAA,IAC3C;AAAA,IACA,EAAE,WAAW,KAAA;AAAA,EAAK;AAGpB,kBAAgB,KAAK;AAErB,QAAM,cAAc,CAAC,MAAsB,OAAO,CAAC,EAAE,SAAS,GAAG,GAAG;AAGpE,QAAM,eAAe,SAAS,MAAM;AAClC,QAAI,WAAW,UAAU,KAAM,QAAO;AACtC,UAAM,gBAAgB,KAAK,MAAM,WAAW,QAAQ,GAAI;AACxD,WAAO,GAAG,YAAY,KAAK,MAAM,gBAAgB,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,MAAO,gBAAgB,OAAQ,EAAE,CAAC,CAAC;AAAA,EACjH,CAAC;AAGD,QAAM,uBAAuB,SAAS,MAAM;AAC1C,QAAI,WAAW,UAAU,KAAM,QAAO;AACtC,UAAM,IAAI,KAAK,MAAM,WAAW,QAAQ,GAAI;AAC5C,WAAO,GAAG,YAAY,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,IAAI,YAAY,KAAK,MAAO,IAAI,OAAQ,EAAE,CAAC,CAAC,IAAI,YAAY,IAAI,EAAE,CAAC;AAAA,EAChH,CAAC;AAED,QAAM,WAAW;AAAA,IACf,MAAM,WAAW,UAAU,QAAQ,WAAW,SAAS,gBAAgB;AAAA,EAAA;AAGzE,SAAO,EAAE,YAAY,cAAc,sBAAsB,SAAA;AAC3D;"}

package/dist/index96.cjs

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const filtrosUrlInternos = require("./index180.cjs");
+function useFiltrosNaUrl(filtros, opcoes = {}) {
+  const { excluir = [], tipos = {}, prefixo = "", hidratar = true } = opcoes;
+  const adaptador = filtrosUrlInternos.criarAdaptador();
+  const mapa = filtrosUrlInternos.criarMapa(filtrosUrlInternos.clonarMolde(filtros.value), { excluir, tipos, prefixo });
+  function hidratarDaUrl() {
+    const alteracoes = filtrosUrlInternos.lerDaUrl(mapa, adaptador.ler(), filtros.value);
+    if (Object.keys(alteracoes).length === 0) return false;
+    filtros.value = { ...filtros.value, ...alteracoes };
+    return true;
+  }
+  function sincronizar() {
+    adaptador.gravar(
+      filtrosUrlInternos.escreverNaUrl(mapa, adaptador.ler(), filtros.value),
+      "replace"
+    );
+  }
+  function limpar() {
+    const params = adaptador.ler();
+    for (const caminho of mapa.caminhos) params.delete(mapa.naUrl(caminho));
+    adaptador.gravar(params, "replace");
+  }
+  const hidratou = hidratar ? hidratarDaUrl() : false;
+  return { sincronizar, limpar, hidratou };
+}
+exports.useFiltrosNaUrl = useFiltrosNaUrl;
+//# sourceMappingURL=index96.cjs.map

package/dist/index96.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index96.cjs","sources":["../src/hooks/use-filtros-na-url.ts"],"sourcesContent":["// Filtros de pesquisa na query string — sair da tela e voltar sem perder a busca.\n//\n// O ganho é o de sempre em listagem: a pessoa filtra, abre um registro, volta —\n// e hoje encontra o formulário limpo. Com os filtros na URL ela volta pro que\n// estava vendo, e de brinde consegue mandar o link da pesquisa pra outra pessoa.\n//\n// 🔴 DADO PESSOAL: o que entra aqui entra no histórico do navegador, é colado em\n// conversa, e cai no LOG DE ACESSO do servidor. Filtro de CPF, RG ou nome\n// completo precisa de `excluir`. O default sincroniza tudo porque é o\n// comportamento previsível, mas ele erra pro lado inseguro — leia `excluir`\n// antes de usar em tela com dado de pessoa.\n//\n// ℹ️ Este é o hook de BAIXO NÍVEL: ele guarda e devolve os filtros, e a tela\n// continua dona de quando buscar. Se a tela é o combo `<acai-ui-form>` +\n// `<acai-ui-table>`, prefira `useListagemNaUrl`, que amarra pesquisa, paginação,\n// histórico e cache num pacote só.\n\nimport { type Ref } from 'vue'\nimport {\n  clonarMolde,\n  criarAdaptador,\n  criarMapa,\n  escreverNaUrl,\n  lerDaUrl,\n  type TipoFiltroUrl,\n} from './filtros-url-internos'\n\nexport type { TipoFiltroUrl }\n\nexport interface OpcoesFiltrosNaUrl {\n  /**\n   * Chaves que NUNCA aparecem na URL. É onde mora dado pessoal (CPF, RG, nome).\n   *\n   * Simétrico de propósito: a chave excluída também não é LIDA da URL. Se\n   * alguém colar `?cpf=...` à mão, o valor é ignorado — senão \"não publicamos\n   * isso\" viraria \"não publicamos, mas aceitamos\".\n   *\n   * Aceita a chave inteira (`'periodo'`) ou uma folha (`'periodo.from'`).\n   */\n  excluir?: readonly string[]\n  /**\n   * Tipo declarado por campo, quando o valor inicial não consegue dizer.\n   *\n   * 🔴 É o que faz o hook servir a formulário de verdade. O padrão dos apps\n   * DETRAN é derivar o modelo do request do swagger trocando `undefined` por\n   * `null` (os componentes exigem `string | number | null` e `v-model` não\n   * compila com `readonly`) — e aí `cargoId: null` não diz que é número, então\n   * a URL devolveria `'12'` em vez de `12`, calado, direto pro payload.\n   *\n   * ```ts\n   * useFiltrosNaUrl(formulario, {\n   *   tipos: { cargoId: 'number', regimeJuridicoId: 'number', progressoMinimo: 'number' },\n   * })\n   * ```\n   *\n   * Campo declarado aqui é governado mesmo que não exista no valor inicial —\n   * declarar é decisão explícita de quem escreveu a tela, diferente de aceitar\n   * chave desconhecida vinda da URL.\n   */\n  tipos?: Readonly<Record<string, TipoFiltroUrl>>\n  /**\n   * Prefixo das chaves. Só é necessário quando DUAS listagens convivem na mesma\n   * rota e as duas têm um filtro de mesmo nome, que sem prefixo se sobrescrevem.\n   */\n  prefixo?: string\n  /** Ler a URL na entrada. Default `true`. */\n  hidratar?: boolean\n}\n\nexport interface FiltrosNaUrl {\n  /**\n   * Grava o estado atual dos filtros na URL. Chame no `buscar()`, não a cada\n   * tecla — senão a URL fica pulando enquanto a pessoa digita.\n   *\n   * Em tela onde o submit só reposiciona a página e deixa um `watch` buscar,\n   * chame na função que de fato dispara a requisição, não no `@submit`.\n   */\n  sincronizar: () => void\n  /** Remove os filtros da URL. Chame no `resetar()`. */\n  limpar: () => void\n  /**\n   * `true` quando a URL trouxe algum filtro na entrada.\n   *\n   * Em tela que NÃO busca no mount, é o gatilho de restaurar o resultado —\n   * senão o formulário volta preenchido com a tabela vazia:\n   * `if (hidratou) void pesquisar()`.\n   */\n  hidratou: boolean\n}\n\n/**\n * Mantém os filtros de pesquisa na query string.\n *\n * Chame no `setup`, ANTES do primeiro `buscar()`: a hidratação é síncrona, então\n * o `onMounted(buscar)` que a tela já tem sai com os filtros da URL e não há\n * segunda requisição.\n *\n * ```ts\n * const filtros = ref(filtrosVistoriaVazios())\n * // `excluir`: CPF na URL vai pro log de acesso do servidor.\n * // `tipos`: campo que nasce `null` não diz que é número.\n * const { sincronizar, limpar } = useFiltrosNaUrl(filtros, {\n *   excluir: ['cpf'],\n *   tipos: { cargoId: 'number' },\n * })\n *\n * async function buscar(): Promise<void> {\n *   sincronizar()\n *   await executar(limparCamposVazios(filtros.value))\n * }\n *\n * function resetar(): void {\n *   filtros.value = limparModelo(filtros.value)\n *   limpar()\n * }\n *\n * onMounted(buscar)\n * ```\n *\n * **Tipos suportados:** string, number, boolean, Date, array de primitivo (chave\n * repetida: `?sort=nome,asc&sort=idade,desc`) e **objeto de um nível** de\n * primitivos, que vira caminho com ponto — `{ periodo: { from, to } }` sai como\n * `?periodo.from=…&periodo.to=…`. É o formato do `<acai-ui-date-range>`, então\n * filtro de período funciona sem o consumidor achatar nada. Dois níveis não.\n *\n * **O tipo sai do valor inicial** do objeto (o \"molde\"), e `tipos` tem\n * precedência sobre ele.\n *\n * **Chave que não está no molde nem em `tipos` é ignorada** — sem isso a URL\n * viraria vetor de injeção (`?size=99999` descendo direto pro `executar()`).\n *\n * ⚠️ A hidratação acontece UMA vez, no `setup`. Voltar/avançar no navegador não\n * repõe o formulário, e a gravação usa `replace` (pesquisa não vira histórico).\n * Quem quer a URL como fonte da verdade — com voltar funcionando e cache — usa\n * `useListagemNaUrl`.\n */\nexport function useFiltrosNaUrl<T extends object>(\n  filtros: Ref<T>,\n  opcoes: OpcoesFiltrosNaUrl = {},\n): FiltrosNaUrl {\n  const { excluir = [], tipos = {}, prefixo = '', hidratar = true } = opcoes\n\n  const adaptador = criarAdaptador()\n  const mapa = criarMapa(clonarMolde(filtros.value), { excluir, tipos, prefixo })\n\n  function hidratarDaUrl(): boolean {\n    const alteracoes = lerDaUrl(mapa, adaptador.ler(), filtros.value as Record<string, unknown>)\n    if (Object.keys(alteracoes).length === 0) return false\n\n    // Um único assign: reatividade dispara uma vez, e a tela nunca observa um\n    // estado meio-hidratado.\n    filtros.value = { ...filtros.value, ...alteracoes } as T\n    return true\n  }\n\n  function sincronizar(): void {\n    // `replace` e não `push`: dez pesquisas não podem virar dez cliques no\n    // voltar pra sair da tela.\n    adaptador.gravar(\n      escreverNaUrl(mapa, adaptador.ler(), filtros.value as Record<string, unknown>),\n      'replace',\n    )\n  }\n\n  function limpar(): void {\n    const params = adaptador.ler()\n    for (const caminho of mapa.caminhos) params.delete(mapa.naUrl(caminho))\n    adaptador.gravar(params, 'replace')\n  }\n\n  const hidratou = hidratar ? hidratarDaUrl() : false\n\n  return { sincronizar, limpar, hidratou }\n}\n"],"names":["criarAdaptador","criarMapa","clonarMolde","lerDaUrl","escreverNaUrl"],"mappings":";;;AAwIO,SAAS,gBACd,SACA,SAA6B,IACf;AACd,QAAM,EAAE,UAAU,CAAA,GAAI,QAAQ,CAAA,GAAI,UAAU,IAAI,WAAW,KAAA,IAAS;AAEpE,QAAM,YAAYA,mBAAAA,eAAA;AAClB,QAAM,OAAOC,6BAAUC,mBAAAA,YAAY,QAAQ,KAAK,GAAG,EAAE,SAAS,OAAO,SAAS;AAE9E,WAAS,gBAAyB;AAChC,UAAM,aAAaC,mBAAAA,SAAS,MAAM,UAAU,IAAA,GAAO,QAAQ,KAAgC;AAC3F,QAAI,OAAO,KAAK,UAAU,EAAE,WAAW,EAAG,QAAO;AAIjD,YAAQ,QAAQ,EAAE,GAAG,QAAQ,OAAO,GAAG,WAAA;AACvC,WAAO;AAAA,EACT;AAEA,WAAS,cAAoB;AAG3B,cAAU;AAAA,MACRC,mBAAAA,cAAc,MAAM,UAAU,IAAA,GAAO,QAAQ,KAAgC;AAAA,MAC7E;AAAA,IAAA;AAAA,EAEJ;AAEA,WAAS,SAAe;AACtB,UAAM,SAAS,UAAU,IAAA;AACzB,eAAW,WAAW,KAAK,SAAU,QAAO,OAAO,KAAK,MAAM,OAAO,CAAC;AACtE,cAAU,OAAO,QAAQ,SAAS;AAAA,EACpC;AAEA,QAAM,WAAW,WAAW,cAAA,IAAkB;AAE9C,SAAO,EAAE,aAAa,QAAQ,SAAA;AAChC;;"}

package/dist/index96.mjs

@@ -0,0 +1,29 @@
+import { criarAdaptador, criarMapa, clonarMolde, lerDaUrl, escreverNaUrl } from "./index180.mjs";
+function useFiltrosNaUrl(filtros, opcoes = {}) {
+  const { excluir = [], tipos = {}, prefixo = "", hidratar = true } = opcoes;
+  const adaptador = criarAdaptador();
+  const mapa = criarMapa(clonarMolde(filtros.value), { excluir, tipos, prefixo });
+  function hidratarDaUrl() {
+    const alteracoes = lerDaUrl(mapa, adaptador.ler(), filtros.value);
+    if (Object.keys(alteracoes).length === 0) return false;
+    filtros.value = { ...filtros.value, ...alteracoes };
+    return true;
+  }
+  function sincronizar() {
+    adaptador.gravar(
+      escreverNaUrl(mapa, adaptador.ler(), filtros.value),
+      "replace"
+    );
+  }
+  function limpar() {
+    const params = adaptador.ler();
+    for (const caminho of mapa.caminhos) params.delete(mapa.naUrl(caminho));
+    adaptador.gravar(params, "replace");
+  }
+  const hidratou = hidratar ? hidratarDaUrl() : false;
+  return { sincronizar, limpar, hidratou };
+}
+export {
+  useFiltrosNaUrl
+};
+//# sourceMappingURL=index96.mjs.map

package/dist/index96.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index96.mjs","sources":["../src/hooks/use-filtros-na-url.ts"],"sourcesContent":["// Filtros de pesquisa na query string — sair da tela e voltar sem perder a busca.\n//\n// O ganho é o de sempre em listagem: a pessoa filtra, abre um registro, volta —\n// e hoje encontra o formulário limpo. Com os filtros na URL ela volta pro que\n// estava vendo, e de brinde consegue mandar o link da pesquisa pra outra pessoa.\n//\n// 🔴 DADO PESSOAL: o que entra aqui entra no histórico do navegador, é colado em\n// conversa, e cai no LOG DE ACESSO do servidor. Filtro de CPF, RG ou nome\n// completo precisa de `excluir`. O default sincroniza tudo porque é o\n// comportamento previsível, mas ele erra pro lado inseguro — leia `excluir`\n// antes de usar em tela com dado de pessoa.\n//\n// ℹ️ Este é o hook de BAIXO NÍVEL: ele guarda e devolve os filtros, e a tela\n// continua dona de quando buscar. Se a tela é o combo `<acai-ui-form>` +\n// `<acai-ui-table>`, prefira `useListagemNaUrl`, que amarra pesquisa, paginação,\n// histórico e cache num pacote só.\n\nimport { type Ref } from 'vue'\nimport {\n  clonarMolde,\n  criarAdaptador,\n  criarMapa,\n  escreverNaUrl,\n  lerDaUrl,\n  type TipoFiltroUrl,\n} from './filtros-url-internos'\n\nexport type { TipoFiltroUrl }\n\nexport interface OpcoesFiltrosNaUrl {\n  /**\n   * Chaves que NUNCA aparecem na URL. É onde mora dado pessoal (CPF, RG, nome).\n   *\n   * Simétrico de propósito: a chave excluída também não é LIDA da URL. Se\n   * alguém colar `?cpf=...` à mão, o valor é ignorado — senão \"não publicamos\n   * isso\" viraria \"não publicamos, mas aceitamos\".\n   *\n   * Aceita a chave inteira (`'periodo'`) ou uma folha (`'periodo.from'`).\n   */\n  excluir?: readonly string[]\n  /**\n   * Tipo declarado por campo, quando o valor inicial não consegue dizer.\n   *\n   * 🔴 É o que faz o hook servir a formulário de verdade. O padrão dos apps\n   * DETRAN é derivar o modelo do request do swagger trocando `undefined` por\n   * `null` (os componentes exigem `string | number | null` e `v-model` não\n   * compila com `readonly`) — e aí `cargoId: null` não diz que é número, então\n   * a URL devolveria `'12'` em vez de `12`, calado, direto pro payload.\n   *\n   * ```ts\n   * useFiltrosNaUrl(formulario, {\n   *   tipos: { cargoId: 'number', regimeJuridicoId: 'number', progressoMinimo: 'number' },\n   * })\n   * ```\n   *\n   * Campo declarado aqui é governado mesmo que não exista no valor inicial —\n   * declarar é decisão explícita de quem escreveu a tela, diferente de aceitar\n   * chave desconhecida vinda da URL.\n   */\n  tipos?: Readonly<Record<string, TipoFiltroUrl>>\n  /**\n   * Prefixo das chaves. Só é necessário quando DUAS listagens convivem na mesma\n   * rota e as duas têm um filtro de mesmo nome, que sem prefixo se sobrescrevem.\n   */\n  prefixo?: string\n  /** Ler a URL na entrada. Default `true`. */\n  hidratar?: boolean\n}\n\nexport interface FiltrosNaUrl {\n  /**\n   * Grava o estado atual dos filtros na URL. Chame no `buscar()`, não a cada\n   * tecla — senão a URL fica pulando enquanto a pessoa digita.\n   *\n   * Em tela onde o submit só reposiciona a página e deixa um `watch` buscar,\n   * chame na função que de fato dispara a requisição, não no `@submit`.\n   */\n  sincronizar: () => void\n  /** Remove os filtros da URL. Chame no `resetar()`. */\n  limpar: () => void\n  /**\n   * `true` quando a URL trouxe algum filtro na entrada.\n   *\n   * Em tela que NÃO busca no mount, é o gatilho de restaurar o resultado —\n   * senão o formulário volta preenchido com a tabela vazia:\n   * `if (hidratou) void pesquisar()`.\n   */\n  hidratou: boolean\n}\n\n/**\n * Mantém os filtros de pesquisa na query string.\n *\n * Chame no `setup`, ANTES do primeiro `buscar()`: a hidratação é síncrona, então\n * o `onMounted(buscar)` que a tela já tem sai com os filtros da URL e não há\n * segunda requisição.\n *\n * ```ts\n * const filtros = ref(filtrosVistoriaVazios())\n * // `excluir`: CPF na URL vai pro log de acesso do servidor.\n * // `tipos`: campo que nasce `null` não diz que é número.\n * const { sincronizar, limpar } = useFiltrosNaUrl(filtros, {\n *   excluir: ['cpf'],\n *   tipos: { cargoId: 'number' },\n * })\n *\n * async function buscar(): Promise<void> {\n *   sincronizar()\n *   await executar(limparCamposVazios(filtros.value))\n * }\n *\n * function resetar(): void {\n *   filtros.value = limparModelo(filtros.value)\n *   limpar()\n * }\n *\n * onMounted(buscar)\n * ```\n *\n * **Tipos suportados:** string, number, boolean, Date, array de primitivo (chave\n * repetida: `?sort=nome,asc&sort=idade,desc`) e **objeto de um nível** de\n * primitivos, que vira caminho com ponto — `{ periodo: { from, to } }` sai como\n * `?periodo.from=…&periodo.to=…`. É o formato do `<acai-ui-date-range>`, então\n * filtro de período funciona sem o consumidor achatar nada. Dois níveis não.\n *\n * **O tipo sai do valor inicial** do objeto (o \"molde\"), e `tipos` tem\n * precedência sobre ele.\n *\n * **Chave que não está no molde nem em `tipos` é ignorada** — sem isso a URL\n * viraria vetor de injeção (`?size=99999` descendo direto pro `executar()`).\n *\n * ⚠️ A hidratação acontece UMA vez, no `setup`. Voltar/avançar no navegador não\n * repõe o formulário, e a gravação usa `replace` (pesquisa não vira histórico).\n * Quem quer a URL como fonte da verdade — com voltar funcionando e cache — usa\n * `useListagemNaUrl`.\n */\nexport function useFiltrosNaUrl<T extends object>(\n  filtros: Ref<T>,\n  opcoes: OpcoesFiltrosNaUrl = {},\n): FiltrosNaUrl {\n  const { excluir = [], tipos = {}, prefixo = '', hidratar = true } = opcoes\n\n  const adaptador = criarAdaptador()\n  const mapa = criarMapa(clonarMolde(filtros.value), { excluir, tipos, prefixo })\n\n  function hidratarDaUrl(): boolean {\n    const alteracoes = lerDaUrl(mapa, adaptador.ler(), filtros.value as Record<string, unknown>)\n    if (Object.keys(alteracoes).length === 0) return false\n\n    // Um único assign: reatividade dispara uma vez, e a tela nunca observa um\n    // estado meio-hidratado.\n    filtros.value = { ...filtros.value, ...alteracoes } as T\n    return true\n  }\n\n  function sincronizar(): void {\n    // `replace` e não `push`: dez pesquisas não podem virar dez cliques no\n    // voltar pra sair da tela.\n    adaptador.gravar(\n      escreverNaUrl(mapa, adaptador.ler(), filtros.value as Record<string, unknown>),\n      'replace',\n    )\n  }\n\n  function limpar(): void {\n    const params = adaptador.ler()\n    for (const caminho of mapa.caminhos) params.delete(mapa.naUrl(caminho))\n    adaptador.gravar(params, 'replace')\n  }\n\n  const hidratou = hidratar ? hidratarDaUrl() : false\n\n  return { sincronizar, limpar, hidratou }\n}\n"],"names":[],"mappings":";AAwIO,SAAS,gBACd,SACA,SAA6B,IACf;AACd,QAAM,EAAE,UAAU,CAAA,GAAI,QAAQ,CAAA,GAAI,UAAU,IAAI,WAAW,KAAA,IAAS;AAEpE,QAAM,YAAY,eAAA;AAClB,QAAM,OAAO,UAAU,YAAY,QAAQ,KAAK,GAAG,EAAE,SAAS,OAAO,SAAS;AAE9E,WAAS,gBAAyB;AAChC,UAAM,aAAa,SAAS,MAAM,UAAU,IAAA,GAAO,QAAQ,KAAgC;AAC3F,QAAI,OAAO,KAAK,UAAU,EAAE,WAAW,EAAG,QAAO;AAIjD,YAAQ,QAAQ,EAAE,GAAG,QAAQ,OAAO,GAAG,WAAA;AACvC,WAAO;AAAA,EACT;AAEA,WAAS,cAAoB;AAG3B,cAAU;AAAA,MACR,cAAc,MAAM,UAAU,IAAA,GAAO,QAAQ,KAAgC;AAAA,MAC7E;AAAA,IAAA;AAAA,EAEJ;AAEA,WAAS,SAAe;AACtB,UAAM,SAAS,UAAU,IAAA;AACzB,eAAW,WAAW,KAAK,SAAU,QAAO,OAAO,KAAK,MAAM,OAAO,CAAC;AACtE,cAAU,OAAO,QAAQ,SAAS;AAAA,EACpC;AAEA,QAAM,WAAW,WAAW,cAAA,IAAkB;AAE9C,SAAO,EAAE,aAAa,QAAQ,SAAA;AAChC;"}