tempest-react-sdk 0.5.0 → 0.7.0

package/dist/vite.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("node:path"),v=require("vite"),f=require("@vitejs/plugin-react");function d(t){const r={};for(const[n,e]of Object.entries(t))r[n]=typeof e=="string"?{target:e,changeOrigin:!0}:e;return r}function y(t={}){const{srcDir:r="src",port:n=5173,host:e="127.0.0.1",open:c=!1,proxy:i,alias:l={},plugins:u=[],overrides:a={}}=t,o=a,s={plugins:[f(),...u],resolve:{alias:{"@":p.resolve(process.cwd(),r),...l}},server:{port:n,host:e,open:c,...i?{proxy:d(i)}:{}}},g={...s,...o,plugins:[...s.plugins??[],...o.plugins??[]],resolve:{...s.resolve,...o.resolve},server:{...s.server,...o.server}};return v.defineConfig(g)}exports.createViteConfig=y;
+//# sourceMappingURL=vite.cjs.map

package/dist/vite.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.cjs","sources":["../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { ProxyOptions, UserConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n\n    const base: UserConfig = {\n        plugins: [react(), ...plugins] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"names":["normalizeProxy","proxy","out","path","value","createViteConfig","options","srcDir","port","host","open","alias","plugins","overrides","overridesConfig","base","react","resolve","merged","defineConfig"],"mappings":"iKAgDA,SAASA,EAAeC,EAAiE,CACrF,MAAMC,EAAoC,CAAA,EAC1C,SAAW,CAACC,EAAMC,CAAK,IAAK,OAAO,QAAQH,CAAK,EAC5CC,EAAIC,CAAI,EACJ,OAAOC,GAAU,SACX,CAAE,OAAQA,EAAO,aAAc,EAAA,EAC9BA,EAEf,OAAOF,CACX,CAkBO,SAASG,EAAiBC,EAAmC,GAAuB,CACvF,KAAM,CACF,OAAAC,EAAS,MACT,KAAAC,EAAO,KACP,KAAAC,EAAO,YACP,KAAAC,EAAO,GACP,MAAAT,EACA,MAAAU,EAAQ,CAAA,EACR,QAAAC,EAAU,CAAA,EACV,UAAAC,EAAY,CAAA,CAAC,EACbP,EAEEQ,EAAkBD,EAElBE,EAAmB,CACrB,QAAS,CAACC,IAAS,GAAGJ,CAAO,EAC7B,QAAS,CACL,MAAO,CACH,IAAKK,EAAAA,QAAQ,QAAQ,IAAA,EAAOV,CAAM,EAClC,GAAGI,CAAA,CACP,EAEJ,OAAQ,CACJ,KAAAH,EACA,KAAAC,EACA,KAAAC,EACA,GAAIT,EAAQ,CAAE,MAAOD,EAAeC,CAAK,CAAA,EAAM,CAAA,CAAC,CACpD,EAGEiB,EAAqB,CACvB,GAAGH,EACH,GAAGD,EACH,QAAS,CAAC,GAAIC,EAAK,SAAW,CAAA,EAAK,GAAID,EAAgB,SAAW,EAAG,EACrE,QAAS,CAAE,GAAGC,EAAK,QAAS,GAAGD,EAAgB,OAAA,EAC/C,OAAQ,CAAE,GAAGC,EAAK,OAAQ,GAAGD,EAAgB,MAAA,CAAO,EAGxD,OAAOK,EAAAA,aAAaD,CAAM,CAC9B"}

package/dist/vite.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`
+ * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a
+ * consuming app's `vite.config.ts` is a single call instead of repeated
+ * boilerplate. Everything is overridable.
+ *
+ * Import it from the dedicated Node entry point:
+ *
+ * @example
+ * // vite.config.ts
+ * import { createViteConfig } from "tempest-react-sdk/vite";
+ *
+ * export default createViteConfig({
+ *     proxy: { "/api": "http://127.0.0.1:8000" },
+ * });
+ */
+export declare function createViteConfig(options?: CreateViteConfigOptions): TempestViteConfig;
+
+export declare interface CreateViteConfigOptions {
+    /**
+     * Source directory aliased to `@`, relative to the project root.
+     * Default: `"src"` (so `@/components/Button` → `<root>/src/components/Button`).
+     */
+    srcDir?: string;
+    /** Dev server port. Default: `5173`. */
+    port?: number;
+    /** Dev server host. Default: `"127.0.0.1"`. */
+    host?: string | boolean;
+    /** Open the browser on `dev` start. Default: `false`. */
+    open?: boolean;
+    /**
+     * Dev proxy table. String values are expanded to
+     * `{ target, changeOrigin: true }`; objects are passed through untouched.
+     *
+     * @example { "/api": "http://127.0.0.1:8000" }
+     */
+    proxy?: Record<string, ProxyEntry>;
+    /** Extra path aliases merged on top of the default `@` → src alias. */
+    alias?: Record<string, string>;
+    /** Vite plugins appended after `@vitejs/plugin-react`. */
+    plugins?: unknown[];
+    /**
+     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for
+     * escape-hatch overrides (build target, define, extra `server` keys, …).
+     */
+    overrides?: Record<string, unknown>;
+}
+
+/**
+ * A Vite proxy entry: either a target URL string (expanded to
+ * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.
+ */
+export declare type ProxyEntry = string | Record<string, unknown>;
+
+/**
+ * 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
+ * `vite.config.ts` default export.
+ */
+export declare type TempestViteConfig = Record<string, unknown>;
+
+export { }

package/dist/vite.js

@@ -0,0 +1,46 @@
+import { resolve as g } from "node:path";
+import { defineConfig as u } from "vite";
+import v from "@vitejs/plugin-react";
+function m(t) {
+  const r = {};
+  for (const [n, e] of Object.entries(t))
+    r[n] = typeof e == "string" ? { target: e, changeOrigin: !0 } : e;
+  return r;
+}
+function h(t = {}) {
+  const {
+    srcDir: r = "src",
+    port: n = 5173,
+    host: e = "127.0.0.1",
+    open: c = !1,
+    proxy: i,
+    alias: p = {},
+    plugins: l = [],
+    overrides: a = {}
+  } = t, o = a, s = {
+    plugins: [v(), ...l],
+    resolve: {
+      alias: {
+        "@": g(process.cwd(), r),
+        ...p
+      }
+    },
+    server: {
+      port: n,
+      host: e,
+      open: c,
+      ...i ? { proxy: m(i) } : {}
+    }
+  }, f = {
+    ...s,
+    ...o,
+    plugins: [...s.plugins ?? [], ...o.plugins ?? []],
+    resolve: { ...s.resolve, ...o.resolve },
+    server: { ...s.server, ...o.server }
+  };
+  return u(f);
+}
+export {
+  h as createViteConfig
+};
+//# sourceMappingURL=vite.js.map

package/dist/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sources":["../src/vite/create-vite-config.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { defineConfig } from \"vite\";\nimport type { ProxyOptions, UserConfig } from \"vite\";\nimport react from \"@vitejs/plugin-react\";\n\n/**\n * A Vite proxy entry: either a target URL string (expanded to\n * `{ target, changeOrigin: true }`) or a raw Vite `ProxyOptions` object.\n */\nexport type ProxyEntry = string | Record<string, unknown>;\n\nexport interface CreateViteConfigOptions {\n    /**\n     * Source directory aliased to `@`, relative to the project root.\n     * Default: `\"src\"` (so `@/components/Button` → `<root>/src/components/Button`).\n     */\n    srcDir?: string;\n    /** Dev server port. Default: `5173`. */\n    port?: number;\n    /** Dev server host. Default: `\"127.0.0.1\"`. */\n    host?: string | boolean;\n    /** Open the browser on `dev` start. Default: `false`. */\n    open?: boolean;\n    /**\n     * Dev proxy table. String values are expanded to\n     * `{ target, changeOrigin: true }`; objects are passed through untouched.\n     *\n     * @example { \"/api\": \"http://127.0.0.1:8000\" }\n     */\n    proxy?: Record<string, ProxyEntry>;\n    /** Extra path aliases merged on top of the default `@` → src alias. */\n    alias?: Record<string, string>;\n    /** Vite plugins appended after `@vitejs/plugin-react`. */\n    plugins?: unknown[];\n    /**\n     * Arbitrary Vite config (a `UserConfig` object) deep-merged last, for\n     * escape-hatch overrides (build target, define, extra `server` keys, …).\n     */\n    overrides?: Record<string, unknown>;\n}\n\n/**\n * The resulting Vite config object. Typed loosely so the SDK's published\n * declarations stay free of `vite`'s internal types; assign it straight to a\n * `vite.config.ts` default export.\n */\nexport type TempestViteConfig = Record<string, unknown>;\n\nfunction normalizeProxy(proxy: Record<string, ProxyEntry>): Record<string, ProxyOptions> {\n    const out: Record<string, ProxyOptions> = {};\n    for (const [path, value] of Object.entries(proxy)) {\n        out[path] =\n            typeof value === \"string\"\n                ? { target: value, changeOrigin: true }\n                : (value as ProxyOptions);\n    }\n    return out;\n}\n\n/**\n * Build a Tempest-flavored Vite config for a React app: the `@vitejs/plugin-react`\n * plugin, the `@` → `src` import alias, and sane dev-server defaults — so a\n * consuming app's `vite.config.ts` is a single call instead of repeated\n * boilerplate. Everything is overridable.\n *\n * Import it from the dedicated Node entry point:\n *\n * @example\n * // vite.config.ts\n * import { createViteConfig } from \"tempest-react-sdk/vite\";\n *\n * export default createViteConfig({\n *     proxy: { \"/api\": \"http://127.0.0.1:8000\" },\n * });\n */\nexport function createViteConfig(options: CreateViteConfigOptions = {}): TempestViteConfig {\n    const {\n        srcDir = \"src\",\n        port = 5173,\n        host = \"127.0.0.1\",\n        open = false,\n        proxy,\n        alias = {},\n        plugins = [],\n        overrides = {},\n    } = options;\n\n    const overridesConfig = overrides as UserConfig;\n\n    const base: UserConfig = {\n        plugins: [react(), ...plugins] as UserConfig[\"plugins\"],\n        resolve: {\n            alias: {\n                \"@\": resolve(process.cwd(), srcDir),\n                ...alias,\n            },\n        },\n        server: {\n            port,\n            host,\n            open,\n            ...(proxy ? { proxy: normalizeProxy(proxy) } : {}),\n        },\n    };\n\n    const merged: UserConfig = {\n        ...base,\n        ...overridesConfig,\n        plugins: [...(base.plugins ?? []), ...(overridesConfig.plugins ?? [])],\n        resolve: { ...base.resolve, ...overridesConfig.resolve },\n        server: { ...base.server, ...overridesConfig.server },\n    };\n\n    return defineConfig(merged) as TempestViteConfig;\n}\n"],"names":["normalizeProxy","proxy","out","path","value","createViteConfig","options","srcDir","port","host","open","alias","plugins","overrides","overridesConfig","base","react","resolve","merged","defineConfig"],"mappings":";;;AAgDA,SAASA,EAAeC,GAAiE;AACrF,QAAMC,IAAoC,CAAA;AAC1C,aAAW,CAACC,GAAMC,CAAK,KAAK,OAAO,QAAQH,CAAK;AAC5C,IAAAC,EAAIC,CAAI,IACJ,OAAOC,KAAU,WACX,EAAE,QAAQA,GAAO,cAAc,GAAA,IAC9BA;AAEf,SAAOF;AACX;AAkBO,SAASG,EAAiBC,IAAmC,IAAuB;AACvF,QAAM;AAAA,IACF,QAAAC,IAAS;AAAA,IACT,MAAAC,IAAO;AAAA,IACP,MAAAC,IAAO;AAAA,IACP,MAAAC,IAAO;AAAA,IACP,OAAAT;AAAA,IACA,OAAAU,IAAQ,CAAA;AAAA,IACR,SAAAC,IAAU,CAAA;AAAA,IACV,WAAAC,IAAY,CAAA;AAAA,EAAC,IACbP,GAEEQ,IAAkBD,GAElBE,IAAmB;AAAA,IACrB,SAAS,CAACC,KAAS,GAAGJ,CAAO;AAAA,IAC7B,SAAS;AAAA,MACL,OAAO;AAAA,QACH,KAAKK,EAAQ,QAAQ,IAAA,GAAOV,CAAM;AAAA,QAClC,GAAGI;AAAA,MAAA;AAAA,IACP;AAAA,IAEJ,QAAQ;AAAA,MACJ,MAAAH;AAAA,MACA,MAAAC;AAAA,MACA,MAAAC;AAAA,MACA,GAAIT,IAAQ,EAAE,OAAOD,EAAeC,CAAK,EAAA,IAAM,CAAA;AAAA,IAAC;AAAA,EACpD,GAGEiB,IAAqB;AAAA,IACvB,GAAGH;AAAA,IACH,GAAGD;AAAA,IACH,SAAS,CAAC,GAAIC,EAAK,WAAW,CAAA,GAAK,GAAID,EAAgB,WAAW,EAAG;AAAA,IACrE,SAAS,EAAE,GAAGC,EAAK,SAAS,GAAGD,EAAgB,QAAA;AAAA,IAC/C,QAAQ,EAAE,GAAGC,EAAK,QAAQ,GAAGD,EAAgB,OAAA;AAAA,EAAO;AAGxD,SAAOK,EAAaD,CAAM;AAC9B;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tempest-react-sdk",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "SDK público da Tempest com componentes, hooks e integrações para projetos React.",
   "type": "module",
   "license": "MIT",
