@classytic/formkit 1.0.2 → 1.2.0

package/CHANGELOG.md

@@ -0,0 +1,78 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.1.0] - 2026-02-24
+
+### Added
+
+- **`useFormKit` hook** — Convenience hook that combines schema default extraction with react-hook-form setup. Returns all `useForm` methods plus ready-to-spread `generatorProps` for minimal boilerplate form setup
+- **`extractDefaultValues(schema)`** — Server-safe utility that walks a schema and extracts all `defaultValue` fields into a flat object, respecting `nameSpace` prefixes and group `itemFields`
+- **`buildValidationRules(field)`** — Server-safe utility that generates react-hook-form validation rules from a field's `required`, `min`, `max`, `minLength`, `maxLength`, and `pattern` props with auto-generated error messages
+- **`ref` prop on FormGenerator** — React 19 ref-as-prop support (no `forwardRef` needed). Pass a ref to get access to the root `<div>` element
+- **`fieldState` runtime data** — `FieldComponentProps` now receives real `fieldState` with `invalid`, `isDirty`, `isTouched`, `isValidating`, and `error` from react-hook-form (previously always `undefined`)
+- **Server entry exports** — `extractDefaultValues` and `buildValidationRules` added to `@classytic/formkit/server`
+- New type exports: `UseFormKitOptions`, `UseFormKitReturn`
+
+### Fixed
+
+- **Nested path DSL conditions** — `evaluateRule` now correctly resolves both flat keys (`"address.city"` as literal key from `DynamicFieldWrapper`) and nested objects (`{ address: { city: "NYC" } }`)
+- **`useFormState` scoped per-field** — Added `name` parameter to prevent unnecessary re-renders across unrelated fields
+- Removed `process.env.NODE_ENV` guard from missing-control warning — now always warns
+
+### Changed
+
+- Requires React Hook Form `^7.54.0` (was `^7.53.2`)
+
+## [1.0.3] - 2024-12-04
+
+### Changed
+
+- **Complete TypeScript Migration**: Rewrote entire codebase with strict TypeScript
+- **Improved Type Definitions**: Added comprehensive type exports for better DX
+- **Modern Build System**: Updated tsup configuration for better tree-shaking
+- **Enhanced Types**: Added `FieldOption`, `FieldOptionGroup`, `DefineField` utility types
+- **Better Error Messages**: Improved development warnings with actionable messages
+
+### Added
+
+- New type exports: `FieldOption`, `FieldOptionGroup`, `DefineField`, `SchemaFieldNames`, `InferSchemaValues`
+- Subcomponent exports: `SectionRenderer`, `GridRenderer`, `FieldWrapper`
+- Hook exports: `useFieldComponent`, `useLayoutComponent`
+- Support for `gap` property in sections
+- Support for `collapsible` and `defaultCollapsed` section properties
+- `FormElement` type for consistent JSX return types
+- `ClassValue` re-export from utils
+
+### Fixed
+
+- Package exports configuration for proper ESM/CJS interop
+- TypeScript strict mode compatibility
+- Proper peer dependency declarations
+
+## [1.0.2] - 2024-12-03
+
+### Added
+
+- Initial public release
+- FormGenerator component
+- FormSystemProvider context
+- Schema-driven form generation
+- Variant support for components
+- Conditional field rendering
+
+## [1.0.1] - 2024-12-02
+
+### Fixed
+
+- Package configuration fixes
+
+## [1.0.0] - 2024-12-01
+
+### Added
+
+- Initial release
+