@lotics/cli 0.44.0 → 0.44.2

package/dist/app_commands.d.ts

@@ -1,15 +1,18 @@
 import { LoticsClient } from "./client.js";
 /**
  * Manifest declaration for one workflow alias:
- *   `"alias": { workflow_id, inputs?: { key: { type, … } } }`
+ *   `"alias": { workflow_id, inputs?: { key: { type, … } }, outputs?: { key: { type, … } } }`
  *
  * When `inputs` is declared, the CLI codegen emits a typed `AppWorkflows[alias]`
- * entry and the server validates payloads against it at execute time. Omit
- * `inputs` for workflows that accept no typed inputs.
+ * entry and the server validates payloads against it at execute time. When
+ * `outputs` is declared, codegen emits a typed `AppWorkflowResults[alias]` so the
+ * app reads a typed `result.data`. Omit either for workflows that take no typed
+ * inputs / return no structured data.
  */
 export type AppWorkflowDeclaration = {
     workflow_id: string;
     inputs?: Record<string, unknown>;
+    outputs?: Record<string, unknown>;
 };
 /**
  * Manifest declaration for one named query:

package/dist/generate_app_workflows_dts.d.ts

@@ -27,4 +27,11 @@ export declare function generateAppWorkflowsDts(workflows: Record<string, AppWor
  * catches structurally-invalid declarations before they reach us.
  */
 export declare function inputsToType(inputs: Record<string, unknown>): string;
+/**
+ * Map an output `fields` map (also the top-level `outputs`) to a TS object type.
+ * Mirrors the backend `outputObjectToTsType`; recursive for nested object/array.
+ * Zero-dep like `inputsToType` — pattern-matches on `type`, falls through to
+ * `unknown` for shapes the server's schema parse rejects before we see them.
+ */
+export declare function objectFieldsToType(fields: Record<string, unknown>): string;
 export declare function isValidIdentifier(name: string): boolean;

package/dist/generate_app_workflows_dts.js

@@ -34,22 +34,32 @@ declare module "@lotics/app-sdk" {
     }
     // Sort alphabetically for deterministic output across regenerations.
     entries.sort(([a], [b]) => a.localeCompare(b));
-    const lines = [];
+    const inputLines = [];
+    const resultLines = [];
     for (const [alias, declaration] of entries) {
-        // declaration is always `{ workflow_id, inputs? }` per manifest schema.
-        // Workflows with no typed inputs omit `inputs:` and get an untyped
-        // `Record<string, unknown>` callable surface.
+        // declaration is `{ workflow_id, inputs?, outputs? }` per manifest schema.
+        // No typed inputs ⇒ untyped `Record<string, unknown>` callable. An alias with
+        // declared `outputs` also gets an `AppWorkflowResults` entry → typed result.data.
         const valueType = declaration.inputs
             ? inputsToType(declaration.inputs)
             : "Record<string, unknown>";
         const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
-        lines.push(`    ${aliasKey}: ${valueType};`);
+        inputLines.push(`    ${aliasKey}: ${valueType};`);
+        if (declaration.outputs) {
+            resultLines.push(`    ${aliasKey}: ${objectFieldsToType(declaration.outputs)};`);
+        }
     }
+    const resultsBlock = resultLines.length > 0
+        ? `
+  interface AppWorkflowResults {
+${resultLines.join("\n")}
+  }`
+        : "";
     return `${HEADER}
 declare module "@lotics/app-sdk" {
   interface AppWorkflows {
-${lines.join("\n")}
-  }
+${inputLines.join("\n")}
+  }${resultsBlock}
 }
 `;
 }
@@ -119,6 +129,68 @@ function inputDeclToTsType(decl) {
             return "unknown";
     }
 }