@@ -23,9 +23,14 @@
   ],
   "files": [
     "dist",
+    "bin",
+    "template",
     "README.md",
     "LICENSE"
   ],
+  "bin": {
+    "create-tempest-app": "./bin/create-tempest-app.mjs"
+  },
   "main": "./dist/tempest-react-sdk.cjs",
   "module": "./dist/tempest-react-sdk.js",
   "types": "./dist/tempest-react-sdk.d.ts",
@@ -43,6 +48,11 @@
       "import": "./dist/testing.js",
       "require": "./dist/testing.cjs"
     },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "import": "./dist/vite.js",
+      "require": "./dist/vite.cjs"
+    },
     "./styles.css": "./dist/styles.css",
     "./package.json": "./package.json"
   },
@@ -57,6 +67,7 @@
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage",
     "clean": "rm -rf dist coverage",
+    "size": "size-limit",
     "prepare": "husky",
     "prepublishOnly": "npm run typecheck && npm run lint && npm run test:run && npm run build"
   },
@@ -74,15 +85,27 @@
     "dexie": "^4.4.2",
     "lucide-react": ">=0.400.0",
     "react-hook-form": "^7.76.0",
+    "react-router-dom": "^7.18.0",
     "zod": "^3.23.0 || ^4.0.0",
     "zustand": "^4.0.0 || ^5.0.0"
   },
   "peerDependencies": {
+    "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "react": "^18.0.0 || ^19.0.0",
-    "react-dom": "^18.0.0 || ^19.0.0"
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    },
+    "@vitejs/plugin-react": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@eslint/js": "^9.36.0",
+    "@size-limit/preset-small-lib": "^12.1.0",
     "@tanstack/react-query": "^5.90.0",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
