kea-typegen 3.7.1 → 3.8.1

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 3.8.0 - 2026-07-14
+
+- Skip logics that are manually typed, e.g. `kea<MakeLogicType<Values, Actions>>(...)` or any other custom type in `kea<...>()`. Such logics are now left completely alone.
+- Add a new `--inline` mode. Instead of writing `logicType.ts` files, it writes and keeps updated a `// Generated by kea-typegen` block directly above each `kea()` call: one interface per non-empty section (`logicValues`, `logicActions`, `logicProps`), tied together with `export type logicType = MakeLogicType<logicValues, logicActions, logicProps>`. Named props types are referenced directly instead of getting an interface. With `--delete`, obsolete `logicType.ts` files are removed when switching over. See `yarn samples:inline:write` / `yarn samples:inline:check` and the `samples-inline/` folder.
+
 ## 3.7.1 - 2026-06-26
 
 Make watch mode incremental. When a watched rebuild can be proven local, regenerate only the changed or affected Kea logic files and keep the existing full-pass fallback for ambiguous changes.

package/README.md

@@ -5,3 +5,36 @@ Automatically generate types for `kea()` calls for [Kea 2.2+](https://keajs.org/
 ## Docs
 
 https://keajs.org/docs/intro/typescript
+
+## Inline mode
+
+By default kea-typegen writes a `logicType.ts` file next to each logic. In inline mode it instead writes
+a marked block of plain interfaces directly above the `kea()` call, tied together with kea's `MakeLogicType`:
+
+```ts
+// Generated by kea-typegen. DO NOT EDIT THIS BLOCK MANUALLY.
+export interface counterLogicValues {
+    counter: number
+}
+
+export interface counterLogicActions {
+    increment: (amount: number) => { amount: number }
+}
+
+export type counterLogicType = MakeLogicType<counterLogicValues, counterLogicActions>
+
+export const counterLogic = kea<counterLogicType>({ ... })
+```
+
+- `--inline` (CLI) or `"inline": true` (`.kearc`) — inline mode for every logic.
+- `--inline-paths a b` (CLI) or `"inlinePaths": ["./scenes/foo"]` (`.kearc`) — inline mode only for logic
+  files under those paths; everything else keeps its `logicType.ts` file. Relative paths resolve against
+  the root path. Use this to migrate a large project directory by directory.
+- A file that already carries a generated inline block stays inline even without either option, so
+  conversions never regress and single files can be converted with `kea-typegen write --inline -f <file>`.
+- With `--delete`, the now obsolete `logicType.ts` files are removed on conversion.
+- Untyped selector combiner parameters get their inferred types written into the source
+  (`(counter) => ...` becomes `(counter: number) => ...`), since `MakeLogicType` types them as `any`.
+- Values and actions pulled in via `connect` are marked with their source logic, e.g.
+  `user: UserType | null // userLogic`.
+- Logics manually typed with `kea<MakeLogicType<...>>()` or a custom type are left alone entirely.

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "kea-typegen",
-    "version": "3.7.1",
+    "version": "3.8.1",
     "description": "Generate type definitions for kea logic",
     "scripts": {
         "start": "ts-node ./src/cli/typegen.ts",
@@ -13,6 +13,8 @@
         "samples:write": "ts-node ./src/cli/typegen.ts write -r ./samples --write-paths --delete",
         "samples:convert": "ts-node ./src/cli/typegen.ts write -r ./samples --convert-to-builders",
         "samples:watch": "ts-node ./src/cli/typegen.ts watch -r ./samples --delete",
+        "samples:inline:check": "ts-node ./src/cli/typegen.ts check -r ./samples-inline --inline",
+        "samples:inline:write": "ts-node ./src/cli/typegen.ts write -r ./samples-inline --inline --delete",
         "samples:write:posthog": "NODE_OPTIONS=\"--max-old-space-size=16384\" ts-node ./src/cli/typegen.ts write --show-ts-errors -c",
         "form-plugin:build": "cd form-plugin && yarn && yarn build && cd ..",
         "form-plugin:rebuild": "yarn form-plugin:build && rm -rf node_modules && yarn"

package/dist/src/__tests__/inline.d.ts

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