+/**
+ * Map an output `fields` map (also the top-level `outputs`) to a TS object type.
+ * Mirrors the backend `outputObjectToTsType`; recursive for nested object/array.
+ * Zero-dep like `inputsToType` — pattern-matches on `type`, falls through to
+ * `unknown` for shapes the server's schema parse rejects before we see them.
+ */
+export function objectFieldsToType(fields) {
+    const parts = [];
+    for (const [key, decl] of Object.entries(fields)) {
+        if (decl === null || typeof decl !== "object")
+            continue;
+        const d = decl;
+        const optional = d.required === false ? "?" : "";
+        const fieldKey = isValidIdentifier(key) ? key : JSON.stringify(key);
+        parts.push(`${fieldKey}${optional}: ${outputDeclToTsType(d)}`);
+    }
+    if (parts.length === 0)
+        return "Record<string, never>";
+    return `{ ${parts.join("; ")} }`;
+}
+function outputDeclToTsType(decl) {
+    const type = decl.type;
+    switch (type) {
+        case "text":
+        case "email":
+        case "date":
+        case "datetime":
+            return "string";
+        case "number":
+            return "number";
+        case "boolean":
+            return "boolean";
+        case "record_link":
+            return decl.multi === true ? "ReadonlyArray<string>" : "string";
+        case "select": {
+            const options = Array.isArray(decl.options) ? decl.options : [];
+            const literals = options
+                .map((o) => o !== null && typeof o === "object" && "value" in o && typeof o.value === "string"
+                ? JSON.stringify(o.value)
+                : null)
+                .filter((v) => v !== null);
+            const inner = literals.length > 0 ? literals.join(" | ") : "string";
+            return decl.multi === true ? `ReadonlyArray<${inner}>` : inner;
+        }
+        case "object": {
+            const fields = decl.fields !== null && typeof decl.fields === "object"
+                ? decl.fields
+                : {};
+            return objectFieldsToType(fields);
+        }
+        case "array": {
+            const items = decl.items !== null && typeof decl.items === "object"
+                ? decl.items
+                : null;
+            return items ? `ReadonlyArray<${outputDeclToTsType(items)}>` : "ReadonlyArray<unknown>";
+        }
+        case "json":
+            return "unknown";
+        default:
+            return "unknown";
+    }
+}
 const IDENTIFIER_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 export function isValidIdentifier(name) {
     return IDENTIFIER_REGEX.test(name);

package/dist/generate_app_workflows_dts.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/generate_app_workflows_dts.test.js

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "vitest";
+import { generateAppWorkflowsDts } from "./generate_app_workflows_dts.js";
+describe("generateAppWorkflowsDts", () => {
+    it("emits no AppWorkflowResults block when no alias declares outputs", () => {
+        const dts = generateAppWorkflowsDts({
+            issue: { workflow_id: "wfl_1", inputs: { record_id: { type: "text" } } },
+        });
+        expect(dts).toContain("interface AppWorkflows {");
+        expect(dts).toContain("issue: {\n      record_id: string;\n    };");
+        expect(dts).not.toContain("AppWorkflowResults");
+    });
+    it("emits a typed AppWorkflowResults entry for an alias with a nested outputs schema", () => {
+        const dts = generateAppWorkflowsDts({
+            computeQuote: {
+                workflow_id: "wfl_2",
+                outputs: {
+                    total: { type: "number" },
+                    note: { type: "text", required: false },
+                    lines: {
+                        type: "array",
+                        items: {
+                            type: "object",
+                            fields: { name: { type: "text" }, amount: { type: "number" } },
+                        },
+                    },
+                },
+            },
+        });
+        expect(dts).toContain("interface AppWorkflowResults {");
+        // Nested array-of-object + optional field render correctly.
+        expect(dts).toContain("computeQuote: { total: number; note?: string; lines: ReadonlyArray<{ name: string; amount: number }> };");
+        // No declared inputs → untyped callable in AppWorkflows.
+        expect(dts).toContain("computeQuote: Record<string, unknown>;");
+    });
+    it("maps record_link/select outputs the same way as inputs", () => {
+        const dts = generateAppWorkflowsDts({
+            lookup: {
+                workflow_id: "wfl_3",
+                outputs: {
+                    owner: { type: "record_link", table_id: "tbl_x" },
+                    tags: { type: "select", options: [{ label: "A", value: "a" }, { label: "B", value: "b" }], multi: true },
+                },
+            },
+        });
+        expect(dts).toContain('owner: string; tags: ReadonlyArray<"a" | "b">');
+    });
+});

package/dist/src/cli.js

@@ -30179,7 +30179,7 @@ import { spawn as spawn2 } from "node:child_process";
 import { tmpdir } from "node:os";
 
 // src/starter_template.ts
-var STARTER_FALLBACK_UI_VERSION = "2.0.0";
+var STARTER_FALLBACK_UI_VERSION = "1.8.0";
 var STARTER_FALLBACK_SDK_VERSION = "0.11.0";
 var STARTER_REACT_NATIVE_VERSION = "0.85.3";
 function buildStarterTemplate(args) {
@@ -30322,6 +30322,34 @@ export default defineConfig({
     dedupe: ["react", "react-dom", "react-native-web"],
   },
   optimizeDeps: {
+    // \`recharts\` (used by @lotics/ui chart_* + sparkline) imports
+    // \`es-toolkit/compat/get\` as a default-export CJS module. Vite's dev
+    // server treats \`compat/*\` as ESM and won't synthesize a default,
+    // so \`import get from "es-toolkit/compat/get"\` fails to resolve.
+    // Pre-bundling forces Vite to convert it to an ESM shim with a default
+    // export. Production build (rollup) handles it correctly without this.
+    //
+    // react-native-web itself is force-prebundled (folds its core CJS deps like
+    // @react-native/normalize-colors into one interop'd chunk), and the deep
+    // subpaths it reaches via *default* imports (e.g. @react-native-picker's web
+    // <select> build) are each pre-bundled into an ESM shim \u2014 Vite's dev optimizer
+    // otherwise serves them without a synthesized default export ("does not
+    // provide an export named 'default'"), blanking the iframe. (Production/rollup
+    // resolves the interop already, so this is dev-only.)
+    include: [
+      "recharts", "es-toolkit", "es-toolkit/compat",
+      "react-native-web", "@react-native/normalize-colors",
+      "inline-style-prefixer/lib/createPrefixer",
+      "inline-style-prefixer/lib/plugins/crossFade",
+      "inline-style-prefixer/lib/plugins/imageSet",
+      "inline-style-prefixer/lib/plugins/logical",
+      "inline-style-prefixer/lib/plugins/position",
+      "inline-style-prefixer/lib/plugins/sizing",
+      "inline-style-prefixer/lib/plugins/transition",
+      "postcss-value-parser", "fbjs/lib/invariant", "fbjs/lib/warning",
+      "styleq", "styleq/transform-localize-style",
+      "react", "react-dom", "react-dom/client", "nullthrows",
+    ],
     // The dep optimizer pre-bundles deps with a SEPARATE esbuild pass that
     // top-level \`define\` doesn't always reach, so a pre-bundled RN dep can
     // still hit \`__DEV__ is not defined\` under \`lotics app dev\`. Define it
@@ -30352,6 +30380,25 @@ export default defineConfig({
   },
   test: {
     environment: "jsdom",
+    // RN packages ship Flow (\`import typeof\`) in their native source, reached
+    // transitively by RN-Web components (pickers, calendars, anything touching
+    // Animated). Vitest's web optimizer is OFF by default and ignores the
+    // \`optimizeDeps.resolveExtensions\` above, so it pre-bundles the native
+    // \`.js\` / \`src\` Flow files and esbuild can't parse them. Enable it with the
+    // same \`.web.js\`-first resolution so it bundles the compiled web variants
+    // (Picker.web.js, RN-Web dist) \u2014 without this, any test that renders a tree
+    // pulling a Picker / DatePicker fails with "Unexpected token 'typeof'".
+    deps: {
+      optimizer: {
+        web: {
+          enabled: true,
+          include: ["react-native", "react-native-web", "@react-native-picker/picker"],
+          esbuildOptions: {
+            resolveExtensions: [".web.tsx", ".web.ts", ".web.js", ".tsx", ".ts", ".jsx", ".js", ".json"],
+          },
+        },
+      },
+    },
   },
 });
 `
@@ -31078,17 +31125,25 @@ declare module "@lotics/app-sdk" {
 `;
   }
   entries.sort(([a], [b]) => a.localeCompare(b));
-  const lines = [];
+  const inputLines = [];
+  const resultLines = [];
   for (const [alias, declaration] of entries) {
     const valueType = declaration.inputs ? inputsToType(declaration.inputs) : "Record<string, unknown>";
     const aliasKey = isValidIdentifier(alias) ? alias : JSON.stringify(alias);
-    lines.push(`    ${aliasKey}: ${valueType};`);
+    inputLines.push(`    ${aliasKey}: ${valueType};`);
+    if (declaration.outputs) {
+      resultLines.push(`    ${aliasKey}: ${objectFieldsToType(declaration.outputs)};`);
+    }
   }
+  const resultsBlock = resultLines.length > 0 ? `
+  interface AppWorkflowResults {
+${resultLines.join("\n")}
+  }` : "";
   return `${HEADER}
 declare module "@lotics/app-sdk" {
   interface AppWorkflows {
-${lines.join("\n")}
-  }
+${inputLines.join("\n")}
+  }${resultsBlock}
 }
 `;
 }
@@ -31145,6 +31200,54 @@ function inputDeclToTsType(decl) {
       return "unknown";
   }
 }
