@blueprint-ts/core 4.0.0-beta.4 → 4.0.0-beta.6

package/CHANGELOG.md

@@ -1,3 +1,26 @@
+## v4.0.0-beta.6 - 2026-02-27 (beta)
+
+# [4.0.0-beta.6](/compare/v4.0.0-beta.5...v4.0.0-beta.6) (2026-02-27)
+
+
+### Bug Fixes
+
+*  bind BaseForm getters to preserve this 5e44296
+* Type propertyAwareToRaw properly 1fe2f28
+
+
+### Features
+
+* Make state protected readonly in BaseForm e6e2f81
+* Removed deprecated Paginator alias 7f07617
+## v4.0.0-beta.5 - 2026-02-27 (beta)
+
+# [4.0.0-beta.5](/compare/v4.0.0-beta.4...v4.0.0-beta.5) (2026-02-27)
+
+
+### Bug Fixes
+
+* satisfy paginator updater typing and type-only import in VueRequestLoaderFactory 6468368
 ## v4.0.0-beta.4 - 2026-02-26 (beta)
 
 # [4.0.0-beta.4](/compare/v4.0.0-beta.3...v4.0.0-beta.4) (2026-02-26)

package/docs/upgrading/v3-to-v4.md

@@ -78,6 +78,24 @@ Page navigation helpers (`toNextPage`, `toPreviousPage`, `toFirstPage`, `toLastP
 `PaginationParamsContract` was removed from the Laravel pagination exports because it was unused. Define your own params
 interface in your app instead.
 
+## Deprecated `Paginator` alias removed
+
+`Paginator` (and the related `PaginatorOptions` alias) was an old alias for `PageAwarePaginator`. The alias file has been removed, so importing `Paginator` or `PaginatorOptions` now results in a build error.
+
+### How to Fix
+
+- Replace `import { Paginator } from '@blueprint-ts/core/pagination'` with:
+
+```typescript
+import { PageAwarePaginator } from '@blueprint-ts/core/pagination'
+```
+
+- Replace `import { type PaginatorOptions } from '@blueprint-ts/core/pagination'` with:
+
+```typescript
+import { type PageAwarePaginatorOptions } from '@blueprint-ts/core/pagination'
+```
+
 ## Core Modules Moved out of `service/`
 
 Core (non-framework) modules moved from `@blueprint-ts/core/service/*` to `@blueprint-ts/core/*`.
@@ -169,3 +187,12 @@ with:
 ```typescript
 import { JsonBaseRequest } from '@blueprint-ts/core/laravel/requests'
 ```
+
+## BaseForm `state` is now protected
+
+`BaseForm.state` was public in previous versions, but it is now `protected readonly`. That means external consumers can no longer import form instances and access `form.state`. Subclasses can still read/write state internally, so any code that depended on reading it from outside the form must switch to supported accessors such as `form.properties`.
+
+### How to Fix
+
+- Replace direct `form.state` usage with the public helpers (`form.properties`, getters, or explicit payload builders).
+- If you were creating helpers that accessed `state` from outside the form, move those helpers inside the form class so they can rely on the protected field.

package/docs/vue/forms/arrays.md

@@ -1,5 +1,7 @@
 # Arrays
 
+## PropertyAwareArray
+
 Use `PropertyAwareArray` for arrays with per-item `v-model`, errors, and dirty state when your array contains objects.
 
 ```ts
@@ -43,3 +45,58 @@ Example component usage:
 ```
 
 Nested error keys like `positions.0.value` map into `position.value.errors`.
+
+## propertyAwareToRaw
+
+`propertyAwareToRaw` converts a property-aware object (each field wrapped in `{ model: { value } }`) into a plain object by unwrapping every field's `model.value`. It is purely a transformation: metadata such as `errors`, `dirty`, and `touched` is dropped, while arrays and nested objects are processed recursively. Keys starting with `_` are omitted from the result, and arrays are mapped element-by-element via the same unwrapping.
+
+### Input shape (property-aware)
+
+```ts
+const propertyAwarePosition = {
+  id: {
+    model: { value: 'pos-1' },
+    errors: [],
+    dirty: false,
+    touched: false
+  },
+  sort_order: {
+    model: { value: 10 },
+    errors: [],
+    dirty: false,
+    touched: false
+  },
+  description: {
+    model: { value: 'Service' },
+    errors: [],
+    dirty: false,
+    touched: false
+  },
+  net_amount: {
+    model: { value: 100 },
+    errors: [],
+    dirty: false,
+    touched: false
+  }
+}
+```
+
+Note that this is only an example of how the input shape looks When used in a form the model is a WritableComputedRef.
+
+### Output shape (raw)
+
+```ts
+const rawPosition = {
+  id: 'pos-1',
+  sort_order: 10,
+  description: 'Service',
+  net_amount: 100
+}
+```
+
+### Notes
+
+- Arrays are mapped element-by-element.
+- Nested objects are unwrapped recursively.
+- Any keys starting with `_` are ignored.
+- Only the `model.value` remains; form metadata is dropped.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueprint-ts/core",
-  "version": "4.0.0-beta.4",
+  "version": "4.0.0-beta.6",
   "license": "MIT",
   "publishConfig": {
     "access": "public"

package/src/pagination/BasePaginator.ts

@@ -42,7 +42,7 @@ export abstract class BasePaginator<ResourceInterface, ViewDriver extends BaseVi
       const result = updater(row, i, data)
 
       if (result !== undefined) {
-        data[i] = result
+        data[i] = result as ResourceInterface
       }
 
       updated++

package/src/pagination/index.ts

@@ -2,7 +2,6 @@ import { PaginationDataDto } from './dtos/PaginationDataDto'
 import { StatePaginationDataDto } from './dtos/StatePaginationDataDto'
 import { VuePaginationDriver } from './frontendDrivers/VuePaginationDriver'
 import { VueBaseViewDriver } from './frontendDrivers/VueBaseViewDriver'
-import { Paginator } from './Paginator'
 import { BasePaginator } from './BasePaginator'
 import { PageAwarePaginator } from './PageAwarePaginator'
 import { StatePaginator } from './StatePaginator'
@@ -25,7 +24,6 @@ export {
   StatePaginationDataDto,
   VuePaginationDriver,
   VueBaseViewDriver,
-  Paginator,
   BasePaginator,
   PageAwarePaginator,
   StatePaginator,

package/src/vue/forms/BaseForm.ts

@@ -27,6 +27,15 @@ type FieldProperty<T> = {
   touched: boolean
 }
 
+type PropertyAwareToRaw<T> =
+  T extends Array<infer U>
+    ? Array<PropertyAwareToRaw<U>>
+    : T extends { model: { value: infer V } }
+      ? V
+      : T extends object
+        ? { [K in keyof T]: PropertyAwareToRaw<T[K]> }
+        : T
+
 type FormKey<FormBody extends object> = Extract<keyof FormBody, string>
 type RequestKey<RequestBody extends object> = Extract<keyof RequestBody, string>
 type ArrayItem<T> = T extends Array<infer Item> ? Item : never
@@ -54,13 +63,13 @@ function isErrorObject(value: unknown): value is ErrorObject {
   return isRecord(value)
 }
 
-export function propertyAwareToRaw<T>(propertyAwareObject: T): T {
+export function propertyAwareToRaw<T>(propertyAwareObject: T): PropertyAwareToRaw<T> {
   if (Array.isArray(propertyAwareObject)) {
-    return propertyAwareObject.map((item) => propertyAwareToRaw(item)) as T
+    return propertyAwareObject.map((item) => propertyAwareToRaw(item)) as PropertyAwareToRaw<T>
   }
 
   if (!isRecord(propertyAwareObject)) {
-    return propertyAwareObject
+    return propertyAwareObject as PropertyAwareToRaw<T>
   }
 
   const result: Record<string, unknown> = {}
@@ -87,7 +96,7 @@ export function propertyAwareToRaw<T>(propertyAwareObject: T): T {
     result[key] = value
   }
 
-  return result as T
+  return result as PropertyAwareToRaw<T>
 }
 
 /** Helper: shallow-merge source object into target. */
@@ -160,7 +169,7 @@ function propertyAwareDeepEqual<T>(a: T, b: T): boolean {
  * (We assume that for every key in RequestBody there is a corresponding key in FormBody.)
  */
 export abstract class BaseForm<RequestBody extends object, FormBody extends object> {
-  public readonly state: FormBody
+  protected readonly state: FormBody
   private readonly dirty: DirtyMap<FormBody>
   private readonly touched: Record<keyof FormBody, boolean>
   private readonly original: FormBody
@@ -795,12 +804,18 @@ export abstract class BaseForm<RequestBody extends object, FormBody extends obje
 
   private getValueGetter(name: string): ((value: unknown) => unknown) | undefined {
     const candidate = (this as Record<string, unknown>)[name]
-    return typeof candidate === 'function' ? (candidate as (value: unknown) => unknown) : undefined
+    if (typeof candidate !== 'function') {
+      return undefined
+    }
+    return (candidate as (value: unknown) => unknown).bind(this)
   }
 
   private getNoArgGetter(name: string): (() => unknown) | undefined {
     const candidate = (this as Record<string, unknown>)[name]
-    return typeof candidate === 'function' ? (candidate as () => unknown) : undefined
+    if (typeof candidate !== 'function') {
+      return undefined
+    }
+    return (candidate as () => unknown).bind(this)
   }
 
   private transformValue(value: unknown, parentKey?: string): unknown {

package/src/vue/requests/factories/VueRequestLoaderFactory.ts

@@ -1,7 +1,7 @@
 import { VueRequestLoader } from '../loaders/VueRequestLoader'
 import { type RequestLoaderContract } from '../../../requests/contracts/RequestLoaderContract'
 import { type Ref } from 'vue'
-import { RequestLoaderFactoryContract } from '../../../requests'
+import type { RequestLoaderFactoryContract } from '../../../requests'
 
 export class VueRequestLoaderFactory implements RequestLoaderFactoryContract<Ref<boolean>> {
   public make(): RequestLoaderContract<Ref<boolean>> {

package/src/pagination/Paginator.ts

@@ -1,11 +0,0 @@
-import { PageAwarePaginator, type PageAwarePaginatorOptions } from './PageAwarePaginator'
-
-/**
- * @deprecated Use PageAwarePaginator instead. This alias is kept for backward compatibility.
- */
-export const Paginator = PageAwarePaginator
-
-/**
- * @deprecated Use PageAwarePaginatorOptions instead. This alias is kept for backward compatibility.
- */
-export type PaginatorOptions = PageAwarePaginatorOptions