@@ -106,6 +129,7 @@
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-hook-form": "^7.76.0",
+    "size-limit": "^12.1.0",
     "typescript": "~5.9.0",
     "typescript-eslint": "^8.45.0",
     "vite": "^7.0.0",

package/template/README.md

@@ -0,0 +1,37 @@
+# Tempest App
+
+Scaffolded with [`create-tempest-app`](https://www.npmjs.com/package/create-tempest-app) and powered by [`tempest-react-sdk`](https://www.npmjs.com/package/tempest-react-sdk).
+
+## Stack
+
+- **Vite** with the `@` → `src` alias (`tempest-react-sdk/vite` → `createViteConfig`)
+- **React Router v7** declarative routing (`defineRoutes` + `<AppRouter>`)
+- **Zustand** state (`createAuthStore` + `createSelectors`)
+- **TanStack Query** cache (mounted by `<AppProviders>`)
+
+## Getting started
+
+```bash
+npm install
+cp .env.example .env   # adjust VITE_API_URL
+npm run dev            # http://127.0.0.1:5173
+```
+
+## Layout
+
+```text
+src/
+├── main.tsx              # mounts <App /> + SDK styles
+├── App.tsx               # <AppProviders> + <AppRouter>
+├── routes.tsx            # declarative route tree (lazy + guard)
+├── layouts/RootLayout.tsx
+├── pages/                # Home, Login, Dashboard (lazy + guarded)
+├── stores/auth.ts        # persisted Zustand auth store
+└── lib/api.ts            # typed HTTP client + query keys
+```
+
+## Next steps
+
+- Add a route: drop a page in `src/pages/` and an entry in `src/routes.tsx`.
+- Add state: `createStore<T>()` in `src/stores/`.
+- Fetch data: `useQuery({ queryKey: queryKeys.me(), queryFn: () => api.get("/me") })`.

package/template/_env.example

@@ -0,0 +1,2 @@
+# Base URL of your backend API (consumed by src/lib/api.ts).
+VITE_API_URL=http://127.0.0.1:8000

package/template/_gitignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+dist-ssr
+*.local
+.env
+.env.*
+!.env.example
+.DS_Store
+*.log

package/template/eslint.config.js

@@ -0,0 +1,27 @@
+import js from "@eslint/js";
+import globals from "globals";
+import reactHooks from "eslint-plugin-react-hooks";
+import reactRefresh from "eslint-plugin-react-refresh";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+    { ignores: ["dist", "node_modules"] },
+    {
+        extends: [js.configs.recommended, ...tseslint.configs.recommended],
+        files: ["**/*.{ts,tsx}"],
+        languageOptions: {
+            ecmaVersion: 2022,
+            globals: globals.browser,
+        },
+        plugins: {
+            "react-hooks": reactHooks,
+            "react-refresh": reactRefresh,
+        },
+        rules: {
+            ...reactHooks.configs.recommended.rules,
+            "react-refresh/only-export-components": ["warn", { allowConstantExport: true }],
+            "@typescript-eslint/consistent-type-imports": "error",
+            "@typescript-eslint/no-unused-vars": ["error", { argsIgnorePattern: "^_" }],
+        },
+    },
+);

