create-keboola-app 0.2.0 → 0.2.1

package/dist/template/src/slices/assistant.ts

@@ -9,11 +9,7 @@ type ChatMessage = {
 };
 
 export type AssistantSlice = {
-  /**
-   * One transcript for the whole app. The home page's prompt input and the rail's
-   * own composer both call `send`, so sending from the page is a handoff into the
-   * rail rather than a second, parallel conversation.
-   */
+  /** One app-wide transcript: the home prompt and the rail's composer both `send` into it. */
   messages: ChatMessage[];
   send: (text: string) => void;
   fullscreen: boolean;
@@ -53,10 +49,8 @@ export const createAssistantSlice: StateCreator<AppState, Mutators, [], Assistan
         messages: [
           ...s.messages,
           { id: crypto.randomUUID(), role: 'user', text },
-          // A canned reply, not a backend call — swap the whole branch for a
-          // real request. It answers in Markdown (including a ```mermaid fence)
-          // because that is what an assistant actually returns, and rendering
-          // that is the rail's job: see AssistantPanel.
+          // Canned stand-in for a backend call; Markdown with a ```mermaid fence,
+          // rendered by AssistantPanel.
           { id: crypto.randomUUID(), role: 'assistant', text: cannedReply(text) },
         ],
       }),

package/dist/template/src/slices/shell.ts

