karsten-design-system 1.2.27 → 1.2.31

package/README.md

@@ -1,208 +1,207 @@
-# Karsten Design System
-
-Uma biblioteca de componentes React estilizados para projetos da Karsten, construída sobre o PrimeReact.
-
-## Instalação
-
-Com npm:
-
-```bash
-npm install karsten-design-system
-```
-
-Com yarn:
-
-```bash
-yarn add karsten-design-system
-```
-
-## Configuração do PrimeReact
-
-No main.tsx adicione:
-
-```js
-import { StrictMode } from "react";
-import { createRoot } from "react-dom/client";
-import "./index.css";
-import App from "./App.tsx";
-
-import { PrimeReactProvider } from 'primereact/api'; // Adicione o PrimeReactProvider
-import Tailwind from 'primereact/passthrough/tailwind'; // Importe o Tailwind
-import './index.css';
-
-createRoot(document.getElementById("root")!).render(
-  <StrictMode>
-    <PrimeReactProvider value={{ pt: Tailwind }}> {/* Envolva o app no Provider do PrimeReact */}
-      <App />
-    </PrimeReactProvider>
-  </StrictMode>
-);
-```
-
-## Pré-requisitos
-
-Esta biblioteca requer as seguintes dependências:
-
-- React 18 ou superior
-- React DOM 18 ou superior
-- React Router DOM 7 ou superior
-- Tailwind 3.4.0 ou superior
-- @types/date-fns 2 ou superior
-- Chart.js 4 ou superior
-- clsx 2 ou superior
-- date-fns 1 ou superior
-- Primeicons 7 ou superior
-- Primereact 10 ou superior
-- Postcss 8 ou superior
-- Autoprefixer 10 ou superior
-
-## Como usar
-
-1. Importe o componente desejado da biblioteca:
-
-```jsx
-import { Button } from 'karsten-design-system';
-```
-
-2. Use o componente em seu projeto:
-
-```jsx
-function App() {
-  return <Button label="Clique aqui" />;
-}
-```
-
-## Componentes Disponíveis
-
-- `Accordion` - Componente para exibir conteúdo em seções expansíveis e colapsáveis.
-- `AutoComplete` - Campo de entrada com sugestões automáticas baseadas no texto digitado.
-- `Breadcrumb` - Navegação hierárquica para indicar a localização atual do usuário.
-- `Button` - Botão estilizado com variantes primária e secundária.
-- `Card` - Contêiner estilizado para exibir informações agrupadas.
-- `Chart` - Gráficos para visualização de dados em diferentes formatos.
-- `DateInput` - Campo de entrada para seleção de datas.
-- `Dialog` - Modal para exibição de mensagens ou ações secundárias.
-- `Divider` - Linha divisória para separação visual de conteúdo.
-- `FilterButton` - Botão para aplicar ou remover filtros em listas ou tabelas.
-- `Header` - Cabeçalho estilizado para títulos ou menus.
-- `IconButton` - Botão com ícone, ideal para ações rápidas.
-- `InfoCard` - Cartão informativo para exibir alertas ou dados destacados.
-- `Input` - Campo de entrada para texto.
-- `InternalMenu` - Menu de navegação interna, útil para dashboards.
-- `Link` - Link estilizado para navegação.
-- `MegaMenu` - Menu expandido com múltiplas opções organizadas.
-- `Notification` - Notificação para exibir alertas e mensagens.
-- `Paginator` - Paginação para navegação em listas ou tabelas.
-- `RadioButton` - Botões de seleção única dentro de um grupo.
-- `Select` - Componente para seleção de opções em um menu suspenso.
-- `Sidebar` - Barra lateral para navegação ou exibição de conteúdo adicional.
-- `Skeleton` - Elementos de carregamento em estilo esqueleto.
-- `Spinner` - Indicador de carregamento animado.
-- `Table` - Tabela para exibição de dados estruturados.
-- `Toast` - Mensagens temporárias exibidas no canto da tela.
-
-## Desenvolvimento
-
-Para contribuir com o projeto:
-
-1. Clone o repositório:
-
-```bash
-git clone https://github.com/KarstenSA/karsten-design-system.git
-```
-
-2. Instale as dependências:
-
-Com npm:
-
-```bash
-npm install
-```
-
-Com yarn:
-
-```bash
-yarn
-```
-
-3. Execute o Storybook para desenvolvimento:
-
-Com npm:
-
-```bash
-npm run storybook
-```
-
-Com yarn:
-
-```bash
-yarn storybook
-```
-
-## Scripts Disponíveis
-
-Com npm:
-
-- `npm run storybook` - Inicia o ambiente de desenvolvimento do Storybook
-- `npm run build-storybook` - Gera o build da biblioteca para hospedagem
-- `npm run build` - Gera o build da biblioteca para publicação no npm
-
-Com yarn:
-
-- `yarn storybook` - Inicia o ambiente de desenvolvimento do Storybook
-- `yarn build-storybook` - Gera o build do Storybook para hospedagem
-- `yarn build` - Gera o build da biblioteca para publicação no npm
-
-## Publicando uma Nova Versão no NPM
-
-1. Atualizar a Versão
-
-Antes de publicar, aumente a versão no `package.json` e `package-lock.json`.
-
-2. Fazer o Build
-
-Com npm:
-
-```bash
-npm run build
-```
-
-Com yarn:
-
-```bash
-yarn build
-```
-
-3. Login no NPM
-
-Se ainda não estiver autenticado, faça login:
-
-```bash
-npm login
-```
-
-4. Publicar
-
-```bash
-npm publish --access public
-```
-
-## Resolução de Problemas
-
-Se você encontrar o erro "peer dependencies missing", instale as dependências necessárias:
-
-Com npm:
-
-```bash
-npm install react@^18 react-dom@^18 tailwindcss@^3.4.0 @types/date-fns@^2 chart.js@^4 clsx@^2 date-fns@^1 primeicons@^7 primereact@^10 postcss@^8 autoprefixer@^10
-```
-
-Com yarn:
-
-```bash
-yarn add react@^18 react-dom@^18 tailwindcss@^3.4.0 @types/date-fns@^2 chart.js@^4 clsx@^2 date-fns@^1 primeicons@^7 primereact@^10 postcss@^8 autoprefixer@^10
-```
-
-## Licença
-
-Este projeto está licenciado sob a licença MIT.
+# Karsten Design System
+
+Uma biblioteca de componentes React estilizados para projetos da Karsten, construída sobre o PrimeReact.
+
+## Instalação
+
+Com npm:
+
+```bash
+npm install karsten-design-system
+```
+
+Com yarn:
+
+```bash
+yarn add karsten-design-system
+```
+
+## Configuração do PrimeReact
+
+No main.tsx adicione:
+
+```js
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import "./index.css";
+import App from "./App.tsx";
+
+import { PrimeReactProvider } from 'primereact/api'; // Adicione o PrimeReactProvider
+import Tailwind from 'primereact/passthrough/tailwind'; // Importe o Tailwind
+import './index.css';
+
+createRoot(document.getElementById("root")!).render(
+  <StrictMode>
+    <PrimeReactProvider value={{ pt: Tailwind }}> {/* Envolva o app no Provider do PrimeReact */}
+      <App />
+    </PrimeReactProvider>
+  </StrictMode>
+);
+```
+
+## Pré-requisitos
+
+Esta biblioteca requer as seguintes dependências:
+
+- React 18 ou superior
+- React DOM 18 ou superior
+- React Router DOM 7 ou superior
+- Tailwind 3.4.0 ou superior
+- @types/date-fns 2 ou superior
+- Chart.js 4 ou superior
+- clsx 2 ou superior
+- date-fns 1 ou superior
+- Primeicons 7 ou superior
+- Primereact 10 ou superior
+- Postcss 8 ou superior
+- Autoprefixer 10 ou superior
+
+## Como usar
+
+1. Importe o componente desejado da biblioteca:
+
+```jsx
+import { Button } from 'karsten-design-system'
+```
+
+2. Use o componente em seu projeto:
+
+```jsx
+function App() {
+  return <Button label="Clique aqui" />
+}
+```
+
+## Componentes Disponíveis
+
+- `Accordion` - Componente para exibir conteúdo em seções expansíveis e colapsáveis.
+- `AutoComplete` - Campo de entrada com sugestões automáticas baseadas no texto digitado.
+- `Breadcrumb` - Navegação hierárquica para indicar a localização atual do usuário.
+- `Button` - Botão estilizado com variantes primária e secundária.
+- `Card` - Contêiner estilizado para exibir informações agrupadas.
+- `Chart` - Gráficos para visualização de dados em diferentes formatos.
+- `DateInput` - Campo de entrada para seleção de datas.
+- `Dialog` - Modal para exibição de mensagens ou ações secundárias.
+- `Divider` - Linha divisória para separação visual de conteúdo.
+- `Header` - Cabeçalho estilizado para títulos ou menus.
+- `IconButton` - Botão com ícone, ideal para ações rápidas.
+- `InfoCard` - Cartão informativo para exibir alertas ou dados destacados.
+- `Input` - Campo de entrada para texto.
+- `InternalMenu` - Menu de navegação interna, útil para dashboards.
+- `Link` - Link estilizado para navegação.
+- `MegaMenu` - Menu expandido com múltiplas opções organizadas.
+- `Notification` - Notificação para exibir alertas e mensagens.
+- `Paginator` - Paginação para navegação em listas ou tabelas.
+- `RadioButton` - Botões de seleção única dentro de um grupo.
+- `Select` - Componente para seleção de opções em um menu suspenso.
+- `Sidebar` - Barra lateral para navegação ou exibição de conteúdo adicional.
+- `Skeleton` - Elementos de carregamento em estilo esqueleto.
+- `Spinner` - Indicador de carregamento animado.
+- `Table` - Tabela para exibição de dados estruturados.
+- `Toast` - Mensagens temporárias exibidas no canto da tela.
+
+## Desenvolvimento
+
+Para contribuir com o projeto:
+
+1. Clone o repositório:
+
+```bash
+git clone https://github.com/KarstenSA/karsten-design-system.git
+```
+
+2. Instale as dependências:
+
+Com npm:
+
+```bash
+npm install
+```
+
+Com yarn:
+
+```bash
+yarn
+```
+
+3. Execute o Storybook para desenvolvimento:
+
+Com npm:
+
+```bash
+npm run storybook
+```
+
+Com yarn:
+
+```bash
+yarn storybook
+```
+
+## Scripts Disponíveis
+
+Com npm:
+
+- `npm run storybook` - Inicia o ambiente de desenvolvimento do Storybook
+- `npm run build-storybook` - Gera o build da biblioteca para hospedagem
+- `npm run build` - Gera o build da biblioteca para publicação no npm
+
+Com yarn:
+
+- `yarn storybook` - Inicia o ambiente de desenvolvimento do Storybook
+- `yarn build-storybook` - Gera o build do Storybook para hospedagem
+- `yarn build` - Gera o build da biblioteca para publicação no npm
+
+## Publicando uma Nova Versão no NPM
+
+1. Atualizar a Versão
+
+Antes de publicar, aumente a versão no `package.json` e `package-lock.json`.
+
+2. Fazer o Build
+
+Com npm:
+
+```bash
+npm run build
+```
+
+Com yarn:
+
+```bash
+yarn build
+```
+
+3. Login no NPM
+
+Se ainda não estiver autenticado, faça login:
+
+```bash
+npm login
+```
+
+4. Publicar
+
+```bash
+npm publish --access public
+```
+
+## Resolução de Problemas
+
+Se você encontrar o erro "peer dependencies missing", instale as dependências necessárias:
+
+Com npm:
+
+```bash
+npm install react@^18 react-dom@^18 tailwindcss@^3.4.0 @types/date-fns@^2 chart.js@^4 clsx@^2 date-fns@^1 primeicons@^7 primereact@^10 postcss@^8 autoprefixer@^10
+```
+
+Com yarn:
+
+```bash
+yarn add react@^18 react-dom@^18 tailwindcss@^3.4.0 @types/date-fns@^2 chart.js@^4 clsx@^2 date-fns@^1 primeicons@^7 primereact@^10 postcss@^8 autoprefixer@^10
+```
+
+## Licença
+
+Este projeto está licenciado sob a licença MIT.