package/template/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="pt-BR">
+    <head>
+        <meta charset="UTF-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+        <title>Tempest App</title>
+    </head>
+    <body>
+        <div id="root"></div>
+        <script type="module" src="/src/main.tsx"></script>
+    </body>
+</html>

package/template/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "tempest-app",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc --noEmit && vite build",
+    "preview": "vite preview",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
+  },
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tempest-react-sdk": "^0.6.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.36.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^5.0.0",
+    "eslint": "^9.36.0",
+    "eslint-plugin-react-hooks": "^5.2.0",
+    "eslint-plugin-react-refresh": "^0.4.22",
+    "globals": "^16.0.0",
+    "typescript": "~5.9.0",
+    "typescript-eslint": "^8.45.0",
+    "vite": "^7.0.0"
+  }
+}

package/template/src/App.tsx

@@ -0,0 +1,15 @@
+import { AppProviders, AppRouter } from "tempest-react-sdk";
+import { routes } from "@/routes";
+
+/**
+ * App root. `AppProviders` composes the error boundary, TanStack Query and
+ * theme; `AppRouter` renders the declarative route tree with a Suspense
+ * fallback for lazy routes.
+ */
+export function App() {
+    return (
+        <AppProviders errorBoundary={{ fallback: <p>Something went wrong.</p> }}>
+            <AppRouter routes={routes} fallback={<p>Loading…</p>} />
+        </AppProviders>
+    );
+}