+function objectFieldsToType(fields) {
+  const parts = [];
+  for (const [key, decl] of Object.entries(fields)) {
+    if (decl === null || typeof decl !== "object") continue;
+    const d = decl;
+    const optional = d.required === false ? "?" : "";
+    const fieldKey = isValidIdentifier(key) ? key : JSON.stringify(key);
+    parts.push(`${fieldKey}${optional}: ${outputDeclToTsType(d)}`);
+  }
+  if (parts.length === 0) return "Record<string, never>";
+  return `{ ${parts.join("; ")} }`;
+}
+function outputDeclToTsType(decl) {
+  const type = decl.type;
+  switch (type) {
+    case "text":
+    case "email":
+    case "date":
+    case "datetime":
+      return "string";
+    case "number":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "record_link":
+      return decl.multi === true ? "ReadonlyArray<string>" : "string";
+    case "select": {
+      const options = Array.isArray(decl.options) ? decl.options : [];
+      const literals = options.map(
+        (o) => o !== null && typeof o === "object" && "value" in o && typeof o.value === "string" ? JSON.stringify(o.value) : null
+      ).filter((v) => v !== null);
+      const inner = literals.length > 0 ? literals.join(" | ") : "string";
+      return decl.multi === true ? `ReadonlyArray<${inner}>` : inner;
+    }
+    case "object": {
+      const fields = decl.fields !== null && typeof decl.fields === "object" ? decl.fields : {};
+      return objectFieldsToType(fields);
+    }
+    case "array": {
+      const items = decl.items !== null && typeof decl.items === "object" ? decl.items : null;
+      return items ? `ReadonlyArray<${outputDeclToTsType(items)}>` : "ReadonlyArray<unknown>";
+    }
+    case "json":
+      return "unknown";
+    default:
+      return "unknown";
+  }
+}
 var IDENTIFIER_REGEX = /^[a-zA-Z_$][a-zA-Z0-9_$]*$/;
 function isValidIdentifier(name) {
   return IDENTIFIER_REGEX.test(name);
@@ -39145,7 +39248,7 @@ var drawingParser = new XMLParser({
   processEntities: false,
   isArray: (tagName) => tagName === "xdr:twoCellAnchor" || tagName === "xdr:oneCellAnchor" || tagName === "Relationship"
 });
-function parseSheet(sheetXml, sheetRelsXml, styles, sharedStrings, theme, indexedColors, zipEntries, date1904) {
+function parseSheet(sheetXml, sheetRelsXml, styles, sharedStrings, theme, indexedColors, zipEntries, date1904, maxRows = MAX_ROWS_PER_SHEET) {
   const doc = xmlParser4.parse(sheetXml);
   const worksheet = doc?.["worksheet"];
   if (!worksheet) return emptySheet("Sheet");
@@ -39163,7 +39266,7 @@ function parseSheet(sheetXml, sheetRelsXml, styles, sharedStrings, theme, indexe
     maxCol,
     maxContentWidth,
     rowOutlineLevels
-  } = parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultRowHeight, date1904);
+  } = parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultRowHeight, date1904, maxRows);
   const colCount = Math.max(parsedCols.length > 0 ? parsedCols[parsedCols.length - 1].max : 0, maxCol);
   const columns = buildColumns(parsedCols, colHidden, maxContentWidth, colCount, defaultColWidth);
   const mergedCells = parseMergedCells(worksheet);
