@donotdev/crud 0.0.6 → 0.0.7

package/dist/forms/hooks/useEntityForm.d.ts

@@ -3,87 +3,19 @@ import type { UseEntityFormOptions, EntityFormReturn } from '../types';
 /**
  * Creates a type-safe form instance from an entity definition.
  *
- * Automatically configures React Hook Form with:
- * - Pre-filtered fields based on operation and visibility
- * - Editability computed per-field based on viewer role
- * - Type-safe form values inferred from entity
+ * Simple, predictable behavior:
+ * - Edit mode: defaultValues (DB object) is used as-is
+ * - Create mode: starts empty, optional auto-save to localStorage
+ *
+ * When formId is provided:
+ * - Tracks form status (uploading/validating/submitting)
+ * - Orchestrates file uploads before validation
+ * - Provides cleanup function for unmount
  *
  * @template E - Entity type from defineEntity()
  * @param entity - Entity definition from defineEntity()
  * @param options - Form configuration options
  * @returns Form instance with React Hook Form API plus entity-aware extensions
- *
- * @example
- * ```tsx
- * import { useEntityForm } from '@donotdev/crud/forms';
- * import { productEntity } from './entities/product';
- *
- * function ProductForm({ existingProduct, onSuccess }) {
- *   const form = useEntityForm(productEntity, {
- *     operation: existingProduct ? 'edit' : 'create',
- *     defaultValues: existingProduct,
- *     viewerRole: 'admin'
- *   });
- *
- *   const onSubmit = async (data) => {
- *     await saveProduct(data);
- *     onSuccess();
- *   };
- *
- *   return (
- *     <form onSubmit={form.handleSubmit(onSubmit)}>
- *       {form.fields.map(({ name, config, editable }) => (
- *         editable ? (
- *           <input
- *             key={name}
- *             {...form.register(name)}
- *             placeholder={config.label}
- *           />
- *         ) : (
- *           <span key={name}>{form.getValues(name)}</span>
- *         )
- *       ))}
- *       <button type="submit" disabled={form.formState.isSubmitting}>
- *         {form.operation === 'create' ? 'Create' : 'Update'}
- *       </button>
- *     </form>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With custom UI components
- * import { useEntityForm } from '@donotdev/crud/forms';
- * import { Input, Select, DatePicker } from './ui';
- *
- * function CustomForm() {
- *   const form = useEntityForm(orderEntity, { operation: 'create' });
- *
- *   // Custom 2-column layout
- *   return (
- *     <form onSubmit={form.handleSubmit(onSubmit)}>
- *       <div className="grid grid-cols-2 gap-4">
- *         <Input label="Customer" {...form.register('customer')} />
- *         <DatePicker label="Date" {...form.register('orderDate')} />
- *       </div>
- *       <Select
- *         label="Status"
- *         options={form.fields.find(f => f.name === 'status')?.config.validation?.options}
- *         {...form.register('status')}
- *       />
- *     </form>
- *   );
- * }
- * ```
- *
- * @see {@link Entity} for entity definition structure
- * @see {@link EntityFormReturn} for return type
- * @see {@link getFieldsForOperation} for field filtering logic
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
  */
 export declare function useEntityForm<E extends Entity>(entity: E, options?: UseEntityFormOptions<E>): EntityFormReturn<E>;
 //# sourceMappingURL=useEntityForm.d.ts.map