package/template/src/layouts/RootLayout.tsx

@@ -0,0 +1,28 @@
+import { Link, Outlet } from "tempest-react-sdk";
+import { useAuth } from "@/stores/auth";
+
+/** App shell: nav bar + routed content via `<Outlet />`. */
+export function RootLayout() {
+    const isAuthenticated = useAuth.use.isAuthenticated();
+    const logout = useAuth.use.logout();
+
+    return (
+        <div style={{ fontFamily: "system-ui, sans-serif", maxWidth: 720, margin: "0 auto", padding: 24 }}>
+            <header style={{ display: "flex", gap: 16, alignItems: "center", marginBottom: 24 }}>
+                <strong>Tempest App</strong>
+                <nav style={{ display: "flex", gap: 12 }}>
+                    <Link to="/">Home</Link>
+                    <Link to="/dashboard">Dashboard</Link>
+                    {isAuthenticated ? (
+                        <button onClick={logout}>Logout</button>
+                    ) : (
+                        <Link to="/login">Login</Link>
+                    )}
+                </nav>
+            </header>
+            <main>
+                <Outlet />
+            </main>
+        </div>
+    );
+}

package/template/src/lib/api.ts

@@ -0,0 +1,17 @@
+import { createApiClient, createQueryKeys } from "tempest-react-sdk";
+import { useAuth } from "@/stores/auth";
+
+/**
+ * Typed HTTP client. Reads the bearer token from the auth store on every
+ * request and points at `VITE_API_URL`.
+ */
+export const api = createApiClient({
+    baseURL: import.meta.env.VITE_API_URL ?? "http://127.0.0.1:8000",
+    getToken: () => useAuth.getState().token,
+    onUnauthorized: () => useAuth.getState().logout(),
+});
+
+/** Stable, namespaced query keys for TanStack Query. */
+export const queryKeys = createQueryKeys("app", {
+    me: () => ["me"],
+});