@@ -7,9 +7,7 @@ import type { AppState } from '../store';
 /**
  * The modes `sidebarMode` may hold, as a runtime value.
  *
- * - Keyed by `SidebarMode`, so adding a mode to the union fails the build here until
- *   it is listed — a hand-written array would silently start rejecting the new mode.
- * - The values carry nothing; the keys are the whole point.
+ * - Keyed by `SidebarMode`, so a new mode fails the build until it is listed here.
  */
 const SIDEBAR_MODES: Record<SidebarMode, true> = {
   expanded: true,
@@ -22,12 +20,8 @@ export const isSidebarMode = (value: unknown): value is SidebarMode =>
 
 export type ShellSlice = {
   /**
-   * The left rail's mode.
-   *
-   * - Lives here, not inside `SidebarProvider`, so it survives a reload; a layout
-   *   preference that resets reads as a broken control.
-   * - `AppChrome` drives the provider from it (`leftMode` + `onLeftModeChange`).
-   * - `SidebarModeMenu` is the UI that writes it.
+   * - Stored here, not in `SidebarProvider`, so it survives a reload.
+   * - `AppChrome` feeds it to the provider; `SidebarModeMenu` writes it.
    */
   sidebarMode: SidebarMode;
   setSidebarMode: (mode: SidebarMode) => void;
@@ -39,8 +33,7 @@ export type ShellSlice = {
 /**
  * The mutator tuple mirrors `store.ts`'s middleware stack, outside-in.
  *
- * - Without it `set` loses its third argument and every `set(partial, false, 'name')`
- *   call fails to type-check.
+ * - Without it `set(partial, false, 'name')` fails to type-check.
  */
 type Mutators = [['zustand/devtools', never], ['zustand/persist', unknown]];
 

package/dist/template/src/store.ts

@@ -16,18 +16,14 @@ export type AppState = ShellSlice &
   // #region block:assistant
   AssistantSlice &
   // #endregion block:assistant
-  // `unknown` is the identity for `&`, so the line above can go without leaving a dangling
-  // operator. The comment keeps this alias on three lines, which is what `oxfmt` expects of
-  // it in an app that dropped the middle term.
+  // - `unknown` is the identity for `&`, so the line above can go without a dangling operator.
+  // - This comment keeps the alias multi-line, as `oxfmt` expects once that line is gone.
   unknown;
 
 export const useAppStore = create<AppState>()(
   devtools(
-    // `persist` inside `devtools` so rehydration lands in the devtools timeline as an
-    // action. Only `sidebarMode` is written out — see `partialize`.
+    // `persist` inside `devtools` so rehydration shows in the devtools timeline.
     persist(
-      // Zustand's slice pattern: `(...a)` forwards `set`, `get` and the store API to
-      // each creator without naming the three of them per slice.
       (...a) => ({
         ...createShellSlice(...a),
         // #region block:assistant
@@ -36,26 +32,15 @@ export const useAppStore = create<AppState>()(
       }),
       {
         name: UI_SETTINGS_STORAGE_KEY,
-        // No `version` here on purpose. Zustand discards a record whose version does not
-        // match and no `migrate` covers, so a bare bump silently resets every returning
-        // visitor. If the stored shape ever changes, add `version` and `migrate` in the
-        // same change. A value that is merely unrecognised is `merge`'s job, below.
-        // The layout preference and nothing else. The default is the whole store, which
-        // would restore a stale transcript on reload and pin `fullscreen` open across
-        // sessions.
+        // - No `version`: a bump without `migrate` resets every stored record; add both together.
+        // - Layout only; the whole store would restore a stale transcript and pin `fullscreen`.
         partialize: (state) => ({ sidebarMode: state.sidebarMode }),
-        // Validate at the storage boundary instead of trusting what comes back.
-        // - `localStorage` is user-writable, and a value written by an older build
-        //   outlives the code that wrote it.
-        // - An unrecognised mode is not inert: `SidebarProvider` derives the rail's
-        //   `state` from it, no branch matches, so the rail sticks at icon width with
-        //   nothing checked in the mode menu — recoverable only by picking a mode.
-        // - Falling back to `current` means the in-memory default, so a junk value
-        //   reads exactly like a first visit.
+        // - Untrusted: `localStorage` is user-writable and outlives the build that wrote it.
+        // - An unknown mode sticks the rail at icon width, so junk falls back to the default.
         merge: (persisted, current) => {
           const stored: unknown =
-            typeof persisted === 'object' && persisted !== null
-              ? Reflect.get(persisted, 'sidebarMode')
+            typeof persisted === 'object' && persisted !== null && 'sidebarMode' in persisted
+              ? persisted.sidebarMode
               : undefined;
 
           return { ...current, sidebarMode: isSidebarMode(stored) ? stored : current.sidebarMode };

package/dist/template/vite.config.ts

@@ -10,11 +10,8 @@ export default defineConfig({
       routesDirectory: './src/routes',
       generatedRouteTree: './src/routeTree.gen.ts',
       /**
-       * `routes/` holds route files and their tests, nothing else.
-       *
        * - A test file exports no `Route`, so unmatched it costs a generator warning per build.
-       * - Matched against the file name, not the path (`routeFileIgnorePrefix` still defaults
-       *   to `-`; nothing here relies on it).
+       * - Matched against the file name, not the path.
        */
       routeFileIgnorePattern: '\\.test\\.tsx?$',
     }),

package/dist/template/vitest.config.ts

@@ -6,11 +6,8 @@ export default defineConfig({
     globals: true,
     environment: 'jsdom',
     setupFiles: ['./src/test-setup.ts'],
-    // This suite runs inside the repo-wide `Checks` job, so it shares a 2-core
-    // runner with every other package's tests — ~25x slower per test than a dev
-    // machine here (measured: AssistantPanel's two prompt tests are 156ms/199ms
-    // locally, 3881ms/5189ms there). The 5s default clips whichever one loses the
-    // race; the userEvent-driven tests get headroom instead.
+    // The shared 2-core `Checks` runner is ~25x slower than a dev machine; the 5s default
+    // clips userEvent-driven tests.
     testTimeout: 15000,
   },
   resolve: {

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "create-keboola-app",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Scaffold a Keboola-shaped frontend app — Vite + React 19 + TanStack Router/Query/Form + Zustand + @keboola/design — from a minimal shell plus the blocks you pick",
   "license": "MIT",
   "type": "module",
+  "bin": {
+    "create-keboola-app": "./dist/cli.js"
+  },
   "files": [
     "dist",
     "README.md",
@@ -35,19 +38,20 @@
     "cli"
   ],
   "dependencies": {
-    "@tanstack/router-generator": "^1.120.4"
+    "@tanstack/router-generator": "^1.167.46"
   },
   "devDependencies": {
+    "@keboola/eslint-plugin-design": "^0.8.0",
+    "@keboola/oxlint-config": "^10.3.0",
+    "@keboola/tsconfig": "^0.2.1",
     "@types/node": "24.12.0",
     "@typescript/native": "npm:typescript@^7.0.2",
     "oxfmt": "^0.66.0",
-    "oxlint": "^1.81.0",
+    "oxlint": "^1.89.0",
     "tsdown": "^0.22.14",
     "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "vite": "^8.1.5",
-    "vitest": "^4.1.10",
-    "@keboola/tsconfig": "^0.2.1",
-    "@keboola/oxlint-config": "^10.0.2"
+    "vite": "^8.3.5",
+    "vitest": "^5.0.5"
   },
   "scripts": {
     "build": "tsdown && node dist/extract.js",
@@ -57,10 +61,7 @@
     "lint:oxlint": "oxlint . --quiet",
     "knip:check": "pnpm --dir ../.. exec knip --workspace packages/create-keboola-app",
     "knip:fix": "pnpm --dir ../.. exec knip --workspace packages/create-keboola-app --fix-type types,exports,files",
-    "test": "vitest run --passWithNoTests --reporter=dot",
+    "test": "vitest run --reporter=dot",
     "type-check": "tsc"
-  },
-  "bin": {
-    "create-keboola-app": "./dist/cli.js"
   }
 }