@pyreon/feature 0.10.0 → 0.11.1

package/src/types.ts

@@ -1,9 +1,21 @@
-import type { FormState, SchemaValidateFn } from '@pyreon/form'
-import type { QueryKey, UseMutationResult, UseQueryResult } from '@pyreon/query'
-import type { Computed, Signal } from '@pyreon/reactivity'
-import type { StoreApi } from '@pyreon/store'
-import type { SortingState } from '@pyreon/table'
-import type { FieldInfo } from './schema'
+import type { FormState, SchemaValidateFn } from "@pyreon/form"
+import type { QueryKey, UseMutationResult, UseQueryResult } from "@pyreon/query"
+import type { Computed, Signal } from "@pyreon/reactivity"
+import type { StoreApi } from "@pyreon/store"
+import type { SortingState } from "@pyreon/table"
+import type { FieldInfo } from "./schema"
+
+/**
+ * Duck-typed schema inference. Matches Zod (`_output`), Valibot, ArkType
+ * without importing their types. Allows TypeScript to infer TValues from schema.
+ */
+export type InferSchemaValues<TSchema> = TSchema extends {
+  _output: infer T extends Record<string, unknown>
+}
+  ? T // Zod v3/v4: z.ZodType has _output
+  : TSchema extends { infer: infer T extends Record<string, unknown> }
+    ? T // ArkType
+    : Record<string, unknown>
 
 /**
  * Configuration for defining a feature.
@@ -11,8 +23,9 @@ import type { FieldInfo } from './schema'
 export interface FeatureConfig<TValues extends Record<string, unknown>> {
   /** Unique feature name — used for store ID and query key namespace. */
   name: string
-  /** Validation schema (Zod, Valibot, or ArkType). Duck-typed — must have `safeParseAsync` for auto-validation. */
-  schema: unknown
+  /** Validation schema (Zod, Valibot, or ArkType). Duck-typed — must have `safeParseAsync` for auto-validation.
+   * Zod schemas carry `_output` for automatic TValues inference. */
+  schema: { _output?: TValues } & Record<never, never>
   /** Custom schema-level validation function. If provided, overrides auto-detection from schema. */
   validate?: SchemaValidateFn<TValues>
   /** API base path (e.g., '/api/users'). */
@@ -44,13 +57,13 @@ export interface ListOptions {
  */
 export interface FeatureFormOptions<TValues extends Record<string, unknown>> {
   /** 'create' (default) or 'edit'. Edit mode uses PUT instead of POST. */
-  mode?: 'create' | 'edit'
+  mode?: "create" | "edit"
   /** Item ID — required when mode is 'edit'. Used to PUT to api/:id and auto-fetch data. */
   id?: string | number
   /** Override initial values (merged with feature defaults). */
   initialValues?: Partial<TValues>
   /** When to validate: 'blur' (default), 'change', or 'submit'. */
-  validateOn?: 'blur' | 'change' | 'submit'
+  validateOn?: "blur" | "change" | "submit"
   /** Callback after successful create/update. */
   onSuccess?: (result: unknown) => void
   /** Callback on submit error. */
@@ -64,9 +77,7 @@ export interface FeatureTableOptions<TValues extends Record<string, unknown>> {
   /** Subset of schema fields to show as columns. If not provided, all fields are shown. */
   columns?: (keyof TValues & string)[]
   /** Per-column overrides (header text, cell renderer, size, etc.). */
-  columnOverrides?: Partial<
-    Record<keyof TValues & string, Record<string, unknown>>
-  >
+  columnOverrides?: Partial<Record<keyof TValues & string, Record<string, unknown>>>
   /** Page size for pagination. If not provided, pagination is disabled. */
   pageSize?: number
 }
@@ -76,7 +87,7 @@ export interface FeatureTableOptions<TValues extends Record<string, unknown>> {
  */
 export interface FeatureTableResult<TValues extends Record<string, unknown>> {
   /** The reactive TanStack Table instance. */
-  table: Computed<import('@pyreon/table').Table<TValues>>
+  table: Computed<import("@pyreon/table").Table<TValues>>
   /** Sorting state signal — bind to UI controls. */
   sorting: Signal<SortingState>
   /** Global filter signal — bind to search input. */