tempest-react-sdk 0.58.0 → 0.60.0

package/dist/vite.d.ts

@@ -69,6 +69,25 @@ export declare interface CreateViteConfigOptions {
  */
 export declare type ProxyEntry = string | Record<string, unknown>;
 
+/**
+ * How much of the reset an app takes.
+ *
+ * The components are written against the reset — `.tempest_button` assumes
+ * `button { background: none; border: 0; padding: 0 }`, every width assumes
+ * `box-sizing: border-box` — so `"none"` is not "unstyled document, styled
+ * components": it is components missing their box model. It exists for the app
+ * that already ships an equivalent reset of its own.
+ */
+export declare type ResetMode = "scoped" | "global" | "none";
+
+/** Shape of `dist/styles/manifest.json`. */
+export declare interface StyleManifest {
+    /** The foundation sheet — tokens and reset together, the pre-split default. */
+    core: string;
+    /** Public export name → the stylesheets it needs, transitive closure included. */
+    components: Record<string, readonly string[]>;
+}
+
 /**
  * Generate a static icon registry from the slugs your source mentions.
  *
@@ -250,6 +269,69 @@ export declare interface TempestPwaManifestOptions {
     appShell?: string | false;
 }
 
+/**
+ * Import only the SDK stylesheets your app can actually reach.
+ *
+ * `styles.css` carries every component the SDK ships — measured at 236.71 kB raw
+ * against the 38.94 kB an app mounting twelve of them can reach. The per-component
+ * sheets under `styles/` have always closed that gap, but by hand: the app lists
+ * them and keeps the list honest as it grows. This plugin makes the list the build's
+ * problem, resolving it from the imports the source already writes.
+ *
+ * The closure matters more than the scan. A component pays for the CSS of every SDK
+ * component it renders internally, so `<DataTable>` alone needs six sheets and
+ * `<AIChat>` seven — a hand-kept list of one sheet per component the app names is
+ * wrong in a way that only shows up as an unstyled child.
+ *
+ * The reset is the other half, and the half that breaks apps. `styles.css` claims
+ * `html`, `body` and `#root`; an app with its own layout that imports it loses its
+ * document surface, and an app that drops the import loses the box model its
+ * components are written against — components render unstyled, which is what the
+ * "just remove the import" fix actually costs. The default `reset: "scoped"` is the
+ * third option: the same normalisation, confined to
+ * `:where([class*="tempest_"])`, so it reaches inside a Tempest component and
+ * nowhere else.
+ *
+ * `tempest-react-sdk/styles/auto.css` is a real file, so it resolves without the
+ * plugin too — to the complete sheet. Dropping the plugin costs bytes, never
+ * correctness.
+ *
+ * @param options - Scan configuration.
+ * @returns The Vite plugin.
+ *
+ * @example
+ * // vite.config.ts
+ * import { createViteConfig, tempestStyles } from "tempest-react-sdk/vite";
+ *
+ * export default createViteConfig({ plugins: [tempestStyles()] });
+ *
+ * @example
+ * // src/main.tsx — the one import, instead of a maintained list
+ * import "tempest-react-sdk/styles/auto.css";
+ */
+export declare function tempestStyles(options?: TempestStylesOptions): TempestVitePlugin;
+
+export declare interface TempestStylesOptions {
+    /** Directory to scan, relative to the Vite root. Default: `"src"`. */
+    dir?: string;
+    /**
+     * Which reset to emit alongside the tokens. Default: `"scoped"`.
+     *
+     * `"scoped"` confines the reset to `:where([class*="tempest_"])`, so components
+     * keep the normalisation they are written against and the app keeps `html`,
+     * `body` and `#root`. `"global"` is the pre-split behaviour, correct when the
+     * SDK owns the whole page. `"none"` emits tokens only.
+     */
+    reset?: ResetMode;
+    /**
+     * Extra export names to style even when the scan cannot see them — a component
+     * reached only through a namespace import, or rendered by a sibling package.
+     */
+    include?: readonly string[];
+    /** Directory names to skip. Default: `node_modules`, `dist`, `build`, `coverage`. */
+    skipDirs?: readonly string[];
+}
+
 /**
  * The resulting Vite config object. Typed loosely so the SDK's published
  * declarations stay free of `vite`'s internal types; assign it straight to a

package/dist/vite.js

@@ -3,4 +3,5 @@ import { createViteConfig as t } from "./vite/create-vite-config.js";
 import { tempestPwaManifest as n } from "./vite/tempest-pwa-manifest.js";
 import { tempestPwaIcons as r } from "./vite/tempest-pwa-icons.js";
 import { tempestPwaDevSw as i } from "./vite/tempest-pwa-dev-sw.js";
-export { t as createViteConfig, e as tempestIcons, i as tempestPwaDevSw, r as tempestPwaIcons, n as tempestPwaManifest };
+import { tempestStyles as a } from "./vite/tempest-styles.js";
+export { t as createViteConfig, e as tempestIcons, i as tempestPwaDevSw, r as tempestPwaIcons, n as tempestPwaManifest, a as tempestStyles };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.58.0",
+  "version": "0.60.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -102,12 +102,13 @@
     },
     "./styles.css": "./dist/styles.css",
     "./styles/*.css": "./dist/styles/*.css",
+    "./styles/manifest.json": "./dist/styles/manifest.json",
     "./package.json": "./package.json",
     "./utilities.css": "./dist/utilities.css"
   },
   "scripts": {
     "dev": "vite build --watch",
-    "build": "tsc -b tsconfig.build.json && node --max-old-space-size=6144 ./node_modules/vite/bin/vite.js build && node scripts/copy-css-assets.mjs && node scripts/split-css.mjs",
+    "build": "node scripts/gen-scoped-reset.mjs && tsc -b tsconfig.build.json && node --max-old-space-size=6144 ./node_modules/vite/bin/vite.js build && node scripts/split-css.mjs && node scripts/gen-style-manifest.mjs && node scripts/copy-css-assets.mjs",
     "postbuild": "node scripts/check-dist-guards.mjs",
     "typecheck": "tsc -b tsconfig.json --noEmit",
     "lint": "eslint .",