ies2-aulapp-ui-kit 0.1.13 → 0.2.0

package/dist/lib/i18n/components/I18nProvider.d.ts

@@ -0,0 +1,38 @@
+import { ReactNode } from 'react';
+import { SupportedLocale } from '../types.js';
+export interface I18nProviderProps {
+    /**
+     * Componentes filhos que terão acesso ao contexto de tradução
+     */
+    children: ReactNode;
+    /**
+     * Locale inicial ou controlado externamente.
+     * Se fornecido, o i18n será inicializado/atualizado com este idioma.
+     */
+    locale?: SupportedLocale;
+}
+/**
+ * Provider de internacionalização para o UI Kit.
+ * Envolva sua aplicação com este provider para habilitar traduções.
+ *
+ * @example
+ * ```tsx
+ * // Uso básico (idioma padrão pt-BR)
+ * <I18nProvider>
+ *   <App />
+ * </I18nProvider>
+ *
+ * // Controlando o idioma externamente
+ * function MyApp() {
+ *   const [locale, setLocale] = useState<SupportedLocale>('en-US')
+ *
+ *   return (
+ *     <I18nProvider locale={locale}>
+ *       <App />
+ *       <button onClick={() => setLocale('pt-BR')}>PT-BR</button>
+ *     </I18nProvider>
+ *   )
+ * }
+ * ```
+ */
+export declare function I18nProvider({ children, locale }: I18nProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/lib/i18n/components/LanguageSwitcher.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Componente de exemplo que demonstra como trocar o idioma da aplicação
+ * Este componente pode ser usado como referência para implementar
+ * seleção de idioma em aplicações que consomem o UI Kit
+ */
+export declare function LanguageSwitcher(): import("react/jsx-runtime").JSX.Element;

package/dist/lib/i18n/config.d.ts

@@ -0,0 +1,2 @@
+import { default as i18n } from 'i18next';
+export default i18n;

package/dist/lib/i18n/hooks/useI18n.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Hook personalizado para gerenciar internacionalização no UI Kit
+ * O i18n do kit é auto-contido e não interfere com o sistema de
+ * tradução do projeto consumidor.
+ *
+ * @param namespace - O namespace de tradução a ser usado
+ * (ex: 'heroBanner', 'componentsPanel')
+ * @param locale - Locale opcional (string simples, ex: 'pt-BR',
+ * 'en-US', 'es'). Se não fornecido, usa o padrão (pt-BR)
+ * @returns Objeto contendo a função de tradução e utilidades
+ *
+ * @example
+ * ```tsx
+ * // Uso simples - idioma padrão
+ * function MyComponent() {
+ *   const { t } = useI18n('heroBanner')
+ *   return <h1>{t('title')}</h1>
+ * }
+ *
+ * // Com locale específico (vem do projeto pai)
+ * function MyComponent({ userLocale }: { userLocale?: string }) {
+ *   const { t } = useI18n('heroBanner', userLocale)
+ *   return <h1>{t('title')}</h1>
+ * }
+ * ```
+ */
+export declare function useI18n(namespace?: string, locale?: string): {
+    t: import('i18next').TFunction<string, undefined>;
+    changeLanguage: (newLocale: string) => Promise<void>;
+    currentLanguage: string;
+    i18n: import('i18next').i18n;
+};

package/dist/lib/i18n/index.d.ts

@@ -0,0 +1,5 @@
+export { default as i18n } from './config.js';
+export * from './types.js';
+export * from './hooks/useI18n.js';
+export * from './components/LanguageSwitcher.js';
+export * from './components/I18nProvider.js';

package/dist/lib/i18n/locales/en-US/badges-panel.json.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+  "sectionLabel": "Tags",
+  "sectionTitle": "Badges",
+  "description": "Quick indicators of content and available resources.",
+  "appearances": {
+    "solid": "Solid",
+    "subtle": "Subtle",
+    "outline": "Outline",
+    "text": "Text"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/en-US/call-to-action-panel.json.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {
+  "sectionLabel": "Action",
+  "sectionTitle": "Call to Action",
+  "description": "Use the kit to accelerate the development of consistent experiences across multiple React apps.",
+  "buttons": {
+    "explore": "Explore components",
+    "documentation": "Documentation",
+    "undo": "Undo change"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/en-US/common.json.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+  "loading": "Loading...",
+  "error": "Error",
+  "success": "Success"
+};
+
+export default _default;

package/dist/lib/i18n/locales/en-US/components-panel.json.d.ts

@@ -0,0 +1,19 @@
+declare const _default: {
+  "sectionLabel": "Components",
+  "sectionTitle": "Buttons",
+  "buttons": {
+    "primary": "Primary",
+    "secondary": "Secondary",
+    "neutral": "Neutral",
+    "ctaWithRadius": "CTA with 8px radius",
+    "outline": "Soft outline",
+    "outlineWithRadius": "Soft outline with 8px radius",
+    "ghost": "Ghost",
+    "createAriaLabel": "Create"
+  },
+  "switch": {
+    "airplaneMode": "Airplane Mode"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/en-US/hero-banner.json.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+  "subtitle": "ies2 aulapp ui kit",
+  "title": "Production-ready shareable components",
+  "description": "This sandbox reflects the current state of the design system. Evaluate each component before publishing a new npm release."
+};
+
+export default _default;

package/dist/lib/i18n/locales/es/badges-panel.json.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+  "sectionLabel": "Etiquetas",
+  "sectionTitle": "Badges",
+  "description": "Indicadores rápidos de contenido y recursos disponibles.",
+  "appearances": {
+    "solid": "Solid",
+    "subtle": "Subtle",
+    "outline": "Outline",
+    "text": "Text"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/es/call-to-action-panel.json.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {
+  "sectionLabel": "Acción",
+  "sectionTitle": "Call to Action",
+  "description": "Use el kit para acelerar el desarrollo de experiencias consistentes en múltiples apps React.",
+  "buttons": {
+    "explore": "Explorar componentes",
+    "documentation": "Documentación",
+    "undo": "Deshacer cambio"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/es/common.json.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+  "loading": "Cargando...",
+  "error": "Error",
+  "success": "Éxito"
+};
+
+export default _default;

package/dist/lib/i18n/locales/es/components-panel.json.d.ts

@@ -0,0 +1,19 @@
+declare const _default: {
+  "sectionLabel": "Componentes",
+  "sectionTitle": "Botones",
+  "buttons": {
+    "primary": "Primario",
+    "secondary": "Secundario",
+    "neutral": "Neutral",
+    "ctaWithRadius": "CTA con radio 8px",
+    "outline": "Contorno suave",
+    "outlineWithRadius": "Contorno suave con radio 8px",
+    "ghost": "Ghost",
+    "createAriaLabel": "Crear"
+  },
+  "switch": {
+    "airplaneMode": "Modo Avión"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/es/hero-banner.json.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+  "subtitle": "ies2 aulapp ui kit",
+  "title": "Componentes compartibles listos para producción",
+  "description": "Este sandbox refleja el estado actual del design system. Evalúe cada componente antes de publicar una nueva versión en npm."
+};
+
+export default _default;

package/dist/lib/i18n/locales/pt-BR/badges-panel.json.d.ts

@@ -0,0 +1,13 @@
+declare const _default: {
+  "sectionLabel": "Tags",
+  "sectionTitle": "Badges",
+  "description": "Indicadores rápidos de conteúdo e recursos disponíveis.",
+  "appearances": {
+    "solid": "Solid",
+    "subtle": "Subtle",
+    "outline": "Outline",
+    "text": "Text"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/pt-BR/call-to-action-panel.json.d.ts

@@ -0,0 +1,12 @@
+declare const _default: {
+  "sectionLabel": "Ação",
+  "sectionTitle": "Call to Action",
+  "description": "Use o kit para acelerar o desenvolvimento de experiências consistentes em múltiplos apps React.",
+  "buttons": {
+    "explore": "Explorar componentes",
+    "documentation": "Documentação",
+    "undo": "Desfazer alteração"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/pt-BR/common.json.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+  "loading": "Carregando...",
+  "error": "Erro",
+  "success": "Sucesso"
+};
+
+export default _default;

package/dist/lib/i18n/locales/pt-BR/components-panel.json.d.ts

@@ -0,0 +1,19 @@
+declare const _default: {
+  "sectionLabel": "Componentes",
+  "sectionTitle": "Botões",
+  "buttons": {
+    "primary": "Primário",
+    "secondary": "Secundário",
+    "neutral": "Neutro",
+    "ctaWithRadius": "CTA com raio 8px",
+    "outline": "Outline suave",
+    "outlineWithRadius": "Outline suave com raio 8px",
+    "ghost": "Ghost",
+    "createAriaLabel": "Criar"
+  },
+  "switch": {
+    "airplaneMode": "Modo Avião"
+  }
+};
+
+export default _default;

package/dist/lib/i18n/locales/pt-BR/hero-banner.json.d.ts

@@ -0,0 +1,7 @@
+declare const _default: {
+  "subtitle": "ies2 aulapp ui kit",
+  "title": "Componentes compartilháveis prontos para produção",
+  "description": "Esta sandbox reflete o estado atual do design system. Avalie cada componente antes de publicar um novo release no npm."
+};
+
+export default _default;

package/dist/lib/i18n/types.d.ts

@@ -0,0 +1,4 @@
+export type SupportedLocale = 'pt-BR' | 'en-US' | 'es';
+export declare const SUPPORTED_LOCALES: SupportedLocale[];
+export declare const DEFAULT_LOCALE: SupportedLocale;
+export declare const LOCALE_LABELS: Record<SupportedLocale, string>;

package/dist/stories/i18n.stories.d.ts

@@ -0,0 +1,14 @@
+import { StoryObj } from '@storybook/react';
+import { LanguageSwitcher } from '../lib/i18n/components/LanguageSwitcher';
+declare const meta: {
+    title: string;
+    component: typeof LanguageSwitcher;
+    parameters: {
+        layout: string;
+    };
+    tags: string[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+export declare const LanguageSwitcherComponent: Story;
+export declare const WithTranslatedContent: Story;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "ies2-aulapp-ui-kit",
   "private": false,
-  "version": "0.1.13",
+  "version": "0.2.0",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.es.js",
@@ -25,7 +25,9 @@
     "@radix-ui/react-tabs": "^1.1.13",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
+    "i18next": "^25.7.4",
     "iconsax-react": "^0.0.8",
+    "react-i18next": "^16.5.3",
     "tailwind-merge": "^3.4.0"
   },
   "peerDependencies": {