xertica-ui 2.9.7 → 2.9.8

package/CHANGELOG.md

@@ -11,6 +11,16 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [2.9.8] — 2026-07-14
+
+### Fixed
+
+- **Projeto gerado pelo scaffold "Web page" não compilava — erros de tipo de bibliotecas de terceiros** — `tsconfig.node.json` não tinha `skipLibCheck`, então o type-check processava as definições de tipo de dependências transitivas usadas internamente pelo Vite (`d3-array`, `prismjs`, etc.), e qualquer inconsistência nelas quebrava a compilação do projeto gerado, mesmo sem nenhum erro real no código do usuário. Corrigido adicionando `"skipLibCheck": true` a `templates/tsconfig.node.json`, usado tanto pelo scaffold "Web page" quanto pelo "Full system".
+- **Tela em branco no scaffold "Web page" — `Error: No QueryClient set, use QueryClientProvider to set one`** — o `App.tsx` gerado por `generateLandingAppTsx` (`bin/language-config.ts`) renderizava `<LandingPage>` direto dentro de `<XerticaProvider>`, sem `QueryClientProvider`, partindo do pressuposto de que a landing page não dependia de React Query. Só que `XerticaProvider` monta `LanguageProvider` internamente, e este chama `useQueryClient()` para invalidar queries traduzíveis na troca de idioma — sem um `QueryClientProvider` acima na árvore, o app quebra no primeiro render. Corrigido envolvendo o `App.tsx` gerado em `<QueryClientProvider client={queryClient}>` (com `queryClient = new QueryClient()`), o mesmo padrão que o scaffold "Full system" (`generateAppTsx`) já usava.
+- **Scroll não funcionava no scaffold "Web page"** — o CSS da própria lib (`styles/xertica/base.css`) define `html, body { height: 100%; overflow: hidden; }`, delegando o scroll a um container interno com altura própria resolvida. Como o `#root` gerado pelo Vite não tinha altura definida, a `LandingPage` (que usa `h-full overflow-y-auto`) não tinha em relação a que altura calcular seu próprio limite de scroll. Corrigido adicionando `#root { height: 100%; }` a `templates/src/styles/index.css`.
+
+---
+
 ## [2.9.7] — 2026-07-14
 
 ### Fixed

package/README.md

@@ -2,7 +2,7 @@
 
 > **Enterprise-grade React design system** built on Tailwind CSS v4, Radix UI, and Lucide Icons — with a robust AI-first documentation layer for precise LLM-driven composition and autonomous agent interaction.
 
-[![npm version](https://img.shields.io/badge/npm-2.9.7-blue)](https://www.npmjs.com/package/xertica-ui)
+[![npm version](https://img.shields.io/badge/npm-2.9.8-blue)](https://www.npmjs.com/package/xertica-ui)
 [![license](https://img.shields.io/badge/license-proprietary-red)](./LICENSE)
 
 ---

package/bin/language-config.ts

@@ -362,27 +362,35 @@ export default function App() {
 /**
  * Generate the App.tsx source for a minimal "web page" project — renders the
  * marketing `LandingPage` directly under `XerticaProvider`, with none of the
- * router/query-client/auth machinery the full system scaffold needs (the
- * landing page itself has no dependency on any of it).
+ * router/auth machinery the full system scaffold needs. `QueryClientProvider`
+ * is still required, though: `XerticaProvider` mounts `LanguageProvider`
+ * internally, which calls `useQueryClient()` to invalidate translated queries
+ * on language change — without a provider above it, the app throws "No
+ * QueryClient set" at render time.
  */
 export function generateLandingAppTsx(
   selectedCodes: string[],
   disableDarkMode: boolean = false
 ): string {
-  const disableDarkModeProp = disableDarkMode ? `\n      disableDarkMode={true}` : '';
-  const availableLanguagesProp = buildAvailableLanguagesProp(selectedCodes, '      ');
+  const disableDarkModeProp = disableDarkMode ? `\n        disableDarkMode={true}` : '';
+  const availableLanguagesProp = buildAvailableLanguagesProp(selectedCodes, '        ');
 
   return `import React from 'react';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { XerticaProvider } from 'xertica-ui/brand';
 import { LandingPage } from '../pages/LandingPage';
 
+const queryClient = new QueryClient();
+
 export default function App() {
   return (
-    <XerticaProvider
-      useCustomTokens={true}${availableLanguagesProp}${disableDarkModeProp}
-    >
-      <LandingPage />
-    </XerticaProvider>
+    <QueryClientProvider client={queryClient}>
+      <XerticaProvider
+        useCustomTokens={true}${availableLanguagesProp}${disableDarkModeProp}
+      >
+        <LandingPage />
+      </XerticaProvider>
+    </QueryClientProvider>
   );
 }
 `;

package/dist/cli.js

@@ -901,19 +901,24 @@ export default function App() {
 }
 function generateLandingAppTsx(selectedCodes, disableDarkMode = false) {
   const disableDarkModeProp = disableDarkMode ? `
-      disableDarkMode={true}` : "";
-  const availableLanguagesProp = buildAvailableLanguagesProp(selectedCodes, "      ");
+        disableDarkMode={true}` : "";
+  const availableLanguagesProp = buildAvailableLanguagesProp(selectedCodes, "        ");
   return `import React from 'react';
+import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
 import { XerticaProvider } from 'xertica-ui/brand';
 import { LandingPage } from '../pages/LandingPage';
 
+const queryClient = new QueryClient();
+
 export default function App() {
   return (
-    <XerticaProvider
-      useCustomTokens={true}${availableLanguagesProp}${disableDarkModeProp}
-    >
-      <LandingPage />
-    </XerticaProvider>
+    <QueryClientProvider client={queryClient}>
+      <XerticaProvider
+        useCustomTokens={true}${availableLanguagesProp}${disableDarkModeProp}
+      >
+        <LandingPage />
+      </XerticaProvider>
+    </QueryClientProvider>
   );
 }
 `;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xertica-ui",
-  "version": "2.9.7",
+  "version": "2.9.8",
   "description": "Xertica UI — Enterprise-grade React design system with Tailwind CSS v4, Radix UI, and AI-first documentation.",
   "type": "module",
   "main": "./dist/index.cjs.js",

package/templates/src/styles/index.css

@@ -93,3 +93,8 @@
   /* Gradients */
   --image-gradient-diagonal: var(--gradient-diagonal);
 }
+
+/* Ensure the root element fills the screen height, allowing container-level scrolling */
+#root {
+  height: 100%;
+}

package/templates/tsconfig.node.json

@@ -6,6 +6,7 @@
     "moduleResolution": "bundler",
     "allowSyntheticDefaultImports": true,
     "strict": true,
+    "skipLibCheck": true,
     "composite": true
   },
   "include": ["vite.config.ts"]