build: fix post-review issues and add packaging/type tooling for 0.3.1

Author: ignsm

.github/workflows/ci.yml

@@ -10,20 +10,28 @@ jobs:
   check:
     runs-on: ubuntu-latest
 
+    strategy:
+      matrix:
+        node-version: [20, 22]
+
     steps:
       - uses: actions/checkout@v4
 
       - uses: pnpm/action-setup@v4
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 20
+          node-version: ${{ matrix.node-version }}
           cache: pnpm
 
       - run: pnpm install --frozen-lockfile
 
       - run: pnpm build
 
+      - run: pnpm lint:packages
+
+      - run: pnpm check:types
+
       - run: pnpm --filter @formhaus/core --filter @formhaus/react run test:resolve
 
       - run: pnpm test

CHANGELOG.md

@@ -4,23 +4,22 @@
 
 ### `@formhaus/core`
 
-- New `onStepValidate` option and `nextStepAsync()` method for async step validation (e.g. server-side checks between steps). Exposes `stepValidating` state, `StepValidateFn` type, and routes top-level errors through `topLevelErrors`.
+- New `onStepValidate` option runs an async validator between steps. `nextStepAsync()` awaits it. Exposes `stepValidating` and the `StepValidateFn` type.
 
 ### `@formhaus/react`
 
-- `FormRenderer` accepts `onStepValidate`; Continue button shows loading during async validation.
+- `FormRenderer` accepts `onStepValidate`. Continue button shows a loading state while the validator runs.
 
 ### `@formhaus/vue`
 
-- `FormRenderer` accepts `onStepValidate`; `useFormEngine` exposes `stepValidating`.
+- `FormRenderer` accepts `onStepValidate`. `useFormEngine` now returns `stepValidating`.
 
-### Build
+### Packaging
 
-- `@formhaus/core` and `@formhaus/react` now ship as single bundled ESM via `tsup` instead of `tsc` directory output. Sizes: core 2.87 KB gzipped, react 3.15 KB gzipped.
-- `"sideEffects": false` on core and react, `"sideEffects": ["**/*.vue", "**/*.css"]` on vue.
-- Reordered `exports` field so `types` comes before `import`.
-- New `test:resolve` script in core and react runs built `dist/index.js` through Node's strict ESM resolver in CI.
-- Dropped "JSON-schema-driven" wording from package descriptions and removed `json-schema` from core keywords.
+- **Breaking:** ESM-only. Dropped legacy `main` and `module` fields. Minimum Node is 18.
+- Fixed `@formhaus/vue` type resolution under `moduleResolution: "node16"` and `"nodenext"`.
+- `@formhaus/core` and `@formhaus/react` down to 2.87 KB and 3.15 KB gzipped.
+- `sideEffects: false` on core, react, and vue.
 
 ## 0.3.0 - 2026-04-07
 

package.json

@@ -7,9 +7,15 @@
     "docs:build": "cd docs && pnpm install && npx vitepress build",
     "docs:dev": "cd docs && npx vitepress dev",
     "test": "pnpm -r run test",
-    "clean": "pnpm -r run clean"
+    "clean": "pnpm -r run clean",
+    "lint:packages": "pnpm --filter @formhaus/core --filter @formhaus/react --filter @formhaus/vue exec publint",
+    "check:types": "pnpm --filter @formhaus/core --filter @formhaus/react --filter @formhaus/vue exec attw --pack --profile esm-only"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.2",
+    "publint": "^0.3.18"
   }
 }

packages/core/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@formhaus/core",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Framework-agnostic form engine with validation, conditional visibility, and multi-step support. Define forms as plain JSON, render anywhere.",
   "type": "module",
   "sideEffects": false,
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -32,7 +32,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ignsm/formhaus.git",
+    "url": "git+https://github.com/ignsm/formhaus.git",
     "directory": "packages/core"
   },
   "keywords": [

packages/figma/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@formhaus/figma",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Figma plugin: generates form mockups from @formhaus/core form definitions",
   "scripts": {
     "build": "esbuild src/code.ts --bundle --outfile=dist/code.js --target=es2017 --format=iife",
@@ -20,7 +20,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ignsm/formhaus.git",
+    "url": "git+https://github.com/ignsm/formhaus.git",
     "directory": "packages/figma"
   }
 }

packages/react/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@formhaus/react",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "React components for Formhaus forms. Define a form once in JSON, render with native HTML or your own components.",
   "type": "module",
   "sideEffects": false,
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -19,6 +19,7 @@
   "scripts": {
     "build": "tsup",
     "test": "vitest run",
+    "test:watch": "vitest",
     "test:resolve": "node --input-type=module -e \"import('./dist/index.js').then(m => { if (!m.FormRenderer) process.exit(1); console.log('ESM resolve OK'); })\"",
     "clean": "rm -rf dist"
   },
@@ -42,7 +43,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ignsm/formhaus.git",
+    "url": "git+https://github.com/ignsm/formhaus.git",
     "directory": "packages/react"
   }
 }

packages/vue/package.json

@@ -1,23 +1,23 @@
 {
   "name": "@formhaus/vue",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Vue 3 components for Formhaus forms. Define a form once in JSON, render with native HTML or your own components.",
   "type": "module",
-  "sideEffects": ["**/*.vue", "**/*.css"],
-  "main": "./dist/index.js",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [
     "dist"
   ],
   "scripts": {
-    "build": "vite build && vue-tsc --declaration --emitDeclarationOnly",
+    "build": "vite build",
     "test": "vitest run",
     "clean": "rm -rf dist"
   },
@@ -33,14 +33,14 @@
     "jsdom": "^29.0.2",
     "typescript": "^5.7.3",
     "vite": "^6.2.2",
+    "vite-plugin-dts": "^4.5.4",
     "vitest": "^4.1.3",
-    "vue": "^3.5.13",
-    "vue-tsc": "^2.0.0"
+    "vue": "^3.5.13"
   },
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/ignsm/formhaus.git",
+    "url": "git+https://github.com/ignsm/formhaus.git",
     "directory": "packages/vue"
   }
 }

packages/vue/vite.config.ts

@@ -1,9 +1,17 @@
 import { defineConfig } from 'vite';
 import vue from '@vitejs/plugin-vue';
+import dts from 'vite-plugin-dts';
 import { resolve } from 'path';
 
 export default defineConfig({
-  plugins: [vue()],
+  plugins: [
+    vue(),
+    dts({
+      include: ['src/**/*.ts', 'src/**/*.vue'],
+      rollupTypes: true,
+      tsconfigPath: './tsconfig.json',
+    }),
+  ],
   build: {
     lib: {
       entry: resolve(__dirname, 'src/index.ts'),