npm - @fast-food/design-system - Versions diffs - 1.32.0 → 1.34.0 - Mend

@fast-food/design-system 1.32.0 → 1.34.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (61) hide show

package/dist/components/organisms/Toaster/toast.d.ts ADDED Viewed

@@ -0,0 +1,27 @@
+import { ToastItem, ToastOptions } from './toast.type';
+interface ToastFn {
+    (message: string, options?: ToastOptions): string;
+    success: (message: string, options?: ToastOptions) => string;
+    error: (message: string, options?: ToastOptions) => string;
+    warning: (message: string, options?: ToastOptions) => string;
+    info: (message: string, options?: ToastOptions) => string;
+    /** Cria um toast com controle total do payload. */
+    show: (toast: Omit<ToastItem, 'id'> & {
+        id?: string;
+    }) => string;
+    /** Fecha um toast específico. */
+    dismiss: (id: string) => void;
+    /** Fecha todos os toasts. */
+    clear: () => void;
+}
+/**
+ * API imperativa de toasts — pode ser chamada de qualquer lugar
+ * (services, handlers, etc.), sem hooks. Requer um `<Toaster />`
+ * montado uma vez na árvore para renderizar.
+ *
+ * @example
+ * toast.success('Pedido criado!');
+ * toast.error('Falha ao salvar', { title: 'Erro' });
+ */
+export declare const toast: ToastFn;
+export {};

package/dist/components/organisms/Toaster/toast.type.d.ts ADDED Viewed

@@ -0,0 +1,32 @@
+export type ToastVariant = 'success' | 'error' | 'warning' | 'info';
+export interface ToastAction {
+    label: string;
+    onClick: () => void;
+}
+export interface ToastItem {
+    id: string;
+    variant: ToastVariant;
+    title?: string;
+    message: string;
+    /** Duração em ms (0 = não fecha sozinho). Padrão: 5000. */
+    duration?: number;
+    icon?: React.ReactNode;
+    action?: ToastAction;
+}
+/** Opções aceitas pelos atalhos (`toast.success`, etc.). */
+export type ToastOptions = Partial<Omit<ToastItem, 'id' | 'message' | 'variant'>> & {
+    id?: string;
+};
+export type ToasterPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+export interface ToasterProps {
+    /** Posição do empilhamento na tela. Padrão: `top-right`. */
+    position?: ToasterPosition;
+    /** Duração padrão aplicada quando o toast não define a sua. */
+    duration?: number;
+    /** Máximo de toasts visíveis ao mesmo tempo (mais antigos são descartados). */
+    max?: number;
+    /** Classe adicional no viewport. */
+    className?: string;
+    /** z-index do viewport. Padrão: 9999. */
+    zIndex?: number;
+}

package/dist/components/organisms/Toaster/toastStore.d.ts ADDED Viewed

@@ -0,0 +1,17 @@
+import { ToastItem } from './toast.type';
+type Listener = (toasts: ToastItem[]) => void;
+/**
+ * Store externo dos toasts. Consumido pelo `<Toaster />` via
+ * `useSyncExternalStore`. Independente de React para permitir a API
+ * imperativa `toast.*` fora de componentes.
+ */
+export declare const toastStore: {
+    subscribe(listener: Listener): () => void;
+    getSnapshot(): ToastItem[];
+    add(toast: Omit<ToastItem, "id"> & {
+        id?: string;
+    }): string;
+    dismiss(id: string): void;
+    clear(): void;
+};
+export {};

package/dist/components/organisms/index.d.ts CHANGED Viewed

@@ -2,3 +2,5 @@ export * from './Header';
 export * from './Layout';
 export * from './Footer';
 export * from './HeroSection';
+export * from './Toaster';
+export * from './ConfirmationModal';

package/dist/contexts/index.d.ts ADDED Viewed

	@@ -0,0 +1 @@
1	+ export * from './theme';

package/dist/contexts/theme/ThemeProvider.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+import { ThemeProviderProps } from './theme.type';
+/**
+ * Provedor de tema (light / dark / system) com persistência em localStorage.
+ * Alterna a classe `dark` em `<html>` — os tokens de cor do design system
+ * já reagem a essa classe (ver `styles/colors.css`).
+ */
+export declare const ThemeProvider: ({ children, defaultTheme, storageKey, disableTransitionOnChange }: ThemeProviderProps) => import("react/jsx-runtime").JSX.Element;
+export default ThemeProvider;

package/dist/contexts/theme/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export * from './ThemeProvider';
+export * from './useTheme';
+export * from './theme.type';

package/dist/contexts/theme/theme.context.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import { ThemeContextValue } from './theme.type';
+/**
+ * Contexto interno do tema. Exposto via `useTheme()`.
+ * Mantido em arquivo separado para evitar avisos de fast-refresh
+ * (arquivos de componente devem exportar apenas componentes).
+ */
+export declare const ThemeContext: import('react').Context<ThemeContextValue | undefined>;

package/dist/contexts/theme/theme.type.d.ts ADDED Viewed

@@ -0,0 +1,23 @@
+/** Temas suportados. `system` segue a preferência do sistema operacional. */
+export type Theme = 'light' | 'dark' | 'system';
+/** Tema efetivamente aplicado no DOM (nunca `system`). */
+export type ResolvedTheme = 'light' | 'dark';
+export interface ThemeProviderProps {
+    children: React.ReactNode;
+    /** Tema inicial quando não há nada persistido. Padrão: `system`. */
+    defaultTheme?: Theme;
+    /** Chave usada no localStorage. Padrão: `fast-food-ui-theme`. */
+    storageKey?: string;
+    /** Desabilita as transições de cor no instante da troca de tema (evita flash). */
+    disableTransitionOnChange?: boolean;
+}
+export interface ThemeContextValue {
+    /** Tema escolhido pelo usuário (`light` | `dark` | `system`). */
+    theme: Theme;
+    /** Tema realmente aplicado (resolve `system` para `light`/`dark`). */
+    resolvedTheme: ResolvedTheme;
+    /** Define o tema. */
+    setTheme: (theme: Theme) => void;
+    /** Alterna entre `light` e `dark` (com base no tema resolvido atual). */
+    toggleTheme: () => void;
+}

package/dist/contexts/theme/useTheme.d.ts ADDED Viewed

@@ -0,0 +1,6 @@
+import { ThemeContextValue } from './theme.type';
+/**
+ * Acessa o tema atual e as ações de troca.
+ * Precisa estar dentro de um `<ThemeProvider>`.
+ */
+export declare const useTheme: () => ThemeContextValue;

package/dist/fast-food-design-system-1.34.0.tgz ADDED Viewed

Binary file