package/dist/index.js

@@ -157,6 +157,10 @@ function CalendarInput({ error, placeholder = 'Selecione uma data', label, disab
     const calendarRef = useRef(null);
     const hasError = (error && !disabled) || (!!error && !disabled);
     const [isDarkMode, setIsDarkMode] = useState(false);
+    const [isClient, setIsClient] = useState(false);
+    useEffect(() => {
+        setIsClient(true);
+    }, []);
     const dateTemplate = (data) => {
         const date = new Date(`${data.year}/${data.month + 1}/${data.day}`);
         const dayComponent = (className) => {
@@ -188,6 +192,8 @@ function CalendarInput({ error, placeholder = 'Selecione uma data', label, disab
         }
     };
     useEffect(() => {
+        if (!isClient || typeof document === 'undefined')
+            return;
         const htmlClassList = document.documentElement.classList;
         setIsDarkMode(htmlClassList.contains('dark'));
         const observer = new MutationObserver(() => {
@@ -198,7 +204,7 @@ function CalendarInput({ error, placeholder = 'Selecione uma data', label, disab
             attributeFilter: ['class'],
         });
         return () => observer.disconnect();
-    }, []);
+    }, [isClient]);
     return (jsx("div", { className: "relative flex flex-col w-full min-w-full", children: jsxs("div", { onClick: handleInputClick, children: [jsx(FloatingLabel, { value: props?.value ? props.value.toString() : '', label: label, disabled: disabled, error: error }), jsxs("div", { className: "relative w-full min-w-full", children: [jsx(Calendar, { ...props, disabled: disabled, placeholder: placeholder, ref: calendarRef, panelStyle: { width: '420px', height: '410px' }, className: clsx('w-full min-w-full focus:shadow-none border-none z-0 font-roboto border rounded-md', hasError
                                 ? 'border-redError placeholder:!text-redError p-invalid'
                                 : 'border-light-700 focus:border-primary', disabled && 'border-light-100 text-disabled', error && 'border-redError text-redError p-invalid', !error && 'border-light-700 p-custom'), dateFormat: "dd/mm/yy", inputStyle: {
@@ -217,14 +223,14 @@ function Card({ children, className, ariaLabel = 'Card de informação', }) {
 }
 
 function CardButton({ label, description, onClick }) {
-    return (jsxs("div", { className: "cursor-pointer rounded-2xl p-4 h-[160px] w-full bg-gradient-to-br hover:shadow-md transition-shadow duration-200 border from-[#f3f4f6] to-light-500 border-[#f3f4f6]\r\n        dark:from-dark-400 dark:to-dark-100 dark:border-dark-400 dark:bg-dark-100 dark:shadow-dark-400", onClick: () => {
+    return (jsxs("div", { className: "cursor-pointer rounded-2xl p-4 h-[160px] w-full bg-gradient-to-br hover:shadow-md transition-shadow duration-200 border from-[#f3f4f6] to-light-500 border-[#f3f4f6]\n        dark:from-dark-400 dark:to-dark-100 dark:border-dark-400 dark:bg-dark-100 dark:shadow-dark-400", onClick: () => {
             if (onClick)
                 onClick();
         }, children: [jsx("h3", { className: "text-lg font-bold text-primary dark:text-light-500", children: label }), description && (jsx("p", { className: "text-sm mt-2 line-clamp-3 text-primary dark:text-light-500", children: description }))] }));
 }
 
 function CardIconsButton({ label, leftIcon, onClick, }) {
-    return (jsxs("div", { className: "cursor-pointer rounded-xl p-4 w-full min-h-[60px] bg-gradient-to-br hover:shadow-md transition-shadow duration-200 border flex items-center justify-between gap-4 from-[#f3f4f6] to-light-500 border-[#f3f4f6]\r\n        dark:from-dark-400 dark:to-dark-100 dark:border-dark-400 dark:bg-dark-100 dark:shadow-dark-400", onClick: () => {
+    return (jsxs("div", { className: "cursor-pointer rounded-xl p-4 w-full min-h-[60px] bg-gradient-to-br hover:shadow-md transition-shadow duration-200 border flex items-center justify-between gap-4 from-[#f3f4f6] to-light-500 border-[#f3f4f6]\n        dark:from-dark-400 dark:to-dark-100 dark:border-dark-400 dark:bg-dark-100 dark:shadow-dark-400", onClick: () => {
             if (onClick)
                 onClick();
         }, "aria-label": `Botão de navegação para ${label}`, children: [jsxs("div", { className: "flex items-center gap-3 flex-grow overflow-hidden", children: [leftIcon && (jsx("div", { className: "text-xl flex-shrink-0 flex items-center dark:text-light-500 text-primary", children: leftIcon })), jsx("h3", { className: "text-base font-semibold break-words dark:text-light-500 text-primary", children: label })] }), jsx("div", { className: "flex items-center justify-center h-full", children: jsx("i", { className: "pi pi-angle-right text-xl flex-shrink-0 dark:text-light-500 text-primary" }) })] }));
@@ -232,6 +238,10 @@ function CardIconsButton({ label, leftIcon, onClick, }) {
 
 function Charts({ type, labels, datasets, title, stacked = false, horizontal = false, legendPosition = 'top', }) {
     const [isDarkMode, setIsDarkMode] = useState(false);
+    const [isClient, setIsClient] = useState(false);
+    useEffect(() => {
+        setIsClient(true);
+    }, []);
     const chartData = {
         labels,
         datasets: datasets.map((ds) => ({
@@ -281,6 +291,8 @@ function Charts({ type, labels, datasets, title, stacked = false, horizontal = f
         },
     };
     useEffect(() => {
+        if (!isClient || typeof document === 'undefined')
+            return;
         const htmlClassList = document.documentElement.classList;
         setIsDarkMode(htmlClassList.contains('dark'));
         const observer = new MutationObserver(() => {
@@ -291,7 +303,7 @@ function Charts({ type, labels, datasets, title, stacked = false, horizontal = f
             attributeFilter: ['class'],
         });
         return () => observer.disconnect();
-    }, []);
+    }, [isClient]);
     return (jsx(Chart, { type: chartType, data: chartData, options: chartOptions, className: "w-full h-full", "aria-label": "chart" }));
 }