package/dist/forms/hooks/useEntityForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useEntityForm.d.ts","sourceRoot":"","sources":["../../../src/forms/hooks/useEntityForm.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAM7C,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoFG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM,GACpC,gBAAgB,CAAC,CAAC,CAAC,CA4LrB"}
+{"version":3,"file":"useEntityForm.d.ts","sourceRoot":"","sources":["../../../src/forms/hooks/useEntityForm.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAQ7C,OAAO,KAAK,EACV,oBAAoB,EACpB,gBAAgB,EAEjB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,EAC5C,MAAM,EAAE,CAAC,EACT,OAAO,GAAE,oBAAoB,CAAC,CAAC,CAAM,GACpC,gBAAgB,CAAC,CAAC,CAAC,CAiarB"}

package/dist/forms/hooks/useEntityForm.js

@@ -1 +1 @@
-"use client";import{useMemo as o,useEffect as g,useRef as h}from"react";import{useForm as k}from"react-hook-form";import{useLocalStorage as x}from"@donotdev/core";import{useAuth as H}from"@donotdev/auth";import{valibotResolver as w}from"@hookform/resolvers/valibot";import{createEntitySchema as y,getFieldsForOperation as K}from"../utils";function U(t,E={}){let v;try{v=H("userRole")}catch{}const{operation:L,defaultValues:r,viewerRole:m=v||"admin",mode:O="onSubmit",t:j,autoSave:s=!1}=E,e=L??(r?"edit":"create"),S=o(()=>y(t,"create"),[t]),R=o(()=>y(t,"draft"),[t]),T=o(()=>w(S),[S]),V=o(()=>w(R),[R]),A=o(()=>async(a,n,i)=>(a?.status==="draft"||r?.status==="draft"?V:T)(a,n,i),[T,V,r]),u=k({defaultValues:r,mode:O,resolver:A}),C=o(()=>`${t.name.toLowerCase()}-form-draft`,[t.name]),{value:d,setValue:D,removeValue:F}=x(C,{defaultValue:null,syncAcrossTabs:!0}),f=h(!1);g(()=>{!s||e!=="create"||r||f.current||(d&&u.reset(d),f.current=!0)},[s,e,r,d,u]);const p=h(!1),l=h(null);g(()=>{if(!s||e!=="create")return;const a=u.watch(n=>{p.current||!f.current||(l.current&&clearTimeout(l.current),l.current=setTimeout(()=>{Object.values(n).some(c=>c!=null&&c!=="")&&D(n)},3e3))});return()=>{a.unsubscribe(),l.current&&clearTimeout(l.current)}},[s,e,u,D]);const b=u.handleSubmit,M=o(()=>!s||e!=="create"?b:((a,n)=>b(async(i,c)=>{p.current=!0;try{await a(i,c),F()}finally{p.current=!1}},n)),[b,s,e,F]),P=o(()=>K(t,{operation:e,viewerRole:m,availableFields:e==="edit"&&r?Object.keys(r):void 0}),[t,e,m,r]);return{...u,handleSubmit:M,fields:P,operation:e,entity:t,t:j??(a=>a),viewerRole:m}}export{U as useEntityForm};
+"use client";import{valibotResolver as B}from"@hookform/resolvers/valibot";import{useMemo as l,useEffect as O,useRef as g,useCallback as w}from"react";import{useForm as ee,useWatch as te}from"react-hook-form";import{useLocalStorage as re,BACKEND_GENERATED_FIELD_NAMES as se}from"@donotdev/core";import{createSchemas as oe}from"@donotdev/schemas";import{useFormStore as V,useFormStatus as ne,useUploadProgress as ae}from"../../stores";import{useUploadStore as L}from"../../stores/UploadStore";import{checkForBlobUrls as x}from"../../utils/uploadValidation";import{getFieldsForOperation as ue}from"../utils";function ve(i,N={}){const{formId:e,operation:_,defaultValues:a,viewerRole:F="admin",mode:C="onBlur",t:J,autoSave:m=!1}=N,n=_??(a?"edit":"create"),K=ne(e??""),W=ae(e??""),b=l(()=>oe(i),[i.name]),P=l(()=>B(b.create),[b.create]),U=l(()=>B(b.draft),[b.draft]),q=l(()=>async(t,o,s)=>((t?.status??a?.status)==="draft"?U:P)(t,o,s),[P,U,a?.status]),p=l(()=>{if(!a)return a;const t={...a};return Object.entries(i.fields).forEach(([o,s])=>{if(s.type==="switch"){const r=t[o];if(r==null){const S=s.options?.fieldSpecific;t[o]=S?.uncheckedValue??!1}}}),t},[a,i.fields]),u=ee({defaultValues:p,mode:C,resolver:q,shouldUnregister:!1,shouldFocusError:!0}),v=g(null);O(()=>{if(n==="edit"&&p){const t=p.id??null;t&&t!==v.current?(u.reset(p),v.current=t):!t&&v.current===null&&(u.reset(p),v.current="initialized")}},[n,p,u]);const G=l(()=>`${i.name.toLowerCase()}-form-draft`,[i.name]),{value:D,setValue:j,removeValue:k}=re(G,{defaultValue:null,syncAcrossTabs:!0}),R=g(!1);O(()=>{!m||n!=="create"||a||R.current||(D&&u.reset(D),R.current=!0)},[m,n,a,D,u]);const c=te({control:u.control}),E=g(!1),h=g(null),y=g(void 0),I=g(!0);O(()=>{if(I.current){I.current=!1,y.current=c?JSON.stringify(c):void 0;return}if(!m||n!=="create"||E.current||!R.current)return;const t=c?JSON.stringify(c):void 0;if(y.current!==t)return y.current=t,h.current&&clearTimeout(h.current),h.current=setTimeout(()=>{if(!c)return;Object.values(c).some(s=>s!=null&&s!=="")&&j(c)},3e3),()=>{h.current&&clearTimeout(h.current)}},[c,m,n,j]);const M=w(async()=>{if(!e)return!0;const t=L.getState(),o=V.getState();if(!t.hasPendingUploads(e))return!0;try{o.setUploading(e,0),await t.uploadAll(e),await new Promise(d=>setTimeout(d,50));let s=u.getValues(),r=x(s),S=0;const f=5;for(;r.length>0&&S<f;)S++,await new Promise(d=>setTimeout(d,100)),s=u.getValues(),r=x(s);if(r.length>0){const d=`Upload incomplete: files still pending at ${r.join(", ")}`;return o.setError(e,d),!1}return!0}catch(s){const r=s instanceof Error?s.message:"File upload failed";return V.getState().setError(e,r),!1}},[e,u]),A=w(t=>n!=="create"?t:Object.fromEntries(Object.entries(t).filter(([o])=>!se.includes(o))),[n]),$=w(t=>{if(typeof window>"u")return;const o=Object.keys(t).find(r=>r!=="root"&&t[r]);if(!o)return;const s=document.querySelector(`input[name="${o}"][aria-invalid="true"], textarea[name="${o}"][aria-invalid="true"], select[name="${o}"][aria-invalid="true"]`);s&&(s.scrollIntoView({behavior:"smooth",block:"center"}),s.focus())},[]),z=u.handleSubmit,H=l(()=>((t,o)=>async s=>{s?.preventDefault?.();const r=e?V.getState():null;e&&r&&r.startSubmit(e),E.current=!0;try{if(!await M()){E.current=!1;return}e&&r&&r.setValidating(e),await z(async(f,d)=>{e&&r&&r.setSubmitting(e);const Y=A(f);try{await t(Y,d),m&&n==="create"&&k(),e&&r&&r.setSuccess(e)}catch(T){const Z=T instanceof Error?T.message:"Submission failed";throw e&&r&&r.setError(e,Z),T}},f=>{e&&r&&r.setError(e,"Validation failed"),$(f),o?.(f)})(s)}finally{E.current=!1}}),[z,e,M,A,$,m,n,k]),Q=w(()=>{e&&(V.getState().cleanup(e),L.getState().cleanup(e))},[e]),X=l(()=>ue(i,{operation:n,viewerRole:F,availableFields:n==="edit"&&a?Object.keys(a):void 0}),[i,n,F,a]);return{...u,handleSubmit:H,fields:X,operation:n,entity:i,t:J??(t=>t),viewerRole:F,formId:e,formStatus:e?K:"idle",uploadProgress:e?W:0,cleanup:Q}}export{ve as useEntityForm};

package/dist/forms/index.d.ts

@@ -4,7 +4,7 @@
  *
  * Import from '@donotdev/crud/forms' to access form building blocks:
  * - Hooks: useEntityForm, useEntityField
- * - Utilities: getFieldsForOperation, createEntitySchema, validateEntity
+ * - Utilities: getFieldsForOperation, validateEntity
  * - Types: InferEntityData, EntityFormReturn, etc.
  *
  * @example
@@ -31,7 +31,9 @@
  */
 export { useEntityForm } from './hooks/useEntityForm';
 export { useEntityField } from './hooks/useEntityField';
-export { isFieldEditable, normalizeToFieldConfig, getFieldsForOperation, createEntitySchema, validateEntity, } from './utils';
-export type { ViewerRole, RenderableField, GetFieldsForOperationOptions, EntityFieldsInput, SchemaOperation, ValidationIssue, ValidationResult, } from './utils';
-export type { InferEntityData, InferEntityInput, InferEntityOutput, UseEntityFormOptions, EntityFormReturn, EntityFieldReturn, Entity, EntityField, FieldConfig, FieldType, Visibility, Editable, ValidationRules, dndevSchema, } from './types';
+export { useController } from './hooks/useController';
+export type { UseControllerProps, UseControllerReturn, ControllerRenderProps, ControllerFieldState, } from './hooks/useController';
+export { isFieldEditable, getFieldsForOperation, validateEntity, translateFieldLabel, translateLabel, yearOptions, rangeOptions, } from './utils';
+export type { ViewerRole, RenderableField, GetFieldsForOperationOptions, EntityFieldsInput, SchemaOperation, ValidationIssue, ValidationResult, SelectOption, } from './utils';
+export type { InferEntityData, InferEntityInput, InferEntityOutput, UseEntityFormOptions, EntityFormReturn, EntityFieldReturn, Entity, EntityField, FieldType, Visibility, Editable, ValidationRules, dndevSchema, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/forms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,cAAc,GACf,MAAM,SAAS,CAAC;AAGjB,YAAY,EAEV,UAAU,EACV,eAAe,EACf,4BAA4B,EAC5B,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,YAAY,EAEV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EAEjB,MAAM,EACN,WAAW,EACX,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,EACR,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,mBAAmB,EACnB,cAAc,EAEd,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAGjB,YAAY,EAEV,UAAU,EACV,eAAe,EACf,4BAA4B,EAC5B,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,YAAY,EAEV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EAEjB,MAAM,EACN,WAAW,EACX,SAAS,EACT,UAAU,EACV,QAAQ,EACR,eAAe,EACf,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/forms/index.js

@@ -1 +1 @@
-import{useEntityForm as i}from"./hooks/useEntityForm";import{useEntityField as r}from"./hooks/useEntityField";import{isFieldEditable as l,normalizeToFieldConfig as n,getFieldsForOperation as d,createEntitySchema as m,validateEntity as F}from"./utils";export{m as createEntitySchema,d as getFieldsForOperation,l as isFieldEditable,n as normalizeToFieldConfig,r as useEntityField,i as useEntityForm,F as validateEntity};
+import{useEntityForm as r}from"./hooks/useEntityForm";import{useEntityField as i}from"./hooks/useEntityField";import{useController as l}from"./hooks/useController";import{isFieldEditable as s,getFieldsForOperation as p,validateEntity as d,translateFieldLabel as F,translateLabel as m,yearOptions as f,rangeOptions as x}from"./utils";export{p as getFieldsForOperation,s as isFieldEditable,x as rangeOptions,F as translateFieldLabel,m as translateLabel,l as useController,i as useEntityField,r as useEntityForm,d as validateEntity,f as yearOptions};

package/dist/forms/types.d.ts

@@ -6,10 +6,11 @@
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-import type { UseFormReturn, ControllerRenderProps, FieldPath } from 'react-hook-form';
-import type { Entity, EntityField, FieldConfig, FieldType, FieldTypeToValue, Visibility, Editable, ValidationRules, dndevSchema } from '@donotdev/core';
+import type { Entity, EntityField, FieldType, FieldTypeToValue, Visibility, Editable, ValidationRules, dndevSchema } from '@donotdev/core';
+import type { FormStatus } from '../stores/FormStore';
 import type { RenderableField, ViewerRole } from './utils';
-export type { Entity, EntityField, FieldConfig, FieldType, Visibility, Editable, ValidationRules, dndevSchema, RenderableField, ViewerRole, };
+import type { UseFormReturn, ControllerRenderProps, FieldPath } from 'react-hook-form';
+export type { Entity, EntityField, FieldType, Visibility, Editable, ValidationRules, dndevSchema, RenderableField, ViewerRole, };
 /**
  * Infers the data type from an entity definition.
  *
@@ -41,7 +42,7 @@ export type { Entity, EntityField, FieldConfig, FieldType, Visibility, Editable,
 export type InferEntityData<E extends Entity> = {
     [K in keyof E['fields']]: E['fields'][K] extends {
         type: infer T;
-    } ? T extends FieldType ? FieldTypeToValue[T] : unknown : unknown;
+    } ? T extends FieldType ? T extends keyof FieldTypeToValue ? FieldTypeToValue[T] : unknown : unknown : unknown;
 };
 /**
  * Infers form input type (values before validation).
@@ -75,6 +76,12 @@ export type InferEntityOutput<E extends Entity> = InferEntityData<E>;
  * @author AMBROISE PARK Consulting
  */
 export interface UseEntityFormOptions<E extends Entity> {
+    /**
+     * Form ID for tracking form/upload state.
+     * Required for deferred file uploads and form status tracking.
+     * Generate with useId() in the parent component.
+     */
+    formId?: string;
     /**
      * Form operation type.
      * - 'create': Excludes technical fields, all other fields editable
@@ -145,6 +152,25 @@ export interface EntityFormReturn<E extends Entity> extends UseFormReturn<InferE
      * Current viewer role.
      */
     viewerRole: ViewerRole;
+    /**
+     * Form ID for state tracking.
+     * Undefined if not provided in options.
+     */
+    formId: string | undefined;
+    /**
+     * Current form status from FormStore.
+     * Tracks: idle → uploading → validating → submitting → success/error
+     */
+    formStatus: FormStatus;
+    /**
+     * Upload progress 0-100 when status is 'uploading'.
+     */
+    uploadProgress: number;
+    /**
+     * Cleanup function to call on unmount.
+     * Cleans up FormStore and UploadStore state for this form.
+     */
+    cleanup: () => void;
 }
 /**
  * Return type for useEntityField hook.
@@ -172,7 +198,7 @@ export interface EntityFieldReturn<E extends Entity, K extends keyof InferEntity
     /**
      * Normalized field configuration.
      */
-    config: FieldConfig;
+    config: EntityField;
     /**
      * Whether field is editable (based on role, operation, config).
      */

package/dist/forms/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/forms/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/forms/types.ts"],"names":[],"mappings":"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"}

package/dist/forms/utils/getFieldsForOperation.d.ts

@@ -6,16 +6,16 @@
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-import type { Entity, EntityField, FieldConfig, FieldType } from '@donotdev/core';
+import type { Entity, EntityField, FieldType } from '@donotdev/core';
 /** Entity fields input - supports Entity, Entity['fields'], or plain Record */
-export type EntityFieldsInput = Entity | Entity['fields'] | Record<string, EntityField<FieldType> | FieldConfig<FieldType>>;
-import { type ViewerRole } from './isFieldEditable';
+export type EntityFieldsInput = Entity | Entity['fields'] | Record<string, EntityField<FieldType>>;
+import type { ViewerRole } from './isFieldEditable';
 /** Field with computed editability for rendering */
 export interface RenderableField<T extends FieldType = FieldType> {
     /** Field name/key */
     name: string;
-    /** Normalized field configuration */
-    config: FieldConfig<T>;
+    /** Field configuration */
+    config: EntityField<T>;
     /** Whether field is editable (input vs read-only) */
     editable: boolean;
 }

package/dist/forms/utils/getFieldsForOperation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getFieldsForOperation.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/getFieldsForOperation.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,MAAM,EACN,WAAW,EACX,WAAW,EACX,SAAS,EACV,MAAM,gBAAgB,CAAC;AAExB,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,MAAM,CAAC,QAAQ,CAAC,GAChB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;AAGpE,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAErE,oDAAoD;AACpD,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC9D,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,4BAA4B;IAC3C,0BAA0B;IAC1B,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,yCAAyC;IACzC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,4BAA4B,GACpC,eAAe,EAAE,CAyDnB"}
+{"version":3,"file":"getFieldsForOperation.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/getFieldsForOperation.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAErE,+EAA+E;AAC/E,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,MAAM,CAAC,QAAQ,CAAC,GAChB,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC;AAI3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,oDAAoD;AACpD,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS;IAC9D,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACvB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,kCAAkC;AAClC,MAAM,WAAW,4BAA4B;IAC3C,0BAA0B;IAC1B,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,yCAAyC;IACzC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,4BAA4B,GACpC,eAAe,EAAE,CAoDnB"}

package/dist/forms/utils/getFieldsForOperation.js

@@ -1 +1 @@
-import{normalizeToFieldConfig as f}from"./normalizeToFieldConfig";import{isFieldEditable as u}from"./isFieldEditable";function F(e,s){const{operation:r,viewerRole:d="admin",availableFields:t}=s,a=e&&typeof e=="object"&&"fields"in e&&"name"in e?e.fields:e;return Object.entries(a).map(([i,c])=>{const n=f(i,c),l=n.visibility||"user";if(r==="create"){if(l==="technical"||l==="hidden")return null}else if(l==="hidden"||t&&!t.includes(i))return null;let o=u(n.editable,d,r);return r==="edit"&&l==="technical"&&n.editable===void 0&&(o=!1),{name:i,config:n,editable:o}}).filter(i=>i!==null)}export{F as getFieldsForOperation};
+import{isFieldEditable as b}from"./isFieldEditable";function p(e,c){const{operation:l,viewerRole:f="admin",availableFields:o}=c,a=e&&typeof e=="object"&&"fields"in e&&"name"in e?e.fields:e,r=Object.entries(a),t=[];for(const[s,u]of r){const i=u,n=i.visibility||"user";if(l==="create"){if(n==="technical"||n==="hidden")continue}else if(n==="hidden"||o&&!o.includes(s))continue;let d=b(i.editable,f,l);l==="edit"&&n==="technical"&&i.editable===void 0&&(d=!1),t.push({name:s,config:i,editable:d})}return t}export{p as getFieldsForOperation};

package/dist/forms/utils/index.d.ts

@@ -6,9 +6,13 @@
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */
-export { isFieldEditable, type ViewerRole } from './isFieldEditable';
-export { normalizeToFieldConfig } from './normalizeToFieldConfig';
-export { getFieldsForOperation, type RenderableField, type GetFieldsForOperationOptions, type EntityFieldsInput, } from './getFieldsForOperation';
-export { createEntitySchema, type SchemaOperation } from './createEntitySchema';
-export { validateEntity, type ValidationIssue, type ValidationResult, } from './validateEntity';
+export { isFieldEditable } from './isFieldEditable';
+export type { ViewerRole } from './isFieldEditable';
+export { getFieldsForOperation } from './getFieldsForOperation';
+export type { RenderableField, GetFieldsForOperationOptions, EntityFieldsInput, } from './getFieldsForOperation';
+export { validateEntity } from './validateEntity';
+export type { ValidationIssue, ValidationResult, SchemaOperation, } from './validateEntity';
+export { translateFieldLabel, translateLabel } from './translateFieldLabel';
+export { yearOptions, rangeOptions } from './optionHelpers';
+export type { SelectOption } from './optionHelpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/forms/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,4BAA4B,EACjC,KAAK,iBAAiB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EACL,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,eAAe,EACf,4BAA4B,EAC5B,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/forms/utils/index.js

@@ -1 +1 @@
-import{isFieldEditable as r}from"./isFieldEditable";import{normalizeToFieldConfig as i}from"./normalizeToFieldConfig";import{getFieldsForOperation as m}from"./getFieldsForOperation";import{createEntitySchema as l}from"./createEntitySchema";import{validateEntity as d}from"./validateEntity";export{l as createEntitySchema,m as getFieldsForOperation,r as isFieldEditable,i as normalizeToFieldConfig,d as validateEntity};
+import{isFieldEditable as r}from"./isFieldEditable";import{getFieldsForOperation as a}from"./getFieldsForOperation";import{validateEntity as l}from"./validateEntity";import{translateFieldLabel as n,translateLabel as s}from"./translateFieldLabel";import{yearOptions as f,rangeOptions as m}from"./optionHelpers";export{a as getFieldsForOperation,r as isFieldEditable,m as rangeOptions,n as translateFieldLabel,s as translateLabel,l as validateEntity,f as yearOptions};

package/dist/forms/utils/isFieldEditable.d.ts

@@ -1,11 +1,3 @@
-/**
- * @fileoverview Field editability utility
- * @description Determines if a field is editable based on editable config, viewer role, and operation.
- *
- * @version 0.0.1
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
 import type { Editable } from '@donotdev/core';
 /** Viewer role type - used for editability checks */
 export type ViewerRole = 'public' | 'guest' | 'user' | 'admin' | 'super';

package/dist/forms/utils/isFieldEditable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isFieldEditable.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/isFieldEditable.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,QAAQ,GAAG,MAAM,GAC3B,OAAO,CAcT"}
+{"version":3,"file":"isFieldEditable.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/isFieldEditable.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qDAAqD;AACrD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,GAAG,SAAS,EAC9B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,QAAQ,GAAG,MAAM,GAC3B,OAAO,CAcT"}

package/dist/forms/utils/optionHelpers.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Option generation helpers for select fields
+ * @description Simple utilities to generate options arrays for select/dropdown fields.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+/** Standard option format for select fields */
+export interface SelectOption {
+    value: string;
+    label: string;
+}
+/**
+ * Generates year options for a select field.
+ *
+ * @param startYear - First year in the range
+ * @param endYear - Last year in the range (defaults to current year)
+ * @param descending - Whether to sort descending (newest first, default: true)
+ * @returns Array of options with value and label
+ *
+ * @example
+ * ```ts
+ * // In entity definition
+ * year: {
+ *   type: 'select',
+ *   validation: {
+ *     required: true,
+ *     options: yearOptions(1995) // 2026, 2025, 2024, ... 1995
+ *   }
+ * }
+ * ```
+ */
+export declare function yearOptions(startYear: number, endYear?: number, descending?: boolean): SelectOption[];
+/**
+ * Generates numeric range options for a select field.
+ *
+ * @param start - First number in the range
+ * @param end - Last number in the range
+ * @param step - Increment between numbers (default: 1)
+ * @param descending - Whether to sort descending (default: false)
+ * @returns Array of options with value and label
+ *
+ * @example
+ * ```ts
+ * // Quantities 1-10
+ * options: rangeOptions(1, 10)
+ *
+ * // Percentages 0-100 by 10
+ * options: rangeOptions(0, 100, 10)
+ * ```
+ */
+export declare function rangeOptions(start: number, end: number, step?: number, descending?: boolean): SelectOption[];
+//# sourceMappingURL=optionHelpers.d.ts.map

package/dist/forms/utils/optionHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optionHelpers.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/optionHelpers.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAAiC,EAC1C,UAAU,GAAE,OAAc,GACzB,YAAY,EAAE,CAchB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,MAAU,EAChB,UAAU,GAAE,OAAe,GAC1B,YAAY,EAAE,CAchB"}

package/dist/forms/utils/optionHelpers.js

@@ -0,0 +1 @@
+function o(n,t=new Date().getFullYear(),i=!0){const r=[];if(i)for(let e=t;e>=n;e--)r.push({value:String(e),label:String(e)});else for(let e=n;e<=t;e++)r.push({value:String(e),label:String(e)});return r}function u(n,t,i=1,r=!1){const e=[];if(r)for(let l=t;l>=n;l-=i)e.push({value:String(l),label:String(l)});else for(let l=n;l<=t;l+=i)e.push({value:String(l),label:String(l)});return e}export{u as rangeOptions,o as yearOptions};

package/dist/forms/utils/translateFieldLabel.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview Field label translation utility
+ * @description Centralized helper for translating field labels with namespace support.
+ * Handles namespace:key syntax, config.label fallback, and fields.${fieldName} pattern.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import type { EntityField, FieldType } from '@donotdev/core';
+/**
+ * Translates a label string with namespace support.
+ * Used for translating option labels, field labels, or any label string.
+ *
+ * Supports namespace:key syntax (e.g., "common:actions.save")
+ *
+ * @param label - Label string to translate (may include namespace:key syntax)
+ * @param t - Translation function from useTranslation hook
+ * @returns Translated label string
+ *
+ * @example
+ * ```typescript
+ * translateLabel('common:status', t); // Translates "status" from "common" namespace
+ * translateLabel('make', t); // Translates "make" in current namespace
+ * ```
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export declare function translateLabel(label: string, t: (key: string, options?: Record<string, any>) => string): string;
+/**
+ * Translates a field label using the provided translation function.
+ *
+ * Supports multiple label formats:
+ * - Namespace syntax: `"namespace:key"` → translates `key` in `namespace`
+ * - Direct label: `"label"` → translates `label` in current namespace
+ * - Field name fallback: uses field name if no label in config
+ *
+ * @param fieldName - Field name (used as fallback)
+ * @param config - Field configuration (may contain label)
+ * @param t - Translation function from useTranslation hook
+ * @returns Translated label string
+ *
+ * @example
+ * ```typescript
+ * import { translateFieldLabel } from '@donotdev/crud/forms';
+ * import { useTranslation } from '@donotdev/core';
+ *
+ * const { t } = useTranslation('entity-car');
+ * const label = translateFieldLabel('make', carEntity.fields.make, t);
+ * // Returns: translated "make" from entity-car namespace
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // With namespace syntax in config.label
+ * const label = translateFieldLabel('status', {
+ *   label: 'common:status',
+ *   type: 'select'
+ * }, t);
+ * // Returns: translated "status" from "common" namespace
+ * ```
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export declare function translateFieldLabel<T extends FieldType = FieldType>(fieldName: string, config: EntityField<T> | undefined, t: (key: string, options?: Record<string, any>) => string): string;
+//# sourceMappingURL=translateFieldLabel.d.ts.map

package/dist/forms/utils/translateFieldLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateFieldLabel.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/translateFieldLabel.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,GACxD,MAAM,CAWR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,SAAS,GAAG,SAAS,EACjE,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,SAAS,EAClC,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,GACxD,MAAM,CAGR"}

package/dist/forms/utils/translateFieldLabel.js

@@ -0,0 +1 @@
+function o(t,n){if(typeof t=="string"&&t.includes(":")){const e=t.split(":"),r=e[1]??t,s=e[0];return n(r,{ns:s})}return n(t)}function c(t,n,e){const r=n?.label||t;return o(r,e)}export{c as translateFieldLabel,o as translateLabel};

package/dist/forms/utils/validateEntity.d.ts

@@ -1,5 +1,8 @@
 import type { Entity } from '@donotdev/core';
-import { type SchemaOperation } from './createEntitySchema';
+/**
+ * Validation operation type
+ */
+export type SchemaOperation = 'create' | 'draft' | 'update' | 'full';
 /**
  * Validation issue structure
  */
@@ -30,7 +33,7 @@ export interface ValidationResult<T> {
  * @template E - Entity type from defineEntity()
  * @param entity - Entity definition from defineEntity()
  * @param data - Data to validate
- * @param operation - Validation context ('create' or 'update')
+ * @param operation - Validation context ('create', 'draft', 'update', or 'full')
  * @returns Validation result with typed issues
  *
  * @example

package/dist/forms/utils/validateEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validateEntity.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/validateEntity.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,oCAAoC;IACpC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,OAAO,EACb,SAAS,GAAE,eAA0B,GACpC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAsB3C"}
+{"version":3,"file":"validateEntity.d.ts","sourceRoot":"","sources":["../../../src/forms/utils/validateEntity.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,oCAAoC;IACpC,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,EAC7C,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,OAAO,EACb,SAAS,GAAE,eAA0B,GACpC,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgC3C"}

package/dist/forms/utils/validateEntity.js

@@ -1 +1 @@
-import*as o from"valibot";import{createEntitySchema as i}from"./createEntitySchema";function p(t,a,c="create"){const r=i(t,c),s=o.safeParse(r,a);return s.success?{success:!0,data:s.output}:{success:!1,issues:s.issues.map(e=>({path:e.path?.map(u=>u.key).join(".")||"",message:e.message}))}}export{p as validateEntity};
+import*as o from"valibot";import{createSchemas as p}from"@donotdev/schemas";function h(a,c,r="create"){const s=p(a),u={create:s.create,draft:s.draft,update:s.update,full:s.get}[r],e=o.safeParse(u,c);return e.success?{success:!0,data:e.output}:{success:!1,issues:e.issues.map(t=>({path:t.path?.map(m=>m.key).join(".")||"",message:t.message}))}}export{h as validateEntity};

package/dist/hooks/index.d.ts

@@ -0,0 +1,3 @@
+export { useFileUpload } from './useFileUpload';
+export type { FileMetadata, UseFileUploadOptions } from './useFileUpload';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/hooks/index.js

@@ -0,0 +1 @@
+import{useFileUpload as l}from"./useFileUpload";export{l as useFileUpload};

package/dist/hooks/useFileUpload.d.ts

@@ -0,0 +1,67 @@
+import type { Picture } from '@donotdev/types';
+/** Metadata for a file in the upload queue */
+export interface FileMetadata {
+    /** Unique ID for React keys */
+    id: string;
+    /** Original file object (for new uploads) */
+    file: File;
+    /** Local preview URL (blob: for new, https: for existing) */
+    previewURL: string;
+    /** Upload progress 0-100 (null = not started) */
+    progress: number | null;
+    /** Uploaded result (null = pending) */
+    uploaded: Picture | null;
+    /** Error message if upload failed */
+    error: string | null;
+}
+export interface UseFileUploadOptions {
+    /** Field name for UploadStore registration */
+    name: string;
+    /** Current value from form */
+    value: Picture | Picture[] | null | undefined;
+    /** Change handler to update form */
+    onChange: (value: Picture | Picture[] | null) => void;
+    /** Allow multiple files */
+    multiple?: boolean;
+    /** Max number of files (multiple mode) */
+    maxFiles?: number;
+    /** Max file size in bytes (default: 10MB) */
+    maxSize?: number;
+    /** Accepted MIME types (e.g., ['image/*'], ['application/pdf']) */
+    accept?: string[];
+    /** Storage path prefix */
+    storagePath?: string;
+    /** Upload function - injected to avoid coupling to specific storage */
+    uploadFn?: (file: File, onProgress: (progress: number) => void) => Promise<Picture>;
+}
+/**
+ * useFileUpload - Unified hook for file uploads
+ *
+ * Features:
+ * - Local preview before upload
+ * - Deferred upload on form submit (when inside EntityFormRenderer)
+ * - Immediate upload when standalone (no UploadProvider context)
+ * - UploadStore integration
+ * - File validation
+ * - Progress tracking
+ * - Works with Image, File, Document field types
+ */
+export declare function useFileUpload({ name, value, onChange, multiple, maxFiles, maxSize, accept, storagePath, uploadFn, }: UseFileUploadOptions): {
+    /** Current files (pending + uploaded) */
+    files: FileMetadata[];
+    /** Add new files (from drop/paste/input) */
+    addFiles: (newFiles: File[]) => void;
+    /** Remove a file by ID */
+    removeFile: (id: string) => void;
+    /** Whether any files are pending upload */
+    hasPending: boolean;
+    /** Whether upload is in progress */
+    isUploading: boolean;
+    /** Overall progress 0-100 */
+    progress: number;
+    /** Form ID from context (undefined if standalone) */
+    formId: string | undefined;
+    /** Whether uploads are deferred (true inside EntityFormRenderer, false standalone) */
+    isDeferred: boolean;
+};
+//# sourceMappingURL=useFileUpload.d.ts.map

package/dist/hooks/useFileUpload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileUpload.d.ts","sourceRoot":"","sources":["../../src/hooks/useFileUpload.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK/C,8CAA8C;AAC9C,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,IAAI,CAAC;IACX,6DAA6D;IAC7D,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uCAAuC;IACvC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,qCAAqC;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,8BAA8B;IAC9B,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9C,oCAAoC;IACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,KAAK,IAAI,CAAC;IACtD,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACrF;AA6DD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,KAAK,EACL,QAAQ,EACR,QAAgB,EAChB,QAAa,EACb,OAA0B,EAC1B,MAAW,EACX,WAAuB,EACvB,QAAQ,GACT,EAAE,oBAAoB;IA4YnB,yCAAyC;;IAEzC,4CAA4C;yBArGjC,IAAI,EAAE;IAuGjB,0BAA0B;qBA9BrB,MAAM;IAgCX,2CAA2C;;IAE3C,oCAAoC;;IAEpC,6BAA6B;;IAE7B,qDAAqD;;IAErD,sFAAsF;;EAGzF"}

package/dist/hooks/useFileUpload.js

@@ -0,0 +1 @@
+"use client";import{useState as G,useCallback as R,useEffect as v,useRef as A,startTransition as H}from"react";import{handleError as j}from"@donotdev/core";import{useUploadContext as K}from"../contexts/UploadContext";import{useUploadStore as k}from"../stores/UploadStore";let B=0;function M(l){if(l){const d=l.split("/").pop()?.split("?")[0];if(d)return`file-${d}`}B+=1;const u=typeof performance<"u"?performance.now():Date.now(),g=Math.random().toString(36).slice(2,11);return`file-${B}-${u}-${g}`}function Q(l){return URL.createObjectURL(l)}function V(l){l.startsWith("blob:")&&URL.revokeObjectURL(l)}function X(l,u,g){return u.length>0&&!u.some(m=>{if(m.endsWith("/*")){const L=m.slice(0,-2);return l.type.startsWith(L)}return l.type===m})?{valid:!1,error:`File type ${l.type} not accepted`}:l.size>g?{valid:!1,error:`File exceeds ${(g/1048576).toFixed(0)}MB limit`}:{valid:!0}}function er({name:l,value:u,onChange:g,multiple:d=!1,maxFiles:m=10,maxSize:L=10*1024*1024,accept:x=[],storagePath:Y="uploads",uploadFn:U}){const h=K(),w=!!h,[f,c]=G([]),E=A(!1),P=A(null),F=A(u),$=A([]);v(()=>{if(E.current){E.current=!1;return}const e=u?JSON.stringify((Array.isArray(u)?u:[u]).map(s=>s.fullUrl).filter(Boolean).sort()):null;e!==P.current&&(P.current=e,F.current=u,H(()=>{if(u){const n=(Array.isArray(u)?u:[u]).filter(t=>t.fullUrl).map((t,r)=>({id:`${M(t.fullUrl)}-existing-${r}`,file:new File([],"existing"),previewURL:t.thumbUrl||t.fullUrl,progress:100,uploaded:t,error:null}));c(n)}else c([])}))},[u]),v(()=>{$.current=f},[f]),v(()=>()=>{$.current.forEach(e=>V(e.previewURL))},[]);const p=R((e,s=!1)=>{const t=(s?e.filter(i=>!i.error):e.filter(i=>i.uploaded&&!i.error)).map(i=>i.uploaded?i.uploaded:s&&w?{fullUrl:i.previewURL,thumbUrl:i.previewURL}:null).filter(i=>i!==null);let r;d?r=t.length>0?t:null:r=t[0]||null;const o=F.current;(()=>{if(!r&&!o)return!1;if(!r||!o)return!0;if(d&&Array.isArray(r)&&Array.isArray(o)){if(r.length!==o.length)return!0;const i=r.map(b=>b.fullUrl).sort().join(","),y=o.map(b=>b.fullUrl).sort().join(",");return i!==y}return!d&&!Array.isArray(r)&&!Array.isArray(o)?r.fullUrl!==o.fullUrl:!0})()&&(E.current=!0,F.current=r,g(r))},[d,g,w]),S=R(async()=>{if(!U)return;let e=[];if(c(n=>(e=n.filter(t=>!t.uploaded&&!t.error),e.length===0?n:n.map(t=>e.some(r=>r.id===t.id)?{...t,progress:0}:t))),e.length===0)return;const s=await Promise.allSettled(e.map(async n=>{try{const t=await U(n.file,r=>{c(o=>o.map(a=>a.id===n.id?{...a,progress:r}:a))});return{id:n.id,picture:t,error:null}}catch(t){const r=t instanceof Error?t.message:"Upload failed";return{id:n.id,picture:null,error:r}}}));c(n=>{const t=n.map(r=>{const o=s.find(a=>a.status==="fulfilled"&&a.value.id===r.id);if(o&&o.status==="fulfilled"){const a=o.value;return{...r,uploaded:a.picture,progress:a.picture?100:null,error:a.error}}return r});return p(t,!1),t})},[U,p]),C=A(S);C.current=S;const I=k(e=>e.registerUpload),N=k(e=>e.unregisterUpload);v(()=>{if(!(!h||!l))return I(h,l,async()=>{await C.current()},()=>$.current.some(e=>!e.uploaded&&!e.error)),()=>{N(h,l)}},[h,l,I,N]);const T=R(async e=>{if(U){c(s=>s.map(n=>n.id===e.id?{...n,progress:0}:n));try{const s=await U(e.file,n=>{c(t=>t.map(r=>r.id===e.id?{...r,progress:n}:r))});c(n=>{const t=n.map(r=>r.id===e.id?{...r,uploaded:s,progress:100,error:null}:r);return p(t,!1),t})}catch(s){const n=s instanceof Error?s.message:"Upload failed";c(t=>t.map(r=>r.id===e.id?{...r,error:n,progress:null}:r))}}},[U,p]),D=R(e=>{c(s=>{const t=(d?m:1)-s.length;if(t<=0)return j(new Error("Maximum files reached"),{userMessage:d?`Maximum ${m} files allowed`:"Only one file allowed",severity:"warning",showNotification:!0}),s;const r=e.slice(0,t),o=[];for(const i of r){const y=X(i,x,L);if(!y.valid){j(new Error(y.error),{userMessage:y.error,severity:"warning",showNotification:!0});continue}o.push({id:M(),file:i,previewURL:Q(i),progress:null,uploaded:null,error:null})}if(o.length===0)return s;const a=d?[...s,...o]:o;return w?setTimeout(()=>{p(a,!0)},0):o.forEach(i=>T(i)),a})},[d,m,x,L,w,T,p]),O=R(e=>{c(s=>{const n=s.find(r=>r.id===e);n&&V(n.previewURL);const t=s.filter(r=>r.id!==e);return p(t,!1),t})},[p]),W=f.some(e=>!e.uploaded&&!e.error),J=f.some(e=>e.progress!==null&&e.progress<100),q=f.length>0?f.reduce((e,s)=>e+(s.progress??0),0)/f.length:0;return{files:f,addFiles:D,removeFile:O,hasPending:W,isUploading:J,progress:q,formId:h,isDeferred:w}}export{er as useFileUpload};