package/template/src/main.tsx

@@ -0,0 +1,10 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import "tempest-react-sdk/styles.css";
+import { App } from "@/App";
+
+createRoot(document.getElementById("root")!).render(
+    <StrictMode>
+        <App />
+    </StrictMode>,
+);

package/template/src/pages/Dashboard.tsx

@@ -0,0 +1,19 @@
+import { useAuth } from "@/stores/auth";
+
+/**
+ * Protected page (see the `guard` in src/routes.tsx). Lazy-loaded, so it is
+ * code-split into its own chunk. Default export because `lazy` expects one.
+ */
+export default function Dashboard() {
+    const user = useAuth.use.user();
+
+    return (
+        <section>
+            <h1>Dashboard</h1>
+            <p>
+                Signed in as <strong>{user?.name}</strong> ({user?.email}).
+            </p>
+            <p>This route is only reachable while authenticated.</p>
+        </section>
+    );
+}

package/template/src/pages/Home.tsx

@@ -0,0 +1,16 @@
+export function Home() {
+    return (
+        <section>
+            <h1>👋 Welcome</h1>
+            <p>
+                This app is wired with <code>tempest-react-sdk</code>: Vite (<code>@</code> alias),
+                React Router (declarative), a Zustand auth store and TanStack Query — all from one
+                place.
+            </p>
+            <p>
+                Edit <code>src/routes.tsx</code> to add pages and <code>src/stores/</code> to add
+                state.
+            </p>
+        </section>
+    );
+}

