@celke/kole-react 0.1.0 → 0.3.0

package/dist/components/Busca/Busca.d.ts

@@ -6,6 +6,8 @@ export interface ItemBusca {
     icone?: IconeProp;
     /** Caminho no menu (ex.: "Cadastros › Pessoas"). */
     trilha?: string;
+    /** Página fora da navegação SPA (ex.: tela Blade num app Inertia): abre com recarga completa, sem `aoNavegar`. */
+    recarregar?: boolean;
 }
 export interface BuscaProps {
     placeholder?: string;

package/dist/components/Estrutura/Estrutura.d.ts

@@ -8,6 +8,11 @@ export interface ItemNav {
     rota?: string;
     filhos?: ItemNav[];
     desabilitado?: boolean;
+    /**
+     * Página fora da navegação SPA (ex.: tela Blade num app Inertia): o link vira
+     * um `<a>` comum, sem `renderLink` nem `aoNavegar`, e abre com recarga completa.
+     */
+    recarregar?: boolean;
 }
 export interface SecaoNav {
     /** Rótulo do grupo (linha em caixa alta). */
@@ -20,6 +25,8 @@ export interface Marca {
     /** URL da imagem do logo (sem ela, mostra um escudo). */
     logo?: string;
     href?: string;
+    /** O `href` da marca abre com recarga completa (ver `ItemNav.recarregar`). */
+    recarregar?: boolean;
 }
 export interface UsuarioEstrutura {
     nome: string;

package/dist/components/Preferencias/Preferencias.d.ts

@@ -1,22 +1,39 @@
 import { type ReactNode } from 'react';
-export type Tema = 'claro' | 'escuro';
+/** `sistema` = segue o modo do sistema operacional, inclusive quando ele muda com a página aberta. */
+export type Tema = 'claro' | 'escuro' | 'sistema';
 export type Densidade = 'compacta' | 'confortavel' | 'espacosa';
 export interface Preferencias {
     tema: Tema;
+    /** O tema que está na tela: com `sistema`, o do sistema operacional agora. */
     escuro: boolean;
     densidade: Densidade;
     definirTema: (t: Tema) => void;
     alternarTema: () => void;
     definirDensidade: (d: Densidade) => void;
 }
+/**
+ * Script para o `<head>` que aplica tema e densidade ANTES da primeira pintura.
+ * Sem ele, o `ProvedorPreferencias` só aplica no primeiro efeito, e quem salvou
+ * o tema escuro vê a página clara piscar ao abrir. Lê a mesma chave do
+ * `localStorage`; passe o mesmo `temaInicial`/`densidadeInicial` do provedor.
+ *
+ * SSR: `<script dangerouslySetInnerHTML={{ __html: scriptTemaInicial() }} />`.
+ * Vite/HTML estático: o README traz o script pronto para colar no index.html.
+ */
+export declare function scriptTemaInicial({ temaInicial, densidadeInicial }?: {
+    temaInicial?: Tema;
+    densidadeInicial?: Densidade;
+}): string;
 export interface ProvedorPreferenciasProps {
     children: ReactNode;
+    /** Tema enquanto a pessoa não escolhe outro. Padrão: `sistema`. */
     temaInicial?: Tema;
     densidadeInicial?: Densidade;
 }
 /**
- * Tema (claro/escuro) e densidade, lembrados no navegador. Aplica
- * `data-theme` no <html> e a classe de densidade no <body>.
+ * Tema (claro/escuro/sistema) e densidade, lembrados no navegador. Aplica
+ * `data-theme` (`light`/`dark`/`system`) no <html> e a classe de densidade no
+ * <body>. Para não piscar ao abrir, use também o `scriptTemaInicial` no <head>.
  */
 export declare function ProvedorPreferencias({ children, temaInicial, densidadeInicial }: ProvedorPreferenciasProps): import("react").JSX.Element;
 export declare function usePreferencias(): Preferencias;