@@ -39345,7 +39448,7 @@ function buildColumns(colDefs, colHidden, maxContentWidth, colCount, _defaultCol
   }
   return columns;
 }
-function parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultRowHeight, date1904) {
+function parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultRowHeight, date1904, maxRows) {
   const sheetData = worksheet["sheetData"];
   if (!sheetData) {
     return {
@@ -39383,7 +39486,7 @@ function parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultR
     }
     if (rowEl["@_hidden"] === "1" || rowEl["@_hidden"] === "true") continue;
     rowCount++;
-    if (rowCount > MAX_ROWS_PER_SHEET) continue;
+    if (rowCount > maxRows) continue;
     const height = rowEl["@_ht"] ? parseFloat(rowEl["@_ht"]) : defaultRowHeight;
     const cellArr = rowEl["c"];
     const cells = [];
@@ -39412,7 +39515,7 @@ function parseSheetData(worksheet, styles, sharedStrings, hyperlinkMap, defaultR
   return {
     rows,
     totalRowCount,
-    truncated: rowCount > MAX_ROWS_PER_SHEET,
+    truncated: rowCount > maxRows,
     maxCol,
     maxContentWidth,
     rowOutlineLevels
@@ -39454,10 +39557,12 @@ function parseCell(cellEl, styles, sharedStrings, hyperlinkMap, date1904) {
   if (fEl !== void 0 && fEl !== null) {
     if (typeof fEl === "object") {
       const fObj = fEl;
-      formula = fObj["#text"];
+      const text = fObj["#text"];
+      formula = text == null ? void 0 : String(text);
       if (fObj["@_t"] === "array") {
         isArrayFormula = true;
-        arrayRange = fObj["@_ref"];
+        const ref2 = fObj["@_ref"];
+        arrayRange = ref2 == null ? void 0 : String(ref2);
         if (formula?.startsWith("{") && formula.endsWith("}")) {
           formula = formula.slice(1, -1);
         }
@@ -41026,11 +41131,11 @@ function ensureVmlArray(val) {
 }
 
 // ../xlsx/src/excel_parser.ts
-function parseExcelBuffer(arrayBuffer) {
+function parseExcelBuffer(arrayBuffer, options) {
   const zip = unzipXlsx(arrayBuffer);
-  return parseExcelFromZip(zip);
+  return parseExcelFromZip(zip, options);
 }
-function parseExcelFromZip(zip) {
+function parseExcelFromZip(zip, options) {
   const themeEntry = findEntry(zip, "xl/theme/theme1.xml");
   const theme = themeEntry ? parseTheme(decodeUtf8(themeEntry)) : { colors: defaultThemeColors(), majorFont: "Calibri", minorFont: "Calibri" };
   const stylesEntry = findEntry(zip, "xl/styles.xml");
@@ -41092,7 +41197,8 @@ function parseExcelFromZip(zip) {
       theme,
       styles.indexedColors,
       zip,
-      workbookInfo.date1904
+      workbookInfo.date1904,
+      options?.maxRowsPerSheet
     );
     parsed.name = sheetInfo.name;
     if (isHidden) parsed.hidden = true;

package/dist/starter_template.d.ts

@@ -39,7 +39,7 @@ export interface StarterFile {
  * scaffolds resolve the live version via `fetchLatestNpmVersion` and only
  * fall back here when the lookup fails.
  */
-export declare const STARTER_FALLBACK_UI_VERSION = "2.0.0";
+export declare const STARTER_FALLBACK_UI_VERSION = "1.8.0";
 export declare const STARTER_FALLBACK_SDK_VERSION = "0.11.0";
 /**
  * react-native pin for scaffolded apps. Matches the monorepo frontend's pin so

package/dist/starter_template.js

@@ -35,7 +35,7 @@
  * scaffolds resolve the live version via `fetchLatestNpmVersion` and only
  * fall back here when the lookup fails.
  */
-export const STARTER_FALLBACK_UI_VERSION = "2.0.0";
+export const STARTER_FALLBACK_UI_VERSION = "1.8.0";
 export const STARTER_FALLBACK_SDK_VERSION = "0.11.0";
 /**
  * react-native pin for scaffolded apps. Matches the monorepo frontend's pin so
@@ -184,6 +184,34 @@ export default defineConfig({
     dedupe: ["react", "react-dom", "react-native-web"],
   },
   optimizeDeps: {
+    // \`recharts\` (used by @lotics/ui chart_* + sparkline) imports
+    // \`es-toolkit/compat/get\` as a default-export CJS module. Vite's dev
+    // server treats \`compat/*\` as ESM and won't synthesize a default,
+    // so \`import get from "es-toolkit/compat/get"\` fails to resolve.
+    // Pre-bundling forces Vite to convert it to an ESM shim with a default
+    // export. Production build (rollup) handles it correctly without this.
+    //
+    // react-native-web itself is force-prebundled (folds its core CJS deps like
+    // @react-native/normalize-colors into one interop'd chunk), and the deep
+    // subpaths it reaches via *default* imports (e.g. @react-native-picker's web
+    // <select> build) are each pre-bundled into an ESM shim — Vite's dev optimizer
+    // otherwise serves them without a synthesized default export ("does not
+    // provide an export named 'default'"), blanking the iframe. (Production/rollup
+    // resolves the interop already, so this is dev-only.)
+    include: [
+      "recharts", "es-toolkit", "es-toolkit/compat",
+      "react-native-web", "@react-native/normalize-colors",
+      "inline-style-prefixer/lib/createPrefixer",
+      "inline-style-prefixer/lib/plugins/crossFade",
+      "inline-style-prefixer/lib/plugins/imageSet",
+      "inline-style-prefixer/lib/plugins/logical",
+      "inline-style-prefixer/lib/plugins/position",
+      "inline-style-prefixer/lib/plugins/sizing",
+      "inline-style-prefixer/lib/plugins/transition",
+      "postcss-value-parser", "fbjs/lib/invariant", "fbjs/lib/warning",
+      "styleq", "styleq/transform-localize-style",
+      "react", "react-dom", "react-dom/client", "nullthrows",
+    ],
     // The dep optimizer pre-bundles deps with a SEPARATE esbuild pass that
     // top-level \`define\` doesn't always reach, so a pre-bundled RN dep can
     // still hit \`__DEV__ is not defined\` under \`lotics app dev\`. Define it
@@ -214,6 +242,25 @@ export default defineConfig({
   },
   test: {
     environment: "jsdom",
+    // RN packages ship Flow (\`import typeof\`) in their native source, reached
+    // transitively by RN-Web components (pickers, calendars, anything touching
+    // Animated). Vitest's web optimizer is OFF by default and ignores the
+    // \`optimizeDeps.resolveExtensions\` above, so it pre-bundles the native
+    // \`.js\` / \`src\` Flow files and esbuild can't parse them. Enable it with the
+    // same \`.web.js\`-first resolution so it bundles the compiled web variants
+    // (Picker.web.js, RN-Web dist) — without this, any test that renders a tree
+    // pulling a Picker / DatePicker fails with "Unexpected token 'typeof'".
+    deps: {
+      optimizer: {
+        web: {
+          enabled: true,
+          include: ["react-native", "react-native-web", "@react-native-picker/picker"],
+          esbuildOptions: {
+            resolveExtensions: [".web.tsx", ".web.ts", ".web.js", ".tsx", ".ts", ".jsx", ".js", ".json"],
+          },
+        },
+      },
+    },
   },
 });
 `,

package/dist/starter_template.test.js

@@ -18,6 +18,14 @@ describe("buildStarterTemplate", () => {
         expect(config).toContain('__DEV__: "false"');
         expect(config).toContain('".web.js"');
     });
+    test("vite.config.ts force-prebundles react-native-web (else a DatePicker/Picker blanks the dev iframe)", () => {
+        // RN-Web does `import normalizeColor from "@react-native/normalize-colors"`
+        // (nested CJS). Un-prebundled, the dev server serves it as ESM with no
+        // default → "does not provide an export named 'default'" + blank iframe the
+        // moment a colour-touching component mounts. Prebundling interops it.
+        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
+        expect(config).toMatch(/include:\s*\[[^\]]*"react-native-web"/);
+    });
     test("vite.config.ts defines the RN __DEV__ global (else the bundle throws at load → blank iframe)", () => {
         // `__DEV__` is a Metro-injected global that RN-ecosystem deps reference at
         // module-eval time (e.g. @react-native-picker's UnimplementedView, pulled in
@@ -31,6 +39,18 @@ describe("buildStarterTemplate", () => {
         // deps under `lotics app dev`).
         expect(config).toMatch(/esbuildOptions:\s*\{\s*define:\s*\{\s*__DEV__:\s*"false"/);
     });
+    test("vite.config.ts enables the vitest web optimizer with .web.js resolution (else tests rendering a Picker/DatePicker fail on Flow)", () => {
+        // Vitest pre-bundles deps with its OWN esbuild optimizer, which is OFF by
+        // default and ignores the top-level `optimizeDeps.resolveExtensions`. Without
+        // it enabled + given `.web.js` first, it grabs react-native's native `.js` /
+        // src Flow files (`import typeof`) that esbuild can't parse — so any test that
+        // renders a tree pulling a Picker/DatePicker dies with "Unexpected token 'typeof'".
+        const config = fileNamed(buildStarterTemplate(baseArgs), "vite.config.ts");
+        expect(config).toMatch(/test:\s*\{[\s\S]*environment:\s*"jsdom"/);
+        expect(config).toMatch(/optimizer:\s*\{\s*web:\s*\{\s*enabled:\s*true/);
+        // The web optimizer carries the same `.web.js`-first resolution as the build.
+        expect(config).toMatch(/web:\s*\{[\s\S]*resolveExtensions:[\s\S]*"\.web\.js"/);
+    });
     test("vite.config.ts maps the RN `global` to globalThis (else rn-web Animated throws when a spring is torn down)", () => {
         // react-native-web's Animated reads `global.cancelAnimationFrame` (free var)
         // when a spring animation is interrupted — e.g. toggling @lotics/ui's Switch.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/cli",
-  "version": "0.44.0",
+  "version": "0.44.2",
   "description": "Lotics SDK and CLI for AI agents",
   "type": "module",
   "bin": {