package/template/src/pages/Login.tsx

@@ -0,0 +1,27 @@
+import { useNavigate } from "tempest-react-sdk";
+import { useAuth } from "@/stores/auth";
+
+/**
+ * Demo login: fakes a session and redirects to the (guarded) dashboard. Swap
+ * the fake `setSession` for a real call to `api.post("/auth/login", …)`.
+ */
+export function Login() {
+    const navigate = useNavigate();
+    const setSession = useAuth.use.setSession();
+
+    function handleLogin() {
+        setSession({
+            user: { id: "1", name: "Ada Lovelace", email: "ada@example.com" },
+            token: "demo-token",
+        });
+        navigate("/dashboard");
+    }
+
+    return (
+        <section>
+            <h1>Login</h1>
+            <p>Sign in to reach the protected dashboard.</p>
+            <button onClick={handleLogin}>Sign in (demo)</button>
+        </section>
+    );
+}

package/template/src/routes.tsx

@@ -0,0 +1,27 @@
+import { defineRoutes } from "tempest-react-sdk";
+import { useAuth } from "@/stores/auth";
+import { RootLayout } from "@/layouts/RootLayout";
+import { Home } from "@/pages/Home";
+import { Login } from "@/pages/Login";
+
+/**
+ * Declarative route tree. `lazy` code-splits a page (with retry on stale
+ * chunks); `guard` redirects when the predicate is falsy — here, reading the
+ * auth store keeps protected pages behind login.
+ */
+export const routes = defineRoutes([
+    {
+        path: "/",
+        element: <RootLayout />,
+        children: [
+            { index: true, element: <Home /> },
+            { path: "login", element: <Login /> },
+            {
+                path: "dashboard",
+                lazy: () => import("@/pages/Dashboard"),
+                guard: () => useAuth.getState().isAuthenticated,
+                redirectTo: "/login",
+            },
+        ],
+    },
+]);

package/template/src/stores/auth.ts

@@ -0,0 +1,15 @@
+import { createAuthStore, createSelectors } from "tempest-react-sdk";
+
+/** The user shape your backend returns. Adjust to match your API. */
+export interface User {
+    id: string;
+    name: string;
+    email: string;
+}
+
+/**
+ * App-wide auth store: persisted user + token in localStorage, with auto
+ * `isAuthenticated`. `createSelectors` adds `useAuth.use.<field>()` hooks that
+ * subscribe to a single slice.
+ */
+export const useAuth = createSelectors(createAuthStore<User>({ name: "app-auth" }));

package/template/src/vite-env.d.ts

@@ -0,0 +1 @@
+/// <reference types="vite/client" />

package/template/tsconfig.json

@@ -0,0 +1,26 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2022", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "jsx": "react-jsx",
+    "types": ["vite/client"],
+    "strict": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "noFallthroughCasesInSwitch": true,
+    "noImplicitOverride": true,
+    "forceConsistentCasingInFileNames": true,
+    "esModuleInterop": true,
+    "isolatedModules": true,
+    "verbatimModuleSyntax": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "noEmit": true,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["src", "vite.config.ts"]
+}

package/template/vite.config.ts

@@ -0,0 +1,7 @@
+import { createViteConfig } from "tempest-react-sdk/vite";
+
+// One call wires `@vitejs/plugin-react`, the `@` → `src` alias and dev-server
+// defaults. Override anything (proxy, port, build target) inline.
+export default createViteConfig({
+    // proxy: { "/api": "http://127.0.0.1:8000" },
+});